@nysds/components 1.18.1 → 1.19.0

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

@@ -697,6 +697,11 @@
           "name": "inverted",
           "description": "Adjusts colors for dark backgrounds.",
           "values": []
+        },
+        {
+          "name": "subtle",
+          "description": "If true, the divider will use a lighter color.",
+          "values": []
         }
       ],
       "references": []
@@ -917,11 +922,16 @@
     },
     {
       "name": "nys-icon",
-      "description": "SVG icon from Material Symbols library with size, rotation, and color options.\n---\n",
+      "description": "SVG icon with swappable library support, size, rotation, and color options.\n---\n\n\n### **Methods:**\n - **redraw()** - Called by the icon library registry when the current library changes.",
       "attributes": [
         {
           "name": "name",
-          "description": "Icon name from Material Symbols library. Required.",
+          "description": "Icon name to resolve from the selected library. Required.",
+          "values": []
+        },
+        {
+          "name": "library",
+          "description": "Which registered icon library to use. Defaults to the built-in NYSDS library.",
           "values": []
         },
         {
@@ -1076,7 +1086,7 @@
     },
     {
       "name": "nys-radiobutton",
-      "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.",
+      "description": "Radio button for single selection from mutually exclusive options. This is a READONLY data component.\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- **nys-other-input** - Fired when \"other\" text input value changes. Detail: `{id, name, value}`.\n\n### **Slots:**\n - **description** - Custom HTML description content.",
       "attributes": [
         {
           "name": "checked",
@@ -1140,7 +1150,7 @@
     },
     {
       "name": "nys-radiogroup",
-      "description": "Container for grouping radio buttons as a single form control.\n---\n\n\n### **Slots:**\n - _default_ - Default slot for `nys-radiobutton` elements.\n- **description** - Custom HTML description content.",
+      "description": "Container for grouping radio buttons as a single form control.\n---\n\n\n### **Events:**\n - **nys-change**\n- **nys-other-input**\n\n### **Slots:**\n - _default_ - Default slot for `nys-radiobutton` elements.\n- **description** - Custom HTML description content.",
       "attributes": [
         {
           "name": "id",
@@ -1201,7 +1211,8 @@
           "name": "size",
           "description": "Radio size for all children: `sm` (24px) or `md` (32px, default).",
           "values": [{ "name": "sm" }, { "name": "md" }]
-        }
+        },
+        { "name": "_showOtherError", "values": [] }
       ],
       "references": []
     },
@@ -1339,16 +1350,16 @@
     },
     {
       "name": "nys-step",
-      "description": "Individual step for use within nys-stepper with navigation support.\n---\n\n\n### **Events:**\n - **nys-step-click** - Fired when a navigable step is clicked. Detail: `{href, label}`. Cancelable.",
+      "description": "Individual step for use within nys-stepper with navigation support.\n---\n\n\n### **Events:**\n - **nys-step-click** - Fired when a navigable (`previous` or `current`) non-selected step is clicked or activated by keyboard. Detail: `{ href: string, label: string }`. Cancelable — call `e.preventDefault()` to suppress `window.location.href` navigation.",
       "attributes": [
         {
           "name": "selected",
-          "description": "Whether this step is currently being viewed. Set by parent stepper.",
+          "description": "Which step is currently being displayed. If not set, defaults to the `current` step.\nSetting this on a step after `current` is silently corrected to match `current`.\nWhen controlling state from a framework, always set this explicitly.",
           "values": []
         },
         {
           "name": "current",
-          "description": "Marks the furthest reached step. Steps before this are navigable.",
+          "description": "The furthest step the user has reached (progress boundary). Steps before this are navigable.",
           "values": []
         },
         {
@@ -1358,17 +1369,7 @@
         },
         {
           "name": "href",
-          "description": "URL for page navigation when step is clicked. Optional for SPA routing.",
-          "values": []
-        },
-        {
-          "name": "isCompactExpanded",
-          "description": "Internal: Whether parent stepper's compact view is expanded.",
-          "values": []
-        },
-        {
-          "name": "stepNumber",
-          "description": "Step number (1-indexed). Auto-assigned by parent stepper.",
+          "description": "URL navigated to when the step is activated, via `window.location.href`.\nNavigation is suppressed if the `nys-step-click` listener calls `e.preventDefault()`.\nOmit for SPA/framework routing and handle navigation in the event listener instead.",
           "values": []
         }
       ],
@@ -1376,9 +1377,13 @@
     },
     {
       "name": "nys-stepper",
-      "description": "Multi-step progress indicator with navigation and mobile-friendly compact view.\n---\n\n\n### **Slots:**\n - _default_ - Default slot for `nys-step` elements.\n- **actions** - Navigation buttons (e.g., Back, Continue). Must be wrapped in a `<div>`.",
+      "description": "Multi-step progress indicator with navigation and mobile-friendly compact view.\n---\n\n\n### **Slots:**\n - _default_ - Default slot for `nys-step` elements. Only `nys-step` children are accepted; others are removed.\n- **actions** - Persistent navigation buttons. Must contain exactly one `<div>` wrapping only `<nys-button>` elements.",
       "attributes": [
-        { "name": "id", "description": "Unique identifier.", "values": [] },
+        {
+          "name": "id",
+          "description": "Unique identifier. Auto-generated as `nys-stepper-{n}-{timestamp}` if not provided.",
+          "values": []
+        },
         {
           "name": "name",
           "description": "Name attribute for form association.",
@@ -1386,17 +1391,17 @@
         },
         {
           "name": "label",
-          "description": "Title displayed above the step counter.",
+          "description": "Title displayed above the step list and compact counter.",
           "values": []
         },
         {
           "name": "counterText",
-          "description": "Progress text (e.g., \"Step 2 of 5\"). Auto-updated based on selection.",
+          "description": "Progress text displayed in compact mode (e.g., \"Step 2 of 5\"). Auto-managed — do not set manually.",
           "values": []
         },
         {
           "name": "isCompactExpanded",
-          "description": "Whether compact mobile view is expanded to show all steps.",
+          "description": "Whether compact mobile view is expanded to show all steps. Toggled by clicking the counter.",
           "values": []
         }
       ],