@aurodesignsystem-dev/auro-formkit 0.0.0-pr1532.1 → 0.0.0-pr1533.1

package/components/form/dist/auro-form.d.ts

@@ -1,6 +1,6 @@
 /**
  * @typedef {Object} FormStateMember - The form state member.
- * @property {string | number | boolean | string[] | null} value - The value of the form element.
+ * @property {string | number | boolean | string[] | Record<string, number> | null} value - The value of the form element. Mirrors the child component's own `.value`, so the shape varies by element type (e.g. an array for `auro-checkbox-group`, an object keyed by counter name for `auro-counter-group`). A `range` `auro-datepicker` is the one form-specific case: its `.values` array is stored rather than its single `.value` string.
  * @property {ValidityState} validity - The validity state of the form element, stored when fired from the form element.
  * @property {boolean} required - Whether the form element is required or not.
  * @property {boolean} disabled - Whether the form element is currently disabled. Cached from the live attribute via the MutationObserver in `connectedCallback` and refreshed from `_handleAttributeMutations`.
@@ -102,7 +102,7 @@ export class AuroForm extends LitElement {
      * `_setInitialState` can detect user edits as `current !== initial`,
      * matching HTML's `dirtyValueFlag` semantics.
      * @private
-     * @type {Record<string, string | number | boolean | string[] | null | undefined>}
+     * @type {Record<string, string | number | boolean | string[] | Record<string, number> | null | undefined>}
      */
     private _initialValues;
     /**
@@ -229,10 +229,10 @@ export class AuroForm extends LitElement {
      */
     private isButtonElement;
     /**
-     * Returns the current values of all named form elements as a key-value object, keyed by each element's `name` attribute.
-     * @returns {Record<string, string | number | boolean | string[] | null>} The current form values.
+     * Returns the current values of all named, enabled form elements as a key-value object, keyed by each element's `name` attribute. Each value is the child component's own `.value`, so the shape depends on the element type — see that component's documentation for its exact shape (for example, `auro-checkbox-group` yields an array, `auro-counter-group` yields an object keyed by counter name, and `auro-select` with `multiSelect` yields a JSON-encoded string). The one form-specific exception is a `range` `auro-datepicker`, whose `.values` array (`[start, end]`) is stored instead of its single `.value` string.
+     * @returns {Record<string, string | number | boolean | string[] | Record<string, number> | null>} The current form values.
      */
-    get value(): Record<string, string | number | boolean | string[] | null>;
+    get value(): Record<string, string | number | boolean | string[] | Record<string, number> | null>;
     /**
      * Getter for internal _submitElements.
      * @returns {HTMLButtonElement[]}
@@ -373,9 +373,9 @@ export class AuroForm extends LitElement {
  */
 export type FormStateMember = {
     /**
-     * - The value of the form element.
+     * - The value of the form element. Mirrors the child component's own `.value`, so the shape varies by element type (e.g. an array for `auro-checkbox-group`, an object keyed by counter name for `auro-counter-group`). A `range` `auro-datepicker` is the one form-specific case: its `.values` array is stored rather than its single `.value` string.
      */
-    value: string | number | boolean | string[] | null;
+    value: string | number | boolean | string[] | Record<string, number> | null;
     /**
      * - The validity state of the form element, stored when fired from the form element.
      */

package/components/form/dist/index.js

@@ -90,7 +90,7 @@ class AuroLibraryRuntimeUtils {
 
 /**
  * @typedef {Object} FormStateMember - The form state member.
- * @property {string | number | boolean | string[] | null} value - The value of the form element.
+ * @property {string | number | boolean | string[] | Record<string, number> | null} value - The value of the form element. Mirrors the child component's own `.value`, so the shape varies by element type (e.g. an array for `auro-checkbox-group`, an object keyed by counter name for `auro-counter-group`). A `range` `auro-datepicker` is the one form-specific case: its `.values` array is stored rather than its single `.value` string.
  * @property {ValidityState} validity - The validity state of the form element, stored when fired from the form element.
  * @property {boolean} required - Whether the form element is required or not.
  * @property {boolean} disabled - Whether the form element is currently disabled. Cached from the live attribute via the MutationObserver in `connectedCallback` and refreshed from `_handleAttributeMutations`.
@@ -184,7 +184,7 @@ class AuroForm extends LitElement {
      * `_setInitialState` can detect user edits as `current !== initial`,
      * matching HTML's `dirtyValueFlag` semantics.
      * @private
-     * @type {Record<string, string | number | boolean | string[] | null | undefined>}
+     * @type {Record<string, string | number | boolean | string[] | Record<string, number> | null | undefined>}
      */
     this._initialValues = {};
 
@@ -343,8 +343,8 @@ class AuroForm extends LitElement {
   }
 
   /**
-   * Returns the current values of all named form elements as a key-value object, keyed by each element's `name` attribute.
-   * @returns {Record<string, string | number | boolean | string[] | null>} The current form values.
+   * Returns the current values of all named, enabled form elements as a key-value object, keyed by each element's `name` attribute. Each value is the child component's own `.value`, so the shape depends on the element type — see that component's documentation for its exact shape (for example, `auro-checkbox-group` yields an array, `auro-counter-group` yields an object keyed by counter name, and `auro-select` with `multiSelect` yields a JSON-encoded string). The one form-specific exception is a `range` `auro-datepicker`, whose `.values` array (`[start, end]`) is stored instead of its single `.value` string.
+   * @returns {Record<string, string | number | boolean | string[] | Record<string, number> | null>} The current form values.
    */
   get value() {
     return Object.keys(this.formState).reduce((acc, key) => {

package/components/form/dist/registered.js

@@ -90,7 +90,7 @@ class AuroLibraryRuntimeUtils {
 
 /**
  * @typedef {Object} FormStateMember - The form state member.
- * @property {string | number | boolean | string[] | null} value - The value of the form element.
+ * @property {string | number | boolean | string[] | Record<string, number> | null} value - The value of the form element. Mirrors the child component's own `.value`, so the shape varies by element type (e.g. an array for `auro-checkbox-group`, an object keyed by counter name for `auro-counter-group`). A `range` `auro-datepicker` is the one form-specific case: its `.values` array is stored rather than its single `.value` string.
  * @property {ValidityState} validity - The validity state of the form element, stored when fired from the form element.
  * @property {boolean} required - Whether the form element is required or not.
  * @property {boolean} disabled - Whether the form element is currently disabled. Cached from the live attribute via the MutationObserver in `connectedCallback` and refreshed from `_handleAttributeMutations`.
@@ -184,7 +184,7 @@ class AuroForm extends LitElement {
      * `_setInitialState` can detect user edits as `current !== initial`,
      * matching HTML's `dirtyValueFlag` semantics.
      * @private
-     * @type {Record<string, string | number | boolean | string[] | null | undefined>}
+     * @type {Record<string, string | number | boolean | string[] | Record<string, number> | null | undefined>}
      */
     this._initialValues = {};
 
@@ -343,8 +343,8 @@ class AuroForm extends LitElement {
   }
 
   /**
-   * Returns the current values of all named form elements as a key-value object, keyed by each element's `name` attribute.
-   * @returns {Record<string, string | number | boolean | string[] | null>} The current form values.
+   * Returns the current values of all named, enabled form elements as a key-value object, keyed by each element's `name` attribute. Each value is the child component's own `.value`, so the shape depends on the element type — see that component's documentation for its exact shape (for example, `auro-checkbox-group` yields an array, `auro-counter-group` yields an object keyed by counter name, and `auro-select` with `multiSelect` yields a JSON-encoded string). The one form-specific exception is a `range` `auro-datepicker`, whose `.values` array (`[start, end]`) is stored instead of its single `.value` string.
+   * @returns {Record<string, string | number | boolean | string[] | Record<string, number> | null>} The current form values.
    */
   get value() {
     return Object.keys(this.formState).reduce((acc, key) => {

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

@@ -10657,14 +10657,16 @@ class BaseInput extends AuroElement {
     this.label = 'Input label is undefined';
     this.layout = 'classic';
     this.locale = 'en-US';
+    this._format = undefined;
+
+    /** @private */
+    this._userSetFormat = false;
     this.max = undefined;
     this.maxLength = undefined;
     this.min = 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
@@ -10822,7 +10824,8 @@ class BaseInput extends AuroElement {
        */
       format: {
         type: String,
-        reflect: true
+        reflect: true,
+        noAccessor: true
       },
 
       /**
@@ -11160,6 +11163,34 @@ class BaseInput extends AuroElement {
     return this.max && dateFormatter.isValidDate(this.max) ? dateFormatter.stringToDateInstance(this.max) : undefined;
   }
 
+  get format() {
+    return this._format;
+  }
+
+  /**
+   * Overrides LitElement's generated accessor so we can track whether the
+   * consumer explicitly set `format`. Locale-derived updates use
+   * `_setFormatFromLocale` instead, which skips this flag.
+   */
+  set format(value) {
+    const oldValue = this._format;
+    this._format = value ? value.toLowerCase() : value;
+    this._userSetFormat = Boolean(value);
+    this.requestUpdate('format', oldValue);
+  }
+
+  /**
+   * Sets format without marking it as user-set. Used by locale auto-derive
+   * so that a subsequent locale change can still update the format.
+   * @private
+   * @param {string} value
+   */
+  _setFormatFromLocale(value) {
+    const oldValue = this._format;
+    this._format = value ? value.toLowerCase() : value;
+    this.requestUpdate('format', oldValue);
+  }
+
   connectedCallback() {
     super.connectedCallback();
 
@@ -11207,15 +11238,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;
@@ -11322,12 +11344,10 @@ class BaseInput extends AuroElement {
   updated(changedProperties) {
     super.updated(changedProperties);
 
-    // When locale changes without an explicit format override, derive format from the new locale.
-    // Only runs if the current format is still the previous locale's default (not user-overridden).
+    // When locale changes, auto-derive format unless the consumer explicitly set one.
     if (changedProperties.has('locale') && !changedProperties.has('format') && this.type === 'date') {
-      const previousLocaleFormat = getDateFormatFromLocale(changedProperties.get('locale'));
-      if (!this.format || this.format.toLowerCase() === previousLocaleFormat) {
-        this.format = getDateFormatFromLocale(this.locale);
+      if (!this._userSetFormat) {
+        this._setFormatFromLocale(getDateFormatFromLocale(this.locale));
       }
     }
 
@@ -11498,9 +11518,6 @@ class BaseInput extends AuroElement {
         this.maskInstance.on('accept', () => {
           if (this._configuringMask) return;
           this.value = this.util.toModelValue(this.maskInstance.value, this.format);
-          if (this.type === "date") {
-            this._rawMaskValue = this.maskInstance.value;
-          }
         });
 
         // Mask fires 'complete' on the restore step below for any value that
@@ -11508,9 +11525,6 @@ class BaseInput extends AuroElement {
         this.maskInstance.on('complete', () => {
           if (this._configuringMask) return;
           this.value = this.util.toModelValue(this.maskInstance.value, this.format);
-          if (this.type === "date") {
-            this._rawMaskValue = this.maskInstance.value;
-          }
         });
 
         // Write existingValue through the mask (not the input directly) so
@@ -11531,14 +11545,17 @@ class BaseInput extends AuroElement {
    * @returns {void}
    */
   notifyValueChanged() {
-    let inputEvent = null;
-
-    inputEvent = new Event('input', {
+    // This echoes Lit's reactive value update (and handleClickClear's
+    // programmatic clear) — it is NOT a fresh user-input event. Mark it
+    // `isProgrammatic` so consumers (e.g. auro-combobox) can distinguish
+    // it from genuine user typing and skip clobbering their own
+    // programmatic state during init-time renders.
+    const inputEvent = new Event('input', {
       bubbles: true,
       composed: true,
     });
+    inputEvent.isProgrammatic = true;
 
-    // Dispatched event to alert outside shadow DOM context of event firing.
     this.dispatchEvent(inputEvent);
   }
 
@@ -11747,8 +11764,7 @@ class BaseInput extends AuroElement {
 
     // Set default date format if type=date and no format is defined
     if (this.type === "date" && !this.format) {
-      // Use locale to determine default date format
-      this.format = this.util.getDateMaskFromLocale().toLowerCase();
+      this._setFormatFromLocale(this.util.getDateMaskFromLocale().toLowerCase());
       this.util.updateFormat(this.format);
     }
   }
@@ -11777,7 +11793,7 @@ class BaseInput extends AuroElement {
     const creditCard = this.matchInputValueToCreditCard();
     const previousFormat = this.format;
 
-    this.format = creditCard.maskFormat;
+    this._setFormatFromLocale(creditCard.maskFormat);
 
     this.maxLength = creditCard.formatLength;
     this.minLength = creditCard.formatMinLength;
@@ -12251,7 +12267,7 @@ class AuroHelpText extends i$3 {
   }
 }
 
-var formkitVersion = '202607022050';
+var formkitVersion = '202607071532';
 
 /**
  * @license
@@ -12549,20 +12565,15 @@ class AuroInput extends BaseInput {
    * @returns {void}
    */
   checkDisplayValueSlotChange() {
-    let nodes = this.shadowRoot.querySelector('slot[name="displayValue"]').assignedNodes();
-
-    // Handle when DisplayValue is multi-level slot content (e.g. combobox passing displayValue to input)
-    if (nodes && nodes[0] && nodes[0].tagName === 'SLOT') {
-      nodes = nodes[0].assignedNodes();
-    }
-
-    let hasContent = false;
-
-    if (nodes.length > 0) {
-      hasContent = true;
-    }
-
-    this.hasDisplayValueContent = hasContent;
+    // flatten:true resolves through auro-combobox's forwarding slot
+    // (<slot name="displayValue" slot="displayValue">) so a clone appended
+    // directly to auro-input's light DOM alongside the forwarder still
+    // counts as content. The prior nodes[0].tagName === 'SLOT' recursion
+    // discarded any siblings past the forwarder.
+    const slot = this.shadowRoot.querySelector('slot[name="displayValue"]');
+    const nodes = slot.assignedNodes({ flatten: true });
+
+    this.hasDisplayValueContent = nodes.length > 0;
   }
 
   firstUpdated() {

package/components/input/demo/getting-started.min.js

@@ -10657,14 +10657,16 @@ class BaseInput extends AuroElement {
     this.label = 'Input label is undefined';
     this.layout = 'classic';
     this.locale = 'en-US';
+    this._format = undefined;
+
+    /** @private */
+    this._userSetFormat = false;
     this.max = undefined;
     this.maxLength = undefined;
     this.min = 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
@@ -10822,7 +10824,8 @@ class BaseInput extends AuroElement {
        */
       format: {
         type: String,
-        reflect: true
+        reflect: true,
+        noAccessor: true
       },
 
       /**
@@ -11160,6 +11163,34 @@ class BaseInput extends AuroElement {
     return this.max && dateFormatter.isValidDate(this.max) ? dateFormatter.stringToDateInstance(this.max) : undefined;
   }
 
+  get format() {
+    return this._format;
+  }
+
+  /**
+   * Overrides LitElement's generated accessor so we can track whether the
+   * consumer explicitly set `format`. Locale-derived updates use
+   * `_setFormatFromLocale` instead, which skips this flag.
+   */
+  set format(value) {
+    const oldValue = this._format;
+    this._format = value ? value.toLowerCase() : value;
+    this._userSetFormat = Boolean(value);
+    this.requestUpdate('format', oldValue);
+  }
+
+  /**
+   * Sets format without marking it as user-set. Used by locale auto-derive
+   * so that a subsequent locale change can still update the format.
+   * @private
+   * @param {string} value
+   */
+  _setFormatFromLocale(value) {
+    const oldValue = this._format;
+    this._format = value ? value.toLowerCase() : value;
+    this.requestUpdate('format', oldValue);
+  }
+
   connectedCallback() {
     super.connectedCallback();
 
@@ -11207,15 +11238,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;
@@ -11322,12 +11344,10 @@ class BaseInput extends AuroElement {
   updated(changedProperties) {
     super.updated(changedProperties);
 
-    // When locale changes without an explicit format override, derive format from the new locale.
-    // Only runs if the current format is still the previous locale's default (not user-overridden).
+    // When locale changes, auto-derive format unless the consumer explicitly set one.
     if (changedProperties.has('locale') && !changedProperties.has('format') && this.type === 'date') {
-      const previousLocaleFormat = getDateFormatFromLocale(changedProperties.get('locale'));
-      if (!this.format || this.format.toLowerCase() === previousLocaleFormat) {
-        this.format = getDateFormatFromLocale(this.locale);
+      if (!this._userSetFormat) {
+        this._setFormatFromLocale(getDateFormatFromLocale(this.locale));
       }
     }
 
@@ -11498,9 +11518,6 @@ class BaseInput extends AuroElement {
         this.maskInstance.on('accept', () => {
           if (this._configuringMask) return;
           this.value = this.util.toModelValue(this.maskInstance.value, this.format);
-          if (this.type === "date") {
-            this._rawMaskValue = this.maskInstance.value;
-          }
         });
 
         // Mask fires 'complete' on the restore step below for any value that
@@ -11508,9 +11525,6 @@ class BaseInput extends AuroElement {
         this.maskInstance.on('complete', () => {
           if (this._configuringMask) return;
           this.value = this.util.toModelValue(this.maskInstance.value, this.format);
-          if (this.type === "date") {
-            this._rawMaskValue = this.maskInstance.value;
-          }
         });
 
         // Write existingValue through the mask (not the input directly) so
@@ -11531,14 +11545,17 @@ class BaseInput extends AuroElement {
    * @returns {void}
    */
   notifyValueChanged() {
-    let inputEvent = null;
-
-    inputEvent = new Event('input', {
+    // This echoes Lit's reactive value update (and handleClickClear's
+    // programmatic clear) — it is NOT a fresh user-input event. Mark it
+    // `isProgrammatic` so consumers (e.g. auro-combobox) can distinguish
+    // it from genuine user typing and skip clobbering their own
+    // programmatic state during init-time renders.
+    const inputEvent = new Event('input', {
       bubbles: true,
       composed: true,
     });
+    inputEvent.isProgrammatic = true;
 
-    // Dispatched event to alert outside shadow DOM context of event firing.
     this.dispatchEvent(inputEvent);
   }
 
@@ -11747,8 +11764,7 @@ class BaseInput extends AuroElement {
 
     // Set default date format if type=date and no format is defined
     if (this.type === "date" && !this.format) {
-      // Use locale to determine default date format
-      this.format = this.util.getDateMaskFromLocale().toLowerCase();
+      this._setFormatFromLocale(this.util.getDateMaskFromLocale().toLowerCase());
       this.util.updateFormat(this.format);
     }
   }
@@ -11777,7 +11793,7 @@ class BaseInput extends AuroElement {
     const creditCard = this.matchInputValueToCreditCard();
     const previousFormat = this.format;
 
-    this.format = creditCard.maskFormat;
+    this._setFormatFromLocale(creditCard.maskFormat);
 
     this.maxLength = creditCard.formatLength;
     this.minLength = creditCard.formatMinLength;
@@ -12251,7 +12267,7 @@ class AuroHelpText extends i$3 {
   }
 }
 
-var formkitVersion = '202607022050';
+var formkitVersion = '202607071532';
 
 /**
  * @license
@@ -12549,20 +12565,15 @@ class AuroInput extends BaseInput {
    * @returns {void}
    */
   checkDisplayValueSlotChange() {
-    let nodes = this.shadowRoot.querySelector('slot[name="displayValue"]').assignedNodes();
-
-    // Handle when DisplayValue is multi-level slot content (e.g. combobox passing displayValue to input)
-    if (nodes && nodes[0] && nodes[0].tagName === 'SLOT') {
-      nodes = nodes[0].assignedNodes();
-    }
-
-    let hasContent = false;
-
-    if (nodes.length > 0) {
-      hasContent = true;
-    }
-
-    this.hasDisplayValueContent = hasContent;
+    // flatten:true resolves through auro-combobox's forwarding slot
+    // (<slot name="displayValue" slot="displayValue">) so a clone appended
+    // directly to auro-input's light DOM alongside the forwarder still
+    // counts as content. The prior nodes[0].tagName === 'SLOT' recursion
+    // discarded any siblings past the forwarder.
+    const slot = this.shadowRoot.querySelector('slot[name="displayValue"]');
+    const nodes = slot.assignedNodes({ flatten: true });
+
+    this.hasDisplayValueContent = nodes.length > 0;
   }
 
   firstUpdated() {