dispersa 0.1.1

package/dist/filters.cjs

@@ -0,0 +1,445 @@
+'use strict';
+
+// src/shared/constants.ts
+var DEFAULT_MAX_ALIAS_DEPTH = 10;
+
+// src/shared/errors/index.ts
+var DispersaError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "DispersaError";
+    if (typeof Error.captureStackTrace === "function") {
+      Error.captureStackTrace(this, this.constructor);
+    }
+  }
+};
+var TokenReferenceError = class _TokenReferenceError extends DispersaError {
+  constructor(referenceName, suggestions = [], message) {
+    const hint = _TokenReferenceError.formatHint(suggestions);
+    super(
+      message ?? `Token reference resolution failed: '${referenceName}'. Token does not exist.${hint}`
+    );
+    this.referenceName = referenceName;
+    this.suggestions = suggestions;
+    this.name = "TokenReferenceError";
+  }
+  static formatHint(suggestions) {
+    if (suggestions.length === 0) {
+      return "";
+    }
+    if (suggestions.length === 1) {
+      return ` Did you mean "${suggestions[0]}"?`;
+    }
+    const quoted = suggestions.map((s) => `"${s}"`);
+    const last = quoted.pop();
+    return ` Did you mean ${quoted.join(", ")} or ${last}?`;
+  }
+};
+var CircularReferenceError = class extends DispersaError {
+  constructor(tokenName, referencePath) {
+    super(
+      `Token resolution failed: '${tokenName}'. Circular reference detected in path: ${referencePath.join(" -> ")}`
+    );
+    this.tokenName = tokenName;
+    this.referencePath = referencePath;
+    this.name = "CircularReferenceError";
+  }
+};
+var ValidationError = class extends DispersaError {
+  constructor(message, errors) {
+    super(message);
+    this.errors = errors;
+    this.name = "ValidationError";
+  }
+};
+
+// src/shared/utils/string-similarity.ts
+function levenshteinDistance(a, b) {
+  if (a === b) {
+    return 0;
+  }
+  if (a.length === 0) {
+    return b.length;
+  }
+  if (b.length === 0) {
+    return a.length;
+  }
+  if (a.length > b.length) {
+    [a, b] = [b, a];
+  }
+  const aLen = a.length;
+  const bLen = b.length;
+  let prev = Array.from({ length: aLen + 1 }, (_, i) => i);
+  for (let j = 1; j <= bLen; j++) {
+    const curr = [j];
+    for (let i = 1; i <= aLen; i++) {
+      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+      curr[i] = Math.min(
+        curr[i - 1] + 1,
+        // insertion
+        prev[i] + 1,
+        // deletion
+        prev[i - 1] + cost
+        // substitution
+      );
+    }
+    prev = curr;
+  }
+  return prev[aLen];
+}
+var MIN_EDIT_DISTANCE = 2;
+var SIMILARITY_THRESHOLD_FACTOR = 0.4;
+function findSimilar(target, candidates, maxDistance, maxResults = 3) {
+  if (candidates.length === 0) {
+    return [];
+  }
+  const threshold = Math.max(MIN_EDIT_DISTANCE, Math.ceil(target.length * SIMILARITY_THRESHOLD_FACTOR));
+  const scored = candidates.map((candidate) => ({
+    value: candidate,
+    distance: levenshteinDistance(target.toLowerCase(), candidate.toLowerCase())
+  })).filter((entry) => entry.distance <= threshold && entry.distance > 0).sort((a, b) => a.distance - b.distance);
+  return scored.slice(0, maxResults).map((entry) => entry.value);
+}
+
+// src/shared/utils/token-utils.ts
+function getPureAliasReferenceName(value) {
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  const match = /^\{([^}]+)\}$/.exec(value);
+  return match?.[1]?.trim();
+}
+
+// src/shared/utils/validation-handler.ts
+var ValidationHandler = class {
+  mode;
+  constructor(options) {
+    this.mode = options?.mode ?? "error";
+  }
+  /**
+   * Whether validation checks should run (mode is not 'off')
+   */
+  shouldValidate() {
+    return this.mode !== "off";
+  }
+  /**
+   * Whether the current mode is 'error' (strictest)
+   */
+  isStrict() {
+    return this.mode === "error";
+  }
+  /**
+   * Handle a validation issue: throw in 'error' mode, warn in 'warn' mode, ignore in 'off' mode
+   */
+  handleIssue(error) {
+    if (this.mode === "error") {
+      throw error;
+    }
+    if (this.mode === "warn") {
+      console.warn(error.message);
+    }
+  }
+  /**
+   * Emit a warning (in 'error' and 'warn' modes, skip in 'off')
+   */
+  warn(message) {
+    if (this.mode === "off") {
+      return;
+    }
+    console.warn(message);
+  }
+};
+
+// src/lib/resolution/alias-resolver.ts
+var AliasResolver = class _AliasResolver {
+  options;
+  resolving;
+  validationHandler;
+  constructor(options = {}) {
+    this.options = {
+      maxDepth: DEFAULT_MAX_ALIAS_DEPTH,
+      ...options
+    };
+    this.resolving = /* @__PURE__ */ new Set();
+    this.validationHandler = new ValidationHandler(options.validation);
+  }
+  /**
+   * Resolve all aliases in a token collection
+   *
+   * Processes each token and resolves any alias references (e.g., `{token.name}`)
+   * to their actual values. Detects circular references and enforces maximum depth.
+   *
+   * @param tokens - Collection of tokens to resolve aliases in
+   * @returns New collection with all aliases resolved to their values
+   * @throws {CircularReferenceError} If circular reference detected
+   * @throws {TokenReferenceError} If referenced token not found (when validate enabled)
+   */
+  resolve(tokens) {
+    const result = {};
+    for (const [name, token] of Object.entries(tokens)) {
+      this.resolving.clear();
+      result[name] = this.resolveToken(name, token, tokens, 0);
+    }
+    return result;
+  }
+  /**
+   * Resolve aliases in a single token
+   */
+  resolveToken(name, token, allTokens, depth) {
+    this.assertMaxDepth(name, depth);
+    this.assertNotCircular(name);
+    this.resolving.add(name);
+    try {
+      const hadAlias = _AliasResolver.hasAliases(token.$value ?? "");
+      const pureAliasReferenceName = getPureAliasReferenceName(token.$value ?? "");
+      if (pureAliasReferenceName !== void 0) {
+        return this.resolvePureAliasToken(
+          name,
+          token,
+          allTokens,
+          depth,
+          hadAlias,
+          pureAliasReferenceName
+        );
+      }
+      return this.resolveInlineAliasToken(name, token, allTokens, depth, hadAlias);
+    } finally {
+      this.resolving.delete(name);
+    }
+  }
+  assertMaxDepth(name, depth) {
+    const maxDepth = this.options.maxDepth ?? DEFAULT_MAX_ALIAS_DEPTH;
+    if (depth <= maxDepth) {
+      return;
+    }
+    throw new ValidationError(`Maximum alias resolution depth exceeded for token: ${name}`, [
+      { message: `Maximum alias resolution depth exceeded for token: ${name}` }
+    ]);
+  }
+  assertNotCircular(name) {
+    if (!this.resolving.has(name)) {
+      return;
+    }
+    throw new CircularReferenceError(name, Array.from(this.resolving));
+  }
+  resolvePureAliasToken(name, token, allTokens, depth, hadAlias, referenceName) {
+    try {
+      const referencedToken = this.resolveReferenceToken(referenceName, allTokens, depth);
+      if (referencedToken === void 0) {
+        return this.withAliasMarker(token, token.$value, hadAlias);
+      }
+      const updatedType = this.getTypeAfterCompatibilityCheck(
+        token.$type,
+        referencedToken.$type,
+        name,
+        referenceName
+      );
+      return this.withAliasMarker(
+        {
+          ...token,
+          $type: updatedType
+        },
+        referencedToken.$value ?? "",
+        hadAlias
+      );
+    } catch (error) {
+      return this.handleAliasError(error, name, token, hadAlias);
+    }
+  }
+  resolveInlineAliasToken(name, token, allTokens, depth, hadAlias) {
+    try {
+      const resolvedValue = this.resolveValue(token.$value ?? "", allTokens, depth);
+      return this.withAliasMarker(token, resolvedValue, hadAlias);
+    } catch (error) {
+      return this.handleAliasError(error, name, token, hadAlias);
+    }
+  }
+  withAliasMarker(token, value, hadAlias) {
+    return {
+      ...token,
+      $value: value,
+      _isAlias: hadAlias
+    };
+  }
+  /**
+   * Resolve aliases in a value
+   */
+  resolveValue(value, allTokens, depth) {
+    if (typeof value === "string") {
+      return this.resolveStringValue(value, allTokens, depth);
+    }
+    if (Array.isArray(value)) {
+      return value.map((item) => this.resolveValue(item, allTokens, depth));
+    }
+    if (typeof value === "object" && value != null) {
+      const result = {};
+      for (const [key, val] of Object.entries(value)) {
+        result[key] = this.resolveValue(val, allTokens, depth);
+      }
+      return result;
+    }
+    return value;
+  }
+  /**
+   * Resolve aliases in a string value
+   */
+  resolveStringValue(value, allTokens, depth) {
+    const fullReferenceMatch = /^\{([^}]+)\}$/.exec(value);
+    if (fullReferenceMatch != null) {
+      const referenceName = fullReferenceMatch[1];
+      if (referenceName != null) {
+        return this.resolveReference(referenceName, allTokens, depth);
+      }
+    }
+    if (value.includes("{")) {
+      return value.replace(/\{([^}]+)\}/g, (_match, referenceName) => {
+        const resolved = this.resolveReference(referenceName, allTokens, depth);
+        if (typeof resolved === "string" || typeof resolved === "number" || typeof resolved === "boolean") {
+          return String(resolved);
+        }
+        return JSON.stringify(resolved);
+      });
+    }
+    return value;
+  }
+  /**
+   * Resolve a single reference (whole token only)
+   *
+   * Per DTCG spec, curly brace syntax only supports whole token references.
+   * Property-level references must use JSON Pointer syntax ($ref).
+   *
+   * Examples:
+   * - `{color.primary}` - whole token reference ✅
+   * - `{color.primary.components.0}` - NOT supported (use $ref with JSON Pointer) ❌
+   */
+  resolveReference(referenceName, allTokens, depth) {
+    const cleanName = referenceName.trim();
+    const referencedToken = allTokens[cleanName];
+    if (referencedToken == null) {
+      const suggestions = findSimilar(cleanName, Object.keys(allTokens));
+      this.validationHandler.handleIssue(new TokenReferenceError(cleanName, suggestions));
+      this.validationHandler.warn(`Unresolved token reference: "${cleanName}"`);
+      return `{${cleanName}}`;
+    }
+    const resolved = this.resolveToken(cleanName, referencedToken, allTokens, depth + 1);
+    return resolved.$value ?? "";
+  }
+  resolveReferenceToken(referenceName, allTokens, depth) {
+    const cleanName = referenceName.trim();
+    const referencedToken = allTokens[cleanName];
+    if (referencedToken == null) {
+      const suggestions = findSimilar(cleanName, Object.keys(allTokens));
+      this.validationHandler.handleIssue(new TokenReferenceError(cleanName, suggestions));
+      this.validationHandler.warn(`Unresolved token reference: "${cleanName}"`);
+      return void 0;
+    }
+    return this.resolveToken(cleanName, referencedToken, allTokens, depth + 1);
+  }
+  getTypeAfterCompatibilityCheck(declaredType, referencedType, tokenName, referenceName) {
+    const declared = typeof declaredType === "string" ? declaredType : void 0;
+    const referenced = typeof referencedType === "string" ? referencedType : void 0;
+    if (declared !== void 0 && referenced !== void 0 && declared !== referenced) {
+      this.handleTypeMismatch(tokenName, referenceName, declared, referenced);
+      return declaredType;
+    }
+    if (declared === void 0 && referenced !== void 0) {
+      return referenced;
+    }
+    return declaredType;
+  }
+  handleTypeMismatch(tokenName, referenceName, declaredType, referencedType) {
+    const message = `Alias type mismatch for "${tokenName}": declared "$type" is "${declaredType}" but referenced token "${referenceName}" has "$type" "${referencedType}".`;
+    this.validationHandler.handleIssue(new ValidationError(message, [{ message }]));
+  }
+  /**
+   * Check if a value contains aliases
+   */
+  static hasAliases(value) {
+    if (typeof value === "string") {
+      return value.includes("{") && value.includes("}");
+    }
+    if (Array.isArray(value)) {
+      return value.some((item) => _AliasResolver.hasAliases(item));
+    }
+    if (typeof value === "object" && value != null) {
+      return Object.values(value).some((val) => _AliasResolver.hasAliases(val));
+    }
+    return false;
+  }
+  /**
+   * Extract all alias references from a value
+   */
+  static extractReferences(value) {
+    const references = [];
+    if (typeof value === "string") {
+      const matches = value.matchAll(/\{([^}]+)\}/g);
+      for (const match of matches) {
+        const ref = match[1];
+        if (ref != null) {
+          references.push(ref.trim());
+        }
+      }
+    } else if (Array.isArray(value)) {
+      for (const item of value) {
+        references.push(..._AliasResolver.extractReferences(item));
+      }
+    } else if (typeof value === "object" && value != null) {
+      for (const val of Object.values(value)) {
+        references.push(..._AliasResolver.extractReferences(val));
+      }
+    }
+    return references;
+  }
+  handleAliasError(error, name, token, hadAlias) {
+    if (error instanceof Error) {
+      this.validationHandler.handleIssue(error);
+    } else {
+      this.validationHandler.handleIssue(new Error(String(error)));
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    this.validationHandler.warn(`Alias resolution skipped for "${name}": ${message}`);
+    return {
+      ...token,
+      $value: token.$value,
+      _isAlias: hadAlias
+    };
+  }
+};
+
+// src/lib/processing/processors/filters/built-in.ts
+function byType(type) {
+  return {
+    filter: (token) => token.$type === type
+  };
+}
+function byPath(pattern) {
+  const regex = typeof pattern === "string" ? new RegExp(`^${pattern}`) : pattern;
+  return {
+    filter: (token) => {
+      const fullPath = token.path.join(".");
+      return regex.test(fullPath);
+    }
+  };
+}
+function isAlias() {
+  return {
+    filter: (token) => AliasResolver.hasAliases(token.originalValue)
+  };
+}
+function isBase() {
+  return {
+    filter: (token) => !AliasResolver.hasAliases(token.originalValue)
+  };
+}
+/**
+ * @license
+ * Copyright (c) 2025 Dispersa Contributors
+ * SPDX-License-Identifier: MIT
+ */
+
+exports.byPath = byPath;
+exports.byType = byType;
+exports.isAlias = isAlias;
+exports.isBase = isBase;
+//# sourceMappingURL=filters.cjs.map
+//# sourceMappingURL=filters.cjs.map

package/dist/filters.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/shared/constants.ts","../src/shared/errors/index.ts","../src/shared/utils/string-similarity.ts","../src/shared/utils/token-utils.ts","../src/shared/utils/validation-handler.ts","../src/lib/resolution/alias-resolver.ts","../src/lib/processing/processors/filters/built-in.ts"],"names":[],"mappings":"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","file":"filters.cjs","sourcesContent":["/**\n * @fileoverview Global constants\n */\n\n/**\n * Default maximum depth for alias resolution\n * Prevents infinite recursion in circular references\n */\nexport const DEFAULT_MAX_ALIAS_DEPTH = 10\n\n/**\n * Default base font size in pixels for rem/em conversions\n */\nexport const DEFAULT_BASE_FONT_SIZE_PX = 16\n","/**\n * @fileoverview Custom error classes for Dispersa\n *\n * Error classes are intentionally kept as simple value objects with no\n * imports from utility modules. Suggestion formatting is done at call\n * sites to keep the error hierarchy dependency-free.\n */\n\n/**\n * Base error class for all Dispersa errors\n */\nexport class DispersaError extends Error {\n  constructor(message: string) {\n    super(message)\n    this.name = 'DispersaError'\n    // Maintains proper stack trace for where our error was thrown (only available on V8)\n    if (typeof Error.captureStackTrace === 'function') {\n      Error.captureStackTrace(this, this.constructor)\n    }\n  }\n}\n\n/**\n * Thrown when a token reference cannot be resolved\n *\n * @param referenceName - The token name that could not be found\n * @param suggestions - Similar token names for \"did you mean?\" hints\n * @param message - Optional custom message (overrides auto-generated message)\n */\nexport class TokenReferenceError extends DispersaError {\n  constructor(\n    public referenceName: string,\n    public suggestions: string[] = [],\n    message?: string,\n  ) {\n    const hint = TokenReferenceError.formatHint(suggestions)\n    super(\n      message ??\n        `Token reference resolution failed: '${referenceName}'. Token does not exist.${hint}`,\n    )\n    this.name = 'TokenReferenceError'\n  }\n\n  private static formatHint(suggestions: string[]): string {\n    if (suggestions.length === 0) {\n      return ''\n    }\n    if (suggestions.length === 1) {\n      return ` Did you mean \"${suggestions[0]}\"?`\n    }\n    const quoted = suggestions.map((s) => `\"${s}\"`)\n    const last = quoted.pop()!\n    return ` Did you mean ${quoted.join(', ')} or ${last}?`\n  }\n}\n\n/**\n * Thrown when a circular reference is detected\n */\nexport class CircularReferenceError extends DispersaError {\n  constructor(\n    public tokenName: string,\n    public referencePath: string[],\n  ) {\n    super(\n      `Token resolution failed: '${tokenName}'. Circular reference detected in path: ${referencePath.join(' -> ')}`,\n    )\n    this.name = 'CircularReferenceError'\n  }\n}\n\n/**\n * Thrown when validation fails\n */\nexport class ValidationError extends DispersaError {\n  constructor(\n    message: string,\n    public errors: { message: string; path?: string }[],\n  ) {\n    super(message)\n    this.name = 'ValidationError'\n  }\n}\n\n/**\n * Thrown when a color format cannot be parsed\n */\nexport class ColorParseError extends DispersaError {\n  constructor(public colorValue: string) {\n    super(`Color parsing failed: '${colorValue}'. Provide a valid CSS color or DTCG color object.`)\n    this.name = 'ColorParseError'\n  }\n}\n\n/**\n * Thrown when a dimension format is invalid\n */\nexport class DimensionFormatError extends DispersaError {\n  constructor(public dimensionValue: string) {\n    super(`Dimension parsing failed: '${dimensionValue}'. Provide a valid DTCG dimension object.`)\n    this.name = 'DimensionFormatError'\n  }\n}\n\n/**\n * Thrown when file operations fail\n */\nexport class FileOperationError extends DispersaError {\n  constructor(\n    public operation: 'read' | 'write',\n    public filePath: string,\n    public originalError: Error,\n  ) {\n    super(`Failed to ${operation} file: ${filePath}. ${originalError.message}`)\n    this.name = 'FileOperationError'\n  }\n}\n\n/**\n * Thrown when a build configuration is invalid\n */\nexport class ConfigurationError extends DispersaError {\n  constructor(message: string) {\n    super(message)\n    this.name = 'ConfigurationError'\n  }\n}\n\n/**\n * Thrown when base permutation cannot be determined\n */\nexport class BasePermutationError extends DispersaError {\n  constructor(\n    message = 'Base permutation determination failed. Define a default modifier in resolver.',\n  ) {\n    super(message)\n    this.name = 'BasePermutationError'\n  }\n}\n\n/**\n * Thrown when an unknown modifier or context is used\n *\n * @param modifierName - Name of the modifier that failed validation\n * @param contextValue - The invalid context value (if applicable)\n * @param availableValues - Valid options (context names or modifier names) for the error message\n */\nexport class ModifierError extends DispersaError {\n  constructor(\n    public modifierName: string,\n    public contextValue?: string,\n    public availableValues: string[] = [],\n  ) {\n    const available = availableValues.length > 0 ? ` Available: ${availableValues.join(', ')}.` : ''\n\n    const message =\n      contextValue != null && contextValue !== ''\n        ? `Modifier validation failed: '${modifierName}'. Invalid context '${contextValue}'.${available}`\n        : `Modifier validation failed: '${modifierName}'. Modifier not defined in resolver.${available}`\n    super(message)\n    this.name = 'ModifierError'\n  }\n}\n","/**\n * @fileoverview String similarity utilities for \"did you mean?\" suggestions\n *\n * Uses Levenshtein distance to find close matches when users reference\n * nonexistent tokens, modifiers, or contexts.\n */\n\n/**\n * Compute the Levenshtein edit distance between two strings.\n *\n * Uses the classic dynamic-programming algorithm with O(min(a,b)) space.\n *\n * @param a - First string\n * @param b - Second string\n * @returns Number of single-character edits (insert, delete, replace)\n */\nexport function levenshteinDistance(a: string, b: string): number {\n  if (a === b) {\n    return 0\n  }\n  if (a.length === 0) {\n    return b.length\n  }\n  if (b.length === 0) {\n    return a.length\n  }\n\n  // Ensure `a` is the shorter string for O(min(a,b)) space\n  if (a.length > b.length) {\n    ;[a, b] = [b, a]\n  }\n\n  const aLen = a.length\n  const bLen = b.length\n\n  // Single row of the DP matrix\n  let prev = Array.from({ length: aLen + 1 }, (_, i) => i)\n\n  for (let j = 1; j <= bLen; j++) {\n    const curr = [j] as number[]\n    for (let i = 1; i <= aLen; i++) {\n      const cost = a[i - 1] === b[j - 1] ? 0 : 1\n      curr[i] = Math.min(\n        curr[i - 1]! + 1, // insertion\n        prev[i]! + 1, // deletion\n        prev[i - 1]! + cost, // substitution\n      )\n    }\n    prev = curr\n  }\n\n  return prev[aLen]!\n}\n\n/** Minimum edit distance threshold for \"did you mean?\" suggestions */\nconst MIN_EDIT_DISTANCE = 2\n\n/** Fraction of target string length used to auto-scale the max distance */\nconst SIMILARITY_THRESHOLD_FACTOR = 0.4\n\n/**\n * Find strings from `candidates` that are similar to `target`.\n *\n * Returns candidates sorted by distance (closest first), filtered to\n * those within `maxDistance`. A good default for maxDistance is roughly\n * 40% of the target length (minimum 2).\n *\n * @param target - The string the user typed\n * @param candidates - Available valid strings to match against\n * @param maxDistance - Maximum edit distance to consider (default: auto-scaled)\n * @returns Array of similar strings, closest first (at most `maxResults`)\n */\nexport function findSimilar(\n  target: string,\n  candidates: string[],\n  maxDistance?: number,\n  maxResults = 3,\n): string[] {\n  if (candidates.length === 0) {\n    return []\n  }\n\n  const threshold =\n    maxDistance ??\n    Math.max(MIN_EDIT_DISTANCE, Math.ceil(target.length * SIMILARITY_THRESHOLD_FACTOR))\n\n  const scored = candidates\n    .map((candidate) => ({\n      value: candidate,\n      distance: levenshteinDistance(target.toLowerCase(), candidate.toLowerCase()),\n    }))\n    .filter((entry) => entry.distance <= threshold && entry.distance > 0)\n    .sort((a, b) => a.distance - b.distance)\n\n  return scored.slice(0, maxResults).map((entry) => entry.value)\n}\n","/**\n * @fileoverview Token utility functions\n */\n\nimport type { InternalResolvedTokens, ResolvedToken, ResolvedTokens } from '@lib/tokens/types'\n\n/**\n * Format deprecation message for a token\n *\n * Generates a standardized deprecation message that can be used in comments,\n * descriptions, or warnings. Handles both boolean and string deprecation values.\n *\n * @param token - Token with optional deprecation information\n * @param description - Optional existing description to prepend deprecation info to\n * @param format - Output format: 'comment' for CSS comments, 'bracket' for [DEPRECATED] prefix\n * @returns Formatted deprecation message or description with deprecation prefix\n *\n * @example\n * ```typescript\n * // CSS comment format\n * formatDeprecationMessage(token, '', 'comment')\n * // Returns: \"DEPRECATED: Use new-token instead\"\n *\n * // Bracket format\n * formatDeprecationMessage(token, 'Primary color', 'bracket')\n * // Returns: \"[DEPRECATED: Use new-token instead] Primary color\"\n * ```\n */\nexport function formatDeprecationMessage(\n  token: ResolvedToken,\n  description: string = '',\n  format: 'comment' | 'bracket' = 'bracket',\n): string {\n  if (token.$deprecated == null || token.$deprecated === false) {\n    return description\n  }\n\n  const deprecationMsg = typeof token.$deprecated === 'string' ? token.$deprecated : ''\n\n  if (format === 'comment') {\n    // CSS comment format: \"DEPRECATED: message\" or just \"DEPRECATED\"\n    const msg = deprecationMsg ? ` ${deprecationMsg}` : ''\n    return `DEPRECATED${msg}`\n  } else {\n    // Bracket format: \"[DEPRECATED: message]\" or \"[DEPRECATED]\"\n    const msg = deprecationMsg ? `: ${deprecationMsg}` : ''\n    const prefix = `[DEPRECATED${msg}]`\n    return description ? `${prefix} ${description}` : prefix\n  }\n}\n\n/**\n * Strip internal metadata from tokens before public output\n */\nexport function stripInternalTokenMetadata(tokens: InternalResolvedTokens): ResolvedTokens {\n  const cleaned: ResolvedTokens = {}\n\n  for (const [name, token] of Object.entries(tokens)) {\n    const { _isAlias: _alias, _sourceModifier: _source, _sourceSet: _sourceSet, ...rest } = token\n    cleaned[name] = rest\n  }\n\n  return cleaned\n}\n\n/**\n * Get sorted token entries for deterministic output ordering\n */\nexport function getSortedTokenEntries(\n  tokens: ResolvedTokens,\n): Array<[name: string, token: ResolvedToken]> {\n  return Object.entries(tokens).sort(([nameA], [nameB]) => nameA.localeCompare(nameB))\n}\n\n/**\n * Check if a value looks like a DTCG token (has `$value` or `$ref` property).\n *\n * This is the base structural check shared by parsers, validators, and resolvers.\n * Individual modules may wrap this in a type-guard to narrow to their own token types.\n */\nexport function isTokenLike(value: unknown): boolean {\n  return typeof value === 'object' && value !== null && ('$value' in value || '$ref' in value)\n}\n\n/**\n * Extract a pure alias reference name from a string value.\n *\n * Returns the inner token name for \"{token.name}\" inputs and undefined otherwise.\n */\nexport function getPureAliasReferenceName(value: unknown): string | undefined {\n  if (typeof value !== 'string') {\n    return undefined\n  }\n  const match = /^\\{([^}]+)\\}$/.exec(value)\n  return match?.[1]?.trim()\n}\n","/**\n * @fileoverview Shared validation handler for consistent validation mode behavior\n *\n * Provides a single source of truth for validation mode checking, error handling,\n * and warning dispatch across all Dispersa components.\n */\n\nimport type { ValidationMode, ValidationOptions } from '@shared/types/validation'\n\n/**\n * Centralized validation handler that all components share.\n *\n * Caches the warning handler and mode at construction time so that\n * repeated calls avoid re-reading options on every invocation.\n */\nexport class ValidationHandler {\n  private mode: ValidationMode\n\n  constructor(options?: ValidationOptions) {\n    this.mode = options?.mode ?? 'error'\n  }\n\n  /**\n   * Whether validation checks should run (mode is not 'off')\n   */\n  shouldValidate(): boolean {\n    return this.mode !== 'off'\n  }\n\n  /**\n   * Whether the current mode is 'error' (strictest)\n   */\n  isStrict(): boolean {\n    return this.mode === 'error'\n  }\n\n  /**\n   * Handle a validation issue: throw in 'error' mode, warn in 'warn' mode, ignore in 'off' mode\n   */\n  handleIssue(error: Error): void {\n    if (this.mode === 'error') {\n      throw error\n    }\n    if (this.mode === 'warn') {\n      // eslint-disable-next-line no-console\n      console.warn(error.message)\n    }\n  }\n\n  /**\n   * Emit a warning (in 'error' and 'warn' modes, skip in 'off')\n   */\n  warn(message: string): void {\n    if (this.mode === 'off') {\n      return\n    }\n    // eslint-disable-next-line no-console\n    console.warn(message)\n  }\n}\n","/**\n * @fileoverview Token alias resolver with circular reference detection\n * Resolves {tokenName} references in token values\n */\n\nimport type { InternalResolvedToken, InternalResolvedTokens, TokenValue } from '@lib/tokens/types'\nimport { DEFAULT_MAX_ALIAS_DEPTH } from '@shared/constants'\nimport { CircularReferenceError, TokenReferenceError, ValidationError } from '@shared/errors/index'\nimport type { ValidationOptions } from '@shared/types/validation'\nimport { findSimilar } from '@shared/utils/string-similarity'\nimport { getPureAliasReferenceName } from '@shared/utils/token-utils'\nimport { ValidationHandler } from '@shared/utils/validation-handler'\n\nexport type AliasResolutionOptions = {\n  maxDepth?: number\n  /**\n   * Enable validation mode (throws errors on missing references)\n   * When false, unresolved references are left as-is\n   * Default: true\n   */\n  validation?: ValidationOptions\n}\n\nexport class AliasResolver {\n  private options: AliasResolutionOptions\n  private resolving: Set<string>\n  private validationHandler: ValidationHandler\n\n  constructor(options: AliasResolutionOptions = {}) {\n    this.options = {\n      maxDepth: DEFAULT_MAX_ALIAS_DEPTH,\n      ...options,\n    }\n    this.resolving = new Set()\n    this.validationHandler = new ValidationHandler(options.validation)\n  }\n\n  /**\n   * Resolve all aliases in a token collection\n   *\n   * Processes each token and resolves any alias references (e.g., `{token.name}`)\n   * to their actual values. Detects circular references and enforces maximum depth.\n   *\n   * @param tokens - Collection of tokens to resolve aliases in\n   * @returns New collection with all aliases resolved to their values\n   * @throws {CircularReferenceError} If circular reference detected\n   * @throws {TokenReferenceError} If referenced token not found (when validate enabled)\n   */\n  resolve(tokens: InternalResolvedTokens): InternalResolvedTokens {\n    const result: InternalResolvedTokens = {}\n\n    for (const [name, token] of Object.entries(tokens)) {\n      this.resolving.clear() // Clear for each top-level token\n      result[name] = this.resolveToken(name, token, tokens, 0)\n    }\n\n    return result\n  }\n\n  /**\n   * Resolve aliases in a single token\n   */\n  private resolveToken(\n    name: string,\n    token: InternalResolvedToken,\n    allTokens: InternalResolvedTokens,\n    depth: number,\n  ): InternalResolvedToken {\n    this.assertMaxDepth(name, depth)\n    this.assertNotCircular(name)\n\n    this.resolving.add(name)\n    try {\n      const hadAlias = AliasResolver.hasAliases((token.$value ?? '') as TokenValue)\n      const pureAliasReferenceName = getPureAliasReferenceName((token.$value ?? '') as TokenValue)\n\n      if (pureAliasReferenceName !== undefined) {\n        return this.resolvePureAliasToken(\n          name,\n          token,\n          allTokens,\n          depth,\n          hadAlias,\n          pureAliasReferenceName,\n        )\n      }\n\n      return this.resolveInlineAliasToken(name, token, allTokens, depth, hadAlias)\n    } finally {\n      this.resolving.delete(name)\n    }\n  }\n\n  private assertMaxDepth(name: string, depth: number): void {\n    const maxDepth = this.options.maxDepth ?? DEFAULT_MAX_ALIAS_DEPTH\n    if (depth <= maxDepth) {\n      return\n    }\n\n    throw new ValidationError(`Maximum alias resolution depth exceeded for token: ${name}`, [\n      { message: `Maximum alias resolution depth exceeded for token: ${name}` },\n    ])\n  }\n\n  private assertNotCircular(name: string): void {\n    if (!this.resolving.has(name)) {\n      return\n    }\n    throw new CircularReferenceError(name, Array.from(this.resolving))\n  }\n\n  private resolvePureAliasToken(\n    name: string,\n    token: InternalResolvedToken,\n    allTokens: InternalResolvedTokens,\n    depth: number,\n    hadAlias: boolean,\n    referenceName: string,\n  ): InternalResolvedToken {\n    try {\n      const referencedToken = this.resolveReferenceToken(referenceName, allTokens, depth)\n      if (referencedToken === undefined) {\n        return this.withAliasMarker(token, token.$value, hadAlias)\n      }\n\n      const updatedType = this.getTypeAfterCompatibilityCheck(\n        token.$type,\n        referencedToken.$type,\n        name,\n        referenceName,\n      )\n\n      return this.withAliasMarker(\n        {\n          ...token,\n          $type: updatedType,\n        },\n        (referencedToken.$value ?? '') as TokenValue,\n        hadAlias,\n      )\n    } catch (error) {\n      return this.handleAliasError(error, name, token, hadAlias)\n    }\n  }\n\n  private resolveInlineAliasToken(\n    name: string,\n    token: InternalResolvedToken,\n    allTokens: InternalResolvedTokens,\n    depth: number,\n    hadAlias: boolean,\n  ): InternalResolvedToken {\n    try {\n      const resolvedValue = this.resolveValue((token.$value ?? '') as TokenValue, allTokens, depth)\n      return this.withAliasMarker(token, resolvedValue, hadAlias)\n    } catch (error) {\n      return this.handleAliasError(error, name, token, hadAlias)\n    }\n  }\n\n  private withAliasMarker(\n    token: InternalResolvedToken,\n    value: TokenValue | undefined,\n    hadAlias: boolean,\n  ): InternalResolvedToken {\n    return {\n      ...token,\n      $value: value,\n      _isAlias: hadAlias,\n    }\n  }\n\n  /**\n   * Resolve aliases in a value\n   */\n  private resolveValue(\n    value: TokenValue,\n    allTokens: InternalResolvedTokens,\n    depth: number,\n  ): TokenValue {\n    if (typeof value === 'string') {\n      return this.resolveStringValue(value, allTokens, depth)\n    }\n\n    if (Array.isArray(value)) {\n      return value.map((item) => this.resolveValue(item as TokenValue, allTokens, depth))\n    }\n\n    if (typeof value === 'object' && value != null) {\n      const result: Record<string, unknown> = {}\n      for (const [key, val] of Object.entries(value)) {\n        result[key] = this.resolveValue(val as TokenValue, allTokens, depth)\n      }\n      return result\n    }\n\n    return value\n  }\n\n  /**\n   * Resolve aliases in a string value\n   */\n  private resolveStringValue(\n    value: string,\n    allTokens: InternalResolvedTokens,\n    depth: number,\n  ): TokenValue {\n    // Check if the entire value is an alias reference\n    const fullReferenceMatch = /^\\{([^}]+)\\}$/.exec(value)\n    if (fullReferenceMatch != null) {\n      const referenceName = fullReferenceMatch[1]\n      if (referenceName != null) {\n        return this.resolveReference(referenceName, allTokens, depth)\n      }\n    }\n\n    // Check for inline aliases (e.g., \"2px solid {color.primary}\")\n    if (value.includes('{')) {\n      return value.replace(/\\{([^}]+)\\}/g, (_match, referenceName: string) => {\n        const resolved = this.resolveReference(referenceName, allTokens, depth)\n        if (\n          typeof resolved === 'string' ||\n          typeof resolved === 'number' ||\n          typeof resolved === 'boolean'\n        ) {\n          return String(resolved)\n        }\n        return JSON.stringify(resolved)\n      })\n    }\n\n    return value\n  }\n\n  /**\n   * Resolve a single reference (whole token only)\n   *\n   * Per DTCG spec, curly brace syntax only supports whole token references.\n   * Property-level references must use JSON Pointer syntax ($ref).\n   *\n   * Examples:\n   * - `{color.primary}` - whole token reference ✅\n   * - `{color.primary.components.0}` - NOT supported (use $ref with JSON Pointer) ❌\n   */\n  private resolveReference(\n    referenceName: string,\n    allTokens: InternalResolvedTokens,\n    depth: number,\n  ): TokenValue {\n    const cleanName = referenceName.trim()\n\n    // Look up the token by its full name (no property-level access)\n    const referencedToken = allTokens[cleanName]\n\n    if (referencedToken == null) {\n      const suggestions = findSimilar(cleanName, Object.keys(allTokens))\n      this.validationHandler.handleIssue(new TokenReferenceError(cleanName, suggestions))\n      this.validationHandler.warn(`Unresolved token reference: \"${cleanName}\"`)\n      return `{${cleanName}}`\n    }\n\n    // Recursively resolve the referenced token\n    const resolved = this.resolveToken(cleanName, referencedToken, allTokens, depth + 1)\n\n    return (resolved.$value ?? '') as TokenValue\n  }\n\n  private resolveReferenceToken(\n    referenceName: string,\n    allTokens: InternalResolvedTokens,\n    depth: number,\n  ): InternalResolvedToken | undefined {\n    const cleanName = referenceName.trim()\n    const referencedToken = allTokens[cleanName]\n\n    if (referencedToken == null) {\n      const suggestions = findSimilar(cleanName, Object.keys(allTokens))\n      this.validationHandler.handleIssue(new TokenReferenceError(cleanName, suggestions))\n      this.validationHandler.warn(`Unresolved token reference: \"${cleanName}\"`)\n      return undefined\n    }\n\n    return this.resolveToken(cleanName, referencedToken, allTokens, depth + 1)\n  }\n\n  private getTypeAfterCompatibilityCheck(\n    declaredType: unknown,\n    referencedType: unknown,\n    tokenName: string,\n    referenceName: string,\n  ): InternalResolvedToken['$type'] {\n    const declared = typeof declaredType === 'string' ? declaredType : undefined\n    const referenced = typeof referencedType === 'string' ? referencedType : undefined\n\n    if (declared !== undefined && referenced !== undefined && declared !== referenced) {\n      this.handleTypeMismatch(tokenName, referenceName, declared, referenced)\n      return declaredType as InternalResolvedToken['$type']\n    }\n\n    if (declared === undefined && referenced !== undefined) {\n      return referenced as InternalResolvedToken['$type']\n    }\n\n    return declaredType as InternalResolvedToken['$type']\n  }\n\n  private handleTypeMismatch(\n    tokenName: string,\n    referenceName: string,\n    declaredType: string,\n    referencedType: string,\n  ): void {\n    const message =\n      `Alias type mismatch for \"${tokenName}\": declared \"$type\" is \"${declaredType}\" ` +\n      `but referenced token \"${referenceName}\" has \"$type\" \"${referencedType}\".`\n\n    this.validationHandler.handleIssue(new ValidationError(message, [{ message }]))\n  }\n\n  /**\n   * Check if a value contains aliases\n   */\n  static hasAliases(value: TokenValue): boolean {\n    if (typeof value === 'string') {\n      return value.includes('{') && value.includes('}')\n    }\n\n    if (Array.isArray(value)) {\n      return value.some((item) => AliasResolver.hasAliases(item as TokenValue))\n    }\n\n    if (typeof value === 'object' && value != null) {\n      return Object.values(value).some((val) => AliasResolver.hasAliases(val as TokenValue))\n    }\n\n    return false\n  }\n\n  /**\n   * Extract all alias references from a value\n   */\n  static extractReferences(value: TokenValue): string[] {\n    const references: string[] = []\n\n    if (typeof value === 'string') {\n      const matches = value.matchAll(/\\{([^}]+)\\}/g)\n      for (const match of matches) {\n        const ref = match[1]\n        if (ref != null) {\n          references.push(ref.trim())\n        }\n      }\n    } else if (Array.isArray(value)) {\n      for (const item of value) {\n        references.push(...AliasResolver.extractReferences(item as TokenValue))\n      }\n    } else if (typeof value === 'object' && value != null) {\n      for (const val of Object.values(value)) {\n        references.push(...AliasResolver.extractReferences(val as TokenValue))\n      }\n    }\n\n    return references\n  }\n\n  private handleAliasError(\n    error: unknown,\n    name: string,\n    token: InternalResolvedToken,\n    hadAlias: boolean,\n  ): InternalResolvedToken {\n    if (error instanceof Error) {\n      this.validationHandler.handleIssue(error)\n    } else {\n      this.validationHandler.handleIssue(new Error(String(error)))\n    }\n\n    const message = error instanceof Error ? error.message : String(error)\n    this.validationHandler.warn(`Alias resolution skipped for \"${name}\": ${message}`)\n\n    return {\n      ...token,\n      $value: token.$value,\n      _isAlias: hadAlias,\n    }\n  }\n}\n","/**\n * @fileoverview Built-in token filters\n *\n * Provides commonly used filters for token selection. These filters can be\n * used in output configurations to control which tokens are included in output.\n */\n\nimport { AliasResolver } from '@lib/resolution/alias-resolver'\nimport type { TokenType } from '@lib/tokens/types'\n\nimport type { Filter } from './types'\n\n/**\n * Factory function to create a filter for a specific token type\n *\n * @param type - Token type to filter for\n * @returns Filter that includes only tokens of the specified type\n *\n * @example\n * ```typescript\n * const shadowFilter = byType('shadow')\n * dispersa.registerFilter(shadowFilter)\n *\n * outputs: [{\n *   css({\n *     name: 'css',\n *     file: 'tokens.css',\n *     preset: 'bundle',\n *     filters: [shadowFilter],\n *   }),\n * }]\n * ```\n */\nexport function byType(type: TokenType): Filter {\n  return {\n    filter: (token) => token.$type === type,\n  }\n}\n\n/**\n * Factory function to create a filter based on path pattern\n *\n * @param pattern - Regular expression or string to match against token path\n * @returns Filter that includes only tokens matching the path pattern\n *\n * @example\n * ```typescript\n * // Filter tokens in 'color.semantic' namespace\n * const semanticColors = byPath(/^color\\.semantic/)\n * dispersa.registerFilter(semanticColors)\n *\n * // Filter tokens starting with 'spacing'\n * const spacingTokens = byPath('spacing')\n * dispersa.registerFilter(spacingTokens)\n * ```\n */\nexport function byPath(pattern: RegExp | string): Filter {\n  const regex = typeof pattern === 'string' ? new RegExp(`^${pattern}`) : pattern\n  return {\n    filter: (token) => {\n      const fullPath = token.path.join('.')\n      return regex.test(fullPath)\n    },\n  }\n}\n\n\n/**\n * Filter to include only alias tokens (tokens that reference other tokens)\n *\n * Useful for shipping only semantic/alias tokens to consumers while keeping\n * base/primitive tokens internal to the design system.\n *\n * @example\n * ```typescript\n * {\n *   name: 'web-semantic',\n *   renderer: cssRenderer(),\n *   options: { preset: 'bundle' },\n *   filters: [isAlias()], // Only tokens that were originally references\n *   transforms: [nameKebabCase()]\n * }\n * ```\n */\nexport function isAlias(): Filter {\n  return {\n    filter: (token) => AliasResolver.hasAliases(token.originalValue),\n  }\n}\n\n/**\n * Filter to include only base tokens (tokens with direct values, not aliases)\n *\n * Useful for internal documentation or extracting only primitive/foundation tokens.\n *\n * @example\n * ```typescript\n * {\n *   name: 'design-primitives',\n *   renderer: jsonRenderer(),\n *   options: { preset: 'standalone' },\n *   filters: [isBase()], // Only tokens with direct values\n * }\n * ```\n */\nexport function isBase(): Filter {\n  return {\n    filter: (token) => !AliasResolver.hasAliases(token.originalValue),\n  }\n}\n"]}

package/dist/filters.d.cts

@@ -0,0 +1,86 @@
+import { F as Filter } from './types-BDY1xBmD.cjs';
+import { T as TokenType } from './types-C1GpiJ6q.cjs';
+
+/**
+ * @fileoverview Built-in token filters
+ *
+ * Provides commonly used filters for token selection. These filters can be
+ * used in output configurations to control which tokens are included in output.
+ */
+
+/**
+ * Factory function to create a filter for a specific token type
+ *
+ * @param type - Token type to filter for
+ * @returns Filter that includes only tokens of the specified type
+ *
+ * @example
+ * ```typescript
+ * const shadowFilter = byType('shadow')
+ * dispersa.registerFilter(shadowFilter)
+ *
+ * outputs: [{
+ *   css({
+ *     name: 'css',
+ *     file: 'tokens.css',
+ *     preset: 'bundle',
+ *     filters: [shadowFilter],
+ *   }),
+ * }]
+ * ```
+ */
+declare function byType(type: TokenType): Filter;
+/**
+ * Factory function to create a filter based on path pattern
+ *
+ * @param pattern - Regular expression or string to match against token path
+ * @returns Filter that includes only tokens matching the path pattern
+ *
+ * @example
+ * ```typescript
+ * // Filter tokens in 'color.semantic' namespace
+ * const semanticColors = byPath(/^color\.semantic/)
+ * dispersa.registerFilter(semanticColors)
+ *
+ * // Filter tokens starting with 'spacing'
+ * const spacingTokens = byPath('spacing')
+ * dispersa.registerFilter(spacingTokens)
+ * ```
+ */
+declare function byPath(pattern: RegExp | string): Filter;
+/**
+ * Filter to include only alias tokens (tokens that reference other tokens)
+ *
+ * Useful for shipping only semantic/alias tokens to consumers while keeping
+ * base/primitive tokens internal to the design system.
+ *
+ * @example
+ * ```typescript
+ * {
+ *   name: 'web-semantic',
+ *   renderer: cssRenderer(),
+ *   options: { preset: 'bundle' },
+ *   filters: [isAlias()], // Only tokens that were originally references
+ *   transforms: [nameKebabCase()]
+ * }
+ * ```
+ */
+declare function isAlias(): Filter;
+/**
+ * Filter to include only base tokens (tokens with direct values, not aliases)
+ *
+ * Useful for internal documentation or extracting only primitive/foundation tokens.
+ *
+ * @example
+ * ```typescript
+ * {
+ *   name: 'design-primitives',
+ *   renderer: jsonRenderer(),
+ *   options: { preset: 'standalone' },
+ *   filters: [isBase()], // Only tokens with direct values
+ * }
+ * ```
+ */
+declare function isBase(): Filter;
+
+export { Filter, byPath, byType, isAlias, isBase };