dispersa 0.4.2 → 1.0.0

package/dist/cli/index.js

@@ -3,9 +3,59 @@ import { access } from 'fs/promises';
 import { createRequire } from 'module';
 import { dirname, resolve, isAbsolute } from 'path';
 import process2 from 'process';
-import { Dispersa } from 'dispersa';
+import { build, lint } from 'dispersa';
 import { createJiti } from 'jiti';
 
+// src/cli/formatters/lint-formatter.ts
+var formatLintJson = (result) => {
+  return JSON.stringify(result, null, 2);
+};
+var formatLintStylish = (result) => {
+  const lines = [];
+  if (result.issues.length === 0) {
+    return "\u2713 No lint issues found";
+  }
+  const byToken = /* @__PURE__ */ new Map();
+  for (const issue of result.issues) {
+    const existing = byToken.get(issue.tokenName) ?? [];
+    existing.push(issue);
+    byToken.set(issue.tokenName, existing);
+  }
+  for (const [tokenName, issues] of byToken) {
+    lines.push(``);
+    lines.push(`  ${tokenName}`);
+    for (const issue of issues) {
+      const severity = issue.severity === "error" ? "\u2716" : "\u26A0";
+      const label = issue.severity === "error" ? "error" : "warning";
+      lines.push(`    ${severity} ${label}: ${issue.message} [${issue.ruleId}]`);
+    }
+  }
+  lines.push(``);
+  if (result.errorCount > 0 || result.warningCount > 0) {
+    const parts = [];
+    if (result.errorCount > 0) {
+      parts.push(`${result.errorCount} error${result.errorCount === 1 ? "" : "s"}`);
+    }
+    if (result.warningCount > 0) {
+      parts.push(`${result.warningCount} warning${result.warningCount === 1 ? "" : "s"}`);
+    }
+    lines.push(`\u2716 ${parts.join(", ")}`);
+  }
+  return lines.join("\n");
+};
+var formatLintCompact = (result) => {
+  const lines = [];
+  for (const issue of result.issues) {
+    const severity = issue.severity.toUpperCase();
+    lines.push(`${severity}: ${issue.ruleId} - ${issue.message} (token: ${issue.tokenName})`);
+  }
+  if (result.errorCount > 0 || result.warningCount > 0) {
+    lines.push(`SUMMARY: ${result.errorCount} errors, ${result.warningCount} warnings`);
+  }
+  return lines.join("\n");
+};
+
+// src/cli/cli.ts
 var defaultConfigNames = [
   "dispersa.config.ts",
   "dispersa.config.js",
@@ -27,6 +77,9 @@ async function runCli(args, options = {}) {
     printHelp(io);
     return 0;
   }
+  if (command === "lint") {
+    return runLintCommand(args.slice(1), cwd, io);
+  }
   if (command !== "build") {
     io.stderr(`Unknown command: ${command}`);
     printHelp(io);
@@ -47,8 +100,7 @@ async function runCli(args, options = {}) {
     }
   }
   const startTime = Date.now();
-  const dispersa = new Dispersa({ resolver, buildPath, validation });
-  const result = await dispersa.build(buildConfig);
+  const result = await build({ resolver, buildPath, validation, ...buildConfig });
   const elapsed = Date.now() - startTime;
   return reportBuildResult(result, verbose, elapsed, io);
 }
@@ -103,6 +155,50 @@ function reportBuildResult(result, verbose, elapsed, io) {
   }
   return 0;
 }
+async function runLintCommand(args, cwd, io) {
+  const verbose = hasFlag(args, "--verbose") || hasFlag(args, "-v");
+  const formatArg = getArgValue(args, "--format");
+  const format = formatArg === "json" || formatArg === "compact" ? formatArg : "stylish";
+  const loaded = await resolveAndLoadConfig(args, cwd, io, verbose);
+  if (!loaded) {
+    return 1;
+  }
+  const normalizedConfig = normalizeConfigPaths(loaded.config, loaded.configDir);
+  const { lint: lintConfig, validation, resolver } = normalizedConfig;
+  if (!lintConfig) {
+    io.stderr("No lint configuration found in config file.");
+    io.stderr('Add a "lint" property to your dispersa.config.ts');
+    return 1;
+  }
+  if (!resolver) {
+    io.stderr("No resolver configuration found in config file.");
+    io.stderr('Add a "resolver" property to your dispersa.config.ts');
+    return 1;
+  }
+  if (verbose) {
+    io.stdout(`Resolver: ${typeof resolver === "string" ? resolver : "(inline)"}`);
+    io.stdout(`Format: ${format}`);
+  }
+  const startTime = Date.now();
+  try {
+    const result = await lint({ resolver, ...lintConfig, validation });
+    const elapsed = Date.now() - startTime;
+    const formatter = format === "json" ? formatLintJson : format === "compact" ? formatLintCompact : formatLintStylish;
+    const output = formatter(result);
+    io.stdout(output);
+    if (verbose) {
+      io.stdout(`Duration: ${elapsed}ms`);
+    }
+    return result.errorCount > 0 ? 1 : 0;
+  } catch (error) {
+    io.stderr("Lint failed.");
+    io.stderr(`- ${error instanceof Error ? error.message : String(error)}`);
+    if (verbose) {
+      io.stderr(`Duration: ${Date.now() - startTime}ms`);
+    }
+    return 1;
+  }
+}
 function getArgValue(args, flag) {
   const index = args.indexOf(flag);
   if (index === -1 || index === args.length - 1) {
@@ -197,15 +293,31 @@ function isPackageResolvable(name, cwd) {
   }
 }
 function printHelp(io) {
-  io.stdout("dispersa build [options]");
+  io.stdout("dispersa <command> [options]");
+  io.stdout("");
+  io.stdout("Commands:");
+  io.stdout("  build              Build design tokens");
+  io.stdout("  lint               Lint design tokens without building");
+  io.stdout("");
+  io.stdout("Build Options:");
+  io.stdout("  --config <path>    Path to dispersa.config.(ts|js|mts|mjs|cts|cjs)");
+  io.stdout("  --verbose, -v      Show detailed build output (timing, error context)");
   io.stdout("");
-  io.stdout("Options:");
-  io.stdout("  --config <path>   Path to dispersa.config.(ts|js|mts|mjs|cts|cjs)");
-  io.stdout("  --verbose, -v     Show detailed build output (timing, error context)");
+  io.stdout("Lint Options:");
+  io.stdout("  --config <path>    Path to dispersa.config.(ts|js|mts|mjs|cts|cjs)");
+  io.stdout("  --format <format>  Output format: stylish (default), json, compact");
+  io.stdout("  --verbose, -v      Show detailed lint output");
 }
 
 // src/cli/index.ts
 var exitCode = await runCli(process.argv.slice(2));
 process.exitCode = exitCode;
+/**
+ * @license MIT
+ * Copyright (c) 2025-present Dispersa
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/cli/cli.ts","../../src/cli/index.ts"],"names":["process","require"],"mappings":"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","file":"index.js","sourcesContent":["import { access } from 'node:fs/promises'\nimport { createRequire } from 'node:module'\nimport { dirname, isAbsolute, resolve } from 'node:path'\nimport process from 'node:process'\n\nimport { Dispersa, type BuildConfig } from 'dispersa'\nimport { createJiti } from 'jiti'\n\nimport type { CliConfig } from './config'\n\ntype CliIO = {\n  stdout: (message: string) => void\n  stderr: (message: string) => void\n}\n\ntype RunOptions = {\n  cwd?: string\n  io?: CliIO\n}\n\nconst defaultConfigNames = [\n  'dispersa.config.ts',\n  'dispersa.config.js',\n  'dispersa.config.mts',\n  'dispersa.config.mjs',\n  'dispersa.config.cts',\n  'dispersa.config.cjs',\n]\n\nexport async function runCli(args: string[], options: RunOptions = {}): Promise<number> {\n  const cwd = options.cwd ?? process.cwd()\n  const io: CliIO = options.io ?? {\n    stdout: (message) => process.stdout.write(`${message}\\n`),\n    stderr: (message) => process.stderr.write(`${message}\\n`),\n  }\n\n  const command = args[0] ?? 'build'\n  if (command === '--help' || command === '-h' || command === 'help') {\n    printHelp(io)\n    return 0\n  }\n\n  if (command !== 'build') {\n    io.stderr(`Unknown command: ${command}`)\n    printHelp(io)\n    return 1\n  }\n\n  const verbose = hasFlag(args, '--verbose') || hasFlag(args, '-v')\n  const loaded = await resolveAndLoadConfig(args, cwd, io, verbose)\n  if (!loaded) {\n    return 1\n  }\n\n  const normalizedConfig = normalizeConfigPaths(loaded.config, loaded.configDir)\n  const { validation, resolver, buildPath, ...buildConfig } = normalizedConfig\n\n  if (verbose) {\n    const outputCount = buildConfig.outputs?.length ?? 0\n    io.stdout(`Outputs: ${outputCount} configured`)\n    if (buildPath) {\n      io.stdout(`Build path: ${buildPath}`)\n    }\n  }\n\n  const startTime = Date.now()\n  const dispersa = new Dispersa({ resolver, buildPath, validation })\n  const result = await dispersa.build(buildConfig as BuildConfig)\n  const elapsed = Date.now() - startTime\n\n  return reportBuildResult(result, verbose, elapsed, io)\n}\n\nasync function resolveAndLoadConfig(\n  args: string[],\n  cwd: string,\n  io: CliIO,\n  verbose: boolean,\n): Promise<{ config: CliConfig; configDir: string } | undefined> {\n  const configPath = getArgValue(args, '--config')\n  const resolvedPath = await resolveConfigPath(configPath, cwd)\n  if (resolvedPath === undefined) {\n    io.stderr(\n      `No config found. Expected one of: ${defaultConfigNames.join(', ')} ` +\n        'or pass --config <path>.',\n    )\n    return undefined\n  }\n\n  if (verbose) {\n    io.stdout(`Config: ${resolvedPath}`)\n  }\n\n  try {\n    const config = await loadConfig(resolvedPath, cwd)\n    return { config, configDir: dirname(resolvedPath) }\n  } catch (error) {\n    io.stderr(`Failed to load config: ${resolvedPath}`)\n    io.stderr(`- ${error instanceof Error ? error.message : String(error)}`)\n    return undefined\n  }\n}\n\nfunction reportBuildResult(\n  result: Awaited<ReturnType<Dispersa['build']>>,\n  verbose: boolean,\n  elapsed: number,\n  io: CliIO,\n): number {\n  if (!result.success) {\n    io.stderr('Build failed.')\n    for (const error of result.errors ?? []) {\n      io.stderr(`- [${error.code}] ${error.message}`)\n      if (verbose && error.tokenPath) {\n        io.stderr(`  Token: ${error.tokenPath}`)\n      }\n      if (verbose && error.path) {\n        io.stderr(`  File: ${error.path}`)\n      }\n      if (verbose && error.suggestions && error.suggestions.length > 0) {\n        io.stderr(`  Suggestions: ${error.suggestions.join(', ')}`)\n      }\n    }\n    if (verbose) {\n      io.stderr(`Duration: ${elapsed}ms`)\n    }\n    return 1\n  }\n\n  io.stdout('Build succeeded.')\n  for (const output of result.outputs) {\n    const location = output.path ?? '(in-memory)'\n    io.stdout(`- ${output.name}: ${location}`)\n  }\n\n  if (verbose) {\n    io.stdout(`Duration: ${elapsed}ms`)\n  }\n\n  return 0\n}\n\nfunction getArgValue(args: string[], flag: string): string | undefined {\n  const index = args.indexOf(flag)\n  if (index === -1 || index === args.length - 1) {\n    return undefined\n  }\n  const value = args[index + 1]\n  if (value == null || value.startsWith('-')) {\n    return undefined\n  }\n  return value\n}\n\nfunction hasFlag(args: string[], flag: string): boolean {\n  return args.includes(flag)\n}\n\nasync function resolveConfigPath(\n  configPath: string | undefined,\n  cwd: string,\n): Promise<string | undefined> {\n  if (configPath) {\n    const fullPath = resolve(cwd, configPath)\n    if (!(await fileExists(fullPath))) {\n      return undefined\n    }\n    return fullPath\n  }\n\n  for (const name of defaultConfigNames) {\n    const fullPath = resolve(cwd, name)\n    if (await fileExists(fullPath)) {\n      return fullPath\n    }\n  }\n\n  return undefined\n}\n\nasync function loadConfig(configPath: string, cwd: string): Promise<CliConfig> {\n  const alias = await buildAliasMap(cwd)\n  const loader = createJiti(cwd, {\n    interopDefault: true,\n    alias,\n  })\n  const loaded = await loader(configPath)\n  const config = (loaded as { default?: CliConfig }).default ?? (loaded as CliConfig)\n\n  if (config == null || typeof config !== 'object') {\n    throw new Error(`Invalid config: ${configPath} did not export an object`)\n  }\n\n  return config\n}\n\nfunction normalizeConfigPaths(config: CliConfig, configDir: string): CliConfig {\n  const resolver =\n    typeof config.resolver === 'string'\n      ? resolveIfRelative(config.resolver, configDir)\n      : config.resolver\n  const buildPath = resolveIfRelative(config.buildPath, configDir)\n  const outputs = config.outputs ?? []\n\n  return {\n    ...config,\n    resolver,\n    buildPath,\n    outputs,\n  }\n}\n\nfunction resolveIfRelative(value: string | undefined, baseDir: string): string | undefined {\n  if (!value) {\n    return value\n  }\n  return isAbsolute(value) ? value : resolve(baseDir, value)\n}\n\nasync function fileExists(path: string): Promise<boolean> {\n  try {\n    await access(path)\n    return true\n  } catch {\n    return false\n  }\n}\n\nasync function buildAliasMap(cwd: string): Promise<Record<string, string>> {\n  const alias: Record<string, string> = {}\n\n  // Dev monorepo: point to source files for hot-reload\n  const coreSourcePath = resolve(cwd, 'packages/core/src/index.ts')\n  if (await fileExists(coreSourcePath)) {\n    alias['dispersa'] = coreSourcePath\n    return alias\n  }\n\n  // Not resolvable from cwd — try from the CLI module's own location\n  // (handles workspace symlinks and global installs)\n  if (!isPackageResolvable('dispersa', cwd)) {\n    const require = createRequire(import.meta.url)\n    try {\n      alias['dispersa'] = require.resolve('dispersa')\n    } catch {\n      // Not resolvable at all; config loading will fail with a clear error\n    }\n  }\n\n  return alias\n}\n\nfunction isPackageResolvable(name: string, cwd: string): boolean {\n  const require = createRequire(import.meta.url)\n  try {\n    require.resolve(name, { paths: [cwd] })\n    return true\n  } catch {\n    return false\n  }\n}\n\nfunction printHelp(io: CliIO): void {\n  io.stdout('dispersa build [options]')\n  io.stdout('')\n  io.stdout('Options:')\n  io.stdout('  --config <path>   Path to dispersa.config.(ts|js|mts|mjs|cts|cjs)')\n  io.stdout('  --verbose, -v     Show detailed build output (timing, error context)')\n}\n","#!/usr/bin/env node\nimport { runCli } from './cli.js'\n\nconst exitCode = await runCli(process.argv.slice(2))\nprocess.exitCode = exitCode\n"]}
+{"version":3,"sources":["../../src/cli/formatters/lint-formatter.ts","../../src/cli/cli.ts","../../src/cli/index.ts"],"names":["process","require"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * @license MIT\n * Copyright (c) 2025-present Dispersa\n *\n * This source code is licensed under the MIT license found in the\n * LICENSE file in the root directory of this source tree.\n */\n\n/**\n * @fileoverview Lint output formatter interface and utilities\n */\n\nimport type { LintIssue, LintResult, LintFormatter } from '@lint/types'\n\n/**\n * Format lint results as JSON\n */\nexport const formatLintJson: LintFormatter = (result: LintResult): string => {\n  return JSON.stringify(result, null, 2)\n}\n\n/**\n * Format lint results in a human-readable stylish format\n */\nexport const formatLintStylish: LintFormatter = (result: LintResult): string => {\n  const lines: string[] = []\n\n  if (result.issues.length === 0) {\n    return '✓ No lint issues found'\n  }\n\n  // Group issues by token\n  const byToken = new Map<string, LintIssue[]>()\n  for (const issue of result.issues) {\n    const existing = byToken.get(issue.tokenName) ?? []\n    existing.push(issue)\n    byToken.set(issue.tokenName, existing)\n  }\n\n  // Output issues\n  for (const [tokenName, issues] of byToken) {\n    lines.push(``)\n    lines.push(`  ${tokenName}`)\n    for (const issue of issues) {\n      const severity = issue.severity === 'error' ? '✖' : '⚠'\n      const label = issue.severity === 'error' ? 'error' : 'warning'\n      lines.push(`    ${severity} ${label}: ${issue.message} [${issue.ruleId}]`)\n    }\n  }\n\n  // Summary\n  lines.push(``)\n  if (result.errorCount > 0 || result.warningCount > 0) {\n    const parts: string[] = []\n    if (result.errorCount > 0) {\n      parts.push(`${result.errorCount} error${result.errorCount === 1 ? '' : 's'}`)\n    }\n    if (result.warningCount > 0) {\n      parts.push(`${result.warningCount} warning${result.warningCount === 1 ? '' : 's'}`)\n    }\n    lines.push(`✖ ${parts.join(', ')}`)\n  }\n\n  return lines.join('\\n')\n}\n\n/**\n * Format lint results for CI output (compact, parseable)\n */\nexport const formatLintCompact: LintFormatter = (result: LintResult): string => {\n  const lines: string[] = []\n\n  for (const issue of result.issues) {\n    const severity = issue.severity.toUpperCase()\n    lines.push(`${severity}: ${issue.ruleId} - ${issue.message} (token: ${issue.tokenName})`)\n  }\n\n  if (result.errorCount > 0 || result.warningCount > 0) {\n    lines.push(`SUMMARY: ${result.errorCount} errors, ${result.warningCount} warnings`)\n  }\n\n  return lines.join('\\n')\n}\n","import { access } from 'node:fs/promises'\nimport { createRequire } from 'node:module'\nimport { dirname, isAbsolute, resolve } from 'node:path'\nimport process from 'node:process'\n\nimport type { LintOutputFormat } from '@lint/types'\nimport { build, lint, type BuildConfig } from 'dispersa'\nimport { createJiti } from 'jiti'\n\nimport type { CliConfig } from './config'\nimport { formatLintCompact, formatLintJson, formatLintStylish } from './formatters/lint-formatter'\n\ntype CliIO = {\n  stdout: (message: string) => void\n  stderr: (message: string) => void\n}\n\ntype RunOptions = {\n  cwd?: string\n  io?: CliIO\n}\n\nconst defaultConfigNames = [\n  'dispersa.config.ts',\n  'dispersa.config.js',\n  'dispersa.config.mts',\n  'dispersa.config.mjs',\n  'dispersa.config.cts',\n  'dispersa.config.cjs',\n]\n\nexport async function runCli(args: string[], options: RunOptions = {}): Promise<number> {\n  const cwd = options.cwd ?? process.cwd()\n  const io: CliIO = options.io ?? {\n    stdout: (message) => process.stdout.write(`${message}\\n`),\n    stderr: (message) => process.stderr.write(`${message}\\n`),\n  }\n\n  const command = args[0] ?? 'build'\n  if (command === '--help' || command === '-h' || command === 'help') {\n    printHelp(io)\n    return 0\n  }\n\n  if (command === 'lint') {\n    return runLintCommand(args.slice(1), cwd, io)\n  }\n\n  if (command !== 'build') {\n    io.stderr(`Unknown command: ${command}`)\n    printHelp(io)\n    return 1\n  }\n\n  const verbose = hasFlag(args, '--verbose') || hasFlag(args, '-v')\n  const loaded = await resolveAndLoadConfig(args, cwd, io, verbose)\n  if (!loaded) {\n    return 1\n  }\n\n  const normalizedConfig = normalizeConfigPaths(loaded.config, loaded.configDir)\n  const { validation, resolver, buildPath, ...buildConfig } = normalizedConfig\n\n  if (verbose) {\n    const outputCount = buildConfig.outputs?.length ?? 0\n    io.stdout(`Outputs: ${outputCount} configured`)\n    if (buildPath) {\n      io.stdout(`Build path: ${buildPath}`)\n    }\n  }\n\n  const startTime = Date.now()\n  const result = await build({ resolver, buildPath, validation, ...buildConfig } as BuildConfig)\n  const elapsed = Date.now() - startTime\n\n  return reportBuildResult(result, verbose, elapsed, io)\n}\n\nasync function resolveAndLoadConfig(\n  args: string[],\n  cwd: string,\n  io: CliIO,\n  verbose: boolean,\n): Promise<{ config: CliConfig; configDir: string } | undefined> {\n  const configPath = getArgValue(args, '--config')\n  const resolvedPath = await resolveConfigPath(configPath, cwd)\n  if (resolvedPath === undefined) {\n    io.stderr(\n      `No config found. Expected one of: ${defaultConfigNames.join(', ')} ` +\n        'or pass --config <path>.',\n    )\n    return undefined\n  }\n\n  if (verbose) {\n    io.stdout(`Config: ${resolvedPath}`)\n  }\n\n  try {\n    const config = await loadConfig(resolvedPath, cwd)\n    return { config, configDir: dirname(resolvedPath) }\n  } catch (error) {\n    io.stderr(`Failed to load config: ${resolvedPath}`)\n    io.stderr(`- ${error instanceof Error ? error.message : String(error)}`)\n    return undefined\n  }\n}\n\nfunction reportBuildResult(\n  result: Awaited<ReturnType<typeof build>>,\n  verbose: boolean,\n  elapsed: number,\n  io: CliIO,\n): number {\n  if (!result.success) {\n    io.stderr('Build failed.')\n    for (const error of result.errors ?? []) {\n      io.stderr(`- [${error.code}] ${error.message}`)\n      if (verbose && error.tokenPath) {\n        io.stderr(`  Token: ${error.tokenPath}`)\n      }\n      if (verbose && error.path) {\n        io.stderr(`  File: ${error.path}`)\n      }\n      if (verbose && error.suggestions && error.suggestions.length > 0) {\n        io.stderr(`  Suggestions: ${error.suggestions.join(', ')}`)\n      }\n    }\n    if (verbose) {\n      io.stderr(`Duration: ${elapsed}ms`)\n    }\n    return 1\n  }\n\n  io.stdout('Build succeeded.')\n  for (const output of result.outputs) {\n    const location = output.path ?? '(in-memory)'\n    io.stdout(`- ${output.name}: ${location}`)\n  }\n\n  if (verbose) {\n    io.stdout(`Duration: ${elapsed}ms`)\n  }\n\n  return 0\n}\n\nasync function runLintCommand(args: string[], cwd: string, io: CliIO): Promise<number> {\n  const verbose = hasFlag(args, '--verbose') || hasFlag(args, '-v')\n  const formatArg = getArgValue(args, '--format')\n  const format: LintOutputFormat =\n    formatArg === 'json' || formatArg === 'compact' ? formatArg : 'stylish'\n\n  const loaded = await resolveAndLoadConfig(args, cwd, io, verbose)\n  if (!loaded) {\n    return 1\n  }\n\n  const normalizedConfig = normalizeConfigPaths(loaded.config, loaded.configDir)\n  const { lint: lintConfig, validation, resolver } = normalizedConfig\n\n  if (!lintConfig) {\n    io.stderr('No lint configuration found in config file.')\n    io.stderr('Add a \"lint\" property to your dispersa.config.ts')\n    return 1\n  }\n\n  if (!resolver) {\n    io.stderr('No resolver configuration found in config file.')\n    io.stderr('Add a \"resolver\" property to your dispersa.config.ts')\n    return 1\n  }\n\n  if (verbose) {\n    io.stdout(`Resolver: ${typeof resolver === 'string' ? resolver : '(inline)'}`)\n    io.stdout(`Format: ${format}`)\n  }\n\n  const startTime = Date.now()\n\n  try {\n    const result = await lint({ resolver, ...lintConfig, validation })\n    const elapsed = Date.now() - startTime\n\n    const formatter =\n      format === 'json'\n        ? formatLintJson\n        : format === 'compact'\n          ? formatLintCompact\n          : formatLintStylish\n\n    const output = formatter(result)\n    io.stdout(output)\n\n    if (verbose) {\n      io.stdout(`Duration: ${elapsed}ms`)\n    }\n\n    return result.errorCount > 0 ? 1 : 0\n  } catch (error) {\n    io.stderr('Lint failed.')\n    io.stderr(`- ${error instanceof Error ? error.message : String(error)}`)\n    if (verbose) {\n      io.stderr(`Duration: ${Date.now() - startTime}ms`)\n    }\n    return 1\n  }\n}\n\nfunction getArgValue(args: string[], flag: string): string | undefined {\n  const index = args.indexOf(flag)\n  if (index === -1 || index === args.length - 1) {\n    return undefined\n  }\n  const value = args[index + 1]\n  if (value == null || value.startsWith('-')) {\n    return undefined\n  }\n  return value\n}\n\nfunction hasFlag(args: string[], flag: string): boolean {\n  return args.includes(flag)\n}\n\nasync function resolveConfigPath(\n  configPath: string | undefined,\n  cwd: string,\n): Promise<string | undefined> {\n  if (configPath) {\n    const fullPath = resolve(cwd, configPath)\n    if (!(await fileExists(fullPath))) {\n      return undefined\n    }\n    return fullPath\n  }\n\n  for (const name of defaultConfigNames) {\n    const fullPath = resolve(cwd, name)\n    if (await fileExists(fullPath)) {\n      return fullPath\n    }\n  }\n\n  return undefined\n}\n\nasync function loadConfig(configPath: string, cwd: string): Promise<CliConfig> {\n  const alias = await buildAliasMap(cwd)\n  const loader = createJiti(cwd, {\n    interopDefault: true,\n    alias,\n  })\n  const loaded = await loader(configPath)\n  const config = (loaded as { default?: CliConfig }).default ?? (loaded as CliConfig)\n\n  if (config == null || typeof config !== 'object') {\n    throw new Error(`Invalid config: ${configPath} did not export an object`)\n  }\n\n  return config\n}\n\nfunction normalizeConfigPaths(config: CliConfig, configDir: string): CliConfig {\n  const resolver =\n    typeof config.resolver === 'string'\n      ? resolveIfRelative(config.resolver, configDir)\n      : config.resolver\n  const buildPath = resolveIfRelative(config.buildPath, configDir)\n  const outputs = config.outputs ?? []\n\n  return {\n    ...config,\n    resolver,\n    buildPath,\n    outputs,\n  }\n}\n\nfunction resolveIfRelative(value: string | undefined, baseDir: string): string | undefined {\n  if (!value) {\n    return value\n  }\n  return isAbsolute(value) ? value : resolve(baseDir, value)\n}\n\nasync function fileExists(path: string): Promise<boolean> {\n  try {\n    await access(path)\n    return true\n  } catch {\n    return false\n  }\n}\n\nasync function buildAliasMap(cwd: string): Promise<Record<string, string>> {\n  const alias: Record<string, string> = {}\n\n  // Dev monorepo: point to source files for hot-reload\n  const coreSourcePath = resolve(cwd, 'packages/core/src/index.ts')\n  if (await fileExists(coreSourcePath)) {\n    alias['dispersa'] = coreSourcePath\n    return alias\n  }\n\n  // Not resolvable from cwd — try from the CLI module's own location\n  // (handles workspace symlinks and global installs)\n  if (!isPackageResolvable('dispersa', cwd)) {\n    const require = createRequire(import.meta.url)\n    try {\n      alias['dispersa'] = require.resolve('dispersa')\n    } catch {\n      // Not resolvable at all; config loading will fail with a clear error\n    }\n  }\n\n  return alias\n}\n\nfunction isPackageResolvable(name: string, cwd: string): boolean {\n  const require = createRequire(import.meta.url)\n  try {\n    require.resolve(name, { paths: [cwd] })\n    return true\n  } catch {\n    return false\n  }\n}\n\nfunction printHelp(io: CliIO): void {\n  io.stdout('dispersa <command> [options]')\n  io.stdout('')\n  io.stdout('Commands:')\n  io.stdout('  build              Build design tokens')\n  io.stdout('  lint               Lint design tokens without building')\n  io.stdout('')\n  io.stdout('Build Options:')\n  io.stdout('  --config <path>    Path to dispersa.config.(ts|js|mts|mjs|cts|cjs)')\n  io.stdout('  --verbose, -v      Show detailed build output (timing, error context)')\n  io.stdout('')\n  io.stdout('Lint Options:')\n  io.stdout('  --config <path>    Path to dispersa.config.(ts|js|mts|mjs|cts|cjs)')\n  io.stdout('  --format <format>  Output format: stylish (default), json, compact')\n  io.stdout('  --verbose, -v      Show detailed lint output')\n}\n","#!/usr/bin/env node\nimport { runCli } from './cli.js'\n\nconst exitCode = await runCli(process.argv.slice(2))\nprocess.exitCode = exitCode\n"]}

package/dist/dispersa-BC1kDF5u.d.ts

@@ -0,0 +1,118 @@
+import { B as BuildConfig, d as BuildResult, j as ModifierInputs, k as ResolverDocument, a as ValidationOptions, m as LintConfig, n as LintResult } from './index-Dajm5rvM.js';
+import { a as ResolvedTokens } from './types-TQHV1MrY.js';
+
+/**
+ * @license
+ * Copyright (c) 2025 Dispersa Contributors
+ * SPDX-License-Identifier: MIT
+ */
+
+/**
+ * DTCG design token processor with multi-format output support
+ *
+ * Dispersa processes DTCG-compliant design tokens through a configurable pipeline,
+ * resolves references and aliases, applies transforms and filters, and generates output
+ * in multiple formats (CSS, JSON, JavaScript).
+ *
+ * **Runtime Validation:**
+ * All functions validate their configuration inputs at runtime, including build configs,
+ * output configs, and custom component registrations. This catches configuration errors
+ * early with helpful error messages.
+ *
+ * Features:
+ * - **Transforms**: Modify token values and names (e.g., convert colors, change case)
+ * - **Filters**: Select which tokens to include in output
+ * - **Preprocessors**: Transform raw token data before parsing
+ * - **Renderers**: Generate output in various formats
+ * - **Runtime validation**: JSON schema validation for all user inputs
+ *
+ * @example Basic build usage
+ * ```typescript
+ * import { build, css } from 'dispersa'
+ * import { nameKebabCase } from 'dispersa/transforms'
+ *
+ * const result = await build({
+ *   resolver: './tokens.resolver.json',
+ *   buildPath: './output',
+ *   outputs: [
+ *     css({
+ *       name: 'css',
+ *       file: 'tokens.css',
+ *       preset: 'bundle',
+ *       selector: ':root',
+ *       transforms: [nameKebabCase()]
+ *     })
+ *   ]
+ * })
+ * ```
+ *
+ * @example Mixed presets per output
+ * ```typescript
+ * import { build, css, json } from 'dispersa'
+ *
+ * const result = await build({
+ *   resolver: './tokens.resolver.json',
+ *   buildPath: './output',
+ *   outputs: [
+ *     css({
+ *       name: 'css',
+ *       file: 'tokens.css',
+ *       preset: 'bundle',
+ *       selector: ':root',  // All themes in one CSS file
+ *       transforms: [nameKebabCase()]
+ *     }),
+ *     json({
+ *       name: 'json',
+ *       file: 'tokens-{theme}.json',  // Separate file per theme
+ *       preset: 'standalone',
+ *       structure: 'flat'
+ *     })
+ *   ]
+ * })
+ * ```
+ *
+ * @example Using filters and preprocessors
+ * ```typescript
+ * import { build, css } from 'dispersa'
+ * import { byType } from 'dispersa/filters'
+ * import { nameKebabCase } from 'dispersa/transforms'
+ *
+ * const result = await build({
+ *   resolver: './tokens.resolver.json',
+ *   buildPath: './output',
+ *   outputs: [
+ *     css({
+ *       name: 'colors-only',
+ *       file: 'colors.css',
+ *       preset: 'standalone',
+ *       selector: ':root',
+ *       filters: [byType('color')],
+ *       transforms: [nameKebabCase()]
+ *     })
+ *   ],
+ *   permutations: [
+ *     { theme: 'light' },
+ *     { theme: 'dark' }
+ *   ]
+ * })
+ * ```
+ */
+declare function build(config: BuildConfig): Promise<BuildResult>;
+declare function buildOrThrow(config: BuildConfig): Promise<BuildResult>;
+declare function buildPermutation(config: BuildConfig, modifierInputs?: ModifierInputs): Promise<BuildResult>;
+declare function resolveTokens(resolver: string | ResolverDocument, modifierInputs?: ModifierInputs, validation?: ValidationOptions): Promise<ResolvedTokens>;
+type LintOptions = {
+    resolver: string | ResolverDocument;
+    modifierInputs?: ModifierInputs;
+    validation?: ValidationOptions;
+} & LintConfig;
+declare function lint(options: LintOptions): Promise<LintResult>;
+declare function resolveAllPermutations(resolver: string | ResolverDocument): Promise<{
+    tokens: ResolvedTokens;
+    modifierInputs: ModifierInputs;
+}[]>;
+declare function generateTypes(tokens: ResolvedTokens, fileName: string, options?: {
+    moduleName?: string;
+}): Promise<void>;
+
+export { type LintOptions as L, buildOrThrow as a, build as b, buildPermutation as c, resolveAllPermutations as d, generateTypes as g, lint as l, resolveTokens as r };

package/dist/dispersa-DL3J_Pmz.d.cts

@@ -0,0 +1,118 @@
+import { B as BuildConfig, d as BuildResult, j as ModifierInputs, k as ResolverDocument, a as ValidationOptions, m as LintConfig, n as LintResult } from './index-De6SjZYH.cjs';
+import { a as ResolvedTokens } from './types-TQHV1MrY.cjs';
+
+/**
+ * @license
+ * Copyright (c) 2025 Dispersa Contributors
+ * SPDX-License-Identifier: MIT
+ */
+
+/**
+ * DTCG design token processor with multi-format output support
+ *
+ * Dispersa processes DTCG-compliant design tokens through a configurable pipeline,
+ * resolves references and aliases, applies transforms and filters, and generates output
+ * in multiple formats (CSS, JSON, JavaScript).
+ *
+ * **Runtime Validation:**
+ * All functions validate their configuration inputs at runtime, including build configs,
+ * output configs, and custom component registrations. This catches configuration errors
+ * early with helpful error messages.
+ *
+ * Features:
+ * - **Transforms**: Modify token values and names (e.g., convert colors, change case)
+ * - **Filters**: Select which tokens to include in output
+ * - **Preprocessors**: Transform raw token data before parsing
+ * - **Renderers**: Generate output in various formats
+ * - **Runtime validation**: JSON schema validation for all user inputs
+ *
+ * @example Basic build usage
+ * ```typescript
+ * import { build, css } from 'dispersa'
+ * import { nameKebabCase } from 'dispersa/transforms'
+ *
+ * const result = await build({
+ *   resolver: './tokens.resolver.json',
+ *   buildPath: './output',
+ *   outputs: [
+ *     css({
+ *       name: 'css',
+ *       file: 'tokens.css',
+ *       preset: 'bundle',
+ *       selector: ':root',
+ *       transforms: [nameKebabCase()]
+ *     })
+ *   ]
+ * })
+ * ```
+ *
+ * @example Mixed presets per output
+ * ```typescript
+ * import { build, css, json } from 'dispersa'
+ *
+ * const result = await build({
+ *   resolver: './tokens.resolver.json',
+ *   buildPath: './output',
+ *   outputs: [
+ *     css({
+ *       name: 'css',
+ *       file: 'tokens.css',
+ *       preset: 'bundle',
+ *       selector: ':root',  // All themes in one CSS file
+ *       transforms: [nameKebabCase()]
+ *     }),
+ *     json({
+ *       name: 'json',
+ *       file: 'tokens-{theme}.json',  // Separate file per theme
+ *       preset: 'standalone',
+ *       structure: 'flat'
+ *     })
+ *   ]
+ * })
+ * ```
+ *
+ * @example Using filters and preprocessors
+ * ```typescript
+ * import { build, css } from 'dispersa'
+ * import { byType } from 'dispersa/filters'
+ * import { nameKebabCase } from 'dispersa/transforms'
+ *
+ * const result = await build({
+ *   resolver: './tokens.resolver.json',
+ *   buildPath: './output',
+ *   outputs: [
+ *     css({
+ *       name: 'colors-only',
+ *       file: 'colors.css',
+ *       preset: 'standalone',
+ *       selector: ':root',
+ *       filters: [byType('color')],
+ *       transforms: [nameKebabCase()]
+ *     })
+ *   ],
+ *   permutations: [
+ *     { theme: 'light' },
+ *     { theme: 'dark' }
+ *   ]
+ * })
+ * ```
+ */
+declare function build(config: BuildConfig): Promise<BuildResult>;
+declare function buildOrThrow(config: BuildConfig): Promise<BuildResult>;
+declare function buildPermutation(config: BuildConfig, modifierInputs?: ModifierInputs): Promise<BuildResult>;
+declare function resolveTokens(resolver: string | ResolverDocument, modifierInputs?: ModifierInputs, validation?: ValidationOptions): Promise<ResolvedTokens>;
+type LintOptions = {
+    resolver: string | ResolverDocument;
+    modifierInputs?: ModifierInputs;
+    validation?: ValidationOptions;
+} & LintConfig;
+declare function lint(options: LintOptions): Promise<LintResult>;
+declare function resolveAllPermutations(resolver: string | ResolverDocument): Promise<{
+    tokens: ResolvedTokens;
+    modifierInputs: ModifierInputs;
+}[]>;
+declare function generateTypes(tokens: ResolvedTokens, fileName: string, options?: {
+    moduleName?: string;
+}): Promise<void>;
+
+export { type LintOptions as L, buildOrThrow as a, build as b, buildPermutation as c, resolveAllPermutations as d, generateTypes as g, lint as l, resolveTokens as r };

package/dist/errors-qT4sJgSA.d.cts

@@ -0,0 +1,104 @@
+/**
+ * @fileoverview Custom error classes for Dispersa
+ *
+ * Error classes are intentionally kept as simple value objects with no
+ * imports from utility modules. Suggestion formatting is done at call
+ * sites to keep the error hierarchy dependency-free.
+ */
+/**
+ * Base error class for all Dispersa errors
+ */
+declare class DispersaError extends Error {
+    constructor(message: string);
+}
+/**
+ * Thrown when a token reference cannot be resolved
+ *
+ * @param referenceName - The token name that could not be found
+ * @param suggestions - Similar token names for "did you mean?" hints
+ * @param message - Optional custom message (overrides auto-generated message)
+ */
+declare class TokenReferenceError extends DispersaError {
+    referenceName: string;
+    suggestions: string[];
+    constructor(referenceName: string, suggestions?: string[], message?: string);
+    private static formatHint;
+}
+/**
+ * Thrown when a circular reference is detected
+ */
+declare class CircularReferenceError extends DispersaError {
+    tokenName: string;
+    referencePath: string[];
+    constructor(tokenName: string, referencePath: string[]);
+}
+/**
+ * Thrown when validation fails
+ */
+declare class ValidationError extends DispersaError {
+    errors: {
+        message: string;
+        path?: string;
+    }[];
+    constructor(message: string, errors: {
+        message: string;
+        path?: string;
+    }[]);
+}
+/**
+ * Thrown when file operations fail
+ */
+declare class FileOperationError extends DispersaError {
+    operation: 'read' | 'write';
+    filePath: string;
+    originalError: Error;
+    constructor(operation: 'read' | 'write', filePath: string, originalError: Error);
+}
+/**
+ * Thrown when a build configuration is invalid
+ */
+declare class ConfigurationError extends DispersaError {
+    constructor(message: string);
+}
+/**
+ * Thrown when base permutation cannot be determined
+ */
+declare class BasePermutationError extends DispersaError {
+    constructor(message?: string);
+}
+/**
+ * Thrown when an unknown modifier or context is used
+ *
+ * @param modifierName - Name of the modifier that failed validation
+ * @param contextValue - The invalid context value (if applicable)
+ * @param availableValues - Valid options (context names or modifier names) for the error message
+ */
+declare class ModifierError extends DispersaError {
+    modifierName: string;
+    contextValue?: string | undefined;
+    availableValues: string[];
+    constructor(modifierName: string, contextValue?: string | undefined, availableValues?: string[]);
+}
+/**
+ * Thrown when lint errors are found and failOnError is true
+ *
+ * @param issues - Array of lint issues that caused the error
+ */
+declare class LintError extends DispersaError {
+    issues: Array<{
+        ruleId: string;
+        severity: 'error' | 'warn';
+        message: string;
+        tokenName: string;
+        tokenPath: string[];
+    }>;
+    constructor(issues: Array<{
+        ruleId: string;
+        severity: 'error' | 'warn';
+        message: string;
+        tokenName: string;
+        tokenPath: string[];
+    }>);
+}
+
+export { BasePermutationError as B, CircularReferenceError as C, DispersaError as D, FileOperationError as F, LintError as L, ModifierError as M, TokenReferenceError as T, ValidationError as V, ConfigurationError as a };