@nysds/components 1.19.3 → 1.20.0-alpha-3

package/dist/packages/nys-table/src/nys-table.d.ts

@@ -10,77 +10,6 @@ import { LitElement } from "lit";
  *   Detail: { columnIndex: number, columnLabel: string, sortDirection: "asc" | "desc" | "none" }
  *
  * @method downloadFile - Triggers download of the CSV file if `download` is set.
- *
- * @example Basic
- * ```html
- * <nys-table id="table1" name="table1">
- *   <table>
- *     <caption>New York State High Peaks and Popular Hikes</caption>
- *     <tr><th>Mountain</th><th>Peak Height (ft)</th><th>Hike Name</th></tr>
- *     <tr><td>Marcy</td><td>5,344</td><td>Van Hoevenberg Trail</td></tr>
- *     <tr><td>Algonquin</td><td>5,114</td><td>Northeast Trail</td></tr>
- *     <tr><td>Haystack</td><td>4,960</td><td>Johns Brook Trail</td></tr>
- *     <tr><td>Skylight</td><td>4,926</td><td>Lake Tear Trail</td></tr>
- *     <tr><td>Whiteface</td><td>4,867</td><td>Whiteface Mountain Trail</td></tr>
- *   </table>
- * </nys-table>
- * ```
- *
- * @example Striped
- * ```html
- * <nys-table id="table2" name="table2" striped>
- *   <table>
- *     <caption>New York State High Peaks and Popular Hikes</caption>
- *     <tr><th>Mountain</th><th>Peak Height (ft)</th><th>Hike Name</th></tr>
- *     <tr><td>Marcy</td><td>5,344</td><td>Van Hoevenberg Trail</td></tr>
- *     <tr><td>Haystack</td><td>4,960</td><td>Johns Brook Trail</td></tr>
- *     <tr><td>Skylight</td><td>4,926</td><td>Lake Tear Trail</td></tr>
- *     <tr><td>Whiteface</td><td>4,867</td><td>Whiteface Mountain Trail</td></tr>
- *   </table>
- * </nys-table>
- * ```
- *
- * @example Bordered
- * ```html
- * <nys-table id="table3" name="table3" bordered>
- *   <table>
- *     <caption>New York State High Peaks and Popular Hikes</caption>
- *     <tr><th>Mountain</th><th>Peak Height (ft)</th><th>Hike Name</th></tr>
- *     <tr><td>Marcy</td><td>5,344</td><td>Van Hoevenberg Trail</td></tr>
- *     <tr><td>Haystack</td><td>4,960</td><td>Johns Brook Trail</td></tr>
- *     <tr><td>Skylight</td><td>4,926</td><td>Lake Tear Trail</td></tr>
- *     <tr><td>Whiteface</td><td>4,867</td><td>Whiteface Mountain Trail</td></tr>
- *   </table>
- * </nys-table>
- * ```
- *
- * @example Sortable
- * ```html
- * <nys-table id="table4" name="table4" sortable>
- *   <table>
- *     <caption>New York State High Peaks and Popular Hikes</caption>
- *     <tr><th>Mountain</th><th>Peak Height (ft)</th><th>Hike Name</th></tr>
- *     <tr><td>Marcy</td><td>5,344</td><td>Van Hoevenberg Trail</td></tr>
- *     <tr><td>Haystack</td><td>4,960</td><td>Johns Brook Trail</td></tr>
- *     <tr><td>Skylight</td><td>4,926</td><td>Lake Tear Trail</td></tr>
- *     <tr><td>Whiteface</td><td>4,867</td><td>Whiteface Mountain Trail</td></tr>
- *   </table>
- * </nys-table>
- * ```
- *
- * @example Downloadable
- * ```html
- * <nys-table id="table5" name="table5" download="path/to/downloadable/version/of/table.filetype">
- *   <table>
- *     <caption>New York State High Peaks and Popular Hikes</caption>
- *     <tr><th>Mountain</th><th>Peak Height (ft)</th><th>Hike Name</th></tr>
- *     <tr><td>Marcy</td><td>5,344</td><td>Van Hoevenberg Trail</td></tr>
- *     <tr><td>Haystack</td><td>4,960</td><td>Johns Brook Trail</td></tr>
- *     <tr><td>Skylight</td><td>4,926</td><td>Lake Tear Trail</td></tr>
- *     <tr><td>Whiteface</td><td>4,867</td><td>Whiteface Mountain Trail</td></tr>
- *   </table>
- * </nys-table>
- * ```
  */
 export declare class NysTable extends LitElement {
     static styles: import("lit").CSSResult;

package/dist/packages/nys-textarea/src/nys-textarea.d.ts

@@ -16,61 +16,14 @@ import { LitElement } from "lit";
  * @fires nys-blur - Fired when textarea loses focus. Triggers validation.
  * @fires nys-select - Fired when user selects text. Detail: `{id, value}`.
  *
- * @example Basic
+ * @example Basic textarea
  * ```html
- * <nys-textarea label="Comments"></nys-textarea>
+ * <nys-textarea label="Comments" rows="4"></nys-textarea>
  * ```
  *
- * @example Disabled
+ * @example Required with description
  * ```html
- * <nys-textarea label="Comments" disabled></nys-textarea>
- * ```
- *
- * @example Readonly
- * ```html
- * <nys-textarea label="Comments" readonly value="You can see me but not edit me"></nys-textarea>
- * ```
- *
- * @example Required
- * ```html
- * <nys-textarea label="Describe the incident" required></nys-textarea>
- * ```
- *
- * @example Optional
- * ```html
- * <nys-textarea label="Comments" optional></nys-textarea>
- * ```
- *
- * @example Max length
- * ```html
- * <nys-textarea label="Comments" maxlength="100"></nys-textarea>
- * ```
- *
- * @example Width Small
- * ```html
- * <nys-textarea label="Comments" width="sm"></nys-textarea>
- * ```
- *
- * @example Width Medium
- * ```html
- * <nys-textarea label="Comments" width="md"></nys-textarea>
- * ```
- *
- * @example Width Large
- * ```html
- * <nys-textarea label="Comments" width="lg"></nys-textarea>
- * ```
- *
- * @example Description
- * ```html
- * <nys-textarea label="Describe the incident" description="Please provide details"></nys-textarea>
- * ```
- *
- * @example Description Slot
- * ```html
- * <nys-textarea label="Describe the incident">
- *  <div slot="description">Please provide details</div>
- * </nys-textarea>
+ * <nys-textarea label="Describe the incident" description="Please provide details" required></nys-textarea>
  * ```
  */
 export declare class NysTextarea extends LitElement {
@@ -97,7 +50,7 @@ export declare class NysTextarea extends LitElement {
     value: string;
     /** Prevents interaction. */
     disabled: boolean;
-    /** Makes textarea readonly but focusable. */
+    /** Makes textarea read-only but focusable. */
     readonly: boolean;
     /** Marks as required. Shows "Required" flag and validates on blur. */
     required: boolean;

package/dist/packages/nys-textinput/src/nys-textinput.d.ts

@@ -17,79 +17,25 @@ import { LitElement } from "lit";
  * @fires nys-focus - Fired when input gains focus.
  * @fires nys-blur - Fired when input loses focus. Triggers validation.
  *
- * @example Basic
+ * @example Basic text input
  * ```html
- * <nys-textinput label="Full Name"></nys-textinput>
+ * <nys-textinput label="Full Name" required></nys-textinput>
  * ```
  *
- * @example Disabled
+ * @example Required Email
  * ```html
- * <nys-textinput label="Email Address" disabled></nys-textinput>
+ * <nys-textinput type="email" label="Email Address" required></nys-textinput>
  * ```
  *
- * @example Readonly
+ * @example Phone with masking
  * ```html
- * <nys-textinput label="Email Address" readonly value="You can see me but not edit me"></nys-textinput>
+ * <nys-textinput type="tel" label="Phone Number"></nys-textinput>
  * ```
  *
- * @example Required
+ * @example Search with button
  * ```html
- * <nys-textinput label="Email Address" required></nys-textinput>
- * ```
- *
- * @example Optional
- * ```html
- * <nys-textinput label="Email Address" optional></nys-textinput>
- * ```
- *
- * @example Width Small
- * ```html
- * <nys-textinput label="Zip Code" width="sm"></nys-textinput>
- * ```
- *
- * @example Width Medium
- * ```html
- * <nys-textinput label="City" width="md"></nys-textinput>
- * ```
- *
- * @example Width Large
- * ```html
- * <nys-textinput label="Email Address" width="lg"></nys-textinput>
- * ```
- *
- * @example Description
- * ```html
- * <nys-textinput label="Email Address" description="Only valid ny.gov emails are accepted."></nys-textinput>
- * ```
- *
- * @example Description Slot
- * ```html
- * <nys-textinput label="Email Address">
- *  <div slot="description">Only valid <strong>ny.gov</strong> emails are accepted.</div>
- * </nys-textinput>
- * ```
- *
- * @example Masking
- * ```html
- * <nys-textinput type="tel" label="Phone Number">
- *  <div slot="description">Some types, such as <code>tel</code> have automatic masking available.</div>
- * </nys-textinput>
- * ```
- *
- * @example Max Min Values
- * ```html
- * <nys-textinput type="number" label="Age" min="18" max="99" width="sm"></nys-textinput>
- * ```
- *
- * @example Suffix Button
- * ```html
- * <nys-textinput id="search-demo" type="search" placeholder="Search">
- *   <nys-button
- *     slot="endButton"
- *     ariaLabel="Search"
- *     prefixIcon="search"
- *     onclick="alert('searching for: ' + document.getElementById('search-demo').value)"
- *   ></nys-button>
+ * <nys-textinput type="search" placeholder="Search">
+ *   <nys-button slot="endButton" label="Search" prefixIcon="search"></nys-button>
  * </nys-textinput>
  * ```
  */

package/dist/packages/nys-toggle/src/nys-toggle.d.ts

@@ -14,50 +14,14 @@ import { LitElement } from "lit";
  * @fires nys-focus - Fired when toggle gains focus.
  * @fires nys-blur - Fired when toggle loses focus.
  *
- * @example Basic
+ * @example Basic toggle
  * ```html
- * <nys-toggle label="Enable notifications" name="notifications" value="enabled-notifications"></nys-toggle>
+ * <nys-toggle label="Enable notifications" name="notifications"></nys-toggle>
  * ```
  *
- * @example Checked
+ * @example Dark mode toggle
  * ```html
- * <nys-toggle label="Dark Mode" name="theme" value="dark" checked></nys-toggle>
- * ```
- *
- * @example Disabled
- * ```html
- * <nys-toggle label="Opt Out of emails" name="toggle-switch" value="emails" disabled></nys-toggle>
- * ```
- *
- * @example Hide Icon
- * ```html
- * <nys-toggle label="No icon on the toggle knob" name="icon" value="no-icon" noIcon></nys-toggle>
- * ```
- *
- * @example Size small
- * ```html
- *  <nys-toggle label="Tiny but mighty" name="sm-size" value="sm-size" size="sm"></nys-toggle>
- * ```
- *
- * @example Description
- * ```html
- * <nys-toggle
- *   label="Opt Out of emails"
- *   description="An email address is recommended to be on file for contact information."
- *   name="toggle-switch"
- *   value="emails"
- * ></nys-toggle>
- * ```
- *
- * @example Description Slot
- * ```html
- * <nys-toggle
- *   label="Opt Out of emails"
- *   name="toggle-switch"
- *   value="emails"
- * >
- *   <p slot="description">We <strong>REALLY</strong> encourage you to keep emails enabled for contact purposes.</p>
- * </nys-toggle>
+ * <nys-toggle label="Dark mode" description="Adjust display for low light" checked></nys-toggle>
  * ```
  */
 export declare class NysToggle extends LitElement {

package/dist/packages/nys-tooltip/src/nys-tooltip.d.ts

@@ -5,51 +5,19 @@ import { LitElement } from "lit";
  * Link to a trigger element via `for` attribute matching the trigger's `id`. Tooltip appears on hover or focus
  * and dismisses on blur, mouse leave, or Escape key. Use for supplementary info only—not critical content.
  *
- * @accessibility
- * - Linked to trigger element via `for` attribute (must match trigger's `id`).
- * - `role="tooltip"` with dynamic `aria-hidden` based on visibility.
- * - Keyboard accessible: Tab to trigger, Enter/Space shows tooltip, Escape dismisses.
- * - Screen readers announce tooltip text when visible.
- * - Visual focus indicators on trigger elements meet WCAG 2.2 AA standards.
- * - Auto-positioning respects viewport bounds to prevent content loss.
- *
  * @summary Contextual tooltip with auto-positioning, keyboard support, and screen reader integration.
  * @element nys-tooltip
  *
- * @example  Basic
- * ```html
- * <div style="display: flex; justify-content: center; gap: 5px; padding: 40px;">
- *   <nys-tooltip for="my-button" text="I am a tooltip."></nys-tooltip>
- *   <nys-button  id="my-button" label="Hover Me"></nys-button>
- * </div>
- * ```
- *
- * @example Position
+ * @example Tooltip for button
  * ```html
- * <div style="display: flex; justify-content: center; gap: 5px; padding: 40px;">
- *   <p>Hover over the icon</p>
- *   <nys-tooltip
- *     for="my-icon2"
- *     text="I am a tooltip."
- *     position="right"
- *   >
- *   </nys-tooltip>
- *   <nys-icon id="my-icon2" name="info" size="3xl"></nys-icon>
- * </div>
+ * <nys-button id="help-btn" label="Help" circle icon="help"></nys-button>
+ * <nys-tooltip for="help-btn" text="Click for assistance"></nys-tooltip>
  * ```
  *
- * @example Inverted
+ * @example Positioned tooltip
  * ```html
- * <div style="background-color: #1b1b1b; color: #ffffff; padding: 40px; display: flex; gap: 5px">
- *   <p>Hover over the icon</p>
- *   <nys-tooltip
- *     for="my-tooltip3"
- *     text="I am a tooltip."
- *     inverted
- *   >
- *   </nys-tooltip>
- *   <nys-icon id="my-tooltip3" name="info" size="3xl"></nys-icon>
- * </div>
+ * <nys-icon id="info-icon" name="info"></nys-icon>
+ * <nys-tooltip for="info-icon" text="Additional details" position="right"></nys-tooltip>
  * ```
  */
 export declare class NysTooltip extends LitElement {

package/dist/packages/nys-unavfooter/src/nys-unavfooter.d.ts

@@ -5,20 +5,12 @@ import { LitElement } from "lit";
  * Place as the last element before `</body>`. Displays NY.gov logo and links to Agencies,
  * App Directory, Counties, Events, Programs, and Services. No configuration needed.
  *
- * @accessibility
- * - Uses semantic `<footer>` element for assistive technology recognition.
- * - All links are keyboard-navigable via Tab.
- * - Proper link text for screen reader users.
- * - Links open in same window (no target="_blank") unless external policy requires otherwise.
- * - Visual design meets WCAG 2.2 AA contrast and focus indicator standards.
- * - Footer is not hidden from screen readers and is announced as navigation.
- *
- *
  * @summary Universal NYS footer with logo and statewide links. Required site-wide.
  * @element nys-unavfooter
  *
- * @example Basic
+ * @example Standard usage
  * ```html
+ * <nys-globalfooter>...</nys-globalfooter>
  * <nys-unavfooter></nys-unavfooter>
  * ```
  */

package/dist/packages/nys-unavheader/src/nys-unavheader.d.ts

@@ -1,9 +1,4 @@
 import { LitElement } from "lit";
-interface Language {
-    code: string;
-    label: string;
-    url?: string;
-}
 /**
  * Universal NYS header with trust bar, logo, search, and language translation. Required on all NYS sites.
  *
@@ -11,66 +6,29 @@ interface Language {
  * site search (searches ny.gov), and 14-language translation dropdown. Use `hideSearch` or `hideTranslate`
  * to remove features if not applicable.
  *
- * @accessibility
- * - Semantic `<header>` element ensures assistive technology recognition.
- * - Trust bar button: `role="button"`, `aria-expanded`, descriptive `aria-label`.
- * - All links and buttons are keyboard-navigable via Tab.
- * - Language dropdown announces current language and list on focus.
- * - Search input announces field purpose and keyboard shortcuts (Enter to submit, Escape to dismiss).
- * - Visual focus indicators meet WCAG 2.2 AA standards.
- * - All text has sufficient color contrast (4.5:1 minimum).
- * - Icons have text labels or `aria-label` attributes.
- *
  * @summary Universal NYS header with trust bar, search, and translation. Required site-wide.
  * @element nys-unavheader
  *
  * @fires nys-language-select - Fired when a language is selected. Detail: `{language: {code, label, url?}}`. Cancelable; `preventDefault()` overrides the default Smartling redirect.
  * @fires nys-search-submit - Fired when a search is submitted. Detail: `{query}`. Cancelable; `preventDefault()` overrides the default search redirect.
+
  *
- * @example Basic
+ * @example Standard usage
  * ```html
  * <nys-unavheader></nys-unavheader>
+ * <nys-globalheader>...</nys-globalheader>
  * ```
  *
- * @example Hide search
+ * @example Without search
  * ```html
  * <nys-unavheader hideSearch></nys-unavheader>
  * ```
- *
- *  @example Hide translate
- * ```html
- * <nys-unavheader hideTranslate></nys-unavheader>
- * ```
- *
- * @example Custom Search URL
- * ```html
- * <nys-unavheader searchUrl="https://designsystem.ny.gov/search/?q="></nys-unavheader>
- * ```
- *
- * @example Custom Language List
- * ```html
- * <nys-unavheader id="my-header"></nys-unavheader>
- * <script>
- *   const header = document.querySelector('#my-header');
- *   header.languages = [
- *   { code: 'en', label: 'English' },
- *   { code: 'es', label: 'Español' , url: '"https://ny.gov/?lang=es"'},
- *   { code: 'fr', label: 'Français', url: '"https://ny.gov/?lang=fr"'},
- *   ];
- * </script>
- * ```
- *
- * @example Custom Language List JS
- * ```html
- * <nys-unavheader id="my-header2"></nys-unavheader>
- * <script>
- *   document.querySelector('#my-header2').addEventListener('nys-language-select', (event) => {
- *   event.preventDefault();
- *   const selectedLanguage = event.detail.language.label;
- *   });
- * </script>
- * ```
  */
+interface Language {
+    code: string;
+    label: string;
+    url?: string;
+}
 export declare class NysUnavHeader extends LitElement {
     static styles: import("lit").CSSResult;
     /** Internal: Whether trust bar panel is expanded. */

package/dist/packages/nys-video/src/nys-video.d.ts

@@ -13,78 +13,16 @@ declare global {
  *
  * For use with YouTube URLs only. Component renders nothing if the URL is invalid.
  *
- * @accessibility
- * - Title text is announced to screen readers when the video is not yet loaded.
- * - When the video loads, the iframe title and aria-label are set to the `titleText`.
- * - Live region announces playback state ("Video is playing", "Advertisement is playing").
- * - Play button is properly labeled and keyboard accessible.
- * - Disabled state prevents play button interaction.
- * - Focus is transferred to the iframe once the video is loaded (for keyboard users).
- *
  * @summary YouTube video player with thumbnail preview and accessibility announcements.
  * @element nys-video
  *
  * @fires nys-video-play - Fired when the user clicks the thumbnail to load the player.
  *
- * @example Basic
- * ```html
- * <nys-video
- *   videourl="https://www.youtube.com/watch?v=TBfFzt0150Q"
- *   titleText="IT'S a Tech Podcast, Episode 3: Human-Centered Design"
- * ></nys-video>
- * ```
- *
- * @example Thumbnail
- * ```html
- * <nys-video
- *  videourl="https://www.youtube.com/watch?v=TBfFzt0150Q"
- *  titleText="IT'S a Tech Podcast, Episode 3: Human-Centered Design"
- *  thumbnail="https://designsystem.ny.gov/assets/img/homepage-grid-3.svg"
- * ></nys-video>
- * ```
- *
- * @example Autoplay
- * ```html
- * <nys-video
- *   videourl="https://www.youtube.com/watch?v=TBfFzt0150Q"
- *   titleText="IT'S a Tech Podcast, Episode 3: Human-Centered Design"
- *   autoplay
- * ></nys-video>
- * ```
- *
- * @example Start Time
- * ```html
- * <nys-video
- *   videourl="https://www.youtube.com/watch?v=TBfFzt0150Q"
- *   titleText="IT'S a Tech Podcast, Episode 3: Human-Centered Design"
- *   starttime="43"
- * ></nys-video>
- * ```
- *
- * @example Disabled
- * ```html
- * <nys-video
- *   videourl="https://www.youtube.com/watch?v=TBfFzt0150Q"
- *   titleText="IT'S a Tech Podcast, Episode 3: Human-Centered Design"
- *   disabled
- * ></nys-video>
- * ```
- *
- * @example Size full
- * ```html
- * <nys-video
- *   size="full"
- *   videourl="https://www.youtube.com/watch?v=TBfFzt0150Q"
- *   titleText="Small (width: 320-439px)"
- * ></nys-video>
- * ```
- *
- * @example Size small
+ * @example Basic usage
  * ```html
  * <nys-video
- *   size="sm"
- *   videourl="https://www.youtube.com/watch?v=TBfFzt0150Q"
- *   titleText="Small (width: 320-439px)"
+ *   videourl="https://www.youtube.com/watch?v=dQw4w9WgXcQ"
+ *   titleText="Video Title"
  * ></nys-video>
  * ```
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nysds/components",
-  "version": "1.19.3",
+  "version": "1.20.0-alpha-3",
   "description": "New York State's design system and code component library.",
   "type": "module",
   "workspaces": [
@@ -29,14 +29,12 @@
   "scripts": {
     "dev": "vite",
     "gen": "plop",
-    "gen-stories": "npm run cem && node src/scripts/generate-stories.mjs",
-    "gen-stories:component": "npm run cem && sh -c 'node src/scripts/generate-stories.mjs \"$@\" && npm run lint:fix' --",
     "build": "tsc --emitDeclarationOnly && vite build",
     "build:umd": "cross-env BUILD_FORMAT=umd vite build",
     "tsc:packages": "tsc -b tsconfig.build.json",
     "build:packages": "npm run tsc:packages && turbo run build --filter='./packages/*' --log-order=grouped",
     "build:root": "cross-env NODE_ENV=production npm run build && cross-env NODE_ENV=production npm run build:umd",
-    "build:all": "npm run clean:dist && npm run lit-analyze || true && cross-env NODE_ENV=production npm run build:packages && npm run build:root && npm run cem && npm run gen-stories && npm run build:mcp && npm run lint:fix",
+    "build:all": "npm run clean:dist && npm run lint && npm run lit-analyze || true && cross-env NODE_ENV=production npm run build:packages && npm run build:root && npm run cem && npm run build:mcp",
     "build:mcp": "npm run build -w @nysds/mcp-server",
     "build:link": "npm run build:all && npm link && cd packages/styles && npm link",
     "lint": "eslint --cache --cache-strategy=content --cache-location node_modules/.cache/eslint && (stylelint \"**/*.scss\" || true)",
@@ -49,8 +47,7 @@
     "release:zip": "npm run build:all && node src/scripts/create-release-zip.js",
     "pretest": "playwright install",
     "test": "wtr --node-resolve",
-    "test:ssr": "node src/scripts/test-ssr.mjs && npm run audit:dist",
-    "audit:dist": "node src/scripts/audit-dist.mjs",
+    "test:ssr": "node scripts/test-ssr.mjs",
     "test:build": "npm run build:all && npm run test",
     "test:compact": "export NYSDS_TEST_OUTPUT=compact && wtr --node-resolve",
     "test:ai": "export NYSDS_TEST_OUTPUT=ai && wtr --node-resolve",
@@ -65,7 +62,7 @@
     "clean:cache": "rm -rf node_modules/.cache",
     "clean:all": "npm run clean:dist && npm run clean:node && npm run clean:cache && find packages -name '*.tsbuildinfo' -delete 2>/dev/null || true && npm run clean:turbo",
     "code-connect": "dotenv -- npx figma connect publish",
-    "cem": "npx cem analyze --config src/scripts/custom-elements-manifest.config.mjs && cp ./custom-elements.json dist/ && node src/scripts/patch-react-utils.js"
+    "cem": "npx cem analyze --config ./custom-elements-manifest.config.mjs && cp ./custom-elements.json dist/ && node src/scripts/patch-react-utils.js"
   },
   "repository": {
     "type": "git",

package/packages/react/NysBreadcrumbs.d.ts

@@ -84,6 +84,6 @@ Override when multiple crumbs exist on the same page. */
  * - **nys-breadcrumbs-expand** - Fired when the user clicks the ellipsis to expand the trail.
  *
  * ### **Slots:**
- *  - _default_ - One or more `li` elements defining the trail.
+ *  - _default_ - One or more `nys-breadcrumbitem` elements defining the trail.
  */
 export const NysBreadcrumbs: React.ForwardRefExoticComponent<NysBreadcrumbsProps>;

package/packages/react/NysButton.d.ts

@@ -123,8 +123,7 @@ export interface NysButtonProps extends Pick<
  * - **nys-click** - Fired when the button is clicked (mouse or keyboard). Not fired when disabled.
  *
  * ### **Slots:**
- *  - _default_ - Button label text. Use as fallback when `label` prop is not provided.
- * - **prefix-icon** - Icon before label. Not shown for `text` variant.
+ *  - **prefix-icon** - Icon before label. Not shown for `text` variant.
  * - **suffix-icon** - Icon after label. Not shown for `text` variant.
  * - **circle-icon** - Icon for circle mode. Overrides `icon` prop.
  *

package/packages/react/NysDropdownMenu.d.ts

@@ -50,7 +50,7 @@ export interface NysDropdownMenuProps extends Pick<
 }
 
 /**
- * Action menu with auto-positioning, keyboard support, and screen reader integration.
+ *
  * ---
  *
  */

package/packages/react/NysLabel.d.ts

@@ -65,10 +65,7 @@ export interface NysLabelProps extends Pick<
 }
 
 /**
- * **Internal component.** Renders form labels with description, required/optional flag, and tooltip.
- *
- * Used internally by form components (textinput, select, checkbox, etc.). Not intended for direct use.
- * Handles label association via `for`, displays asterisk for required fields, and integrates tooltips.
+ * Internal label component for form fields with flag and tooltip support.
  * ---
  *
  *

package/packages/react/NysTextarea.d.ts

@@ -25,7 +25,7 @@ export interface NysTextareaProps extends Pick<
   /** Prevents interaction. */
   disabled?: boolean;
 
-  /** Makes textarea readonly but focusable. */
+  /** Makes textarea read-only but focusable. */
   readonly?: boolean;
 
   /** Marks as required. Shows "Required" flag and validates on blur. */