⛋ Terrazzo Monorepo

This repo serves as the home for:

• Terrazzo CLI: generate code from DTCG tokens (formerly known as “Cobalt UI”)
  • CSS
  • Sass
  • JS/TS
  • Swift
  • Tailwind
• Terrazzo Color Picker, a futuristic colorpicker that can handle wide gamut and high bit-depth colors in stunning color reproduction
• Token Lab (coming soon): generate design systems from scratch, or start from an existing OSS design system

🔹 Cobalt UI

Cobalt UI 2.0 was renamed to Terrazzo (same project, same people). To see the code for Cobalt 1.0, see the 1.x branch.

@terrazzo/plugin-css

0.10.4

Patch Changes

• #550 936789e Thanks @nlemoine! - Add support for color-scheme property

0.10.3

Patch Changes

• #533 e1a612f Thanks @pvignau! - Auto-install CSS plugin with Sass during init

• Updated dependencies [6141d4f]:

  • @terrazzo/parser@0.10.3

0.10.2

Patch Changes

• #521 f0d909c Thanks @ciampo! - Add token $description as CSS comments

0.10.1

Patch Changes

• #510 4493731 Thanks @drwpow! - Reduce decimal places in color output.

  • [plugin-css] ⚠️ Minor breaking change: decimals have been simplified in output. To restore original behavior, pass in colorDepth: 'unlimited'

• Updated dependencies [4493731]:

  • @terrazzo/token-tools@0.10.1
  • @terrazzo/cli@0.10.1

0.10.0

Minor Changes

• #507 0060100 Thanks @drwpow! - ⚠️ Breaking change: remove HSV as a supported colorSpace, because it’s absent from CSS Color Module 4

• #507 0060100 Thanks @drwpow! - ⚠️ Breaking change: align color token ranges to CSS Color Module 4. This results in breaking changes to HSL and HWB, which normalize to 0 - 100, rather than 0 - 1:

    {
      "colorSpace": "hsl",
  -   "components": [270, 0.5, 0.4]
  +   "components": [270, 50, 40]
    }

  All other color spaces should be unaffected, as they were already matching CSS Color Module 4.

Patch Changes

• #507 0060100 Thanks @drwpow! - Fix a98-rgb colorSpace, accidentally referring to it as "a98"

• Updated dependencies [0060100, 0060100, 0060100]:

  • @terrazzo/token-tools@0.10.0
  • @terrazzo/cli@0.10.0

0.9.1

Patch Changes

• #502 c9792bd Thanks @drwpow! - Fix bug in parsing LAB colors

• #502 c9792bd Thanks @drwpow! - Add support for lab65 colors (not technically part of CSS Module 4 spec, but a nice convenience)

• Updated dependencies [c9792bd, c9792bd]:

  • @terrazzo/token-tools@0.9.1
  • @terrazzo/cli@0.9.1

0.9.0

Minor Changes

• #497 9b80fd4 Thanks @bschlenk! - - potential 5x speedup for @terrazzo/plugin-css
  • removed isTokenMatch from @terrazzo/token-tools

Patch Changes

• Updated dependencies [9b80fd4]:
  • @terrazzo/cli@0.9.0
  • @terrazzo/token-tools@0.9.0

0.8.1

Patch Changes

• Updated dependencies [5edf1fd]:
  • @terrazzo/cli@0.8.1
  • @terrazzo/token-tools@0.8.1

0.8.0

Minor Changes

• #489 63f91e6 Thanks @drwpow! - Use Rolldown for packaging 🚀

Patch Changes

• Updated dependencies [63f91e6]:
  • @terrazzo/token-tools@0.8.0
  • @terrazzo/cli@0.8.0

0.7.4

Patch Changes

• #485 84335da Thanks @drwpow! - Add transform API to allow dynamic parsing / transformation of tokens on load

• Updated dependencies [84335da]:

  • @terrazzo/cli@0.7.4
  • @terrazzo/token-tools@0.7.4

0.7.3

Patch Changes

• #482 abc14c4 Thanks @drwpow! - Fix documentation links

• Updated dependencies [abc14c4]:

  • @terrazzo/cli@0.7.3
  • @terrazzo/token-tools@0.7.3

0.7.2

Patch Changes

• #477 0e24810 Thanks @dzonatan! - add baseSelector option to css plugin to allow changing the root selector

0.7.1

Patch Changes

• #468 2c28957 Thanks @drwpow! - When downsampling colors for sRGB gamut, preserve the originally-authored colorspace

• Updated dependencies [2c28957]:

  • @terrazzo/token-tools@0.7.1
  • @terrazzo/cli@0.7.1

0.7.0

Minor Changes

• #454 44ff082 Thanks @drwpow! - ⚠️ Breaking change: the new color token object format uses "components" instead of "channels". Please update your tokens accordingly.

Patch Changes

• Updated dependencies [44ff082]:
  • @terrazzo/token-tools@0.7.0
  • @terrazzo/cli@0.7.0

0.6.0

Minor Changes

• #425 9a98ab0 Thanks @drwpow! - feat: ⚠️ Breaking change: aliasing to specific modes (# character) is deprecated. It was an experimental feature in Cobalt 1.0 with unpredictable behavior. In some upcoming spec changes it will be incompatible with advanced usecases.

• #425 9a98ab0 Thanks @drwpow! - fix: Improvements to mode aliasing and mode overrides. typography tokens only have to partially-declare overrides for modes, while keeping their core set. While this has been supported, behavior was buggy and sometimes was inconsistent.

• #425 9a98ab0 Thanks @drwpow! - ⚠️ Breaking change: cubicBezier tokens no longer support aliases as values, in line with the spec.

Patch Changes

• #425 9a98ab0 Thanks @drwpow! - fix: [plugin-css] Font Family names without spaces no longer get quotes.

  fix: Font Family tokens are always normalized to an array internally for easier parsing.

• #425 9a98ab0 Thanks @drwpow! - feat: @terrazzo/plugin-css now returns entire token for variableName. This is a minor breaking change from variableName(name: string) → variableName(token: Token), but current users can just use token.id to get the same value as before.

  ⚠️ Minor internal breaking change as a result: transformCSSValue() in @terrazzo/token-tools now requires entire token️ to make this possible.

• #425 9a98ab0 Thanks @drwpow! - fix: ⚠️ [plugin-css] Minor breaking change: transition tokens no longer generate variables for sub-parts. This is a change done in service to better protect “allowed” token usage. If you want consumers to be able to “break apart” tokens, then they must also exist as individual tokens that get aliased.

• Updated dependencies [9a98ab0, 9a98ab0, 9a98ab0, 9a98ab0, 9a98ab0, 9a98ab0, 9a98ab0, 9a98ab0, 9a98ab0]:

  • @terrazzo/token-tools@0.6.0
  • @terrazzo/cli@0.6.0

0.5.0

Minor Changes

• #420 ff3d9d1 Thanks @drwpow! - fix: ⚠️ Breaking change: CSS aliases will revert to original 1.0 behavior and be “shallow,” meaning they’ll be preserved as-written. Terrazzo 2.0 (beta) attempted to simplify aliases to only be single-depth, but that results in unintentional behavior.

Patch Changes

• #420 ff3d9d1 Thanks @drwpow! - fix: Improve reverse alias lookups (needed for plugin-css, where redeclared base tokens need downstream aliases to be redeclared too, so the values aren’t stale)

• #419 3962918 Thanks @drwpow! - Improve CLI logging and debugging for performance testing

• #420 ff3d9d1 Thanks @drwpow! - fix: CSS utilities alphabetize declarations to produce more consistent output. Reordering tokens should be a plugin-level concern; parser will preserve token authoring order.

• Updated dependencies [ff3d9d1, 3962918, ff3d9d1, ff3d9d1, ff3d9d1]:

  • @terrazzo/cli@0.5.0
  • @terrazzo/token-tools@0.5.0

0.4.0

Minor Changes

• #416 822c956 Thanks @drwpow! - fix: ⚠️ Breaking change: CSS variables updated to closer match Cobalt 1.0 behavior

Patch Changes

• #416 822c956 Thanks @drwpow! - feat: Add legacyHex option for outputting legacy hex codes

• Updated dependencies [822c956, 822c956]:

  • @terrazzo/token-tools@0.4.0
  • @terrazzo/cli@0.4.0

0.3.2

Patch Changes

• #412 7e3d513 Thanks @drwpow! - feat: Add skipBuild option to skip generating .css files

• #411 2ad079c Thanks @drwpow! - fix: Bug in pnpm workspaces

0.3.1

Patch Changes

• #408 6f97566 Thanks @drwpow! - fix(critical): plugin-css didn’t scope values properly

• #408 6f97566 Thanks @drwpow! - fix: setTransform() would not properly deduplicate token values

• Updated dependencies [6f97566]:

  • @terrazzo/cli@0.3.4

0.3.0

Minor Changes

• #391 8e6810c Thanks @drwpow! - fix: ⚠️ Breaking change: Remove dash around numbers in CSS var names

Patch Changes

• Updated dependencies [8e6810c]:
  • @terrazzo/cli@0.3.0

0.2.0

Minor Changes

• Reconcile types with latest changes from @terrazzo/cli and @terrazzo/parser

0.1.2

Patch Changes

• #347 b90287c Thanks @tomasfrancisco! - Add support for inset shadows

• Updated dependencies [b90287c]:

  • @terrazzo/token-tools@0.1.3
  • @terrazzo/parser@0.1.3
  • @terrazzo/cli@0.1.3

0.1.1

Patch Changes

• #339 9197405 Thanks @tomasfrancisco! - Fix missing letter spacing transformation as a dimension token

• #341 a637f67 Thanks @drwpow! - Fix 0 durations missing units in CSS

• Updated dependencies [9197405, a637f67]:

  • @terrazzo/token-tools@0.1.1
  • @terrazzo/parser@0.1.1
  • @terrazzo/cli@0.1.1

0.1.0

Minor Changes

• #319 e7f272d Thanks @drwpow! - ⚠️ Breaking change: dimension and duration tokens normalize to object syntax in plugins (following upcoming changes in DTCG spec; see https://github.com/design-tokens/community-group/pull/244).

Patch Changes

• Updated dependencies [e7f272d]:
  • @terrazzo/token-tools@0.1.0
  • @terrazzo/parser@0.1.0
  • @terrazzo/cli@0.1.0

0.0.11

Patch Changes

• #302 d0a9df4 Thanks @drwpow! - Fix parser bug with partialAliasOf that would lead to incorrect final values when aliasing

• Updated dependencies [d0a9df4]:

  • @terrazzo/parser@0.0.17
  • @terrazzo/cli@0.0.17

0.0.10

Patch Changes

• #285 e8a0df1 Thanks @drwpow! - Add support for multiple token files

• Updated dependencies [e8a0df1]:

  • @terrazzo/token-tools@0.0.6
  • @terrazzo/parser@0.0.12
  • @terrazzo/cli@0.0.12