dispersa 0.4.3 → 1.0.0

package/dist/cli/cli.js

@@ -2,9 +2,60 @@ import { access } from 'fs/promises';
 import { createRequire } from 'module';
 import { dirname, resolve, isAbsolute } from 'path';
 import process from 'process';
-import { Dispersa } from 'dispersa';
+import { build, lint } from 'dispersa';
 import { createJiti } from 'jiti';
 
+// src/cli/cli.ts
+
+// 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",
@@ -27,6 +78,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 +101,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 +156,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,12 +294,28 @@ 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");
 }
+/**
+ * @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.
+ */
 
 export { runCli };
 //# sourceMappingURL=cli.js.map

package/dist/cli/cli.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/cli/cli.ts"],"names":["require"],"mappings":"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","file":"cli.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"]}
+{"version":3,"sources":["../../src/cli/formatters/lint-formatter.ts","../../src/cli/cli.ts"],"names":["require"],"mappings":"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","file":"cli.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"]}

package/dist/cli/config.d.ts

@@ -1,7 +1,328 @@
 import { BuildConfig, ValidationOptions } from 'dispersa';
 
+/**
+ * @fileoverview Token types - extended from schema-generated types
+ *
+ * Base token types are defined manually to match DTCG 2025.10.
+ * This keeps TypeScript types stable while runtime validation relies on
+ * the vendored DTCG JSON Schemas.
+ */
+type JsonPointerReferenceObject = {
+    $ref: string;
+};
+type TokenValueReference = string | JsonPointerReferenceObject;
+type Token = {
+    $value?: TokenValue | TokenValueReference;
+    $ref?: string;
+    $type?: TokenType;
+    $description?: string;
+    $deprecated?: boolean | string;
+    $extensions?: Record<string, unknown>;
+};
+/**
+ * Token type discriminator - union of all valid token type strings
+ *
+ * Represents the possible values for the $type property in DTCG tokens.
+ */
+type TokenType = 'color' | 'dimension' | 'fontFamily' | 'fontWeight' | 'duration' | 'cubicBezier' | 'number' | 'shadow' | 'typography' | 'border' | 'strokeStyle' | 'transition' | 'gradient';
+/**
+ * Token value types - any valid value that can appear in a token
+ *
+ * Represents the possible types for the $value property in tokens.
+ * Can be primitives, objects, or arrays depending on the token type.
+ */
+type TokenValue = string | number | boolean | Record<string, unknown> | unknown[];
+/**
+ * Fully resolved token with computed metadata
+ *
+ * After resolution, tokens include additional metadata like their
+ * full path in the token hierarchy and the original value before
+ * any alias or reference resolution.
+ *
+ * @example
+ * ```typescript
+ * {
+ *   $value: "#ff0000",
+ *   $type: "color",
+ *   path: ["color", "brand", "primary"],
+ *   name: "color.brand.primary",
+ *   originalValue: "{color.red.500}" // Before alias resolution
+ * }
+ * ```
+ */
+type ResolvedToken = Token & {
+    /** Hierarchical path segments (e.g., ['color', 'brand', 'primary']) */
+    path: string[];
+    /** Fully qualified token name (e.g., 'color.brand.primary') */
+    name: string;
+    /**
+     * The raw value before any alias or reference resolution.
+     *
+     * For alias tokens this contains the alias reference string
+     * (e.g., `"{color.primary}"`) or a composite value with embedded
+     * alias references. For non-alias tokens this equals `$value`.
+     *
+     * Use the built-in `isAlias()` / `isBase()` filters or inspect
+     * this value with `getPureAliasReferenceName()` to determine
+     * whether the token was originally an alias.
+     */
+    originalValue: TokenValue;
+};
+/**
+ * Internal resolved token with metadata used by the pipeline and bundlers
+ *
+ * These fields are not part of the DTCG spec and should be stripped before
+ * returning tokens to public callers or rendering output.
+ */
+type InternalResolvedToken = ResolvedToken & {
+    /** Internal: Whether this token was originally an alias (not part of DTCG spec) */
+    _isAlias?: boolean;
+    /** Internal: Source modifier tag for bundle outputs (not part of DTCG spec) */
+    _sourceModifier?: string;
+    /** Internal: Source set name for bundle outputs (not part of DTCG spec) */
+    _sourceSet?: string;
+};
+/**
+ * Internal collection of resolved tokens (with internal metadata)
+ */
+type InternalResolvedTokens = Record<string, InternalResolvedToken>;
+
+/**
+ * @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.
+ */
+/**
+ * @fileoverview Core type definitions for the Dispersa linting system
+ *
+ * Inspired by ESLint and Terrazzo, this system provides a plugin-based
+ * architecture for validating design tokens against semantic rules.
+ */
+
+/**
+ * Lint rule severity levels
+ *
+ * - `'off'` - Rule is disabled
+ * - `'warn'` - Rule issues warnings but doesn't fail the build
+ * - `'error'` - Rule issues errors and fails the build (if failOnError is true)
+ */
+type Severity = 'off' | 'warn' | 'error';
+/**
+ * Metadata describing a lint rule
+ *
+ * @template MessageIds - Union type of message IDs this rule can produce
+ */
+type LintRuleMeta<MessageIds extends string = string> = {
+    /** Short name of the rule (e.g., 'require-description') */
+    name: string;
+    /** Human-readable description of what the rule checks */
+    description: string;
+    /** Optional URL to documentation for this rule */
+    url?: string;
+    /** Map of message IDs to message templates (supports {{placeholder}} interpolation) */
+    messages: Record<MessageIds, string>;
+    /** Token types this rule applies to. Default: 'all' */
+    appliesTo?: TokenType[] | 'all';
+};
+/**
+ * Context object passed to rule's create() function
+ *
+ * Provides access to tokens, configuration, and the report function.
+ *
+ * @template MessageIds - Union type of message IDs this rule can produce
+ * @template Options - Rule-specific options type
+ */
+type LintRuleContext<MessageIds extends string = string, Options extends Record<string, unknown> = Record<string, never>> = {
+    /** Fully qualified rule ID (e.g., 'dispersa/require-description') */
+    id: string;
+    /** Merged options (defaultOptions + user config) */
+    options: Options;
+    /** All resolved tokens to validate */
+    tokens: InternalResolvedTokens;
+    /**
+     * Report a lint issue
+     *
+     * @param descriptor - Issue descriptor with token, message ID, and optional data
+     */
+    report(descriptor: LintReportDescriptor<MessageIds>): void;
+};
+/**
+ * Descriptor for reporting a lint issue
+ *
+ * @template MessageIds - Union type of message IDs this rule can produce
+ */
+type LintReportDescriptor<MessageIds extends string = string> = {
+    /** The token that has the issue */
+    token: ResolvedToken;
+    /** ID of the message to use from rule's meta.messages */
+    messageId: MessageIds;
+    /** Data to interpolate into the message (replaces {{key}} placeholders) */
+    data?: Record<string, string | number>;
+};
+/**
+ * A lint rule definition
+ *
+ * Rules are created using the `createRule()` factory function for type safety.
+ *
+ * @template MessageIds - Union type of message IDs this rule can produce
+ * @template Options - Rule-specific options type
+ *
+ * @example
+ * ```typescript
+ * const myRule: LintRule<'MISSING_VALUE', { required: boolean }> = {
+ *   meta: {
+ *     name: 'require-value',
+ *     description: 'Require tokens to have values',
+ *     messages: {
+ *       MISSING_VALUE: "Token '{{name}}' is missing a value",
+ *     },
+ *   },
+ *   defaultOptions: { required: true },
+ *   create({ tokens, report, options }) {
+ *     for (const token of Object.values(tokens)) {
+ *       if (options.required && !token.$value) {
+ *         report({ token, messageId: 'MISSING_VALUE', data: { name: token.name } })
+ *       }
+ *     }
+ *   },
+ * }
+ * ```
+ */
+type LintRule<MessageIds extends string = string, Options extends Record<string, unknown> = Record<string, never>> = {
+    /** Rule metadata */
+    meta: LintRuleMeta<MessageIds>;
+    /** Default options merged with user config */
+    defaultOptions?: Options;
+    /**
+     * Factory function that creates the rule's validation logic
+     *
+     * Called once per lint run with the context object.
+     *
+     * @param context - Rule context with tokens, options, and report function
+     */
+    create(context: LintRuleContext<MessageIds, Options>): void | Promise<void>;
+};
+/**
+ * Base rule type without generic parameters for use in plugin definitions
+ */
+type AnyLintRule = LintRule<string, Record<string, unknown>>;
+/**
+ * A lint plugin that provides rules and configurations
+ *
+ * @example
+ * ```typescript
+ * const myPlugin: LintPlugin = {
+ *   meta: {
+ *     name: 'my-lint-plugin',
+ *     version: '1.0.0',
+ *   },
+ *   rules: {
+ *     'my-rule': myRule,
+ *   },
+ *   configs: {
+ *     recommended: {
+ *       plugins: { my: myPlugin },
+ *       rules: {
+ *         'my/my-rule': 'warn',
+ *       },
+ *     },
+ *   },
+ * }
+ * ```
+ */
+type LintPlugin = {
+    /** Plugin metadata */
+    meta: {
+        /** Package name (e.g., '@dispersa/lint-plugin-a11y') */
+        name: string;
+        /** Semantic version (optional, for debugging/metadata) */
+        version?: string;
+    };
+    /** Rules provided by this plugin */
+    rules: Record<string, AnyLintRule>;
+    /** Predefined configurations */
+    configs?: Record<string, LintConfig>;
+};
+/**
+ * Rule configuration - either severity only or severity with options
+ *
+ * @example
+ * ```typescript
+ * // Severity only
+ * 'error'
+ *
+ * // Severity with options
+ * ['error', { format: 'kebab-case' }]
+ * ```
+ */
+type RuleConfig = Severity | [Severity, Record<string, unknown>];
+/**
+ * Registry for lint rule options types.
+ *
+ * Built-in dispersa rules are registered via declaration merging in `./rules/index.ts`.
+ * Plugin authors can augment this interface to add their own rule types:
+ *
+ * @example
+ * ```typescript
+ * // In your plugin file
+ * declare module 'dispersa/lint' {
+ *   interface RulesRegistry {
+ *     'my-plugin/my-rule': MyRuleOptions
+ *   }
+ * }
+ * ```
+ */
+interface RulesRegistry {
+}
+/**
+ * Type-safe configuration for a single rule from the registry.
+ *
+ * @template K - The rule ID key from RulesRegistry
+ */
+type RuleConfigFor<K extends keyof RulesRegistry> = Severity | [Severity, RulesRegistry[K]];
+/**
+ * Typed rules configuration with intellisense for all registered rules.
+ *
+ * Provides autocomplete for rule IDs and their option types.
+ * Also allows arbitrary string keys for unregistered rules.
+ */
+type TypedRulesConfig = {
+    [K in keyof RulesRegistry]?: RuleConfigFor<K>;
+} & Record<string, RuleConfig>;
+/**
+ * Lint configuration
+ *
+ * @template Rules - Rules configuration type (defaults to TypedRulesConfig for intellisense)
+ *
+ * @example
+ * ```typescript
+ * const config: LintConfig = {
+ *   plugins: {
+ *     dispersa: dispersaPlugin,
+ *     a11y: '@dispersa/lint-plugin-a11y', // Load by string
+ *   },
+ *   rules: {
+ *     'dispersa/require-description': 'warn',
+ *     'dispersa/naming-convention': ['error', { format: 'kebab-case' }],
+ *     'a11y/min-contrast': ['error', { level: 'AA' }],
+ *   },
+ * }
+ * ```
+ */
+type LintConfig<Rules extends Record<string, RuleConfig> = TypedRulesConfig> = {
+    /** Plugins to load (by object or module path string) */
+    plugins?: Record<string, LintPlugin | string>;
+    /** Rule configurations */
+    rules?: Rules;
+    /** Fail build on lint errors (default: true) */
+    failOnError?: boolean;
+};
+
 type CliConfig = BuildConfig & {
     validation?: ValidationOptions;
+    lint?: LintConfig;
 };
 declare function defineConfig(config: CliConfig): CliConfig;
 

package/dist/cli/config.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/cli/config.ts"],"names":[],"mappings":";AAMO,SAAS,aAAa,MAAA,EAA8B;AACzD,EAAA,OAAO,MAAA;AACT","file":"config.js","sourcesContent":["import type { BuildConfig, ValidationOptions } from 'dispersa'\n\nexport type CliConfig = BuildConfig & {\n  validation?: ValidationOptions\n}\n\nexport function defineConfig(config: CliConfig): CliConfig {\n  return config\n}\n"]}
+{"version":3,"sources":["../../src/cli/config.ts"],"names":[],"mappings":";AAQO,SAAS,aAAa,MAAA,EAA8B;AACzD,EAAA,OAAO,MAAA;AACT","file":"config.js","sourcesContent":["import type { LintConfig } from '@lint/types'\nimport type { BuildConfig, ValidationOptions } from 'dispersa'\n\nexport type CliConfig = BuildConfig & {\n  validation?: ValidationOptions\n  lint?: LintConfig\n}\n\nexport function defineConfig(config: CliConfig): CliConfig {\n  return config\n}\n"]}