unstale

npm / @terrazzo/plugin-css

@terrazzo/plugin-css

What changed in @terrazzo/plugin-css 2, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-20.

4 breaking3 deprecations7 new APIs and options2 behavior and defaults11 fixes and other

See which of these apply to your code, ranked, in your agent:

npx @unstale/cli init

@unstale/cli on npm

@terrazzo/plugin-css 227 changes

Breaking changes 4

  • @terrazzo/plugin-css now inherits alphabetize from options, a minor breaking change.

    2.3.0release notes

  • Lint plugins must use the merged sources array instead of the per-file src context value.

    2.0.0release notes

  • Lint plugins no longer receive lint context per individual file; plugins using src must instead read from sources and look up files by token source location.

    2.0.0release notes

  • May be undefined for tokens created with $ref, so plugins using this value must account for its absence.

    2.0.0release notes

Deprecations 3

  • Marked deprecated for removal in 3.0; migrate to permutations.

    2.0.0release notes

  • Marked deprecated for removal in 3.0; migrate to permutations.

    2.0.0release notes

  • Marked deprecated for removal in 3.0; migrate to permutations.

    2.0.0release notes

New APIs and options 7

  • The resolver API adds orthogonality detection, except for $extends.

    2.4.0release notes

  • Added the omitTypographyShorthand option.

    2.2.0release notes

  • Added the subValueVariableName option.

    2.2.0release notes

  • Provides the functionality of the deprecated options and more, and is the recommended migration target.

    2.0.0release notes

  • Support was added for the Token Listing format.

    2.0.0release notes

  • Typography shorthand support was added.

    2.0.0release notes

  • Configuration now allows partial utility CSS groups.

    2.0.0release notes

Behavior and default changes 2

  • Shadow token types and CSS processing now allow lists of aliases.

    2.9.0release notes

  • Validation moved to lint rules, allowing token validation to be configured individually and optionally extended.

    2.0.0release notes

Fixes and other changes 11

  • Fixes sibling-token aliases emitting a variable that reads itself and silently dropping the sibling’s real value.

    2.9.0release notes

  • Zero-valued dimension tokens preserve their units instead of serializing as bare 0, keeping values such as 0px and 0rem type-compatible in CSS math functions like calc().

    2.3.0release notes

  • Improves handling of aliases when the primitive or primary has a token but the aliases do not, preventing tokens from being dropped.

    2.0.3release notes

  • Fixes legacy modeSelectors resolving to the default alias instead of the requested mode.

    2.0.2release notes

  • Fixes a runtime error when $extensions does not have a mode object.

    2.0.1release notes

  • Fixed border tokens not cascading correctly across modes.

    2.0.0release notes

  • Utility class generation now includes missing logical property directions.

    2.0.0release notes

  • Fixed stale descriptions when multiple CSS plugins are used.

    2.0.0release notes

  • CSS generation for extended typography properties was improved.

    2.0.0release notes

  • The TypeScript type now permits undefined or null return values.

    2.0.0release notes

  • Transforms from a previous plugin-css run are no longer cached, preventing correct or unexpected output from stale cached transforms.

    2.0.0release notes