@aurodesignsystem-dev/auro-formkit 0.0.0-pr1510.2 → 0.0.0-pr1511.0

package/custom-elements.json

@@ -4577,7 +4577,7 @@
             {
               "kind": "method",
               "name": "updateHostAria",
-              "description": "Sets host-level ARIA so each cell exposes its date, selection state,\nand blackout status to assistive tech browsing the month grid.",
+              "description": "Updates ARIA attributes on the host element so that\nariaActiveDescendantElement can expose cell info to the SR.",
               "privacy": "private",
               "return": {
                 "type": {
@@ -4598,7 +4598,7 @@
             {
               "kind": "method",
               "name": "setActive",
-              "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.",
+              "description": "Imperatively marks this cell as active without triggering a Lit re-render.\nNote: buttons stay tabindex=\"-1\" because the grid uses aria-activedescendant.",
               "return": {
                 "type": {
                   "text": "void"
@@ -4743,7 +4743,6 @@
               "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"
             },
@@ -4903,7 +4902,6 @@
               "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"
             },
@@ -5308,26 +5306,6 @@
                 }
               }
             },
-            {
-              "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",
@@ -5379,40 +5357,6 @@
                 }
               }
             },
-            {
-              "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",
@@ -5436,7 +5380,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. DOM focus\nstays on the grid wrapper; the live region (see getOrCreateLiveRegion)\nis what announces the active cell to assistive tech.",
+              "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.",
               "return": {
                 "type": {
                   "text": "void"
@@ -5475,39 +5419,6 @@
                 }
               }
             },
-            {
-              "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",
@@ -5562,7 +5473,7 @@
                   }
                 }
               ],
-              "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.",
+              "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.",
               "privacy": "private",
               "return": {
                 "type": {
@@ -5682,7 +5593,7 @@
                   }
                 }
               ],
-              "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`).",
+              "description": "Checks whether a given date is a blackout date.",
               "privacy": "private",
               "return": {
                 "type": {
@@ -5793,33 +5704,6 @@
                 }
               }
             },
-            {
-              "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",
@@ -6004,7 +5888,7 @@
               "type": {
                 "text": "array"
               },
-              "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.",
+              "description": "Legacy array of disabled-date timestamps.",
               "privacy": "private",
               "default": "[]"
             },
@@ -6706,13 +6590,13 @@
               "parameters": [
                 {
                   "name": "time",
-                  "description": "Unix timestamp (seconds), local midnight of the day.",
+                  "description": "Unix timestamp in seconds.",
                   "type": {
                     "text": "number"
                   }
                 }
               ],
-              "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.",
+              "description": "Converts a Unix timestamp (seconds) from the vendor calendar to an ISO date string.",
               "privacy": "private",
               "return": {
                 "type": {
@@ -6988,34 +6872,6 @@
               },
               "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",
@@ -7380,23 +7236,11 @@
               "type": {
                 "text": "string"
               },
-              "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.",
+              "description": "Label announced for cells after the range (or after start when no end is selected).",
               "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",
@@ -7736,13 +7580,6 @@
               "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",
@@ -7913,7 +7750,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
             },
@@ -8353,7 +8190,7 @@
               "type": {
                 "text": "string"
               },
-              "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.",
+              "description": "Label announced for cells after the range (or after start when no end is selected).",
               "default": "'after range'",
               "fieldName": "rangeLabelAfterRange"
             },
@@ -8375,15 +8212,6 @@
               "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": {
@@ -8407,7 +8235,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"
             },
             {
@@ -8557,116 +8385,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "components/datepicker/src/blackoutUtils.js",
-      "declarations": [
-        {
-          "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",
@@ -18917,6 +18635,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",
@@ -19635,15 +19365,6 @@
                 "module": "components/layoutElement/src/auroElement.js"
               }
             },
-            {
-              "kind": "field",
-              "name": "options",
-              "privacy": "private",
-              "type": {
-                "text": "array"
-              },
-              "attribute": "options"
-            },
             {
               "kind": "field",
               "name": "optionSelected",
@@ -20012,13 +19733,6 @@
               "description": "DEPRECATED - use `appearance=\"inverse\"` instead.",
               "fieldName": "onDark"
             },
-            {
-              "name": "options",
-              "type": {
-                "text": "array"
-              },
-              "fieldName": "options"
-            },
             {
               "name": "optionSelected",
               "type": {
@@ -20196,7 +19910,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; } if (!ctx.isExpanded) { component.dropdown.show(); } component.menu.updateActiveOption(lastOption); }, 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; } if (!ctx.isExpanded) { component.dropdown.show(); } 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": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aurodesignsystem-dev/auro-formkit",
-  "version": "0.0.0-pr1510.2",
+  "version": "0.0.0-pr1511.0",
   "description": "A collection of web components used to build forms.",
   "homepage": "https://github.com/AlaskaAirlines/auro-formkit#readme",
   "bugs": {
@@ -27,10 +27,7 @@
   ],
   "files": [
     "components/*/dist/**/*",
-    "components/*/demo/**/*.md",
-    "components/*/demo/**/*.html",
-    "components/*/demo/**/*.min.*",
-    "components/*/demo/**/*.json",
+    "components/*/demo/**/*",
     "CHANGELOG.md",
     "README.md",
     "LICENSE",
@@ -158,7 +155,6 @@
     "concat": "^1.0.3",
     "concurrently": "^9.2.1",
     "core-js": "^3.49.0",
-    "cross-env": "^10.1.0",
     "date-fns": "^4.1.0",
     "eslint": "^10.2.1",
     "eslint-plugin-jsdoc": "^62.9.0",

package/components/datepicker/dist/blackoutUtils.d.ts

@@ -1,43 +0,0 @@
-/**
- * Single source of truth for parsing and matching blackout dates across the
- * datepicker. Both `auro-calendar` (memoized Set + `isDateBlackout`) and the
- * pre-`firstUpdated` fallback inside `auro-calendar-cell` route through these
- * helpers so the YYYY-MM-DD → seconds conversion and the merge-with-legacy
- * `disabledDays` rules are defined exactly once.
- */
-/**
- * Converts a `YYYY-MM-DD` ISO date string to a Unix timestamp (seconds)
- * representing local midnight on that calendar day. Returns `null` for
- * inputs that don't parse to a finite timestamp.
- *
- * Uses the `new Date(year, monthIndex, day)` constructor (NOT
- * `new Date(isoStr)`) so the result is local-midnight rather than UTC
- * midnight — required to keep the calendar grid aligned with the user's
- * local calendar day in negative-offset timezones.
- *
- * @param {string} isoStr - Date string in `YYYY-MM-DD` format.
- * @returns {number|null} Local-midnight Unix timestamp (seconds), or null.
- */
-export function parseIsoToTimestamp(isoStr: string): number | null;
-/**
- * Builds a `Set<number>` of seconds-since-epoch timestamps covering both the
- * legacy `disabledDays` (already-numeric) array and the ISO `blackoutDates`
- * array. Use this for O(1) membership checks in hot paths.
- *
- * @param {Array<string|number>|undefined} disabledDays - Legacy timestamp array.
- * @param {Array<string>|undefined} blackoutDates - ISO `YYYY-MM-DD` array.
- * @returns {Set<number>}
- */
-export function buildBlackoutSet(disabledDays: Array<string | number> | undefined, blackoutDates: Array<string> | undefined): Set<number>;
-/**
- * One-shot membership test for a single timestamp against both blackout
- * sources. Allocates a Set on each call; only use this in cold paths
- * (e.g. the pre-`firstUpdated` cell fallback). Hot paths should hold the
- * Set returned from `buildBlackoutSet` and `.has(ts)` directly.
- *
- * @param {number} dateTs - Unix timestamp (seconds) to test.
- * @param {Array<string|number>|undefined} disabledDays - Legacy timestamp array.
- * @param {Array<string>|undefined} blackoutDates - ISO `YYYY-MM-DD` array.
- * @returns {boolean}
- */
-export function isBlackoutTimestamp(dateTs: number, disabledDays: Array<string | number> | undefined, blackoutDates: Array<string> | undefined): boolean;