@digdir/designsystemet 0.1.0-next.31 → 0.100.51-next.52

package/README.md

@@ -0,0 +1,16 @@
+# @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
+We recommend using the [Designsystemet theme-builder](https://theme.designsystemet.no/) for generating options and commandline snippet. 
+
+### Build tokens
+Use `npx @digdir/designsystemet tokens build` to build CSS from design-tokens generated in the step above.

package/dist/bin/config.d.ts

@@ -0,0 +1,162 @@
+import { z } from 'zod';
+export declare function mapPathToOptionName(path: (string | number)[]): string | undefined;
+export declare const colorRegex: RegExp;
+/**
+ * This defines the structure of the JSON config file
+ */
+export declare const configFileSchema: z.ZodObject<{
+    outDir: z.ZodOptional<z.ZodString>;
+    clean: z.ZodOptional<z.ZodBoolean>;
+    themes: z.ZodRecord<z.ZodString, z.ZodObject<{
+        colors: z.ZodObject<{
+            main: z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodString, `#${string}`, string>>;
+            support: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodString, `#${string}`, string>>>>;
+            neutral: z.ZodEffects<z.ZodString, `#${string}`, string>;
+        }, "strip", z.ZodTypeAny, {
+            main: Record<string, `#${string}`>;
+            neutral: `#${string}`;
+            support: Record<string, `#${string}`>;
+        }, {
+            main: Record<string, string>;
+            neutral: string;
+            support?: Record<string, string> | undefined;
+        }>;
+        typography: z.ZodOptional<z.ZodObject<{
+            fontFamily: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            fontFamily: string;
+        }, {
+            fontFamily: string;
+        }>>;
+        borderRadius: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        colors: {
+            main: Record<string, `#${string}`>;
+            neutral: `#${string}`;
+            support: Record<string, `#${string}`>;
+        };
+        typography?: {
+            fontFamily: string;
+        } | undefined;
+        borderRadius?: number | undefined;
+    }, {
+        colors: {
+            main: Record<string, string>;
+            neutral: string;
+            support?: Record<string, string> | undefined;
+        };
+        typography?: {
+            fontFamily: string;
+        } | undefined;
+        borderRadius?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    themes: Record<string, {
+        colors: {
+            main: Record<string, `#${string}`>;
+            neutral: `#${string}`;
+            support: Record<string, `#${string}`>;
+        };
+        typography?: {
+            fontFamily: string;
+        } | undefined;
+        borderRadius?: number | undefined;
+    }>;
+    clean?: boolean | undefined;
+    outDir?: string | undefined;
+}, {
+    themes: Record<string, {
+        colors: {
+            main: Record<string, string>;
+            neutral: string;
+            support?: Record<string, string> | undefined;
+        };
+        typography?: {
+            fontFamily: string;
+        } | undefined;
+        borderRadius?: number | undefined;
+    }>;
+    clean?: boolean | undefined;
+    outDir?: string | undefined;
+}>;
+/**
+ * This defines the structure of the final configuration after combining the config file,
+ * command-line options and default values.
+ */
+export declare const combinedConfigSchema: z.ZodObject<{
+    outDir: z.ZodString;
+    clean: z.ZodBoolean;
+    themes: z.ZodRecord<z.ZodString, z.ZodObject<{
+        colors: z.ZodObject<{
+            main: z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodString, `#${string}`, string>>;
+            support: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodString, `#${string}`, string>>>>;
+            neutral: z.ZodEffects<z.ZodString, `#${string}`, string>;
+        }, "strip", z.ZodTypeAny, {
+            main: Record<string, `#${string}`>;
+            neutral: `#${string}`;
+            support: Record<string, `#${string}`>;
+        }, {
+            main: Record<string, string>;
+            neutral: string;
+            support?: Record<string, string> | undefined;
+        }>;
+        typography: z.ZodOptional<z.ZodObject<{
+            fontFamily: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            fontFamily: string;
+        }, {
+            fontFamily: string;
+        }>>;
+        borderRadius: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        colors: {
+            main: Record<string, `#${string}`>;
+            neutral: `#${string}`;
+            support: Record<string, `#${string}`>;
+        };
+        typography?: {
+            fontFamily: string;
+        } | undefined;
+        borderRadius?: number | undefined;
+    }, {
+        colors: {
+            main: Record<string, string>;
+            neutral: string;
+            support?: Record<string, string> | undefined;
+        };
+        typography?: {
+            fontFamily: string;
+        } | undefined;
+        borderRadius?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    clean: boolean;
+    themes: Record<string, {
+        colors: {
+            main: Record<string, `#${string}`>;
+            neutral: `#${string}`;
+            support: Record<string, `#${string}`>;
+        };
+        typography?: {
+            fontFamily: string;
+        } | undefined;
+        borderRadius?: number | undefined;
+    }>;
+    outDir: string;
+}, {
+    clean: boolean;
+    themes: Record<string, {
+        colors: {
+            main: Record<string, string>;
+            neutral: string;
+            support?: Record<string, string> | undefined;
+        };
+        typography?: {
+            fontFamily: string;
+        } | undefined;
+        borderRadius?: number | undefined;
+    }>;
+    outDir: string;
+}>;
+export type CombinedConfigSchema = z.infer<typeof combinedConfigSchema>;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../bin/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,sBAQ5D;AAUD,eAAO,MAAM,UAAU,QAA2C,CAAC;AA+BnE;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAO3B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAA8B,CAAC;AAChE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/bin/config.js

@@ -0,0 +1,56 @@
+import * as R from "ramda";
+import { z } from "zod";
+import { convertToHex } from "../src/colors/index.js";
+import { cliOptions } from "../src/tokens/create.js";
+function mapPathToOptionName(path) {
+  const normalisedPath = path[0] === "themes" ? ["theme", ...R.drop(2, path)] : path;
+  const option = R.path(normalisedPath, cliOptions);
+  if (typeof option !== "string") {
+    return;
+  }
+  return option;
+}
+const hexPatterns = [
+  // Hex colors: #000, #0000, #000000, #00000000
+  `#[0-9a-fA-F]{3}`,
+  `#[0-9a-fA-F]{4}`,
+  `#[0-9a-fA-F]{6}`,
+  `#[0-9a-fA-F]{8}`
+];
+const colorRegex = new RegExp(`^${hexPatterns.join("|")}$`);
+const colorSchema = z.string({ description: "A hex color, which is used for creating a color scale" }).regex(colorRegex).transform(convertToHex);
+const colorCategorySchema = z.record(colorSchema, { description: "One or more color definitions" });
+const themeSchema = z.object(
+  {
+    colors: z.object(
+      {
+        main: colorCategorySchema,
+        support: colorCategorySchema.optional().default({}),
+        neutral: colorSchema
+      },
+      { description: "Defines the colors for this theme" }
+    ),
+    typography: z.object(
+      {
+        fontFamily: z.string({ description: "Sets the font-family for this theme" })
+      },
+      { description: "Defines the typography for a given theme" }
+    ).optional(),
+    borderRadius: z.number({ description: "Defines the border-radius for this theme" }).optional()
+  },
+  { description: "An object defining a theme. The property name holding the object becomes the theme name." }
+);
+const configFileSchema = z.object({
+  outDir: z.string({ description: "Path to the output directory for the created design tokens" }).optional(),
+  clean: z.boolean({ description: "Delete the output directory before building or creating tokens" }).optional(),
+  themes: z.record(themeSchema, {
+    description: "An object with one or more themes. Each property defines a theme, and the property name is used as the theme name."
+  })
+});
+const combinedConfigSchema = configFileSchema.required();
+export {
+  colorRegex,
+  combinedConfigSchema,
+  configFileSchema,
+  mapPathToOptionName
+};

package/dist/{types/bin → bin}/designsystemet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"designsystemet.d.ts","sourceRoot":"","sources":["../../../bin/designsystemet.ts"],"names":[],"mappings":""}
+{"version":3,"file":"designsystemet.d.ts","sourceRoot":"","sources":["../../bin/designsystemet.ts"],"names":[],"mappings":""}

package/dist/bin/designsystemet.js

@@ -1,39 +1,123 @@
 #!/usr/bin/env node
+import fs from "node:fs/promises";
+import path from "node:path";
 import { Argument, createCommand, program } from "@commander-js/extra-typings";
 import chalk from "chalk";
+import * as R from "ramda";
+import { fromError } from "zod-validation-error";
 import { convertToHex } from "../src/colors/index.js";
-import { createTokensPackage } from "../src/init/createTokensPackage.js";
 import migrations from "../src/migrations/index.js";
-import { buildTokens } from "../src/tokens/build/index.js";
-import { createTokens } from "../src/tokens/create//index.js";
-program.name("Designsystemet").description("CLI for working with Designsystemet").showHelpAfterError();
+import { buildTokens } from "../src/tokens/build.js";
+import { cliOptions, createTokens } from "../src/tokens/create.js";
+import { cleanDir } from "../src/tokens/utils.js";
+import { writeTokens } from "../src/tokens/write.js";
+import { combinedConfigSchema, configFileSchema, mapPathToOptionName } from "./config.js";
+import { getDefaultOrExplicitOption } from "./options.js";
+program.name("designsystemet").description("CLI for working with Designsystemet").showHelpAfterError();
 function makeTokenCommands() {
   const tokenCmd = createCommand("tokens");
-  tokenCmd.command("build").description("Build Designsystemet tokens").option("-t, --tokens <string>", `Path to ${chalk.blue("design-tokens")}`, "./design-tokens").option("-o, --out <string>", `Output directory for built ${chalk.blue("design-tokens")}`, "./dist/tokens").option("-p, --preview", "Generate preview token.ts files", false).action((opts) => {
-    const tokens = typeof opts.tokens === "string" ? opts.tokens : "./design-tokens";
-    const out = typeof opts.out === "string" ? opts.out : "./dist/tokens";
-    const preview = opts.preview;
-    console.log(`Bulding tokens in ${chalk.green(tokens)}`);
-    return buildTokens({ tokens, out, preview });
+  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_FILE = "designsystemet.config.json";
+  tokenCmd.command("build").description("Build Designsystemet tokens").option("-t, --tokens <string>", `Path to ${chalk.blue("design-tokens")}`, DEFAULT_TOKENS_CREATE_DIR).option(
+    "-o, --out-dir <string>",
+    `Output directory for built ${chalk.blue("design-tokens")}`,
+    DEFAULT_TOKENS_BUILD_DIR
+  ).option(`--${cliOptions.clean} [boolean]`, "Clean output directory before building tokens", parseBoolean, false).option("--dry [boolean]", `Dry run for built ${chalk.blue("design-tokens")}`, parseBoolean, false).option("-p, --preview", "Generate preview token.ts files", false).option("--verbose", "Enable verbose output", false).action((opts) => {
+    const { preview, verbose, clean, dry } = opts;
+    const tokens = typeof opts.tokens === "string" ? opts.tokens : DEFAULT_TOKENS_CREATE_DIR;
+    const outDir = typeof opts.outDir === "string" ? opts.outDir : "./dist/tokens";
+    console.log(`Building tokens in ${chalk.green(tokens)}`);
+    if (dry) {
+      console.log(`Performing dry run, no files will be written`);
+    }
+    return buildTokens({ tokens, outDir, preview, verbose, dry, clean });
   });
-  tokenCmd.command("create").description("Create Designsystemet tokens").option("-w, --write [string]", `Output directory for created ${chalk.blue("design-tokens")}`).option("-a, --accent <number>", `Accent hex color`).option("-n, --neutral <number>", `Neutral hex color`).option("-b1, --brand1 <number>", `Brand1 hex color`).option("-b2, --brand2 <number>", `Brand2 hex color`).option("-b3, --brand3 <number>", `Brand3 hex color`).option("-f, --font-family <string>", `Font family`).action(async (opts) => {
-    console.log(`Creating tokens with options ${chalk.green(JSON.stringify(opts))}`);
-    const family = typeof opts.fontFamily === "string" ? opts.fontFamily : "Inter";
-    const write2 = typeof opts.write === "boolean" ? "./design-tokens" : opts.write;
-    const props = {
-      colors: {
-        accent: convertToHex(opts.accent),
-        neutral: convertToHex(opts.neutral),
-        brand1: convertToHex(opts.brand1),
-        brand2: convertToHex(opts.brand2),
-        brand3: convertToHex(opts.brand3)
-      },
-      typography: {
-        family
-      },
-      write: write2
-    };
-    await createTokens(props);
+  tokenCmd.command("create").description("Create Designsystemet tokens").option(`-m, --${cliOptions.theme.colors.main} <name:hex...>`, `Main colors`, parseColorValues).option(`-s, --${cliOptions.theme.colors.support} <name:hex...>`, `Support colors`, parseColorValues).option(`-n, --${cliOptions.theme.colors.neutral} <hex>`, `Neutral hex color`, convertToHex).option(
+    `-o, --${cliOptions.outDir} <string>`,
+    `Output directory for created ${chalk.blue("design-tokens")}`,
+    DEFAULT_TOKENS_CREATE_DIR
+  ).option(`--${cliOptions.clean} [boolean]`, "Clean output directory before creating tokens", parseBoolean, false).option("--dry [boolean]", `Dry run for created ${chalk.blue("design-tokens")}`, parseBoolean, false).option(`-f, --${cliOptions.theme.typography.fontFamily} <string>`, `Font family`, DEFAULT_FONT).option(
+    `-b, --${cliOptions.theme.borderRadius} <number>`,
+    `Unitless base border-radius in px`,
+    (radiusAsString) => Number(radiusAsString),
+    4
+  ).option("--theme <string>", "Theme name (ignored when using JSON config file)", DEFAULT_THEME_NAME).option(
+    "--config <string>",
+    `Path to config file (default: "${DEFAULT_CONFIG_FILE}")`,
+    (value) => parseConfig(value, { allowFileNotFound: false })
+  ).action(async (opts, cmd) => {
+    if (opts.dry) {
+      console.log(`Performing dry run, no files will be written`);
+    }
+    const configFile = await (opts.config ? opts.config : parseConfig(DEFAULT_CONFIG_FILE, { allowFileNotFound: true }));
+    const propsFromJson = configFile?.config;
+    if (propsFromJson) {
+      const themeColors = Object.values(propsFromJson?.themes ?? {}).map(
+        (x) => /* @__PURE__ */ new Set([...R.keys(x.colors.main), ...R.keys(x.colors.support)])
+      );
+      if (!R.all(R.equals(R.__, themeColors[0]), themeColors)) {
+        console.error(
+          chalk.redBright(
+            `In config ${configFile.path}, all themes must have the same custom color names, but we found:`
+          )
+        );
+        const themeNames = R.keys(propsFromJson.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({
+        main: optionGetter(cmd, "mainColors"),
+        support: optionGetter(cmd, "supportColors"),
+        neutral: optionGetter(cmd, "neutralColor")
+      }),
+      typography: noUndefined({
+        fontFamily: optionGetter(cmd, "fontFamily")
+      }),
+      borderRadius: optionGetter(cmd, "borderRadius")
+    });
+    const unvalidatedConfig = noUndefined({
+      outDir: propsFromJson?.outDir ?? getDefaultOrExplicitOption(cmd, "outDir"),
+      clean: propsFromJson?.clean ?? getDefaultOrExplicitOption(cmd, "clean"),
+      themes: propsFromJson?.themes ? (
+        // For each theme specified in the JSON config, we override the config values
+        // with the explicitly set options from the CLI.
+        R.map((theme) => R.mergeDeepRight(theme, getThemeOptions(getDefaultOrExplicitOption)), propsFromJson.themes)
+      ) : (
+        // If there are no themes specified in the JSON config, we use both explicit
+        // and default theme options from the CLI.
+        {
+          [opts.theme]: getThemeOptions(getDefaultOrExplicitOption)
+        }
+      )
+    });
+    let config;
+    try {
+      config = combinedConfigSchema.parse(unvalidatedConfig);
+    } catch (err) {
+      console.error(chalk.redBright("Invalid config after combining config file and CLI options"));
+      const validationError = makeFriendlyError(err);
+      console.error(validationError.toString());
+      process.exit(1);
+    }
+    console.log(`Creating tokens with configuration ${chalk.green(JSON.stringify(config, null, 2))}`);
+    if (config.clean) {
+      await cleanDir(config.outDir, opts.dry);
+    }
+    for (const [name, themeWithoutName] of Object.entries(config.themes)) {
+      const theme = { name, ...themeWithoutName };
+      const tokens = createTokens(theme);
+      await writeTokens({ outDir: config.outDir, tokens, theme, dry: opts.dry });
+    }
   });
   return tokenCmd;
 }
@@ -56,7 +140,51 @@ program.command("migrate").description("run a Designsystemet migration").addArgu
     console.log("Migrate: please specify a migration name or --list");
   }
 });
-program.command("init").description("create an initial token structure for Designsystemet").addArgument(new Argument("<targetDir>", "Target directory for the generated code")).action(async (targetDir) => {
-  await createTokensPackage(targetDir);
-});
 await program.parseAsync(process.argv);
+async function parseConfig(configPath, options) {
+  const resolvedPath = path.resolve(process.cwd(), configPath);
+  let configFile;
+  try {
+    configFile = await fs.readFile(resolvedPath, { encoding: "utf-8" });
+    console.log(`Found config file: ${chalk.green(resolvedPath)}`);
+  } catch (err) {
+    if (err instanceof Error) {
+      const nodeErr = err;
+      if (nodeErr.code === "ENOENT" && options.allowFileNotFound) {
+        return;
+      }
+    }
+    throw err;
+  }
+  try {
+    return {
+      path: configPath,
+      config: await configFileSchema.parseAsync(JSON.parse(configFile))
+    };
+  } catch (err) {
+    console.error(chalk.redBright(`Invalid config in ${configPath}`));
+    const validationError = makeFriendlyError(err);
+    console.error(validationError.toString());
+    process.exit(1);
+  }
+}
+function makeFriendlyError(err) {
+  return fromError(err, {
+    messageBuilder: (issues) => issues.map((issue) => {
+      const issuePath = issue.path.join(".");
+      const optionName = mapPathToOptionName(issue.path);
+      const errorCode = `(error code: ${issue.code})`;
+      const optionMessage = optionName ? ` or CLI option --${optionName}` : "";
+      return `  - Error in JSON value ${chalk.red(issuePath)}${optionMessage}:
+    ${issue.message} ${chalk.dim(errorCode)}`;
+    }).join("\n")
+  });
+}
+function parseColorValues(value, previous = {}) {
+  const [name, hex] = value.split(":");
+  previous[name] = convertToHex(hex);
+  return previous;
+}
+function parseBoolean(value, previous) {
+  return value === "true" || value === true;
+}

package/dist/bin/options.d.ts

@@ -0,0 +1,16 @@
+import type { Command, OptionValueSource, OptionValues } from '@commander-js/extra-typings';
+declare const getOptionIfMatchingSource: (...sources: OptionValueSource[]) => <Args extends unknown[], Opts extends OptionValues, K extends keyof Opts>(command: Command<Args, Opts>, option: K) => Opts[K] | undefined;
+export 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.
+ */
+export declare const getExplicitOptionOnly: <Args extends unknown[], Opts extends OptionValues, K extends keyof Opts>(command: Command<Args, Opts>, option: K) => Opts[K] | undefined;
+/**
+ * This function is basically the default behaviour, unlike {@link getExplicitOptionOnly}.
+ * It is provided so that the program can choose its behaviour as needed.
+ */
+export declare const getDefaultOrExplicitOption: <Args extends unknown[], Opts extends OptionValues, K extends keyof Opts>(command: Command<Args, Opts>, option: K) => Opts[K] | undefined;
+export {};
+//# sourceMappingURL=options.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../bin/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE5F,QAAA,MAAM,yBAAyB,eAChB,iBAAiB,EAAE,MAC/B,IAAI,SAAS,OAAO,EAAE,EAAE,IAAI,SAAS,YAAY,EAAE,CAAC,SAAS,MAAM,IAAI,WAC7D,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,UACpB,CAAC,wBAMV,CAAC;AAEJ,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAExE;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAjB/B,IAAI,SAAS,OAAO,EAAE,EAAE,IAAI,SAAS,YAAY,EAAE,CAAC,SAAS,MAAM,IAAI,WAC7D,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,UACpB,CAAC,wBAewD,CAAC;AAEtE;;;GAGG;AACH,eAAO,MAAM,0BAA0B,GAvBpC,IAAI,SAAS,OAAO,EAAE,EAAE,IAAI,SAAS,YAAY,EAAE,CAAC,SAAS,MAAM,IAAI,WAC7D,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,UACpB,CAAC,wBAqBwE,CAAC"}

package/dist/bin/options.js

@@ -0,0 +1,12 @@
+const getOptionIfMatchingSource = (...sources) => (command, option) => {
+  const source = command.getOptionValueSource(option);
+  if (sources.includes(source)) {
+    return command.getOptionValue(option);
+  }
+};
+const getExplicitOptionOnly = getOptionIfMatchingSource("cli");
+const getDefaultOrExplicitOption = getOptionIfMatchingSource("cli", "default");
+export {
+  getDefaultOrExplicitOption,
+  getExplicitOptionOnly
+};

package/dist/config.schema.json

@@ -0,0 +1,81 @@
+{
+  "type": "object",
+  "properties": {
+    "$schema": {
+      "type": "string"
+    },
+    "outDir": {
+      "type": "string",
+      "description": "Path to the output directory for the created design tokens"
+    },
+    "clean": {
+      "type": "boolean",
+      "description": "Delete the output directory before building or creating tokens"
+    },
+    "themes": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "colors": {
+            "type": "object",
+            "properties": {
+              "main": {
+                "type": "object",
+                "additionalProperties": {
+                  "type": "string",
+                  "pattern": "^#[0-9a-fA-F]{3}|#[0-9a-fA-F]{4}|#[0-9a-fA-F]{6}|#[0-9a-fA-F]{8}$",
+                  "description": "A hex color, which is used for creating a color scale"
+                },
+                "description": "One or more color definitions"
+              },
+              "support": {
+                "$ref": "#/properties/themes/additionalProperties/properties/colors/properties/main",
+                "description": "One or more color definitions",
+                "default": {}
+              },
+              "neutral": {
+                "$ref": "#/properties/themes/additionalProperties/properties/colors/properties/main/additionalProperties"
+              }
+            },
+            "required": [
+              "main",
+              "neutral"
+            ],
+            "additionalProperties": false,
+            "description": "Defines the colors for this theme"
+          },
+          "typography": {
+            "type": "object",
+            "properties": {
+              "fontFamily": {
+                "type": "string",
+                "description": "Sets the font-family for this theme"
+              }
+            },
+            "required": [
+              "fontFamily"
+            ],
+            "additionalProperties": false,
+            "description": "Defines the typography for a given theme"
+          },
+          "borderRadius": {
+            "type": "number",
+            "description": "Defines the border-radius for this theme"
+          }
+        },
+        "required": [
+          "colors"
+        ],
+        "additionalProperties": false,
+        "description": "An object defining a theme. The property name holding the object becomes the theme name."
+      },
+      "description": "An object with one or more themes. Each property defines a theme, and the property name is used as the theme name."
+    }
+  },
+  "required": [
+    "themes"
+  ],
+  "additionalProperties": false,
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/dist/src/colors/colorMetadata.d.ts

@@ -0,0 +1,53 @@
+import type { ColorMetadataByName, ColorNumber, CssColor, GlobalColors } from './types.js';
+export declare const baseColors: Record<GlobalColors, CssColor>;
+export declare const colorMetadata: ColorMetadataByName;
+export declare const getColorMetadataByNumber: (number: ColorNumber) => ({
+    name: "background-default";
+    number: 1;
+} & import("./types.js").ColorMetadata) | ({
+    name: "background-tinted";
+    number: 2;
+} & import("./types.js").ColorMetadata) | ({
+    name: "surface-default";
+    number: 3;
+} & import("./types.js").ColorMetadata) | ({
+    name: "surface-tinted";
+    number: 4;
+} & import("./types.js").ColorMetadata) | ({
+    name: "surface-hover";
+    number: 5;
+} & import("./types.js").ColorMetadata) | ({
+    name: "surface-active";
+    number: 6;
+} & import("./types.js").ColorMetadata) | ({
+    name: "border-subtle";
+    number: 7;
+} & import("./types.js").ColorMetadata) | ({
+    name: "border-default";
+    number: 8;
+} & import("./types.js").ColorMetadata) | ({
+    name: "border-strong";
+    number: 9;
+} & import("./types.js").ColorMetadata) | ({
+    name: "text-subtle";
+    number: 10;
+} & import("./types.js").ColorMetadata) | ({
+    name: "text-default";
+    number: 11;
+} & import("./types.js").ColorMetadata) | ({
+    name: "base-default";
+    number: 12;
+} & import("./types.js").ColorMetadata) | ({
+    name: "base-hover";
+    number: 13;
+} & import("./types.js").ColorMetadata) | ({
+    name: "base-active";
+    number: 14;
+} & import("./types.js").ColorMetadata) | ({
+    name: "base-contrast-subtle";
+    number: 15;
+} & import("./types.js").ColorMetadata) | ({
+    name: "base-contrast-default";
+    number: 16;
+} & import("./types.js").ColorMetadata);
+//# sourceMappingURL=colorMetadata.d.ts.map

package/dist/src/colors/colorMetadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorMetadata.d.ts","sourceRoot":"","sources":["../../../src/colors/colorMetadata.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE3F,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,YAAY,EAAE,QAAQ,CAMrD,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,mBAsM3B,CAAC;AAIF,eAAO,MAAM,wBAAwB,WAAY,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uCAE3D,CAAC"}