NYS Design System Release 1.19.3

Responsive margin and padding classes now available

Check out the updated documentation for Responsive utility classes featuring Margin and Padding variants!

Style overrides added for <nys-accordionitem> header text color

You can now override the accordion item header text color by modifying the --nys-accordion-color--header variable in your CSS.

MCP server updates

We made quite a few changes to the MCP server this release:

• Revamp all component code examples in source JSDocs
• Clarify when to enable nysLogo in <nys-globalheader>
• Document user-actions slot in <nys-globalheader>
• Document events fired by <nys-unavheader>

<nys-button> acts more like native <button> now

You can now label an <nys-button> like a native button:

<nys-button>This didn't work before 1.19.3!</nys-button>

Default <nys-icon> library redux

We made a significant improvement to <nys-icon> in v1.19.0. We added the ability to load in custom icons from any icon library. Unfortunately, this led to a break in the default icon library. We created a workaround for the issue, but we felt it was still lacking a ZERO-CONFIG option.

v1.19.3 "reverts" the change to the default library, while continuing to support defining external libraries. Learn how to implement a custom library in 1.19.3.

Expose files/value accessors in <nys-fileinput>

We were missing the native functionality of a file input component. The native functionality lists the files as a value. This fix aligns <nys-fileinput> with native requirements.

Continuing our automation journey

One of our guiding principles for the NYS Design System is to automate everything that is easily repeatable. In an effort to automate our documentation generation, Emily wrote a script that scans the source code Typescript file for @JSDoc-compatible comments and extracts the documentation automatically.

This change removed over 35 MDX files which was functionally duplicate code from our stories files. So we now generate our Storybook stories directly from the component source code, reducing the amount of duplication across the entire repository. Next up? Automating that documentation directly to this website.

Bug fixes

• Translate icon fixed in unavheader
• Accordion height tweaks
• Modal width and height cap removed
• Fix overlapping text in <nys-alert>, <nys-badge>, and <nys-icon>
• Checkbox label weight parity
• Fix checkbox for Drupal
• Lit as peer dep of packages

🚨 Breaking changes

• none

⚠️ Known issues

• Users running NYSDS 1.19.0 through 1.19.2 should immediately upgrade to 1.19.3 to fix the default icon library bug introduced in 1.19.0.

If you notice any issues, please add them to our GitHub Issue Tracker

For full component updates, bug fixes, and the detailed changelog:

See the full developer release notes for v.1.19.3 →