dispersa 0.3.1 → 0.4.1

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { D as DispersaOptions, B as BuildConfig, a as BuildResult, M as ModifierInputs, R as ResolverDocument } from './index-BkvV7Z54.cjs';
-export { A as AndroidRendererOptions, c as BuildError, d as BuildOutput, C as CssRendererOptions, E as ErrorCode, F as FormatOptions, I as IosRendererOptions, L as LifecycleHooks, e as MediaQueryFunction, O as OutputConfig, f as OutputTree, P as PermutationData, h as RenderContext, i as RenderMeta, j as RenderOutput, g as Renderer, S as SelectorFunction, T as TailwindRendererOptions, b as ValidationMode, V as ValidationOptions, k as defineRenderer } from './index-BkvV7Z54.cjs';
+import { D as DispersaOptions, B as BuildConfig, a as BuildResult, M as ModifierInputs, R as ResolverDocument } from './index-dwm-xYbQ.cjs';
+export { A as AndroidRendererOptions, c as BuildError, d as BuildOutput, C as CssRendererOptions, E as ErrorCode, F as FileFunction, e as FormatOptions, I as IosRendererOptions, L as LifecycleHooks, f as MediaQueryFunction, O as OutputConfig, g as OutputTree, P as PermutationData, i as RenderContext, j as RenderMeta, k as RenderOutput, h as Renderer, S as SelectorFunction, T as TailwindRendererOptions, b as ValidationMode, V as ValidationOptions, l as defineRenderer } from './index-dwm-xYbQ.cjs';
 import { R as ResolvedTokens } from './types-Bc0kA7De.cjs';
 export { B as BorderToken, r as BorderValue, k as ColorComponent, j as ColorSpace, C as ColorToken, i as ColorValue, h as ColorValueObject, o as CubicBezierValue, D as DesignTokenValue, d as DimensionToken, l as DimensionValue, e as DurationToken, m as DurationValue, F as FontFamilyValue, n as FontWeightValue, w as GradientStop, G as GradientToken, v as GradientValue, a as ResolvedToken, S as ShadowToken, p as ShadowValueObject, s as StrokeStyleValue, t as StrokeStyleValueObject, T as TokenType, b as TokenValue, c as TokenValueReference, g as TransitionToken, u as TransitionValue, f as TypographyToken, q as TypographyValue, E as isBorderToken, x as isColorToken, y as isDimensionToken, H as isDurationToken, J as isGradientToken, z as isShadowToken, I as isTransitionToken, A as isTypographyToken } from './types-Bc0kA7De.cjs';
 export { T as Transform } from './types-BAv39mum.cjs';
@@ -7,7 +7,7 @@ export { F as Filter } from './types-DWKq-eJj.cjs';
 export { J as JsModuleRendererOptions, a as JsonRendererOptions, P as Preprocessor } from './types-CussyWwe.cjs';
 export { AndroidBuilderConfig, CssBuilderConfig, IosBuilderConfig, JsBuilderConfig, JsonBuilderConfig, TailwindBuilderConfig, android, css, ios, js, json, tailwind } from './builders.cjs';
 export { isOutputTree, outputTree } from './renderers.cjs';
-export { BasePermutationError, CircularReferenceError, ColorParseError, ConfigurationError, DimensionFormatError, DispersaError, FileOperationError, ModifierError, TokenReferenceError, ValidationError } from './errors.cjs';
+export { BasePermutationError, CircularReferenceError, ConfigurationError, DispersaError, FileOperationError, ModifierError, TokenReferenceError, ValidationError } from './errors.cjs';
 import 'json-schema-to-ts';
 
 /**

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { D as DispersaOptions, B as BuildConfig, a as BuildResult, M as ModifierInputs, R as ResolverDocument } from './index-DJ_UHSQG.js';
-export { A as AndroidRendererOptions, c as BuildError, d as BuildOutput, C as CssRendererOptions, E as ErrorCode, F as FormatOptions, I as IosRendererOptions, L as LifecycleHooks, e as MediaQueryFunction, O as OutputConfig, f as OutputTree, P as PermutationData, h as RenderContext, i as RenderMeta, j as RenderOutput, g as Renderer, S as SelectorFunction, T as TailwindRendererOptions, b as ValidationMode, V as ValidationOptions, k as defineRenderer } from './index-DJ_UHSQG.js';
+import { D as DispersaOptions, B as BuildConfig, a as BuildResult, M as ModifierInputs, R as ResolverDocument } from './index-Bkedvob6.js';
+export { A as AndroidRendererOptions, c as BuildError, d as BuildOutput, C as CssRendererOptions, E as ErrorCode, F as FileFunction, e as FormatOptions, I as IosRendererOptions, L as LifecycleHooks, f as MediaQueryFunction, O as OutputConfig, g as OutputTree, P as PermutationData, i as RenderContext, j as RenderMeta, k as RenderOutput, h as Renderer, S as SelectorFunction, T as TailwindRendererOptions, b as ValidationMode, V as ValidationOptions, l as defineRenderer } from './index-Bkedvob6.js';
 import { R as ResolvedTokens } from './types-Bc0kA7De.js';
 export { B as BorderToken, r as BorderValue, k as ColorComponent, j as ColorSpace, C as ColorToken, i as ColorValue, h as ColorValueObject, o as CubicBezierValue, D as DesignTokenValue, d as DimensionToken, l as DimensionValue, e as DurationToken, m as DurationValue, F as FontFamilyValue, n as FontWeightValue, w as GradientStop, G as GradientToken, v as GradientValue, a as ResolvedToken, S as ShadowToken, p as ShadowValueObject, s as StrokeStyleValue, t as StrokeStyleValueObject, T as TokenType, b as TokenValue, c as TokenValueReference, g as TransitionToken, u as TransitionValue, f as TypographyToken, q as TypographyValue, E as isBorderToken, x as isColorToken, y as isDimensionToken, H as isDurationToken, J as isGradientToken, z as isShadowToken, I as isTransitionToken, A as isTypographyToken } from './types-Bc0kA7De.js';
 export { T as Transform } from './types-CzHa7YkW.js';
@@ -7,7 +7,7 @@ export { F as Filter } from './types-BzNcG-rI.js';
 export { J as JsModuleRendererOptions, a as JsonRendererOptions, P as Preprocessor } from './types-CZb19kiq.js';
 export { AndroidBuilderConfig, CssBuilderConfig, IosBuilderConfig, JsBuilderConfig, JsonBuilderConfig, TailwindBuilderConfig, android, css, ios, js, json, tailwind } from './builders.js';
 export { isOutputTree, outputTree } from './renderers.js';
-export { BasePermutationError, CircularReferenceError, ColorParseError, ConfigurationError, DimensionFormatError, DispersaError, FileOperationError, ModifierError, TokenReferenceError, ValidationError } from './errors.js';
+export { BasePermutationError, CircularReferenceError, ConfigurationError, DispersaError, FileOperationError, ModifierError, TokenReferenceError, ValidationError } from './errors.js';
 import 'json-schema-to-ts';
 
 /**

package/dist/index.js

@@ -59,7 +59,7 @@ var init_token_utils = __esm({
 });
 
 // src/shared/errors/index.ts
-var DispersaError, TokenReferenceError, CircularReferenceError, ValidationError, ColorParseError, DimensionFormatError, FileOperationError, ConfigurationError, BasePermutationError, ModifierError;
+var DispersaError, TokenReferenceError, CircularReferenceError, ValidationError, FileOperationError, ConfigurationError, BasePermutationError, ModifierError;
 var init_errors = __esm({
   "src/shared/errors/index.ts"() {
     DispersaError = class extends Error {
@@ -110,20 +110,6 @@ var init_errors = __esm({
         this.name = "ValidationError";
       }
     };
-    ColorParseError = class extends DispersaError {
-      constructor(colorValue) {
-        super(`Color parsing failed: '${colorValue}'. Provide a valid CSS color or DTCG color object.`);
-        this.colorValue = colorValue;
-        this.name = "ColorParseError";
-      }
-    };
-    DimensionFormatError = class extends DispersaError {
-      constructor(dimensionValue) {
-        super(`Dimension parsing failed: '${dimensionValue}'. Provide a valid DTCG dimension object.`);
-        this.dimensionValue = dimensionValue;
-        this.name = "DimensionFormatError";
-      }
-    };
     FileOperationError = class extends DispersaError {
       constructor(operation, filePath, originalError) {
         super(`Failed to ${operation} file: ${filePath}. ${originalError.message}`);
@@ -3880,12 +3866,6 @@ function toBuildError(error, outputName) {
   if (error instanceof ValidationError) {
     return { message, code: "VALIDATION", severity: "error" };
   }
-  if (error instanceof ColorParseError) {
-    return { message, code: "COLOR_PARSE", severity: "error" };
-  }
-  if (error instanceof DimensionFormatError) {
-    return { message, code: "DIMENSION_FORMAT", severity: "error" };
-  }
   if (error instanceof FileOperationError) {
     return { message, code: "FILE_OPERATION", path: error.filePath, severity: "error" };
   }
@@ -5880,6 +5860,32 @@ var TokenParser = class {
 };
 
 // src/build/pipeline/token-pipeline.ts
+var ROOT_REF_PATTERN = /\.\$root\}/g;
+function rewriteRootReferences(value) {
+  if (typeof value === "string") {
+    return ROOT_REF_PATTERN.test(value) ? value.replace(ROOT_REF_PATTERN, "}") : value;
+  }
+  if (Array.isArray(value)) {
+    let changed = false;
+    const mapped = value.map((item) => {
+      const rewritten = rewriteRootReferences(item);
+      if (rewritten !== item) changed = true;
+      return rewritten;
+    });
+    return changed ? mapped : value;
+  }
+  if (typeof value === "object" && value !== null) {
+    let changed = false;
+    const result = {};
+    for (const [k, v] of Object.entries(value)) {
+      const rewritten = rewriteRootReferences(v);
+      if (rewritten !== v) changed = true;
+      result[k] = rewritten;
+    }
+    return changed ? result : value;
+  }
+  return value;
+}
 var TokenPipeline = class {
   options;
   validationHandler;
@@ -5904,8 +5910,9 @@ var TokenPipeline = class {
    * 5. Resolve JSON Pointer references
    * 6. Parse and flatten token structure
    * 7. Resolve alias references
-   * 8. Apply filters (if provided) — runs first to remove tokens before transforms
-   * 9. Apply transforms (if provided) — runs on the already-filtered token set
+   * 8. Strip $root from token names/paths (DTCG structural mechanism, transparent in output)
+   * 9. Apply filters (if provided) — runs first to remove tokens before transforms
+   * 10. Apply transforms (if provided) — runs on the already-filtered token set
    *
    * Each stage is explicitly typed to ensure correct order and prevent temporal coupling.
    *
@@ -5945,7 +5952,8 @@ var TokenPipeline = class {
     const refResolved = await this.resolveReferences(preprocessed);
     const flattened = this.flattenTokens(refResolved);
     const aliasResolved = this.resolveAliases(flattened);
-    const filtered = this.applyFilterStage(aliasResolved, filterList);
+    const rootStripped = this.stripRootTokenNames(aliasResolved);
+    const filtered = this.applyFilterStage(rootStripped, filterList);
     return this.applyTransformStage(filtered, transformList);
   }
   /**
@@ -6030,8 +6038,34 @@ var TokenPipeline = class {
     return { ...rest, aliasResolvedTokens };
   }
   /**
-   * Stage 8: Apply filters to final tokens (before transforms to skip unnecessary work)
+   * Stage 8: Strip `$root` from token names and paths.
+   *
+   * `$root` is a DTCG structural mechanism that allows a group to carry a
+   * default value alongside child tokens. References must use the full path
+   * (`{color.action.brand.$root}`) for alias resolution, but `$root` should
+   * be transparent in output. This stage re-keys tokens so downstream
+   * consumers (filters, transforms, renderers) see clean names.
    */
+  stripRootTokenNames(stage) {
+    const tokens = stage.aliasResolvedTokens;
+    const result = {};
+    for (const [key, token] of Object.entries(tokens)) {
+      const rewrittenOriginal = rewriteRootReferences(token.originalValue);
+      if (!key.endsWith(".$root")) {
+        result[key] = rewrittenOriginal !== token.originalValue ? { ...token, originalValue: rewrittenOriginal } : token;
+        continue;
+      }
+      const strippedPath = token.path.filter((segment) => segment !== "$root");
+      const strippedName = strippedPath.join(".");
+      result[strippedName] = {
+        ...token,
+        path: strippedPath,
+        name: strippedName,
+        originalValue: rewrittenOriginal
+      };
+    }
+    return { ...stage, aliasResolvedTokens: result };
+  }
   applyFilterStage(stage, filterList) {
     let tokens = stage.aliasResolvedTokens;
     if (filterList !== void 0 && filterList.length > 0) {
@@ -9689,6 +9723,6 @@ init_errors();
  * LICENSE file in the root directory of this source tree.
  */
 
-export { BasePermutationError, CircularReferenceError, ColorParseError, ConfigurationError, DimensionFormatError, Dispersa, DispersaError, FileOperationError, ModifierError, TokenReferenceError, ValidationError, android, css, defineRenderer, ios, isBorderToken, isColorToken, isDimensionToken, isDurationToken, isGradientToken, isOutputTree, isShadowToken, isTransitionToken, isTypographyToken, js, json, outputTree, tailwind };
+export { BasePermutationError, CircularReferenceError, ConfigurationError, Dispersa, DispersaError, FileOperationError, ModifierError, TokenReferenceError, ValidationError, android, css, defineRenderer, ios, isBorderToken, isColorToken, isDimensionToken, isDurationToken, isGradientToken, isOutputTree, isShadowToken, isTransitionToken, isTypographyToken, js, json, outputTree, tailwind };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map