@aurodesignsystem-dev/auro-formkit 0.0.0-pr1505.0 → 0.0.0-pr1506.1

package/custom-elements.json

@@ -1256,6 +1256,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> | null"
+                }
+              },
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "handleMenuOptions",
@@ -6305,14 +6325,6 @@
               "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"
@@ -11704,61 +11716,6 @@
                 "module": "components/input/src/base-input.js"
               }
             },
-            {
-              "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"
-                }
-              },
-              "inheritedFrom": {
-                "name": "BaseInput",
-                "module": "components/input/src/base-input.js"
-              }
-            },
-            {
-              "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"
-                }
-              },
-              "inheritedFrom": {
-                "name": "BaseInput",
-                "module": "components/input/src/base-input.js"
-              }
-            },
             {
               "kind": "method",
               "name": "patchInputEvent",
@@ -11812,70 +11769,6 @@
                 "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",
@@ -12251,15 +12144,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",
@@ -12291,15 +12175,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",
@@ -12408,15 +12283,6 @@
                 "module": "components/input/src/base-input.js"
               }
             },
-            {
-              "kind": "field",
-              "name": "_valueObject",
-              "default": "undefined",
-              "inheritedFrom": {
-                "name": "BaseInput",
-                "module": "components/input/src/base-input.js"
-              }
-            },
             {
               "kind": "field",
               "name": "a11yRole",
@@ -13815,53 +13681,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",
@@ -13903,62 +13722,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",
@@ -14246,11 +14009,6 @@
               "default": "undefined",
               "attribute": "max"
             },
-            {
-              "kind": "field",
-              "name": "_maxObject",
-              "default": "undefined"
-            },
             {
               "kind": "field",
               "name": "maxLength",
@@ -14274,11 +14032,6 @@
               "default": "undefined",
               "attribute": "min"
             },
-            {
-              "kind": "field",
-              "name": "_minObject",
-              "default": "undefined"
-            },
             {
               "kind": "field",
               "name": "minLength",
@@ -14371,11 +14124,6 @@
               "default": "undefined",
               "attribute": "value"
             },
-            {
-              "kind": "field",
-              "name": "_valueObject",
-              "default": "undefined"
-            },
             {
               "kind": "field",
               "name": "a11yRole",
@@ -18606,6 +18354,32 @@
               ],
               "description": "Updates the active option in the menu."
             },
+            {
+              "kind": "method",
+              "name": "_getOptionDisplayText",
+              "parameters": [
+                {
+                  "name": "option",
+                  "description": "The menu option element.",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                }
+              ],
+              "description": "Returns the lowercase, trimmed text content of a menu option.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_clearTypeaheadBuffer",
+              "description": "Empties the type-ahead buffer and cancels any pending reset timeout.\nCalled when focus leaves the component, when Escape closes the bib, and on disconnect\nso a stale buffer never bridges into a fresh interaction.",
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "updateActiveOptionBasedOnKey",
@@ -18618,7 +18392,7 @@
                   }
                 }
               ],
-              "description": "Updates the active option in the menu based on keyboard input.",
+              "description": "Updates the active option in the menu based on keyboard input.\n\nImplements the WAI-ARIA APG Listbox type-ahead pattern: accumulates printable\nkeystrokes into a buffer that resets after `typeaheadTimeoutMs` of inactivity.\nA multi-character buffer matches the first option whose displayed text starts\nwith the buffer; repeating a single character cycles through options that start\nwith that character.",
               "privacy": "private",
               "return": {
                 "type": {
@@ -19014,6 +18788,24 @@
               },
               "default": "false"
             },
+            {
+              "kind": "field",
+              "name": "typeaheadBuffer",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "default": "''"
+            },
+            {
+              "kind": "field",
+              "name": "_typeaheadTimeout",
+              "type": {
+                "text": "null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
             {
               "kind": "field",
               "name": "appearance",
@@ -19298,6 +19090,18 @@
               },
               "description": "Indicates whether the input is in a dirty state (has been interacted with)."
             },
+            {
+              "kind": "field",
+              "name": "typeaheadTimeoutMs",
+              "privacy": "public",
+              "type": {
+                "text": "number"
+              },
+              "description": "Milliseconds of keyboard inactivity before the type-ahead buffer resets.\nIncrease for users who type slowly.",
+              "default": "500",
+              "attribute": "typeaheadTimeoutMs",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "validity",
@@ -19650,6 +19454,15 @@
                 "module": "components/layoutElement/src/auroElement.js"
               }
             },
+            {
+              "name": "typeaheadTimeoutMs",
+              "type": {
+                "text": "number"
+              },
+              "description": "Milliseconds of keyboard inactivity before the type-ahead buffer resets.\nIncrease for users who type slowly.",
+              "default": "500",
+              "fieldName": "typeaheadTimeoutMs"
+            },
             {
               "name": "validity",
               "type": {
@@ -19728,7 +19541,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) { 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) { component.updateActiveOptionBasedOnKey(evt.key); if (evt.key === ' ') { evt.preventDefault(); evt.stopPropagation(); if (ctx.isExpanded) { component.dropdown.hide(); return; } component.dropdown.show(); } }, }"
+          "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); }, }"
         }
       ],
       "exports": [
@@ -19764,6 +19577,25 @@
               "text": "Array<HTMLElement>"
             }
           }
+        },
+        {
+          "kind": "function",
+          "name": "getActiveOptions",
+          "parameters": [
+            {
+              "name": "menu",
+              "description": "The auro-menu element.",
+              "type": {
+                "text": "HTMLElement | null | undefined"
+              }
+            }
+          ],
+          "description": "Returns the active (selectable + visible) options for type-ahead navigation.\n\nUses auro-menuoption's `isActive` getter, which excludes disabled, hidden,\nand static options (e.g. `static nomatch` placeholders) so the type-ahead\ncursor never lands on a non-actionable item. Same empty-safe handling as\n`getEnabledOptions`.",
+          "return": {
+            "type": {
+              "text": "Array<HTMLElement>"
+            }
+          }
         }
       ],
       "exports": [
@@ -19774,6 +19606,14 @@
             "name": "getEnabledOptions",
             "module": "components/select/src/selectUtils.js"
           }
+        },
+        {
+          "kind": "js",
+          "name": "getActiveOptions",
+          "declaration": {
+            "name": "getActiveOptions",
+            "module": "components/select/src/selectUtils.js"
+          }
         }
       ]
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aurodesignsystem-dev/auro-formkit",
-  "version": "0.0.0-pr1505.0",
+  "version": "0.0.0-pr1506.1",
   "description": "A collection of web components used to build forms.",
   "homepage": "https://github.com/AlaskaAirlines/auro-formkit#readme",
   "bugs": {