Feat(exporter-tokens): Export only Theme tokens collection

- Filter out primitives from the generated tokens and leave only color theme tokens

- solves #DS-1543

exporters/tokens/src/generators/fileGenerator.ts

@@ -1,9 +1,10 @@
-import { TokenGroup, Token, Supernova, TokenTheme } from '@supernovaio/sdk-exporters';
-import { generateFileContent } from './contentGenerator';
+import { Supernova, Token, TokenGroup, TokenTheme } from '@supernovaio/sdk-exporters';
 import { commonThemedFilesData, FileData, nonThemedFilesData, themedFilesData } from '../config/fileConfig';
-import { toCamelCase } from '../helpers/stringHelper';
-import { indentAndFormat } from '../formatters/stylesFormatter';
 import { GLOBAL_DIRECTORY, JS_DIRECTORY, SCSS_DIRECTORY, THEMES_DIRECTORY } from '../constants';
+import { indentAndFormat } from '../formatters/stylesFormatter';
+import { filterColorCollections } from '../helpers/colorHelper';
+import { toCamelCase } from '../helpers/stringHelper';
+import { generateFileContent } from './contentGenerator';
 
 export const generateFiles = (
   tokens: Array<Token>,
@@ -79,6 +80,7 @@ export const generateOutputFilesByThemes = async (
   sdk: Supernova,
 ): Promise<{ path: string; fileName: string; content: string }[]> => {
   const outputFiles: { path: string; fileName: string; content: string }[] = [];
+  const filteredColorCollections = filterColorCollections(tokens);
 
   // Generate global files for non-themed tokens
   const globalFiles = generateFiles(tokens, mappedTokens, tokenGroups, nonThemedFilesData);
@@ -121,7 +123,7 @@ export const generateOutputFilesByThemes = async (
   // Compute themed tokens for all themes in parallel
   const allThemes = await Promise.all(
     themes.map(async (theme) => {
-      const themedTokens = sdk.tokens.computeTokensByApplyingThemes(tokens, tokens, [theme]);
+      const themedTokens = sdk.tokens.computeTokensByApplyingThemes(tokens, filteredColorCollections, [theme]);
 
       return { themedTokens, theme };
     }),
@@ -161,7 +163,7 @@ export const generateOutputFilesByThemes = async (
   const rootThemesFileContent = generateThemesRootFile(themes);
   const rootTsThemesFileContent = generateThemesRootFile(themes, true);
   const rootScssThemesFile = `@forward 'color-tokens';\n`;
-  const colorTokensFile = generateFiles(tokens, mappedTokens, tokenGroups, commonThemedFilesData, false);
+  const colorTokensFile = generateFiles(filteredColorCollections, mappedTokens, tokenGroups, commonThemedFilesData, false);
   outputFiles.push({ path: `./${SCSS_DIRECTORY}/`, fileName: '@themes.scss', content: rootThemesFileContent });
   outputFiles.push({
     path: `./${JS_DIRECTORY}/${THEMES_DIRECTORY}`,
@@ -182,4 +184,4 @@ export const generateOutputFilesByThemes = async (
   );
 
   return outputFiles;
-};
+};

exporters/tokens/src/helpers/__tests__/colorHelper.test.ts

@@ -1,6 +1,8 @@
+import { exampleCollectionTokens, expectedCollectionValue } from '../../../tests/fixtures/exampleCollectionTokens';
 import { examplePrefixToken } from '../../../tests/fixtures/examplePrefixToken';
 import {
   canHexBeShortened,
+  filterColorCollections,
   findAllHexColorsInStringAndNormalize,
   normalizeColor,
   removeAlphaChannel,
@@ -105,4 +107,12 @@ describe('colorHelper', () => {
       });
     },
   );
+
+  describe('filterColorCollections', () => {
+    it('should filter color collections', () => {
+      const tokens = Array.from(exampleCollectionTokens.values());
+
+      expect(filterColorCollections(tokens)).toStrictEqual(expectedCollectionValue);
+    });
+  });
 });

exporters/tokens/src/helpers/colorHelper.ts

@@ -1,3 +1,5 @@
+import { Token, TokenType } from '@supernovaio/sdk-exporters';
+
 const HEX_COLOR_REGEX = /#([A-Fa-f0-9]{6,8})\b/g;
 const LONG_HEX_WITH_ALPHA_LENGTH = 8;
 const SHORT_HEX_WITH_ALPHA_LENGTH = 4;
@@ -73,3 +75,28 @@ export const transformColorsToVariables = (
 
   return transformedValue;
 };
+
+export const filterColorCollections = (tokens: Token[]) => {
+  const TOKEN_PROPERTY_NAME = 'Collection';
+  const TOKEN_COLLECTION_NAME = 'Theme tokens';
+
+  return tokens.filter((item) => {
+    // Include all tokens that are not of tokenType "Color"
+    if (item.tokenType !== TokenType.color) {
+      return true;
+    }
+
+    // Proceed with filtering for "Color" tokenType
+    const collectionProperty = item.properties.find((prop) => prop.name === TOKEN_PROPERTY_NAME);
+    if (!collectionProperty) {
+      return false;
+    }
+
+    const themeTokenOption = collectionProperty.options?.find((option) => option.name === TOKEN_COLLECTION_NAME);
+    if (!themeTokenOption) {
+      return false;
+    }
+
+    return item.propertyValues?.Collection === themeTokenOption.id;
+  });
+};

exporters/tokens/tests/fixtures/exampleCollectionTokens.ts

@@ -0,0 +1,127 @@
+import { ColorToken, StringToken, Token, TokenType } from '@supernovaio/sdk-exporters';
+
+export const exampleCollectionTokens = new Map<string, Token>();
+exampleCollectionTokens.set('colorCollectionRef1', {
+  id: 'colorCollectionRef1',
+  name: 'Theme Color',
+  tokenType: TokenType.color,
+  properties: [
+    {
+      name: 'Collection',
+      options: [
+        {
+          id: 'theme-tokens-id',
+          name: 'Theme tokens',
+        },
+        {
+          id: 'primitives-id',
+          name: 'Primitives',
+        },
+        {
+          id: 'global-tokens-id',
+          name: 'Global tokens',
+        },
+      ],
+    },
+  ],
+  propertyValues: { Collection: 'theme-tokens-id' },
+} as unknown as ColorToken);
+
+exampleCollectionTokens.set('colorCollectionRef2', {
+  id: 'colorCollectionRef2',
+  name: 'Primitive Color',
+  tokenType: TokenType.color,
+  properties: [
+    {
+      name: 'Collection',
+      options: [
+        {
+          id: 'theme-tokens-id',
+          name: 'Theme tokens',
+        },
+        {
+          id: 'primitives-id',
+          name: 'Primitives',
+        },
+        {
+          id: 'global-tokens-id',
+          name: 'Global tokens',
+        },
+      ],
+    },
+  ],
+  propertyValues: { Collection: 'primitives-id' },
+} as unknown as ColorToken);
+
+exampleCollectionTokens.set('colorCollectionRef3', {
+  id: 'colorCollectionRef3',
+  name: 'Global Color',
+  tokenType: TokenType.color,
+  properties: [
+    {
+      name: 'Collection',
+      options: [
+        {
+          id: 'theme-tokens-id',
+          name: 'Theme tokens',
+        },
+        {
+          id: 'primitives-id',
+          name: 'Primitives',
+        },
+        {
+          id: 'global-tokens-id',
+          name: 'Global tokens',
+        },
+      ],
+    },
+  ],
+  propertyValues: { Collection: 'global-tokens-id' },
+} as unknown as ColorToken);
+
+exampleCollectionTokens.set('stringRef', {
+  id: 'stringRef',
+  name: 'Columns',
+  tokenType: TokenType.string,
+  parentGroupId: '2',
+  origin: {
+    name: 'Grid/Columns',
+  },
+  value: 'value',
+} as unknown as StringToken);
+
+export const expectedCollectionValue = [
+  {
+    id: 'colorCollectionRef1',
+    name: 'Theme Color',
+    properties: [
+      {
+        name: 'Collection',
+        options: [
+          {
+            id: 'theme-tokens-id',
+            name: 'Theme tokens',
+          },
+          {
+            id: 'primitives-id',
+            name: 'Primitives',
+          },
+          {
+            id: 'global-tokens-id',
+            name: 'Global tokens',
+          },
+        ],
+      },
+    ],
+    propertyValues: { Collection: 'theme-tokens-id' },
+    tokenType: 'Color',
+  },
+  {
+    id: 'stringRef',
+    name: 'Columns',
+    origin: { name: 'Grid/Columns' },
+    parentGroupId: '2',
+    tokenType: 'String',
+    value: 'value',
+  },
+];