@nysds/components 1.18.1 → 1.19.0

package/packages/react/nysds-jsx.d.ts

@@ -419,6 +419,8 @@ export type NysDatepickerProps = {
 export type NysDividerProps = {
   /** Adjusts colors for dark backgrounds. */
   inverted?: boolean;
+  /** If true, the divider will use a lighter color. */
+  subtle?: boolean;
 };
 
 export type NysDropdownMenuProps = {
@@ -530,8 +532,10 @@ export type NysGlobalHeaderProps = {
 };
 
 export type NysIconProps = {
-  /** Icon name from Material Symbols library. Required. */
+  /** Icon name to resolve from the selected library. Required. */
   name?: string;
+  /** Which registered icon library to use. Defaults to the built-in NYSDS library. */
+  library?: string;
   /** Accessible label. When set, removes `aria-hidden` and adds `aria-label` to the SVG. */
   ariaLabel?: string;
   /** Rotation in degrees. Applied via CSS `rotate`. */
@@ -560,6 +564,8 @@ export type NysIconProps = {
     | "32"
     | "40"
     | "50";
+  /** Resolves when the current icon load (if any) is complete. */
+  updateComplete?: Promise<boolean>;
 };
 
 export type NysLabelProps = {
@@ -644,18 +650,14 @@ export type NysRadiobuttonProps = {
   /**  */
   showOtherError?: boolean;
 
-  /**  */
-  "onnys-error-clear"?: (e: CustomEvent<CustomEvent>) => void;
   /** Fired when selection changes. Detail: `{id, checked, name, value}`. */
-  "onnys-change"?: (e: CustomEvent<CustomEvent>) => void;
-  /** Fired when "other" text input value changes. Detail: `{id, name, value}`. */
-  "onnys-other-input"?: (e: CustomEvent<CustomEvent>) => void;
+  "onnys-change"?: (e: CustomEvent<never>) => void;
   /** Fired when radio gains focus. */
-  "onnys-focus"?: (e: CustomEvent<Event>) => void;
+  "onnys-focus"?: (e: CustomEvent<never>) => void;
   /** Fired when radio loses focus. */
-  "onnys-blur"?: (e: CustomEvent<Event>) => void;
-  /**  */
-  "onnys-error"?: (e: CustomEvent<CustomEvent>) => void;
+  "onnys-blur"?: (e: CustomEvent<never>) => void;
+  /** Fired when "other" text input value changes. Detail: `{id, name, value}`. */
+  "onnys-other-input"?: (e: CustomEvent<never>) => void;
 };
 
 export type NysRadiogroupProps = {
@@ -683,6 +685,13 @@ export type NysRadiogroupProps = {
   form?: string | null;
   /** Radio size for all children: `sm` (24px) or `md` (32px, default). */
   size?: "sm" | "md";
+  /**  */
+  _showOtherError?: boolean;
+
+  /**  */
+  "onnys-change"?: (e: CustomEvent<CustomEvent>) => void;
+  /**  */
+  "onnys-other-input"?: (e: CustomEvent<CustomEvent>) => void;
 };
 
 export type NysOptionProps = {
@@ -744,34 +753,34 @@ export type NysSkipnavProps = {
 };
 
 export type NysStepProps = {
-  /** Whether this step is currently being viewed. Set by parent stepper. */
+  /** Which step is currently being displayed. If not set, defaults to the `current` step.
+Setting this on a step after `current` is silently corrected to match `current`.
+When controlling state from a framework, always set this explicitly. */
   selected?: boolean;
-  /** Marks the furthest reached step. Steps before this are navigable. */
+  /** The furthest step the user has reached (progress boundary). Steps before this are navigable. */
   current?: boolean;
   /** Step label text displayed alongside the step number. */
   label?: string;
-  /** URL for page navigation when step is clicked. Optional for SPA routing. */
+  /** URL navigated to when the step is activated, via `window.location.href`.
+Navigation is suppressed if the `nys-step-click` listener calls `e.preventDefault()`.
+Omit for SPA/framework routing and handle navigation in the event listener instead. */
   href?: string;
-  /** Internal: Whether parent stepper's compact view is expanded. */
-  isCompactExpanded?: boolean;
-  /** Step number (1-indexed). Auto-assigned by parent stepper. */
-  stepNumber?: number;
-  /** Custom click handler. Called before `nys-step-click` event. */
+  /** Optional function called before `nys-step-click` is dispatched. Use for pre-navigation logic. */
   onClick?: (e: Event) => void | undefined;
-  /** Fired when a navigable step is clicked. Detail: `{href, label}`. Cancelable. */
+  /** 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. */
   "onnys-step-click"?: (e: CustomEvent<never>) => void;
 };
 
 export type NysStepperProps = {
-  /** Unique identifier. */
+  /** Unique identifier. Auto-generated as `nys-stepper-{n}-{timestamp}` if not provided. */
   id?: string;
   /** Name attribute for form association. */
   name?: string;
-  /** Title displayed above the step counter. */
+  /** Title displayed above the step list and compact counter. */
   label?: string;
-  /** Progress text (e.g., "Step 2 of 5"). Auto-updated based on selection. */
+  /** Progress text displayed in compact mode (e.g., "Step 2 of 5"). Auto-managed — do not set manually. */
   counterText?: string;
-  /** Whether compact mobile view is expanded to show all steps. */
+  /** Whether compact mobile view is expanded to show all steps. Toggled by clicking the counter. */
   isCompactExpanded?: boolean;
 };
 
@@ -1294,9 +1303,12 @@ export type CustomElements = {
   "nys-globalheader": Partial<NysGlobalHeaderProps & BaseProps & BaseEvents>;
 
   /**
-   * SVG icon from Material Symbols library with size, rotation, and color options.
+   * SVG icon with swappable library support, size, rotation, and color options.
    * ---
    *
+   *
+   * ### **Methods:**
+   *  - **redraw()** - Called by the icon library registry when the current library changes.
    */
   "nys-icon": Partial<NysIconProps & BaseProps & BaseEvents>;
 
@@ -1339,21 +1351,15 @@ export type CustomElements = {
   "nys-pagination": Partial<NysPaginationProps & BaseProps & BaseEvents>;
 
   /**
-   * Radio button for single selection from mutually exclusive options.
+   * Radio button for single selection from mutually exclusive options. This is a READONLY data component.
    * ---
    *
    *
    * ### **Events:**
-   *  - **nys-error-clear**
-   * - **nys-change** - Fired when selection changes. Detail: `{id, checked, name, value}`.
-   * - **nys-other-input** - Fired when "other" text input value changes. Detail: `{id, name, value}`.
+   *  - **nys-change** - Fired when selection changes. Detail: `{id, checked, name, value}`.
    * - **nys-focus** - Fired when radio gains focus.
    * - **nys-blur** - Fired when radio loses focus.
-   * - **nys-error**
-   *
-   * ### **Methods:**
-   *  - **getInputElement(): _Promise<HTMLInputElement | null>_** - Functions
-   * --------------------------------------------------------------------------
+   * - **nys-other-input** - Fired when "other" text input value changes. Detail: `{id, name, value}`.
    *
    * ### **Slots:**
    *  - **description** - Custom HTML description content.
@@ -1365,6 +1371,10 @@ export type CustomElements = {
    * ---
    *
    *
+   * ### **Events:**
+   *  - **nys-change**
+   * - **nys-other-input**
+   *
    * ### **Slots:**
    *  - _default_ - Default slot for `nys-radiobutton` elements.
    * - **description** - Custom HTML description content.
@@ -1414,7 +1424,7 @@ export type CustomElements = {
    *
    *
    * ### **Events:**
-   *  - **nys-step-click** - Fired when a navigable step is clicked. Detail: `{href, label}`. Cancelable.
+   *  - **nys-step-click** - Fired when a navigable (`previous` or `current`) non-selected step is clicked or activated by keyboard. Detail: `{ href: string, label: string }`. Cancelable — call `e.preventDefault()` to suppress `window.location.href` navigation.
    */
   "nys-step": Partial<NysStepProps & BaseProps & BaseEvents>;
 
@@ -1424,8 +1434,8 @@ export type CustomElements = {
    *
    *
    * ### **Slots:**
-   *  - _default_ - Default slot for `nys-step` elements.
-   * - **actions** - Navigation buttons (e.g., Back, Continue). Must be wrapped in a `<div>`.
+   *  - _default_ - Default slot for `nys-step` elements. Only `nys-step` children are accepted; others are removed.
+   * - **actions** - Persistent navigation buttons. Must contain exactly one `<div>` wrapping only `<nys-button>` elements.
    */
   "nys-stepper": Partial<NysStepperProps & BaseProps & BaseEvents>;
 

package/dist/packages/mcp-server/src/lib/format.d.ts

@@ -1,21 +0,0 @@
-/**
- * Format Utilities
- *
- * Helpers for formatting MCP tool responses.
- */
-/**
- * JSON replacer that strips null and undefined values from objects.
- * Use with JSON.stringify(obj, stripNulls, 2) for cleaner output.
- */
-export declare function stripNulls(_key: string, value: unknown): unknown;
-/**
- * Format an object as JSON, stripping null/undefined values and empty arrays.
- */
-export declare function formatResponse(data: unknown): string;
-/**
- * Create a text content response for MCP tools.
- */
-export declare function textContent(data: unknown): {
-    type: "text";
-    text: string;
-};