npm - @nysds/components - Versions diffs - 1.18.1 → 1.19.0 - Mend

@nysds/components 1.18.1 → 1.19.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (122) hide show

package/custom-elements.json +799 -372
package/dist/.vscode/vscode.html-custom-data.json +29 -24
package/dist/custom-elements.json +799 -372
package/dist/icons/ac_unit.svg +8 -0
package/dist/icons/account_balance_filled.svg +8 -0
package/dist/icons/account_circle.svg +8 -0
package/dist/icons/add.svg +8 -0
package/dist/icons/air.svg +8 -0
package/dist/icons/arrow_back.svg +8 -0
package/dist/icons/arrow_downward.svg +8 -0
package/dist/icons/arrow_forward.svg +8 -0
package/dist/icons/arrow_upward.svg +8 -0
package/dist/icons/attach_file.svg +8 -0
package/dist/icons/calendar_month.svg +8 -0
package/dist/icons/cancel.svg +8 -0
package/dist/icons/cancel_filled.svg +8 -0
package/dist/icons/check.svg +8 -0
package/dist/icons/check_circle.svg +8 -0
package/dist/icons/chevron_down.svg +8 -0
package/dist/icons/chevron_left.svg +8 -0
package/dist/icons/chevron_right.svg +8 -0
package/dist/icons/chevron_up.svg +8 -0
package/dist/icons/clear_day.svg +8 -0
package/dist/icons/close.svg +8 -0
package/dist/icons/code.svg +8 -0
package/dist/icons/content_copy.svg +8 -0
package/dist/icons/coronavirus.svg +8 -0
package/dist/icons/delete.svg +8 -0
package/dist/icons/download.svg +8 -0
package/dist/icons/download_done.svg +8 -0
package/dist/icons/drive_folder_upload.svg +8 -0
package/dist/icons/edit_square.svg +8 -0
package/dist/icons/emergency_home.svg +8 -0
package/dist/icons/error.svg +8 -0
package/dist/icons/expand_all.svg +8 -0
package/dist/icons/filter_alt.svg +8 -0
package/dist/icons/filter_list.svg +8 -0
package/dist/icons/height.svg +8 -0
package/dist/icons/help.svg +8 -0
package/dist/icons/info.svg +8 -0
package/dist/icons/language.svg +8 -0
package/dist/icons/language_filled.svg +8 -0
package/dist/icons/link.svg +8 -0
package/dist/icons/lock_filled.svg +8 -0
package/dist/icons/mail.svg +8 -0
package/dist/icons/manifest.json +84 -0
package/dist/icons/menu.svg +8 -0
package/dist/icons/more_vert.svg +8 -0
package/dist/icons/notifications.svg +8 -0
package/dist/icons/open_in_new.svg +8 -0
package/dist/icons/phone_in_talk.svg +8 -0
package/dist/icons/print.svg +8 -0
package/dist/icons/progress_activity.svg +8 -0
package/dist/icons/publish.svg +8 -0
package/dist/icons/rainy.svg +8 -0
package/dist/icons/refresh.svg +8 -0
package/dist/icons/remove.svg +8 -0
package/dist/icons/search.svg +8 -0
package/dist/icons/share.svg +8 -0
package/dist/icons/sms.svg +8 -0
package/dist/icons/social_bluesky.svg +8 -0
package/dist/icons/social_facebook.svg +8 -0
package/dist/icons/social_flickr.svg +8 -0
package/dist/icons/social_google_play.svg +8 -0
package/dist/icons/social_instagram.svg +10 -0
package/dist/icons/social_linkedin.svg +8 -0
package/dist/icons/social_pinterest.svg +8 -0
package/dist/icons/social_rss.svg +10 -0
package/dist/icons/social_snapchat.svg +8 -0
package/dist/icons/social_soundcloud.svg +21 -0
package/dist/icons/social_threads.svg +9 -0
package/dist/icons/social_tiktok.svg +8 -0
package/dist/icons/social_tumblr.svg +8 -0
package/dist/icons/social_vimeo.svg +8 -0
package/dist/icons/social_x.svg +8 -0
package/dist/icons/social_youtube.svg +8 -0
package/dist/icons/sort.svg +8 -0
package/dist/icons/straight.svg +8 -0
package/dist/icons/thumb_down.svg +8 -0
package/dist/icons/thumb_up.svg +8 -0
package/dist/icons/upload_file.svg +8 -0
package/dist/icons/visibility.svg +8 -0
package/dist/icons/visibility_off.svg +8 -0
package/dist/icons/warning.svg +8 -0
package/dist/nysds.es.js +3762 -3630
package/dist/nysds.es.js.map +1 -1
package/dist/nysds.js +342 -865
package/dist/nysds.js.map +1 -1
package/dist/packages/mcp-server/src/lib/token-parser.d.ts +19 -31
package/dist/packages/mcp-server/src/tools/token-tools.d.ts +2 -3
package/dist/packages/nys-avatar/src/nys-avatar.d.ts +2 -0
package/dist/packages/nys-backtotop/src/nys-backtotop.d.ts +3 -3
package/dist/packages/nys-button/src/nys-button.d.ts +5 -0
package/dist/packages/nys-checkbox/src/nys-checkbox.d.ts +2 -1
package/dist/packages/nys-divider/src/nys-divider.d.ts +2 -0
package/dist/packages/nys-dropdownmenu/src/nys-dropdownmenu.d.ts +1 -1
package/dist/packages/nys-globalheader/src/nys-globalheader.d.ts +3 -0
package/dist/packages/nys-icon/src/icon-cache.d.ts +11 -0
package/dist/packages/nys-icon/src/icon-library-registry.d.ts +47 -0
package/dist/packages/nys-icon/src/index.d.ts +3 -0
package/dist/packages/nys-icon/src/nys-icon.d.ts +40 -11
package/dist/packages/nys-modal/src/nys-modal.d.ts +1 -0
package/dist/packages/nys-radiobutton/src/nys-radiobutton.d.ts +1 -38
package/dist/packages/nys-radiobutton/src/nys-radiogroup.d.ts +17 -7
package/dist/packages/nys-stepper/src/nys-step.d.ts +75 -23
package/dist/packages/nys-stepper/src/nys-stepper.d.ts +81 -9
package/dist/packages/nys-tab/src/nys-tabgroup.d.ts +1 -0
package/dist/packages/nys-tooltip/src/nys-tooltip.d.ts +1 -0
package/package.json +12 -6
package/packages/react/NysDivider.d.ts +3 -0
package/packages/react/NysDivider.js +2 -1
package/packages/react/NysIcon.d.ts +11 -2
package/packages/react/NysIcon.js +26 -3
package/packages/react/NysRadiobutton.d.ts +7 -23
package/packages/react/NysRadiobutton.js +1 -3
package/packages/react/NysRadiogroup.d.ts +18 -2
package/packages/react/NysRadiogroup.js +17 -1
package/packages/react/NysStep.d.ts +10 -12
package/packages/react/NysStep.js +1 -12
package/packages/react/NysStepper.d.ts +6 -6
package/packages/react/nysds-jsx.d.ts +46 -36
package/dist/packages/mcp-server/src/lib/format.d.ts +0 -21

package/custom-elements.json CHANGED Viewed

@@ -893,6 +893,26 @@
               "name": "_handleSlotChange",
               "privacy": "private"
             },
+            {
+              "kind": "field",
+              "name": "_cleanAriaLabel",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "description": "Functions\n--------------------------------------------------------------------------",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "_colorStyle",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              }
+            },
             {
               "kind": "method",
               "name": "getContrastForeground",
@@ -1058,7 +1078,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "A floating \"Back to top\" button that appears after scrolling. Smooth-scrolls to page top when clicked.\n\nAuto-shows after scrolling 1.5 viewports on pages 4+ screens tall. Set `visible` to force display.\nRenders as circle button on mobile. Position with `position` prop (`left` or `right`).\n\n**Placement:** For best accessibility, place as the first focusable element in the page footer.\nIf no footer exists, place at the bottom of the body tag (after main content). Floating\npositioning allows it to overlay content without taking up layout space.\n\n**Focus Management:** When clicked, after scrolling to the top, focus is automatically moved\nto the `<main>` element (if present), the first heading (`<h1>` or `<h2>`), or the document element.\nThis ensures keyboard navigation continues naturally from the top of the page.",
+          "description": "A floating \"Back to top\" button that appears after scrolling. Smooth-scrolls to page top when clicked.\n\nAuto-shows after scrolling 1.5 viewports on pages 4+ screens tall. Set `visible` to force display.\nRenders as circle button on mobile. Position with `position` prop (`left` or `right`).\n\n**Placement:** For best accessibility, place as the first focusable element in the page footer.\nIf no footer exists, place at the bottom of the body tag (after main content). Floating\npositioning allows it to overlay content without taking up layout space.\n\n**Focus Management:** When clicked, after scrolling to the top, focus is moved to `<body>`.\nThis places the user before the skip-navigation link so they can re-use it to jump directly\nback to main content — and works regardless of whether the page uses `<main>` or heading landmarks.",
           "name": "NysBacktotop",
           "members": [
             {
@@ -2188,6 +2208,24 @@
               },
               "privacy": "private"
             },
+            {
+              "kind": "field",
+              "name": "_hasPrefixSlot",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_hasSuffixSlot",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
             {
               "kind": "field",
               "name": "formAssociated",
@@ -2204,6 +2242,32 @@
               "privacy": "private",
               "description": "Functions\n--------------------------------------------------------------------------"
             },
+            {
+              "kind": "method",
+              "name": "_onPrefixSlotChange",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_onSuffixSlotChange",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
+            },
             {
               "kind": "method",
               "name": "_manageFormAction",
@@ -2246,6 +2310,19 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "_handleKeyup",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                }
+              ]
+            },
             {
               "kind": "method",
               "name": "_handleAnyAttributeFunction",
@@ -2777,6 +2854,11 @@
               "default": "false",
               "attribute": "showOtherError"
             },
+            {
+              "kind": "field",
+              "name": "_mobileQuery",
+              "privacy": "private"
+            },
             {
               "kind": "field",
               "name": "isMobile",
@@ -2889,14 +2971,14 @@
             },
             {
               "kind": "field",
-              "name": "_handleResize",
-              "privacy": "private"
+              "name": "_handleMobileQuery",
+              "privacy": "private",
+              "description": "Event Handlers\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
               "name": "_emitChangeEvent",
-              "privacy": "private",
-              "description": "Event Handlers\n--------------------------------------------------------------------------"
+              "privacy": "private"
             },
             {
               "kind": "method",
@@ -5299,6 +5381,17 @@
               "attribute": "inverted",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "subtle",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "If true, the divider will use a lighter color.",
+              "attribute": "subtle",
+              "reflects": true
+            },
             {
               "kind": "method",
               "name": "_generateUniqueId",
@@ -5316,6 +5409,16 @@
               "description": "Adjusts colors for dark backgrounds.",
               "fieldName": "inverted",
               "propName": "inverted"
+            },
+            {
+              "name": "subtle",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "If true, the divider will use a lighter color.",
+              "fieldName": "subtle",
+              "propName": "subtle"
             }
           ],
           "superclass": {
@@ -5461,6 +5564,15 @@
               "readonly": true,
               "default": "4"
             },
+            {
+              "kind": "field",
+              "name": "_resizeObserver",
+              "type": {
+                "text": "ResizeObserver | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
             {
               "kind": "method",
               "name": "_findTrigger",
@@ -5689,11 +5801,6 @@
               "name": "_handleMenuKeydown",
               "privacy": "private"
             },
-            {
-              "kind": "field",
-              "name": "_handleWindowResize",
-              "privacy": "private"
-            },
             {
               "kind": "field",
               "name": "_handleWindowScroll",
@@ -7211,6 +7318,16 @@
               "kind": "method",
               "name": "_getNysLogo",
               "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_boundClickOutside",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_boundKeyDown",
+              "privacy": "private"
             }
           ],
           "attributes": [
@@ -7292,99 +7409,423 @@
     },
     {
       "kind": "javascript-module",
-      "path": "packages/nys-icon/src/index.ts",
-      "declarations": [],
+      "path": "packages/nys-icon/src/icon-cache.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "clearIconCache",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "url",
+              "optional": true,
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "Clear one or all entries from the cache."
+        },
+        {
+          "kind": "function",
+          "name": "fetchIcon",
+          "return": {
+            "type": {
+              "text": "Promise<SVGElement>"
+            }
+          },
+          "parameters": [
+            {
+              "name": "url",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "Fetch and parse an SVG from a URL. Returns a cloned SVGElement (safe for multiple consumers)."
+        }
+      ],
       "exports": [
         {
           "kind": "js",
-          "name": "*",
+          "name": "clearIconCache",
           "declaration": {
-            "name": "*",
-            "module": "packages/nys-icon/src/nys-icon"
+            "name": "clearIconCache",
+            "module": "packages/nys-icon/src/icon-cache.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "fetchIcon",
+          "declaration": {
+            "name": "fetchIcon",
+            "module": "packages/nys-icon/src/icon-cache.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "packages/nys-icon/src/nys-icon.ts",
+      "path": "packages/nys-icon/src/icon-library-registry.ts",
       "declarations": [
         {
-          "kind": "class",
-          "description": "Renders SVG icons from the NYSDS icon library (Material Symbols). Decorative by default (`aria-hidden`).\n\nPass `name` to select an icon from the library. Use `ariaLabel` to make the icon accessible\n(removes `aria-hidden`). Supports size presets, rotation, flipping, and custom colors.",
-          "name": "NysIcon",
-          "members": [
+          "kind": "function",
+          "name": "getIconLibrary",
+          "return": {
+            "type": {
+              "text": "IconLibrary | undefined"
+            }
+          },
+          "parameters": [
             {
-              "kind": "field",
               "name": "name",
               "type": {
                 "text": "string"
-              },
-              "default": "\"\"",
-              "description": "Icon name from Material Symbols library. Required.",
-              "attribute": "name",
-              "reflects": true
-            },
+              }
+            }
+          ],
+          "description": "Get a registered icon library by name."
+        },
+        {
+          "kind": "function",
+          "name": "registerIconLibrary",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
             {
-              "kind": "field",
-              "name": "ariaLabel",
+              "name": "name",
               "type": {
                 "text": "string"
-              },
-              "default": "\"\"",
-              "description": "Accessible label. When set, removes `aria-hidden` and adds `aria-label` to the SVG.",
-              "attribute": "ariaLabel"
+              }
             },
             {
-              "kind": "field",
-              "name": "rotate",
+              "name": "library",
               "type": {
-                "text": "string"
-              },
-              "default": "\"0\"",
-              "description": "Rotation in degrees. Applied via CSS `rotate`.",
-              "attribute": "rotate"
-            },
+                "text": "IconLibrary"
+              }
+            }
+          ],
+          "description": "Register or replace a named icon library. All watching icons using this library will redraw.",
+          "examples": [
             {
-              "kind": "field",
-              "name": "flip",
+              "title": "Register a Font Awesome library with a custom resolver:",
+              "code": "registerIconLibrary(\"fa\", {\nresolver: (name) => `https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/svg/${name}.svg`\n});",
+              "lang": "ts"
+            }
+          ]
+        },
+        {
+          "kind": "function",
+          "name": "unregisterIconLibrary",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "name",
               "type": {
                 "text": "string"
-              },
-              "default": "\"\"",
-              "description": "Flip direction: `horizontal`, `vertical`, or empty for none.",
-              "attribute": "flip"
-            },
+              }
+            }
+          ],
+          "description": "Remove a registered icon library. All watching icons using this library will redraw."
+        },
+        {
+          "kind": "function",
+          "name": "unwatchIconLibrary",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
             {
-              "kind": "field",
-              "name": "color",
+              "name": "name",
               "type": {
                 "text": "string"
-              },
-              "default": "\"\"",
-              "description": "Icon color. Accepts any CSS color value. Defaults to `currentcolor`.",
-              "attribute": "color"
+              }
             },
             {
-              "kind": "field",
-              "name": "size",
+              "name": "watcher",
               "type": {
-                "text": "| \"xs\"\n    | \"sm\"\n    | \"md\"\n    | \"lg\"\n    | \"xl\"\n    | \"2xl\"\n    | \"3xl\"\n    | \"4xl\"\n    | \"5xl\"\n    | \"12\"\n    | \"14\"\n    | \"16\"\n    | \"18\"\n    | \"20\"\n    | \"24\"\n    | \"32\"\n    | \"40\"\n    | \"50\""
-              },
-              "default": "\"md\"",
-              "description": "Icon size. Semantic sizes: `xs`-`5xl`. Pixel sizes: `12`-`50`.",
-              "attribute": "size"
-            },
-            {
-              "kind": "method",
-              "name": "getIcon",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": ""
-                }
-              },
-              "description": "Retrieves the SVG element for the given icon name and applies\naccessibility, rotation, flip, color, and size classes."
+                "text": "NysIconWatcher"
+              }
+            }
+          ],
+          "description": "Unsubscribe an icon instance from library change notifications."
+        },
+        {
+          "kind": "function",
+          "name": "watchIconLibrary",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "name",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "watcher",
+              "type": {
+                "text": "NysIconWatcher"
+              }
+            }
+          ],
+          "description": "Subscribe an icon instance to library change notifications."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "getIconLibrary",
+          "declaration": {
+            "name": "getIconLibrary",
+            "module": "packages/nys-icon/src/icon-library-registry.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "registerIconLibrary",
+          "declaration": {
+            "name": "registerIconLibrary",
+            "module": "packages/nys-icon/src/icon-library-registry.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "unregisterIconLibrary",
+          "declaration": {
+            "name": "unregisterIconLibrary",
+            "module": "packages/nys-icon/src/icon-library-registry.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "unwatchIconLibrary",
+          "declaration": {
+            "name": "unwatchIconLibrary",
+            "module": "packages/nys-icon/src/icon-library-registry.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "watchIconLibrary",
+          "declaration": {
+            "name": "watchIconLibrary",
+            "module": "packages/nys-icon/src/icon-library-registry.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "packages/nys-icon/src/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "packages/nys-icon/src/nys-icon"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "clearIconCache",
+          "declaration": {
+            "name": "clearIconCache",
+            "module": "./icon-cache"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "IconLibrary",
+          "declaration": {
+            "name": "IconLibrary",
+            "module": "./icon-library-registry"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "registerIconLibrary",
+          "declaration": {
+            "name": "registerIconLibrary",
+            "module": "./icon-library-registry"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "unregisterIconLibrary",
+          "declaration": {
+            "name": "unregisterIconLibrary",
+            "module": "./icon-library-registry"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "packages/nys-icon/src/nys-icon.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Renders SVG icons from a registered icon library. The built-in NYSDS icon\nlibrary (Material Symbols) is the default. Custom libraries (Font Awesome,\nMaterial Icons, etc.) can be registered via `registerIconLibrary()`.\n\nPass `name` to select an icon. Use `library` to choose a registered library\n(defaults to `\"default\"` for NYSDS icons). Use `ariaLabel` to make the icon\naccessible (removes `aria-hidden`). Supports size presets, rotation,\nflipping, and custom colors.",
+          "name": "NysIcon",
+          "members": [
+            {
+              "kind": "field",
+              "name": "name",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Icon name to resolve from the selected library. Required.",
+              "attribute": "name",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "library",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"default\"",
+              "description": "Which registered icon library to use. Defaults to the built-in NYSDS library.",
+              "attribute": "library",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "ariaLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Accessible label. When set, removes `aria-hidden` and adds `aria-label` to the SVG.",
+              "attribute": "ariaLabel"
+            },
+            {
+              "kind": "field",
+              "name": "rotate",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"0\"",
+              "description": "Rotation in degrees. Applied via CSS `rotate`.",
+              "attribute": "rotate"
+            },
+            {
+              "kind": "field",
+              "name": "flip",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Flip direction: `horizontal`, `vertical`, or empty for none.",
+              "attribute": "flip"
+            },
+            {
+              "kind": "field",
+              "name": "color",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Icon color. Accepts any CSS color value. Defaults to `currentcolor`.",
+              "attribute": "color"
+            },
+            {
+              "kind": "field",
+              "name": "size",
+              "type": {
+                "text": "| \"xs\"\n    | \"sm\"\n    | \"md\"\n    | \"lg\"\n    | \"xl\"\n    | \"2xl\"\n    | \"3xl\"\n    | \"4xl\"\n    | \"5xl\"\n    | \"12\"\n    | \"14\"\n    | \"16\"\n    | \"18\"\n    | \"20\"\n    | \"24\"\n    | \"32\"\n    | \"40\"\n    | \"50\""
+              },
+              "default": "\"md\"",
+              "description": "Icon size. Semantic sizes: `xs`-`5xl`. Pixel sizes: `12`-`50`.",
+              "attribute": "size"
+            },
+            {
+              "kind": "field",
+              "name": "_svg",
+              "type": {
+                "text": "SVGElement | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
+            {
+              "kind": "field",
+              "name": "_loadSeq",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0",
+              "description": "Monotonically increasing token so stale async fetches are discarded."
+            },
+            {
+              "kind": "field",
+              "name": "_loadPromise",
+              "type": {
+                "text": "Promise<void> | null"
+              },
+              "privacy": "private",
+              "default": "null",
+              "description": "Promise for the in-flight icon load."
+            },
+            {
+              "kind": "field",
+              "name": "updateComplete",
+              "type": {
+                "text": "Promise<boolean>"
+              },
+              "description": "Resolves when the current icon load (if any) is complete.",
+              "readonly": true
+            },
+            {
+              "kind": "method",
+              "name": "redraw",
+              "description": "Called by the icon library registry when the current library changes."
+            },
+            {
+              "kind": "field",
+              "name": "_validName",
+              "privacy": "private",
+              "static": true,
+              "default": "/^[a-zA-Z0-9_-]+$/"
+            },
+            {
+              "kind": "method",
+              "name": "_loadIcon",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_applyAttributes",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "svg",
+                  "type": {
+                    "text": "SVGElement"
+                  }
+                }
+              ]
             }
           ],
           "attributes": [
@@ -7394,10 +7835,20 @@
                 "text": "string"
               },
               "default": "\"\"",
-              "description": "Icon name from Material Symbols library. Required.",
+              "description": "Icon name to resolve from the selected library. Required.",
               "fieldName": "name",
               "propName": "name"
             },
+            {
+              "name": "library",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"default\"",
+              "description": "Which registered icon library to use. Defaults to the built-in NYSDS library.",
+              "fieldName": "library",
+              "propName": "library"
+            },
             {
               "name": "ariaLabel",
               "type": {
@@ -7455,13 +7906,18 @@
           },
           "tagName": "nys-icon",
           "customElement": true,
-          "summary": "SVG icon from Material Symbols library with size, rotation, and color options.",
+          "summary": "SVG icon with swappable library support, size, rotation, and color options.",
           "examples": [
             {
-              "title": "Basic icon",
+              "title": "Basic icon (default NYSDS library)",
               "code": "<nys-icon name=\"check_circle\" size=\"lg\"></nys-icon>",
               "lang": "html"
             },
+            {
+              "title": "Font Awesome icon",
+              "code": "<nys-icon name=\"house\" library=\"fa\" size=\"lg\"></nys-icon>",
+              "lang": "html"
+            },
             {
               "title": "Accessible icon with label",
               "code": "<nys-icon name=\"warning\" ariaLabel=\"Warning\" color=\"var(--nys-color-warning)\"></nys-icon>",
@@ -7811,6 +8267,11 @@
               "privacy": "private",
               "default": "null"
             },
+            {
+              "kind": "field",
+              "name": "_mobileMedia",
+              "privacy": "private"
+            },
             {
               "kind": "field",
               "name": "hasBodySlots",
@@ -7856,7 +8317,7 @@
               "privacy": "private"
             },
             {
-              "kind": "method",
+              "kind": "field",
               "name": "_handleBodySlotChange",
               "privacy": "private"
             },
@@ -8276,15 +8737,6 @@
             }
           ],
           "members": [
-            {
-              "kind": "field",
-              "name": "shadowRootOptions",
-              "type": {
-                "text": "object"
-              },
-              "static": true,
-              "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true, }"
-            },
             {
               "kind": "field",
               "name": "checked",
@@ -8354,236 +8806,91 @@
               "name": "name",
               "type": {
                 "text": "string"
-              },
-              "default": "\"\"",
-              "description": "Group name. Radios with same name are mutually exclusive.",
-              "attribute": "name",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "value",
-              "type": {
-                "text": "string"
-              },
-              "default": "\"\"",
-              "description": "Value submitted when this radio is selected.",
-              "attribute": "value"
-            },
-            {
-              "kind": "field",
-              "name": "form",
-              "type": {
-                "text": "string | null"
-              },
-              "default": "null",
-              "description": "Form `id` to associate with.",
-              "attribute": "form",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "size",
-              "type": {
-                "text": "\"sm\" | \"md\""
-              },
-              "default": "\"md\"",
-              "description": "Radio size: `sm` (24px) or `md` (32px, default).",
-              "attribute": "size",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "tile",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Renders as tile with larger clickable area.",
-              "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",
-              "type": {
-                "text": "Record<string, NysRadiobutton>"
-              },
-              "static": true,
-              "default": "{}"
-            },
-            {
-              "kind": "method",
-              "name": "getInputElement",
-              "privacy": "public",
-              "return": {
-                "type": {
-                  "text": "Promise<HTMLInputElement | null>"
-                }
-              },
-              "description": "Functions\n--------------------------------------------------------------------------"
-            },
-            {
-              "kind": "method",
-              "name": "formResetUpdate",
-              "privacy": "public"
-            },
-            {
-              "kind": "field",
-              "name": "_handleResize",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "_clearOtherState",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "_dispatchClearErrorEvent",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "_emitChangeEvent",
-              "privacy": "private",
-              "description": "Event Handlers\n--------------------------------------------------------------------------"
-            },
-            {
-              "kind": "method",
-              "name": "_emitOtherInputEvent",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "_handleChange",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "_handleFocus",
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "_handleBlur",
-              "privacy": "private"
-            },
-            {
-              "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": [
+              },
+              "default": "\"\"",
+              "description": "Group name. Radios with same name are mutually exclusive.",
+              "attribute": "name",
+              "reflects": true
+            },
             {
-              "name": "nys-error-clear",
+              "kind": "field",
+              "name": "value",
               "type": {
-                "text": "CustomEvent"
-              }
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Value submitted when this radio is selected.",
+              "attribute": "value"
             },
             {
-              "name": "nys-change",
+              "kind": "field",
+              "name": "form",
               "type": {
-                "text": "CustomEvent"
+                "text": "string | null"
               },
-              "description": "Fired when selection changes. Detail: `{id, checked, name, value}`."
+              "default": "null",
+              "description": "Form `id` to associate with.",
+              "attribute": "form",
+              "reflects": true
             },
             {
-              "name": "nys-other-input",
+              "kind": "field",
+              "name": "size",
               "type": {
-                "text": "CustomEvent"
+                "text": "\"sm\" | \"md\""
               },
-              "description": "Fired when \"other\" text input value changes. Detail: `{id, name, value}`."
+              "default": "\"md\"",
+              "description": "Radio size: `sm` (24px) or `md` (32px, default).",
+              "attribute": "size",
+              "reflects": true
             },
             {
-              "name": "nys-focus",
+              "kind": "field",
+              "name": "tile",
               "type": {
-                "text": "Event"
+                "text": "boolean"
               },
-              "description": "Fired when radio gains focus."
+              "default": "false",
+              "description": "Renders as tile with larger clickable area.",
+              "attribute": "tile",
+              "reflects": true
             },
             {
-              "name": "nys-blur",
+              "kind": "field",
+              "name": "other",
               "type": {
-                "text": "Event"
+                "text": "boolean"
               },
-              "description": "Fired when radio loses focus."
+              "default": "false",
+              "attribute": "other",
+              "reflects": true
             },
             {
-              "name": "nys-error",
+              "kind": "field",
+              "name": "showOtherError",
               "type": {
-                "text": "CustomEvent"
-              }
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "showOtherError"
+            }
+          ],
+          "events": [
+            {
+              "description": "Fired when selection changes. Detail: `{id, checked, name, value}`.",
+              "name": "nys-change"
+            },
+            {
+              "description": "Fired when radio gains focus.",
+              "name": "nys-focus"
+            },
+            {
+              "description": "Fired when radio loses focus.",
+              "name": "nys-blur"
+            },
+            {
+              "description": "Fired when \"other\" text input value changes. Detail: `{id, name, value}`.",
+              "name": "nys-other-input"
             }
           ],
           "attributes": [
@@ -8722,7 +9029,7 @@
           },
           "tagName": "nys-radiobutton",
           "customElement": true,
-          "summary": "Radio button for single selection from mutually exclusive options.",
+          "summary": "Radio button for single selection from mutually exclusive options. This is a READONLY data component.",
           "examples": [
             {
               "title": "Radio group",
@@ -8907,6 +9214,15 @@
               "attribute": "size",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "_showOtherError",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "_showOtherError"
+            },
             {
               "kind": "field",
               "name": "selectedValue",
@@ -8925,6 +9241,49 @@
               "privacy": "private",
               "default": "\"\""
             },
+            {
+              "kind": "field",
+              "name": "_radios",
+              "type": {
+                "text": "NysRadiobutton[]"
+              },
+              "privacy": "private",
+              "default": "[]"
+            },
+            {
+              "kind": "field",
+              "name": "_mobileQuery",
+              "type": {
+                "text": "MediaQueryList"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "isMobile",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_hasUserInteracted",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_childObserver",
+              "type": {
+                "text": "MutationObserver | undefined"
+              },
+              "privacy": "private"
+            },
             {
               "kind": "field",
               "name": "_internals",
@@ -8997,30 +9356,38 @@
               "privacy": "public"
             },
             {
-              "kind": "method",
-              "name": "_initializeChildAttributes",
+              "kind": "field",
+              "name": "_handleMobileQuery",
               "privacy": "private",
               "description": "Functions\n--------------------------------------------------------------------------"
             },
             {
               "kind": "method",
-              "name": "_updateRadioButtonsSize",
+              "name": "_handleSlotChange",
               "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "_updateRadioButtonsTile",
+              "name": "_initializeChildAttributes",
               "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "_updateRadioButtonsShowError",
+              "name": "_updateRadioButtonsSize",
               "privacy": "private"
             },
             {
               "kind": "method",
-              "name": "_updateRadioButtonsForm",
-              "privacy": "private"
+              "name": "_selectRadio",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "radiobtn",
+                  "type": {
+                    "text": "NysRadiobutton"
+                  }
+                }
+              ]
             },
             {
               "kind": "method",
@@ -9029,7 +9396,7 @@
             },
             {
               "kind": "method",
-              "name": "_handleRadioButtonChange",
+              "name": "_handleInvalid",
               "privacy": "private",
               "parameters": [
                 {
@@ -9043,9 +9410,15 @@
             },
             {
               "kind": "method",
-              "name": "_handleInvalid",
+              "name": "_handleTextInput",
               "privacy": "private",
               "parameters": [
+                {
+                  "name": "radiobtn",
+                  "type": {
+                    "text": "NysRadiobutton"
+                  }
+                },
                 {
                   "name": "event",
                   "type": {
@@ -9056,36 +9429,102 @@
             },
             {
               "kind": "method",
-              "name": "_handleChildError",
+              "name": "_handleTextInputBlur",
               "privacy": "private",
               "parameters": [
                 {
-                  "name": "event",
+                  "name": "radiobtn",
                   "type": {
-                    "text": "Event"
+                    "text": "NysRadiobutton"
                   }
                 }
               ]
             },
             {
               "kind": "method",
-              "name": "_handleChildErrorClear",
-              "privacy": "private"
+              "name": "_validateOtherAndEmitError",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "radiobtn",
+                  "type": {
+                    "text": "NysRadiobutton"
+                  }
+                }
+              ]
             },
             {
               "kind": "method",
-              "name": "_handleOtherInput",
+              "name": "_handleOtherKeydown",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_handleGroupFocusout",
               "privacy": "private",
               "parameters": [
                 {
                   "name": "event",
                   "type": {
-                    "text": "Event"
+                    "text": "FocusEvent"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "field",
+              "name": "_handleRadiobtnClick",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_handleRadiobtnFocus",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "radiobtn",
+                  "type": {
+                    "text": "NysRadiobutton"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_handleRadiobtnBlur",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "radiobtn",
+                  "type": {
+                    "text": "NysRadiobutton"
                   }
                 }
               ]
             }
           ],
+          "events": [
+            {
+              "name": "nys-change",
+              "type": {
+                "text": "CustomEvent"
+              }
+            },
+            {
+              "name": "nys-other-input",
+              "type": {
+                "text": "CustomEvent"
+              }
+            }
+          ],
           "attributes": [
             {
               "name": "id",
@@ -9206,6 +9645,15 @@
               "description": "Radio size for all children: `sm` (24px) or `md` (32px, default).",
               "fieldName": "size",
               "propName": "size"
+            },
+            {
+              "name": "_showOtherError",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "_showOtherError",
+              "propName": "_showothererror"
             }
           ],
           "superclass": {
@@ -10081,7 +10529,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "A single step within `nys-stepper`. Represents one stage in a multi-step process.\n\nMark as `current` to indicate active progress point. Previous steps become clickable for navigation.\nSet `href` for page-based navigation or listen to `nys-step-click` for SPA routing.\n\n## Step States\n\nUnderstanding the three step states is critical for proper stepper usage:\n\n- **`selected`** - Which step is currently being displayed/viewed. This controls which step's\n  content is shown. Defaults to `current` if not set. Cannot be set on a step after `current`.\n  Users can click previous steps to change `selected` without changing `current`.\n\n- **`current`** - The furthest step the user has reached. This is the progress boundary.\n  Update this as the user completes steps and advances. Steps after `current` are not navigable.\n  Only one step should have `current` at a time.\n\n- **`previous`** - Auto-applied by the stepper to all steps before `current`. Do not set manually.\n  Steps with `previous` are clickable and allow the user to navigate back.\n\n## Common Patterns\n\n**Initial state:** Set `current` on the first step. `selected` will default to it.\n```html\n<nys-step label=\"Step 1\" current></nys-step>\n<nys-step label=\"Step 2\"></nys-step>\n```\n\n**User completed step 1, now on step 2:**\n```html\n<nys-step label=\"Step 1\"></nys-step>\n<nys-step label=\"Step 2\" current></nys-step>\n```\n\n**User went back to review step 1 (but progress is still at step 2):**\n```html\n<nys-step label=\"Step 1\" selected></nys-step>\n<nys-step label=\"Step 2\" current></nys-step>\n```",
+          "description": "A single step within `nys-stepper`. Represents one stage in a multi-step process.\n\nMark as `current` to indicate the active progress point. Previous steps become clickable for navigation.\nSet `href` for page-based navigation, or omit it and listen to `nys-step-click` for SPA/framework routing.\n\n## Step states\n\nThree boolean attributes control step appearance and behavior:\n\n- **`current`** — The furthest step the user has reached (the progress boundary). Only one step should\n  have `current` at a time; if multiple are set the parent stepper keeps the first and removes the rest.\n  Steps after `current` are not navigable and do not fire `nys-step-click`. Update `current` in your\n  application state when the user advances.\n\n- **`selected`** — Which step's content is currently displayed. Defaults to the `current` step if not\n  explicitly set. If `selected` is placed on a step after `current`, the stepper silently corrects it\n  to match `current`. When managing state from a framework, always set `selected` explicitly — without\n  it the stepper's fallback will reset in-sidebar navigation on every state update.\n\n- **`previous`** — Auto-applied by the parent stepper to every step before `current`. Do not set this\n  manually. Steps with `previous` are clickable and fire `nys-step-click`.\n\n## `nys-step-click` firing conditions\n\nThe event fires only when ALL of the following are true:\n1. The step has `previous` or `current` (i.e. it is navigable).\n2. The step does NOT already have `selected` (clicking the already-viewed step is a no-op).\n\nSteps that are neither `previous` nor `current` (future steps) never fire the event.\n\n## `href` and navigation\n\nIf `href` is set, the stepper calls `window.location.href = href` after dispatching `nys-step-click`\n— but only if the event was **not canceled**. To handle navigation yourself (SPA routing, fetch, etc.),\nalways call `e.preventDefault()` in your listener. Omitting `href` entirely is simpler for SPAs.\n\n## `onClick` vs `nys-step-click`\n\nThe `onClick` property (a function reference, not a DOM attribute) is called **before** the\n`nys-step-click` event is dispatched. Use it for imperative pre-navigation logic. In React, pass it\nas the `onClick` prop on `NysStep`.\n\n## Accessibility\n- The step label renders with `role=\"button\"` and is keyboard-focusable (`tabindex=\"0\"`) for navigable\n  steps (`current`, `previous`). Future steps get `tabindex=\"-1\"` and are not reachable by keyboard.\n- Enter and Space activate the step (same as click).\n- `aria-label` is set to `\"{label} Step\"` for screen reader announcement.\n\n## Common patterns\n\n**Initial state:** Set `current` on the first step. `selected` defaults to it.\n```html\n<nys-step label=\"Step 1\" current></nys-step>\n<nys-step label=\"Step 2\"></nys-step>\n```\n\n**User completed step 1, now on step 2:**\n```html\n<nys-step label=\"Step 1\"></nys-step>\n<nys-step label=\"Step 2\" current></nys-step>\n```\n\n**User went back to review step 1 (progress still at step 2):**\n```html\n<nys-step label=\"Step 1\" selected></nys-step>\n<nys-step label=\"Step 2\" current></nys-step>\n```",
           "name": "NysStep",
           "members": [
             {
@@ -10091,7 +10539,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "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.",
               "attribute": "selected",
               "reflects": true
             },
@@ -10102,7 +10550,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "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.",
               "attribute": "current",
               "reflects": true
             },
@@ -10123,36 +10571,16 @@
                 "text": "string"
               },
               "default": "\"\"",
-              "description": "URL for page navigation when step is clicked. Optional for SPA routing.",
+              "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.",
               "attribute": "href"
             },
-            {
-              "kind": "field",
-              "name": "isCompactExpanded",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Internal: Whether parent stepper's compact view is expanded.",
-              "attribute": "isCompactExpanded"
-            },
             {
               "kind": "field",
               "name": "onClick",
               "type": {
                 "text": "(e: Event) => void | undefined"
               },
-              "description": "Custom click handler. Called before `nys-step-click` event."
-            },
-            {
-              "kind": "field",
-              "name": "stepNumber",
-              "type": {
-                "text": "number"
-              },
-              "default": "0",
-              "description": "Step number (1-indexed). Auto-assigned by parent stepper.",
-              "attribute": "stepNumber"
+              "description": "Optional function called before `nys-step-click` is dispatched. Use for pre-navigation logic."
             },
             {
               "kind": "method",
@@ -10183,7 +10611,7 @@
           ],
           "events": [
             {
-              "description": "Fired when a navigable step is clicked. Detail: `{href, label}`. Cancelable.",
+              "description": "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.",
               "name": "nys-step-click"
             }
           ],
@@ -10194,7 +10622,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "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.",
               "fieldName": "selected",
               "propName": "selected"
             },
@@ -10204,7 +10632,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "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.",
               "fieldName": "current",
               "propName": "current"
             },
@@ -10224,29 +10652,9 @@
                 "text": "string"
               },
               "default": "\"\"",
-              "description": "URL for page navigation when step is clicked. Optional for SPA routing.",
+              "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.",
               "fieldName": "href",
               "propName": "href"
-            },
-            {
-              "name": "isCompactExpanded",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Internal: Whether parent stepper's compact view is expanded.",
-              "fieldName": "isCompactExpanded",
-              "propName": "iscompactexpanded"
-            },
-            {
-              "name": "stepNumber",
-              "type": {
-                "text": "number"
-              },
-              "default": "0",
-              "description": "Step number (1-indexed). Auto-assigned by parent stepper.",
-              "fieldName": "stepNumber",
-              "propName": "stepnumber"
             }
           ],
           "superclass": {
@@ -10258,9 +10666,14 @@
           "summary": "Individual step for use within nys-stepper with navigation support.",
           "examples": [
             {
-              "title": "Step with navigation",
+              "title": "Step with page navigation",
               "code": "<nys-step label=\"Personal Info\" href=\"/step-1\"></nys-step>",
               "lang": "html"
+            },
+            {
+              "title": "Step with SPA navigation (no href)",
+              "code": "step.addEventListener('nys-step-click', (e) => {\ne.preventDefault(); // no href set, but good practice\nshowStepContent(e.detail.label);\n});",
+              "lang": "js"
             }
           ]
         }
@@ -10290,15 +10703,15 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "A multi-step progress indicator for forms or wizards. Manages `nys-step` children with selection and navigation.\n\nAdd `nys-step` elements as children. Mark one step as `current` to indicate progress; previous steps become\nnavigable. Compact view on mobile expands to show all steps. Use `actions` slot for navigation buttons.\nDo not place the stepper inside a form element.",
+          "description": "A multi-step progress indicator for forms or wizards. Manages `nys-step` children with selection and navigation.\n\nAdd `nys-step` elements as children. Mark one step as `current` to indicate the progress boundary; all steps\nbefore it become navigable. Compact view on mobile expands to show all steps. Use the `actions` slot for\npersistent navigation buttons (e.g., Save & Exit). Do not place the stepper inside a `<form>` element —\nput form fields in the main content area alongside it.\n\n## When to use\n- Linear, ordered forms or wizards with more than 2 sections.\n\n## When not to use\n- Forms with only 1 or 2 sections — use a simpler layout.\n- Non-linear forms where sections can be completed in any order.\n\n## Compact mode (mobile)\nOn small screens the stepper collapses to a compact view: step labels are hidden and progress\nis shown as a bar indicator with a \"Step x of y\" counter. Clicking or pressing Enter/Space on\nthe counter expands the full step list (counter text changes to \"Back to Form\"). Collapsing\nagain returns the user to the form view.\n\n## actions slot constraints\nThe `actions` slot must contain exactly one `<div>` as its direct child. That `<div>` may only\ncontain `<nys-button>` elements — any other element is removed with a console warning.\nThe stepper automatically forces `size=\"sm\"` on every button in the slot. Buttons with the\n`fullWidth` attribute get `flex: 1 1 0` injected so they share available width equally.\n\n## Multiple `current` conflict\nIf more than one `nys-step` has the `current` attribute, only the first one is kept; the rest\nare silently removed. Always mark exactly one step as `current`.\n\n## id auto-generation\nIf no `id` is provided, a unique id is generated automatically in the form\n`nys-stepper-{n}-{timestamp}`.\n\n## Accessibility\n- The compact counter is rendered as a `role=\"button\"` with `aria-expanded` and a descriptive\n  `aria-label` that announces the current step (e.g., \"Expand step navigation. You are on Step 2 of 4\").\n- Keyboard: Enter or Space toggles the compact view.\n- Each `nys-step` label is keyboard-focusable and activatable for navigable steps.\n- Visual focus indicators are provided on all interactive elements.",
           "name": "NysStepper",
           "slots": [
             {
-              "description": "Default slot for `nys-step` elements.",
+              "description": "Default slot for `nys-step` elements. Only `nys-step` children are accepted; others are removed.",
               "name": ""
             },
             {
-              "description": "Navigation buttons (e.g., Back, Continue). Must be wrapped in a `<div>`.",
+              "description": "Persistent navigation buttons. Must contain exactly one `<div>` wrapping only `<nys-button>` elements.",
               "name": "actions"
             }
           ],
@@ -10310,7 +10723,7 @@
                 "text": "string"
               },
               "default": "\"\"",
-              "description": "Unique identifier.",
+              "description": "Unique identifier. Auto-generated as `nys-stepper-{n}-{timestamp}` if not provided.",
               "attribute": "id",
               "reflects": true
             },
@@ -10332,7 +10745,7 @@
                 "text": "string"
               },
               "default": "\"\"",
-              "description": "Title displayed above the step counter.",
+              "description": "Title displayed above the step list and compact counter.",
               "attribute": "label"
             },
             {
@@ -10342,7 +10755,7 @@
                 "text": "string"
               },
               "default": "\"initial\"",
-              "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.",
               "attribute": "counterText"
             },
             {
@@ -10352,7 +10765,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "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.",
               "attribute": "isCompactExpanded",
               "reflects": true
             },
@@ -10419,7 +10832,7 @@
                 "text": "string"
               },
               "default": "\"\"",
-              "description": "Unique identifier.",
+              "description": "Unique identifier. Auto-generated as `nys-stepper-{n}-{timestamp}` if not provided.",
               "fieldName": "id",
               "propName": "id"
             },
@@ -10439,7 +10852,7 @@
                 "text": "string"
               },
               "default": "\"\"",
-              "description": "Title displayed above the step counter.",
+              "description": "Title displayed above the step list and compact counter.",
               "fieldName": "label",
               "propName": "label"
             },
@@ -10449,7 +10862,7 @@
                 "text": "string"
               },
               "default": "\"initial\"",
-              "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.",
               "fieldName": "counterText",
               "propName": "countertext"
             },
@@ -10459,7 +10872,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "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.",
               "fieldName": "isCompactExpanded",
               "propName": "iscompactexpanded"
             }
@@ -10486,6 +10899,11 @@
               "title": "Navigation buttons in actions slot",
               "code": "<nys-stepper label=\"Application\">\n<nys-step label=\"Step 1\"></nys-step>\n<nys-step label=\"Step 2\" current></nys-step>\n<nys-step label=\"Step 3\"></nys-step>\n<div slot=\"actions\">\n<nys-button label=\"Save and Exit\" variant=\"outline\" size=\"sm\" fullWidth></nys-button>\n</div>\n</nys-stepper>",
               "lang": "html"
+            },
+            {
+              "title": "SPA / programmatic navigation",
+              "code": "let currentStep = 0; // furthest reached\nlet viewingStep = 0; // currently displayed\n\nfunction updateStepper(steps) {\nsteps.forEach((step, i) => {\nstep.toggleAttribute('current', i === currentStep);\nstep.toggleAttribute('selected', i === viewingStep);\n});\n}\n\ndocument.querySelector('nys-stepper').addEventListener('nys-step-click', (e) => {\ne.preventDefault();\nconst steps = Array.from(document.querySelectorAll('nys-step'));\nconst clicked = e.composedPath().find(el => el.tagName?.toLowerCase() === 'nys-step');\nconst index = steps.indexOf(clicked);\nif (index !== -1) { viewingStep = index; updateStepper(steps); }\n});\n\n// Advance to next step (call on form submit / \"Continue\" click)\nfunction advance(steps) {\nif (currentStep < steps.length - 1) {\ncurrentStep++;\nviewingStep = currentStep;\nupdateStepper(steps);\n}\n}",
+              "lang": "js"
             }
           ]
         }
@@ -13424,6 +13842,15 @@
               "privacy": "private",
               "default": "null"
             },
+            {
+              "kind": "field",
+              "name": "_resizeObserver",
+              "type": {
+                "text": "ResizeObserver | null"
+              },
+              "privacy": "private",
+              "default": "null"
+            },
             {
               "kind": "field",
               "name": "position",