@aurodesignsystem-dev/auro-formkit 0.0.0-pr1530.2 → 0.0.0-pr1531.1

package/custom-elements.json

@@ -4621,17 +4621,6 @@
                 }
               }
             },
-            {
-              "kind": "method",
-              "name": "_initFromAncestors",
-              "description": "Wires the cell to its ancestor calendar-month and calendar (and, via\nthe calendar, to the datepicker). Extracted from firstUpdated() so the\nretry loop can re-attempt without recursively invoking a Lit lifecycle\nmethod (which is outside the framework's contract).",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              }
-            },
             {
               "kind": "method",
               "name": "configurePopover",
@@ -5293,25 +5282,6 @@
           "description": "",
           "name": "AuroCalendar",
           "members": [
-            {
-              "kind": "field",
-              "name": "disabledDays",
-              "deprecated": "See constructor JSDoc — migrate to\n`auro-datepicker.blackoutDates`. The getter/setter pair exists so the\none-time deprecation warning fires as soon as a consumer assigns a\nnon-empty array (empty assignments are ignored — an empty array is\nindistinguishable from the constructor default and would produce a\nspurious warning), rather than only when `_getBlackoutSet()` happens\nto rebuild.",
-              "return": {
-                "type": {
-                  "text": "Array"
-                }
-              },
-              "parameters": [
-                {
-                  "description": "The legacy `disabledDays` array to set.",
-                  "name": "value",
-                  "type": {
-                    "text": "Array"
-                  }
-                }
-              ]
-            },
             {
               "kind": "field",
               "name": "centralDateObject",
@@ -5586,7 +5556,7 @@
             {
               "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`.\n\nThe cache invalidates on **reference identity** — only when the\nconsumer reassigns the array (`el.blackoutDates = [...]`), matching\nLit's own reactivity semantics for array properties. In-place mutations\non the existing array (`push`, `splice`, index assignment) will NOT\ninvalidate the cache and the new entries will be silently ignored.\nConsumers must reassign to update — see the JSDoc on\n`auro-datepicker.blackoutDates` for the recommended pattern.\n\nA shallow-equality tier was considered but rejected: it would run\nO(N) work on every cell render (this method is called per-cell via\n`isBlackout()`) and still wouldn't catch same-length value swaps,\noffering a false sense of safety.",
+              "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": {
@@ -5962,7 +5932,7 @@
                   }
                 }
               ],
-              "description": "Debounced version of announceSelection for focus navigation.\nUses the assertive live region with a 150ms debounce so only the\nfinal cell after rapid arrow-key traversal is announced. We\noriginally tried aria-live=\"polite\" here, but VoiceOver treats\npolite as \"wait until idle\" — which never happens during active\nkeyboard navigation — so the announcements were silently dropped.\n\nThis is a documented deviation from WCAG 2.1 SC 4.1.3, which\nprefers `polite` for status messages. See the \"Documented\nDeviation\" section in components/datepicker/docs/pages/accessibility.md.",
+              "description": "Debounced version of announceSelection for focus navigation.\nUses the assertive live region with a 150ms debounce so only the\nfinal cell after rapid arrow-key traversal is announced. We\noriginally tried aria-live=\"polite\" here, but VoiceOver treats\npolite as \"wait until idle\" — which never happens during active\nkeyboard navigation — so the announcements were silently dropped.",
               "privacy": "private",
               "return": {
                 "type": {
@@ -6140,7 +6110,7 @@
             },
             {
               "kind": "field",
-              "name": "_disabledDays",
+              "name": "disabledDays",
               "type": {
                 "text": "array"
               },
@@ -7544,7 +7514,7 @@
               "type": {
                 "text": "array"
               },
-              "description": "Array of dates that cannot be selected. Dates should be in ISO format (YYYY-MM-DD).\n\n**Immutable update required.** The datepicker treats this array as\nimmutable and memoizes a lookup Set keyed on the array's reference\nidentity — matching Lit's own reactivity semantics for array\nproperties. In-place mutations (`blackoutDates.push(...)`,\n`blackoutDates[i] = ...`, `blackoutDates.splice(...)`) will not\ninvalidate the cache and the new entries will be silently ignored.\nTo update, reassign the property: `el.blackoutDates = [...el.blackoutDates, '2024-12-25']`.",
+              "description": "Array of dates that cannot be selected. Dates should be in ISO format (YYYY-MM-DD).",
               "default": "[]",
               "attribute": "blackoutDates",
               "reflects": true
@@ -8208,7 +8178,7 @@
               "type": {
                 "text": "array"
               },
-              "description": "Array of dates that cannot be selected. Dates should be in ISO format (YYYY-MM-DD).\n\n**Immutable update required.** The datepicker treats this array as\nimmutable and memoizes a lookup Set keyed on the array's reference\nidentity — matching Lit's own reactivity semantics for array\nproperties. In-place mutations (`blackoutDates.push(...)`,\n`blackoutDates[i] = ...`, `blackoutDates.splice(...)`) will not\ninvalidate the cache and the new entries will be silently ignored.\nTo update, reassign the property: `el.blackoutDates = [...el.blackoutDates, '2024-12-25']`.",
+              "description": "Array of dates that cannot be selected. Dates should be in ISO format (YYYY-MM-DD).",
               "default": "[]",
               "fieldName": "blackoutDates"
             },
@@ -8832,7 +8802,7 @@
           "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(); // Signal to the visibility-change handler in auro-datepicker.js that // focus should be restored to the trigger regardless of hasFocus. // hidePopover() (desktop non-modal path) does not auto-restore focus, // and hiding the grid's popover ancestor drops focus to <body>. That // synchronously fires focusout on the datepicker host — clearing // hasFocus — before updated() runs, which would otherwise skip the // input refocus. Native <dialog>.close() (modal path) restores focus // itself, but the flag is harmless there. component._restoreFocusOnClose = true; 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(); }, }"
+          "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": [
@@ -19198,7 +19168,7 @@
             {
               "kind": "method",
               "name": "configureMenu",
-              "description": "Binds all behavior needed to the menu after rendering.\n\nThe `<auro-menu>` reference is captured once and not re-targeted on\n`slotchange`. Runtime option mutations are covered via\n`auroMenu-optionsChange`, so swap options inside the menu freely; do not\nswap the `<auro-menu>` element itself under a live select — remount the\nparent `<auro-select>` instead.",
+              "description": "Binds all behavior needed to the menu after rendering.",
               "privacy": "private",
               "return": {
                 "type": {
@@ -20402,7 +20372,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) { evt.preventDefault(); evt.stopPropagation(); // `pop()` is safe here: getActiveOptions returns a fresh filtered array. // Uses \"active\" (not \"enabled\") so hidden and static rows — which a screen // reader must not announce as focused — are skipped. const lastOption = getActiveOptions(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] = getActiveOptions(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) { // Ignore keys chorded with Ctrl/Meta/Alt so browser/OS shortcuts // (Cmd+C, Ctrl+V, Alt+X, Cmd+Space, …) don't leak into typeahead // or toggle the bib. Native <select> ignores modified keys. // ArrowUp/ArrowDown handle modifier+arrow explicitly above; this // guard only affects the default (printable/Space) branch. if (evt.ctrlKey || evt.metaKey || evt.altKey) { return; } // 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": [

package/package.json

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