dispersa 0.3.0 → 0.4.0

package/dist/index.js

@@ -5880,6 +5880,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 +5930,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 +5972,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 +6058,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) {