@terrazzo/plugin-js 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 Drew Powers
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/biome.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://biomejs.dev/schemas/1.6.4/schema.json",
+  "extends": ["../../biome.json"],
+  "files": {
+    "include": ["./src/", "./test/"],
+    "ignore": [
+      "./test/fixtures/**/*.js",
+      "./test/fixtures/**/*.json",
+      "./test/fixtures/**/*.d.ts",
+      "./test/**/actual.*",
+      "./test/**/want.*",
+      "./test/types/"
+    ]
+  }
+}

package/dist/build.d.ts

@@ -0,0 +1,7 @@
+import type { BuildHookOptions } from '@terrazzo/parser';
+export declare function buildJS({ getTransforms }: {
+    getTransforms: BuildHookOptions['getTransforms'];
+}): string;
+export declare function buildDTS({ getTransforms }: {
+    getTransforms: BuildHookOptions['getTransforms'];
+}): string;

package/dist/build.js

@@ -0,0 +1,44 @@
+import { FILE_HEADER, FORMAT_DTS_ID, FORMAT_JS_ID, TYPE_MAP } from './lib.js';
+export function buildJS({ getTransforms }) {
+    const output = [FILE_HEADER, ''];
+    // gather vals
+    const tokenVals = {};
+    for (const token of getTransforms({ format: FORMAT_JS_ID, id: '*' })) {
+        if (!tokenVals[token.token.id]) {
+            tokenVals[token.token.id] = {};
+        }
+        tokenVals[token.token.id][token.mode] = token.value;
+    }
+    // body
+    output.push('export const tokens = {');
+    for (const id in tokenVals) {
+        output.push(`  "${id}": {`);
+        for (const mode in tokenVals[id]) {
+            output.push(`    "${mode}": ${tokenVals[id][mode]},`);
+        }
+        output.push('  },');
+    }
+    output.push('};', '');
+    // footer
+    output.push(`/** Get individual token */
+export function token(tokenID, modeName = ".") {
+  return tokens[tokenID]?.[modeName];
+}`, '');
+    return output.join('\n');
+}
+export function buildDTS({ getTransforms }) {
+    const output = [FILE_HEADER, ''];
+    const importDeps = new Set();
+    const types = getTransforms({ format: FORMAT_DTS_ID, id: '*', mode: '.' }).map((t) => {
+        importDeps.add(TYPE_MAP[t.token.$type]); // collect only necessary types
+        if (t.type === 'MULTI_VALUE') {
+            const description = t.value.description ? `  /** ${t.value.description} */\n` : '';
+            return `${description}  "${t.token.id}": ${t.value.value};`;
+        }
+        return `"${t.token.id}": ${t.value};`;
+    });
+    output.push('import type {', ...[...importDeps].sort((a, b) => a.localeCompare(b)).map((dep) => `  ${dep},`), '} from "@terrazzo/parser";', '', 'export declare const tokens: {', ...types, '};', '', `export declare function token<K extends keyof typeof tokens>(tokenID: K, modeName?: never): (typeof tokens)[K]["."];
+export declare function token<K extends keyof typeof tokens, M extends keyof (typeof tokens)[K]>(tokenID: K, modeName: M): (typeof tokens)[K][M];`, '');
+    return output.join('\n');
+}
+//# sourceMappingURL=build.js.map

package/dist/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import type { Plugin } from '@terrazzo/parser';
+import { type JSPluginOptions } from './lib.js';
+export * from './build.js';
+export * from './lib.js';
+export default function pluginJS(options?: JSPluginOptions): Plugin;

package/dist/index.js

@@ -0,0 +1,83 @@
+/**
+ * @module @terrazzo/plugin-js
+ * @license MIT License
+ * 
+ * Copyright (c) 2021 Drew Powers
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import { transformJSValue } from '@terrazzo/token-tools/js';
+import { FORMAT_DTS_ID, FORMAT_JS_ID, TYPE_MAP } from './lib.js';
+import { buildDTS, buildJS } from './build.js';
+export * from './build.js';
+export * from './lib.js';
+export default function pluginJS(options) {
+    const customTransform = options?.transform;
+    return {
+        name: '@terrazzo/plugin-js',
+        async transform({ tokens, getTransforms, setTransform }) {
+            // skip work if another .js plugin has already run
+            const jsTokens = getTransforms({ format: FORMAT_JS_ID, id: '*', mode: '.' });
+            if (jsTokens.length) {
+                return;
+            }
+            for (const id in tokens) {
+                const token = tokens[id];
+                // .d.ts (only default "." mode needed)
+                setTransform(id, {
+                    format: FORMAT_DTS_ID,
+                    value: {
+                        description: token.$description,
+                        value: `Record<"${Object.keys(token.mode).join('" | "')}", ${TYPE_MAP[token.$type]}["$value"]>`,
+                    },
+                    mode: '.',
+                });
+                // .js (all modes)
+                for (const mode in token.mode) {
+                    if (customTransform) {
+                        const transformedValue = customTransform(token, mode);
+                        if (transformedValue !== undefined && transformedValue !== null) {
+                            setTransform(id, { format: FORMAT_JS_ID, value: transformedValue, mode });
+                            continue;
+                        }
+                    }
+                    const transformedValue = transformJSValue(token, { mode, startingIndent: 4 });
+                    if (transformedValue !== undefined) {
+                        setTransform(id, { format: FORMAT_JS_ID, value: transformedValue, mode });
+                    }
+                }
+            }
+        },
+        async build({ getTransforms, outputFile }) {
+            // if (options?.json) {
+            //   const contents = buildJSON({ getTransforms });
+            //   outputFile(typeof options?.json === 'string' ? options.json : 'index.json', contents);
+            // }
+            if (options?.js) {
+                const js = buildJS({ getTransforms });
+                const jsFilename = typeof options?.js === 'string' ? options.js : 'index.js';
+                outputFile(jsFilename, js);
+                const dts = buildDTS({ getTransforms });
+                const dtsFilename = typeof options?.js === 'string' ? options.js.replace(/\.js$/, '.d.ts') : 'index.d.ts';
+                outputFile(dtsFilename, dts);
+            }
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/lib.d.ts

@@ -0,0 +1,17 @@
+import type { Token, TokenNormalized, TokenTransformed } from '@terrazzo/parser';
+export declare const FORMAT_JS_ID = "js";
+export declare const FORMAT_DTS_ID = "d.ts";
+export interface JSPluginOptions {
+    /** output JS? (default: true) */
+    js?: boolean | string;
+    /** output JSON? (default: false) */
+    json?: boolean | string;
+    /** exclude token IDs from output? */
+    exclude?: string[];
+    /** return deeply-nested values? (default: false) */
+    deep?: boolean;
+    /** Override certain token values */
+    transform?: (token: TokenNormalized, mode: string) => TokenTransformed['value'];
+}
+export declare const FILE_HEADER = "/** ------------------------------------------\n *  Autogenerated by \u26CB Terrazzo. DO NOT EDIT!\n * ------------------------------------------- */";
+export declare const TYPE_MAP: Record<Token['$type'], string>;

package/dist/lib.js

@@ -0,0 +1,24 @@
+export const FORMAT_JS_ID = 'js';
+export const FORMAT_DTS_ID = 'd.ts';
+export const FILE_HEADER = `/** ------------------------------------------
+ *  Autogenerated by ⛋ Terrazzo. DO NOT EDIT!
+ * ------------------------------------------- */`;
+export const TYPE_MAP = {
+    boolean: 'BooleanTokenNormalized',
+    border: 'BorderTokenNormalized',
+    color: 'ColorTokenNormalized',
+    cubicBezier: 'CubicBezierTokenNormalized',
+    dimension: 'DimensionTokenNormalized',
+    duration: 'DurationTokenNormalized',
+    fontFamily: 'FontFamilyTokenNormalized',
+    fontWeight: 'FontWeightTokenNormalized',
+    gradient: 'GradientTokenNormalized',
+    link: 'LinkTokenNormalized',
+    number: 'NumberTokenNormalized',
+    shadow: 'ShadowTokenNormalized',
+    string: 'StringTokenNormalized',
+    strokeStyle: 'StrokeStyleTokenNormalized',
+    typography: 'TypographyTokenNormalized',
+    transition: 'TransitionTokenNormalized',
+};
+//# sourceMappingURL=lib.js.map

package/dist/lib.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.js","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC;AACjC,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC;AAepC,MAAM,CAAC,MAAM,WAAW,GAAG;;kDAEuB,CAAC;AAEnD,MAAM,CAAC,MAAM,QAAQ,GAAmC;IACtD,OAAO,EAAE,wBAAwB;IACjC,MAAM,EAAE,uBAAuB;IAC/B,KAAK,EAAE,sBAAsB;IAC7B,WAAW,EAAE,4BAA4B;IACzC,SAAS,EAAE,0BAA0B;IACrC,QAAQ,EAAE,yBAAyB;IACnC,UAAU,EAAE,2BAA2B;IACvC,UAAU,EAAE,2BAA2B;IACvC,QAAQ,EAAE,yBAAyB;IACnC,IAAI,EAAE,qBAAqB;IAC3B,MAAM,EAAE,uBAAuB;IAC/B,MAAM,EAAE,uBAAuB;IAC/B,MAAM,EAAE,uBAAuB;IAC/B,WAAW,EAAE,4BAA4B;IACzC,UAAU,EAAE,2BAA2B;IACvC,UAAU,EAAE,2BAA2B;CACxC,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@terrazzo/plugin-js",
+  "description": "Generate JS, TS, and JSON from your design tokens schema (requires @terrazzo/cli)",
+  "version": "0.0.0",
+  "author": {
+    "name": "Drew Powers",
+    "email": "drew@pow.rs"
+  },
+  "keywords": [
+    "design tokens",
+    "design tokens community group",
+    "design tokens format module",
+    "design system",
+    "dtcg",
+    "w3c design tokens"
+  ],
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "peerDependencies": {
+    "@terrazzo/cli": "^0.0.6"
+  },
+  "dependencies": {
+    "@terrazzo/token-tools": "^0.0.2"
+  },
+  "devDependencies": {
+    "@terrazzo/parser": "^0.0.6",
+    "@terrazzo/cli": "^0.0.6"
+  },
+  "scripts": {
+    "build": "pnpm run build:clean && pnpm run build:ts && pnpm run build:license",
+    "build:clean": "del dist",
+    "build:ts": "tsc -p tsconfig.build.json",
+    "build:license": "node ../../scripts/inject-license.js @terrazzo/plugin-js dist/index.js",
+    "dev": "tsc -p tsconfig.build.json -w",
+    "lint": "biome check .",
+    "test": "co build -c ./test/types.tokens.mjs && pnpm run \"/^test:.*/\"",
+    "test:js": "vitest run",
+    "test:ts": "tsc --noEmit"
+  }
+}

package/src/build.ts

@@ -0,0 +1,67 @@
+import type { BuildHookOptions } from '@terrazzo/parser';
+import { FILE_HEADER, FORMAT_DTS_ID, FORMAT_JS_ID, TYPE_MAP } from './lib.js';
+
+export function buildJS({ getTransforms }: { getTransforms: BuildHookOptions['getTransforms'] }): string {
+  const output: string[] = [FILE_HEADER, ''];
+
+  // gather vals
+  const tokenVals: Record<string, Record<string, string>> = {};
+  for (const token of getTransforms({ format: FORMAT_JS_ID, id: '*' })) {
+    if (!tokenVals[token.token.id]) {
+      tokenVals[token.token.id] = {};
+    }
+    tokenVals[token.token.id]![token.mode] = token.value as string;
+  }
+
+  // body
+  output.push('export const tokens = {');
+  for (const id in tokenVals) {
+    output.push(`  "${id}": {`);
+    for (const mode in tokenVals[id]) {
+      output.push(`    "${mode}": ${tokenVals[id]![mode]},`);
+    }
+    output.push('  },');
+  }
+  output.push('};', '');
+
+  // footer
+  output.push(
+    `/** Get individual token */
+export function token(tokenID, modeName = ".") {
+  return tokens[tokenID]?.[modeName];
+}`,
+    '',
+  );
+
+  return output.join('\n');
+}
+
+export function buildDTS({ getTransforms }: { getTransforms: BuildHookOptions['getTransforms'] }): string {
+  const output: string[] = [FILE_HEADER, ''];
+
+  const importDeps = new Set<string>();
+  const types = getTransforms({ format: FORMAT_DTS_ID, id: '*', mode: '.' }).map((t) => {
+    importDeps.add(TYPE_MAP[t.token.$type]); // collect only necessary types
+    if (t.type === 'MULTI_VALUE') {
+      const description = t.value.description ? `  /** ${t.value.description} */\n` : '';
+      return `${description}  "${t.token.id}": ${t.value.value};`;
+    }
+    return `"${t.token.id}": ${t.value};`;
+  });
+
+  output.push(
+    'import type {',
+    ...[...importDeps].sort((a, b) => a.localeCompare(b)).map((dep) => `  ${dep},`),
+    '} from "@terrazzo/parser";',
+    '',
+    'export declare const tokens: {',
+    ...types,
+    '};',
+    '',
+    `export declare function token<K extends keyof typeof tokens>(tokenID: K, modeName?: never): (typeof tokens)[K]["."];
+export declare function token<K extends keyof typeof tokens, M extends keyof (typeof tokens)[K]>(tokenID: K, modeName: M): (typeof tokens)[K][M];`,
+    '',
+  );
+
+  return output.join('\n');
+}

package/src/index.ts

@@ -0,0 +1,66 @@
+import type { Plugin } from '@terrazzo/parser';
+import { transformJSValue } from '@terrazzo/token-tools/js';
+import { FORMAT_DTS_ID, FORMAT_JS_ID, TYPE_MAP, type JSPluginOptions } from './lib.js';
+import { buildDTS, buildJS } from './build.js';
+
+export * from './build.js';
+export * from './lib.js';
+
+export default function pluginJS(options?: JSPluginOptions): Plugin {
+  const customTransform = options?.transform;
+
+  return {
+    name: '@terrazzo/plugin-js',
+    async transform({ tokens, getTransforms, setTransform }) {
+      // skip work if another .js plugin has already run
+      const jsTokens = getTransforms({ format: FORMAT_JS_ID, id: '*', mode: '.' });
+      if (jsTokens.length) {
+        return;
+      }
+
+      for (const id in tokens) {
+        const token = tokens[id]!;
+
+        // .d.ts (only default "." mode needed)
+        setTransform(id, {
+          format: FORMAT_DTS_ID,
+          value: {
+            description: token.$description,
+            value: `Record<"${Object.keys(token.mode).join('" | "')}", ${TYPE_MAP[token.$type]}["$value"]>`,
+          },
+          mode: '.',
+        });
+
+        // .js (all modes)
+        for (const mode in token.mode) {
+          if (customTransform) {
+            const transformedValue = customTransform(token, mode);
+            if (transformedValue !== undefined && transformedValue !== null) {
+              setTransform(id, { format: FORMAT_JS_ID, value: transformedValue, mode });
+              continue;
+            }
+          }
+          const transformedValue = transformJSValue(token, { mode, startingIndent: 4 });
+          if (transformedValue !== undefined) {
+            setTransform(id, { format: FORMAT_JS_ID, value: transformedValue, mode });
+          }
+        }
+      }
+    },
+    async build({ getTransforms, outputFile }) {
+      // if (options?.json) {
+      //   const contents = buildJSON({ getTransforms });
+      //   outputFile(typeof options?.json === 'string' ? options.json : 'index.json', contents);
+      // }
+      if (options?.js) {
+        const js = buildJS({ getTransforms });
+        const jsFilename = typeof options?.js === 'string' ? options.js : 'index.js';
+        outputFile(jsFilename, js);
+
+        const dts = buildDTS({ getTransforms });
+        const dtsFilename = typeof options?.js === 'string' ? options.js.replace(/\.js$/, '.d.ts') : 'index.d.ts';
+        outputFile(dtsFilename, dts);
+      }
+    },
+  };
+}

package/src/lib.ts

@@ -0,0 +1,40 @@
+import type { Token, TokenNormalized, TokenTransformed } from '@terrazzo/parser';
+
+export const FORMAT_JS_ID = 'js';
+export const FORMAT_DTS_ID = 'd.ts';
+
+export interface JSPluginOptions {
+  /** output JS? (default: true) */
+  js?: boolean | string;
+  /** output JSON? (default: false) */
+  json?: boolean | string;
+  /** exclude token IDs from output? */
+  exclude?: string[];
+  /** return deeply-nested values? (default: false) */
+  deep?: boolean;
+  /** Override certain token values */
+  transform?: (token: TokenNormalized, mode: string) => TokenTransformed['value'];
+}
+
+export const FILE_HEADER = `/** ------------------------------------------
+ *  Autogenerated by ⛋ Terrazzo. DO NOT EDIT!
+ * ------------------------------------------- */`;
+
+export const TYPE_MAP: Record<Token['$type'], string> = {
+  boolean: 'BooleanTokenNormalized',
+  border: 'BorderTokenNormalized',
+  color: 'ColorTokenNormalized',
+  cubicBezier: 'CubicBezierTokenNormalized',
+  dimension: 'DimensionTokenNormalized',
+  duration: 'DurationTokenNormalized',
+  fontFamily: 'FontFamilyTokenNormalized',
+  fontWeight: 'FontWeightTokenNormalized',
+  gradient: 'GradientTokenNormalized',
+  link: 'LinkTokenNormalized',
+  number: 'NumberTokenNormalized',
+  shadow: 'ShadowTokenNormalized',
+  string: 'StringTokenNormalized',
+  strokeStyle: 'StrokeStyleTokenNormalized',
+  typography: 'TypographyTokenNormalized',
+  transition: 'TransitionTokenNormalized',
+};