unstale

npm / @terrazzo/parser

@terrazzo/parser

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

7 breaking1 deprecations7 new APIs and options3 behavior and defaults9 fixes and other

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

npx @unstale/cli init

@unstale/cli on npm

@terrazzo/parser 227 changes

Breaking changes 7

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

    2.3.0release notes

  • The listPermutations API is no longer provided for complex resolvers.

    2.2.0release notes

  • These token types now have stricter requirements that all properties be present; each behavior can be opted out of through lint rules.

    2.0.0release notes

  • build() and buildEnd() plugin hooks now execute in parallel; other hooks remain sequential.

    2.0.0release notes

  • DTCG 2nd Editors draft format now errors by default; colors and dimensions must use the new object format, and typography requires its minimum properties.

    2.0.0release notes

  • Plugin lint now runs once on the merged full set instead of on individual files; plugins using src must read from sources instead.

    2.0.0release notes

  • The transform API receives a Momoa node first and a context object second, and must return a Momoa node rather than raw JSON.

    2.0.0release notes

Deprecations 1

  • Soft-deprecated in favor of core/valid-typography.

    2.0.0release notes

New APIs and options 7

  • Add the resolveAliases option; setting it to false allows partial application of input using the sets and modifiers options.

    2.5.0release notes

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

    2.4.0release notes

  • A dependency-free package is used for generated JS plugin declarations so published token packages do not require consumers to install @terrazzo/parser.

    2.4.0release notes

  • Adds full support for the DTCG v2025.10 spec, including resolvers.

    2.0.0release notes

  • Adds first-class support for local and remote JSON references; DTCG aliases are transformed to JSON $refs and are interchangeable.

    2.0.0release notes

  • Adds support for the Token Listing format.

    2.0.0release notes

  • Adds typography shorthand support.

    2.0.0release notes

Behavior and default changes 3

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

    2.9.0release notes

  • Validation is handled by lint rules, so token validation can be configured individually and optionally extended.

    2.0.0release notes

  • May be undefined for tokens created with $ref.

    2.0.0release notes

Fixes and other changes 9

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

    2.0.3release notes

  • In legacy mode, modeSelectors now resolves to the requested mode instead of the default alias.

    2.0.2release notes

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

    2.0.1release notes

  • Fixes cases where border tokens’ partial aliases referred to themselves.

    2.0.0release notes

  • Fixes border tokens not cascading correctly across modes.

    2.0.0release notes

  • Adds the missing $deprecated property to group types.

    2.0.0release notes

  • Improves CSS generation for extended typography properties.

    2.0.0release notes

  • Fixes unused-rule warnings for rules that are turned off.

    2.0.0release notes

  • Fixes strokeStyle partialAliasOf.

    2.0.0release notes