@aurodesignsystem-dev/auro-formkit 0.0.0-pr1514.8 → 0.0.0-pr1515.0

package/components/input/demo/api.md

@@ -13,20 +13,20 @@ The `auro-input` element provides users a way to enter data into a text field.
 | `a11yControls`                    | `a11yControls`                    |           | `string`                                         |             | The value for the aria-controls attribute.       |
 | `a11yExpanded`                    | `a11yExpanded`                    |           | `boolean`                                        |             | The value for the aria-expanded attribute.       |
 | `a11yRole`                        | `a11yRole`                        |           | `string`                                         |             | The value for the role attribute.                |
-| `activeLabel`                     | `activeLabel`                     |           | `boolean`                                        | false       | If set, the label will remain fixed in the active position. |
+| `activeLabel`                     | `activeLabel`                     |           | `boolean`                                        |             | If set, the label will remain fixed in the active position. |
 | `appearance`                      | `appearance`                      |           | `'default' \| 'inverse'`                         | "'default'" | Defines whether the component will be on lighter or darker backgrounds. |
 | `autocapitalize`                  | `autocapitalize`                  |           | `string`                                         |             | An enumerated attribute that controls whether and how text input is automatically capitalized as it is entered/edited by the user. [off/none, on/sentences, words, characters]. |
 | `autocomplete`                    | `autocomplete`                    |           | `string`                                         |             | An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete="off"` is supported. |
 | `autocorrect`                     | `autocorrect`                     |           | `string`                                         |             | When set to `off`, stops iOS from auto-correcting words when typed into a text box. |
 | `customValidityTypeEmail`         | `customValidityTypeEmail`         |           | `string`                                         |             | Custom help text message for email type validity. |
 | `disabled`                        | `disabled`                        |           | `boolean`                                        | false       | If set, disables the input.                      |
-| `dvInputOnly`                     | `dvInputOnly`                     |           | `boolean`                                        | false       | If defined, the display value slot content will only mask the HTML5 input element. The input's label will not be masked. |
+| `dvInputOnly`                     | `dvInputOnly`                     |           | `boolean`                                        |             | If defined, the display value slot content will only mask the HTML5 input element. The input's label will not be masked. |
 | `error`                           | `error`                           |           | `string`                                         |             | When defined, sets persistent validity to `customError` and sets `setCustomValidity` = attribute value. |
 | `errorMessage`                    | `errorMessage`                    |           | `string`                                         |             | Contains the help text message for the current validity error. |
 | `format`                          | `format`                          |           | `string`                                         |             | Specifies the input mask format.                 |
 | `hasFocus`                        |                                   |           | `boolean`                                        |             | Flag to indicate if the input currently has focus. |
-| `hasValue`                        |                                   |           | `boolean`                                        | false       | Flag to indicate if the input currently has value. |
-| `icon`                            | `icon`                            |           | `boolean`                                        | false       | If set, will render an icon inside the input to the left of the value. Support is limited to auro-input instances with credit card format. |
+| `hasValue`                        |                                   |           | `boolean`                                        |             | Flag to indicate if the input currently has value. |
+| `icon`                            | `icon`                            |           | `boolean`                                        |             | If set, will render an icon inside the input to the left of the value. Support is limited to auro-input instances with credit card format. |
 | `id`                              | `id`                              |           | `string`                                         |             | The id global attribute defines an identifier (ID) which must be unique in the whole document. |
 | `inputmode`                       | `inputmode`                       |           | `string`                                         |             | Exposes inputmode attribute for input.           |
 | `lang`                            | `lang`                            |           | `string`                                         |             | Defines the language of an element.              |
@@ -40,7 +40,7 @@ The `auro-input` element provides users a way to enter data into a text field.
 | `minObject`                       |                                   | readonly  | `Date \| undefined`                              |             | Read-only Date object representation of `min` for full date formats. |
 | `name`                            | `name`                            |           | `string`                                         |             | Populates the `name` attribute on the input.     |
 | `nested`                          | `nested`                          |           | `boolean`                                        |             | Sets styles for nested operation - removes borders, hides help + error text, and<br />hides accents. |
-| `noValidate`                      | `noValidate`                      |           | `boolean`                                        | false       | If set, disables auto-validation on blur.        |
+| `noValidate`                      | `noValidate`                      |           | `boolean`                                        |             | If set, disables auto-validation on blur.        |
 | `onDark`                          | `onDark`                          |           | `boolean`                                        | false       | DEPRECATED - use `appearance="inverse"` instead. |
 | `pattern`                         | `pattern`                         |           | `string`                                         |             | Specifies a regular expression the form control's value should match. |
 | `placeholder`                     | `placeholder`                     |           | `string`                                         |             | Define custom placeholder text.                  |

package/components/input/demo/customize.md

@@ -646,7 +646,7 @@
 <div class="exampleWrapper">
 <!-- AURO-GENERATED-CONTENT:START (FILE:src=../apiExamples/set-custom-validity-range-overflow.html) -->
 <!-- The below content is automatically added from ../apiExamples/set-custom-validity-range-overflow.html -->
-<auro-input type="date" max="2025-12-31" setCustomValidityRangeOverflow="Date must be on or before 12/31/2025.">
+<auro-input type="date" max="12/31/2025" setCustomValidityRangeOverflow="Date must be on or before 12/31/2025.">
 <span slot="label">Event Date</span>
 <span slot="helpText">Enter a date no later than 12/31/2025.</span>
 </auro-input>
@@ -656,7 +656,7 @@
 <span slot="trigger">See code</span>
 <!-- AURO-GENERATED-CONTENT:START (CODE:src=../apiExamples/set-custom-validity-range-overflow.html) -->
 <!-- The below code snippet is automatically added from ../apiExamples/set-custom-validity-range-overflow.html -->
-<pre class="language-html"><code class="language-html">&lt;auro-input type="date" max="2025-12-31" setCustomValidityRangeOverflow="Date must be on or before 12/31/2025."&gt;
+<pre class="language-html"><code class="language-html">&lt;auro-input type="date" max="12/31/2025" setCustomValidityRangeOverflow="Date must be on or before 12/31/2025."&gt;
   &lt;span slot="label"&gt;Event Date&lt;/span&gt;
   &lt;span slot="helpText"&gt;Enter a date no later than 12/31/2025.&lt;/span&gt;
 &lt;/auro-input&gt;</code></pre>
@@ -667,7 +667,7 @@
 <div class="exampleWrapper">
 <!-- AURO-GENERATED-CONTENT:START (FILE:src=../apiExamples/set-custom-validity-range-underflow.html) -->
 <!-- The below content is automatically added from ../apiExamples/set-custom-validity-range-underflow.html -->
-<auro-input type="date" min="2024-01-01" setCustomValidityRangeUnderflow="Date must be on or after 01/01/2024.">
+<auro-input type="date" min="01/01/2024" setCustomValidityRangeUnderflow="Date must be on or after 01/01/2024.">
 <span slot="label">Start Date</span>
 <span slot="helpText">Enter a date no earlier than 01/01/2024.</span>
 </auro-input>
@@ -677,7 +677,7 @@
 <span slot="trigger">See code</span>
 <!-- AURO-GENERATED-CONTENT:START (CODE:src=../apiExamples/set-custom-validity-range-underflow.html) -->
 <!-- The below code snippet is automatically added from ../apiExamples/set-custom-validity-range-underflow.html -->
-<pre class="language-html"><code class="language-html">&lt;auro-input type="date" min="2024-01-01" setCustomValidityRangeUnderflow="Date must be on or after 01/01/2024."&gt;
+<pre class="language-html"><code class="language-html">&lt;auro-input type="date" min="01/01/2024" setCustomValidityRangeUnderflow="Date must be on or after 01/01/2024."&gt;
   &lt;span slot="label"&gt;Start Date&lt;/span&gt;
   &lt;span slot="helpText"&gt;Enter a date no earlier than 01/01/2024.&lt;/span&gt;
 &lt;/auro-input&gt;</code></pre>
@@ -888,7 +888,7 @@
 <div class="exampleWrapper">
 <!-- AURO-GENERATED-CONTENT:START (FILE:src=../apiExamples/max-date.html) -->
 <!-- The below content is automatically added from ../apiExamples/max-date.html -->
-<auro-input type="date" max="2023-03-25" setCustomValidityRangeOverflow="The selected date is past the defined maximum date.">
+<auro-input type="date" max="03/25/2023" setCustomValidityRangeOverflow="The selected date is past the defined maximum date.">
 <span slot="label">Choose a date</span>
 <span slot="helpText">Help Text</span>
 </auro-input>
@@ -898,7 +898,7 @@
 <span slot="trigger">See code</span>
 <!-- AURO-GENERATED-CONTENT:START (CODE:src=../apiExamples/max-date.html) -->
 <!-- The below code snippet is automatically added from ../apiExamples/max-date.html -->
-<pre class="language-html"><code class="language-html">&lt;auro-input type="date" max="2023-03-25" setCustomValidityRangeOverflow="The selected date is past the defined maximum date."&gt;
+<pre class="language-html"><code class="language-html">&lt;auro-input type="date" max="03/25/2023" setCustomValidityRangeOverflow="The selected date is past the defined maximum date."&gt;
   &lt;span slot="label"&gt;Choose a date&lt;/span&gt;
   &lt;span slot="helpText"&gt;Help Text&lt;/span&gt;
 &lt;/auro-input&gt;</code></pre>
@@ -954,7 +954,7 @@
 <div class="exampleWrapper">
 <!-- AURO-GENERATED-CONTENT:START (FILE:src=../apiExamples/min-date.html) -->
 <!-- The below content is automatically added from ../apiExamples/min-date.html -->
-<auro-input type="date" min="2023-03-25" setCustomValidityRangeUnderflow="The selected date is before the defined minimum date.">
+<auro-input type="date" min="03/25/2023" setCustomValidityRangeUnderflow="The selected date is before the defined minimum date.">
 <span slot="label">Choose a date</span>
 <span slot="helpText">Help Text</span>
 </auro-input>
@@ -964,7 +964,7 @@
 <span slot="trigger">See code</span>
 <!-- AURO-GENERATED-CONTENT:START (CODE:src=../apiExamples/min-date.html) -->
 <!-- The below code snippet is automatically added from ../apiExamples/min-date.html -->
-<pre class="language-html"><code class="language-html">&lt;auro-input type="date" min="2023-03-25" setCustomValidityRangeUnderflow="The selected date is before the defined minimum date."&gt;
+<pre class="language-html"><code class="language-html">&lt;auro-input type="date" min="03/25/2023" setCustomValidityRangeUnderflow="The selected date is before the defined minimum date."&gt;
   &lt;span slot="label"&gt;Choose a date&lt;/span&gt;
   &lt;span slot="helpText"&gt;Help Text&lt;/span&gt;
 &lt;/auro-input&gt;</code></pre>

package/components/input/demo/customize.min.js

@@ -10385,13 +10385,6 @@ class AuroInputUtilities {
    * @returns {string | undefined}
    */
   toFormattedValue(valueObject, format) {
-    // Exposed publicly via `AuroInputUtil.toFormattedValue`, so a missing
-    // `format` argument has to fail gracefully rather than throw on
-    // `format.toLowerCase()`. Treat any falsy value (undefined, null, '')
-    // as "no format → no display value".
-    if (!format) {
-      return undefined;
-    }
     const normalizedFormat = format.toLowerCase();
     const maskOptions = this.getMaskOptions('date', normalizedFormat);
 
@@ -10542,18 +10535,79 @@ class BaseInput extends AuroElement {
   constructor() {
     super();
 
-    // Single-source initialization. Alphabetized so duplicate or stale
-    // defaults are immediately obvious on a diff. Every field is assigned
-    // exactly once here (previously the constructor + the old
-    // `_initializePrivateDefaults` overlapped — both wrote ~14 of the same
-    // fields and double-allocated `util` and `validation`, discarding the
-    // first instance). `validation` is now allocated exactly once; `util`
-    // is seeded here with an en-US default and then rebuilt in
-    // `connectedCallback` once the consumer-resolved locale is available,
-    // so a parent (datepicker/combobox) calling `validate()` synchronously
-    // during its own update cycle sees a populated util instance.
+    this.appearance = "default";
+    this.disabled = false;
+    this.layout = 'classic';
+    this.locale = 'en-US';
+    this.max = undefined;
+    this._maxObject = undefined;
+    this.maxLength = undefined;
+    this.min = undefined;
+    this._minObject = undefined;
+    this.minLength = undefined;
+    this.required = false;
+    this.onDark = false;
+    this.setCustomValidityForType = undefined;
+    this.size = 'lg';
+    this.shape = 'classic';
+    this.value = undefined;
+    this._valueObject = undefined;
+
+    this._initializePrivateDefaults();
+  }
+
+  /**
+   * Internal Defaults.
+   * @private
+   * @returns {void}
+   */
+  _initializePrivateDefaults() {
     this.activeLabel = false;
-    /** @private */
+    this.appearance = "default";
+    this.icon = false;
+    this.disabled = false;
+    this.dvInputOnly = false;
+    this.hideLabelVisually = false;
+    this.max = undefined;
+    this.maxLength = undefined;
+    this.min = undefined;
+    this.minLength = undefined;
+    this.noValidate = false;
+    this.onDark = false;
+    this.required = false;
+    this.setCustomValidityForType = undefined;
+
+    // Used for storing raw values returned from input mask.
+    this._rawMaskValue = undefined;
+
+    /**
+     * @private
+     */
+    this.layout = 'classic';
+
+    /**
+     * @private
+     */
+    this.shape = 'classic';
+
+    /**
+     * @private
+     */
+    this.size = 'lg';
+
+    this.touched = false;
+    this.util = new AuroInputUtilities({
+      locale: "en-US",
+      format: this.format
+    });
+    this.validation = new AuroFormValidation();
+    this.inputIconName = undefined;
+    this.showPassword = false;
+    this.validationCCLength = undefined;
+    this.hasValue = false;
+    this.label = 'Input label is undefined';
+
+
     this.allowedInputTypes = [
       "text",
       "number",
@@ -10562,8 +10616,7 @@ class BaseInput extends AuroElement {
       "credit-card",
       "tel"
     ];
-    this.appearance = "default";
-    /** @private */
+    this.icon = false;
     this.dateFormatMap = {
       'mm/dd/yyyy': 'dateMMDDYYYY',
       'dd/mm/yyyy': 'dateDDMMYYYY',
@@ -10580,57 +10633,27 @@ class BaseInput extends AuroElement {
       'dd/mm': 'dateDDMM',
       'mm/dd': 'dateMMDD'
     };
-    this.disabled = false;
-    /** @private */
     this.domHandler = new DomHandler();
     this.dvInputOnly = false;
     this.hasValue = false;
-    this.hideLabelVisually = false;
-    this.icon = false;
-    /** @private */
     this.inputIconName = undefined;
-    /** @private */
     this.label = 'Input label is undefined';
-    this.layout = 'classic';
-    this.locale = 'en-US';
-    this.max = undefined;
-    this._maxObject = undefined;
-    this.maxLength = undefined;
-    this.min = undefined;
-    this._minObject = undefined;
-    this.minLength = undefined;
     this.noValidate = false;
-    this.onDark = false;
-    // Raw values returned from the input mask before model normalization.
-    this._rawMaskValue = undefined;
-    this.required = false;
-    this.setCustomValidityForType = undefined;
-    // Credit Card is intentionally excluded — its mask manages the cursor
-    // itself, and listing it here caused cursor placement issues in Safari.
-    /** @private */
+    this._rawMaskValue = undefined; // Used for storing raw values returned from input mask.
     this.setSelectionInputTypes = [
       "text",
       "password",
       "email"
-    ];
-    this.shape = 'classic';
-    /** @private */
+    ]; // Credit Card is not included as this caused cursor placement issues in Safari.
     this.showPassword = false;
-    this.size = 'lg';
     this.touched = false;
-    /** @private */
     this.uniqueId = new UniqueId().create();
-    /** @private */
     this.util = new AuroInputUtilities({
       locale: this.locale,
       format: this.format
     });
-    /** @private */
     this.validation = new AuroFormValidation();
-    /** @private */
     this.validationCCLength = undefined;
-    this.value = undefined;
-    this._valueObject = undefined;
   }
 
   // function to define props used within the scope of this component
@@ -11178,15 +11201,6 @@ class BaseInput extends AuroElement {
 
     this.inputId = this.id ? `${this.id}-input` : window.crypto.randomUUID();
 
-    // Normalize the format token to lowercase so case-mixed values supplied
-    // via attribute (e.g. `format="MM/DD/YYYY"`) hit the `dateFormatMap`
-    // lookup inside `setCustomHelpTextMessage`. Without this, an uppercase
-    // format silently misses the map and leaves `setCustomValidityForType`
-    // unset.
-    if (this.format) {
-      this.format = this.format.toLowerCase();
-    }
-
     // use validity message override if declared when initializing the component
     if (this.hasAttribute('setCustomValidity')) {
       this.ValidityMessageOverride = this.setCustomValidity;
@@ -11620,38 +11634,6 @@ class BaseInput extends AuroElement {
       this.touched = true;
       this.validation.validate(this);
     }
-
-    // Prevents cursor jumping in Safari. Setting `this.value` triggers a Lit
-    // update that can re-render the input and reset the native cursor; we
-    // capture the caret position before that update commits and restore it
-    // via `setSelectionRange` once the update has flushed. Gated on
-    // `setSelectionInputTypes` so credit-card (and other masked types whose
-    // formatter manages the cursor itself) doesn't get a competing write.
-    // Capture the caret position INSIDE the gate — reading `selectionStart`
-    // on input types that don't support text selection (number, email in
-    // some browsers) throws InvalidStateError, which would crash all input
-    // handling. Wrap the read in try/catch belt-and-suspenders even though
-    // the gated types currently support it, since the list is a public
-    // property a consumer could mutate.
-    if (this.setSelectionInputTypes.includes(this.type)) {
-      let selectionStart;
-      try {
-        selectionStart = this.inputElement.selectionStart;
-      } catch (error) { // eslint-disable-line no-unused-vars
-        return;
-      }
-      if (typeof selectionStart !== 'number') {
-        return;
-      }
-      this.updateComplete.then(() => {
-        try {
-          this.inputElement.setSelectionRange(selectionStart, selectionStart);
-        } catch (error) { // eslint-disable-line no-unused-vars
-          // Some input types (number/email in certain UAs) throw on
-          // setSelectionRange; swallow and let the native cursor stand.
-        }
-      });
-    }
   }
 
   /**
@@ -12278,7 +12260,7 @@ class AuroHelpText extends i$3 {
   }
 }
 
-var formkitVersion = '202606291956';
+var formkitVersion = '202606291748';
 
 /**
  * @license
@@ -12793,7 +12775,6 @@ class AuroInput extends BaseInput {
         <${this.buttonTag}
           @click="${this.handleClickShowPassword}"
           appearance="${this.onDark ? 'inverse' : this.appearance}"
-          aria-pressed="${this.showPassword ? 'true' : 'false'}"
           class="notificationBtn passwordBtn"
           shape="circle"
           size="sm"
@@ -12867,29 +12848,25 @@ class AuroInput extends BaseInput {
    * @returns {html} - Returns HTML for the help text and error message.
    */
   renderHtmlHelpText() {
-    // Single `<p>` with stable identity across validity transitions —
-    // previously two distinct templates (valid vs invalid) caused Lit to
-    // replace the node entirely on a flip, and VoiceOver wouldn't
-    // re-announce because the live-region element it was watching had been
-    // removed and a new one inserted. Keeping one node means the `role`,
-    // `aria-live`, and text content all change in-place, which AT does
-    // observe and announce.
-    const isError = this.validity && this.validity !== 'valid';
     return u$4`
-      <${this.helpTextTag}
-        appearance="${this.onDark ? 'inverse' : this.appearance}"
-        ?error=${isError}>
-        <p
-          id="${this.uniqueId}"
-          part="helpText"
-          role="${o$2(isError ? 'alert' : undefined)}"
-          aria-live="${o$2(isError ? 'assertive' : undefined)}">
-          ${isError
-        ? this.errorMessage
-        : u$4`<slot name="helpText">${this.getHelpText()}</slot>`
+      ${!this.validity || this.validity === undefined || this.validity === 'valid'
+        ? u$4`
+          <${this.helpTextTag}
+            appearance="${this.onDark ? 'inverse' : this.appearance}">
+            <p id="${this.uniqueId}" part="helpText">
+              <slot name="helpText">${this.getHelpText()}</slot>
+            </p>
+          </${this.helpTextTag}>
+        `
+        : u$4`
+          <${this.helpTextTag} error
+            appearance="${this.onDark ? 'inverse' : this.appearance}">
+            <p id="${this.uniqueId}" role="alert" aria-live="assertive" part="helpText">
+              ${this.errorMessage}
+            </p>
+          </${this.helpTextTag}>
+        `
       }
-        </p>
-      </${this.helpTextTag}>
     `;
   }