@digdir/designsystemet 0.0.0-chore-remove-cli-tsx-20260701060359

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2024 Digitaliseringsdirektoratet (Digdir)
+
+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/README.md

@@ -0,0 +1,104 @@
+# @digdir/designsystemet
+
+CLI and tooling for Designsystemet
+
+Use `--help` for available commands and options
+
+Read the Designsystemet [README](https://github.com/digdir/designsystemet) to get started.
+
+
+## Usage
+
+### Create tokens
+
+Use `npx @digdir/designsystemet tokens create <options>` to create design tokens for use with Designsystemet.
+
+This allows you to define themes including custom colors, font-family, and border-radius.
+We recommend using the [Designsystemet theme builder](https://theme.designsystemet.no/) for generating a valid config.
+
+#### Update tokens
+
+Whenever a new version of the CLI is released, or you have done changes, we recommend to update design tokens with the `--clean` option to potentially remove any changes deprecated files or unneeded files.
+
+To update design tokens, re-run `npx @digdir/designsystemet tokens create <options> --clean`. 
+If a [config file](#using-a-config-file) you can also re-run with `"clean": true`.
+
+> ⚠️ **WARNING** ⚠️  
+> The design tokens created by this tool are considered an implementation detail, and is subject
+> to change at any time without being considered a breaking change. We **only** support customisations
+> done through the CLI options and config. Direct editing of the design tokens are **not** supported.
+> 
+> Since tokens may be added or removed at any time, it is necessary to routinely re-run this
+> command when upgrading the libraries. This will remove any direct edits to the design tokens.
+
+### Build CSS from tokens
+
+Use `npx @digdir/designsystemet tokens build <options>` to build CSS from design tokens generated in the previous step.
+
+> ⚠️ **WARNING** ⚠️  
+> The CSS files from created by this tool are considered build artifacts. They should **not** be
+> edited directly. While the CSS will not change unexpectedly, new variables may be added at any
+> time. Therefore, it is necessary to routinely re-run this command when upgrading the libraries.
+> This will remove any direct edits to the CSS.
+
+#### Update built CSS
+
+Whenever a new version of the CLI is released, or you have done changes, we recommend to build a new set of CSS from design tokens with the `--clean` option to potentially remove any changes deprecated files or unneeded files.
+
+
+### Using a config file
+
+> ⚠️ **WARNING** ⚠️  
+> The typography feature is experimental. The config schema may change at any time.
+
+
+The `tokens create` command supports a config file. It will auto-detect a `designsystemet.config.json` or `designsystemet.config.jsonc` file in the current directory. You can also use the `--config <path>` option to supply a different config name and location.
+
+Both `.json` and `.jsonc` files may contain comments and trailing commas (JSONC).
+
+The main advantage of using a config file is for automation in scenarios with multiple themes.
+
+To get started, use this template for a `designsystemet.config.json` file:
+
+```jsonc
+{
+  "$schema": "node_modules/@digdir/designsystemet/dist/config.schema.json",
+}
+```
+
+In editors which support JSON Schema, the `$schema` will then  give you editor hints for the structure of the file.
+
+#### Minimal config example
+```jsonc
+{
+  "$schema": "./node_modules/@digdir/designsystemet/dist/config.schema.json",
+  "outDir": "../path/to/design-tokens",
+  "themes": {
+    "theme": {
+      "colors": {
+        "accent": "#1E98F5",
+        "neutral": "#1E2B3C",
+      },
+      "borderRadius": 4
+    }
+  }
+}
+```
+To generate new design tokens and CSS files, you would then run.
+
+```
+npx @digdir/designsystemet tokens create
+npx @digdir/designsystemet tokens build
+```
+
+#### Complex config example
+
+Have a look at the `*.config.json` files under the `packages/cli` in the Github repo for more complex examples.
+
+#### Create config from existing tokens
+
+You can get a minimal config file, meaning without overrides, generated from existing design tokens using the following command:
+
+```sh
+npx @digdir/designsystemet generate-config-from-tokens --dir <path to design tokens>
+```

package/dist/bin/config.d.ts

@@ -0,0 +1,14 @@
+import { CreateConfigSchema } from "../src/schemas/v1.1/schema.js";
+import { deprecatedCLIOptions } from "../src/schemas/helpers.js";
+import { Command, OptionValues } from "@commander-js/extra-typings";
+
+//#region bin/config.d.ts
+declare function readConfigFile(configFilePath: string, allowFileNotFound?: boolean): Promise<string>;
+declare function parseCreateConfig(configFile: string, options: {
+  theme: string;
+  cmd: Command<unknown[], OptionValues>;
+  configFilePath: string;
+}): Promise<CreateConfigSchema>;
+//#endregion
+export { deprecatedCLIOptions, parseCreateConfig, readConfigFile };
+//# sourceMappingURL=config.d.ts.map

package/dist/bin/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","names":[],"sources":["../../bin/config.ts"],"mappings":";;;;;iBAUsB,cAAA,CAAe,cAAA,UAAwB,iBAAA,aAA2B,OAAO;AAAA,iBAoBzE,iBAAA,CACpB,UAAA,UACA,OAAA;EAAW,KAAA;EAAe,GAAA,EAAK,OAAA,YAAmB,YAAA;EAAe,cAAA;AAAA,IAChE,OAAA,CAAQ,kBAAA"}

package/dist/bin/config.js

@@ -0,0 +1,58 @@
+import { deprecatedCLIOptions, parseConfig, validateConfig } from "../src/schemas/helpers.js";
+import { configFileCreateSchema } from "../src/schemas/v1.1/schema.js";
+import { dsfs } from "../src/utils/filesystem.js";
+import { getCliOption, getDefaultCliOption, getSuppliedCliOption } from "./options.js";
+import pc from "picocolors";
+import * as R from "ramda";
+//#region bin/config.ts
+async function readConfigFile(configFilePath, allowFileNotFound = true) {
+	let configFile;
+	try {
+		configFile = await dsfs.readFile(configFilePath, allowFileNotFound);
+	} catch (err) {
+		if (allowFileNotFound) return "";
+		console.error(pc.redBright(`Could not read config file at ${pc.blue(configFilePath)}`));
+		throw err;
+	}
+	if (configFile) console.log(`Found config file: ${pc.green(configFilePath)}`);
+	return configFile;
+}
+async function parseCreateConfig(configFile, options) {
+	const { cmd, theme = "theme", configFilePath } = options;
+	const configParsed = parseConfig(configFile, configFilePath);
+	const themeColors = Object.values(configParsed?.themes ?? {}).map((x) => new Set(R.keys(x.colors)));
+	if (!R.all(R.equals(R.__, themeColors[0]), themeColors)) {
+		console.error(pc.redBright(`In config, all themes must have the same custom color names, but we found:`));
+		const themeNames = R.keys(configParsed.themes ?? {});
+		themeColors.forEach((colors, index) => {
+			const colorNames = Array.from(colors);
+			console.log(`  - ${themeNames[index]}: ${colorNames.join(", ")}`);
+		});
+		console.log();
+		process.exit(1);
+	}
+	const noUndefined = R.reject(R.isNil);
+	const getThemeOptions = (optionGetter) => noUndefined({
+		colors: noUndefined({
+			...optionGetter(cmd, "mainColors"),
+			...optionGetter(cmd, "supportColors"),
+			neutral: optionGetter(cmd, "neutralColor")
+		}),
+		typography: noUndefined({ fontFamily: optionGetter(cmd, "fontFamily") }),
+		borderRadius: optionGetter(cmd, "borderRadius"),
+		defaultColor: optionGetter(cmd, "defaultColor")
+	});
+	return validateConfig(configFileCreateSchema, noUndefined({
+		outDir: configParsed?.outDir ?? getCliOption(cmd, "outDir"),
+		clean: configParsed?.clean ?? getCliOption(cmd, "clean"),
+		themes: configParsed?.themes ? R.map((jsonThemeValues) => {
+			const defaultThemeValues = getThemeOptions(getDefaultCliOption);
+			const cliThemeValues = getThemeOptions(getSuppliedCliOption);
+			return R.mergeDeepRight(defaultThemeValues, R.mergeDeepRight(jsonThemeValues, cliThemeValues));
+		}, configParsed.themes) : { [theme]: getThemeOptions(getCliOption) }
+	}), configFilePath);
+}
+//#endregion
+export { deprecatedCLIOptions, parseCreateConfig, readConfigFile };
+
+//# sourceMappingURL=config.js.map

package/dist/bin/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","names":[],"sources":["../../bin/config.ts"],"sourcesContent":["import type { Command, OptionValues } from '@commander-js/extra-typings';\nimport pc from 'picocolors';\nimport * as R from 'ramda';\nimport { parseConfig, validateConfig } from '../src/schemas/helpers.ts';\nimport { type CreateConfigSchema, configFileCreateSchema } from '../src/schemas/v1.1/schema.ts';\nimport { dsfs } from '../src/utils/filesystem.ts';\nimport { getCliOption, getDefaultCliOption, getSuppliedCliOption, type OptionGetter } from './options.ts';\n\nexport { deprecatedCLIOptions } from '../src/schemas/helpers.ts';\n\nexport async function readConfigFile(configFilePath: string, allowFileNotFound = true): Promise<string> {\n  let configFile: string;\n\n  try {\n    configFile = await dsfs.readFile(configFilePath, allowFileNotFound);\n  } catch (err) {\n    if (allowFileNotFound) {\n      return '';\n    }\n    console.error(pc.redBright(`Could not read config file at ${pc.blue(configFilePath)}`));\n    throw err;\n  }\n\n  if (configFile) {\n    console.log(`Found config file: ${pc.green(configFilePath)}`);\n  }\n\n  return configFile;\n}\n\nexport async function parseCreateConfig(\n  configFile: string,\n  options: { theme: string; cmd: Command<unknown[], OptionValues>; configFilePath: string },\n): Promise<CreateConfigSchema> {\n  const { cmd, theme = 'theme', configFilePath } = options;\n\n  const configParsed: CreateConfigSchema = parseConfig<CreateConfigSchema>(configFile, configFilePath);\n\n  /*\n   * Check that we're not creating multiple themes with different color names.\n   * For the themes' modes to work in Figma and when building css, the color names must be consistent\n   */\n  const themeColors = Object.values(configParsed?.themes ?? {}).map((x) => new Set(R.keys(x.colors)));\n  if (!R.all(R.equals(R.__, themeColors[0]), themeColors)) {\n    console.error(pc.redBright(`In config, all themes must have the same custom color names, but we found:`));\n    const themeNames = R.keys(configParsed.themes ?? {});\n    themeColors.forEach((colors, index) => {\n      const colorNames = Array.from(colors);\n      console.log(`  - ${themeNames[index]}: ${colorNames.join(', ')}`);\n    });\n    console.log();\n    process.exit(1);\n  }\n\n  /*\n   * Create final config from JSON config file and command-line options\n   */\n  const noUndefined = R.reject(R.isNil);\n\n  const getThemeOptions = (optionGetter: OptionGetter) =>\n    noUndefined({\n      colors: noUndefined({\n        ...(optionGetter(cmd, 'mainColors') as Record<string, string>),\n        ...(optionGetter(cmd, 'supportColors') as Record<string, string>),\n        neutral: optionGetter(cmd, 'neutralColor') as string,\n      }),\n      typography: noUndefined({\n        fontFamily: optionGetter(cmd, 'fontFamily'),\n      }),\n      borderRadius: optionGetter(cmd, 'borderRadius'),\n      defaultColor: optionGetter(cmd, 'defaultColor'),\n    });\n\n  const unvalidatedConfig = noUndefined({\n    outDir: configParsed?.outDir ?? getCliOption(cmd, 'outDir'),\n    clean: configParsed?.clean ?? getCliOption(cmd, 'clean'),\n    themes: configParsed?.themes\n      ? R.map((jsonThemeValues) => {\n          // For each theme specified in the JSON config, we resolve the option values in the following order:\n          // - default value\n          // - config value\n          // - CLI value\n          // With later values overriding earlier values\n          const defaultThemeValues = getThemeOptions(getDefaultCliOption);\n          const cliThemeValues = getThemeOptions(getSuppliedCliOption);\n          const mergedConfigs = R.mergeDeepRight(defaultThemeValues, R.mergeDeepRight(jsonThemeValues, cliThemeValues));\n          return mergedConfigs;\n        }, configParsed.themes)\n      : // If there are no themes specified in the JSON config, we use both explicit\n        // and default theme options from the CLI.\n        {\n          [theme]: getThemeOptions(getCliOption),\n        },\n  });\n\n  return validateConfig<CreateConfigSchema>(configFileCreateSchema, unvalidatedConfig, configFilePath);\n}\n"],"mappings":";;;;;;;AAUA,eAAsB,eAAe,gBAAwB,oBAAoB,MAAuB;CACtG,IAAI;CAEJ,IAAI;EACF,aAAa,MAAM,KAAK,SAAS,gBAAgB,iBAAiB;CACpE,SAAS,KAAK;EACZ,IAAI,mBACF,OAAO;EAET,QAAQ,MAAM,GAAG,UAAU,iCAAiC,GAAG,KAAK,cAAc,GAAG,CAAC;EACtF,MAAM;CACR;CAEA,IAAI,YACF,QAAQ,IAAI,sBAAsB,GAAG,MAAM,cAAc,GAAG;CAG9D,OAAO;AACT;AAEA,eAAsB,kBACpB,YACA,SAC6B;CAC7B,MAAM,EAAE,KAAK,QAAQ,SAAS,mBAAmB;CAEjD,MAAM,eAAmC,YAAgC,YAAY,cAAc;CAMnG,MAAM,cAAc,OAAO,OAAO,cAAc,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,IAAI,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;CAClG,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,YAAY,EAAE,GAAG,WAAW,GAAG;EACvD,QAAQ,MAAM,GAAG,UAAU,4EAA4E,CAAC;EACxG,MAAM,aAAa,EAAE,KAAK,aAAa,UAAU,CAAC,CAAC;EACnD,YAAY,SAAS,QAAQ,UAAU;GACrC,MAAM,aAAa,MAAM,KAAK,MAAM;GACpC,QAAQ,IAAI,OAAO,WAAW,OAAO,IAAI,WAAW,KAAK,IAAI,GAAG;EAClE,CAAC;EACD,QAAQ,IAAI;EACZ,QAAQ,KAAK,CAAC;CAChB;CAKA,MAAM,cAAc,EAAE,OAAO,EAAE,KAAK;CAEpC,MAAM,mBAAmB,iBACvB,YAAY;EACV,QAAQ,YAAY;GAClB,GAAI,aAAa,KAAK,YAAY;GAClC,GAAI,aAAa,KAAK,eAAe;GACrC,SAAS,aAAa,KAAK,cAAc;EAC3C,CAAC;EACD,YAAY,YAAY,EACtB,YAAY,aAAa,KAAK,YAAY,EAC5C,CAAC;EACD,cAAc,aAAa,KAAK,cAAc;EAC9C,cAAc,aAAa,KAAK,cAAc;CAChD,CAAC;CAwBH,OAAO,eAAmC,wBAtBhB,YAAY;EACpC,QAAQ,cAAc,UAAU,aAAa,KAAK,QAAQ;EAC1D,OAAO,cAAc,SAAS,aAAa,KAAK,OAAO;EACvD,QAAQ,cAAc,SAClB,EAAE,KAAK,oBAAoB;GAMzB,MAAM,qBAAqB,gBAAgB,mBAAmB;GAC9D,MAAM,iBAAiB,gBAAgB,oBAAoB;GAE3D,OADsB,EAAE,eAAe,oBAAoB,EAAE,eAAe,iBAAiB,cAAc,CACxF;EACrB,GAAG,aAAa,MAAM,IAGtB,GACG,QAAQ,gBAAgB,YAAY,EACvC;CACN,CAEkF,GAAG,cAAc;AACrG"}

package/dist/bin/designsystemet.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/bin/designsystemet.js

@@ -0,0 +1,174 @@
+#!/usr/bin/env node
+import { deprecatedCLIOptions } from "../src/schemas/helpers.js";
+import { convertToHex } from "../src/colors/utils.js";
+import "../src/colors/index.js";
+import { dsfs } from "../src/utils/filesystem.js";
+import { parseCreateConfig, readConfigFile } from "./config.js";
+import migrations_default from "../src/migrations/index.js";
+import { checkAutomigrate } from "../src/automigrate.js";
+import { toColorNames } from "../src/tokens/utils.js";
+import { buildTokens } from "../src/tokens/build.js";
+import { createSystemTokenFiles, tokenSetsToFiles } from "../src/tokens/create/files.js";
+import { createTokens, tokenSetDimensions } from "../src/tokens/create.js";
+import { generateConfigFromTokens } from "../src/tokens/generate-config.js";
+import pc from "picocolors";
+import * as R from "ramda";
+import path from "node:path";
+import { Argument, createCommand, program } from "@commander-js/extra-typings";
+//#region bin/designsystemet.ts
+const figletAscii = `
+ _____            _                           _                      _
+|  __ \\          (_)                         | |                    | |
+| |  | | ___  ___ _  __ _ _ __  ___ _   _ ___| |_ ___ _ __ ___   ___| |_
+| |  | |/ _ \\/ __| |/ _\` | '_ \\/ __| | | / __| __/ _ \\ '_ \` _ \\ / _ \\ __|
+| |__| |  __/\\__ \\ | (_| | | | \\__ \\ |_| \\__ \\ ||  __/ | | | | |  __/ |_
+|_____/ \\___||___/_|\\__, |_| |_|___/\\__, |___/\\__\\___|_| |_| |_|\\___|\\__|
+                     __/ |           __/ |
+                    |___/           |___/
+`;
+program.name("designsystemet").description("CLI for working with Designsystemet").showHelpAfterError();
+const DEFAULT_TOKENS_CREATE_DIR = "./design-tokens";
+const DEFAULT_TOKENS_BUILD_DIR = "./design-tokens-build";
+const DEFAULT_FONT = "Inter";
+const DEFAULT_THEME_NAME = "theme";
+const DEFAULT_CONFIG_FILEPATH = "designsystemet.config.json";
+const DEFAULT_CONFIG_FILEPATHS = ["designsystemet.config.json", "designsystemet.config.jsonc"];
+function _makeTokenCommands() {
+	const tokenCmd = createCommand("tokens");
+	tokenCmd.command("build").description("Build Designsystemet tokens").option("-t, --tokens <string>", `Path to ${pc.blue("design-tokens")}`, DEFAULT_TOKENS_CREATE_DIR).option("-o, --out-dir <string>", `Output directory for built ${pc.blue("design-tokens")}`, DEFAULT_TOKENS_BUILD_DIR).option(`--${deprecatedCLIOptions.clean} [boolean]`, "Clean output directory before building tokens", parseBoolean, false).option("--dry [boolean]", `Dry run for built ${pc.blue("design-tokens")}`, parseBoolean, false).option("--verbose", "Enable verbose output", false).option("--config <string>", `Path to config file (auto-detects ${DEFAULT_CONFIG_FILEPATHS.map((p) => `"${p}"`).join(" or ")})`).option("--experimental-tailwind", "Generate Tailwind CSS classes for tokens", false).action(async (opts) => {
+		console.log(figletAscii);
+		const { verbose, clean, dry, experimentalTailwind, tokens } = opts;
+		dsfs.init({
+			dry,
+			outdir: opts.outDir,
+			verbose
+		});
+		const outDir = dsfs.outDir;
+		if (clean) await dsfs.cleanDir(outDir);
+		const files = await buildTokens({
+			tokensDir: tokens,
+			verbose,
+			tailwind: experimentalTailwind
+		});
+		console.log(`\n💾 Writing build to ${pc.green(outDir)}`);
+		await dsfs.writeFiles(files, outDir, true);
+		console.log(`\n✅ Finished building tokens in ${pc.green(outDir)}`);
+		return Promise.resolve();
+	});
+	tokenCmd.command("create").description("Create Designsystemet tokens").option("--config <string>", `Path to config file (auto-detects ${DEFAULT_CONFIG_FILEPATHS.map((p) => `"${p}"`).join(" or ")})`).option(`--${deprecatedCLIOptions.clean} [boolean]`, "Clean output directory before creating tokens", parseBoolean, false).option("--dry [boolean]", `Dry run for created ${pc.blue("design-tokens")}`, parseBoolean, false).option("--skip-check", "Skip migration check", false).option("-y, --yes", "Skip user prompts", false).option(`-m, --${deprecatedCLIOptions.theme.colors.main} <name:hex...>`, `Main colors (deprecated, use JSON config file instead)`, parseColorValues).option(`-s, --${deprecatedCLIOptions.theme.colors.support} <name:hex...>`, `Support colors (deprecated, use JSON config file instead)`, parseColorValues).option(`-n, --${deprecatedCLIOptions.theme.colors.neutral} <hex>`, `Neutral hex color (deprecated, use JSON config file instead)`, convertToHex).option(`-o, --${deprecatedCLIOptions.outDir} <string>`, `Output directory for created ${pc.blue("design-tokens")}`, DEFAULT_TOKENS_CREATE_DIR).option(`-f, --${deprecatedCLIOptions.theme.typography.fontFamily} <string>`, `Font family (experimental, deprecated, use JSON config file instead)`, DEFAULT_FONT).option(`-b, --${deprecatedCLIOptions.theme.borderRadius} <number>`, `Unitless base border-radius in px (deprecated, use JSON config file instead)`, (radiusAsString) => Number(radiusAsString), 4).option("--theme <string>", "Theme name (deprecated, use JSON config file instead)", DEFAULT_THEME_NAME).action(async (opts, cmd) => {
+		if (opts.mainColors || opts.supportColors || opts.neutralColor || opts.borderRadius && opts.borderRadius !== 4 || opts.theme && opts.theme !== DEFAULT_THEME_NAME || opts.fontFamily && opts.fontFamily !== DEFAULT_FONT) console.warn(pc.yellow(`\n ⚠️  Using CLI options for ${pc.bold(`colors, border radius, theme, or font family is deprecated`)} and will be removed in a future release.
+           \n ⚠️  Please use a JSON config file instead.`));
+		console.log(figletAscii);
+		if (opts.dry) console.log(`Performing dry run, no files will be written`);
+		const themeName = opts.theme;
+		const { configFile, configFilePath } = await getConfigFile(opts.config);
+		const config = await parseCreateConfig((opts.skipCheck ? configFile : await checkAutomigrate(configFile, configFilePath, opts.yes)) || configFile, {
+			theme: themeName,
+			cmd,
+			configFilePath
+		});
+		const themeNames = Object.keys(config.themes);
+		if (themeNames.length > 0) console.log(`Using themes from config file: ${pc.blue(themeNames.join(", "))}`);
+		dsfs.init({
+			dry: opts.dry,
+			outdir: config.outDir
+		});
+		const outDir = dsfs.outDir;
+		const files = [];
+		const colorNames = toColorNames(config.themes?.[themeNames[0]]?.colors);
+		for (const [name, themeConfig] of Object.entries(config.themes)) {
+			const { tokenSets } = await createTokens({
+				name,
+				...themeConfig
+			});
+			files.push(...tokenSetsToFiles(tokenSets));
+		}
+		files.push(...await createSystemTokenFiles({
+			tokenSetDimensions,
+			themeNames,
+			colorNames
+		}));
+		if (config.clean) await dsfs.cleanDir(outDir);
+		await dsfs.mkdir(outDir);
+		await dsfs.writeFiles(files, outDir);
+		console.log(`\n✅ Finished creating tokens in ${pc.green(outDir)} for themes: ${pc.blue(themeNames.join(", "))}`);
+		return Promise.resolve();
+	});
+	return tokenCmd;
+}
+program.addCommand(_makeTokenCommands());
+program.command("generate-config-from-tokens").description("Generate a config file from existing design tokens. Will not include overrides.").option("-d, --dir <string>", "Path to design tokens directory", DEFAULT_TOKENS_CREATE_DIR).option("-o, --out <string>", "Output path for config file", DEFAULT_CONFIG_FILEPATH).option("--dry [boolean]", "Dry run - show config without writing file", parseBoolean, false).action(async (opts) => {
+	console.log(figletAscii);
+	const { dry } = opts;
+	const tokensDir = path.resolve(opts.dir);
+	const configFilePath = path.resolve(opts.out);
+	dsfs.init({
+		dry,
+		outdir: path.dirname(configFilePath)
+	});
+	try {
+		const config = await generateConfigFromTokens({
+			tokensDir,
+			outFile: configFilePath
+		});
+		if (dry) {
+			console.log();
+			console.log("Generated config (dry run):");
+			console.log(JSON.stringify(config, null, 2));
+		}
+		if (configFilePath) {
+			const configJson = JSON.stringify(config, null, 2);
+			await dsfs.writeFile(configFilePath, configJson);
+			console.log();
+			console.log(`\n✅ Config file written to ${pc.blue(configFilePath)}`);
+		}
+	} catch (error) {
+		console.error(pc.redBright("Error generating config:"));
+		console.error(error instanceof Error ? error.message : String(error));
+		process.exit(1);
+	}
+});
+program.command("migrate").description("run a Designsystemet migration").addArgument(new Argument("[migration]", "Available migrations").choices(Object.keys(migrations_default))).option("-l --list", "List available migrations").option("-g --glob <glob>", "Glob for files upon which to apply the migration", "./**/*.(tsx|css)").action((migrationKey, opts) => {
+	console.log(figletAscii);
+	const { glob, list } = opts;
+	if (list) for (const key of Object.keys(migrations_default)) console.log(key);
+	else if (migrationKey) {
+		const migration = migrations_default[migrationKey];
+		if (!migration) {
+			console.error("Migration not found!");
+			throw "Aborting";
+		}
+		console.log(`Applying migration ${pc.blue(migrationKey)} with glob: ${pc.green(glob)}`);
+		migration?.(glob).then(() => console.log(`Migration ${pc.blue(migrationKey)} finished`)).catch((error) => console.log(error));
+	} else console.log("Migrate: please specify a migration name or --list");
+});
+await program.parseAsync(process.argv);
+function parseColorValues(value, previous = {}) {
+	const [name, hex] = value.split(":");
+	previous[name] = convertToHex(hex);
+	return previous;
+}
+function parseBoolean(value) {
+	return value === "true" || value === true;
+}
+async function getConfigFile(userConfigFilePath) {
+	if (!R.isNil(userConfigFilePath)) return {
+		configFile: await readConfigFile(userConfigFilePath, DEFAULT_CONFIG_FILEPATHS.includes(userConfigFilePath)),
+		configFilePath: userConfigFilePath
+	};
+	for (const configFilePath of DEFAULT_CONFIG_FILEPATHS) {
+		const configFile = await readConfigFile(configFilePath, true);
+		if (configFile) return {
+			configFile,
+			configFilePath
+		};
+	}
+	return {
+		configFile: "",
+		configFilePath: DEFAULT_CONFIG_FILEPATH
+	};
+}
+//#endregion
+export {};
+
+//# sourceMappingURL=designsystemet.js.map

package/dist/bin/designsystemet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"designsystemet.js","names":["cliOptions","migrations"],"sources":["../../bin/designsystemet.ts"],"sourcesContent":["#!/usr/bin/env node\nimport path from 'node:path';\nimport { Argument, createCommand, program } from '@commander-js/extra-typings';\nimport pc from 'picocolors';\nimport * as R from 'ramda';\nimport { checkAutomigrate } from '../src/automigrate.ts';\nimport { convertToHex } from '../src/colors/index.ts';\nimport type { CssColor } from '../src/colors/types.ts';\nimport migrations from '../src/migrations/index.ts';\nimport { buildTokens } from '../src/tokens/build.ts';\nimport { createSystemTokenFiles, tokenSetsToFiles } from '../src/tokens/create/files.ts';\nimport { createTokens, tokenSetDimensions } from '../src/tokens/create.ts';\nimport { generateConfigFromTokens } from '../src/tokens/generate-config.ts';\nimport type { OutputFile, Theme } from '../src/tokens/types.ts';\nimport { toColorNames } from '../src/tokens/utils.ts';\nimport { dsfs } from '../src/utils/filesystem.ts';\nimport { deprecatedCLIOptions as cliOptions, parseCreateConfig, readConfigFile } from './config.ts';\n\nconst figletAscii = `\n _____            _                           _                      _\n|  __ \\\\          (_)                         | |                    | |\n| |  | | ___  ___ _  __ _ _ __  ___ _   _ ___| |_ ___ _ __ ___   ___| |_\n| |  | |/ _ \\\\/ __| |/ _\\` | '_ \\\\/ __| | | / __| __/ _ \\\\ '_ \\` _ \\\\ / _ \\\\ __|\n| |__| |  __/\\\\__ \\\\ | (_| | | | \\\\__ \\\\ |_| \\\\__ \\\\ ||  __/ | | | | |  __/ |_\n|_____/ \\\\___||___/_|\\\\__, |_| |_|___/\\\\__, |___/\\\\__\\\\___|_| |_| |_|\\\\___|\\\\__|\n                     __/ |           __/ |\n                    |___/           |___/\n`;\n\nprogram.name('designsystemet').description('CLI for working with Designsystemet').showHelpAfterError();\n\nconst DEFAULT_TOKENS_CREATE_DIR = './design-tokens';\nconst DEFAULT_TOKENS_BUILD_DIR = './design-tokens-build';\nconst DEFAULT_FONT = 'Inter';\nconst DEFAULT_THEME_NAME = 'theme';\nconst DEFAULT_CONFIG_FILEPATH = 'designsystemet.config.json';\n// Default config files to auto-detect when no --config is supplied, in order of precedence.\nconst DEFAULT_CONFIG_FILEPATHS = ['designsystemet.config.json', 'designsystemet.config.jsonc'];\n\nfunction _makeTokenCommands() {\n  const tokenCmd = createCommand('tokens');\n\n  tokenCmd\n    .command('build')\n    .description('Build Designsystemet tokens')\n    .option('-t, --tokens <string>', `Path to ${pc.blue('design-tokens')}`, DEFAULT_TOKENS_CREATE_DIR)\n    .option(\n      '-o, --out-dir <string>',\n      `Output directory for built ${pc.blue('design-tokens')}`,\n      DEFAULT_TOKENS_BUILD_DIR,\n    )\n    .option(`--${cliOptions.clean} [boolean]`, 'Clean output directory before building tokens', parseBoolean, false)\n    .option('--dry [boolean]', `Dry run for built ${pc.blue('design-tokens')}`, parseBoolean, false)\n    .option('--verbose', 'Enable verbose output', false)\n    .option(\n      '--config <string>',\n      `Path to config file (auto-detects ${DEFAULT_CONFIG_FILEPATHS.map((p) => `\"${p}\"`).join(' or ')})`,\n    )\n    .option('--experimental-tailwind', 'Generate Tailwind CSS classes for tokens', false)\n    .action(async (opts) => {\n      console.log(figletAscii);\n      const { verbose, clean, dry, experimentalTailwind, tokens } = opts;\n\n      // TODO - add outdir eqivalent to config option when parsing config, so that it can be set in the config file as well. buildDir?\n\n      dsfs.init({ dry, outdir: opts.outDir, verbose });\n\n      const outDir = dsfs.outDir;\n\n      if (clean) {\n        await dsfs.cleanDir(outDir);\n      }\n\n      const files = await buildTokens({\n        tokensDir: tokens,\n        verbose,\n        tailwind: experimentalTailwind,\n      });\n\n      console.log(`\\n💾 Writing build to ${pc.green(outDir)}`);\n\n      await dsfs.writeFiles(files, outDir, true);\n\n      console.log(`\\n✅ Finished building tokens in ${pc.green(outDir)}`);\n\n      return Promise.resolve();\n    });\n\n  tokenCmd\n    .command('create')\n    .description('Create Designsystemet tokens')\n    .option(\n      '--config <string>',\n      `Path to config file (auto-detects ${DEFAULT_CONFIG_FILEPATHS.map((p) => `\"${p}\"`).join(' or ')})`,\n    )\n    .option(`--${cliOptions.clean} [boolean]`, 'Clean output directory before creating tokens', parseBoolean, false)\n    .option('--dry [boolean]', `Dry run for created ${pc.blue('design-tokens')}`, parseBoolean, false)\n    .option('--skip-check', 'Skip migration check', false) // TODO -- will be moved to global option in the future, since it applies to all commands, not just create\n    .option('-y, --yes', 'Skip user prompts', false) // TODO -- will be moved to global option in the future, since it applies to all commands, not just create\n    /** Deprecated options */\n    .option(\n      `-m, --${cliOptions.theme.colors.main} <name:hex...>`,\n      `Main colors (deprecated, use JSON config file instead)`,\n      parseColorValues,\n    )\n    .option(\n      `-s, --${cliOptions.theme.colors.support} <name:hex...>`,\n      `Support colors (deprecated, use JSON config file instead)`,\n      parseColorValues,\n    )\n    .option(\n      `-n, --${cliOptions.theme.colors.neutral} <hex>`,\n      `Neutral hex color (deprecated, use JSON config file instead)`,\n      convertToHex,\n    )\n    .option(\n      `-o, --${cliOptions.outDir} <string>`,\n      `Output directory for created ${pc.blue('design-tokens')}`,\n      DEFAULT_TOKENS_CREATE_DIR,\n    )\n    .option(\n      `-f, --${cliOptions.theme.typography.fontFamily} <string>`,\n      `Font family (experimental, deprecated, use JSON config file instead)`,\n      DEFAULT_FONT,\n    )\n    .option(\n      `-b, --${cliOptions.theme.borderRadius} <number>`,\n      `Unitless base border-radius in px (deprecated, use JSON config file instead)`,\n      (radiusAsString) => Number(radiusAsString),\n      4,\n    )\n    .option('--theme <string>', 'Theme name (deprecated, use JSON config file instead)', DEFAULT_THEME_NAME)\n    .action(async (opts, cmd) => {\n      if (\n        opts.mainColors ||\n        opts.supportColors ||\n        opts.neutralColor ||\n        (opts.borderRadius && opts.borderRadius !== 4) ||\n        (opts.theme && opts.theme !== DEFAULT_THEME_NAME) ||\n        (opts.fontFamily && opts.fontFamily !== DEFAULT_FONT)\n      ) {\n        console.warn(\n          pc.yellow(`\\n ⚠️  Using CLI options for ${pc.bold(`colors, border radius, theme, or font family is deprecated`)} and will be removed in a future release.\n           \\n ⚠️  Please use a JSON config file instead.`),\n        );\n      }\n\n      console.log(figletAscii);\n      if (opts.dry) {\n        console.log(`Performing dry run, no files will be written`);\n      }\n      const themeName = opts.theme;\n\n      const { configFile, configFilePath } = await getConfigFile(opts.config);\n\n      const updatedConfigFile = opts.skipCheck\n        ? configFile\n        : await checkAutomigrate(configFile, configFilePath, opts.yes);\n\n      const config = await parseCreateConfig(updatedConfigFile || configFile, {\n        theme: themeName,\n        cmd,\n        configFilePath,\n      });\n\n      const themeNames = Object.keys(config.themes);\n      if (themeNames.length > 0) {\n        console.log(`Using themes from config file: ${pc.blue(themeNames.join(', '))}`);\n      }\n\n      dsfs.init({ dry: opts.dry, outdir: config.outDir });\n\n      const outDir = dsfs.outDir;\n\n      const files: OutputFile[] = [];\n\n      // Pick colors from first theme since we have a constraint they should be the same across themes.\n      const colorNames = toColorNames(config.themes?.[themeNames[0]]?.colors);\n\n      for (const [name, themeConfig] of Object.entries(config.themes)) {\n        const { tokenSets } = await createTokens({ name, ...themeConfig } as Theme);\n        files.push(...tokenSetsToFiles(tokenSets));\n      }\n\n      files.push(\n        ...(await createSystemTokenFiles({\n          tokenSetDimensions,\n          themeNames,\n          colorNames,\n        })),\n      );\n\n      if (config.clean) {\n        await dsfs.cleanDir(outDir);\n      }\n\n      await dsfs.mkdir(outDir);\n      await dsfs.writeFiles(files, outDir);\n\n      console.log(`\\n✅ Finished creating tokens in ${pc.green(outDir)} for themes: ${pc.blue(themeNames.join(', '))}`);\n\n      return Promise.resolve();\n    });\n\n  return tokenCmd;\n}\n\nprogram.addCommand(_makeTokenCommands());\n\nprogram\n  .command('generate-config-from-tokens')\n  .description('Generate a config file from existing design tokens. Will not include overrides.')\n  .option('-d, --dir <string>', 'Path to design tokens directory', DEFAULT_TOKENS_CREATE_DIR)\n  .option('-o, --out <string>', 'Output path for config file', DEFAULT_CONFIG_FILEPATH)\n  .option('--dry [boolean]', 'Dry run - show config without writing file', parseBoolean, false)\n  .action(async (opts) => {\n    console.log(figletAscii);\n    const { dry } = opts;\n    const tokensDir = path.resolve(opts.dir);\n    const configFilePath = path.resolve(opts.out);\n\n    dsfs.init({ dry, outdir: path.dirname(configFilePath) });\n\n    try {\n      const config = await generateConfigFromTokens({\n        tokensDir,\n        outFile: configFilePath,\n      });\n\n      if (dry) {\n        console.log();\n        console.log('Generated config (dry run):');\n        console.log(JSON.stringify(config, null, 2));\n      }\n\n      if (configFilePath) {\n        const configJson = JSON.stringify(config, null, 2);\n        await dsfs.writeFile(configFilePath, configJson);\n        console.log();\n        console.log(`\\n✅ Config file written to ${pc.blue(configFilePath)}`);\n      }\n    } catch (error) {\n      console.error(pc.redBright('Error generating config:'));\n      console.error(error instanceof Error ? error.message : String(error));\n      process.exit(1);\n    }\n  });\n\nprogram\n  .command('migrate')\n  .description('run a Designsystemet migration')\n  .addArgument(new Argument('[migration]', 'Available migrations').choices(Object.keys(migrations)))\n  .option('-l --list', 'List available migrations')\n  .option('-g --glob <glob>', 'Glob for files upon which to apply the migration', './**/*.(tsx|css)')\n  .action((migrationKey, opts) => {\n    console.log(figletAscii);\n    const { glob, list } = opts;\n\n    if (list) {\n      for (const key of Object.keys(migrations)) {\n        console.log(key);\n      }\n    } else if (migrationKey) {\n      const migration = migrations[migrationKey as keyof typeof migrations];\n      if (!migration) {\n        console.error('Migration not found!');\n        throw 'Aborting';\n      }\n\n      console.log(`Applying migration ${pc.blue(migrationKey)} with glob: ${pc.green(glob)}`);\n      migration?.(glob)\n        .then(() => console.log(`Migration ${pc.blue(migrationKey)} finished`))\n        .catch((error) => console.log(error));\n    } else {\n      console.log('Migrate: please specify a migration name or --list');\n    }\n  });\n\nawait program.parseAsync(process.argv);\n\nfunction parseColorValues(value: string, previous: Record<string, CssColor> = {}): Record<string, CssColor> {\n  const [name, hex] = value.split(':');\n  previous[name] = convertToHex(hex);\n  return previous;\n}\n\nfunction parseBoolean(value: string | boolean): boolean {\n  return value === 'true' || value === true;\n}\n\nasync function getConfigFile(userConfigFilePath: string | undefined) {\n  if (!R.isNil(userConfigFilePath)) {\n    // A config path was supplied explicitly. It's allowed to not exist only if it's one of the defaults.\n    const allowFileNotFound = DEFAULT_CONFIG_FILEPATHS.includes(userConfigFilePath);\n    const configFile = await readConfigFile(userConfigFilePath, allowFileNotFound);\n\n    return { configFile, configFilePath: userConfigFilePath };\n  }\n\n  // No config path supplied: auto-detect the default config files (.json, then .jsonc).\n  for (const configFilePath of DEFAULT_CONFIG_FILEPATHS) {\n    const configFile = await readConfigFile(configFilePath, true);\n    if (configFile) {\n      return { configFile, configFilePath };\n    }\n  }\n\n  // None found - return empty config using the canonical default path for messaging.\n  return { configFile: '', configFilePath: DEFAULT_CONFIG_FILEPATH };\n}\n"],"mappings":"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"}

package/dist/bin/options.d.ts

@@ -0,0 +1,24 @@
+import { Command, OptionValueSource, OptionValues } from "@commander-js/extra-typings";
+
+//#region bin/options.d.ts
+declare const getOptionIfMatchingSource: (...sources: OptionValueSource[]) => <Args extends unknown[], Opts extends OptionValues, K extends keyof Opts>(command: Command<Args, Opts>, option: K) => Opts[K] | undefined;
+type OptionGetter = ReturnType<typeof getOptionIfMatchingSource>;
+/**
+ * Get an option value if it is explicitly supplied to the CLI command.
+ * The difference between this and using the option directly is that we return undefined
+ * instead of the default value if the option was not explicitly set.
+ */
+declare const getSuppliedCliOption: <Args extends unknown[], Opts extends OptionValues, K extends keyof Opts>(command: Command<Args, Opts>, option: K) => Opts[K] | undefined;
+/**
+ * Get the default value specified for a CLI command option.
+ * Mostly useful for getting values which may later be overridden.
+ */
+declare const getDefaultCliOption: <Args extends unknown[], Opts extends OptionValues, K extends keyof Opts>(command: Command<Args, Opts>, option: K) => Opts[K] | undefined;
+/**
+ * Try to get the explicitly supplied CLI option, and fall back to the default value
+ * for the option as defined in the {@link Command}
+ */
+declare const getCliOption: <Args extends unknown[], Opts extends OptionValues, K extends keyof Opts>(command: Command<Args, Opts>, option: K) => Opts[K] | undefined;
+//#endregion
+export { OptionGetter, getCliOption, getDefaultCliOption, getSuppliedCliOption };
+//# sourceMappingURL=options.d.ts.map

package/dist/bin/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","names":[],"sources":["../../bin/options.ts"],"mappings":";;;cAEM,yBAAA,MACA,OAAA,EAAS,iBAAA,6CACyB,YAAA,kBAA8B,IAAA,EAClE,OAAA,EAAS,OAAA,CAAQ,IAAA,EAAM,IAAA,GACvB,MAAA,EAAQ,CAAA,KAAC,IAAA,CAAA,CAAA;AAAA,KAQD,YAAA,GAAe,UAAU,QAAQ,yBAAA;AAd+C;;;;;AAAA,cAqB/E,oBAAA,wCAjB2B,YAAA,kBAA8B,IAAA,EAAI,OAAA,EAC7D,OAAA,CAAQ,IAAA,EAAM,IAAA,GAAK,MAAA,EACpB,CAAA,KAAC,IAAA,CAAA,CAAA;;;;;cAqBA,mBAAA,wCAvB2B,YAAA,kBAA8B,IAAA,EAAI,OAAA,EAC7D,OAAA,CAAQ,IAAA,EAAM,IAAA,GAAK,MAAA,EACpB,CAAA,KAAC,IAAA,CAAA,CAAA;;;;;cA2BA,YAAA,wCA7B2B,YAAA,kBAA8B,IAAA,EAAI,OAAA,EAC7D,OAAA,CAAQ,IAAA,EAAM,IAAA,GAAK,MAAA,EACpB,CAAA,KAAC,IAAA,CAAA,CAAA"}

package/dist/bin/options.js

@@ -0,0 +1,25 @@
+//#region bin/options.ts
+const getOptionIfMatchingSource = (...sources) => (command, option) => {
+	const source = command.getOptionValueSource(option);
+	if (sources.includes(source)) return command.getOptionValue(option);
+};
+/**
+* Get an option value if it is explicitly supplied to the CLI command.
+* The difference between this and using the option directly is that we return undefined
+* instead of the default value if the option was not explicitly set.
+*/
+const getSuppliedCliOption = getOptionIfMatchingSource("cli");
+/**
+* Get the default value specified for a CLI command option.
+* Mostly useful for getting values which may later be overridden.
+*/
+const getDefaultCliOption = getOptionIfMatchingSource("default");
+/**
+* Try to get the explicitly supplied CLI option, and fall back to the default value
+* for the option as defined in the {@link Command}
+*/
+const getCliOption = getOptionIfMatchingSource("cli", "default");
+//#endregion
+export { getCliOption, getDefaultCliOption, getSuppliedCliOption };
+
+//# sourceMappingURL=options.js.map

package/dist/bin/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","names":[],"sources":["../../bin/options.ts"],"sourcesContent":["import type { Command, OptionValueSource, OptionValues } from '@commander-js/extra-typings';\n\nconst getOptionIfMatchingSource =\n  (...sources: OptionValueSource[]) =>\n  <Args extends unknown[], Opts extends OptionValues, K extends keyof Opts>(\n    command: Command<Args, Opts>,\n    option: K,\n  ) => {\n    const source = command.getOptionValueSource(option);\n    if (sources.includes(source)) {\n      return command.getOptionValue(option);\n    }\n  };\n\nexport type OptionGetter = ReturnType<typeof getOptionIfMatchingSource>;\n\n/**\n * Get an option value if it is explicitly supplied to the CLI command.\n * The difference between this and using the option directly is that we return undefined\n * instead of the default value if the option was not explicitly set.\n */\nexport const getSuppliedCliOption = getOptionIfMatchingSource('cli');\n\n/**\n * Get the default value specified for a CLI command option.\n * Mostly useful for getting values which may later be overridden.\n */\nexport const getDefaultCliOption = getOptionIfMatchingSource('default');\n\n/**\n * Try to get the explicitly supplied CLI option, and fall back to the default value\n * for the option as defined in the {@link Command}\n */\nexport const getCliOption = getOptionIfMatchingSource('cli', 'default');\n"],"mappings":";AAEA,MAAM,6BACH,GAAG,aAEF,SACA,WACG;CACH,MAAM,SAAS,QAAQ,qBAAqB,MAAM;CAClD,IAAI,QAAQ,SAAS,MAAM,GACzB,OAAO,QAAQ,eAAe,MAAM;AAExC;;;;;;AASF,MAAa,uBAAuB,0BAA0B,KAAK;;;;;AAMnE,MAAa,sBAAsB,0BAA0B,SAAS;;;;;AAMtE,MAAa,eAAe,0BAA0B,OAAO,SAAS"}