@aurodesignsystem-dev/auro-formkit 0.0.0-pr1507.0 → 0.0.0-pr1508.1

package/custom-elements.json

@@ -1164,6 +1164,33 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "_scheduleTimer",
+              "parameters": [
+                {
+                  "name": "fn",
+                  "description": "Callback to run.",
+                  "type": {
+                    "text": "Function"
+                  }
+                },
+                {
+                  "name": "ms",
+                  "description": "Delay in milliseconds.",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "description": "setTimeout wrapper that records the timer id so disconnectedCallback\ncan cancel any outstanding callbacks. The id is removed from the set\nonce the callback fires so the set doesn't grow unbounded.",
+              "return": {
+                "type": {
+                  "text": "number"
+                }
+              },
+              "privacy": "private"
+            },
             {
               "kind": "field",
               "name": "inputValue",
@@ -1256,6 +1283,26 @@
               "description": "Update displayValue or input.value, it's called when making a selection.",
               "privacy": "private"
             },
+            {
+              "kind": "method",
+              "name": "syncInputValuesAcrossTriggerAndBib",
+              "parameters": [
+                {
+                  "name": "nextValue",
+                  "description": "The value to write to both inputs.",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Writes nextValue to the trigger input and the bib input when their current\nvalue differs, then re-asserts imask after Lit's update flushes.",
+              "return": {
+                "type": {
+                  "text": "Promise<void>"
+                }
+              },
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "handleMenuOptions",
@@ -1423,6 +1470,26 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "handleTriggerInputValueChange",
+              "parameters": [
+                {
+                  "name": "event",
+                  "description": "The input event from the trigger input element.",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ],
+              "description": "Handles input value changes originating from the trigger input.\nRefreshes menu options and filtering, delegates to handleInputValueChange\nfor value synchronization, and manages fullscreen bib focus.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
             {
               "kind": "method",
               "name": "configureCombobox",
@@ -1995,15 +2062,6 @@
               },
               "description": "Specifies the currently active option."
             },
-            {
-              "kind": "field",
-              "name": "triggerExpandedState",
-              "privacy": "private",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "Deferred aria-expanded state for the trigger input.\nDelays the \"true\" transition so VoiceOver finishes its character echo\nbefore announcing \"expanded\"."
-            },
             {
               "kind": "field",
               "name": "componentHasFocus",
@@ -2454,7 +2512,7 @@
           "type": {
             "text": "object"
           },
-          "default": "{ ArrowDown(component, evt, ctx) { // If the clear button has focus, let the browser handle ArrowDown normally. if (isClearBtnFocused(ctx)) { return; } // option display and navigation are prevented if there are no available options if (component.availableOptions.length > 0) { evt.preventDefault(); // navigate if bib is open otherwise open it if (component.dropdown.isPopoverVisible) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { component.activateLastEnabledAvailableOption(); } else { navigateArrow(component, 'down'); } } else { component.showBib(); } } }, ArrowUp(component, evt, ctx) { // If the clear button has focus, let the browser handle ArrowUp normally. if (isClearBtnFocused(ctx)) { return; } // option display and navigation are prevented if there are no available options if (component.availableOptions.length > 0) { evt.preventDefault(); // navigate if bib is open otherwise open it if (component.dropdown.isPopoverVisible) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { component.activateFirstEnabledAvailableOption(); } else { navigateArrow(component, 'up'); } } else { component.showBib(); } } }, End(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateLastEnabledAvailableOption(); } }, Enter(component, evt, ctx) { if (isClearBtnFocused(ctx)) { // If the clear button has focus, let the browser activate it normally. // stopPropagation prevents parent containers (e.g., forms) from treating // Enter as a submit, but we must NOT call preventDefault — that would // block the browser's built-in \"Enter activates focused button\" behavior. evt.stopPropagation(); } else if (ctx.isExpanded && component.menu.optionActive) { reconcileMenuIndex(component.menu); component.menu.makeSelection(); if (ctx.isModal) { component.setTriggerInputFocus(); } evt.preventDefault(); evt.stopPropagation(); } else { // Prevent the keypress from bubbling to parent containers (e.g., forms) // which could interpret Enter as a submit or trigger other unintended behavior. // This is safe because showBib() opens the dialog programmatically, // not via event propagation. evt.preventDefault(); evt.stopPropagation(); component.showBib(); } }, Escape(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Prevent the Escape key from bubbling up and closing any parent dialogs / drawers / popups evt.stopPropagation(); if (ctx.isModal) { component.setTriggerInputFocus(); } component.hideBib(); }, Home(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateFirstEnabledAvailableOption(); } }, Tab(component, evt, ctx) { if (ctx.isExpanded && !isClearBtnFocused(ctx)) { // When the clear button is focused, Tab events do not bubble out of // its shadow DOM, so this handler only fires when the clear button // is NOT focused. In that case, select the active option and close. reconcileMenuIndex(component.menu); component.menu.makeSelection(); component.hideBib(); // In fullscreen modal mode, closing the dialog does not // automatically restores focus to the input. In the tab case, // Explicitly move focus to the trigger's clear button so the // user can continues tabbing through the page normally. if (ctx.isModal && !evt.shiftKey) { component.setClearBtnFocus(); } } }, }"
+          "default": "{ ArrowDown(component, evt, ctx) { // If the clear button has focus, let the browser handle ArrowDown normally. if (isClearBtnFocused(ctx)) { return; } // option display and navigation are prevented if there are no available options if (component.availableOptions.length > 0) { evt.preventDefault(); // navigate if bib is open otherwise open it if (component.dropdown.isPopoverVisible) { navigateArrow(component, 'down'); } else { component.showBib(); } } }, ArrowUp(component, evt, ctx) { // If the clear button has focus, let the browser handle ArrowUp normally. if (isClearBtnFocused(ctx)) { return; } // option display and navigation are prevented if there are no available options if (component.availableOptions.length > 0) { evt.preventDefault(); // navigate if bib is open otherwise open it if (component.dropdown.isPopoverVisible) { navigateArrow(component, 'up'); } else { component.showBib(); } } }, End(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateLastEnabledAvailableOption(); } }, Enter(component, evt, ctx) { // Forms should not submit on Enter from a combobox, regardless of which // child element (input, clear button, menu) is focused. evt.stopPropagation(); if (isClearBtnFocused(ctx)) { // Let the browser dispatch Enter to the focused clear button so its // built-in activation fires and clears the selection. Do NOT call // preventDefault — that would block the activation. return; } if (ctx.isExpanded && component.menu.optionActive) { reconcileMenuIndex(component.menu); component.menu.makeSelection(); if (ctx.isModal) { component.setTriggerInputFocus(); } evt.preventDefault(); } else { evt.preventDefault(); component.showBib(); } }, Escape(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Prevent the Escape key from bubbling up and closing any parent dialogs / drawers / popups evt.stopPropagation(); if (ctx.isModal) { component.setTriggerInputFocus(); } component.hideBib(); }, Home(component, evt, ctx) { if (ctx.isExpanded) { evt.preventDefault(); evt.stopPropagation(); component.activateFirstEnabledAvailableOption(); } }, Tab(component, evt, ctx) { if (ctx.isExpanded && !isClearBtnFocused(ctx)) { // When the clear button is focused, Tab events do not bubble out of // its shadow DOM, so this handler only fires when the clear button // is NOT focused. In that case, select the active option and close. reconcileMenuIndex(component.menu); component.menu.makeSelection(); component.hideBib(); // In fullscreen modal mode, closing the dialog does not // automatically restores focus to the input. In the tab case, // Explicitly move focus to the trigger's clear button so the // user can continues tabbing through the page normally. if (ctx.isModal && !evt.shiftKey) { component.setClearBtnFocus(); } } } }"
         }
       ],
       "exports": [
@@ -4577,7 +4635,7 @@
             {
               "kind": "method",
               "name": "updateHostAria",
-              "description": "Updates ARIA attributes on the host element so that\nariaActiveDescendantElement can expose cell info to the SR.",
+              "description": "Sets host-level ARIA so each cell exposes its date, selection state,\nand blackout status to assistive tech browsing the month grid.",
               "privacy": "private",
               "return": {
                 "type": {
@@ -4598,7 +4656,7 @@
             {
               "kind": "method",
               "name": "setActive",
-              "description": "Imperatively marks this cell as active without triggering a Lit re-render.\nNote: buttons stay tabindex=\"-1\" because the grid uses aria-activedescendant.",
+              "description": "Imperatively marks this cell as active without triggering a Lit re-render.\nButtons stay tabindex=\"-1\" because DOM focus stays on the grid wrapper —\narrow keys move the active cell imperatively and the live region carries\nthe SR announcement.\n\nRefuses to activate out-of-range cells: those are aria-hidden, have no\nclick/focus handlers, and are filtered out of `getFocusableCells`. The\nactive class showing on a disabled cell would be visually misleading,\nso this guard is the single source of truth across every code path\nthat might call setActive (keyboard nav, focus restore, cell click).",
               "return": {
                 "type": {
                   "text": "void"
@@ -4743,6 +4801,7 @@
               "type": {
                 "text": "array"
               },
+              "deprecated": "Propagated from the legacy `auro-calendar.disabledDays`\nUnix-timestamp array. The cell honors it for backward compatibility\n(see the divergence-check fallback inside `isBlackout`), but\nconsumers should migrate to `auro-datepicker.blackoutDates`\n(YYYY-MM-DD ISO strings). The calendar emits a one-time\ndeprecation warning the first time a non-empty value is observed.",
               "default": "[]",
               "attribute": "disabledDays"
             },
@@ -4902,6 +4961,7 @@
               "type": {
                 "text": "array"
               },
+              "deprecated": "Propagated from the legacy `auro-calendar.disabledDays`\nUnix-timestamp array. The cell honors it for backward compatibility\n(see the divergence-check fallback inside `isBlackout`), but\nconsumers should migrate to `auro-datepicker.blackoutDates`\n(YYYY-MM-DD ISO strings). The calendar emits a one-time\ndeprecation warning the first time a non-empty value is observed.",
               "default": "[]",
               "fieldName": "disabledDays"
             },
@@ -5306,6 +5366,26 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "_afterMonthRender",
+              "parameters": [
+                {
+                  "name": "callback",
+                  "description": "Runs once after the month re-render and\nthe cells' button caches have refreshed.",
+                  "type": {
+                    "text": "() => void"
+                  }
+                }
+              ],
+              "description": "Schedules `callback` two animation frames out, giving the child\n`auro-formkit-calendar-month` and `auro-formkit-calendar-cell` elements\na full render-and-paint cycle to settle before the callback reads or\nmutates DOM.\n\nWhy two frames, not one:\n1. Lit batches property updates and renders in a microtask, so frame N\n   schedules the render but the new DOM may not be painted yet.\n2. Cells re-cache `_cachedButton` inside their own `updateComplete.then`,\n   which also lands a tick later. Reading buttons from frame N+1\n   (after both renders + cache refresh have flushed) reliably hits the\n   new month's cells.\n\nUsed by every code path that calls `handleNextMonth`/`handlePrevMonth`\nand then needs to inspect the freshly-rendered cells (cross-month\nkeyboard nav, boundary events, `updateActiveCellForVisibleMonth`).\nDo NOT collapse to a single rAF — it intermittently lands before\n`_cachedButton` is refreshed, which silently breaks focus restoration\nand `setActiveCell` lookups.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
             {
               "kind": "method",
               "name": "renderAllCalendars",
@@ -5357,6 +5437,40 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "pickNearestCell",
+              "parameters": [
+                {
+                  "name": "cells",
+                  "description": "Focusable cells from getAllFocusableCells.",
+                  "type": {
+                    "text": "Array"
+                  }
+                },
+                {
+                  "name": "targetTs",
+                  "description": "Desired Unix timestamp (seconds).",
+                  "type": {
+                    "text": "Number"
+                  }
+                },
+                {
+                  "name": "direction",
+                  "description": "Navigation direction.",
+                  "type": {
+                    "text": "'next'|'prev'"
+                  }
+                }
+              ],
+              "description": "Picks the focusable cell whose date is closest to targetTs. Used as a\nfallback after a month-boundary nav when the exact target date isn't\nfocusable — typically because the month re-render lagged or the date\nwas filtered out by isOutOfRange. When two cells are equidistant, the\nnavigation direction breaks the tie so the user moves the way they\npressed (forward → later cell, backward → earlier cell).",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Object|null"
+                }
+              }
+            },
             {
               "kind": "method",
               "name": "getAllFocusableCells",
@@ -5380,7 +5494,7 @@
                   }
                 }
               ],
-              "description": "Sets the active cell across all months. Only one cell has tabindex=\"0\" at a time.\nUses imperative DOM manipulation — no Lit re-render triggered.\nAlso updates ariaActiveDescendantElement on the grid wrapper so\nscreen readers announce the active cell without moving DOM focus.",
+              "description": "Sets the active cell across all months. Only one cell has tabindex=\"0\" at a time.\nUses imperative DOM manipulation — no Lit re-render triggered. DOM focus\nstays on the grid wrapper; the live region (see getOrCreateLiveRegion)\nis what announces the active cell to assistive tech.",
               "return": {
                 "type": {
                   "text": "void"
@@ -5400,6 +5514,16 @@
             {
               "kind": "method",
               "name": "handleGridFocusIn",
+              "parameters": [
+                {
+                  "name": "event",
+                  "description": "The focusin event.",
+                  "optional": true,
+                  "type": {
+                    "text": "FocusEvent"
+                  }
+                }
+              ],
               "description": "Shows the activeCell ring when the grid gains focus.",
               "privacy": "private",
               "return": {
@@ -5419,6 +5543,39 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "_getBlackoutSet",
+              "description": "Returns a memoized Set of blackout timestamps (seconds) drawn from both\nthe legacy `disabledDays` array and the datepicker's ISO `blackoutDates`.\nThe cache invalidates when either source array's reference changes, which\nmatches Lit's own reactive identity semantics for array properties.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Set<Number>"
+                }
+              }
+            },
+            {
+              "kind": "field",
+              "name": "_warnedDisabledDaysDeprecation",
+              "type": {
+                "text": "boolean"
+              },
+              "static": true,
+              "default": "false",
+              "description": "Per-class flag that gates the `disabledDays` deprecation warning so it\nfires exactly once per page no matter how many calendars or rebuild\ncycles encounter the legacy array.",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_warnDisabledDaysDeprecated",
+              "description": "One-time `console.debug` directing consumers from the legacy\n`disabledDays` Unix-timestamp API to the ISO `blackoutDates` API. Fires\nthe first time `_getBlackoutSet` rebuilds from a non-empty\n`disabledDays`; subsequent calls (on this or any other AuroCalendar\ninstance on the page) are silent.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
             {
               "kind": "method",
               "name": "computeActiveDate",
@@ -5473,7 +5630,7 @@
                   }
                 }
               ],
-              "description": "Handles arrow key navigation on the calendar grid wrapper.\nFocus stays on the grid wrapper; only ariaActiveDescendantElement\nand the visual active-cell indicator change.",
+              "description": "Handles arrow key navigation on the calendar grid wrapper.\nFocus stays on the grid wrapper; only the visual active-cell indicator\nchanges. The live region announces the new active cell.",
               "privacy": "private",
               "return": {
                 "type": {
@@ -5593,7 +5750,7 @@
                   }
                 }
               ],
-              "description": "Checks whether a given date is a blackout date.",
+              "description": "Checks whether a given date is a blackout date. Delegates to the\nmemoized `_getBlackoutSet` so the YYYY-MM-DD parsing and the\nlegacy/ISO merge rules live in exactly one place (see `blackoutUtils.js`).",
               "privacy": "private",
               "return": {
                 "type": {
@@ -5665,7 +5822,7 @@
             {
               "kind": "method",
               "name": "scrollToActiveCell",
-              "description": "Scrolls the calendar to ensure the month containing the active cell is visible.",
+              "description": "Scrolls the calendar so the active cell is visible.\n\nWalks the flat tree (rendered, slot-aware) outward from the active\ncell's button and calls `scrollBy` on every vertically-scrollable\nancestor by whatever delta still separates the cell from that\nancestor's viewport. Native `scrollIntoView` is not used because the\ncell sits inside multiple nested scroll containers (the dropdown bib's\n`<dialog>`, the bibtemplate's `#bodyContainer`) and the algorithm only\nscrolls one of them on its own, leaving the cell short of the\nviewport in mobile fullscreen.\n\nUses `behavior: 'auto'` (the spec's universally-supported non-animated\nvalue) so each `scrollBy` resolves synchronously and the next\niteration's `getBoundingClientRect` reads post-scroll positions\naccurately. This also satisfies `prefers-reduced-motion` users — the\nscroll containers do not set CSS `scroll-behavior: smooth`, so `auto`\nis effectively instant.\n\nThe active cell is looked up from the cache populated by\n`setActiveCell`. On a cache miss (stale or absent) the cache is\nrefreshed from a single full scan so subsequent calls stay on the\nfast path.",
               "privacy": "private",
               "return": {
                 "type": {
@@ -5704,6 +5861,33 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "_deliverAnnouncement",
+              "parameters": [
+                {
+                  "name": "dateStr",
+                  "description": "The localized date string to announce.",
+                  "type": {
+                    "text": "String"
+                  }
+                },
+                {
+                  "name": "attempts",
+                  "description": "Number of prior retry attempts.",
+                  "type": {
+                    "text": "Number"
+                  }
+                }
+              ],
+              "description": "Writes `dateStr` to the live region. If the dropdown's dialog hasn't\nmounted yet (so getOrCreateLiveRegion can't attach), retries on the\nnext animation frame up to MAX_LIVE_REGION_RETRIES instead of silently\ndropping the announcement. The retry uses the same `_announceRafId`\nthe double-rAF below uses, so a newer announceSelection call (or\ndisconnectedCallback) cancels any in-flight retry.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
             {
               "kind": "method",
               "name": "announceFocusDebounced",
@@ -5857,6 +6041,16 @@
               "privacy": "private",
               "default": "null"
             },
+            {
+              "kind": "field",
+              "name": "_activeCell",
+              "type": {
+                "text": "null"
+              },
+              "description": "Cached reference to the active cell host. Set by setActiveCell and\nrefreshed by scrollToActiveCell when its cache check misses (stale\nor missing). Lets scrollToActiveCell skip a full cell scan on each\narrow key.",
+              "privacy": "private",
+              "default": "null"
+            },
             {
               "kind": "field",
               "name": "_gridHasFocus",
@@ -5888,7 +6082,7 @@
               "type": {
                 "text": "array"
               },
-              "description": "Legacy array of disabled-date timestamps.",
+              "deprecated": "Use `auro-datepicker.blackoutDates` (an array of\n`YYYY-MM-DD` ISO strings) instead. This legacy array of Unix\ntimestamps is still honored for backward compatibility but emits a\none-time `console.debug` the first time a non-empty value is observed.\nSupport will be removed in a future major release.",
               "privacy": "private",
               "default": "[]"
             },
@@ -6305,6 +6499,14 @@
               "description": "Defines the label content for the first input.",
               "name": "fromLabel"
             },
+            {
+              "description": "Overrides the \"(optional)\" text rendered next to the first input's label when the datepicker is not `required`.",
+              "name": "optionalFromLabel"
+            },
+            {
+              "description": "Overrides the \"(optional)\" text rendered next to the second input's label when `range` is set and the datepicker is not `required`.",
+              "name": "optionalToLabel"
+            },
             {
               "description": "Defines the content to display in the auro-calendar-cell for the specified date. The content text is colored using the success state token when the `highlight` attribute is applied to the slot.",
               "name": "date_YYYY_MM_DD"
@@ -6582,13 +6784,13 @@
               "parameters": [
                 {
                   "name": "time",
-                  "description": "Unix timestamp in seconds.",
+                  "description": "Unix timestamp (seconds), local midnight of the day.",
                   "type": {
                     "text": "number"
                   }
                 }
               ],
-              "description": "Converts a Unix timestamp (seconds) from the vendor calendar to an ISO date string.",
+              "description": "Converts a Unix timestamp (seconds) from the vendored range-datepicker\n(`src/vendor/wc-range-datepicker/day.js`) to an ISO date string.\n\nTimezone contract:\n- INPUT: `time` is assumed to be the seconds-since-epoch of **local\n  midnight** for the intended calendar day. The vendor's Day constructor\n  builds it via `date-fns format(date, 't')` from a locally-constructed\n  Date, so this assumption currently holds end-to-end.\n- OUTPUT: `dateFormatter.toISOFormatString` reads the Date's local\n  getFullYear/getMonth/getDate components, so the returned YYYY-MM-DD\n  string matches the local calendar day.\n\nIf the vendor ever switches to emitting UTC-midnight timestamps, this\nconversion will silently shift the returned date by one day in zones\nwest of UTC. Any vendor swap should re-verify this contract; the TZ\nregression suite (`npm run test:hst`, UTC-10) will catch the symptom.",
               "privacy": "private",
               "return": {
                 "type": {
@@ -6864,6 +7066,34 @@
               },
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "_warnedInvalidLocales",
+              "static": true,
+              "default": "new Set()",
+              "description": "Per-class dedup set used by `_warnInvalidLocale`. Static so the dedup\nspans every datepicker instance on the page; lives on the class (not\nat module scope) so it stays an encapsulated implementation detail of\nthis component and does not interfere with WCA's class-JSDoc\nattachment.",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_warnInvalidLocale",
+              "parameters": [
+                {
+                  "name": "badLocale",
+                  "description": "The locale value that failed.",
+                  "type": {
+                    "text": "string|undefined"
+                  }
+                }
+              ],
+              "description": "Logs a one-time `console.debug` when an unsupported locale falls back to\nen-US. Deduped by the offending tag so noisy re-renders that resurface\nthe same bad value stay quiet, but each new bad value still signals so\nconsumers can spot the typo or missing tag.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
             {
               "kind": "method",
               "name": "handleSlotToSlot",
@@ -7228,11 +7458,23 @@
               "type": {
                 "text": "string"
               },
-              "description": "Label announced for cells after the range (or after start when no end is selected).",
+              "description": "Label announced for cells after a fully selected range (both\n`dateFrom` and `dateTo` are set). While a range is still being\npicked (`dateFrom` set, `dateTo` unset), focused cells past the\nstart use `rangeLabelEndPreview` instead.",
               "default": "'after range'",
               "attribute": "rangeLabelAfterRange",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "rangeLabelEndPreview",
+              "privacy": "public",
+              "type": {
+                "text": "string"
+              },
+              "description": "Label announced for the focused cell while previewing a range end\n(dateFrom set, dateTo not yet selected). Tells AT users that\npressing Enter would commit this cell as the range end.",
+              "default": "'previewing range end'",
+              "attribute": "rangeLabelEndPreview",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "blackoutDates",
@@ -7572,6 +7814,13 @@
               "name": "helpTextTag",
               "privacy": "private"
             },
+            {
+              "kind": "field",
+              "name": "_listenerAbortController",
+              "description": "Single AbortController shared by every listener registered in the\nconfigure* methods. Lets disconnectedCallback tear all of them down\nwith one abort() call.\n\nThe genuine leak risk is the listeners attached to children that can\noutlive the host if they get reparented — `this.dropdown`,\n`this.calendar`, and the inputs inside the dropdown's slot.\nListeners attached to `this` (e.g. focusin/focusout on the host)\nform a self-contained reference graph that the GC can collect with\nthe host anyway, but they share the same signal so the cleanup\npattern stays uniform across all configure* sites.",
+              "privacy": "private",
+              "default": "new AbortController()"
+            },
             {
               "kind": "field",
               "name": "layout",
@@ -7742,7 +7991,7 @@
               "type": {
                 "text": "array"
               },
-              "description": "Dates that the user should have for reference as part of their decision making when selecting a date.\nThis should be a JSON string array of ISO date strings (`YYYY-MM-DD`).",
+              "description": "Dates that the user should have for reference as part of their decision-making when selecting a date.\nThis should be a JSON string array of ISO date strings (`YYYY-MM-DD`).",
               "attribute": "referenceDates",
               "reflects": true
             },
@@ -8182,7 +8431,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "Label announced for cells after the range (or after start when no end is selected).",
+              "description": "Label announced for cells after a fully selected range (both\n`dateFrom` and `dateTo` are set). While a range is still being\npicked (`dateFrom` set, `dateTo` unset), focused cells past the\nstart use `rangeLabelEndPreview` instead.",
               "default": "'after range'",
               "fieldName": "rangeLabelAfterRange"
             },
@@ -8204,6 +8453,15 @@
               "default": "'range end'",
               "fieldName": "rangeLabelEnd"
             },
+            {
+              "name": "rangeLabelEndPreview",
+              "type": {
+                "text": "string"
+              },
+              "description": "Label announced for the focused cell while previewing a range end\n(dateFrom set, dateTo not yet selected). Tells AT users that\npressing Enter would commit this cell as the range end.",
+              "default": "'previewing range end'",
+              "fieldName": "rangeLabelEndPreview"
+            },
             {
               "name": "rangeLabelInRange",
               "type": {
@@ -8227,7 +8485,7 @@
               "type": {
                 "text": "array"
               },
-              "description": "Dates that the user should have for reference as part of their decision making when selecting a date.\nThis should be a JSON string array of ISO date strings (`YYYY-MM-DD`).",
+              "description": "Dates that the user should have for reference as part of their decision-making when selecting a date.\nThis should be a JSON string array of ISO date strings (`YYYY-MM-DD`).",
               "fieldName": "referenceDates"
             },
             {
@@ -8379,44 +8637,154 @@
     },
     {
       "kind": "javascript-module",
-      "path": "components/datepicker/src/buttonVersion.js",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "default",
-          "declaration": {
-            "name": "12.3.2",
-            "module": "components/datepicker/src/buttonVersion.js"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "components/datepicker/src/datepickerKeyboardStrategy.js",
+      "path": "components/datepicker/src/blackoutUtils.js",
       "declarations": [
         {
-          "kind": "variable",
-          "name": "datepickerKeyboardStrategy",
-          "type": {
-            "text": "object"
-          },
-          "default": "{ Escape(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Stop propagation so parent containers (auro-dialog, auro-drawer) // don't also react to Escape. evt.stopPropagation(); evt.preventDefault(); component.hideBib(); }, Enter(component, evt, ctx) { if (ctx.isExpanded) { return; } // Only open from the trigger input, not the clear button or other internal elements. // evt.target is retargeted to the host in shadow DOM, so use composedPath() // to find the real origin. The clear button is rendered with class \"clearBtn\". const path = evt.composedPath(); if (path.some(el => el.classList?.contains('clearBtn'))) { return; } evt.preventDefault(); component.dropdown.show(); }, ' '(component, evt, ctx) { if (ctx.isExpanded) { return; } // Only open from the trigger input, not the clear button or other internal elements. // evt.target is retargeted to the host in shadow DOM, so use composedPath() // to find the real origin. The clear button is rendered with class \"clearBtn\". const path = evt.composedPath(); if (path.some(el => el.classList?.contains('clearBtn'))) { return; } evt.preventDefault(); component.dropdown.show(); }, }"
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "datepickerKeyboardStrategy",
-          "declaration": {
-            "name": "datepickerKeyboardStrategy",
-            "module": "components/datepicker/src/datepickerKeyboardStrategy.js"
+          "kind": "function",
+          "name": "parseIsoToTimestamp",
+          "parameters": [
+            {
+              "name": "isoStr",
+              "description": "Date string in `YYYY-MM-DD` format.",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "Converts a `YYYY-MM-DD` ISO date string to a Unix timestamp (seconds)\nrepresenting local midnight on that calendar day. Returns `null` for\ninputs that don't parse to a finite timestamp.\n\nUses the `new Date(year, monthIndex, day)` constructor (NOT\n`new Date(isoStr)`) so the result is local-midnight rather than UTC\nmidnight — required to keep the calendar grid aligned with the user's\nlocal calendar day in negative-offset timezones.",
+          "return": {
+            "type": {
+              "text": "number|null"
+            }
           }
-        }
-      ]
-    },
-    {
+        },
+        {
+          "kind": "function",
+          "name": "buildBlackoutSet",
+          "parameters": [
+            {
+              "name": "disabledDays",
+              "description": "Legacy timestamp array.",
+              "type": {
+                "text": "Array<string|number>|undefined"
+              }
+            },
+            {
+              "name": "blackoutDates",
+              "description": "ISO `YYYY-MM-DD` array.",
+              "type": {
+                "text": "Array<string>|undefined"
+              }
+            }
+          ],
+          "description": "Builds a `Set<number>` of seconds-since-epoch timestamps covering both the\nlegacy `disabledDays` (already-numeric) array and the ISO `blackoutDates`\narray. Use this for O(1) membership checks in hot paths.",
+          "return": {
+            "type": {
+              "text": "Set<number>"
+            }
+          }
+        },
+        {
+          "kind": "function",
+          "name": "isBlackoutTimestamp",
+          "parameters": [
+            {
+              "name": "dateTs",
+              "description": "Unix timestamp (seconds) to test.",
+              "type": {
+                "text": "number"
+              }
+            },
+            {
+              "name": "disabledDays",
+              "description": "Legacy timestamp array.",
+              "type": {
+                "text": "Array<string|number>|undefined"
+              }
+            },
+            {
+              "name": "blackoutDates",
+              "description": "ISO `YYYY-MM-DD` array.",
+              "type": {
+                "text": "Array<string>|undefined"
+              }
+            }
+          ],
+          "description": "One-shot membership test for a single timestamp against both blackout\nsources. Allocates a Set on each call; only use this in cold paths\n(e.g. the pre-`firstUpdated` cell fallback). Hot paths should hold the\nSet returned from `buildBlackoutSet` and `.has(ts)` directly.",
+          "return": {
+            "type": {
+              "text": "boolean"
+            }
+          }
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "parseIsoToTimestamp",
+          "declaration": {
+            "name": "parseIsoToTimestamp",
+            "module": "components/datepicker/src/blackoutUtils.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "buildBlackoutSet",
+          "declaration": {
+            "name": "buildBlackoutSet",
+            "module": "components/datepicker/src/blackoutUtils.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "isBlackoutTimestamp",
+          "declaration": {
+            "name": "isBlackoutTimestamp",
+            "module": "components/datepicker/src/blackoutUtils.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "components/datepicker/src/buttonVersion.js",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "12.3.2",
+            "module": "components/datepicker/src/buttonVersion.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "components/datepicker/src/datepickerKeyboardStrategy.js",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "datepickerKeyboardStrategy",
+          "type": {
+            "text": "object"
+          },
+          "default": "{ Escape(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Stop propagation so parent containers (auro-dialog, auro-drawer) // don't also react to Escape. evt.stopPropagation(); evt.preventDefault(); component.hideBib(); }, Enter(component, evt, ctx) { if (ctx.isExpanded) { return; } // Only open from the trigger input, not the clear button or other internal elements. // evt.target is retargeted to the host in shadow DOM, so use composedPath() // to find the real origin. The clear button is rendered with class \"clearBtn\". const path = evt.composedPath(); if (path.some(el => el.classList?.contains('clearBtn'))) { return; } evt.preventDefault(); component.dropdown.show(); }, ' '(component, evt, ctx) { if (ctx.isExpanded) { return; } // Only open from the trigger input, not the clear button or other internal elements. // evt.target is retargeted to the host in shadow DOM, so use composedPath() // to find the real origin. The clear button is rendered with class \"clearBtn\". const path = evt.composedPath(); if (path.some(el => el.classList?.contains('clearBtn'))) { return; } evt.preventDefault(); component.dropdown.show(); }, }"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "datepickerKeyboardStrategy",
+          "declaration": {
+            "name": "datepickerKeyboardStrategy",
+            "module": "components/datepicker/src/datepickerKeyboardStrategy.js"
+          }
+        }
+      ]
+    },
+    {
       "kind": "javascript-module",
       "path": "components/datepicker/src/iconVersion.js",
       "declarations": [],
@@ -10493,6 +10861,46 @@
               },
               "privacy": "private"
             },
+            {
+              "kind": "method",
+              "name": "_isDisabled",
+              "parameters": [
+                {
+                  "name": "element",
+                  "description": "The element to check.",
+                  "type": {
+                    "text": "HTMLElement | undefined | null"
+                  }
+                }
+              ],
+              "description": "Whether a given element is currently disabled. Disabled controls are excluded\nfrom submission, validity, and initial-state checks per the HTML spec\n(section 4.10.19.2 \"Enabling and disabling form controls\":\nhttps://www.w3.org/TR/2011/WD-html5-20110113/association-of-controls-and-forms.html).\n\nImplementation note: we deliberately read only the attribute. Every Auro\nform element in `formElementTags` declares `disabled` with `reflect: true`,\nso the attribute and property stay in sync. Reading the attribute also\nlets the MutationObserver in `connectedCallback` (which is filtered to\n`['disabled', 'name']`) be the single source of truth for re-renders.\nIf a future form-element type ships without attribute reflection, expand\nthis helper to also read `element.disabled`.",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_isNameDisabled",
+              "parameters": [
+                {
+                  "name": "name",
+                  "description": "The `name` attribute used to register the element.",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Whether the tracked form element registered under `name` is currently disabled.\nSee `_isDisabled` for the HTML-spec rationale behind excluding disabled\ncontrols from form state.\n\nReads a cached flag on `formState[name]` populated by `_addElementToState`\nat registration and refreshed by `_handleAttributeMutations` whenever the\nelement's `disabled` attribute toggles. The cache is fed by the same\n`hasAttribute('disabled')` read as `_isDisabled`, so the \"future form-element\ntype without attribute reflection\" caveat documented there applies here too.",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "_eventIsValidFormEvent",
@@ -10574,10 +10982,52 @@
               "privacy": "private",
               "readonly": true
             },
+            {
+              "kind": "method",
+              "name": "_isFormValid",
+              "description": "Raw constraint-validation check. Returns `true` when no enabled field\nhas a validity error. Unlike the public `validity` getter, this does\nNOT gate on `isInitialState` — callers that need to make a decision\nbased on the actual constraint state (submit-button enablement, the\ninternal `submit()` gate) read this so a pre-filled valid form is\ncorrectly recognized as submittable at first render.",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_hasResetableState",
+              "description": "Whether the reset button should be enabled. True when the form has\ndiverged from its initial state (so the user can always return to\ndefaults — even if the dirty value lives behind a now-disabled field),\nOR when any non-disabled field has a current value or captured initial\nvalue (covers pre-filled forms and user-cleared-back-to-empty cases).",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_normalizeEmpty",
+              "parameters": [
+                {
+                  "name": "value",
+                  "description": "Value to normalize.",
+                  "type": {
+                    "text": "*"
+                  }
+                }
+              ],
+              "description": "Collapse empty representations to a single canonical `null`.\n\n`_addElementToState` captures `null` for a field that mounts without a\n`value` attribute (`element.value || element.getAttribute('value')` is\nfalsy → resolves to `null`), but `sharedInputListener` later stores the\nraw `event.target.value` — which is `''` for a user-cleared text input.\nWithout this normalization, backspacing back to empty would taint the\nform forever (`'' !== null`) and Reset would stay enabled with nothing\nto actually reset.\n\n`''`, `undefined`, and `[]` all collapse to `null`. The empty-array case\ncovers checkbox-group, radio-group, and multiselect, where `[]` means\n\"no selection\" — semantically the same as `null`/`''`. Genuine values\n— including `0`, `false`, non-empty strings, and non-empty arrays —\npass through unchanged so number, boolean, and populated multi-value\nfields still compare correctly.",
+              "return": {
+                "type": {
+                  "text": "*"
+                }
+              },
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "_calculateValidity",
-              "description": "Infer validity status based on current formState.",
+              "description": "Infer validity status based on current formState.\n\nValidity stays `null` while the form is in its initial state — this is\nthe \"stay quiet until the user interacts\" UX contract that consumers\ndepend on to delay error indicators. Code that needs the raw\nconstraint-validation result regardless of interaction (e.g.,\nsubmit-button enablement) should call `_isFormValid()` directly.",
               "privacy": "private"
             },
             {
@@ -10594,7 +11044,7 @@
             {
               "kind": "method",
               "name": "_setInitialState",
-              "description": "Determines whether the form is in its initial (untouched) state and updates `_isInitialState` accordingly.",
+              "description": "Determines whether the form is in its initial (untouched) state.\n\nA field is tainted if either:\n  - its value differs from the value captured on first render, OR\n  - its validity is failing (anything other than `null` or `'valid'`).\n\nValidity acts as a backup signal: it catches users who interact with a\nfield without changing its value (e.g., focusing and blurring a required\nfield). We skip `null` (not yet validated) and `'valid'` (the default\nafter Auro's auto-validation on mount) because neither proves the user\ntouched anything.",
               "return": {
                 "type": {
                   "text": "void"
@@ -10754,6 +11204,26 @@
               },
               "privacy": "private"
             },
+            {
+              "kind": "method",
+              "name": "_handleAttributeMutations",
+              "parameters": [
+                {
+                  "name": "mutations",
+                  "description": "The batched mutation records.",
+                  "type": {
+                    "text": "MutationRecord[]"
+                  }
+                }
+              ],
+              "description": "Handle batched MutationObserver records for `disabled` and `name`\nattribute changes on tracked form elements. A `name` change invalidates\nthe formState keying — we resolve it by re-initializing state. A `disabled`\nchange simply needs a re-render (so `value` / `validity` getters re-evaluate)\nand a refresh of the submit/reset button enablement.",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "mutationEventListener",
@@ -10847,6 +11317,25 @@
               },
               "privacy": "private",
               "default": "[]"
+            },
+            {
+              "kind": "field",
+              "name": "_initialValues",
+              "type": {
+                "text": "Record<string, string | number | boolean | string[] | null | undefined>"
+              },
+              "description": "Captured initial (default) value per field `name`. Populated on first\nsight of each name in `_addElementToState` and preserved across\nsubsequent `initializeState` cycles (slot change, rename, reset) so\n`_setInitialState` can detect user edits as `current !== initial`,\nmatching HTML's `dirtyValueFlag` semantics.",
+              "privacy": "private",
+              "default": "{}"
+            },
+            {
+              "kind": "field",
+              "name": "_attributeObserver",
+              "type": {
+                "text": "MutationObserver | null"
+              },
+              "privacy": "private",
+              "default": "null"
             }
           ],
           "events": [
@@ -11636,21 +12125,6 @@
                 "module": "components/input/src/base-input.js"
               }
             },
-            {
-              "kind": "method",
-              "name": "_initializePrivateDefaults",
-              "description": "Internal Defaults.",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "inheritedFrom": {
-                "name": "BaseInput",
-                "module": "components/input/src/base-input.js"
-              }
-            },
             {
               "kind": "field",
               "name": "valueObject",
@@ -11698,23 +12172,23 @@
             },
             {
               "kind": "method",
-              "name": "_computeDateObjectFallback",
+              "name": "patchInputEvent",
               "parameters": [
                 {
-                  "name": "dateStr",
-                  "description": "ISO date string from `value`/`min`/`max`.",
+                  "name": "input",
+                  "description": "The input element to patch.",
                   "type": {
-                    "text": "string|undefined"
+                    "text": "HTMLInputElement"
                   }
                 }
               ],
-              "description": "Parses a date string into a Date object when the corresponding `_*Object`\nfield hasn't been synced yet by `updated()`. Returns undefined when the\ninput type/format isn't a full date or the string is not a valid date.\n\nWhy this exists: a parent (datepicker) can call `inputN.validate()` from\ninside its own `updated()` before this input's `updated()` has run\n`syncDateValues()` — so `_valueObject`/`_maxObject` are still `undefined`\nand range checks would otherwise silently no-op (flipping the result to\n`valid` or `patternMismatch`).",
-              "privacy": "private",
+              "description": "Patches the input element to dispatch an 'input' event whenever its value is set programmatically.\nThis ensures that changes to the input's value are consistently communicated, even if not triggered by user input.",
               "return": {
                 "type": {
-                  "text": "Date|undefined"
+                  "text": "void"
                 }
               },
+              "privacy": "private",
               "inheritedFrom": {
                 "name": "BaseInput",
                 "module": "components/input/src/base-input.js"
@@ -11722,25 +12196,9 @@
             },
             {
               "kind": "method",
-              "name": "setDateObjectProperty",
-              "parameters": [
-                {
-                  "name": "propertyName",
-                  "description": "Public object property name.",
-                  "type": {
-                    "text": "'valueObject'|'minObject'|'maxObject'"
-                  }
-                },
-                {
-                  "name": "propertyValue",
-                  "description": "Value to assign.",
-                  "type": {
-                    "text": "Date|undefined"
-                  }
-                }
-              ],
-              "description": "Internal setter for readonly date object properties.",
+              "name": "setCustomHelpTextMessage",
               "privacy": "private",
+              "deprecated": "https://dev.azure.com/itsals/E_Retain_Content/_workitems/edit/1557296",
               "return": {
                 "type": {
                   "text": "void"
@@ -11753,23 +12211,13 @@
             },
             {
               "kind": "method",
-              "name": "patchInputEvent",
-              "parameters": [
-                {
-                  "name": "input",
-                  "description": "The input element to patch.",
-                  "type": {
-                    "text": "HTMLInputElement"
-                  }
-                }
-              ],
-              "description": "Patches the input element to dispatch an 'input' event whenever its value is set programmatically.\nThis ensures that changes to the input's value are consistently communicated, even if not triggered by user input.",
+              "name": "notifyValidityChange",
+              "privacy": "private",
               "return": {
                 "type": {
                   "text": "void"
                 }
               },
-              "privacy": "private",
               "inheritedFrom": {
                 "name": "BaseInput",
                 "module": "components/input/src/base-input.js"
@@ -11777,101 +12225,8 @@
             },
             {
               "kind": "method",
-              "name": "setCustomHelpTextMessage",
-              "privacy": "private",
-              "deprecated": "https://dev.azure.com/itsals/E_Retain_Content/_workitems/edit/1557296",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "inheritedFrom": {
-                "name": "BaseInput",
-                "module": "components/input/src/base-input.js"
-              }
-            },
-            {
-              "kind": "method",
-              "name": "notifyValidityChange",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "inheritedFrom": {
-                "name": "BaseInput",
-                "module": "components/input/src/base-input.js"
-              }
-            },
-            {
-              "kind": "method",
-              "name": "syncDateValues",
-              "parameters": [
-                {
-                  "name": "changedProperties",
-                  "default": "undefined",
-                  "description": "Optional map of changed properties used to limit which values are synchronized.",
-                  "optional": true,
-                  "type": {
-                    "text": "Map<string, unknown>|undefined"
-                  }
-                }
-              ],
-              "description": "Synchronizes the ISO string values and Date object representations for date-related properties.\nThis keeps the model and display values aligned when either side changes.\n\nWhen a full date format is in use, this method updates `value`, `min`, and `max` from their corresponding\nDate objects or vice versa, based on which properties have changed. It only runs when the current configuration\nrepresents a full year/month/day date format.",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "privacy": "private",
-              "inheritedFrom": {
-                "name": "BaseInput",
-                "module": "components/input/src/base-input.js"
-              }
-            },
-            {
-              "kind": "method",
-              "name": "syncSingleDateValue",
-              "parameters": [
-                {
-                  "name": "changedProperties",
-                  "description": "Map of changed properties from Lit.",
-                  "type": {
-                    "text": "Map<string, unknown>|undefined"
-                  }
-                },
-                {
-                  "name": "objectProperty",
-                  "description": "Date object property name.",
-                  "type": {
-                    "text": "string"
-                  }
-                },
-                {
-                  "name": "valueProperty",
-                  "description": "ISO string property name.",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ],
-              "description": "Synchronizes one date object/string property pair.",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "inheritedFrom": {
-                "name": "BaseInput",
-                "module": "components/input/src/base-input.js"
-              }
-            },
-            {
-              "kind": "method",
-              "name": "configureAutoFormatting",
-              "description": "Sets up IMasks and logic based on auto-formatting requirements.",
+              "name": "configureAutoFormatting",
+              "description": "Sets up IMasks and logic based on auto-formatting requirements.",
               "privacy": "private",
               "return": {
                 "type": {
@@ -12164,6 +12519,35 @@
                 "module": "components/input/src/base-input.js"
               }
             },
+            {
+              "kind": "field",
+              "name": "activeLabel",
+              "privacy": "public",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If set, the label will remain fixed in the active position.",
+              "default": "false",
+              "attribute": "activeLabel",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "BaseInput",
+                "module": "components/input/src/base-input.js"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "allowedInputTypes",
+              "type": {
+                "text": "array"
+              },
+              "privacy": "private",
+              "default": "[ \"text\", \"number\", \"email\", \"password\", \"credit-card\", \"tel\" ]",
+              "inheritedFrom": {
+                "name": "BaseInput",
+                "module": "components/input/src/base-input.js"
+              }
+            },
             {
               "kind": "field",
               "name": "appearance",
@@ -12180,6 +12564,19 @@
                 "module": "components/input/src/base-input.js"
               }
             },
+            {
+              "kind": "field",
+              "name": "dateFormatMap",
+              "type": {
+                "text": "object"
+              },
+              "privacy": "private",
+              "default": "{ 'mm/dd/yyyy': 'dateMMDDYYYY', 'dd/mm/yyyy': 'dateDDMMYYYY', 'yyyy/mm/dd': 'dateYYYYMMDD', 'yyyy/dd/mm': 'dateYYYYDDMM', 'mm/yy': 'dateMMYY', 'yy/mm': 'dateYYMM', 'mm/yyyy': 'dateMMYYYY', 'yyyy/mm': 'dateYYYYMM', 'yy': 'dateYY', 'yyyy': 'dateYYYY', 'mm': 'dateMM', 'dd': 'dateDD', 'dd/mm': 'dateDDMM', 'mm/dd': 'dateMMDD' }",
+              "inheritedFrom": {
+                "name": "BaseInput",
+                "module": "components/input/src/base-input.js"
+              }
+            },
             {
               "kind": "field",
               "name": "disabled",
@@ -12196,6 +12593,101 @@
                 "module": "components/input/src/base-input.js"
               }
             },
+            {
+              "kind": "field",
+              "name": "domHandler",
+              "privacy": "private",
+              "default": "new DomHandler()",
+              "inheritedFrom": {
+                "name": "BaseInput",
+                "module": "components/input/src/base-input.js"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "dvInputOnly",
+              "privacy": "public",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If defined, the display value slot content will only mask the HTML5 input element. The input's label will not be masked.",
+              "default": "false",
+              "attribute": "dvInputOnly",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "BaseInput",
+                "module": "components/input/src/base-input.js"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "hasValue",
+              "privacy": "public",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Flag to indicate if the input currently has value.",
+              "default": "false",
+              "inheritedFrom": {
+                "name": "BaseInput",
+                "module": "components/input/src/base-input.js"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "hideLabelVisually",
+              "privacy": "private",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If set, the label will be hidden visually but still accessible to assistive technologies.",
+              "default": "false",
+              "attribute": "hideLabelVisually",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "BaseInput",
+                "module": "components/input/src/base-input.js"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "icon",
+              "privacy": "public",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "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.",
+              "default": "false",
+              "attribute": "icon",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "BaseInput",
+                "module": "components/input/src/base-input.js"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "inputIconName",
+              "privacy": "private",
+              "default": "undefined",
+              "inheritedFrom": {
+                "name": "BaseInput",
+                "module": "components/input/src/base-input.js"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "default": "'Input label is undefined'",
+              "inheritedFrom": {
+                "name": "BaseInput",
+                "module": "components/input/src/base-input.js"
+              }
+            },
             {
               "kind": "field",
               "name": "layout",
@@ -12243,15 +12735,6 @@
                 "module": "components/input/src/base-input.js"
               }
             },
-            {
-              "kind": "field",
-              "name": "_maxObject",
-              "default": "undefined",
-              "inheritedFrom": {
-                "name": "BaseInput",
-                "module": "components/input/src/base-input.js"
-              }
-            },
             {
               "kind": "field",
               "name": "maxLength",
@@ -12283,15 +12766,6 @@
                 "module": "components/input/src/base-input.js"
               }
             },
-            {
-              "kind": "field",
-              "name": "_minObject",
-              "default": "undefined",
-              "inheritedFrom": {
-                "name": "BaseInput",
-                "module": "components/input/src/base-input.js"
-              }
-            },
             {
               "kind": "field",
               "name": "minLength",
@@ -12310,14 +12784,14 @@
             },
             {
               "kind": "field",
-              "name": "required",
+              "name": "noValidate",
               "privacy": "public",
               "type": {
                 "text": "boolean"
               },
-              "description": "Populates the `required` attribute on the input. Used for client-side validation.",
+              "description": "If set, disables auto-validation on blur.",
               "default": "false",
-              "attribute": "required",
+              "attribute": "noValidate",
               "reflects": true,
               "inheritedFrom": {
                 "name": "BaseInput",
@@ -12340,6 +12814,31 @@
                 "module": "components/layoutElement/src/auroElement.js"
               }
             },
+            {
+              "kind": "field",
+              "name": "_rawMaskValue",
+              "default": "undefined",
+              "inheritedFrom": {
+                "name": "BaseInput",
+                "module": "components/input/src/base-input.js"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "required",
+              "privacy": "public",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Populates the `required` attribute on the input. Used for client-side validation.",
+              "default": "false",
+              "attribute": "required",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "BaseInput",
+                "module": "components/input/src/base-input.js"
+              }
+            },
             {
               "kind": "field",
               "name": "setCustomValidityForType",
@@ -12357,17 +12856,15 @@
             },
             {
               "kind": "field",
-              "name": "size",
-              "privacy": "public",
+              "name": "setSelectionInputTypes",
               "type": {
-                "text": "string"
+                "text": "array"
               },
-              "attribute": "size",
-              "reflects": true,
-              "default": "'lg'",
+              "privacy": "private",
+              "default": "[ \"text\", \"password\", \"email\" ]",
               "inheritedFrom": {
-                "name": "AuroElement",
-                "module": "components/layoutElement/src/auroElement.js"
+                "name": "BaseInput",
+                "module": "components/input/src/base-input.js"
               }
             },
             {
@@ -12387,14 +12884,81 @@
             },
             {
               "kind": "field",
-              "name": "value",
+              "name": "showPassword",
+              "privacy": "private",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "showPassword",
+              "inheritedFrom": {
+                "name": "BaseInput",
+                "module": "components/input/src/base-input.js"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "size",
               "privacy": "public",
               "type": {
                 "text": "string"
               },
-              "description": "Populates the `value` attribute on the input. Can also be read to retrieve the current value of the input.\nThe format for this property should be ISO for `date` type inputs.",
+              "attribute": "size",
+              "reflects": true,
+              "default": "'lg'",
+              "inheritedFrom": {
+                "name": "AuroElement",
+                "module": "components/layoutElement/src/auroElement.js"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "touched",
+              "privacy": "private",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Indicates whether the input is in a dirty state (has been interacted with).",
+              "default": "false",
+              "inheritedFrom": {
+                "name": "BaseInput",
+                "module": "components/input/src/base-input.js"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "uniqueId",
+              "privacy": "private",
+              "inheritedFrom": {
+                "name": "BaseInput",
+                "module": "components/input/src/base-input.js"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "util",
+              "privacy": "private",
+              "default": "new AuroInputUtilities({ locale: this.locale, format: this.format })",
+              "inheritedFrom": {
+                "name": "BaseInput",
+                "module": "components/input/src/base-input.js"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "validation",
+              "privacy": "private",
+              "default": "new AuroFormValidation()",
+              "inheritedFrom": {
+                "name": "BaseInput",
+                "module": "components/input/src/base-input.js"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "validationCCLength",
+              "privacy": "private",
               "default": "undefined",
-              "attribute": "value",
               "inheritedFrom": {
                 "name": "BaseInput",
                 "module": "components/input/src/base-input.js"
@@ -12402,8 +12966,14 @@
             },
             {
               "kind": "field",
-              "name": "_valueObject",
+              "name": "value",
+              "privacy": "public",
+              "type": {
+                "text": "string"
+              },
+              "description": "Populates the `value` attribute on the input. Can also be read to retrieve the current value of the input.\nThe format for this property should be ISO for `date` type inputs.",
               "default": "undefined",
+              "attribute": "value",
               "inheritedFrom": {
                 "name": "BaseInput",
                 "module": "components/input/src/base-input.js"
@@ -12469,21 +13039,6 @@
                 "module": "components/input/src/base-input.js"
               }
             },
-            {
-              "kind": "field",
-              "name": "activeLabel",
-              "privacy": "public",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "If set, the label will remain fixed in the active position.",
-              "attribute": "activeLabel",
-              "reflects": true,
-              "inheritedFrom": {
-                "name": "BaseInput",
-                "module": "components/input/src/base-input.js"
-              }
-            },
             {
               "kind": "field",
               "name": "autocapitalize",
@@ -12543,21 +13098,6 @@
                 "module": "components/input/src/base-input.js"
               }
             },
-            {
-              "kind": "field",
-              "name": "dvInputOnly",
-              "privacy": "public",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "If defined, the display value slot content will only mask the HTML5 input element. The input's label will not be masked.",
-              "attribute": "dvInputOnly",
-              "reflects": true,
-              "inheritedFrom": {
-                "name": "BaseInput",
-                "module": "components/input/src/base-input.js"
-              }
-            },
             {
               "kind": "field",
               "name": "error",
@@ -12615,49 +13155,6 @@
                 "module": "components/input/src/base-input.js"
               }
             },
-            {
-              "kind": "field",
-              "name": "hasValue",
-              "privacy": "public",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "Flag to indicate if the input currently has value.",
-              "inheritedFrom": {
-                "name": "BaseInput",
-                "module": "components/input/src/base-input.js"
-              }
-            },
-            {
-              "kind": "field",
-              "name": "hideLabelVisually",
-              "privacy": "private",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "If set, the label will be hidden visually but still accessible to assistive technologies.",
-              "attribute": "hideLabelVisually",
-              "reflects": true,
-              "inheritedFrom": {
-                "name": "BaseInput",
-                "module": "components/input/src/base-input.js"
-              }
-            },
-            {
-              "kind": "field",
-              "name": "icon",
-              "privacy": "public",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "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.",
-              "attribute": "icon",
-              "reflects": true,
-              "inheritedFrom": {
-                "name": "BaseInput",
-                "module": "components/input/src/base-input.js"
-              }
-            },
             {
               "kind": "field",
               "name": "id",
@@ -12746,21 +13243,6 @@
                 "module": "components/input/src/base-input.js"
               }
             },
-            {
-              "kind": "field",
-              "name": "noValidate",
-              "privacy": "public",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "If set, disables auto-validation on blur.",
-              "attribute": "noValidate",
-              "reflects": true,
-              "inheritedFrom": {
-                "name": "BaseInput",
-                "module": "components/input/src/base-input.js"
-              }
-            },
             {
               "kind": "field",
               "name": "pattern",
@@ -12918,16 +13400,6 @@
                 "module": "components/input/src/base-input.js"
               }
             },
-            {
-              "kind": "field",
-              "name": "showPassword",
-              "privacy": "public",
-              "attribute": "showPassword",
-              "inheritedFrom": {
-                "name": "BaseInput",
-                "module": "components/input/src/base-input.js"
-              }
-            },
             {
               "kind": "field",
               "name": "simple",
@@ -12958,19 +13430,6 @@
                 "module": "components/input/src/base-input.js"
               }
             },
-            {
-              "kind": "field",
-              "name": "touched",
-              "privacy": "private",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "Indicates whether the input is in a dirty state (has been interacted with).",
-              "inheritedFrom": {
-                "name": "BaseInput",
-                "module": "components/input/src/base-input.js"
-              }
-            },
             {
               "kind": "field",
               "name": "type",
@@ -13118,6 +13577,7 @@
                 "text": "boolean"
               },
               "description": "If set, the label will remain fixed in the active position.",
+              "default": "false",
               "fieldName": "activeLabel",
               "inheritedFrom": {
                 "name": "BaseInput",
@@ -13204,6 +13664,7 @@
                 "text": "boolean"
               },
               "description": "If defined, the display value slot content will only mask the HTML5 input element. The input's label will not be masked.",
+              "default": "false",
               "fieldName": "dvInputOnly",
               "inheritedFrom": {
                 "name": "BaseInput",
@@ -13252,6 +13713,7 @@
                 "text": "boolean"
               },
               "description": "If set, the label will be hidden visually but still accessible to assistive technologies.",
+              "default": "false",
               "fieldName": "hideLabelVisually",
               "inheritedFrom": {
                 "name": "BaseInput",
@@ -13264,6 +13726,7 @@
                 "text": "boolean"
               },
               "description": "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.",
+              "default": "false",
               "fieldName": "icon",
               "inheritedFrom": {
                 "name": "BaseInput",
@@ -13401,6 +13864,7 @@
                 "text": "boolean"
               },
               "description": "If set, disables auto-validation on blur.",
+              "default": "false",
               "fieldName": "noValidate",
               "inheritedFrom": {
                 "name": "BaseInput",
@@ -13580,6 +14044,10 @@
             },
             {
               "name": "showPassword",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
               "fieldName": "showPassword",
               "inheritedFrom": {
                 "name": "BaseInput",
@@ -13763,17 +14231,6 @@
               "static": true,
               "readonly": true
             },
-            {
-              "kind": "method",
-              "name": "_initializePrivateDefaults",
-              "description": "Internal Defaults.",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
-            },
             {
               "kind": "field",
               "name": "valueObject",
@@ -13807,53 +14264,6 @@
               },
               "readonly": true
             },
-            {
-              "kind": "method",
-              "name": "_computeDateObjectFallback",
-              "parameters": [
-                {
-                  "name": "dateStr",
-                  "description": "ISO date string from `value`/`min`/`max`.",
-                  "type": {
-                    "text": "string|undefined"
-                  }
-                }
-              ],
-              "description": "Parses a date string into a Date object when the corresponding `_*Object`\nfield hasn't been synced yet by `updated()`. Returns undefined when the\ninput type/format isn't a full date or the string is not a valid date.\n\nWhy this exists: a parent (datepicker) can call `inputN.validate()` from\ninside its own `updated()` before this input's `updated()` has run\n`syncDateValues()` — so `_valueObject`/`_maxObject` are still `undefined`\nand range checks would otherwise silently no-op (flipping the result to\n`valid` or `patternMismatch`).",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "Date|undefined"
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "setDateObjectProperty",
-              "parameters": [
-                {
-                  "name": "propertyName",
-                  "description": "Public object property name.",
-                  "type": {
-                    "text": "'valueObject'|'minObject'|'maxObject'"
-                  }
-                },
-                {
-                  "name": "propertyValue",
-                  "description": "Value to assign.",
-                  "type": {
-                    "text": "Date|undefined"
-                  }
-                }
-              ],
-              "description": "Internal setter for readonly date object properties.",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
-            },
             {
               "kind": "method",
               "name": "patchInputEvent",
@@ -13895,62 +14305,6 @@
                 }
               }
             },
-            {
-              "kind": "method",
-              "name": "syncDateValues",
-              "parameters": [
-                {
-                  "name": "changedProperties",
-                  "default": "undefined",
-                  "description": "Optional map of changed properties used to limit which values are synchronized.",
-                  "optional": true,
-                  "type": {
-                    "text": "Map<string, unknown>|undefined"
-                  }
-                }
-              ],
-              "description": "Synchronizes the ISO string values and Date object representations for date-related properties.\nThis keeps the model and display values aligned when either side changes.\n\nWhen a full date format is in use, this method updates `value`, `min`, and `max` from their corresponding\nDate objects or vice versa, based on which properties have changed. It only runs when the current configuration\nrepresents a full year/month/day date format.",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "syncSingleDateValue",
-              "parameters": [
-                {
-                  "name": "changedProperties",
-                  "description": "Map of changed properties from Lit.",
-                  "type": {
-                    "text": "Map<string, unknown>|undefined"
-                  }
-                },
-                {
-                  "name": "objectProperty",
-                  "description": "Date object property name.",
-                  "type": {
-                    "text": "string"
-                  }
-                },
-                {
-                  "name": "valueProperty",
-                  "description": "ISO string property name.",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ],
-              "description": "Synchronizes one date object/string property pair.",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
-            },
             {
               "kind": "method",
               "name": "configureAutoFormatting",
@@ -14164,41 +14518,138 @@
               }
             },
             {
-              "kind": "method",
-              "name": "matchInputValueToCreditCard",
-              "description": "Function to support credit-card feature type.",
-              "privacy": "private",
-              "deprecated": "https://dev.azure.com/itsals/E_Retain_Content/_workitems/edit/1557296",
-              "return": {
-                "type": {
-                  "text": "object"
-                }
-              }
+              "kind": "method",
+              "name": "matchInputValueToCreditCard",
+              "description": "Function to support credit-card feature type.",
+              "privacy": "private",
+              "deprecated": "https://dev.azure.com/itsals/E_Retain_Content/_workitems/edit/1557296",
+              "return": {
+                "type": {
+                  "text": "object"
+                }
+              }
+            },
+            {
+              "kind": "field",
+              "name": "activeLabel",
+              "privacy": "public",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If set, the label will remain fixed in the active position.",
+              "default": "false",
+              "attribute": "activeLabel",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "allowedInputTypes",
+              "type": {
+                "text": "array"
+              },
+              "privacy": "private",
+              "default": "[ \"text\", \"number\", \"email\", \"password\", \"credit-card\", \"tel\" ]"
+            },
+            {
+              "kind": "field",
+              "name": "appearance",
+              "privacy": "public",
+              "type": {
+                "text": "string"
+              },
+              "description": "Defines whether the component will be on lighter or darker backgrounds.",
+              "default": "\"default\"",
+              "attribute": "appearance",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "dateFormatMap",
+              "type": {
+                "text": "object"
+              },
+              "privacy": "private",
+              "default": "{ 'mm/dd/yyyy': 'dateMMDDYYYY', 'dd/mm/yyyy': 'dateDDMMYYYY', 'yyyy/mm/dd': 'dateYYYYMMDD', 'yyyy/dd/mm': 'dateYYYYDDMM', 'mm/yy': 'dateMMYY', 'yy/mm': 'dateYYMM', 'mm/yyyy': 'dateMMYYYY', 'yyyy/mm': 'dateYYYYMM', 'yy': 'dateYY', 'yyyy': 'dateYYYY', 'mm': 'dateMM', 'dd': 'dateDD', 'dd/mm': 'dateDDMM', 'mm/dd': 'dateMMDD' }"
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "privacy": "public",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If set, disables the input.",
+              "default": "false",
+              "attribute": "disabled",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "domHandler",
+              "privacy": "private",
+              "default": "new DomHandler()"
+            },
+            {
+              "kind": "field",
+              "name": "dvInputOnly",
+              "privacy": "public",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If defined, the display value slot content will only mask the HTML5 input element. The input's label will not be masked.",
+              "default": "false",
+              "attribute": "dvInputOnly",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "hasValue",
+              "privacy": "public",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Flag to indicate if the input currently has value.",
+              "default": "false"
             },
             {
               "kind": "field",
-              "name": "appearance",
-              "privacy": "public",
+              "name": "hideLabelVisually",
+              "privacy": "private",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "description": "Defines whether the component will be on lighter or darker backgrounds.",
-              "default": "\"default\"",
-              "attribute": "appearance",
+              "description": "If set, the label will be hidden visually but still accessible to assistive technologies.",
+              "default": "false",
+              "attribute": "hideLabelVisually",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "disabled",
+              "name": "icon",
               "privacy": "public",
               "type": {
                 "text": "boolean"
               },
-              "description": "If set, disables the input.",
+              "description": "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.",
               "default": "false",
-              "attribute": "disabled",
+              "attribute": "icon",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "inputIconName",
+              "privacy": "private",
+              "default": "undefined"
+            },
+            {
+              "kind": "field",
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "default": "'Input label is undefined'"
+            },
             {
               "kind": "field",
               "name": "layout",
@@ -14238,11 +14689,6 @@
               "default": "undefined",
               "attribute": "max"
             },
-            {
-              "kind": "field",
-              "name": "_maxObject",
-              "default": "undefined"
-            },
             {
               "kind": "field",
               "name": "maxLength",
@@ -14266,11 +14712,6 @@
               "default": "undefined",
               "attribute": "min"
             },
-            {
-              "kind": "field",
-              "name": "_minObject",
-              "default": "undefined"
-            },
             {
               "kind": "field",
               "name": "minLength",
@@ -14285,14 +14726,14 @@
             },
             {
               "kind": "field",
-              "name": "required",
+              "name": "noValidate",
               "privacy": "public",
               "type": {
                 "text": "boolean"
               },
-              "description": "Populates the `required` attribute on the input. Used for client-side validation.",
+              "description": "If set, disables auto-validation on blur.",
               "default": "false",
-              "attribute": "required",
+              "attribute": "noValidate",
               "reflects": true
             },
             {
@@ -14311,6 +14752,23 @@
                 "module": "components/layoutElement/src/auroElement.js"
               }
             },
+            {
+              "kind": "field",
+              "name": "_rawMaskValue",
+              "default": "undefined"
+            },
+            {
+              "kind": "field",
+              "name": "required",
+              "privacy": "public",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Populates the `required` attribute on the input. Used for client-side validation.",
+              "default": "false",
+              "attribute": "required",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "setCustomValidityForType",
@@ -14324,14 +14782,23 @@
             },
             {
               "kind": "field",
-              "name": "size",
+              "name": "setSelectionInputTypes",
+              "type": {
+                "text": "array"
+              },
+              "privacy": "private",
+              "default": "[ \"text\", \"password\", \"email\" ]"
+            },
+            {
+              "kind": "field",
+              "name": "shape",
               "privacy": "public",
               "type": {
                 "text": "string"
               },
-              "attribute": "size",
+              "attribute": "shape",
               "reflects": true,
-              "default": "'lg'",
+              "default": "'classic'",
               "inheritedFrom": {
                 "name": "AuroElement",
                 "module": "components/layoutElement/src/auroElement.js"
@@ -14339,19 +14806,62 @@
             },
             {
               "kind": "field",
-              "name": "shape",
+              "name": "showPassword",
+              "privacy": "private",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "showPassword"
+            },
+            {
+              "kind": "field",
+              "name": "size",
               "privacy": "public",
               "type": {
                 "text": "string"
               },
-              "attribute": "shape",
+              "attribute": "size",
               "reflects": true,
-              "default": "'classic'",
+              "default": "'lg'",
               "inheritedFrom": {
                 "name": "AuroElement",
                 "module": "components/layoutElement/src/auroElement.js"
               }
             },
+            {
+              "kind": "field",
+              "name": "touched",
+              "privacy": "private",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Indicates whether the input is in a dirty state (has been interacted with).",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "uniqueId",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "util",
+              "privacy": "private",
+              "default": "new AuroInputUtilities({ locale: this.locale, format: this.format })"
+            },
+            {
+              "kind": "field",
+              "name": "validation",
+              "privacy": "private",
+              "default": "new AuroFormValidation()"
+            },
+            {
+              "kind": "field",
+              "name": "validationCCLength",
+              "privacy": "private",
+              "default": "undefined"
+            },
             {
               "kind": "field",
               "name": "value",
@@ -14363,11 +14873,6 @@
               "default": "undefined",
               "attribute": "value"
             },
-            {
-              "kind": "field",
-              "name": "_valueObject",
-              "default": "undefined"
-            },
             {
               "kind": "field",
               "name": "a11yRole",
@@ -14412,17 +14917,6 @@
               "attribute": "a11yActivedescendant",
               "reflects": true
             },
-            {
-              "kind": "field",
-              "name": "activeLabel",
-              "privacy": "public",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "If set, the label will remain fixed in the active position.",
-              "attribute": "activeLabel",
-              "reflects": true
-            },
             {
               "kind": "field",
               "name": "autocapitalize",
@@ -14466,17 +14960,6 @@
               "description": "Custom help text message for email type validity.",
               "attribute": "customValidityTypeEmail"
             },
-            {
-              "kind": "field",
-              "name": "dvInputOnly",
-              "privacy": "public",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "If defined, the display value slot content will only mask the HTML5 input element. The input's label will not be masked.",
-              "attribute": "dvInputOnly",
-              "reflects": true
-            },
             {
               "kind": "field",
               "name": "error",
@@ -14518,37 +15001,6 @@
               },
               "description": "Flag to indicate if the input currently has focus."
             },
-            {
-              "kind": "field",
-              "name": "hasValue",
-              "privacy": "public",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "Flag to indicate if the input currently has value."
-            },
-            {
-              "kind": "field",
-              "name": "hideLabelVisually",
-              "privacy": "private",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "If set, the label will be hidden visually but still accessible to assistive technologies.",
-              "attribute": "hideLabelVisually",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "icon",
-              "privacy": "public",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "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.",
-              "attribute": "icon",
-              "reflects": true
-            },
             {
               "kind": "field",
               "name": "id",
@@ -14613,17 +15065,6 @@
               "attribute": "nested",
               "reflects": true
             },
-            {
-              "kind": "field",
-              "name": "noValidate",
-              "privacy": "public",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "If set, disables auto-validation on blur.",
-              "attribute": "noValidate",
-              "reflects": true
-            },
             {
               "kind": "field",
               "name": "pattern",
@@ -14737,12 +15178,6 @@
               "description": "Custom help text message to display when validity = `valueMissing`.",
               "attribute": "setCustomValidityValueMissing"
             },
-            {
-              "kind": "field",
-              "name": "showPassword",
-              "privacy": "public",
-              "attribute": "showPassword"
-            },
             {
               "kind": "field",
               "name": "simple",
@@ -14765,15 +15200,6 @@
               "attribute": "spellcheck",
               "reflects": true
             },
-            {
-              "kind": "field",
-              "name": "touched",
-              "privacy": "private",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "Indicates whether the input is in a dirty state (has been interacted with)."
-            },
             {
               "kind": "field",
               "name": "type",
@@ -14903,6 +15329,7 @@
                 "text": "boolean"
               },
               "description": "If set, the label will remain fixed in the active position.",
+              "default": "false",
               "fieldName": "activeLabel"
             },
             {
@@ -14961,6 +15388,7 @@
                 "text": "boolean"
               },
               "description": "If defined, the display value slot content will only mask the HTML5 input element. The input's label will not be masked.",
+              "default": "false",
               "fieldName": "dvInputOnly"
             },
             {
@@ -14993,6 +15421,7 @@
                 "text": "boolean"
               },
               "description": "If set, the label will be hidden visually but still accessible to assistive technologies.",
+              "default": "false",
               "fieldName": "hideLabelVisually"
             },
             {
@@ -15001,6 +15430,7 @@
                 "text": "boolean"
               },
               "description": "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.",
+              "default": "false",
               "fieldName": "icon"
             },
             {
@@ -15094,6 +15524,7 @@
                 "text": "boolean"
               },
               "description": "If set, disables auto-validation on blur.",
+              "default": "false",
               "fieldName": "noValidate"
             },
             {
@@ -15213,6 +15644,10 @@
             },
             {
               "name": "showPassword",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
               "fieldName": "showPassword"
             },
             {
@@ -18506,6 +18941,18 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "_syncLabelText",
+              "description": "Reads the current label slot text and pushes it to the dropdown bib\n(for dialog naming) and the menu (for listbox aria-label). Safe to call\nbefore either child has been wired up — each branch self-guards.",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_observeLabelChanges",
+              "description": "Keeps the dialog/menu accessible names in sync when consumers mutate the\nlabel slot at runtime (e.g., i18n locale swap). `slotchange` alone is\ninsufficient — it doesn't fire when textContent of an already-assigned\nslotted node changes, which is the common case. We scope the observer to\nthe label node itself (not the whole host subtree) so option-content\nmutations don't trigger label re-syncs, and re-target on `slotchange`\nwhen consumers add or replace the label element.",
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "register",
@@ -19224,15 +19671,6 @@
                 "module": "components/layoutElement/src/auroElement.js"
               }
             },
-            {
-              "kind": "field",
-              "name": "options",
-              "privacy": "private",
-              "type": {
-                "text": "array"
-              },
-              "attribute": "options"
-            },
             {
               "kind": "field",
               "name": "optionSelected",
@@ -19601,13 +20039,6 @@
               "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
               "fieldName": "onDark"
             },
-            {
-              "name": "options",
-              "type": {
-                "text": "array"
-              },
-              "fieldName": "options"
-            },
             {
               "name": "optionSelected",
               "type": {
@@ -19785,7 +20216,7 @@
           "type": {
             "text": "object"
           },
-          "default": "{ ArrowDown(component, evt, ctx) { evt.preventDefault(); if (ctx.isExpanded) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { // navigate to last enabled option selectKeyboardStrategy.End(component, evt, ctx); } else { navigateArrow(component, 'down', { ctx }); } } else { component.dropdown.show(); } }, ArrowUp(component, evt, ctx) { evt.preventDefault(); if (ctx.isExpanded) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { // navigate to first enabled option selectKeyboardStrategy.Home(component, evt, ctx); } else { navigateArrow(component, 'up', { ctx }); } } else { component.dropdown.show(); } }, Escape(component, evt, ctx) { // Always clear the type-ahead buffer — Escape is a universal cancel. // Safe to call when the buffer is empty. // eslint-disable-next-line no-underscore-dangle if (typeof component._clearTypeaheadBuffer === 'function') { // eslint-disable-next-line no-underscore-dangle component._clearTypeaheadBuffer(); } if (!ctx.isExpanded) { return; } // Prevent the Escape key from bubbling up and closing any parent dialogs / drawers / popups evt.stopPropagation(); component.dropdown.hide(); }, End(component, evt, ctx) { if (!ctx.isExpanded) { return; } evt.preventDefault(); evt.stopPropagation(); // `pop()` is safe here: getEnabledOptions returns a fresh filtered array. const lastOption = getEnabledOptions(component.menu).pop(); if (lastOption) { component.menu.updateActiveOption(lastOption); } }, Enter(component, evt, ctx) { evt.preventDefault(); evt.stopPropagation(); if (!ctx.isExpanded) { component.dropdown.show(); return; } component.menu.makeSelection(); }, Home(component, evt, ctx) { if (!ctx.isExpanded) { return; } evt.preventDefault(); evt.stopPropagation(); const [firstOption] = getEnabledOptions(component.menu); if (firstOption) { component.menu.updateActiveOption(firstOption); } }, Tab(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Tab selects the focused option and closes the popup per the // WAI-ARIA APG select-only combobox / listbox pattern. if (component.optionActive) { component.menu.makeSelection(); } component.dropdown.hide(); }, default(component, evt, ctx) { // Space resolves to either typeahead-buffer extension or bib toggle // depending on whether a type-ahead buffer is active. Mirrors native // <select> and the WAI-ARIA APG Listbox guidance: mid-typeahead space // is a search character (e.g. \"San Francisco\"); otherwise it toggles. if (evt.key === ' ') { evt.preventDefault(); evt.stopPropagation(); if (component.typeaheadBuffer && component.typeaheadBuffer.length > 0) { component.updateActiveOptionBasedOnKey(evt.key); return; } if (ctx.isExpanded) { component.dropdown.hide(); } else { component.dropdown.show(); } return; } component.updateActiveOptionBasedOnKey(evt.key); }, }"
+          "default": "{ ArrowDown(component, evt, ctx) { evt.preventDefault(); if (ctx.isExpanded) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { // navigate to last enabled option selectKeyboardStrategy.End(component, evt, ctx); } else { navigateArrow(component, 'down', { ctx }); } } else { component.dropdown.show(); } }, ArrowUp(component, evt, ctx) { evt.preventDefault(); if (ctx.isExpanded) { if (evt.altKey || evt.ctrlKey || evt.metaKey) { // navigate to first enabled option selectKeyboardStrategy.Home(component, evt, ctx); } else { navigateArrow(component, 'up', { ctx }); } } else { component.dropdown.show(); } }, Escape(component, evt, ctx) { // Always clear the type-ahead buffer — Escape is a universal cancel. // Safe to call when the buffer is empty. // eslint-disable-next-line no-underscore-dangle if (typeof component._clearTypeaheadBuffer === 'function') { // eslint-disable-next-line no-underscore-dangle component._clearTypeaheadBuffer(); } if (!ctx.isExpanded) { return; } // Prevent the Escape key from bubbling up and closing any parent dialogs / drawers / popups evt.stopPropagation(); component.dropdown.hide(); }, End(component, evt, ctx) { evt.preventDefault(); evt.stopPropagation(); // `pop()` is safe here: getEnabledOptions returns a fresh filtered array. const lastOption = getEnabledOptions(component.menu).pop(); if (!lastOption) { return; } // Pre-stash before show() so the auroDropdown-toggled handler's // `!optionActive` guard short-circuits the firstActive/selected fallback — // otherwise show() synchronously fires the handler and writes // aria-activedescendant once before we overwrite it. component.menu.updateActiveOption(lastOption); if (!ctx.isExpanded) { component.dropdown.show(); } }, Enter(component, evt, ctx) { // Prevent the keypress from bubbling to parent containers (e.g., forms) // which could interpret Enter as a submit. Matches APG select-only combobox // and native <select> behavior: Enter opens the listbox when closed, selects // the active option when open — it does not submit a parent form. evt.preventDefault(); evt.stopPropagation(); if (!ctx.isExpanded) { component.dropdown.show(); return; } component.menu.makeSelection(); }, Home(component, evt, ctx) { evt.preventDefault(); evt.stopPropagation(); const [firstOption] = getEnabledOptions(component.menu); if (!firstOption) { return; } // See End() for why this must run before show(). component.menu.updateActiveOption(firstOption); if (!ctx.isExpanded) { component.dropdown.show(); } }, Tab(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Tab selects the focused option and closes the popup per the // WAI-ARIA APG select-only combobox / listbox pattern. if (component.optionActive) { component.menu.makeSelection(); } component.dropdown.hide(); }, default(component, evt, ctx) { // Space resolves to either typeahead-buffer extension or bib toggle // depending on whether a type-ahead buffer is active. Mirrors native // <select> and the WAI-ARIA APG Listbox guidance: mid-typeahead space // is a search character (e.g. \"San Francisco\"); otherwise it toggles. if (evt.key === ' ') { evt.preventDefault(); evt.stopPropagation(); if (component.typeaheadBuffer && component.typeaheadBuffer.length > 0) { component.updateActiveOptionBasedOnKey(evt.key); return; } if (ctx.isExpanded) { component.dropdown.hide(); } else { component.dropdown.show(); } return; } component.updateActiveOptionBasedOnKey(evt.key); }, }"
         }
       ],
       "exports": [