@terrazzo/cli 2.0.0-beta.6 → 2.0.0-rc.0

package/CHANGELOG.md

@@ -77,9 +77,9 @@ The 2.0.0 release is full of new features:
 
 - [#568](https://github.com/terrazzoapp/terrazzo/pull/568) [`67c75be`](https://github.com/terrazzoapp/terrazzo/commit/67c75be78978cece52b61cf258ccc3a875e6af48) Thanks [@drwpow](https://github.com/drwpow)! - Fix border tokens not cascading correctly across modes
 
-- An error is now thrown if `--config [path]` points to a bad location.
+- Bugfix: An error is now thrown if `--config [path]` points to a bad location.
 
-- TypeScript config files now fully supported! `terrazzo.config.ts` is now the default.
+- Config: TypeScript files and plugins are now fully supported! `terrazzo.config.ts` is now the default.
 
 ## 0.10.3
 

package/bin/cli.js

@@ -32,12 +32,12 @@ import { Logger } from '@terrazzo/parser';
 import {
   buildCmd,
   checkCmd,
+  formatCmd,
   helpCmd,
   importCmd,
   initCmd,
   labCmd,
   loadConfig,
-  normalizeCmd,
   versionCmd,
 } from '../dist/index.js';
 
@@ -113,9 +113,9 @@ export default async function main() {
     process.exit(0);
   }
 
-  // normalize
-  if (cmd === 'normalize') {
-    await normalizeCmd(positionals[1], { logger, output: flags.output });
+  // format
+  if (cmd === 'format' || cmd === 'normalize') {
+    await formatCmd(positionals[1], { logger, output: flags.output });
     process.exit(0);
   }
   // import

package/dist/index.d.ts

@@ -93,6 +93,16 @@ declare function checkCmd({
   positionals
 }: CheckOptions): Promise<void>;
 //#endregion
+//#region src/format.d.ts
+interface NormalizeOptions {
+  logger: Logger;
+  output: URL;
+}
+declare function formatCmd(filename: string, {
+  logger,
+  output
+}: NormalizeOptions): Promise<void>;
+//#endregion
 //#region src/help.d.ts
 /** Show help */
 declare function helpCmd(): void;
@@ -165,21 +175,11 @@ declare function labCmd({
   logger
 }: LabBuildOptions): Promise<void>;
 //#endregion
-//#region src/normalize.d.ts
-interface NormalizeOptions {
-  logger: Logger;
-  output: URL;
-}
-declare function normalizeCmd(filename: string, {
-  logger,
-  output
-}: NormalizeOptions): Promise<void>;
-//#endregion
 //#region src/version.d.ts
 declare function versionCmd(): void;
 //#endregion
 //#region src/index.d.ts
 declare function defineConfig(config: Config): ConfigInit;
 //#endregion
-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 };
+export { BuildOptions, CheckOptions, Command, DEFAULT_CONFIG_PATH, DEFAULT_TOKENS_PATH, FigmaOutput, Flags, GREEN_CHECK, ImportCmdOptions, InitOptions, LabBuildOptions, LoadConfigOptions, NormalizeOptions, buildCmd, checkCmd, cwd, defineConfig, formatCmd, helpCmd, importCmd, importFromFigma, importFromFigmaOptions, initCmd, isFigmaPath, labCmd, loadConfig, loadTokens, 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/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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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/shared.ts","../src/build.ts","../src/check.ts","../src/format.ts","../src/help.ts","../src/import/figma/index.ts","../src/import/index.ts","../src/init.ts","../src/lab.ts","../src/version.ts","../src/index.ts"],"mappings":"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"}

package/dist/index.js

@@ -1,7 +1,7 @@
 import { createRequire } from "node:module";
+import fsSync from "node:fs";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { build, defineConfig as defineConfig$1, parse } from "@terrazzo/parser";
-import fs from "node:fs";
 import path from "node:path";
 import pc from "picocolors";
 import { createServer } from "vite";
@@ -9,8 +9,11 @@ import { ViteNodeRunner } from "vite-node/client";
 import { ViteNodeServer } from "vite-node/server";
 import chokidar from "chokidar";
 import yamlToMomoa from "yaml-to-momoa";
-import fs$1 from "node:fs/promises";
+import * as momoa from "@humanwhocodes/momoa";
+import { getObjMember, getObjMembers, traverse } from "@terrazzo/json-schema-tools";
 import { isAlias, pluralize } from "@terrazzo/token-tools";
+import yaml from "yaml";
+import fs from "node:fs/promises";
 import { merge } from "merge-anything";
 import { camelCase } from "scule";
 import { spawn } from "node:child_process";
@@ -21,8 +24,6 @@ import { parseModule } from "meriyah";
 import { Readable, Writable } from "node:stream";
 import { serve } from "@hono/node-server";
 import mime from "mime";
-import * as momoa from "@humanwhocodes/momoa";
-import { getObjMember, getObjMembers, traverse } from "@terrazzo/json-schema-tools";
 
 //#region src/shared.ts
 const cwd = new URL(`${pathToFileURL(process.cwd())}/`);
@@ -115,9 +116,9 @@ async function loadTokens(tokenPaths, { logger }) {
 			message: `loadTokens: Expected array, received ${typeof tokenPaths}`
 		});
 		if (tokenPaths.length === 1 && tokenPaths[0].href === DEFAULT_TOKENS_PATH.href) {
-			if (!fs.existsSync(tokenPaths[0])) {
+			if (!fsSync.existsSync(tokenPaths[0])) {
 				const yamlPath = new URL("./tokens.yaml", cwd);
-				if (fs.existsSync(yamlPath)) tokenPaths[0] = yamlPath;
+				if (fsSync.existsSync(yamlPath)) tokenPaths[0] = yamlPath;
 				else {
 					logger.error({
 						group: "config",
@@ -185,9 +186,9 @@ async function loadTokens(tokenPaths, { logger }) {
 				});
 				return;
 			}
-			else if (fs.existsSync(filename)) allTokens.push({
+			else if (fsSync.existsSync(filename)) allTokens.push({
 				filename,
-				src: fs.readFileSync(filename, "utf8")
+				src: fsSync.readFileSync(filename, "utf8")
 			});
 			else {
 				logger.error({
@@ -213,7 +214,7 @@ function printSuccess(message, startTime) {
 }
 /** Resolve config */
 function resolveConfig(filename) {
-	if (filename && fs.existsSync(new URL(filename, cwd))) return filename;
+	if (filename && fsSync.existsSync(new URL(filename, cwd))) return filename;
 	for (const ext of [
 		".ts",
 		".js",
@@ -223,17 +224,17 @@ function resolveConfig(filename) {
 		".cjs"
 	]) {
 		const maybeFilename = `terrazzo.config${ext}`;
-		if (fs.existsSync(new URL(maybeFilename, cwd))) return fileURLToPath(new URL(maybeFilename, cwd));
+		if (fsSync.existsSync(new URL(maybeFilename, cwd))) return fileURLToPath(new URL(maybeFilename, cwd));
 	}
 }
 /** Resolve tokens.json path (for lint command) */
 function resolveTokenPath(filename, { logger }) {
 	const tokensPath = new URL(filename, cwd);
-	if (!fs.existsSync(tokensPath)) logger.error({
+	if (!fsSync.existsSync(tokensPath)) logger.error({
 		group: "config",
 		message: `Could not locate ${filename}. Does the file exist?`
 	});
-	else if (!fs.statSync(tokensPath).isFile()) logger.error({
+	else if (!fsSync.statSync(tokensPath).isFile()) logger.error({
 		group: "config",
 		message: `Expected JSON or YAML file, received ${filename}.`
 	});
@@ -336,8 +337,8 @@ async function buildCmd({ config, configPath, flags, logger }) {
 function writeFiles(result, { config, logger }) {
 	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);
+		fsSync.mkdirSync(new URL(".", output), { recursive: true });
+		fsSync.writeFileSync(output, contents);
 		logger.debug({
 			group: "parser",
 			label: "buildEnd",
@@ -373,6 +374,125 @@ async function checkCmd({ config, logger, positionals }) {
 	}
 }
 
+//#endregion
+//#region src/format.ts
+function findMember(name) {
+	return function(member) {
+		return member.name.type === "String" && member.name.value === name;
+	};
+}
+async function formatCmd(filename, { logger, output }) {
+	try {
+		if (!filename) {
+			logger.error({
+				group: "config",
+				message: "Expected input: `tz format <tokens.json> -o output.json`"
+			});
+			return;
+		}
+		const sourceLoc = new URL(filename, cwd);
+		if (!fsSync.existsSync(sourceLoc)) logger.error({
+			group: "config",
+			message: `Couldn’t find ${path.relative(cwd.href, sourceLoc.href)}. Does it exist?`
+		});
+		const sourceData = fsSync.readFileSync(sourceLoc, "utf8");
+		const isYaml = filename.endsWith(".yml") || filename.endsWith(".yaml") || !sourceData.startsWith("{");
+		const document = isYaml ? yamlToMomoa(sourceData) : momoa.parse(sourceData, { mode: "jsonc" });
+		const { tokens } = await parse([{
+			src: sourceData,
+			filename: sourceLoc
+		}], {
+			config: defineConfig$1({ lint: { rules: {
+				"core/consistent-naming": "off",
+				"core/valid-color": "off",
+				"core/valid-dimension": "off",
+				"core/valid-duration": "off",
+				"core/valid-typography": "off"
+			} } }, { cwd }),
+			logger,
+			resolveAliases: false,
+			yamlToMomoa
+		});
+		traverse(document, { enter(node, _parent, nodePath) {
+			const token = tokens[nodePath.join(".")];
+			if (!token || token.aliasOf || node.type !== "Member" || node.value.type !== "Object") return;
+			const $valueI = node.value.members.findIndex(findMember("$value"));
+			switch (token.$type) {
+				case "color":
+					if (node.value.members[$valueI].value.type === "String") {
+						if (isAlias(node.value.members[$valueI].value.value)) return;
+						const hex = node.value.members[$valueI].value.value;
+						node.value.members[$valueI].value = momoa.parse(JSON.stringify({
+							...token.$value,
+							hex: hex.startsWith("#") ? hex.slice(0, 7) : void 0
+						})).body;
+						const $extensions = getObjMember(node.value, "$extensions");
+						if ($extensions?.type === "Object") {
+							const mode = getObjMember($extensions, "mode");
+							if (mode?.type === "Object") for (let i = 0; i < mode.members.length; i++) {
+								const modeName = mode.members[i].name.value;
+								const hex = mode.members[i].value.value;
+								mode.members[i].value = momoa.parse(JSON.stringify({
+									...token.mode[modeName].$value,
+									hex: hex.startsWith("#") ? hex.slice(0, 7) : void 0
+								})).body;
+							}
+						}
+					}
+					break;
+				case "dimension":
+				case "duration":
+					if (node.value.members[$valueI].value.type === "String") {
+						if (isAlias(node.value.members[$valueI].value.value)) return;
+						node.value.members[$valueI].value = formatDurationDimension(node.value.members[$valueI].value);
+						const $extensions = getObjMember(node.value, "$extensions");
+						if ($extensions?.type === "Object") {
+							const mode = getObjMember($extensions, "mode");
+							if (mode?.type === "Object") for (let i = 0; i < mode.members.length; i++) mode.members[i].value = formatDurationDimension(node.value.members[$valueI].value);
+						}
+					}
+					break;
+				case "typography": {
+					if (node.value.members[$valueI]?.value.type !== "Object") return;
+					node.value.members[$valueI].value = formatTypography(node.value.members[$valueI].value);
+					const $extensions = getObjMember(node.value, "$extensions");
+					if ($extensions?.type === "Object") {
+						const mode = getObjMember($extensions, "mode");
+						if (mode?.type === "Object") for (let i = 0; i < mode.members.length; i++) mode.members[i].value = formatTypography(mode.members[i].value);
+					}
+				}
+			}
+		} });
+		const outputLoc = new URL(output, cwd);
+		const contents = isYaml ? yaml.stringify(JSON.parse(momoa.print(document))) : momoa.print(document, { indent: 2 });
+		fsSync.mkdirSync(new URL(".", outputLoc), { recursive: true });
+		fsSync.writeFileSync(outputLoc, contents);
+	} catch (err) {
+		printError(err.message);
+		process.exit(1);
+	}
+}
+function formatDurationDimension(node) {
+	const value = Number.parseFloat(node.value);
+	if (!Number.isFinite(value)) return node;
+	node.type = "Object";
+	node.members = momoa.parse(JSON.stringify({
+		value,
+		unit: node.value.replace(String(value), "")
+	})).body.members;
+	delete node.value;
+	return node;
+}
+function formatTypography(node) {
+	const { fontFamily, fontSize, fontWeight, letterSpacing, lineHeight } = getObjMembers(node);
+	if (!fontFamily) node.members.push(momoa.parse("{\"fontFamily\":[\"inherit\"]}").body.members[0]);
+	if (!fontSize) node.members.push(momoa.parse("{\"fontSize\":{\"value\":1,\"unit\":\"rem\"}}").body.members[0]);
+	if (!fontWeight) node.members.push(momoa.parse("{\"fontWeight\":400}").body.members[0]);
+	if (!letterSpacing) node.members.push(momoa.parse("{\"letterSpacing\":{\"value\":0,\"unit\":\"rem\"}}").body.members[0]);
+	if (!lineHeight) node.members.push(momoa.parse("{\"lineHeight\":1}").body.members[0]);
+	return node;
+}
+
 //#endregion
 //#region src/help.ts
 /** Show help */
@@ -384,6 +504,9 @@ function helpCmd() {
       --no-lint      Disable linters running on build
     check [path]     Check tokens.json for errors and run linters
     lint [path]      (alias of check)
+    format [path]    Format your tokens
+      --o [file]     Output file
+    normalize        (alias of format)
     init             Create a starter tokens.json file
     lab              Manage your tokens with a web interface
     import [path]    Import from a Figma Design file
@@ -936,7 +1059,7 @@ async function importCmd({ flags, positionals, logger }) {
 		});
 		const end = performance.now() - start;
 		if (flags.output) {
-			const oldFile = fs.existsSync(flags.output) ? JSON.parse(await fs$1.readFile(flags.output, "utf8")) : {};
+			const oldFile = fsSync.existsSync(flags.output) ? JSON.parse(await fs.readFile(flags.output, "utf8")) : {};
 			const code = {
 				$schema: result.code.$schema,
 				version: result.code.version,
@@ -946,7 +1069,7 @@ async function importCmd({ flags, positionals, logger }) {
 				$defs: oldFile.$defs,
 				$extensions: oldFile.$extensions
 			};
-			await fs$1.writeFile(flags.output, `${JSON.stringify(code, void 0, 2)}\n`);
+			await fs.writeFile(flags.output, `${JSON.stringify(code, void 0, 2)}\n`);
 			logger.info({
 				group: "import",
 				message: `Imported ${formatNumber(result.variableCount)} ${pluralize(result.variableCount, "Variable", "Variables")}, ${formatNumber(result.styleCount)} ${pluralize(result.styleCount, "Style", "Styles")} → ${flags.output}`,
@@ -1018,9 +1141,9 @@ async function initCmd({ logger }) {
 			logger
 		});
 		const tokensPath = config.tokens[0];
-		const hasExistingConfig = fs.existsSync(configPath);
-		let startFromDS = !(tokensPath && fs.existsSync(tokensPath));
-		if (tokensPath && fs.existsSync(tokensPath)) {
+		const hasExistingConfig = fsSync.existsSync(configPath);
+		let startFromDS = !(tokensPath && fsSync.existsSync(tokensPath));
+		if (tokensPath && fsSync.existsSync(tokensPath)) {
 			if (await confirm({ message: `Found tokens at ${path.relative(fileURLToPath(cwd), fileURLToPath(tokensPath))}. Overwrite with a new design system?` })) startFromDS = true;
 		}
 		if (startFromDS) {
@@ -1049,7 +1172,7 @@ async function initCmd({ logger }) {
 		}
 		if (!hasExistingConfig) {
 			await newConfigFile(configPath, [EXAMPLE_TOKENS_PATH]);
-			await fs$1.writeFile(EXAMPLE_TOKENS_PATH, JSON.stringify(EXAMPLE_TOKENS, void 0, 2));
+			await fs.writeFile(EXAMPLE_TOKENS_PATH, JSON.stringify(EXAMPLE_TOKENS, void 0, 2));
 		}
 		const existingPlugins = config.plugins.map((p) => p.name);
 		const pluginSelection = await multiselect({
@@ -1103,7 +1226,7 @@ async function initCmd({ logger }) {
 	}
 }
 async function newConfigFile(configPath, tokens, imports = []) {
-	await fs$1.writeFile(configPath, `import { defineConfig } from '@terrazzo/cli';
+	await fs.writeFile(configPath, `import { defineConfig } from '@terrazzo/cli';
 ${imports.map((p) => `import ${p.specifier} from '${p.path}';`).join("\n")}
 
 export default defineConfig({
@@ -1150,7 +1273,7 @@ function getConfigObjFromAst(ast, configPath) {
 	return astConfig;
 }
 async function updateConfigTokens(configPath, tokens) {
-	const ast = parseModule(await fs$1.readFile(configPath, "utf8"));
+	const ast = parseModule(await fs.readFile(configPath, "utf8"));
 	const astConfig = getConfigObjFromAst(ast, configPath);
 	let tokensKey = astConfig.properties.find((p) => p.type === "Property" && p.key.type === "Identifier" && p.key.name === "tokens");
 	if (!tokensKey) {
@@ -1174,7 +1297,7 @@ async function updateConfigTokens(configPath, tokens) {
 		};
 		astConfig.properties.unshift(tokensKey);
 	}
-	await fs$1.writeFile(configPath, generate(ast, SYNTAX_SETTINGS));
+	await fs.writeFile(configPath, generate(ast, SYNTAX_SETTINGS));
 }
 /**
 * Add plugin imports
@@ -1185,7 +1308,7 @@ async function updateConfigTokens(configPath, tokens) {
 * introduce bugs).
 */
 async function updateConfigPlugins(configPath, plugins) {
-	const ast = parseModule(await fs$1.readFile(configPath, "utf8"));
+	const ast = parseModule(await fs.readFile(configPath, "utf8"));
 	ast.body.push(...plugins.map((p) => ({
 		type: "ImportDeclaration",
 		source: {
@@ -1228,7 +1351,7 @@ async function updateConfigPlugins(configPath, plugins) {
 		method: false,
 		shorthand: false
 	});
-	await fs$1.writeFile(configPath, generate(ast, SYNTAX_SETTINGS));
+	await fs.writeFile(configPath, generate(ast, SYNTAX_SETTINGS));
 }
 const EXAMPLE_TOKENS = {
 	color: {
@@ -1418,7 +1541,7 @@ async function labCmd({ config, logger }) {
 	/** TODO: handle multiple files */
 	const [tokenFileUrl] = config.tokens;
 	const staticFiles = /* @__PURE__ */ new Set();
-	const dirEntries = await fs$1.readdir(fileURLToPath(import.meta.resolve("./lab")), {
+	const dirEntries = await fs.readdir(fileURLToPath(import.meta.resolve("./lab")), {
 		withFileTypes: true,
 		recursive: true
 	});
@@ -1432,18 +1555,18 @@ async function labCmd({ config, logger }) {
 		overrideGlobalObjects: false,
 		async fetch(request) {
 			const pathname = new URL(request.url).pathname;
-			if (pathname === "/") return new Response(Readable.toWeb(fs.createReadStream(fileURLToPath(import.meta.resolve("./lab/index.html")))), { headers: { "Content-Type": "text/html" } });
+			if (pathname === "/") return new Response(Readable.toWeb(fsSync.createReadStream(fileURLToPath(import.meta.resolve("./lab/index.html")))), { headers: { "Content-Type": "text/html" } });
 			if (pathname === "/api/tokens") {
-				if (request.method === "GET") return new Response(Readable.toWeb(fs.createReadStream(tokenFileUrl)), { headers: {
+				if (request.method === "GET") return new Response(Readable.toWeb(fsSync.createReadStream(tokenFileUrl)), { headers: {
 					"Content-Type": "application/json",
 					"Cache-Control": "no-cache"
 				} });
 				else if (request.method === "POST" && request.body) {
-					await request.body.pipeTo(Writable.toWeb(fs.createWriteStream(tokenFileUrl)));
+					await request.body.pipeTo(Writable.toWeb(fsSync.createWriteStream(tokenFileUrl)));
 					return new Response(JSON.stringify({ success: true }), { headers: { "Content-Type": "application/json" } });
 				}
 			}
-			if (staticFiles.has(pathname)) return new Response(Readable.toWeb(fs.createReadStream(fileURLToPath(import.meta.resolve(`./lab${pathname}`)))), { headers: { "Content-Type": mime.getType(pathname) ?? "application/octet-stream" } });
+			if (staticFiles.has(pathname)) return new Response(Readable.toWeb(fsSync.createReadStream(fileURLToPath(import.meta.resolve(`./lab${pathname}`)))), { headers: { "Content-Type": mime.getType(pathname) ?? "application/octet-stream" } });
 			return new Response("Not found", { status: 404 });
 		}
 	}, (info) => {
@@ -1461,124 +1584,10 @@ async function labCmd({ config, logger }) {
 	});
 }
 
-//#endregion
-//#region src/normalize.ts
-function findMember(name) {
-	return function(member) {
-		return member.name.type === "String" && member.name.value === name;
-	};
-}
-async function normalizeCmd(filename, { logger, output }) {
-	try {
-		if (!filename) {
-			logger.error({
-				group: "config",
-				message: "Expected input: `tz normalize <tokens.json> -o output.json`"
-			});
-			return;
-		}
-		const sourceLoc = new URL(filename, cwd);
-		if (!fs.existsSync(sourceLoc)) logger.error({
-			group: "config",
-			message: `Couldn’t find ${path.relative(cwd.href, sourceLoc.href)}. Does it exist?`
-		});
-		const sourceData = fs.readFileSync(sourceLoc, "utf8");
-		const document = momoa.parse(sourceData, { mode: "jsonc" });
-		const { tokens } = await parse([{
-			src: sourceData,
-			filename: sourceLoc
-		}], {
-			config: defineConfig$1({ lint: { rules: {
-				"core/valid-color": "off",
-				"core/valid-dimension": "off",
-				"core/valid-duration": "off",
-				"core/valid-typography": "off"
-			} } }, { cwd }),
-			logger
-		});
-		traverse(document, { enter(node, _parent, nodePath) {
-			const token = tokens[nodePath.join(".")];
-			if (!token || token.aliasOf || node.type !== "Member" || node.value.type !== "Object") return;
-			const $valueI = node.value.members.findIndex(findMember("$value"));
-			switch (token.$type) {
-				case "color":
-					if (node.value.members[$valueI].value.type === "String") {
-						if (isAlias(node.value.members[$valueI].value.value)) return;
-						const hex = node.value.members[$valueI].value.value;
-						node.value.members[$valueI].value = momoa.parse(JSON.stringify({
-							...token.$value,
-							hex: hex.startsWith("#") ? hex.slice(0, 7) : void 0
-						})).body;
-						const $extensions = getObjMember(node.value, "$extensions");
-						if ($extensions?.type === "Object") {
-							const mode = getObjMember($extensions, "mode");
-							if (mode?.type === "Object") for (let i = 0; i < mode.members.length; i++) {
-								const modeName = mode.members[i].name.value;
-								const hex = mode.members[i].value.value;
-								mode.members[i].value = momoa.parse(JSON.stringify({
-									...token.mode[modeName].$value,
-									hex: hex.startsWith("#") ? hex.slice(0, 7) : void 0
-								})).body;
-							}
-						}
-					}
-					break;
-				case "dimension":
-				case "duration":
-					if (node.value.members[$valueI].value.type === "String") {
-						if (isAlias(node.value.members[$valueI].value.value)) return;
-						node.value.members[$valueI].value = normalizeDurationDimension(node.value.members[$valueI].value);
-						const $extensions = getObjMember(node.value, "$extensions");
-						if ($extensions?.type === "Object") {
-							const mode = getObjMember($extensions, "mode");
-							if (mode?.type === "Object") for (let i = 0; i < mode.members.length; i++) mode.members[i].value = normalizeDurationDimension(node.value.members[$valueI].value);
-						}
-					}
-					break;
-				case "typography": {
-					if (node.value.members[$valueI]?.value.type !== "Object") return;
-					node.value.members[$valueI].value = normalizeTypography(node.value.members[$valueI].value);
-					const $extensions = getObjMember(node.value, "$extensions");
-					if ($extensions?.type === "Object") {
-						const mode = getObjMember($extensions, "mode");
-						if (mode?.type === "Object") for (let i = 0; i < mode.members.length; i++) mode.members[i].value = normalizeTypography(mode.members[i].value);
-					}
-				}
-			}
-		} });
-		const outputLoc = new URL(output, cwd);
-		fs.mkdirSync(new URL(".", outputLoc), { recursive: true });
-		fs.writeFileSync(outputLoc, momoa.print(document, { indent: 2 }));
-	} catch (err) {
-		printError(err.message);
-		process.exit(1);
-	}
-}
-function normalizeDurationDimension(node) {
-	const value = Number.parseFloat(node.value);
-	if (!Number.isFinite(value)) return node;
-	node.type = "Object";
-	node.members = momoa.parse(JSON.stringify({
-		value,
-		unit: node.value.replace(String(value), "")
-	})).body.members;
-	delete node.value;
-	return node;
-}
-function normalizeTypography(node) {
-	const { fontFamily, fontSize, fontWeight, letterSpacing, lineHeight } = getObjMembers(node);
-	if (!fontFamily) node.members.push(momoa.parse("{\"fontFamily\":[\"inherit\"]}").body.members[0]);
-	if (!fontSize) node.members.push(momoa.parse("{\"fontSize\":{\"value\":1,\"unit\":\"rem\"}}").body.members[0]);
-	if (!fontWeight) node.members.push(momoa.parse("{\"fontWeight\":400}").body.members[0]);
-	if (!letterSpacing) node.members.push(momoa.parse("{\"letterSpacing\":{\"value\":0,\"unit\":\"rem\"}}").body.members[0]);
-	if (!lineHeight) node.members.push(momoa.parse("{\"lineHeight\":1}").body.members[0]);
-	return node;
-}
-
 //#endregion
 //#region src/version.ts
 function versionCmd() {
-	const { version } = JSON.parse(fs.readFileSync(new URL("../package.json", import.meta.url), "utf8"));
+	const { version } = JSON.parse(fsSync.readFileSync(new URL("../package.json", import.meta.url), "utf8"));
 	console.log(version);
 }
 
@@ -1589,6 +1598,7 @@ function defineConfig(config) {
 	const normalizedConfig = { ...config };
 	if (typeof normalizedConfig.tokens === "string" || Array.isArray(normalizedConfig.tokens)) normalizedConfig.tokens = (Array.isArray(normalizedConfig.tokens) ? normalizedConfig.tokens : [normalizedConfig.tokens]).map((tokenPath) => {
 		if (tokenPath.startsWith(".") || /^(https?|file):\/\//i.test(tokenPath)) return tokenPath;
+		else if (fsSync.existsSync(new URL(tokenPath, cwd))) return new URL(tokenPath, cwd);
 		try {
 			return pathToFileURL(require.resolve(tokenPath));
 		} catch (err) {
@@ -1600,5 +1610,5 @@ function defineConfig(config) {
 }
 
 //#endregion
-export { DEFAULT_CONFIG_PATH, DEFAULT_TOKENS_PATH, GREEN_CHECK, buildCmd, checkCmd, cwd, defineConfig, helpCmd, importCmd, importFromFigma, initCmd, isFigmaPath, labCmd, loadConfig, loadTokens, normalizeCmd, printError, printSuccess, resolveConfig, resolveTokenPath, time, versionCmd, writeFiles };
+export { DEFAULT_CONFIG_PATH, DEFAULT_TOKENS_PATH, GREEN_CHECK, buildCmd, checkCmd, cwd, defineConfig, formatCmd, helpCmd, importCmd, importFromFigma, initCmd, isFigmaPath, labCmd, loadConfig, loadTokens, printError, printSuccess, resolveConfig, resolveTokenPath, time, versionCmd, writeFiles };
 //# sourceMappingURL=index.js.map