Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 0 additions & 1 deletion .github/workflows/deploy-docs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,6 @@ jobs:
- run: moon run site:export
- run: moon run visualizer:build
- run: moon run s2-visualizer:build
- run: moon run s2-tokens-viewer:export
- run: moon run viewer:export
- run: moon run release-timeline:build
env:
Expand Down
3 changes: 3 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -119,3 +119,6 @@ dist
# test temporary directories
temp-*
**/test/temp-*

# auto-generated token files (copied by prepare scripts)
docs/s2-tokens-viewer/tokens/
10 changes: 5 additions & 5 deletions .lintstagedrc.js
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
export default {
"**/*.{js,jsx,ts,tsx,json,yml,yaml}": ["prettier --write"],
"**/*.md": (files) => {
// Filter out changeset files - they need special handling
const nonChangesetFiles = files.filter(
(file) => !file.includes(".changeset/"),
// Filter out changeset and CHANGELOG files - they need special handling
const processableFiles = files.filter(
(file) => !file.includes(".changeset/") && !file.includes("CHANGELOG.md"),
);
if (nonChangesetFiles.length === 0) return [];
if (processableFiles.length === 0) return [];
// Use -o flag (no path) to write back to same file
return nonChangesetFiles.map(
return processableFiles.map(
(file) => `remark ${file} --use remark-gfm --use remark-github -o`,
);
},
Expand Down
11 changes: 0 additions & 11 deletions .lintstagedrc.json

This file was deleted.

46 changes: 23 additions & 23 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,48 +1,48 @@
Note: for [Spectrum 2](https://s2.spectrum.adobe.com/) token data has been graduated to the `main` branch. If you need access to the S1 data, use the [`s1-legacy` branch](https://github.com/adobe/spectrum-tokens/tree/s1-legacy) and `v12.x.x` packages on [NPM](https://www.npmjs.com/package/@adobe/spectrum-tokens?activeTab=versions).
Note: for [Spectrum 2](https://s2.spectrum.adobe.com/) token data has been graduated to the `main` branch. If you need access to the S1 data, use the [`s1-legacy` branch](https://github.com/adobe/spectrum-design-data/tree/s1-legacy) and `v12.x.x` packages on [NPM](https://www.npmjs.com/package/@adobe/spectrum-tokens?activeTab=versions).

The [Spectrum token visualizer](https://opensource.adobe.com/spectrum-tokens/visualizer/) shows the token data for S1. For Spectrum 2 data, use [opensource.adobe.com/spectrum-tokens/s2-visualizer/](https://opensource.adobe.com/spectrum-tokens/s2-visualizer/).

# Spectrum Tokens Monorepo

This repo uses:

- [pnpm](https://pnpm.io/) for package management
- [moon](https://moonrepo.dev/moon) to manage task running
- [Changesets](https://github.com/changesets/changesets) for automated versioning and releasing
- [Prettier](https://prettier.io/) for code formatting/linting
- [commitlint](https://commitlint.js.org/) and [Convetional Commits](https://www.conventionalcommits.org/en/v1.0.0/) to standardize commit messages
- [husky](https://typicode.github.io/husky/) to automate formatting of committed files and linting of commit messages
* [pnpm](https://pnpm.io/) for package management
* [moon](https://moonrepo.dev/moon) to manage task running
* [Changesets](https://github.com/changesets/changesets) for automated versioning and releasing
* [Prettier](https://prettier.io/) for code formatting/linting
* [commitlint](https://commitlint.js.org/) and [Convetional Commits](https://www.conventionalcommits.org/en/v1.0.0/) to standardize commit messages
* [husky](https://typicode.github.io/husky/) to automate formatting of committed files and linting of commit messages

Packages in this monorepo:

## Core Packages

- [Spectrum Tokens](packages/tokens/) design tokens for Spectrum, Adobe's design system.
- [Spectrum Component Schemas](packages/component-schemas/) JSON schemas for validating Spectrum component APIs and properties.
* [Spectrum Tokens](packages/tokens/) design tokens for Spectrum, Adobe's design system.
* [Spectrum Component Schemas](packages/component-schemas/) JSON schemas for validating Spectrum component APIs and properties.

## Documentation & Visualization

- [Spectrum Token Visualizer Tool](docs/visualizer/) a visualizer for inspecting S1 tokens. Published as a [static site](https://opensource.adobe.com/spectrum-tokens/visualizer/).
- [Spectrum Token Visualizer Tool S2](docs/s2-visualizer/) a version of the visualizer that shows the Spectrum 2 data. Published as a [static site](https://opensource.adobe.com/spectrum-tokens/s2-visualizer/).
- [Spectrum S2 Tokens Viewer](docs/s2-tokens-viewer/) an enhanced token viewer with component usage analysis for Spectrum 2 tokens.
- [Spectrum Tokens Docs](docs/site/) a static site to show the component options API and other token data.
- [Release Timeline Visualization](docs/release-timeline/) interactive charts showing release frequency and development activity patterns. Published as a [static site](https://opensource.adobe.com/spectrum-tokens/release-timeline/).
* [Spectrum Token Visualizer Tool](docs/visualizer/) a visualizer for inspecting S1 tokens. Published as a [static site](https://opensource.adobe.com/spectrum-tokens/visualizer/).
* [Spectrum Token Visualizer Tool S2](docs/s2-visualizer/) a version of the visualizer that shows the Spectrum 2 data. Published as a [static site](https://opensource.adobe.com/spectrum-tokens/s2-visualizer/).
* [Spectrum S2 Tokens Viewer](docs/s2-tokens-viewer/) an enhanced token viewer with component usage analysis for Spectrum 2 tokens.
* [Spectrum Tokens Docs](docs/site/) a static site to show the component options API and other token data.
* [Release Timeline Visualization](docs/release-timeline/) interactive charts showing release frequency and development activity patterns. Published as a [static site](https://opensource.adobe.com/spectrum-tokens/release-timeline/).

## Development Tools

- [Spectrum Token Diff Generator](tools/diff-generator/) a library and cli tool that reports changes made between two schema/releases/branches.
- [Optimized Diff Engine](tools/optimized-diff/) high-performance diff algorithm for large token datasets.
- [Release Analyzer](tools/release-analyzer/) tool for analyzing release history and generating data for change frequency visualization.
- [Token Changeset Generator](tools/token-changeset-generator/) automates creation of changeset files from token diff analysis.
- [Token CSV Generator](tools/token-csv-generator/) exports token data to CSV format for analysis and reporting.
- [Transform Tokens JSON](tools/transform-tokens-json/) utilities for merging and transforming token data between formats.
- [Token Manifest Builder](tools/token-manifest-builder/) generates manifest files for token distribution.
- [Spectrum Design Data MCP](tools/spectrum-design-data-mcp/) Model Context Protocol server providing AI assistants with structured access to Spectrum design system data.
* [Spectrum Token Diff Generator](tools/diff-generator/) a library and cli tool that reports changes made between two schema/releases/branches.
* [Optimized Diff Engine](tools/optimized-diff/) high-performance diff algorithm for large token datasets.
* [Release Analyzer](tools/release-analyzer/) tool for analyzing release history and generating data for change frequency visualization.
* [Token Changeset Generator](tools/token-changeset-generator/) automates creation of changeset files from token diff analysis.
* [Token CSV Generator](tools/token-csv-generator/) exports token data to CSV format for analysis and reporting.
* [Transform Tokens JSON](tools/transform-tokens-json/) utilities for merging and transforming token data between formats.
* [Token Manifest Builder](tools/token-manifest-builder/) generates manifest files for token distribution.
* [Spectrum Design Data MCP](tools/spectrum-design-data-mcp/) Model Context Protocol server providing AI assistants with structured access to Spectrum design system data.

## Setup monorepo locally

1. Install pnpm using [this guide](https://pnpm.io/installation).
1. Install dependencies
2. Install dependencies
```bash
pnpm i
```
Expand Down
2 changes: 1 addition & 1 deletion docs/release-timeline/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

### Minor Changes

- [#566](https://github.com/adobe/spectrum-tokens/pull/566) [`e0de953`](https://github.com/adobe/spectrum-tokens/commit/e0de953fb8ef5aba92782838094eeec3a4c78321) Thanks [@GarthDB](https://github.com/GarthDB)! - Add release timeline visualization and analysis tools for Spectrum Tokens change tracking.
- [#566](https://github.com/adobe/spectrum-design-data/pull/566) [`e0de953`](https://github.com/adobe/spectrum-design-data/commit/e0de953fb8ef5aba92782838094eeec3a4c78321) Thanks [@GarthDB](https://github.com/GarthDB)! - Add release timeline visualization and analysis tools for Spectrum Tokens change tracking.

This adds new internal tooling for analyzing and visualizing the frequency and scope of Spectrum Tokens releases:
- **Release Analyzer Tool** (`tools/release-analyzer/`): Parses git tags and CHANGELOG.md to extract release data and change scope metrics
Expand Down
16 changes: 8 additions & 8 deletions docs/s2-tokens-viewer/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,57 +4,57 @@

### Patch Changes

- Updated dependencies [[`f64bee3`](https://github.com/adobe/spectrum-tokens/commit/f64bee3900c874775f2d3424516786a0d644d057)]:
- Updated dependencies [[`f64bee3`](https://github.com/adobe/spectrum-design-data/commit/f64bee3900c874775f2d3424516786a0d644d057)]:
- @adobe/spectrum-tokens@13.16.0

## 0.1.7

### Patch Changes

- Updated dependencies [[`1e860c4`](https://github.com/adobe/spectrum-tokens/commit/1e860c4436c58ceca6f4500ea7e24d6d8cdd20c8)]:
- Updated dependencies [[`1e860c4`](https://github.com/adobe/spectrum-design-data/commit/1e860c4436c58ceca6f4500ea7e24d6d8cdd20c8)]:
- @adobe/spectrum-tokens@13.15.1

## 0.1.6

### Patch Changes

- Updated dependencies [[`3df7197`](https://github.com/adobe/spectrum-tokens/commit/3df7197e7da23c9bb107f7dfcd935b5c62a86041)]:
- Updated dependencies [[`3df7197`](https://github.com/adobe/spectrum-design-data/commit/3df7197e7da23c9bb107f7dfcd935b5c62a86041)]:
- @adobe/spectrum-tokens@13.15.0

## 0.1.5

### Patch Changes

- Updated dependencies [[`b4df84e`](https://github.com/adobe/spectrum-tokens/commit/b4df84e2f2ca246332907f9ddda94438288dd98e)]:
- Updated dependencies [[`b4df84e`](https://github.com/adobe/spectrum-design-data/commit/b4df84e2f2ca246332907f9ddda94438288dd98e)]:
- @adobe/spectrum-tokens@13.14.1

## 0.1.4

### Patch Changes

- Updated dependencies [[`336f672`](https://github.com/adobe/spectrum-tokens/commit/336f67216dfd875f0feb65c10059d9f3fe6dcaf7)]:
- Updated dependencies [[`336f672`](https://github.com/adobe/spectrum-design-data/commit/336f67216dfd875f0feb65c10059d9f3fe6dcaf7)]:
- @adobe/spectrum-tokens@13.14.0

## 0.1.3

### Patch Changes

- Updated dependencies [[`1d4973e`](https://github.com/adobe/spectrum-tokens/commit/1d4973e78d814575da231c2c4080ead8a190d2fc)]:
- Updated dependencies [[`1d4973e`](https://github.com/adobe/spectrum-design-data/commit/1d4973e78d814575da231c2c4080ead8a190d2fc)]:
- @adobe/spectrum-tokens@13.13.0

## 0.1.2

### Patch Changes

- [#544](https://github.com/adobe/spectrum-tokens/pull/544) [`18dc0e1`](https://github.com/adobe/spectrum-tokens/commit/18dc0e12537e73d7290ae9b227754b5240807cf3) Thanks [@GarthDB](https://github.com/GarthDB)! - Fix moon.yml command chaining syntax for newer moon version
- [#544](https://github.com/adobe/spectrum-design-data/pull/544) [`18dc0e1`](https://github.com/adobe/spectrum-design-data/commit/18dc0e12537e73d7290ae9b227754b5240807cf3) Thanks [@GarthDB](https://github.com/GarthDB)! - Fix moon.yml command chaining syntax for newer moon version

Updated command chaining in moon.yml tasks to use proper shell syntax instead of && as array elements. This resolves issues with the viewer:export task failing after moon version update.

## 0.1.1

### Patch Changes

- [#533](https://github.com/adobe/spectrum-tokens/pull/533) [`27fe5e4`](https://github.com/adobe/spectrum-tokens/commit/27fe5e44fed13b7b1fddd02f614251cc47c4f8eb) Thanks [@GarthDB](https://github.com/GarthDB)! - Improve S2 tokens viewer self-containment and deployment
- [#533](https://github.com/adobe/spectrum-design-data/pull/533) [`27fe5e4`](https://github.com/adobe/spectrum-design-data/commit/27fe5e44fed13b7b1fddd02f614251cc47c4f8eb) Thanks [@GarthDB](https://github.com/GarthDB)! - Improve S2 tokens viewer self-containment and deployment

**Enhancements:**
- Add workspace dependency on `@adobe/spectrum-tokens` package
Expand Down
20 changes: 16 additions & 4 deletions docs/s2-tokens-viewer/moon.yml
Original file line number Diff line number Diff line change
Expand Up @@ -18,15 +18,27 @@ tasks:
command:
- sh
- -c
- "mkdir -p ../../site/s2-tokens-viewer/ && rm -rf ../../site/s2-tokens-viewer && mkdir -p ../../site/s2-tokens-viewer"
- "mkdir -p ../../site && rm -rf ../../site/s2-tokens-viewer && mkdir -p ../../site/s2-tokens-viewer"
platform: system
prepare:
command:
- sh
- -c
- "mkdir -p tokens && cp -r node_modules/@adobe/spectrum-tokens/src/ tokens && cp -r node_modules/@adobe/spectrum-tokens/package.json tokens/"
platform: system
deps:
- tokens:build
inputs:
- package.json
outputs:
- tokens/
export:
command:
- sh
- -c
- "cp -r ./index.html ../../site/s2-tokens-viewer/ && cp -r ./css ../../site/s2-tokens-viewer/ && cp -r ./data ../../site/s2-tokens-viewer/ && cp -r ./tokens ../../site/s2-tokens-viewer/"
- "mkdir -p ../../site/s2-tokens-viewer && cp -r ./index.html ../../site/s2-tokens-viewer/ && cp -r ./css ../../site/s2-tokens-viewer/ && cp -r ./data ../../site/s2-tokens-viewer/ && cp -r ./tokens ../../site/s2-tokens-viewer/"
deps:
- ~:clean
- ~:prepare
platform: system
outputs:
- /site/
- /site/s2-tokens-viewer/
Loading