@adobe/spectrum-tokens 14.1.0 → 14.2.1

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # [**@adobe/spectrum-tokens**](https://github.com/adobe/spectrum-design-data)
 
+## 14.2.1
+
+### Patch Changes
+
+- [#709](https://github.com/adobe/spectrum-design-data/pull/709) [`49ad47b`](https://github.com/adobe/spectrum-design-data/commit/49ad47bea61952f84eb86b214954136049aca376) Thanks [@GarthDB](https://github.com/GarthDB)! - Use dynamic import for prettier in writeJson so the package loads without prettier
+  when used outside the monorepo (e.g. spectrum-design-data-mcp via npx).
+
+## 14.2.0
+
+### Minor Changes
+
+- [#706](https://github.com/adobe/spectrum-design-data/pull/706) [`c051815`](https://github.com/adobe/spectrum-design-data/commit/c05181505730ec911196c4b6d37d106bccd742e5) Thanks [@GarthDB](https://github.com/GarthDB)! - Add `getTokensByFile()` export (tokens grouped by filename; complement to `getAllTokens()`).
+
 ## 14.1.0
 
 ### Minor Changes
@@ -22,7 +35,6 @@
   <details><summary><strong>Updated Properties (67)</strong></summary>
 
   All tokens below had the `renamed` property added to indicate their replacement token name:
-  
   - `drop-shadow-color` → `drop-shadow-color-100`
   - `color-loupe-drop-shadow-color` → `drop-shadow-elevated-color`
   - `color-handle-drop-shadow-color` → `drop-shadow-color`

package/index.js

@@ -12,11 +12,10 @@ governing permissions and limitations under the License.
 
 import { glob } from "glob";
 
-import { resolve } from "path";
+import { basename, resolve } from "path";
 import { readFile } from "fs/promises";
 import * as url from "url";
 import { writeFile } from "fs/promises";
-import { format } from "prettier";
 
 export const __dirname = url.fileURLToPath(new URL(".", import.meta.url));
 
@@ -28,6 +27,7 @@ export const readJson = async (fileName) =>
   JSON.parse(await readFile(fileName, "utf8"));
 
 export const writeJson = async (fileName, jsonData) => {
+  const { format } = await import("prettier");
   await writeFile(
     fileName,
     await format(JSON.stringify(jsonData), { parser: "json-stringify" }),
@@ -45,6 +45,17 @@ export const isDeprecated = (token) =>
 export const getFileTokens = async (tokenFileName) =>
   await readJson(resolve(__dirname, "src", tokenFileName));
 
+export const getTokensByFile = async () => {
+  const result = {};
+  await Promise.all(
+    tokenFileNames.map(async (filePath) => {
+      const fileName = basename(filePath);
+      result[fileName] = await readJson(filePath);
+    }),
+  );
+  return result;
+};
+
 export const getAllTokens = async () => {
   return await Promise.all(tokenFileNames.map(getFileTokens)).then(
     (tokenFileDataAr) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/spectrum-tokens",
-  "version": "14.1.0",
+  "version": "14.2.1",
   "description": "Design tokens for Spectrum, Adobe's design system",
   "type": "module",
   "main": "index.js",

package/test/checkAliasReferences.test.js

@@ -0,0 +1,53 @@
+/*
+Copyright 2024 Adobe. All rights reserved.
+This file is licensed to you under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License. You may obtain a copy
+of the License at http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed under
+the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+OF ANY KIND, either express or implied. See the License for the specific language
+governing permissions and limitations under the License.
+*/
+
+import test from "ava";
+import { getAllTokens } from "../index.js";
+
+const ALIAS_PATTERN = /^\{([^}]+)\}$/;
+
+function collectAliasRefs(obj, path = "") {
+  const refs = [];
+  if (typeof obj.value === "string") {
+    const match = obj.value.match(ALIAS_PATTERN);
+    if (match) {
+      refs.push({ ref: match[1], path: path || "value" });
+    }
+  }
+  if (obj.sets) {
+    for (const [setName, setValue] of Object.entries(obj.sets)) {
+      refs.push(...collectAliasRefs(setValue, `${path}sets.${setName}.`));
+    }
+  }
+  return refs;
+}
+
+test("every alias reference should resolve to an existing token", async (t) => {
+  const tokens = await getAllTokens();
+  const allTokenNames = new Set(Object.keys(tokens));
+  const invalid = [];
+
+  for (const [tokenName, token] of Object.entries(tokens)) {
+    const refs = collectAliasRefs(token);
+    for (const { ref, path } of refs) {
+      if (!allTokenNames.has(ref)) {
+        invalid.push({ token: tokenName, ref, path });
+      }
+    }
+  }
+
+  t.deepEqual(
+    invalid,
+    [],
+    `${invalid.length} alias references point to non-existent tokens`,
+  );
+});

package/test/checkRenamed.test.js

@@ -0,0 +1,34 @@
+/*
+Copyright 2024 Adobe. All rights reserved.
+This file is licensed to you under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License. You may obtain a copy
+of the License at http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed under
+the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+OF ANY KIND, either express or implied. See the License for the specific language
+governing permissions and limitations under the License.
+*/
+
+import test from "ava";
+import { getAllTokens } from "../index.js";
+
+test("every renamed property should reference an existing token", async (t) => {
+  const tokens = await getAllTokens();
+  const allTokenNames = new Set(Object.keys(tokens));
+  const invalid = [];
+
+  for (const [tokenName, token] of Object.entries(tokens)) {
+    if (Object.hasOwn(token, "renamed")) {
+      if (!allTokenNames.has(token.renamed)) {
+        invalid.push({ token: tokenName, renamed: token.renamed });
+      }
+    }
+  }
+
+  t.deepEqual(
+    invalid,
+    [],
+    `${invalid.length} renamed values reference non-existent tokens`,
+  );
+});