.changeset/config.json

@@ -1,9 +1,12 @@
 {
-  "$schema": "https://unpkg.com/@changesets/config@2.3.0/schema.json",
-  "changelog": ["@changesets/changelog-github", {"repo": "drwpow/cobalt-ui"}],
+  "$schema": "https://unpkg.com/@changesets/config@3.0.2/schema.json",
+  "changelog": [
+    "@changesets/changelog-github",
+    {
+      "repo": "terrazzoapp/terrazzo"
+    }
+  ],
   "commit": false,
-  "linked": [],
   "access": "public",
-  "baseBranch": "main",
-  "updateInternalDependencies": "patch"
+  "baseBranch": "main"
 }

.git-blame-ignore-revs

@@ -0,0 +1,3 @@
+# Prettier format
+4b07a803ce92376ba2dff577454cf619eb53ed5e
+c15567f94a557cbfed32bb3bb51c7e7b98f75d49

.github/pull_request_template.md

@@ -0,0 +1,7 @@
+## Changes
+
+_What does this PR change? Link to any related issue(s)._
+
+## How to Review
+
+_How can a reviewer review your changes? What should be kept in mind for this review?_

.github/workflows/ci.yml

@@ -6,25 +6,59 @@ on:
       - main
   pull_request:
 
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
 jobs:
   lint:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
-      - uses: pnpm/action-setup@v2
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+      - uses: pnpm/action-setup@v4
         with:
-          version: latest
-      - uses: actions/setup-node@v3
-      - run: pnpm i
+          version: 9.15.4
+          run_install: true
       - run: pnpm run lint
   test:
+    strategy:
+      matrix:
+        node-version: [20.x, 22.x, 23.x]
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
-      - uses: pnpm/action-setup@v2
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 9.15.4
+          run_install: true
+      - run: pnpm test
+  test-macos:
+    runs-on: macos-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22.x
+      - uses: pnpm/action-setup@v4
         with:
-          version: latest
-      - uses: actions/setup-node@v3
-      - run: pnpm i
-      - run: pnpm run build
+          version: 9.15.4
+          run_install: true
       - run: pnpm test
+  test-windows:
+    runs-on: windows-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22.x
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 9.15.4
+          run_install: true
+      - run: pnpm -r build && pnpm -r test

.github/workflows/release.yml

@@ -9,22 +9,21 @@ jobs:
   changelog:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
-      - uses: pnpm/action-setup@v2
+      - uses: actions/setup-node@v4
         with:
-          version: latest
-      - name: Setup Node
-        uses: actions/setup-node@v3
+          node-version: 22
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
         with:
-          node-version: 20
-      - run: pnpm i
+          version: 9.15.4
+          run_install: true
       - run: pnpm run build
       - uses: changesets/action@v1
         with:
           version: pnpm run version
           publish: pnpm exec changeset publish
-          commit: '[ci] release'
-          title: '[ci] release'
+          commit: "[ci] release"
+          title: "[ci] release"
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           NPM_TOKEN: ${{ secrets.NPM_TOKEN }}

.gitignore

@@ -1,6 +1,8 @@
+.DS_Store
 dist
 node_modules
 package-lock.json
 .dccache
 .pnpm-debug*
 .env
+.turbo

.nvmrc

@@ -0,0 +1 @@
+22.x

.prettierignore

@@ -1,6 +1,4 @@
-/packages/utils/src/ansi.ts
-/docs/tokens.json
-want.json
-want.js
-want.d.ts
-examples/*/tokens/*
+*.css
+*.ts
+*.tsx
+*.js

.vscode/extensions.json

@@ -0,0 +1,3 @@
+{
+  "recommendations": ["biomejs.biome"]
+}

.vscode/settings.json

@@ -0,0 +1,26 @@
+{
+  "[css]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[astro]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[javascript]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[javascriptreact]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[json]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[markdown]": {
+    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  },
+  "[typescript]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[typescriptreact]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  }
+}

CONTRIBUTING.md

@@ -9,31 +9,63 @@ contributing here.
 
 ## Setup
 
-This repo requires [pnpm]. Once installed, run:
+This repo requires [pnpm](https://pnpm.io/). Once installed, run:
 
-```
+```sh
 pnpm i
 ```
 
 ## Developing
 
 To build TypeScript as you work, run:
 
-```
+```sh
 pnpm run dev
 ```
 
+This project uses [Biome](https://biomejs.dev/), a modern JS toolchain, for linting and formatting.
+
+### `.ts` vs. `.js` + `.d.ts`
+
+Some packages (such as `parser`) are written in raw `.js` and `.d.ts`. The reason is the types are written strictly for the benefit of the user, however, the runtime needs to handle invalid and unexpected input that TypeScript may think is impossible or unnecessary, and it usually gets confused. One way to solve this is typing almost everything as `unknown`, however, that’s essentially the same as just writing `.js` anyway. Another way to look at it is for these packages, `.d.ts` are what’s _expected_ from the user, but often reality won’t match that.
+
+Packages that are wrtitten in `.ts` follow more expected TypeScript conventions.
+
 ## Testing
 
 Tests are written in [Vitest](https://vitest.dev), a modern replacement for Jest. To run tests:
 
-```
+```sh
 pnpm run build
 pnpm test
 ```
 
-## Opening a PR
+⚠️ **Be sure to build first!** Many tests test the _actual_ built files, not the source `.ts` files.
+
+## Opening a Pull Request
+
+All PRs are welcome! But to save your time, here are some common PRs received and the best course of action to take:
+
+_✨ **Tip**: check out the [good first issue](https://github.com/terrazzoapp/terrazzo/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) and [help wanted](https://github.com/terrazzoapp/terrazzo/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22) tags for open issues that need a PR!_
+
+### 🐛 Bugfixes
+
+1. **Open the PR directly.** Always accepted, with or without an accompanying issue, as long as you also add tests. Thank you for fixing it!
+
+### 📖 Documentation Changes
+
+1. **Open an issue.** If this is a larger restructuring, or making huge content changes, we’re open to that! But it may need discussion first. However, if this is a **translation** (always accepted) or **fixing a typo** no issue is needed; just open the PR.
+2. **Open the PR.** This will be accepted 🙂.
+
+### ✨ New Feature
+
+1. **Open an issue to discuss.** Before opening a PR, the feature may need some discussion, and a clarifying design! Opening an issue makes sure no work is wasted when it’s time for a PR.
+2. **Open the PR.** With a clear goal for the PR, it’ll be easier to write and review, and will chip more quickly!
+
+### 💥 Breaking Change
 
-All PRs are welcome! When opening a PR, be sure to complete the checklist within the template to make it easier on me 🙂.
+1. **Open an issue to discuss.** Sure, we never plan _directly_ on breaking the API, but usually it’s part of a larger desired change. Let’s discuss it **in an issue** before opening a PR!
+2. **Open a NON-BREAKING PR against `main`** Usually we can do some halfway workaround that somewhat solves the problem without breaking the existing API. But afterward, …
+3. **Open a BREAKING PR in the future when pinged**. Cobalt doesn’t have a defined release cycle yet, but at certain times, there will be a branch that contains breaking changes for a future major release. The core maintainers will coordinate with you on how to get the breaking changes in, if they’re accepted.
 
-[pnpm]: https://pnpm.io/
+For all PRs, **adding tests** are required, as is **filling out the description template** and adding a 🦋 **Changeset** if a new version needs to be released (Changeset instructions automatically appear as a PR comment).

README.md

@@ -1,10 +1,17 @@
-# Cobalt
+# ⛋ Terrazzo Monorepo
 
-Design token tooling compatible with the [W3C Design Tokens specification](https://design-tokens.github.io/community-group/format/). Cobalt can:
+This repo serves as the home for:
 
-- Parse and validate any valid `tokens.json` file
-- Generate Sass, CSS, TypeScript, and more from `tokens.json`
-- Keep `tokens.json` in sync from one or multiple Figma files
-- Provide a common interface for you to write your own plugins and code generators for your design tokens
+- [Terrazzo CLI](https://terrazzo.app/docs/cli): generate code from [DTCG tokens](https://tr.designtokens.org/format/) (formerly known as “Cobalt UI”)
+  - [CSS](https://terrazzo.app/docs/cli/integrations/css)
+  - [Sass](https://terrazzo.app/docs/cli/integrations/sass)
+  - [JS/TS](https://terrazzo.app/docs/cli/integrations/js)
+  - [Swift](https://terrazzo.app/docs/cli/integrations/swift)
+  - [Tailwind](https://terrazzo.app/docs/cli/integrations/tailwind)
+- [Terrazzo Color Picker](https://terrazzo.app/docs/components/color-picker), a futuristic colorpicker that can handle wide gamut and high bit-depth colors in stunning color reproduction
+- [Terrazzo Tiles DS](./packages/tiles/): a design system for _documenting_ design systems
+- Token Lab (coming soon): generate design systems from scratch, or start from an existing OSS design system
 
-**[👉 Read Documentation](https://cobalt-ui.pages.dev)**
+### 🔹 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](https://github.com/terrazzoapp/terrazzo/tree/1.x).

biome.json

@@ -0,0 +1,62 @@
+{
+  "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
+  "organizeImports": {
+    "enabled": true
+  },
+  "files": {
+    "ignore": ["**/dist/**", "**/package.json", "*.css.d.ts"]
+  },
+  "formatter": {
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineWidth": 120
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "single",
+      "jsxQuoteStyle": "single"
+    }
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true,
+      "complexity": {
+        "useArrowFunction": "off"
+      },
+      "correctness": {
+        "useImportExtensions": "error",
+        "useExhaustiveDependencies": "off"
+      },
+      "style": {
+        "noNonNullAssertion": "off",
+        "noUselessElse": "off",
+        "useBlockStatements": "error"
+      },
+      "performance": {
+        "noDelete": "off"
+      },
+      "suspicious": {
+        "noConsoleLog": "error",
+        "noFallthroughSwitchClause": "error",
+        "noExplicitAny": "warn",
+        "noShadowRestrictedNames": "error"
+      },
+      "nursery": {
+        "useGuardForIn": "error"
+      }
+    }
+  },
+  "overrides": [
+    {
+      "include": ["**/*.test.*"],
+      "linter": {
+        "rules": {
+          "suspicious": {
+            "noExplicitAny": "off"
+          }
+        }
+      }
+    }
+  ]
+}