@nysds/components 1.13.1 → 1.15.0

package/dist/custom-elements.json

@@ -33,6 +33,20 @@
           "kind": "class",
           "description": "A container for grouping `nys-accordionitem` components with coordinated expand/collapse behavior.\n\nPlace `nys-accordionitem` elements as children. Set `singleSelect` to allow only one item open at a time.\nThe `bordered` style propagates to all children automatically.",
           "name": "NysAccordion",
+          "cssProperties": [
+            {
+              "description": "Background color of the accordion header.",
+              "name": "--nys-accordion-background-color--header"
+            },
+            {
+              "description": "Background hover color of the accordion header.",
+              "name": "--nys-accordion-background-color--header--hover"
+            },
+            {
+              "description": "Maximum readable width of accordion content. Defaults to a character-based width (80ch) for readability.",
+              "name": "--nys-accordion-content-max-width"
+            }
+          ],
           "slots": [
             {
               "description": "Default slot for `nys-accordionitem` elements.",
@@ -1436,6 +1450,15 @@
             }
           ],
           "members": [
+            {
+              "kind": "field",
+              "name": "shadowRootOptions",
+              "type": {
+                "text": "object"
+              },
+              "static": true,
+              "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true, }"
+            },
             {
               "kind": "field",
               "name": "id",
@@ -2024,6 +2047,15 @@
             }
           ],
           "members": [
+            {
+              "kind": "field",
+              "name": "shadowRootOptions",
+              "type": {
+                "text": "object"
+              },
+              "static": true,
+              "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true, }"
+            },
             {
               "kind": "field",
               "name": "checked",
@@ -2194,6 +2226,39 @@
               "attribute": "size",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "other",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "other",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "showOtherError",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "showOtherError"
+            },
+            {
+              "kind": "field",
+              "name": "isMobile",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_hasUserInteracted",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
             {
               "kind": "method",
               "name": "getInputElement",
@@ -2285,12 +2350,27 @@
               "name": "_manageLabelClick",
               "privacy": "private"
             },
+            {
+              "kind": "field",
+              "name": "_hasDescription",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "_handleResize",
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "_emitChangeEvent",
               "privacy": "private",
               "description": "Event Handlers\n--------------------------------------------------------------------------"
             },
+            {
+              "kind": "method",
+              "name": "_emitOtherInputEvent",
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "_handleChange",
@@ -2314,6 +2394,11 @@
               "name": "_handleBlur",
               "privacy": "private"
             },
+            {
+              "kind": "method",
+              "name": "_handleTextInputBlur",
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "_handleKeydown",
@@ -2326,6 +2411,29 @@
                   }
                 }
               ]
+            },
+            {
+              "kind": "method",
+              "name": "_handleTextInput",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_validateOtherAndEmitError",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_dispatchClearError",
+              "privacy": "private"
             }
           ],
           "events": [
@@ -2336,6 +2444,13 @@
               },
               "description": "Fired when checked state changes. Detail: `{id, checked, name, value}`."
             },
+            {
+              "name": "nys-other-input",
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Fired when \"other\" text input value changes. Detail: `{id, name, value}`."
+            },
             {
               "name": "nys-focus",
               "type": {
@@ -2349,6 +2464,18 @@
                 "text": "Event"
               },
               "description": "Fired when checkbox loses focus."
+            },
+            {
+              "name": "nys-error",
+              "type": {
+                "text": "CustomEvent"
+              }
+            },
+            {
+              "name": "nys-error-clear",
+              "type": {
+                "text": "CustomEvent"
+              }
             }
           ],
           "attributes": [
@@ -2495,6 +2622,22 @@
               "default": "\"md\"",
               "description": "Checkbox size: `sm` (24px) or `md` (32px, default).",
               "fieldName": "size"
+            },
+            {
+              "name": "other",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "other"
+            },
+            {
+              "name": "showOtherError",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "showOtherError"
             }
           ],
           "superclass": {
@@ -2544,6 +2687,15 @@
             }
           ],
           "members": [
+            {
+              "kind": "field",
+              "name": "shadowRootOptions",
+              "type": {
+                "text": "object"
+              },
+              "static": true,
+              "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true, }"
+            },
             {
               "kind": "field",
               "name": "id",
@@ -2692,6 +2844,24 @@
               "privacy": "private",
               "default": "\"\""
             },
+            {
+              "kind": "field",
+              "name": "_hasOtherError",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_otherErrorCheckbox",
+              "type": {
+                "text": "NysCheckbox | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
             {
               "kind": "field",
               "name": "_internals",
@@ -2712,10 +2882,15 @@
             },
             {
               "kind": "method",
-              "name": "_setGroupExist",
+              "name": "_hasAtLeastOneChecked",
               "privacy": "private",
               "description": "Functions\n--------------------------------------------------------------------------"
             },
+            {
+              "kind": "method",
+              "name": "_setGroupExist",
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "_setupCheckboxRequired",
@@ -2726,6 +2901,11 @@
               "name": "_manageRequire",
               "privacy": "private"
             },
+            {
+              "kind": "method",
+              "name": "_setCustomOtherError",
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "_updateCheckboxSize",
@@ -2787,6 +2967,45 @@
                 }
               ],
               "description": "Event Handlers\n--------------------------------------------------------------------------"
+            },
+            {
+              "kind": "method",
+              "name": "_handleChildError",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_handleChildErrorClear",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_checkOtherInputs",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "checkboxes",
+                  "type": {
+                    "text": "NysCheckbox[]"
+                  }
+                }
+              ]
             }
           ],
           "attributes": [
@@ -2938,7 +3157,7 @@
     },
     {
       "kind": "javascript-module",
-      "path": "packages/nys-datepicker/src/index.ts",
+      "path": "packages/nys-combobox/src/index.ts",
       "declarations": [],
       "exports": [
         {
@@ -2946,19 +3165,29 @@
           "name": "*",
           "declaration": {
             "name": "*",
-            "module": "packages/nys-datepicker/src/nys-datepicker"
+            "module": "packages/nys-combobox/src/nys-combobox"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "packages/nys-datepicker/src/nys-datepicker.ts",
+      "path": "packages/nys-combobox/src/nys-combobox.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "`<nys-datepicker>` is a form-associated, accessible date picker component.\nOptionally wraps a `<wc-datepicker>` for custom calendar UI.\n\nEvents:",
-          "name": "NysDatepicker",
+          "description": "`<nys-combobox>` is a form-enabled combo box combining text input with a filterable dropdown.\n\nFeatures:\n- Type to filter options\n- Keyboard navigation (Arrow keys, Enter, Escape)\n- Mouse and keyboard interaction\n- Clears non-selected text on blur\n- Clear button when value is selected\n- Integrates with forms via ElementInternals\n- Supports native <option> and <optgroup> elements\n- Accessible per W3C ARIA Authoring Practices",
+          "name": "NysCombobox",
+          "slots": [
+            {
+              "description": "Optional custom description content below the label.",
+              "name": "description"
+            },
+            {
+              "description": "Options (<option>, <optgroup>) to populate the dropdown",
+              "name": "default"
+            }
+          ],
           "members": [
             {
               "kind": "field",
@@ -2982,31 +3211,30 @@
             },
             {
               "kind": "field",
-              "name": "width",
+              "name": "label",
               "type": {
-                "text": "\"md\" | \"lg\" | \"full\""
+                "text": "string"
               },
-              "default": "\"md\"",
-              "attribute": "width",
-              "reflects": true
+              "default": "\"\"",
+              "attribute": "label"
             },
             {
               "kind": "field",
-              "name": "hideTodayButton",
+              "name": "description",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "attribute": "hideTodayButton"
+              "default": "\"\"",
+              "attribute": "description"
             },
             {
               "kind": "field",
-              "name": "hideClearButton",
+              "name": "value",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "attribute": "hideClearButton"
+              "default": "\"\"",
+              "attribute": "value"
             },
             {
               "kind": "field",
@@ -3040,22 +3268,12 @@
             },
             {
               "kind": "field",
-              "name": "showError",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "attribute": "showError",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "errorMessage",
+              "name": "tooltip",
               "type": {
                 "text": "string"
               },
               "default": "\"\"",
-              "attribute": "errorMessage"
+              "attribute": "tooltip"
             },
             {
               "kind": "field",
@@ -3069,67 +3287,130 @@
             },
             {
               "kind": "field",
-              "name": "tooltip",
+              "name": "width",
               "type": {
-                "text": "string"
+                "text": "\"md\" | \"lg\" | \"full\""
               },
-              "default": "\"\"",
-              "attribute": "tooltip"
+              "default": "\"full\"",
+              "attribute": "width",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "type",
+              "name": "inverted",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "\"date\"",
-              "attribute": "type"
+              "default": "false",
+              "attribute": "inverted",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "label",
+              "name": "showError",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "\"\"",
-              "attribute": "label"
+              "default": "false",
+              "attribute": "showError",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "description",
+              "name": "errorMessage",
               "type": {
                 "text": "string"
               },
               "default": "\"\"",
-              "attribute": "description"
+              "attribute": "errorMessage"
             },
             {
               "kind": "field",
-              "name": "startDate",
+              "name": "_isOpen",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_filterText",
               "type": {
                 "text": "string"
               },
-              "default": "\"\"",
-              "attribute": "startDate"
+              "privacy": "private",
+              "default": "\"\""
             },
             {
               "kind": "field",
-              "name": "inverted",
+              "name": "_highlightedIndex",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "-1"
+            },
+            {
+              "kind": "field",
+              "name": "_options",
+              "type": {
+                "text": "ComboboxOption[]"
+              },
+              "privacy": "private",
+              "default": "[]"
+            },
+            {
+              "kind": "field",
+              "name": "_filteredOptions",
+              "type": {
+                "text": "ComboboxOption[]"
+              },
+              "privacy": "private",
+              "default": "[]"
+            },
+            {
+              "kind": "field",
+              "name": "_dropdownAbove",
               "type": {
                 "text": "boolean"
               },
-              "default": "false",
-              "attribute": "inverted",
-              "reflects": true
+              "privacy": "private",
+              "default": "false"
             },
             {
               "kind": "field",
-              "name": "value",
+              "name": "_announcement",
               "type": {
-                "text": "string | Date | undefined"
+                "text": "string"
               },
-              "default": "undefined",
-              "attribute": "value"
+              "privacy": "private",
+              "default": "\"\""
+            },
+            {
+              "kind": "field",
+              "name": "_input",
+              "type": {
+                "text": "HTMLInputElement"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_listbox",
+              "type": {
+                "text": "HTMLElement | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_originalErrorMessage",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "default": "\"\""
             },
             {
               "kind": "field",
@@ -3148,6 +3429,24 @@
               },
               "privacy": "private"
             },
+            {
+              "kind": "field",
+              "name": "_selectedLabel",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "default": "\"\""
+            },
+            {
+              "kind": "field",
+              "name": "_defaultValue",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "default": "\"\""
+            },
             {
               "kind": "field",
               "name": "formAssociated",
@@ -3160,38 +3459,43 @@
             },
             {
               "kind": "method",
-              "name": "_whenWcDatepickerReady",
+              "name": "_handleSlotChange",
               "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "Promise<WcDatepicker | null>"
-                }
-              }
+              "description": "Slot handling\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
               "name": "_setValue",
               "privacy": "private",
+              "description": "Form Integration\n--------------------------------------------------------------------------"
+            },
+            {
+              "kind": "method",
+              "name": "_manageRequire",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_setValidityMessage",
+              "privacy": "private",
               "parameters": [
                 {
-                  "name": "value",
+                  "name": "message",
+                  "default": "\"\"",
                   "type": {
-                    "text": "Date | string | undefined"
+                    "text": "string"
                   }
                 }
-              ],
-              "description": "Form helper methods:\n- _setValue: set internal value and trigger validation\n- _manageRequire: handle required state\n- _validate: actively validate and show errors\n- checkValidity: passive boolean check without UI\n- _setValidityMessage: sync validation message with UI and internals\n- _handleInvalid: handle form invalid event and focus first invalid field"
+              ]
             },
             {
               "kind": "method",
-              "name": "_manageRequire",
+              "name": "_validate",
               "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "_validate",
-              "privacy": "private",
-              "description": "Actively validates the component:\n- Updates internal validity state\n- Updates UI (e.g. showError)\n- Called on blur/change or form submission"
+              "name": "formResetCallback"
             },
             {
               "kind": "method",
@@ -3200,74 +3504,92 @@
                 "type": {
                   "text": "boolean"
                 }
-              },
-              "description": "Passive check of validity:\n- Returns true/false\n- Does NOT update UI or show errors\n- Used in form submission checks"
+              }
             },
             {
               "kind": "method",
-              "name": "_setValidityMessage",
+              "name": "_handleInvalid",
               "privacy": "private",
               "parameters": [
                 {
-                  "name": "message",
-                  "default": "\"\"",
+                  "name": "event",
                   "type": {
-                    "text": "string"
+                    "text": "Event"
                   }
                 }
               ]
             },
             {
               "kind": "method",
-              "name": "_handleInvalid",
+              "name": "_positionDropdown",
+              "privacy": "private",
+              "description": "Dropdown positioning\n--------------------------------------------------------------------------"
+            },
+            {
+              "kind": "method",
+              "name": "_filterOptions",
               "privacy": "private",
               "parameters": [
                 {
-                  "name": "event",
+                  "name": "searchText",
                   "type": {
-                    "text": "Event"
+                    "text": "string"
                   }
                 }
-              ]
+              ],
+              "description": "Filtering\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
-              "name": "_replaceButtonSVG",
+              "name": "_scrollToHighlighted",
               "privacy": "private",
-              "description": "Replaces the default wc-datepicker month navigation buttons\nwith NYS icon components for previous and next month."
+              "description": "Keyboard navigation\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
-              "name": "_addMonthDropdownIcon",
-              "privacy": "private"
+              "name": "_handleKeyDown",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                }
+              ]
             },
             {
               "kind": "method",
-              "name": "_parseLocalDate",
+              "name": "_moveHighlight",
               "privacy": "private",
               "parameters": [
                 {
-                  "name": "dateString",
+                  "name": "direction",
                   "type": {
-                    "text": "string"
+                    "text": "number"
                   }
                 }
               ]
             },
             {
               "kind": "method",
-              "name": "_handleInputKeydown",
+              "name": "_handleInput",
               "privacy": "private",
               "parameters": [
                 {
                   "name": "event",
                   "type": {
-                    "text": "KeyboardEvent"
+                    "text": "Event"
                   }
                 }
               ],
               "description": "Event Handlers\n--------------------------------------------------------------------------"
             },
+            {
+              "kind": "method",
+              "name": "_handleFocus",
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "_handleBlur",
@@ -3282,38 +3604,18 @@
               ]
             },
             {
-              "kind": "method",
-              "name": "_onDocumentClick",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "_toggleDatepicker",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "_openDatepicker",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "_handleDateChange",
+              "kind": "field",
+              "name": "_handleDocumentClick",
               "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "_handleTodayClick",
+              "name": "_handleIconClick",
               "privacy": "private"
             },
             {
               "kind": "method",
               "name": "_handleClearClick",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "_handleInputChange",
               "privacy": "private",
               "parameters": [
                 {
@@ -3326,68 +3628,93 @@
             },
             {
               "kind": "method",
-              "name": "_getValidDateFromInput",
+              "name": "_handleOptionClick",
               "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "Date | null"
-                }
-              },
               "parameters": [
                 {
-                  "name": "value",
+                  "name": "option",
                   "type": {
-                    "text": "string"
+                    "text": "ComboboxOption"
                   }
                 }
               ]
             },
             {
               "kind": "method",
-              "name": "_isSafari",
+              "name": "_handleOptionMouseEnter",
               "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "boolean"
+              "parameters": [
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
                 }
-              }
+              ]
             },
             {
               "kind": "method",
-              "name": "_isMobile",
+              "name": "_selectOption",
               "privacy": "private",
-              "return": {
-                "type": {
-                  "text": ""
+              "parameters": [
+                {
+                  "name": "option",
+                  "type": {
+                    "text": "ComboboxOption"
+                  }
                 }
-              },
-              "description": "Determines whether the current device uses a coarse pointer.\nA coarse pointer usually means touch-based input where precise pointing\nis not expected, such as fingers on phones and most tablets.\n\nNote: This is not a guarantee of a mobile device.\nSome non-mobile devices may also report a coarse pointer,\nand some mobile devices may not."
+              ]
             },
             {
               "kind": "method",
-              "name": "_shouldUseNativeDatepicker",
+              "name": "_handleChange",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_openDropdown",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_closeDropdown",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_renderOptions",
               "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "boolean"
-                }
-              }
+              "description": "Render helpers\n--------------------------------------------------------------------------"
             }
           ],
           "events": [
+            {
+              "name": "nys-input",
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Fired on input change. Detail: `{ id, value }`."
+            },
+            {
+              "name": "nys-focus",
+              "type": {
+                "text": "Event"
+              },
+              "description": "Fired when combobox receives focus."
+            },
             {
               "name": "nys-blur",
               "type": {
                 "text": "Event"
               },
-              "description": "Dispatched when input or calendar loses focus"
+              "description": "Fired when combobox loses focus."
             },
             {
-              "name": "nys-input",
+              "name": "nys-change",
               "type": {
                 "text": "CustomEvent"
               },
-              "description": "Dispatched when user selects or types a valid date Notes: - Uses native date input on Safari or mobile devices (custom calendar removed for these scenarios)"
+              "description": "Fired when selection changes. Detail: `{ id, value }`."
             }
           ],
           "attributes": [
@@ -3408,246 +3735,1486 @@
               "fieldName": "name"
             },
             {
-              "name": "width",
+              "name": "label",
               "type": {
-                "text": "\"md\" | \"lg\" | \"full\""
+                "text": "string"
               },
-              "default": "\"md\"",
+              "default": "\"\"",
+              "fieldName": "label"
+            },
+            {
+              "name": "description",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "fieldName": "description"
+            },
+            {
+              "name": "value",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "fieldName": "value"
+            },
+            {
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "disabled"
+            },
+            {
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "required"
+            },
+            {
+              "name": "optional",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "optional"
+            },
+            {
+              "name": "tooltip",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "fieldName": "tooltip"
+            },
+            {
+              "name": "form",
+              "type": {
+                "text": "string | null"
+              },
+              "default": "null",
+              "fieldName": "form"
+            },
+            {
+              "name": "width",
+              "type": {
+                "text": "\"md\" | \"lg\" | \"full\""
+              },
+              "default": "\"full\"",
               "fieldName": "width"
             },
             {
+              "name": "inverted",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "inverted"
+            },
+            {
+              "name": "showError",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "showError"
+            },
+            {
+              "name": "errorMessage",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "fieldName": "errorMessage"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "nys-combobox",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "custom-element-definition",
+          "name": "nys-combobox",
+          "declaration": {
+            "name": "NysCombobox",
+            "module": "packages/nys-combobox/src/nys-combobox.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "NysCombobox",
+          "declaration": {
+            "name": "NysCombobox",
+            "module": "packages/nys-combobox/src/nys-combobox.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "packages/nys-datepicker/src/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "packages/nys-datepicker/src/nys-datepicker"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "packages/nys-datepicker/src/nys-datepicker.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Date picker with calendar popup and form validation. Falls back to native date input\non Safari and mobile.",
+          "name": "NysDatepicker",
+          "members": [
+            {
+              "kind": "field",
+              "name": "shadowRootOptions",
+              "type": {
+                "text": "object"
+              },
+              "static": true,
+              "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true, }"
+            },
+            {
+              "kind": "field",
+              "name": "id",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Unique identifier. Auto-generated if not provided.",
+              "attribute": "id",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "name",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Name for form submission.",
+              "attribute": "name",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "width",
+              "type": {
+                "text": "\"md\" | \"lg\" | \"full\""
+              },
+              "default": "\"md\"",
+              "description": "Input width: `md` (200px), `lg` (384px), `full` (100%).",
+              "attribute": "width",
+              "reflects": true
+            },
+            {
+              "kind": "field",
               "name": "hideTodayButton",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "fieldName": "hideTodayButton"
+              "description": "Hide the \"Today\" button in calendar popup.",
+              "attribute": "hideTodayButton"
             },
             {
+              "kind": "field",
               "name": "hideClearButton",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "fieldName": "hideClearButton"
+              "description": "Hide the \"Clear\" button in calendar popup.",
+              "attribute": "hideClearButton"
             },
             {
+              "kind": "field",
               "name": "disabled",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "fieldName": "disabled"
+              "description": "Disable interaction.",
+              "attribute": "disabled",
+              "reflects": true
             },
             {
+              "kind": "field",
               "name": "required",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "fieldName": "required"
+              "description": "Mark as required. Shows \"Required\" flag and validates on blur.",
+              "attribute": "required",
+              "reflects": true
             },
             {
+              "kind": "field",
               "name": "optional",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "fieldName": "optional"
+              "description": "Show \"Optional\" flag. Use when most fields are required.",
+              "attribute": "optional",
+              "reflects": true
             },
             {
+              "kind": "field",
               "name": "showError",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "fieldName": "showError"
+              "description": "Show error state.",
+              "attribute": "showError",
+              "reflects": true
             },
             {
+              "kind": "field",
               "name": "errorMessage",
               "type": {
                 "text": "string"
               },
               "default": "\"\"",
-              "fieldName": "errorMessage"
+              "description": "Error message text.",
+              "attribute": "errorMessage"
             },
             {
+              "kind": "field",
               "name": "form",
               "type": {
                 "text": "string | null"
               },
               "default": "null",
-              "fieldName": "form"
+              "description": "Form `id` to associate with when input is outside form.",
+              "attribute": "form",
+              "reflects": true
             },
             {
+              "kind": "field",
               "name": "tooltip",
               "type": {
                 "text": "string"
               },
               "default": "\"\"",
-              "fieldName": "tooltip"
+              "description": "Tooltip text on info icon hover.",
+              "attribute": "tooltip"
             },
             {
+              "kind": "field",
               "name": "type",
               "type": {
                 "text": "string"
               },
               "default": "\"date\"",
-              "fieldName": "type"
+              "description": "Input type. Currently only supports `date`.",
+              "attribute": "type"
             },
             {
+              "kind": "field",
               "name": "label",
               "type": {
                 "text": "string"
               },
               "default": "\"\"",
-              "fieldName": "label"
+              "description": "Label text. Required for accessibility.",
+              "attribute": "label"
             },
             {
+              "kind": "field",
               "name": "description",
               "type": {
                 "text": "string"
               },
               "default": "\"\"",
-              "fieldName": "description"
+              "description": "Helper text below label.",
+              "attribute": "description"
             },
             {
+              "kind": "field",
               "name": "startDate",
               "type": {
                 "text": "string"
               },
               "default": "\"\"",
-              "fieldName": "startDate"
+              "description": "Initial date when calendar opens (YYYY-MM-DD).",
+              "attribute": "startDate"
             },
             {
+              "kind": "field",
               "name": "inverted",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "fieldName": "inverted"
+              "description": "Dark background mode.",
+              "attribute": "inverted",
+              "reflects": true
             },
             {
+              "kind": "field",
               "name": "value",
               "type": {
                 "text": "string | Date | undefined"
               },
               "default": "undefined",
-              "fieldName": "value"
-            }
-          ],
-          "superclass": {
-            "name": "LitElement",
-            "package": "lit"
-          },
-          "tagName": "nys-datepicker",
-          "customElement": true
-        }
-      ],
-      "exports": [
-        {
-          "kind": "custom-element-definition",
-          "name": "nys-datepicker",
-          "declaration": {
-            "name": "NysDatepicker",
-            "module": "packages/nys-datepicker/src/nys-datepicker.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "NysDatepicker",
-          "declaration": {
-            "name": "NysDatepicker",
-            "module": "packages/nys-datepicker/src/nys-datepicker.ts"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "name": "wc-datepicker",
-          "declaration": {
-            "name": "WcDatepicker",
-            "package": "wc-datepicker/dist/components/wc-datepicker"
+              "description": "Selected date. Accepts Date object or ISO string (YYYY-MM-DD).",
+              "attribute": "value"
+            },
+            {
+              "kind": "field",
+              "name": "datepickerIsOpen",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_hasUserInteracted",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_internals",
+              "type": {
+                "text": "ElementInternals"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "formAssociated",
+              "type": {
+                "text": "boolean"
+              },
+              "static": true,
+              "default": "true",
+              "description": "Lifecycle methods\n--------------------------------------------------------------------------"
+            },
+            {
+              "kind": "method",
+              "name": "_whenWcDatepickerReady",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Promise<WcDatepicker | null>"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_setValue",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "Date | string | undefined"
+                  }
+                }
+              ],
+              "description": "Form helper methods:\n- _setValue: set internal value and trigger validation\n- _manageRequire: handle required state\n- _validate: actively validate and show errors\n- checkValidity: passive boolean check without UI\n- _setValidityMessage: sync validation message with UI and internals\n- _handleInvalid: handle form invalid event and focus first invalid field"
+            },
+            {
+              "kind": "method",
+              "name": "_manageRequire",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_validate",
+              "privacy": "private",
+              "description": "Actively validates the component:\n- Updates internal validity state\n- Updates UI (e.g. showError)\n- Called on blur/change or form submission"
+            },
+            {
+              "kind": "method",
+              "name": "checkValidity",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "description": "Passive check of validity:\n- Returns true/false\n- Does NOT update UI or show errors\n- Used in form submission checks"
+            },
+            {
+              "kind": "method",
+              "name": "_setValidityMessage",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "message",
+                  "default": "\"\"",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_handleInvalid",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_replaceButtonSVG",
+              "privacy": "private",
+              "description": "Replaces the default wc-datepicker month navigation buttons\nwith NYS icon components for previous and next month."
+            },
+            {
+              "kind": "method",
+              "name": "_addMonthDropdownIcon",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_parseLocalDate",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "dateString",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_setTodayDate",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_setFocusOnTodayDate",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "visualFocusOnly",
+                  "default": "false"
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_dispatchInputEvent",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_handleInputKeydown",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                }
+              ],
+              "description": "Event Handlers\n--------------------------------------------------------------------------"
+            },
+            {
+              "kind": "method",
+              "name": "_handleBlur",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "FocusEvent"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_onDocumentClick",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_onKeydownEsc",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_toggleDatepicker",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_openDatepicker",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_handleDateChange",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_handleTodayClick",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_handleClearClick",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_handleInputChange",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_getValidDateFromInput",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Date | null"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_handleFocusTrap",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_isSafari",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_isMobile",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              },
+              "description": "Determines whether the current device uses a coarse pointer.\nA coarse pointer usually means touch-based input where precise pointing\nis not expected, such as fingers on phones and most tablets.\n\nNote: This is not a guarantee of a mobile device.\nSome non-mobile devices may also report a coarse pointer,\nand some mobile devices may not."
+            },
+            {
+              "kind": "method",
+              "name": "_shouldUseNativeDatepicker",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              }
+            }
+          ],
+          "events": [
+            {
+              "name": "nys-input",
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Fired on date selection. Detail: `{id, value}`."
+            },
+            {
+              "name": "nys-blur",
+              "type": {
+                "text": "Event"
+              },
+              "description": "Fired when input or calendar loses focus. Triggers validation."
+            }
+          ],
+          "attributes": [
+            {
+              "name": "id",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Unique identifier. Auto-generated if not provided.",
+              "fieldName": "id"
+            },
+            {
+              "name": "name",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Name for form submission.",
+              "fieldName": "name"
+            },
+            {
+              "name": "width",
+              "type": {
+                "text": "\"md\" | \"lg\" | \"full\""
+              },
+              "default": "\"md\"",
+              "description": "Input width: `md` (200px), `lg` (384px), `full` (100%).",
+              "fieldName": "width"
+            },
+            {
+              "name": "hideTodayButton",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Hide the \"Today\" button in calendar popup.",
+              "fieldName": "hideTodayButton"
+            },
+            {
+              "name": "hideClearButton",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Hide the \"Clear\" button in calendar popup.",
+              "fieldName": "hideClearButton"
+            },
+            {
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Disable interaction.",
+              "fieldName": "disabled"
+            },
+            {
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Mark as required. Shows \"Required\" flag and validates on blur.",
+              "fieldName": "required"
+            },
+            {
+              "name": "optional",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Show \"Optional\" flag. Use when most fields are required.",
+              "fieldName": "optional"
+            },
+            {
+              "name": "showError",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Show error state.",
+              "fieldName": "showError"
+            },
+            {
+              "name": "errorMessage",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Error message text.",
+              "fieldName": "errorMessage"
+            },
+            {
+              "name": "form",
+              "type": {
+                "text": "string | null"
+              },
+              "default": "null",
+              "description": "Form `id` to associate with when input is outside form.",
+              "fieldName": "form"
+            },
+            {
+              "name": "tooltip",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Tooltip text on info icon hover.",
+              "fieldName": "tooltip"
+            },
+            {
+              "name": "type",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"date\"",
+              "description": "Input type. Currently only supports `date`.",
+              "fieldName": "type"
+            },
+            {
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Label text. Required for accessibility.",
+              "fieldName": "label"
+            },
+            {
+              "name": "description",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Helper text below label.",
+              "fieldName": "description"
+            },
+            {
+              "name": "startDate",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Initial date when calendar opens (YYYY-MM-DD).",
+              "fieldName": "startDate"
+            },
+            {
+              "name": "inverted",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Dark background mode.",
+              "fieldName": "inverted"
+            },
+            {
+              "name": "value",
+              "type": {
+                "text": "string | Date | undefined"
+              },
+              "default": "undefined",
+              "description": "Selected date. Accepts Date object or ISO string (YYYY-MM-DD).",
+              "fieldName": "value"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "nys-datepicker",
+          "customElement": true,
+          "summary": "Date picker with calendar popup and native fallback."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "custom-element-definition",
+          "name": "nys-datepicker",
+          "declaration": {
+            "name": "NysDatepicker",
+            "module": "packages/nys-datepicker/src/nys-datepicker.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "NysDatepicker",
+          "declaration": {
+            "name": "NysDatepicker",
+            "module": "packages/nys-datepicker/src/nys-datepicker.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "wc-datepicker",
+          "declaration": {
+            "name": "WcDatepicker",
+            "package": "wc-datepicker/dist/components/wc-datepicker"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "packages/nys-divider/src/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "packages/nys-divider/src/nys-divider"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "packages/nys-divider/src/nys-divider.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "A horizontal rule for visual separation between content sections. Renders a semantic `<hr>` element.\n\nUse to separate distinct content areas within a page. Set `inverted` for use on dark backgrounds.",
+          "name": "NysDivider",
+          "members": [
+            {
+              "kind": "field",
+              "name": "inverted",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Adjusts colors for dark backgrounds.",
+              "attribute": "inverted",
+              "reflects": true
+            },
+            {
+              "kind": "method",
+              "name": "_generateUniqueId",
+              "privacy": "private",
+              "description": "Functions\n--------------------------------------------------------------------------"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "inverted",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Adjusts colors for dark backgrounds.",
+              "fieldName": "inverted"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "nys-divider",
+          "customElement": true,
+          "summary": "Horizontal divider for visual separation of content sections."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "custom-element-definition",
+          "name": "nys-divider",
+          "declaration": {
+            "name": "NysDivider",
+            "module": "packages/nys-divider/src/nys-divider.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "NysDivider",
+          "declaration": {
+            "name": "NysDivider",
+            "module": "packages/nys-divider/src/nys-divider.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "packages/nys-dropdownmenu/src/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "packages/nys-dropdownmenu/src/nys-dropdownmenu"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "packages/nys-dropdownmenu/src/nys-dropdownmenuitem"
           }
         }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "packages/nys-divider/src/index.ts",
-      "declarations": [],
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "packages/nys-dropdownmenu/src/nys-dropdownmenu.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "NysDropdownMenu",
+          "members": [
+            {
+              "kind": "field",
+              "name": "for",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "attribute": "for",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "showDropdown",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "showDropdown"
+            },
+            {
+              "kind": "field",
+              "name": "position",
+              "type": {
+                "text": "Position | null"
+              },
+              "default": "null",
+              "description": "Preferred position relative to trigger.",
+              "attribute": "position",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "_trigger",
+              "type": {
+                "text": "HTMLElement | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_menuElement",
+              "type": {
+                "text": "HTMLElement | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_ariaTarget",
+              "type": {
+                "text": "HTMLElement | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "GAP",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "readonly": true,
+              "default": "4"
+            },
+            {
+              "kind": "method",
+              "name": "_findTrigger",
+              "privacy": "private",
+              "description": "Functions\n--------------------------------------------------------------------------"
+            },
+            {
+              "kind": "method",
+              "name": "_connectTrigger",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_toggleDropdown",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_closeDropdown",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_getMenuItems",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "HTMLElement[]"
+                }
+              }
+            },
+            {
+              "kind": "field",
+              "name": "_handleDocumentClick",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_focusOnFirstItem",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "applyInverseTransform",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_positionMenu",
+              "privacy": "private",
+              "description": "The controller function for positioning the dropdown menu.\nThe logic diverts to if user sets position or we auto position the dropdown menu"
+            },
+            {
+              "kind": "method",
+              "name": "_setUserPosition",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Position"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "userPosition",
+                  "type": {
+                    "text": "Position"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_autoPosition",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Position"
+                }
+              },
+              "description": "Auto Positioning of the dropdown menu relies on the best surrounding space available\nto select the desirable position."
+            },
+            {
+              "kind": "method",
+              "name": "_checkSpaceAvailable",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "SpaceAvailable"
+                }
+              },
+              "description": "Checks if the dropdown menu fits inside the viewport on the given side of the trigger.\nOverrides user set position for auto-positioning if user's desire space is not available"
+            },
+            {
+              "kind": "method",
+              "name": "_checkPositionFits",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "position",
+                  "type": {
+                    "text": "Position"
+                  }
+                },
+                {
+                  "name": "space",
+                  "type": {
+                    "text": "SpaceAvailable"
+                  }
+                },
+                {
+                  "name": "menuRect",
+                  "type": {
+                    "text": "DOMRect"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_findBestAlternative",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Position"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "userPosition",
+                  "type": {
+                    "text": "Position"
+                  }
+                },
+                {
+                  "name": "space",
+                  "type": {
+                    "text": "SpaceAvailable"
+                  }
+                },
+                {
+                  "name": "menuRect",
+                  "type": {
+                    "text": "DOMRect"
+                  }
+                }
+              ],
+              "description": "This position is called for when user's set position didn't fit OR auto positioning when default position doesn't fit\nWe look for the best alternative positions in order of preference base on the set position (e.g. bottom-start => bottom-end)."
+            },
+            {
+              "kind": "method",
+              "name": "_findMostAvailableSpace",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Position"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "space",
+                  "type": {
+                    "text": "SpaceAvailable"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_calculateCoordinates",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              },
+              "parameters": [
+                {
+                  "name": "position",
+                  "type": {
+                    "text": "Position"
+                  }
+                }
+              ],
+              "description": "A valid ideal position has been chosen.\nThis function calculates the coordinate of the trigger to properly position the dropdown menu."
+            },
+            {
+              "kind": "method",
+              "name": "_applyPosition",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "coords",
+                  "type": {
+                    "text": "PositionCoordinates"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "field",
+              "name": "_handleTriggerKeydown",
+              "privacy": "private",
+              "description": "Event Handlers\n--------------------------------------------------------------------------"
+            },
+            {
+              "kind": "field",
+              "name": "_handleMenuKeydown",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_handleWindowResize",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_handleWindowScroll",
+              "privacy": "private"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "for",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "fieldName": "for"
+            },
+            {
+              "name": "showDropdown",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "showDropdown"
+            },
+            {
+              "name": "position",
+              "type": {
+                "text": "Position | null"
+              },
+              "default": "null",
+              "description": "Preferred position relative to trigger.",
+              "fieldName": "position"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "nys-dropdownmenu",
+          "customElement": true
+        }
+      ],
       "exports": [
+        {
+          "kind": "custom-element-definition",
+          "name": "nys-dropdownmenu",
+          "declaration": {
+            "name": "NysDropdownMenu",
+            "module": "packages/nys-dropdownmenu/src/nys-dropdownmenu.ts"
+          }
+        },
         {
           "kind": "js",
-          "name": "*",
+          "name": "NysDropdownMenu",
           "declaration": {
-            "name": "*",
-            "module": "packages/nys-divider/src/nys-divider"
+            "name": "NysDropdownMenu",
+            "module": "packages/nys-dropdownmenu/src/nys-dropdownmenu.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "packages/nys-divider/src/nys-divider.ts",
+      "path": "packages/nys-dropdownmenu/src/nys-dropdownmenuitem.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "A horizontal rule for visual separation between content sections. Renders a semantic `<hr>` element.\n\nUse to separate distinct content areas within a page. Set `inverted` for use on dark backgrounds.",
-          "name": "NysDivider",
+          "description": "**Slotted component.** Displays an individual dropdown item within `nys-dropdown` with label.\n\nThe `nys-dropdownitem` is used as customizable item within the dropdown so users don't have to raw code <ul>, <li>, <a href>\nand have the benefit of default customization.",
+          "name": "NysDropdownMenuItem",
           "members": [
             {
-              "kind": "field",
-              "name": "inverted",
+              "kind": "field",
+              "name": "shadowRootOptions",
+              "type": {
+                "text": "object"
+              },
+              "static": true,
+              "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true, }"
+            },
+            {
+              "kind": "field",
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "attribute": "label"
+            },
+            {
+              "kind": "field",
+              "name": "href",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "attribute": "href"
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "disabled",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "target",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"_self\"",
+              "attribute": "target"
+            },
+            {
+              "kind": "field",
+              "name": "prefixIcon",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "attribute": "prefixIcon"
+            },
+            {
+              "kind": "field",
+              "name": "divider",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "attribute": "divider"
+            },
+            {
+              "kind": "method",
+              "name": "_handleClick",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
+            }
+          ],
+          "events": [
+            {
+              "name": "nys-click",
+              "type": {
+                "text": "CustomEvent"
+              }
+            }
+          ],
+          "attributes": [
+            {
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "fieldName": "label"
+            },
+            {
+              "name": "href",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "fieldName": "href"
+            },
+            {
+              "name": "disabled",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Adjusts colors for dark backgrounds.",
-              "attribute": "inverted",
-              "reflects": true
+              "fieldName": "disabled"
             },
             {
-              "kind": "method",
-              "name": "_generateUniqueId",
-              "privacy": "private",
-              "description": "Functions\n--------------------------------------------------------------------------"
-            }
-          ],
-          "attributes": [
+              "name": "target",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"_self\"",
+              "fieldName": "target"
+            },
             {
-              "name": "inverted",
+              "name": "prefixIcon",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "description": "Adjusts colors for dark backgrounds.",
-              "fieldName": "inverted"
+              "default": "\"\"",
+              "fieldName": "prefixIcon"
+            },
+            {
+              "name": "divider",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "fieldName": "divider"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "nys-divider",
+          "tagName": "nys-dropdownmenuitem",
           "customElement": true,
-          "summary": "Horizontal divider for visual separation of content sections."
+          "summary": "Dropdown item to display label and provide href link."
         }
       ],
       "exports": [
         {
           "kind": "custom-element-definition",
-          "name": "nys-divider",
+          "name": "nys-dropdownmenuitem",
           "declaration": {
-            "name": "NysDivider",
-            "module": "packages/nys-divider/src/nys-divider.ts"
+            "name": "NysDropdownMenuItem",
+            "module": "packages/nys-dropdownmenu/src/nys-dropdownmenuitem.ts"
           }
         },
         {
           "kind": "js",
-          "name": "NysDivider",
+          "name": "NysDropdownMenuItem",
           "declaration": {
-            "name": "NysDivider",
-            "module": "packages/nys-divider/src/nys-divider.ts"
+            "name": "NysDropdownMenuItem",
+            "module": "packages/nys-dropdownmenu/src/nys-dropdownmenuitem.ts"
           }
         }
       ]
@@ -3813,6 +5380,15 @@
             }
           ],
           "members": [
+            {
+              "kind": "field",
+              "name": "shadowRootOptions",
+              "type": {
+                "text": "object"
+              },
+              "static": true,
+              "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true, }"
+            },
             {
               "kind": "field",
               "name": "id",
@@ -4417,6 +5993,15 @@
           "description": "**Internal component.** Displays an individual file within `nys-fileinput` with status and progress.\n\nRendered automatically by `nys-fileinput` for each selected file. Shows filename, upload status\n(pending/processing/done/error), progress bar during upload, and error messages. Remove button emits event.",
           "name": "NysFileItem",
           "members": [
+            {
+              "kind": "field",
+              "name": "shadowRootOptions",
+              "type": {
+                "text": "object"
+              },
+              "static": true,
+              "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true, }"
+            },
             {
               "kind": "field",
               "name": "filename",
@@ -5163,6 +6748,20 @@
               },
               "privacy": "private",
               "default": "\"\""
+            },
+            {
+              "kind": "method",
+              "name": "_handleLabelClick",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ],
+              "description": "Event Handlers\n--------------------------------------------------------------------------"
             }
           ],
           "attributes": [
@@ -5810,6 +7409,15 @@
             }
           ],
           "members": [
+            {
+              "kind": "field",
+              "name": "shadowRootOptions",
+              "type": {
+                "text": "object"
+              },
+              "static": true,
+              "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true, }"
+            },
             {
               "kind": "field",
               "name": "checked",
@@ -5939,6 +7547,39 @@
               "attribute": "tile",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "other",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "other",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "showOtherError",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "showOtherError"
+            },
+            {
+              "kind": "field",
+              "name": "isMobile",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_hasUserInteracted",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
             {
               "kind": "field",
               "name": "buttonGroup",
@@ -5964,12 +7605,27 @@
               "name": "formResetUpdate",
               "privacy": "public"
             },
+            {
+              "kind": "field",
+              "name": "_handleResize",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_clearOtherState",
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "_emitChangeEvent",
               "privacy": "private",
               "description": "Event Handlers\n--------------------------------------------------------------------------"
             },
+            {
+              "kind": "method",
+              "name": "_emitOtherInputEvent",
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "_handleChange",
@@ -5989,9 +7645,51 @@
               "kind": "method",
               "name": "_callInputHandling",
               "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_handleTextInput",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_handleTextInputBlur",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_validateOtherAndEmitError",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_handleOtherKeydown",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                }
+              ]
             }
           ],
           "events": [
+            {
+              "name": "nys-error-clear",
+              "type": {
+                "text": "CustomEvent"
+              }
+            },
             {
               "name": "nys-change",
               "type": {
@@ -5999,6 +7697,13 @@
               },
               "description": "Fired when selection changes. Detail: `{id, checked, name, value}`."
             },
+            {
+              "name": "nys-other-input",
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Fired when \"other\" text input value changes. Detail: `{id, name, value}`."
+            },
             {
               "name": "nys-focus",
               "type": {
@@ -6012,6 +7717,12 @@
                 "text": "Event"
               },
               "description": "Fired when radio loses focus."
+            },
+            {
+              "name": "nys-error",
+              "type": {
+                "text": "CustomEvent"
+              }
             }
           ],
           "attributes": [
@@ -6122,6 +7833,22 @@
               "default": "false",
               "description": "Renders as tile with larger clickable area.",
               "fieldName": "tile"
+            },
+            {
+              "name": "other",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "other"
+            },
+            {
+              "name": "showOtherError",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "showOtherError"
             }
           ],
           "superclass": {
@@ -6171,6 +7898,15 @@
             }
           ],
           "members": [
+            {
+              "kind": "field",
+              "name": "shadowRootOptions",
+              "type": {
+                "text": "object"
+              },
+              "static": true,
+              "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true, }"
+            },
             {
               "kind": "field",
               "name": "id",
@@ -6461,6 +8197,19 @@
                   }
                 }
               ]
+            },
+            {
+              "kind": "method",
+              "name": "_handleChildError",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
             }
           ],
           "attributes": [
@@ -6796,6 +8545,15 @@
             }
           ],
           "members": [
+            {
+              "kind": "field",
+              "name": "shadowRootOptions",
+              "type": {
+                "text": "object"
+              },
+              "static": true,
+              "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true, }"
+            },
             {
               "kind": "field",
               "name": "id",
@@ -8109,6 +9867,15 @@
             }
           ],
           "members": [
+            {
+              "kind": "field",
+              "name": "shadowRootOptions",
+              "type": {
+                "text": "object"
+              },
+              "static": true,
+              "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true, }"
+            },
             {
               "kind": "field",
               "name": "id",
@@ -8721,6 +10488,15 @@
             }
           ],
           "members": [
+            {
+              "kind": "field",
+              "name": "shadowRootOptions",
+              "type": {
+                "text": "object"
+              },
+              "static": true,
+              "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true, }"
+            },
             {
               "kind": "field",
               "name": "id",
@@ -8879,6 +10655,16 @@
               "description": "Maximum character length.",
               "attribute": "maxlength"
             },
+            {
+              "kind": "field",
+              "name": "ariaLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Accessible label. When set, assuming \"label\" isn't provided for private special cases (i.e., <checkbox other>).",
+              "attribute": "ariaLabel"
+            },
             {
               "kind": "field",
               "name": "width",
@@ -9309,6 +11095,15 @@
               "description": "Maximum character length.",
               "fieldName": "maxlength"
             },
+            {
+              "name": "ariaLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Accessible label. When set, assuming \"label\" isn't provided for private special cases (i.e., <checkbox other>).",
+              "fieldName": "ariaLabel"
+            },
             {
               "name": "width",
               "type": {
@@ -9431,6 +11226,15 @@
             }
           ],
           "members": [
+            {
+              "kind": "field",
+              "name": "shadowRootOptions",
+              "type": {
+                "text": "object"
+              },
+              "static": true,
+              "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true, }"
+            },
             {
               "kind": "field",
               "name": "id",
@@ -9589,7 +11393,12 @@
             },
             {
               "kind": "method",
-              "name": "_handleChange",
+              "name": "_handleClick",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_handleSliderClick",
               "privacy": "private",
               "parameters": [
                 {
@@ -10240,7 +12049,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "Universal NYS header with trust bar, logo, search, and language translation. Required on all NYS sites.\n\nPlace as the first element in `<body>`. Includes \"official site\" trust indicator, NY.gov logo,\nsite search (searches ny.gov), and 14-language translation dropdown. Use `hideSearch` or `hideTranslate`\nto remove features if not applicable.",
+          "description": "",
           "name": "NysUnavHeader",
           "members": [
             {
@@ -10310,16 +12119,17 @@
                 "text": "string"
               },
               "default": "\"\"",
+              "description": "The URL endpoint of the search, make sure to include the query param.",
               "attribute": "searchUrl"
             },
             {
               "kind": "field",
               "name": "languages",
               "type": {
-                "text": "[string, string][]"
+                "text": "Language[]"
               },
-              "privacy": "private",
-              "default": "[ [\"English\", \"\"], [\"Español\", \"es\"], [\"中文\", \"zh\"], [\"繁體中文\", \"zh-traditional\"], [\"Русский\", \"ru\"], [\"יידיש\", \"yi\"], [\"বাংলা\", \"bn\"], [\"한국어\", \"ko\"], [\"Kreyòl Ayisyen\", \"ht\"], [\"Italiano\", \"it\"], [\"العربية\", \"ar\"], [\"Polski\", \"pl\"], [\"Français\", \"fr\"], [\"اردو\", \"ur\"], ]",
+              "default": "[ { code: \"en\", label: \"English\" }, { code: \"es\", label: \"Español\" }, { code: \"zh\", label: \"中文\" }, { code: \"zh-traditional\", label: \"繁體中文\" }, { code: \"yi\", label: \"יידיש\" }, { code: \"ru\", label: \"Русский\" }, { code: \"bn\", label: \"বাংলা\" }, { code: \"ko\", label: \"한국어\" }, { code: \"ht\", label: \"Kreyòl Ayisyen\" }, { code: \"it\", label: \"Italiano\" }, { code: \"ar\", label: \"العربية\" }, { code: \"pl\", label: \"Polski\" }, { code: \"fr\", label: \"Français\" }, { code: \"ur\", label: \"اردو\" }, ]",
+              "description": "The list of languages this site can be translated to, default to use Smartling",
               "attribute": "languages"
             },
             {
@@ -10352,6 +12162,19 @@
               "name": "_toggleSearchDropdown",
               "privacy": "private"
             },
+            {
+              "kind": "method",
+              "name": "_handleLanguageSelect",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "language",
+                  "type": {
+                    "text": "Language"
+                  }
+                }
+              ]
+            },
             {
               "kind": "method",
               "name": "_handleSearchFocus",
@@ -10463,14 +12286,16 @@
                 "text": "string"
               },
               "default": "\"\"",
+              "description": "The URL endpoint of the search, make sure to include the query param.",
               "fieldName": "searchUrl"
             },
             {
               "name": "languages",
               "type": {
-                "text": "[string, string][]"
+                "text": "Language[]"
               },
-              "default": "[ [\"English\", \"\"], [\"Español\", \"es\"], [\"中文\", \"zh\"], [\"繁體中文\", \"zh-traditional\"], [\"Русский\", \"ru\"], [\"יידיש\", \"yi\"], [\"বাংলা\", \"bn\"], [\"한국어\", \"ko\"], [\"Kreyòl Ayisyen\", \"ht\"], [\"Italiano\", \"it\"], [\"العربية\", \"ar\"], [\"Polski\", \"pl\"], [\"Français\", \"fr\"], [\"اردو\", \"ur\"], ]",
+              "default": "[ { code: \"en\", label: \"English\" }, { code: \"es\", label: \"Español\" }, { code: \"zh\", label: \"中文\" }, { code: \"zh-traditional\", label: \"繁體中文\" }, { code: \"yi\", label: \"יידיש\" }, { code: \"ru\", label: \"Русский\" }, { code: \"bn\", label: \"বাংলা\" }, { code: \"ko\", label: \"한국어\" }, { code: \"ht\", label: \"Kreyòl Ayisyen\" }, { code: \"it\", label: \"Italiano\" }, { code: \"ar\", label: \"العربية\" }, { code: \"pl\", label: \"Polski\" }, { code: \"fr\", label: \"Français\" }, { code: \"ur\", label: \"اردو\" }, ]",
+              "description": "The list of languages this site can be translated to, default to use Smartling",
               "fieldName": "languages"
             }
           ],
@@ -10479,8 +12304,7 @@
             "package": "lit"
           },
           "tagName": "nys-unavheader",
-          "customElement": true,
-          "summary": "Universal NYS header with trust bar, search, and translation. Required site-wide."
+          "customElement": true
         }
       ],
       "exports": [