@nysds/components 1.13.1 → 1.15.0

package/dist/.vscode/vscode.css-custom-data.json

@@ -2,6 +2,21 @@
   "$schema": "https://raw.githubusercontent.com/microsoft/vscode-css-languageservice/main/docs/customData.schema.json",
   "version": 1.1,
   "properties": [
+    {
+      "name": "--nys-accordion-background-color--header",
+      "description": "Background color of the accordion header.",
+      "values": []
+    },
+    {
+      "name": "--nys-accordion-background-color--header--hover",
+      "description": "Background hover color of the accordion header.",
+      "values": []
+    },
+    {
+      "name": "--nys-accordion-content-max-width",
+      "description": "Maximum readable width of accordion content. Defaults to a character-based width (80ch) for readability.",
+      "values": []
+    },
     {
       "name": "--nys-button-color",
       "description": "Text color of the button label.",

package/dist/.vscode/vscode.html-custom-data.json

@@ -4,7 +4,7 @@
   "tags": [
     {
       "name": "nys-accordion",
-      "description": "Container for accordion items with optional single-select and bordered styling.\n---\n\n\n### **Slots:**\n - _default_ - Default slot for `nys-accordionitem` elements.",
+      "description": "Container for accordion items with optional single-select and bordered styling.\n---\n\n\n### **Slots:**\n - _default_ - Default slot for `nys-accordionitem` elements.\n\n### **CSS Properties:**\n - **--nys-accordion-background-color--header** - Background color of the accordion header. _(default: undefined)_\n- **--nys-accordion-background-color--header--hover** - Background hover color of the accordion header. _(default: undefined)_\n- **--nys-accordion-content-max-width** - Maximum readable width of accordion content. Defaults to a character-based width (80ch) for readability. _(default: undefined)_",
       "attributes": [
         {
           "name": "id",
@@ -362,7 +362,7 @@
     },
     {
       "name": "nys-checkbox",
-      "description": "Checkbox for binary choices or multi-select options.\n---\n\n\n### **Events:**\n - **nys-change** - Fired when checked state changes. Detail: `{id, checked, name, value}`.\n- **nys-focus** - Fired when checkbox gains focus.\n- **nys-blur** - Fired when checkbox loses focus.\n\n### **Methods:**\n - **checkValidity(): _boolean_** - Functions\n--------------------------------------------------------------------------\n\n### **Slots:**\n - **description** - Custom HTML description content.",
+      "description": "Checkbox for binary choices or multi-select options.\n---\n\n\n### **Events:**\n - **nys-change** - Fired when checked state changes. Detail: `{id, checked, name, value}`.\n- **nys-other-input** - Fired when \"other\" text input value changes. Detail: `{id, name, value}`.\n- **nys-focus** - Fired when checkbox gains focus.\n- **nys-blur** - Fired when checkbox loses focus.\n- **nys-error**\n- **nys-error-clear**\n\n### **Methods:**\n - **checkValidity(): _boolean_** - Functions\n--------------------------------------------------------------------------\n\n### **Slots:**\n - **description** - Custom HTML description content.",
       "attributes": [
         {
           "name": "checked",
@@ -443,7 +443,9 @@
           "name": "size",
           "description": "Checkbox size: `sm` (24px) or `md` (32px, default).",
           "values": [{ "name": "sm" }, { "name": "md" }]
-        }
+        },
+        { "name": "other", "values": [] },
+        { "name": "showOtherError", "values": [] }
       ],
       "references": []
     },
@@ -520,30 +522,123 @@
       "references": []
     },
     {
-      "name": "nys-datepicker",
-      "description": "`<nys-datepicker>` is a form-associated, accessible date picker component.\nOptionally wraps a `<wc-datepicker>` for custom calendar UI.\n\nEvents:\n---\n\n\n### **Events:**\n - **nys-blur** - Dispatched when input or calendar loses focus\n- **nys-input** - 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)\n\n### **Methods:**\n - **checkValidity(): _boolean_** - Passive check of validity:\n- Returns true/false\n- Does NOT update UI or show errors\n- Used in form submission checks",
+      "name": "nys-combobox",
+      "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\n---\n\n\n### **Events:**\n - **nys-input** - Fired on input change. Detail: `{ id, value }`.\n- **nys-focus** - Fired when combobox receives focus.\n- **nys-blur** - Fired when combobox loses focus.\n- **nys-change** - Fired when selection changes. Detail: `{ id, value }`.\n\n### **Slots:**\n - **description** - Optional custom description content below the label.\n- **default** - Options (<option>, <optgroup>) to populate the dropdown",
       "attributes": [
         { "name": "id", "values": [] },
         { "name": "name", "values": [] },
-        {
-          "name": "width",
-          "values": [{ "name": "md" }, { "name": "lg" }, { "name": "full" }]
-        },
-        { "name": "hideTodayButton", "values": [] },
-        { "name": "hideClearButton", "values": [] },
+        { "name": "label", "values": [] },
+        { "name": "description", "values": [] },
+        { "name": "value", "values": [] },
         { "name": "disabled", "values": [] },
         { "name": "required", "values": [] },
         { "name": "optional", "values": [] },
-        { "name": "showError", "values": [] },
-        { "name": "errorMessage", "values": [] },
-        { "name": "form", "values": [] },
         { "name": "tooltip", "values": [] },
-        { "name": "type", "values": [] },
-        { "name": "label", "values": [] },
-        { "name": "description", "values": [] },
-        { "name": "startDate", "values": [] },
+        { "name": "form", "values": [] },
+        {
+          "name": "width",
+          "values": [{ "name": "md" }, { "name": "lg" }, { "name": "full" }]
+        },
         { "name": "inverted", "values": [] },
-        { "name": "value", "values": [{ "name": "Date" }] }
+        { "name": "showError", "values": [] },
+        { "name": "errorMessage", "values": [] }
+      ],
+      "references": []
+    },
+    {
+      "name": "nys-datepicker",
+      "description": "Date picker with calendar popup and native fallback.\n---\n\n\n### **Events:**\n - **nys-input** - Fired on date selection. Detail: `{id, value}`.\n- **nys-blur** - Fired when input or calendar loses focus. Triggers validation.\n\n### **Methods:**\n - **checkValidity(): _boolean_** - Passive check of validity:\n- Returns true/false\n- Does NOT update UI or show errors\n- Used in form submission checks",
+      "attributes": [
+        {
+          "name": "id",
+          "description": "Unique identifier. Auto-generated if not provided.",
+          "values": []
+        },
+        {
+          "name": "name",
+          "description": "Name for form submission.",
+          "values": []
+        },
+        {
+          "name": "width",
+          "description": "Input width: `md` (200px), `lg` (384px), `full` (100%).",
+          "values": [{ "name": "md" }, { "name": "lg" }, { "name": "full" }]
+        },
+        {
+          "name": "hideTodayButton",
+          "description": "Hide the \"Today\" button in calendar popup.",
+          "values": []
+        },
+        {
+          "name": "hideClearButton",
+          "description": "Hide the \"Clear\" button in calendar popup.",
+          "values": []
+        },
+        {
+          "name": "disabled",
+          "description": "Disable interaction.",
+          "values": []
+        },
+        {
+          "name": "required",
+          "description": "Mark as required. Shows \"Required\" flag and validates on blur.",
+          "values": []
+        },
+        {
+          "name": "optional",
+          "description": "Show \"Optional\" flag. Use when most fields are required.",
+          "values": []
+        },
+        {
+          "name": "showError",
+          "description": "Show error state.",
+          "values": []
+        },
+        {
+          "name": "errorMessage",
+          "description": "Error message text.",
+          "values": []
+        },
+        {
+          "name": "form",
+          "description": "Form `id` to associate with when input is outside form.",
+          "values": []
+        },
+        {
+          "name": "tooltip",
+          "description": "Tooltip text on info icon hover.",
+          "values": []
+        },
+        {
+          "name": "type",
+          "description": "Input type. Currently only supports `date`.",
+          "values": []
+        },
+        {
+          "name": "label",
+          "description": "Label text. Required for accessibility.",
+          "values": []
+        },
+        {
+          "name": "description",
+          "description": "Helper text below label.",
+          "values": []
+        },
+        {
+          "name": "startDate",
+          "description": "Initial date when calendar opens (YYYY-MM-DD).",
+          "values": []
+        },
+        {
+          "name": "inverted",
+          "description": "Dark background mode.",
+          "values": []
+        },
+        {
+          "name": "value",
+          "description": "Selected date. Accepts Date object or ISO string (YYYY-MM-DD).",
+          "values": [{ "name": "Date" }]
+        }
       ],
       "references": []
     },
@@ -559,6 +654,33 @@
       ],
       "references": []
     },
+    {
+      "name": "nys-dropdownmenu",
+      "description": "\n---\n",
+      "attributes": [
+        { "name": "for", "values": [] },
+        { "name": "showDropdown", "values": [] },
+        {
+          "name": "position",
+          "description": "Preferred position relative to trigger.",
+          "values": [{ "name": "Position" }]
+        }
+      ],
+      "references": []
+    },
+    {
+      "name": "nys-dropdownmenuitem",
+      "description": "Dropdown item to display label and provide href link.\n---\n\n\n### **Events:**\n - **nys-click**",
+      "attributes": [
+        { "name": "label", "values": [] },
+        { "name": "href", "values": [] },
+        { "name": "disabled", "values": [] },
+        { "name": "target", "values": [] },
+        { "name": "prefixIcon", "values": [] },
+        { "name": "divider", "values": [] }
+      ],
+      "references": []
+    },
     {
       "name": "nys-errormessage",
       "description": "Internal error message display with icon and ARIA alert support.\n---\n",
@@ -901,7 +1023,7 @@
     },
     {
       "name": "nys-radiobutton",
-      "description": "Radio button for single selection from mutually exclusive options.\n---\n\n\n### **Events:**\n - **nys-change** - Fired when selection changes. Detail: `{id, checked, name, value}`.\n- **nys-focus** - Fired when radio gains focus.\n- **nys-blur** - Fired when radio loses focus.\n\n### **Methods:**\n - **getInputElement(): _Promise<HTMLInputElement | null>_** - Functions\n--------------------------------------------------------------------------\n\n### **Slots:**\n - **description** - Custom HTML description content.",
+      "description": "Radio button for single selection from mutually exclusive options.\n---\n\n\n### **Events:**\n - **nys-error-clear**\n- **nys-change** - Fired when selection changes. Detail: `{id, checked, name, value}`.\n- **nys-other-input** - Fired when \"other\" text input value changes. Detail: `{id, name, value}`.\n- **nys-focus** - Fired when radio gains focus.\n- **nys-blur** - Fired when radio loses focus.\n- **nys-error**\n\n### **Methods:**\n - **getInputElement(): _Promise<HTMLInputElement | null>_** - Functions\n--------------------------------------------------------------------------\n\n### **Slots:**\n - **description** - Custom HTML description content.",
       "attributes": [
         {
           "name": "checked",
@@ -962,7 +1084,9 @@
           "name": "tile",
           "description": "Renders as tile with larger clickable area.",
           "values": []
-        }
+        },
+        { "name": "other", "values": [] },
+        { "name": "showOtherError", "values": [] }
       ],
       "references": []
     },
@@ -1444,6 +1568,11 @@
           "description": "Maximum character length.",
           "values": []
         },
+        {
+          "name": "ariaLabel",
+          "description": "Accessible label. When set, assuming \"label\" isn't provided for private special cases (i.e., <checkbox other>).",
+          "values": []
+        },
         {
           "name": "width",
           "description": "Input width: `sm` (88px), `md` (200px), `lg` (384px), `full` (100%, default).",
@@ -1586,7 +1715,7 @@
     },
     {
       "name": "nys-unavheader",
-      "description": "Universal NYS header with trust bar, search, and translation. Required site-wide.\n---\n",
+      "description": "\n---\n",
       "attributes": [
         {
           "name": "trustbarVisible",
@@ -1618,10 +1747,15 @@
           "description": "Hides the search functionality.",
           "values": []
         },
-        { "name": "searchUrl", "values": [] },
+        {
+          "name": "searchUrl",
+          "description": "The URL endpoint of the search, make sure to include the query param.",
+          "values": []
+        },
         {
           "name": "languages",
-          "values": [{ "name": "[string" }, { "name": "string][]" }]
+          "description": "The list of languages this site can be translated to, default to use Smartling",
+          "values": [{ "name": "Language[]" }]
         }
       ],
       "references": []