@aurodesignsystem-dev/auro-formkit 0.0.0-pr1516.0 → 0.0.0-pr1519.0

package/custom-elements.json

@@ -321,6 +321,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",
@@ -413,6 +440,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",
@@ -580,6 +627,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",
@@ -1152,15 +1219,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",
@@ -1611,7 +1669,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": [
@@ -12112,61 +12170,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",
@@ -12220,70 +12223,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",
@@ -12796,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",
@@ -12836,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",
@@ -13058,15 +12979,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",
@@ -13418,6 +13330,20 @@
                 "module": "components/input/src/base-input.js"
               }
             },
+            {
+              "kind": "field",
+              "name": "setCustomValidityPatternMismatch",
+              "privacy": "public",
+              "type": {
+                "text": "string"
+              },
+              "description": "Custom help text message to display when validity = `patternMismatch`.",
+              "attribute": "setCustomValidityPatternMismatch",
+              "inheritedFrom": {
+                "name": "BaseInput",
+                "module": "components/input/src/base-input.js"
+              }
+            },
             {
               "kind": "field",
               "name": "setCustomValidityRangeOverflow",
@@ -13523,7 +13449,7 @@
               "name": "type",
               "privacy": "public",
               "type": {
-                "text": "'text' | 'password' | 'email' | 'credit-card' | 'tel' | 'number'"
+                "text": "'text' | 'password' | 'email' | 'credit-card' | 'tel' | 'number' | 'date'"
               },
               "description": "Populates the `type` attribute on the input.",
               "default": "'text'",
@@ -14070,6 +13996,18 @@
                 "module": "components/input/src/base-input.js"
               }
             },
+            {
+              "name": "setCustomValidityPatternMismatch",
+              "type": {
+                "text": "string"
+              },
+              "description": "Custom help text message to display when validity = `patternMismatch`.",
+              "fieldName": "setCustomValidityPatternMismatch",
+              "inheritedFrom": {
+                "name": "BaseInput",
+                "module": "components/input/src/base-input.js"
+              }
+            },
             {
               "name": "setCustomValidityRangeOverflow",
               "type": {
@@ -14169,7 +14107,7 @@
             {
               "name": "type",
               "type": {
-                "text": "'text' | 'password' | 'email' | 'credit-card' | 'tel' | 'number'"
+                "text": "'text' | 'password' | 'email' | 'credit-card' | 'tel' | 'number' | 'date'"
               },
               "description": "Populates the `type` attribute on the input.",
               "default": "'text'",
@@ -14352,53 +14290,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",
@@ -14440,62 +14331,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",
@@ -14880,11 +14715,6 @@
               "default": "undefined",
               "attribute": "max"
             },
-            {
-              "kind": "field",
-              "name": "_maxObject",
-              "default": "undefined"
-            },
             {
               "kind": "field",
               "name": "maxLength",
@@ -14908,11 +14738,6 @@
               "default": "undefined",
               "attribute": "min"
             },
-            {
-              "kind": "field",
-              "name": "_minObject",
-              "default": "undefined"
-            },
             {
               "kind": "field",
               "name": "minLength",
@@ -15074,11 +14899,6 @@
               "default": "undefined",
               "attribute": "value"
             },
-            {
-              "kind": "field",
-              "name": "_valueObject",
-              "default": "undefined"
-            },
             {
               "kind": "field",
               "name": "a11yRole",
@@ -15334,6 +15154,16 @@
               "description": "Custom help text message to display when validity = `customError`.",
               "attribute": "setCustomValidityCustomError"
             },
+            {
+              "kind": "field",
+              "name": "setCustomValidityPatternMismatch",
+              "privacy": "public",
+              "type": {
+                "text": "string"
+              },
+              "description": "Custom help text message to display when validity = `patternMismatch`.",
+              "attribute": "setCustomValidityPatternMismatch"
+            },
             {
               "kind": "field",
               "name": "setCustomValidityRangeOverflow",
@@ -15411,7 +15241,7 @@
               "name": "type",
               "privacy": "public",
               "type": {
-                "text": "'text' | 'password' | 'email' | 'credit-card' | 'tel' | 'number'"
+                "text": "'text' | 'password' | 'email' | 'credit-card' | 'tel' | 'number' | 'date'"
               },
               "description": "Populates the `type` attribute on the input.",
               "default": "'text'",
@@ -15808,6 +15638,14 @@
               "default": "undefined",
               "fieldName": "setCustomValidityForType"
             },
+            {
+              "name": "setCustomValidityPatternMismatch",
+              "type": {
+                "text": "string"
+              },
+              "description": "Custom help text message to display when validity = `patternMismatch`.",
+              "fieldName": "setCustomValidityPatternMismatch"
+            },
             {
               "name": "setCustomValidityRangeOverflow",
               "type": {
@@ -15875,7 +15713,7 @@
             {
               "name": "type",
               "type": {
-                "text": "'text' | 'password' | 'email' | 'credit-card' | 'tel' | 'number'"
+                "text": "'text' | 'password' | 'email' | 'credit-card' | 'tel' | 'number' | 'date'"
               },
               "description": "Populates the `type` attribute on the input.",
               "default": "'text'",
@@ -16264,6 +16102,32 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "isValidPartialDate",
+              "parameters": [
+                {
+                  "name": "value",
+                  "description": "The user-facing display value.",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "format",
+                  "description": "The partial date format string (e.g. \"mm/yyyy\", \"yyyy\", \"dd\").",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Validates a value against a partial date format (one that lacks yy/mm/dd all three).\nSingle-component formats are checked as integer ranges; multi-component formats use\na date-fns parse + round-trip to confirm both validity and exact formatting.",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              }
+            },
             {
               "kind": "method",
               "name": "toModelValue",

package/package.json

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