@terrazzo/cli 2.0.0-beta.3 → 2.0.0-beta.4

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ## 2.0.0
 
+The 2.0.0 release is full of new features:
+
+- Full support for the DTCG v2025.10 spec, including resolvers
+- New and improved [native Figma import](https://terrazzo.app/docs/guides/import-from-figma)
+- `@terrazzo/plugin-js` was reimagined as a resolver API to build your own token machine (server-side)
+- `@terrazzo/plugin-css-in-js` was added as the missing solution for type-safe JS to use in any CSS-in-JS library
+- And of course dozens of bugfixes and quality of life improvements
+
 ### Minor Changes
 
 - [#530](https://github.com/terrazzoapp/terrazzo/pull/530) [`370ed7b`](https://github.com/terrazzoapp/terrazzo/commit/370ed7b0f578a64824124145d7f4936536b37bb3) Thanks [@drwpow](https://github.com/drwpow)! - ⚠️ Breaking change; DTCG 2nd Editors draft format will throw errors by default. This means converting all colors and dimensions to the new object format.
@@ -48,7 +56,7 @@
   - Typography
 
   These behaviors may be opted out individually by adjusting the new lint rules ([see documentation](https://terrazzo.app/cli/linting/)).
-  
+
 - [#589](https://github.com/terrazzoapp/terrazzo/pull/589) [`8f32d44`](https://github.com/terrazzoapp/terrazzo/commit/8f32d44792bba62194e674c9b60cfdeb366c96c7) Thanks [@michaelurban](https://github.com/michaelurban)! - feat: add typography shorthand, improve Sass plugin
 
 ### Patch Changes

package/bin/cli.js

@@ -29,7 +29,17 @@ import { createRequire } from 'node:module';
 import { parseArgs } from 'node:util';
 import { Logger } from '@terrazzo/parser';
 import dotenv from 'dotenv';
-import { buildCmd, checkCmd, helpCmd, initCmd, labCmd, loadConfig, normalizeCmd, versionCmd } from '../dist/index.js';
+import {
+  buildCmd,
+  checkCmd,
+  helpCmd,
+  importCmd,
+  initCmd,
+  labCmd,
+  loadConfig,
+  normalizeCmd,
+  versionCmd,
+} from '../dist/index.js';
 
 const require = createRequire(process.cwd());
 
@@ -44,13 +54,18 @@ const { values: flags, positionals } = parseArgs({
   allowPositionals: true,
   options: {
     config: { type: 'string', short: 'c' },
-    out: { type: 'string', short: 'o' },
-    output: { type: 'string' },
+    output: { 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' },
+    unpublished: { type: 'boolean' },
+    'skip-styles': { type: 'boolean' },
+    'skip-variables': { type: 'boolean' },
+    'font-family-names': { type: 'string' },
+    'font-weight-names': { type: 'string' },
+    'number-names': { type: 'string' },
   },
 });
 
@@ -96,7 +111,12 @@ export default async function main() {
 
   // normalize
   if (cmd === 'normalize') {
-    await normalizeCmd(positionals[1], { logger, output: flags.out ?? flags.output });
+    await normalizeCmd(positionals[1], { logger, output: flags.output });
+    process.exit(0);
+  }
+  // import
+  if (cmd === 'import') {
+    await importCmd({ flags, logger, positionals });
     process.exit(0);
   }
 
@@ -118,6 +138,7 @@ export default async function main() {
       await initCmd({ config, flags, logger });
       break;
     }
+
     case 'lab': {
       try {
         require.resolve('@terrazzo/token-lab');

package/dist/index.d.ts

@@ -97,6 +97,54 @@ declare function checkCmd({
 /** Show help */
 declare function helpCmd(): void;
 //#endregion
+//#region src/import/figma/index.d.ts
+interface importFromFigmaOptions {
+  url: string;
+  logger: Logger;
+  /** Grab unpublished Styles/Variables @default false */
+  unpublished?: boolean;
+  skipStyles?: boolean;
+  skipVariables?: boolean;
+  /** RegEx for overriding Variable types with fontFamily tokens */
+  fontFamilyNames?: string;
+  /** RegEx for overriding Variable types with fontWeight tokens */
+  fontWeightNames?: string;
+  /** RegEx for overriding Variable types with number tokens */
+  numberNames?: string;
+}
+interface FigmaOutput {
+  variableCount: number;
+  styleCount: number;
+  /** The Resolver JSON, in object format (could be any shape) */
+  code: Record<string, any>;
+}
+declare function importFromFigma({
+  url,
+  logger,
+  unpublished,
+  skipStyles,
+  skipVariables,
+  fontFamilyNames,
+  fontWeightNames,
+  numberNames
+}: importFromFigmaOptions): Promise<FigmaOutput>;
+/** Is this a valid URL, and one belonging to a Figma file? */
+declare function isFigmaPath(url: string): boolean;
+//#endregion
+//#region src/import/index.d.ts
+interface ImportCmdOptions {
+  flags: {
+    /** The output file @default stdout */output?: string;
+  } & Record<string, any>;
+  positionals: string[];
+  logger: Logger;
+}
+declare function importCmd({
+  flags,
+  positionals,
+  logger
+}: ImportCmdOptions): Promise<void>;
+//#endregion
 //#region src/init.d.ts
 interface InitOptions {
   logger: Logger;
@@ -133,5 +181,5 @@ declare function versionCmd(): void;
 //#region src/index.d.ts
 declare function defineConfig(config: Config): ConfigInit;
 //#endregion
-export { BuildOptions, CheckOptions, Command, DEFAULT_CONFIG_PATH, DEFAULT_TOKENS_PATH, Flags, GREEN_CHECK, InitOptions, LabBuildOptions, LoadConfigOptions, NormalizeOptions, buildCmd, checkCmd, cwd, defineConfig, helpCmd, initCmd, labCmd, loadConfig, loadTokens, normalizeCmd, printError, printSuccess, resolveConfig, resolveTokenPath, time, versionCmd, writeFiles };
+export { BuildOptions, CheckOptions, Command, DEFAULT_CONFIG_PATH, DEFAULT_TOKENS_PATH, FigmaOutput, Flags, GREEN_CHECK, ImportCmdOptions, InitOptions, LabBuildOptions, LoadConfigOptions, NormalizeOptions, buildCmd, checkCmd, cwd, defineConfig, helpCmd, importCmd, importFromFigma, importFromFigmaOptions, initCmd, isFigmaPath, labCmd, loadConfig, loadTokens, normalizeCmd, printError, printSuccess, resolveConfig, resolveTokenPath, time, versionCmd, writeFiles };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/shared.ts","../src/build.ts","../src/check.ts","../src/help.ts","../src/init.ts","../src/lab.ts","../src/normalize.ts","../src/version.ts","../src/index.ts"],"mappings":";;;cASa,GAAA,EAAG,GAAA;AAAA,cACH,mBAAA,EAAmB,GAAA;AAAA,cACnB,mBAAA,EAAmB,GAAA;AAAA,KAEpB,OAAA;AAAA,cAEC,WAAA;AAAA,UAEI,KAAA;EAR6C;EAU5D,MAAA;EATqE;EAWrE,GAAA;EAX8B;EAa9B,IAAA;EAZW;EAcX,KAAA;;EAEA,OAAA;AAAA;AAAA,UAGe,iBAAA;EACf,GAAA,EAAK,OAAA;EACL,KAAA,EAAO,KAAA;EACP,MAAA,EAAQ,MAAA;AAAA;AAlBV;AAAA,iBAsBsB,UAAA,CAAA;EAAa,GAAA;EAAK,KAAA;EAAO;AAAA,GAAU,iBAAA,GAAiB,OAAA;;;;AApB1E;AAAA,iBA2GsB,UAAA,CAAW,UAAA,EAAY,GAAA;EAAS;AAAA;EAAY,MAAA,EAAQ,MAAA;AAAA,IAAQ,OAAA;;;;;iBAiGlE,UAAA,CAAW,OAAA;;iBAKX,YAAA,CAAa,OAAA,UAAiB,SAAA;AApM9C;AAAA,iBAyMgB,aAAA,CAAc,QAAA;;iBAgBd,gBAAA,CAAiB,QAAA;EAAoB;AAAA;EAAY,MAAA,EAAQ,MAAA;AAAA,IAAQ,GAAA;;iBAWjE,IAAA,CAAK,KAAA;;;UChPJ,YAAA;EACf,KAAA,EAAO,KAAA;EACP,MAAA,EAAQ,UAAA;EACR,UAAA;EACA,MAAA,EAAQ,MAAA;AAAA;ADZV;AAAA,iBCgBsB,QAAA,CAAA;EAAW,MAAA;EAAQ,UAAA;EAAY,KAAA;EAAO;AAAA,GAAU,YAAA,GAAY,OAAA;;iBAoFlE,UAAA,CAAW,MAAA,EAAQ,iBAAA;EAAqB,MAAA;EAAQ;AAAA;EAAY,MAAA,EAAQ,UAAA;EAAY,MAAA,EAAQ,MAAA;AAAA;;;UC1GvF,YAAA;;EAEf,WAAA;EACA,MAAA,EAAQ,UAAA;EACR,MAAA,EAAQ,MAAA;AAAA;;iBAIY,QAAA,CAAA;EAAW,MAAA;EAAQ,MAAA;EAAQ;AAAA,GAAe,YAAA,GAAY,OAAA;;;;iBCX5D,OAAA,CAAA;;;UCoFC,WAAA;EACf,MAAA,EAAQ,MAAA;AAAA;AAAA,iBAGY,OAAA,CAAA;EAAU;AAAA,GAAU,WAAA,GAAW,OAAA;;;UChFpC,eAAA;EACf,KAAA,EAAO,KAAA;EACP,MAAA,EAAQ,UAAA;EACR,UAAA;EACA,MAAA,EAAQ,MAAA;AAAA;AAAA,iBAGY,MAAA,CAAA;EAAS,MAAA;EAAQ;AAAA,GAAU,eAAA,GAAe,OAAA;;;UCR/C,gBAAA;EACf,MAAA,EAAQ,MAAA;EACR,MAAA,EAAQ,GAAA;AAAA;AAAA,iBASY,YAAA,CAAa,QAAA;EAAoB,MAAA;EAAQ;AAAA,GAAU,gBAAA,GAAgB,OAAA;;;iBCjBzE,UAAA,CAAA;;;iBCeA,YAAA,CAAa,MAAA,EAAQ,MAAA,GAAS,UAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/shared.ts","../src/build.ts","../src/check.ts","../src/help.ts","../src/import/figma/index.ts","../src/import/index.ts","../src/init.ts","../src/lab.ts","../src/normalize.ts","../src/version.ts","../src/index.ts"],"mappings":"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"}