@nysds/components 1.19.3-alpha-1 → 1.19.3

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

@@ -242,7 +242,7 @@
     },
     {
       "name": "nys-breadcrumbs",
-      "description": "Breadcrumb navigation trail with responsive collapse support.\n---\n\n\n### **Events:**\n - **nys-expand**\n- **nys-breadcrumbs-expand** - Fired when the user clicks the ellipsis to expand the trail.\n\n### **Slots:**\n - _default_ - One or more `nys-breadcrumbitem` elements defining the trail.",
+      "description": "Breadcrumb navigation trail with responsive collapse support.\n---\n\n\n### **Events:**\n - **nys-expand**\n- **nys-breadcrumbs-expand** - Fired when the user clicks the ellipsis to expand the trail.\n\n### **Slots:**\n - _default_ - One or more `li` elements defining the trail.",
       "attributes": [
         {
           "name": "id",
@@ -257,7 +257,7 @@
         {
           "name": "size",
           "description": "Controls the visual size of the breadcrumb text and spacing: `sm` for dense layouts, `md` (default) for standard use.",
-          "values": [{ "name": "sm" }, { "name": "md" }, { "name": "\"\"" }]
+          "values": [{ "name": "sm" }, { "name": "md" }]
         },
         {
           "name": "backToParent",
@@ -284,7 +284,7 @@
     },
     {
       "name": "nys-button",
-      "description": "Button for actions and CTAs with variants, sizes, and icon support.\n---\n\n\n### **Events:**\n - **nys-focus** - Fired when the button receives focus.\n- **nys-blur** - Fired when the button loses focus.\n- **nys-click** - Fired when the button is clicked (mouse or keyboard). Not fired when disabled.\n\n### **Slots:**\n - **prefix-icon** - Icon before label. Not shown for `text` variant.\n- **suffix-icon** - Icon after label. Not shown for `text` variant.\n- **circle-icon** - Icon for circle mode. Overrides `icon` prop.\n\n### **CSS Properties:**\n - **--nys-button-color** - Text color of the button label. _(default: undefined)_\n- **--nys-button-color--hover** - Text color when hovered. _(default: undefined)_\n- **--nys-button-color--active** - Text color when active/pressed. _(default: undefined)_\n- **--nys-button-background-color** - Background color of the button. _(default: undefined)_\n- **--nys-button-background-color--hover** - Background color when hovered. _(default: undefined)_\n- **--nys-button-background-color--active** - Background color when active/pressed. _(default: undefined)_\n- **--nys-button-border-color** - Border color of the button. _(default: undefined)_\n- **--nys-button-border-color--hover** - Border color when hovered. _(default: undefined)_\n- **--nys-button-border-color--active** - Border color when active/pressed. _(default: undefined)_",
+      "description": "Button for actions and CTAs with variants, sizes, and icon support.\n---\n\n\n### **Events:**\n - **nys-focus** - Fired when the button receives focus.\n- **nys-blur** - Fired when the button loses focus.\n- **nys-click** - Fired when the button is clicked (mouse or keyboard). Not fired when disabled.\n\n### **Slots:**\n - _default_ - Button label text. Use as fallback when `label` prop is not provided.\n- **prefix-icon** - Icon before label. Not shown for `text` variant.\n- **suffix-icon** - Icon after label. Not shown for `text` variant.\n- **circle-icon** - Icon for circle mode. Overrides `icon` prop.\n\n### **CSS Properties:**\n - **--nys-button-color** - Text color of the button label. _(default: undefined)_\n- **--nys-button-color--hover** - Text color when hovered. _(default: undefined)_\n- **--nys-button-color--active** - Text color when active/pressed. _(default: undefined)_\n- **--nys-button-background-color** - Background color of the button. _(default: undefined)_\n- **--nys-button-background-color--hover** - Background color when hovered. _(default: undefined)_\n- **--nys-button-background-color--active** - Background color when active/pressed. _(default: undefined)_\n- **--nys-button-border-color** - Border color of the button. _(default: undefined)_\n- **--nys-button-border-color--hover** - Border color when hovered. _(default: undefined)_\n- **--nys-button-border-color--active** - Border color when active/pressed. _(default: undefined)_",
       "attributes": [
         {
           "name": "id",
@@ -708,7 +708,7 @@
     },
     {
       "name": "nys-dropdownmenu",
-      "description": "\n---\n",
+      "description": "Action menu with auto-positioning, keyboard support, and screen reader integration.\n---\n",
       "attributes": [
         { "name": "for", "values": [] },
         { "name": "showDropdown", "values": [] },
@@ -767,7 +767,7 @@
     },
     {
       "name": "nys-fileinput",
-      "description": "File input with drag-and-drop, validation, and progress tracking.\n---\n\n\n### **Events:**\n - **nys-change** - Fired when files are added or removed. Detail: `{id, files}`.\n\n### **Slots:**\n - **description** - Custom HTML description content.",
+      "description": "File input with drag-and-drop, validation, and progress tracking.\n---\n\n\n### **Events:**\n - **nys-blur** - Fired when focus leaves the component. Triggers validation.\n- **nys-change** - Fired when files are added or removed. Detail: `{id, files}`.\n\n### **Methods:**\n - **setFiles(incoming: _File[]_): _Promise<void>_** - Programmatically set the selection and await async validation/processing.\nSame as assigning `files`, but resolves once every file has finished its\nmagic-byte validation and read — use when you need to read `checkValidity()`\nor the settled selection immediately after.\n\n### **Slots:**\n - **description** - Custom HTML description content.",
       "attributes": [
         {
           "name": "id",
@@ -905,7 +905,7 @@
     },
     {
       "name": "nys-globalheader",
-      "description": "Agency header with navigation, mobile menu, and active link highlighting.\n---\n\n\n### **Slots:**\n - _default_ - Navigation content (typically `<ul>` with `<li><a>` links). Auto-sanitized.",
+      "description": "Agency header with navigation, mobile menu, and active link highlighting.\n---\n\n\n### **Slots:**\n - _default_ - Navigation content (typically `<ul>` with `<li><a>` links). Auto-sanitized.\n- **user-actions** - User-account controls (e.g. profile link, settings, log-out button) shown in the header.",
       "attributes": [
         {
           "name": "appName",
@@ -924,7 +924,7 @@
         },
         {
           "name": "nysLogo",
-          "description": "Toggles the NYS brand mark",
+          "description": "Displays the NYS brand mark in the header. Off by default.\n\nEnable only for internal, state-employee (back-office) applications that omit\n`nys-unavheader`. Any resident-facing app — even one requiring login — should\nkeep `nys-unavheader` for trust and leave this off.",
           "values": []
         }
       ],
@@ -994,7 +994,7 @@
     },
     {
       "name": "nys-label",
-      "description": "Internal label component for form fields with flag and tooltip support.\n---\n\n\n### **Events:**\n - **nys-label-click**\n\n### **Slots:**\n - **description** - Custom HTML description content below the label.",
+      "description": "**Internal component.** Renders form labels with description, required/optional flag, and tooltip.\n\nUsed internally by form components (textinput, select, checkbox, etc.). Not intended for direct use.\nHandles label association via `for`, displays asterisk for required fields, and integrates tooltips.\n---\n\n\n### **Events:**\n - **nys-label-click**\n\n### **Slots:**\n - **description** - Custom HTML description content below the label.",
       "attributes": [
         { "name": "id", "description": "The ID of the label.", "values": [] },
         {
@@ -1527,7 +1527,7 @@
         },
         {
           "name": "readonly",
-          "description": "Makes textarea read-only but focusable.",
+          "description": "Makes textarea readonly but focusable.",
           "values": []
         },
         {
@@ -1829,7 +1829,7 @@
     },
     {
       "name": "nys-unavheader",
-      "description": "\n---\n",
+      "description": "Universal NYS header with trust bar, search, and translation. Required site-wide.\n---\n\n\n### **Events:**\n - **nys-language-select** - Fired when a language is selected. Detail: `{language: {code, label, url?}}`. Cancelable; `preventDefault()` overrides the default Smartling redirect.\n- **nys-search-submit** - Fired when a search is submitted. Detail: `{query}`. Cancelable; `preventDefault()` overrides the default search redirect.",
       "attributes": [
         {
           "name": "trustbarVisible",