@terrazzo/cli 0.2.1 → 0.2.3

package/.turbo/turbo-build.log

@@ -1,4 +1,4 @@
 
-> @terrazzo/cli@0.2.1 build /home/runner/work/terrazzo/terrazzo/packages/cli
+> @terrazzo/cli@0.2.3 build /home/runner/work/terrazzo/terrazzo/packages/cli
 > tsc -p tsconfig.build.json
 

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @terrazzo/cli
 
+## 0.2.3
+
+### Patch Changes
+
+- [#367](https://github.com/terrazzoapp/terrazzo/pull/367) [`00af144`](https://github.com/terrazzoapp/terrazzo/commit/00af144538390c0fd22ebc14bf70db2c1f942203) Thanks [@drwpow](https://github.com/drwpow)! - Add Microsoft Fluent as starter template
+
+- Updated dependencies [[`00af144`](https://github.com/terrazzoapp/terrazzo/commit/00af144538390c0fd22ebc14bf70db2c1f942203)]:
+  - @terrazzo/parser@0.2.3
+  - @terrazzo/token-tools@0.2.3
+
+## 0.2.2
+
+### Patch Changes
+
+- [#364](https://github.com/terrazzoapp/terrazzo/pull/364) [`27cc92e`](https://github.com/terrazzoapp/terrazzo/commit/27cc92ef5e9e187b5ec7a8abe3f23bc51f59fc9c) Thanks [@drwpow](https://github.com/drwpow)! - Add init CLI options
+
+- Updated dependencies [[`27cc92e`](https://github.com/terrazzoapp/terrazzo/commit/27cc92ef5e9e187b5ec7a8abe3f23bc51f59fc9c)]:
+  - @terrazzo/parser@0.2.2
+  - @terrazzo/token-tools@0.2.2
+
 ## 0.2.1
 
 ### Patch Changes

package/bin/cli.js

@@ -25,210 +25,90 @@
  * SOFTWARE.
  */
 
-import fs from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
 import { parseArgs } from 'node:util';
-import { Logger, build, defineConfig, parse } from '@terrazzo/parser';
-import chokidar from 'chokidar';
+import { Logger } from '@terrazzo/parser';
 import dotenv from 'dotenv';
-import pc from 'picocolors';
-import yamlToMomoa from 'yaml-to-momoa';
-
+import { buildCmd } from '../dist/build.js';
+import { checkCmd } from '../dist/check.js';
+import { helpCmd } from '../dist/help.js';
+import { initCmd } from '../dist/init.js';
+import { loadConfig } from '../dist/shared.js';
+import { versionCmd } from '../dist/version.js';
+
+// Load env vars before anything else
+// (a user may not use these at all, but in the offchance they do)
 dotenv.config();
 
 const [, , ...argsRaw] = process.argv;
-const cwd = new URL(`file://${process.cwd()}/`);
-const PKG_ROOT = new URL('../', import.meta.url);
-const logger = new Logger(
-  // TODO: listen for env vars for debugging, log level, etc
-);
-
-const GREEN_CHECK = pc.green('✔');
 
 const { values: flags, positionals } = parseArgs({
   args: argsRaw,
   allowPositionals: true,
   options: {
-    config: {
-      type: 'string',
-      short: 'c',
-    },
-    out: {
-      type: 'string',
-      short: 'o',
-    },
-    help: {
-      type: 'boolean',
-    },
-    watch: {
-      type: 'boolean',
-      short: 'w',
-    },
-    version: {
-      type: 'boolean',
-    },
+    config: { type: 'string', short: 'c' },
+    out: { type: 'string', short: 'o' },
+    help: { type: 'boolean' },
+    silent: { type: 'boolean' },
+    quiet: { type: 'boolean' }, // secret alias for --silent because I can’t remember it
+    watch: { type: 'boolean', short: 'w' },
+    version: { type: 'boolean' },
   },
 });
 
+// Note: there are 2 types of logging in the CLI. The logger passed to the
+// parser will provide shared configuration for all methods, but it will throw
+// Errors because it’s expected to run in a generic JS context (process.exit
+// won’t always be available).
+//
+// However, in a CLI, errors are more numerous and expected, and users are
+// likely to see multiple at once. We want to remove stacktraces just for the
+// CLI context. So we wrap this logger with our own formatter that simply prints
+// the raw message.
+const logger = new Logger({
+  // set correct level of debugging
+  level: flags.silent || flags.quiet ? 'error' : undefined,
+  // add debug messages, if requested
+  debugScope: process.env.DEBUG,
+});
+
 export default async function main() {
-  const start = performance.now();
   const cmd = positionals[0];
 
   // ---
-  // half-run commands: --help, --version, init
+  // Half-run commands: --help, --version, init
 
   // --version
   if (flags.version) {
-    const { version } = JSON.parse(fs.readFileSync(new URL('./package.json', PKG_ROOT), 'utf8'));
-    console.log(version);
+    versionCmd();
     process.exit(0);
   }
 
   // --help
   if (flags.help || !cmd) {
-    showHelp();
+    helpCmd();
     process.exit(0);
   }
 
-  // ---
-  // full-run commands: build, check
-
-  // setup: load terrazzo.config.js and terrazzo.config.json
-  let configPath;
-  if (typeof flags.config === 'string') {
-    if (flags.config === '') {
-      printErrors('Missing path after --config flag');
-      process.exit(1);
-    }
-    configPath = resolveConfig(flags.config);
-  }
-  let config = {
-    tokens: [new URL('./tokens.json', cwd)],
-    outDir: new URL('./tokens/', cwd),
-    plugins: [],
-    ignore: { tokens: [], deprecated: false },
-  };
-  const resolvedConfigPath = resolveConfig(configPath);
-  if (resolvedConfigPath) {
-    try {
-      const mod = await import(resolvedConfigPath);
-      if (!mod.default) {
-        printErrors(
-          `No default export found in ${path.relative(cwd.href, resolvedConfigPath)}. See https://terrazzo.dev/docs/cli for instructions.`,
-        );
-        process.exit(1);
-      }
-      config = defineConfig(mod.default, { cwd, logger });
-    } catch (err) {
-      printErrors(err.message || err);
-      process.exit(1);
-    }
-  } else if (cmd !== 'init' && cmd !== 'check') {
-    printErrors('No config file found. Create one with `npx terrazzo init`.');
-    process.exit(1);
-  }
+  const { config, configPath } = await loadConfig({ cmd, flags, logger });
 
+  // ---
+  // Full-run commands: build, check, lint
   switch (cmd) {
     case 'build': {
-      if (!Array.isArray(config.plugins) || !config.plugins.length) {
-        printErrors(`No plugins defined! Add some in ${configPath || 'terrazzo.config.js'}`);
-        process.exit(1);
-      }
-
-      let rawSchemas = await loadTokens(config.tokens);
-
-      const watch = flags.watch;
-
-      let { tokens, ast } = await parse(rawSchemas, { config, logger, yamlToMomoa });
-      let result = await build(tokens, { ast, config, logger });
-      writeFiles(result, config);
-
-      printErrors(result.errors);
-      printWarnings(result.warnings);
-
-      if (watch) {
-        const dt = new Intl.DateTimeFormat('en-us', {
-          hour: '2-digit',
-          minute: '2-digit',
-        });
-        const tokenWatcher = chokidar.watch(config.tokens.map((filename) => fileURLToPath(filename)));
-        tokenWatcher.on('change', async (filename) => {
-          try {
-            rawSchemas = await loadTokens(config.tokens);
-            const parseResult = await parse(rawSchemas, { config, logger, yamlToMomoa });
-            tokens = parseResult.tokens;
-            ast = parseResult.ast;
-            result = await build(tokens, { ast, config, logger });
-            console.log(
-              `${pc.dim(dt.format(new Date()))} ${pc.green('Tz')}} ${pc.yellow(filename)} updated ${GREEN_CHECK}`,
-            );
-          } catch (err) {
-            printErrors([err.message || err]);
-          }
-        });
-        const configWatcher = chokidar.watch(resolveConfig(configPath));
-        configWatcher.on('change', async (filename) => {
-          try {
-            console.log(
-              `${pc.dim(dt.format(new Date()))} ${pc.green('Tz')} ${pc.yellow('Config updated. Reloading…')}`,
-            );
-            config = (await import(filename)).default;
-            rawSchema = await loadTokens(config.tokens);
-            const parseResult = await parse(tokens, { config, logger, yamlToMomoa });
-            tokens = parseResult.tokens;
-            ast = parseResult.ast;
-            result = await build(tokens, { ast, config, logger });
-            writeFiles(result, config);
-          } catch (err) {
-            printErrors([err.message || err]);
-          }
-        });
-
-        // keep process occupied
-        await new Promise(() => {});
-      } else {
-        printSuccess(
-          `${Object.keys(tokens).length} token${Object.keys(tokens).length !== 1 ? 's' : ''} built ${time(start)}`,
-        );
-      }
-      break;
-    }
-    case 'check': {
-      const rawSchemas = await loadTokens(positionals[1] ? [resolveTokenPath(positionals[1])] : config.tokens);
-      const filename = positionals[1] || config.tokens[0];
-      console.log(pc.underline(filename.protocol === 'file:' ? filename.href : filename));
-      await parse(rawSchemas, { config, continueOnError: true, logger, yamlToMomoa }); // will throw if errors
-      printSuccess(`No errors ${time(start)}`);
+      await buildCmd({ config, configPath, flags, logger });
       break;
     }
+    case 'check':
     case 'lint': {
-      if (!Array.isArray(config.plugins) || !config.plugins.length) {
-        printErrors(`No plugins defined! Add some in ${configPath || 'terrazzo.config.js'}`);
-      }
-
-      const rawSchema = await loadTokens(positionals[1] ? [resolveTokenPath(positionals[1])] : config.tokens);
-      await parse(rawSchema, { config, continueOnError: true, logger, yamlToMomoa }); // will throw if errors
-
+      await checkCmd({ config, logger, positionals });
       break;
     }
     case 'init': {
-      if (
-        !fs.existsSync(new URL('./terrazzo.config.js', cwd)) &&
-        !fs.existsSync(new URL('./terrazzo.config.mjs', cwd)) &&
-        !fs.existsSync(new URL('./terrazzo.config.cjs', cwd))
-      ) {
-        fs.cpSync(new URL('./terrazzo.config.mjs', PKG_ROOT), new URL('./terrazzo.config.mjs', cwd));
-        printSuccess('terrazzo.config.mjs created');
-      }
-      if (!fs.existsSync(config.tokens[0])) {
-        fs.cpSync(new URL('./tokens-example.json', PKG_ROOT), new URL(config?.tokens, cwd));
-        printSuccess(`${config.tokens} created ${time(start)}`);
-      }
+      await initCmd({ config, flags, logger });
       break;
     }
     default: {
-      showHelp();
+      helpCmd();
       break;
     }
   }
@@ -238,192 +118,3 @@ export default async function main() {
 }
 
 main();
-
-/** Show help */
-function showHelp() {
-  console.log(`tz
-  [commands]
-    build           Build token artifacts from tokens.json
-      --watch, -w   Watch tokens.json for changes and recompile
-      --no-lint     Disable linters running on build
-    check [path]    Check tokens.json for syntax errors
-    lint [path]     Run linters
-    init            Create a starter tokens.json file
-    bundle          Combine multiple tokens schemas into one
-      --out [path]  Specify bundled tokens.json output
-    convert [file]  Convert Style Dictionary format to DTCG
-      --out [path]  Specify converted tokens.json output
-
-  [options]
-    --help          Show this message
-    --config, -c    Path to config (default: ./terrazzo.config.js)
-`);
-}
-
-/** load tokens */
-async function loadTokens(tokenPaths) {
-  const allTokens = [];
-
-  if (!Array.isArray(tokenPaths)) {
-    printErrors(`loadTokens: Expected array, received ${typeof tokenPaths}`);
-    process.exit(1);
-  }
-
-  // if this is the default value, also check for tokens.yaml
-  if (tokenPaths.length === 1 && tokenPaths[0].href === new URL('./tokens.json', cwd).href) {
-    if (!fs.existsSync(tokenPaths[0])) {
-      const yamlPath = new URL('./tokens.yaml', cwd);
-      if (fs.existsSync(yamlPath)) {
-        tokenPaths[0] = yamlPath;
-      } else {
-        printErrors(
-          `Could not locate ${path.relative(cwd.href, tokenPaths[0].href)}. To create one, run \`npx tz init\`.`,
-        );
-        process.exit(1);
-      }
-    }
-  }
-
-  // download/read
-  for (let i = 0; i < tokenPaths.length; i++) {
-    const filename = tokenPaths[i];
-
-    if (!(filename instanceof URL)) {
-      printErrors(`loadTokens[${i}]: Expected URL, received ${filename}`);
-      process.exit(1);
-    }
-
-    if (filename.protocol === 'http:' || filename.protocol === 'https:') {
-      try {
-        // if Figma URL
-        if (filename.host === 'figma.com' || filename.host === 'www.figma.com') {
-          const [_, fileKeyword, fileKey] = filename.pathname.split('/');
-          if (fileKeyword !== 'file' || !fileKey) {
-            printErrors(
-              `Unexpected Figma URL. Expected "https://www.figma.com/file/:file_key/:file_name?…", received "${filename.href}"`,
-            );
-            process.exit(1);
-          }
-          const headers = new Headers({
-            Accept: '*/*',
-            'User-Agent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:123.0) Gecko/20100101 Firefox/123.0',
-          });
-          if (process.env.FIGMA_ACCESS_TOKEN) {
-            headers.set('X-FIGMA-TOKEN', process.env.FIGMA_ACCESS_TOKEN);
-          } else {
-            printWarnings('FIGMA_ACCESS_TOKEN not set');
-          }
-          const res = await fetch(`https://api.figma.com/v1/files/${fileKey}/variables/local`, {
-            method: 'GET',
-            headers,
-          });
-          if (res.ok) {
-            allTokens.push({ filename, src: await res.text() });
-          }
-          const message = res.status !== 404 ? JSON.stringify(await res.json(), undefined, 2) : '';
-          printErrors(`Figma responded with ${res.status}${message ? `:\n${message}` : ''}`);
-          process.exit(1);
-          break;
-        }
-
-        // otherwise, expect YAML/JSON
-        const res = await fetch(filename, {
-          method: 'GET',
-          headers: { Accept: '*/*', 'User-Agent': 'Mozilla/5.0 Gecko/20100101 Firefox/123.0' },
-        });
-        allTokens.push({ filename, src: await res.text() });
-      } catch (err) {
-        printErrors(`${filename.href}: ${err}`);
-      }
-    } else {
-      if (fs.existsSync(filename)) {
-        allTokens.push({ filename, src: fs.readFileSync(filename, 'utf8') });
-      } else {
-        printErrors(`Could not locate ${path.relative(cwd.href, filename.href)}. To create one, run \`npx tz init\`.`);
-        process.exit(1);
-      }
-    }
-  }
-
-  return allTokens;
-}
-
-/**
- * resolve config
- * @return {string | undefined} resolvedPath
- */
-function resolveConfig(filename) {
-  // --config [configpath]
-  if (filename) {
-    const configPath = new URL(filename, cwd);
-    if (fs.existsSync(configPath)) {
-      return configPath.href; // ⚠️ ESM wants "file://..." URLs on Windows & Unix.
-    }
-    return undefined;
-  }
-
-  // default: terrazzo.config.js
-  for (const defaultFilename of [
-    './terrazzo.config.mjs', // .mjs takes precedence (it suggestes .js is CJS)
-    './terrazzo.config.js',
-  ]) {
-    const configPath = new URL(defaultFilename, cwd);
-    if (fs.existsSync(configPath)) {
-      return configPath.href; // ⚠️ ESM wants "file://..." URLs on Windows & Unix.
-    }
-  }
-}
-
-/** Resolve tokens.json path (for lint command) */
-function resolveTokenPath(filename) {
-  const tokensPath = new URL(filename, cwd);
-  if (!fs.existsSync(tokensPath)) {
-    printErrors(`Could not locate ${filename}. Does the file exist?`);
-    process.exit(1);
-  }
-  if (!fs.statSync(tokensPath).isFile()) {
-    printErrors(`Expected JSON or YAML file, received ${filename}.`);
-    process.exit(1);
-  }
-  return tokensPath;
-}
-
-/** Print time elapsed */
-function time(start) {
-  const diff = performance.now() - start;
-  return pc.dim(diff < 750 ? `${Math.round(diff)}ms` : `${(diff / 1000).toFixed(1)}s`);
-}
-
-/** Print success */
-export function printSuccess(message) {
-  console.log(`  ${GREEN_CHECK}  ${message}`);
-}
-
-/** Print errors */
-export function printErrors(errors) {
-  if (!errors || (typeof errors !== 'string' && !Array.isArray(errors))) {
-    return;
-  }
-  for (const err of Array.isArray(errors) ? errors : [errors]) {
-    console.error(`  ${pc.red(`✘  ${err}`)}`);
-  }
-}
-
-/** Print warnings */
-export function printWarnings(warnings) {
-  if (!warnings || (typeof warnings !== 'string' && !Array.isArray(warnings))) {
-    return;
-  }
-  for (const warn of Array.isArray(warnings) ? warnings : [warnings]) {
-    console.warn(`  ${pc.yellow(`!  ${warn}`)}`);
-  }
-}
-
-/** Write files */
-export function writeFiles(result, config) {
-  for (const { filename, contents } of result.outputFiles) {
-    const output = new URL(filename, config.outDir);
-    fs.mkdirSync(new URL('.', output), { recursive: true });
-    fs.writeFileSync(output, contents);
-  }
-}

package/dist/build.d.ts

@@ -0,0 +1,12 @@
+import { type BuildRunnerResult, type ConfigInit, type Logger } from '@terrazzo/parser';
+import { type Flags } from './shared.js';
+export interface BuildOptions {
+    flags: Flags;
+    config: ConfigInit;
+    configPath: string;
+    logger: Logger;
+}
+/** tz build */
+export declare function buildCmd({ config, configPath, flags, logger }: BuildOptions): Promise<void>;
+/** Write files */
+export declare function writeFiles(result: BuildRunnerResult, config: ConfigInit): void;

package/dist/build.js

@@ -0,0 +1,88 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { build, parse } from '@terrazzo/parser';
+import chokidar from 'chokidar';
+import pc from 'picocolors';
+import yamlToMomoa from 'yaml-to-momoa';
+import { DEFAULT_TOKENS_PATH, GREEN_CHECK, cwd, loadTokens, printError, printSuccess, resolveConfig, } from './shared.js';
+/** tz build */
+export async function buildCmd({ config, configPath, flags, logger }) {
+    try {
+        const startTime = performance.now();
+        if (!Array.isArray(config.plugins) || !config.plugins.length) {
+            logger.error({ message: `No plugins defined! Add some in ${configPath || 'terrazzo.config.js'}` });
+        }
+        // first build
+        let rawSchemas = await loadTokens(config.tokens, { logger });
+        if (!rawSchemas) {
+            logger.error({
+                message: `Error loading ${path.relative(fileURLToPath(cwd), fileURLToPath(config.tokens[0] || DEFAULT_TOKENS_PATH))}`,
+            });
+            return;
+        }
+        let { tokens, sources } = await parse(rawSchemas, { config, logger, yamlToMomoa });
+        let result = await build(tokens, { sources, config, logger });
+        writeFiles(result, config);
+        // --watch (handle rebuild)
+        if (flags.watch) {
+            const dt = new Intl.DateTimeFormat('en-us', {
+                hour: '2-digit',
+                minute: '2-digit',
+            });
+            async function rebuild({ messageBefore, messageAfter } = {}) {
+                try {
+                    if (messageBefore) {
+                        logger.info({ message: messageBefore });
+                    }
+                    rawSchemas = await loadTokens(config.tokens, { logger });
+                    if (!rawSchemas) {
+                        throw new Error(`Error loading ${path.relative(fileURLToPath(cwd), fileURLToPath(config.tokens[0] || DEFAULT_TOKENS_PATH))}`);
+                    }
+                    const parseResult = await parse(rawSchemas, { config, logger, yamlToMomoa });
+                    tokens = parseResult.tokens;
+                    sources = parseResult.sources;
+                    result = await build(tokens, { sources, config, logger });
+                    if (messageAfter) {
+                        logger.info({ message: messageAfter });
+                    }
+                    writeFiles(result, config);
+                }
+                catch (err) {
+                    console.error(pc.red(`✗  ${err.message || err}`));
+                    // don’t exit! we’re watching, so continue as long as possible
+                }
+            }
+            const tokenWatcher = chokidar.watch(config.tokens.map((filename) => fileURLToPath(filename)));
+            tokenWatcher.on('change', async (filename) => {
+                await rebuild({
+                    messageBefore: `${pc.dim(dt.format(new Date()))} ${pc.green('tz')}} ${pc.yellow(filename)} updated ${GREEN_CHECK}`,
+                });
+            });
+            const configWatcher = chokidar.watch(resolveConfig(configPath));
+            configWatcher.on('change', async () => {
+                await rebuild({
+                    messageBefore: `${pc.dim(dt.format(new Date()))} ${pc.green('tz')} ${pc.yellow('Config updated. Reloading…')}`,
+                });
+            });
+            // keep process occupied
+            await new Promise(() => { });
+        }
+        else {
+            printSuccess(`${Object.keys(tokens).length} token${Object.keys(tokens).length !== 1 ? 's' : ''} built`, startTime);
+        }
+    }
+    catch (err) {
+        printError(err.message);
+        process.exit(1);
+    }
+}
+/** Write files */
+export function writeFiles(result, config) {
+    for (const { filename, contents } of result.outputFiles) {
+        const output = new URL(filename, config.outDir);
+        fs.mkdirSync(new URL('.', output), { recursive: true });
+        fs.writeFileSync(output, contents);
+    }
+}
+//# 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/check.d.ts

@@ -0,0 +1,9 @@
+import { type ConfigInit, type Logger } from '@terrazzo/parser';
+export interface CheckOptions {
+    /** positional CLI args */
+    positionals: string[];
+    config: ConfigInit;
+    logger: Logger;
+}
+/** tz check */
+export declare function checkCmd({ config, logger, positionals }: CheckOptions): Promise<void>;

package/dist/check.js

@@ -0,0 +1,24 @@
+import { parse } from '@terrazzo/parser';
+import yamlToMomoa from 'yaml-to-momoa';
+import { loadTokens, printError, printSuccess, resolveTokenPath } from './shared.js';
+/** tz check */
+export async function checkCmd({ config, logger, positionals }) {
+    try {
+        const startTime = performance.now();
+        const tokenPaths = positionals.slice(1).length
+            ? positionals.slice(1).map((tokenPath) => resolveTokenPath(tokenPath, { logger }))
+            : config.tokens;
+        const sources = await loadTokens(tokenPaths, { logger });
+        if (!sources?.length) {
+            logger.error({ message: 'Couldn’t find any tokens. Run `npx tz init` to create some.' });
+            return;
+        }
+        await parse(sources, { config, continueOnError: true, logger, yamlToMomoa }); // will throw if errors
+        printSuccess('No errors', startTime);
+    }
+    catch (err) {
+        printError(err.message);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=check.js.map

package/dist/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../src/check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,WAAW,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AASrF,eAAe;AACf,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAgB;IAC1E,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QACpC,MAAM,UAAU,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM;YAC5C,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,gBAAgB,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YAClF,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;QAClB,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;YACrB,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,6DAA6D,EAAE,CAAC,CAAC;YACzF,OAAO;QACT,CAAC;QACD,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,uBAAuB;QACrG,YAAY,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,UAAU,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;QACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/help.d.ts

@@ -0,0 +1,2 @@
+/** Show help */
+export declare function helpCmd(): void;

package/dist/help.js

@@ -0,0 +1,18 @@
+/** Show help */
+export function helpCmd() {
+    console.log(`tz
+  [commands]
+    build           Build token artifacts from tokens.json
+      --watch, -w   Watch tokens.json for changes and recompile
+      --no-lint     Disable linters running on build
+    check [path]    Check tokens.json for errors and run linters
+    lint [path]     (alias of check)
+    init            Create a starter tokens.json file
+
+  [options]
+    --help          Show this message
+    --config, -c    Path to config (default: ./terrazzo.config.js)
+    --quiet         Suppress warnings
+`);
+}
+//# sourceMappingURL=help.js.map

package/dist/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAAA,gBAAgB;AAChB,MAAM,UAAU,OAAO;IACrB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;CAab,CAAC,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -1,2 +1,3 @@
 import { type Config, type ConfigInit } from '@terrazzo/parser';
+export type { Command, Flags } from './shared.js';
 export declare function defineConfig(config: Config): ConfigInit;

package/dist/index.js

@@ -1,5 +1,6 @@
 import { defineConfig as defineConfigCore } from '@terrazzo/parser';
+import { cwd } from './shared.js';
 export function defineConfig(config) {
-    return defineConfigCore(config, { cwd: new URL(`file://${process.cwd()}/`) });
+    return defineConfigCore(config, { cwd });
 }
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,YAAY,IAAI,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAElG,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO,gBAAgB,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,IAAI,GAAG,CAAC,UAAU,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;AAChF,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,YAAY,IAAI,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAClG,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAIlC,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO,gBAAgB,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;AAC3C,CAAC"}

package/dist/init.d.ts

@@ -0,0 +1,5 @@
+import type { Logger } from '@terrazzo/parser';
+export interface InitOptions {
+    logger: Logger;
+}
+export declare function initCmd({ logger }: InitOptions): Promise<void>;

package/dist/init.js

@@ -0,0 +1,217 @@
+import { execSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { confirm, intro, multiselect, outro, select, spinner } from '@clack/prompts';
+import { pluralize } from '@terrazzo/token-tools';
+import { detect } from 'detect-package-manager';
+import { generate } from 'escodegen';
+import { parseModule } from 'meriyah';
+import { DEFAULT_CONFIG_PATH, DEFAULT_TOKENS_PATH, cwd, loadConfig, printError } from './shared.js';
+const INSTALL_COMMAND = {
+    npm: 'install -D --silent',
+    yarn: 'add -D --silent',
+    pnpm: 'add -D --silent',
+    bun: 'install -D --silent',
+};
+const DTCG_ROOT_URL = 'https://raw.githubusercontent.com/terrazzoapp/dtcg-examples/refs/heads/main/';
+const DESIGN_SYSTEMS = {
+    'adobe-spectrum': {
+        name: 'Spectrum',
+        author: 'Adobe',
+        tokens: ['adobe-spectrum.json'],
+    },
+    'apple-hig': {
+        name: 'Human Interface Guidelines',
+        author: 'Apple',
+        tokens: ['apple-hig.json'],
+    },
+    'figma-sds': {
+        name: 'Simple Design System',
+        author: 'Figma',
+        tokens: ['figma-sds.json'],
+    },
+    'github-primer': {
+        name: 'Primer',
+        author: 'GitHub',
+        tokens: ['github-primer.json'],
+    },
+    'ibm-carbon': {
+        name: 'Carbon',
+        author: 'IBM',
+        tokens: ['ibm-carbon.json'],
+    },
+    'microsoft-fluent': {
+        name: 'Fluent',
+        author: 'Microsoft',
+        tokens: ['microsoft-fluent.json'],
+    },
+    radix: {
+        name: 'Radix',
+        author: 'Radix',
+        tokens: ['radix.json'],
+    },
+    'salesforce-lightning': {
+        name: 'Lightning',
+        author: 'Salesforce',
+        tokens: ['salesforce-lightning.json'],
+    },
+    'shopify-polaris': {
+        name: 'Polaris',
+        author: 'Shopify',
+        tokens: ['shopify-polaris.json'],
+    },
+};
+export async function initCmd({ logger }) {
+    try {
+        intro('⛋ Welcome to Terrazzo');
+        const packageManager = await detect({ cwd: fileURLToPath(cwd) });
+        // TODO: pass in CLI flags?
+        const { config, configPath } = await loadConfig({ cmd: 'init', flags: {}, logger });
+        const relConfigPath = configPath
+            ? path.relative(fileURLToPath(cwd), fileURLToPath(new URL(configPath)))
+            : undefined;
+        let tokensPath = config.tokens[0];
+        let startFromDS = !(tokensPath && fs.existsSync(tokensPath));
+        // 1. tokens
+        if (tokensPath && fs.existsSync(tokensPath)) {
+            if (await confirm({
+                message: `Found tokens at ${path.relative(fileURLToPath(cwd), fileURLToPath(tokensPath))}. Overwrite with a new design system?`,
+            })) {
+                startFromDS = true;
+            }
+        }
+        else {
+            tokensPath = DEFAULT_TOKENS_PATH;
+        }
+        if (startFromDS) {
+            const ds = DESIGN_SYSTEMS[(await select({
+                message: 'Start from existing design system?',
+                options: [
+                    ...Object.entries(DESIGN_SYSTEMS).map(([id, { author, name }]) => ({
+                        value: id,
+                        label: `${author} ${name}`,
+                    })),
+                    { value: 'none', label: 'None' },
+                ],
+            }))];
+            if (ds) {
+                // TODO: support multiple tokens files?
+                const s = spinner();
+                s.start('Downloading…');
+                const tokenSource = await fetch(new URL(ds.tokens[0], DTCG_ROOT_URL)).then((res) => res.text());
+                fs.writeFileSync(tokensPath, tokenSource);
+                s.stop('Download complete');
+            }
+        }
+        // 2. plugins
+        const existingPlugins = config.plugins.map((p) => p.name);
+        const pluginSelection = await multiselect({
+            message: 'Install plugins?',
+            options: [
+                { value: '@terrazzo/plugin-css', label: 'CSS' },
+                { value: '@terrazzo/plugin-js', label: 'JS + TS' },
+                { value: '@terrazzo/plugin-sass', label: 'Sass' },
+                { value: '@terrazzo/plugin-tailwind', label: 'Tailwind' },
+            ],
+            required: false,
+        });
+        const newPlugins = Array.isArray(pluginSelection)
+            ? pluginSelection.filter((p) => !existingPlugins.includes(p))
+            : [];
+        if (newPlugins?.length) {
+            const plugins = newPlugins.map((p) => ({ specifier: p.replace('@terrazzo/plugin-', ''), package: p }));
+            const pluginCount = `${newPlugins.length} ${pluralize(newPlugins.length, 'plugin', 'plugins')}`;
+            const s = spinner();
+            s.start(`Installing ${pluginCount}…`);
+            execSync([packageManager, INSTALL_COMMAND[packageManager], newPlugins.join(' ')].join(' '), {
+                cwd,
+                stdio: 'inherit',
+            });
+            s.message('Updating config');
+            if (configPath) {
+                const ast = parseModule(fs.readFileSync(configPath, 'utf8'));
+                const astExport = ast.body.find((node) => node.type === 'ExportDefaultDeclaration');
+                // 2a. add plugin imports
+                // note: this has the potential to duplicate plugins, but we tried our
+                // best to filter already, and this may be the user’s fault if they
+                // selected to install a plugin already installed. But also, this is
+                // easily-fixable, so let’s not waste too much time here (and possibly
+                // introduce bugs).
+                ast.body.push(...plugins.map((p) => ({
+                    type: 'ImportDeclaration',
+                    source: { type: 'Literal', value: p.package },
+                    specifiers: [{ type: 'ImportDefaultSpecifier', local: { type: 'Identifier', name: p.specifier } }],
+                    attributes: [],
+                })));
+                // 2b. add plugins to config.plugins
+                if (!astExport) {
+                    logger.error({ message: `SyntaxError: ${relConfigPath} does not have default export.` });
+                    return;
+                }
+                const astConfig = (astExport.declaration.type === 'CallExpression'
+                    ? // export default defineConfig({ ... })
+                        astExport.declaration.arguments[0]
+                    : // export default { ... }
+                        astExport.declaration);
+                if (astConfig.type !== 'ObjectExpression') {
+                    logger.error({ message: `Config: expected object default export, received ${astConfig.type}` });
+                    return;
+                }
+                const pluginsArray = astConfig.properties.find((property) => property.type === 'Property' && property.key.type === 'Identifier' && property.key.name === 'plugins')?.value;
+                const pluginsAst = plugins.map((p) => ({
+                    type: 'CallExpression',
+                    callee: {
+                        type: 'Identifier',
+                        name: p.specifier,
+                    },
+                    arguments: [],
+                }));
+                if (pluginsArray) {
+                    pluginsArray.elements.push(...pluginsAst);
+                }
+                else {
+                    astConfig.properties.push({
+                        type: 'Property',
+                        key: { type: 'Identifier', name: 'plugins' },
+                        value: { type: 'ArrayExpression', elements: pluginsAst },
+                        kind: 'init',
+                        computed: false,
+                        method: false,
+                        shorthand: false,
+                    });
+                }
+                // 2c. update new file (and we’ll probably format it wrong but hey)
+                fs.writeFileSync(configPath, generate(ast, {
+                    format: {
+                        indent: { style: '  ' },
+                        quotes: 'single',
+                        semicolons: true,
+                    },
+                }));
+            }
+            else {
+                // 2a. write new config file (easy)
+                fs.writeFileSync(DEFAULT_CONFIG_PATH, `import { defineConfig } from '@terrazzo/cli';
+${plugins.map((p) => `import ${p.specifier} from '${p.package}';`).join('\n')}
+export default defineConfig({
+  tokens: ['./tokens.json'],
+  plugins: [
+    ${plugins.map((p) => `${p.specifier}(),`).join('\n    ')}
+  ],
+  outdir: './dist/',
+  lint: {
+    /** @see https://terrazzo.app/docs/cli/lint */
+  },
+});`);
+            }
+            s.stop(`Installed ${pluginCount}`);
+        }
+        outro('⛋ Done! 🎉');
+    }
+    catch (err) {
+        printError(err.message);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

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

package/dist/shared.d.ts

@@ -0,0 +1,47 @@
+import { type ConfigInit, type Logger } from '@terrazzo/parser';
+export declare const cwd: URL;
+export declare const DEFAULT_CONFIG_PATH: URL;
+export declare const DEFAULT_TOKENS_PATH: URL;
+export type Command = 'build' | 'check' | 'help' | 'init' | 'version';
+export declare const GREEN_CHECK: string;
+export interface Flags {
+    /** --config, -c */
+    config?: string;
+    /** --out, -o */
+    out?: string;
+    /** --help */
+    help?: boolean;
+    /** --watch, -w */
+    watch?: boolean;
+    /** --version */
+    version?: boolean;
+}
+export interface LoadConfigOptions {
+    cmd: Command;
+    flags: Flags;
+    logger: Logger;
+}
+/** Load config */
+export declare function loadConfig({ cmd, flags, logger }: LoadConfigOptions): Promise<{
+    config: ConfigInit;
+    configPath: string;
+}>;
+/** load tokens */
+export declare function loadTokens(tokenPaths: URL[], { logger }: {
+    logger: Logger;
+}): Promise<{
+    filename: URL;
+    src: string;
+}[] | undefined>;
+/** Print error */
+export declare function printError(message: string): void;
+/** Print success */
+export declare function printSuccess(message: string, startTime?: number): void;
+/** Resolve config */
+export declare function resolveConfig(filename?: string): string | undefined;
+/** Resolve tokens.json path (for lint command) */
+export declare function resolveTokenPath(filename: string, { logger }: {
+    logger: Logger;
+}): URL;
+/** Print time elapsed */
+export declare function time(start: number): string;

package/dist/shared.js

@@ -0,0 +1,184 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { defineConfig } from '@terrazzo/parser';
+import pc from 'picocolors';
+export const cwd = new URL(`file://${process.cwd()}/`);
+export const DEFAULT_CONFIG_PATH = new URL('./terrazzo.config.mjs', cwd);
+export const DEFAULT_TOKENS_PATH = new URL('./tokens.json', cwd);
+export const GREEN_CHECK = pc.green('✔');
+/** Load config */
+export async function loadConfig({ cmd, flags, logger }) {
+    try {
+        let config = {
+            tokens: [DEFAULT_TOKENS_PATH],
+            outDir: new URL('./tokens/', cwd),
+            plugins: [],
+            lint: { build: { enabled: true }, rules: {} },
+            ignore: { tokens: [], deprecated: false },
+        };
+        let configPath;
+        if (typeof flags.config === 'string') {
+            if (flags.config === '') {
+                logger.error({ message: 'Missing path after --config flag' });
+                process.exit(1);
+            }
+            configPath = resolveConfig(flags.config);
+        }
+        const resolvedConfigPath = resolveConfig(configPath);
+        if (resolvedConfigPath) {
+            try {
+                const mod = await import(resolvedConfigPath);
+                if (!mod.default) {
+                    logger.error({
+                        message: `No default export found in ${path.relative(cwd.href, resolvedConfigPath)}. See https://terrazzo.dev/docs/cli for instructions.`,
+                    });
+                }
+                config = defineConfig(mod.default, { cwd, logger });
+            }
+            catch (err) {
+                logger.error({ message: err.message || err });
+            }
+        }
+        else if (cmd !== 'init' && cmd !== 'check') {
+            logger.error({ message: 'No config file found. Create one with `npx terrazzo init`.' });
+        }
+        return { config, configPath: resolvedConfigPath };
+    }
+    catch (err) {
+        printError(err.message);
+        process.exit(1);
+    }
+}
+/** load tokens */
+export async function loadTokens(tokenPaths, { logger }) {
+    try {
+        const allTokens = [];
+        if (!Array.isArray(tokenPaths)) {
+            logger.error({ message: `loadTokens: Expected array, received ${typeof tokenPaths}` });
+        }
+        // if this is the default value, also check for tokens.yaml
+        if (tokenPaths.length === 1 && tokenPaths[0].href === DEFAULT_TOKENS_PATH.href) {
+            if (!fs.existsSync(tokenPaths[0])) {
+                const yamlPath = new URL('./tokens.yaml', cwd);
+                if (fs.existsSync(yamlPath)) {
+                    tokenPaths[0] = yamlPath;
+                }
+                else {
+                    logger.error({
+                        message: `Could not locate ${path.relative(cwd.href, tokenPaths[0].href)}. To create one, run \`npx tz init\`.`,
+                    });
+                    return;
+                }
+            }
+        }
+        // download/read
+        for (let i = 0; i < tokenPaths.length; i++) {
+            const filename = tokenPaths[i];
+            if (!(filename instanceof URL)) {
+                logger.error({ message: `Expected URL, received ${filename}`, label: `loadTokens[${i}]` });
+                return;
+            }
+            else if (filename.protocol === 'http:' || filename.protocol === 'https:') {
+                try {
+                    // if Figma URL
+                    if (filename.host === 'figma.com' || filename.host === 'www.figma.com') {
+                        const [_, fileKeyword, fileKey] = filename.pathname.split('/');
+                        if (fileKeyword !== 'file' || !fileKey) {
+                            logger.error({
+                                message: `Unexpected Figma URL. Expected "https://www.figma.com/file/:file_key/:file_name?…", received "${filename.href}"`,
+                            });
+                        }
+                        const headers = new Headers({
+                            Accept: '*/*',
+                            'User-Agent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:123.0) Gecko/20100101 Firefox/123.0',
+                        });
+                        if (process.env.FIGMA_ACCESS_TOKEN) {
+                            headers.set('X-FIGMA-TOKEN', process.env.FIGMA_ACCESS_TOKEN);
+                        }
+                        else {
+                            logger.warn({ message: 'FIGMA_ACCESS_TOKEN not set' });
+                        }
+                        const res = await fetch(`https://api.figma.com/v1/files/${fileKey}/variables/local`, {
+                            method: 'GET',
+                            headers,
+                        });
+                        if (res.ok) {
+                            allTokens.push({ filename, src: await res.text() });
+                        }
+                        const message = res.status !== 404 ? JSON.stringify(await res.json(), undefined, 2) : '';
+                        logger.error({ message: `Figma responded with ${res.status}${message ? `:\n${message}` : ''}` });
+                        break;
+                    }
+                    // otherwise, expect YAML/JSON
+                    const res = await fetch(filename, {
+                        method: 'GET',
+                        headers: { Accept: '*/*', 'User-Agent': 'Mozilla/5.0 Gecko/20100101 Firefox/123.0' },
+                    });
+                    allTokens.push({ filename, src: await res.text() });
+                }
+                catch (err) {
+                    logger.error({ message: `${filename.href}: ${err}` });
+                    return;
+                }
+            }
+            else {
+                if (fs.existsSync(filename)) {
+                    allTokens.push({ filename, src: fs.readFileSync(filename, 'utf8') });
+                }
+                else {
+                    logger.error({
+                        message: `Could not locate ${path.relative(cwd.href, filename.href)}. To create one, run \`npx tz init\`.`,
+                    });
+                    return;
+                }
+            }
+        }
+        return allTokens;
+    }
+    catch (err) {
+        printError(err.message);
+        process.exit(1);
+    }
+}
+/** Print error */
+export function printError(message) {
+    console.error(pc.red(`✗  ${message}`));
+}
+/** Print success */
+export function printSuccess(message, startTime) {
+    console.log(`${GREEN_CHECK}  ${message}${startTime ? ` ${time(startTime)}` : ''}`);
+}
+/** Resolve config */
+export function resolveConfig(filename) {
+    // --config [configpath]
+    if (filename) {
+        const configPath = new URL(filename, cwd);
+        if (fs.existsSync(configPath)) {
+            return configPath.href; // ⚠️ ESM wants "file://..." URLs on Windows & Unix.
+        }
+        return undefined;
+    }
+    // note: the order isn’t significant; just try for most-common first.
+    // if a user has multiple files differing only by file extension, behavior is
+    // unpredictable and that’s on them.
+    return ['.js', '.mjs', '.cjs']
+        .map((ext) => new URL(`./terrazzo.config${ext}`, cwd))
+        .find((configPath) => fs.existsSync(configPath))?.href; // ⚠️ ESM wants "file://..." URLs on Windows & Unix.;
+}
+/** Resolve tokens.json path (for lint command) */
+export function resolveTokenPath(filename, { logger }) {
+    const tokensPath = new URL(filename, cwd);
+    if (!fs.existsSync(tokensPath)) {
+        logger.error({ message: `Could not locate ${filename}. Does the file exist?` });
+    }
+    else if (!fs.statSync(tokensPath).isFile()) {
+        logger.error({ message: `Expected JSON or YAML file, received ${filename}.` });
+    }
+    return tokensPath;
+}
+/** Print time elapsed */
+export function time(start) {
+    const diff = performance.now() - start;
+    return pc.dim(diff < 750 ? `${Math.round(diff)}ms` : `${(diff / 1000).toFixed(1)}s`);
+}
+//# sourceMappingURL=shared.js.map

package/dist/shared.js.map

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

package/dist/version.d.ts

@@ -0,0 +1 @@
+export declare function versionCmd(): void;

package/dist/version.js

@@ -0,0 +1,6 @@
+import fs from 'node:fs';
+export function versionCmd() {
+    const { version } = JSON.parse(fs.readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
+    console.log(version);
+}
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,MAAM,UAAU,UAAU;IACxB,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IACrG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACvB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@terrazzo/cli",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "CLI for managing design tokens using the Design Tokens Community Group (DTCG) standard and generating code for any platform via plugins.",
   "type": "module",
   "author": {
@@ -40,16 +40,18 @@
     "terrazzo": "bin/cli.js"
   },
   "dependencies": {
+    "@clack/prompts": "^0.8.2",
+    "@types/escodegen": "^0.0.10",
     "chokidar": "^3.6.0",
+    "detect-package-manager": "^3.0.2",
     "dotenv": "^16.4.5",
+    "escodegen": "^2.1.0",
     "merge-anything": "^5.1.7",
+    "meriyah": "^6.0.3",
     "picocolors": "^1.1.1",
     "yaml-to-momoa": "^0.0.3",
-    "@terrazzo/parser": "^0.2.1",
-    "@terrazzo/token-tools": "^0.2.1"
-  },
-  "devDependencies": {
-    "typescript": "^5.7.2"
+    "@terrazzo/parser": "^0.2.3",
+    "@terrazzo/token-tools": "^0.2.3"
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",