@pandacss/token-dictionary 0.37.0 → 0.37.1

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import * as _pandacss_types from '@pandacss/types';
-import { Tokens, SemanticTokens, ThemeVariantsMap } from '@pandacss/types';
+import { Tokens, SemanticTokens, ThemeVariantsMap, Token as Token$1 } from '@pandacss/types';
 import { CssVarOptions, CssVar } from '@pandacss/shared';
 
 type TokenStatus = 'deprecated' | 'experimental' | 'new';
@@ -147,9 +147,13 @@ declare class TokenDictionary {
      */
     expandReferenceInValue(value: string): string;
     /**
-     * Resolve token references to their actual raw value
+     * Get the value of a token reference
      */
     resolveReference(value: string): string;
+    /**
+     * Resolve token references to their actual raw value (recursively resolves references)
+     */
+    deepResolveReference(originalValue: string): string | undefined;
     build(): this;
     get isEmpty(): boolean;
     view: ReturnType<TokenDictionaryView['getTokensView']>;
@@ -164,6 +168,7 @@ declare class TokenDictionaryView {
         colorPalettes: Map<string, Map<string, string>>;
         vars: Map<string, Map<string, string>>;
         values: Map<string, string>;
+        nameByVar: Map<string, string>;
         json: Record<string, Record<string, string>>;
         get: (path: string, fallback?: string | number) => string;
         getCategoryValues: (category: string) => Record<string, string> | undefined;
@@ -175,4 +180,21 @@ declare class TokenDictionaryView {
     private processVars;
 }
 
-export { Token, TokenDictionary };
+/**
+ * Returns all references in a string
+ *
+ * @example
+ *
+ * `{colors.red.300} {sizes.sm}` => ['colors.red.300', 'sizes.sm']
+ */
+declare function getReferences(value: string): string[];
+declare const hasReference: (value: string) => boolean;
+declare function expandReferences(value: string, fn: (key: string) => string): string;
+/**
+ * Converts a JS Map to an object
+ */
+declare function mapToJson(map: Map<string, any>): Record<string, unknown>;
+declare const isToken: (value: any) => value is Token$1<any>;
+declare function assertTokenFormat(token: any): asserts token is Token$1;
+
+export { Token, TokenDictionary, type TokenExtensions, assertTokenFormat, expandReferences, getReferences, hasReference, isToken, mapToJson };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _pandacss_types from '@pandacss/types';
-import { Tokens, SemanticTokens, ThemeVariantsMap } from '@pandacss/types';
+import { Tokens, SemanticTokens, ThemeVariantsMap, Token as Token$1 } from '@pandacss/types';
 import { CssVarOptions, CssVar } from '@pandacss/shared';
 
 type TokenStatus = 'deprecated' | 'experimental' | 'new';
@@ -147,9 +147,13 @@ declare class TokenDictionary {
      */
     expandReferenceInValue(value: string): string;
     /**
-     * Resolve token references to their actual raw value
+     * Get the value of a token reference
      */
     resolveReference(value: string): string;
+    /**
+     * Resolve token references to their actual raw value (recursively resolves references)
+     */
+    deepResolveReference(originalValue: string): string | undefined;
     build(): this;
     get isEmpty(): boolean;
     view: ReturnType<TokenDictionaryView['getTokensView']>;
@@ -164,6 +168,7 @@ declare class TokenDictionaryView {
         colorPalettes: Map<string, Map<string, string>>;
         vars: Map<string, Map<string, string>>;
         values: Map<string, string>;
+        nameByVar: Map<string, string>;
         json: Record<string, Record<string, string>>;
         get: (path: string, fallback?: string | number) => string;
         getCategoryValues: (category: string) => Record<string, string> | undefined;
@@ -175,4 +180,21 @@ declare class TokenDictionaryView {
     private processVars;
 }
 
-export { Token, TokenDictionary };
+/**
+ * Returns all references in a string
+ *
+ * @example
+ *
+ * `{colors.red.300} {sizes.sm}` => ['colors.red.300', 'sizes.sm']
+ */
+declare function getReferences(value: string): string[];
+declare const hasReference: (value: string) => boolean;
+declare function expandReferences(value: string, fn: (key: string) => string): string;
+/**
+ * Converts a JS Map to an object
+ */
+declare function mapToJson(map: Map<string, any>): Record<string, unknown>;
+declare const isToken: (value: any) => value is Token$1<any>;
+declare function assertTokenFormat(token: any): asserts token is Token$1;
+
+export { Token, TokenDictionary, type TokenExtensions, assertTokenFormat, expandReferences, getReferences, hasReference, isToken, mapToJson };

package/dist/index.js

@@ -21,7 +21,13 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var src_exports = {};
 __export(src_exports, {
   Token: () => Token,
-  TokenDictionary: () => TokenDictionary
+  TokenDictionary: () => TokenDictionary,
+  assertTokenFormat: () => assertTokenFormat,
+  expandReferences: () => expandReferences,
+  getReferences: () => getReferences,
+  hasReference: () => hasReference,
+  isToken: () => isToken,
+  mapToJson: () => mapToJson
 });
 module.exports = __toCommonJS(src_exports);
 
@@ -1001,11 +1007,32 @@ var TokenDictionary = class {
     });
   }
   /**
-   * Resolve token references to their actual raw value
+   * Get the value of a token reference
    */
   resolveReference(value) {
     return expandReferences(value, (key) => this.getByName(key)?.value);
   }
+  /**
+   * Resolve token references to their actual raw value (recursively resolves references)
+   */
+  deepResolveReference(originalValue) {
+    const stack = [originalValue];
+    while (stack.length) {
+      const next = stack.pop();
+      if (next.startsWith("{")) {
+        stack.push(this.resolveReference(next));
+        continue;
+      }
+      if (next.startsWith("var(")) {
+        const ref = this.view.nameByVar.get(next);
+        if (ref) {
+          stack.push(this.resolveReference(`{${ref}}`));
+          continue;
+        }
+      }
+      return next;
+    }
+  }
   build() {
     this.applyMiddlewares("pre");
     this.transformTokens("pre");
@@ -1037,12 +1064,13 @@ var TokenDictionaryView = class {
     const colorPalettes = /* @__PURE__ */ new Map();
     const valuesByCategory = /* @__PURE__ */ new Map();
     const flatValues = /* @__PURE__ */ new Map();
+    const nameByVar = /* @__PURE__ */ new Map();
     const vars = /* @__PURE__ */ new Map();
     this.dictionary.allTokens.forEach((token) => {
       this.processCondition(token, conditionMap);
       this.processColorPalette(token, colorPalettes, this.dictionary.byName);
       this.processCategory(token, categoryMap);
-      this.processValue(token, valuesByCategory, flatValues);
+      this.processValue(token, valuesByCategory, flatValues, nameByVar);
       this.processVars(token, vars);
     });
     const json = mapToJson(valuesByCategory);
@@ -1052,6 +1080,7 @@ var TokenDictionaryView = class {
       colorPalettes,
       vars,
       values: flatValues,
+      nameByVar,
       json,
       get: (0, import_shared5.memo)((path, fallback) => {
         return flatValues.get(path) ?? fallback;
@@ -1117,7 +1146,7 @@ var TokenDictionaryView = class {
       group.set(category, /* @__PURE__ */ new Map());
     group.get(category).set(prop, token);
   }
-  processValue(token, byCategory, flat) {
+  processValue(token, byCategory, flatValues, nameByVar) {
     const { category, prop, varRef, isNegative } = token.extensions;
     if (!category)
       return;
@@ -1125,7 +1154,8 @@ var TokenDictionaryView = class {
       byCategory.set(category, /* @__PURE__ */ new Map());
     const value = isNegative ? token.extensions.condition !== "base" ? token.originalValue : token.value : varRef;
     byCategory.get(category).set(prop, value);
-    flat.set(token.name, value);
+    flatValues.set(token.name, value);
+    nameByVar.set(value, token.name);
   }
   processVars(token, group) {
     const { condition, isNegative, isVirtual, var: varName, theme } = token.extensions;
@@ -1150,5 +1180,11 @@ function replaceRootWithColorPalette(path, colorPaletteRoot) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Token,
-  TokenDictionary
+  TokenDictionary,
+  assertTokenFormat,
+  expandReferences,
+  getReferences,
+  hasReference,
+  isToken,
+  mapToJson
 });

package/dist/index.mjs

@@ -982,11 +982,32 @@ var TokenDictionary = class {
     });
   }
   /**
-   * Resolve token references to their actual raw value
+   * Get the value of a token reference
    */
   resolveReference(value) {
     return expandReferences(value, (key) => this.getByName(key)?.value);
   }
+  /**
+   * Resolve token references to their actual raw value (recursively resolves references)
+   */
+  deepResolveReference(originalValue) {
+    const stack = [originalValue];
+    while (stack.length) {
+      const next = stack.pop();
+      if (next.startsWith("{")) {
+        stack.push(this.resolveReference(next));
+        continue;
+      }
+      if (next.startsWith("var(")) {
+        const ref = this.view.nameByVar.get(next);
+        if (ref) {
+          stack.push(this.resolveReference(`{${ref}}`));
+          continue;
+        }
+      }
+      return next;
+    }
+  }
   build() {
     this.applyMiddlewares("pre");
     this.transformTokens("pre");
@@ -1018,12 +1039,13 @@ var TokenDictionaryView = class {
     const colorPalettes = /* @__PURE__ */ new Map();
     const valuesByCategory = /* @__PURE__ */ new Map();
     const flatValues = /* @__PURE__ */ new Map();
+    const nameByVar = /* @__PURE__ */ new Map();
     const vars = /* @__PURE__ */ new Map();
     this.dictionary.allTokens.forEach((token) => {
       this.processCondition(token, conditionMap);
       this.processColorPalette(token, colorPalettes, this.dictionary.byName);
       this.processCategory(token, categoryMap);
-      this.processValue(token, valuesByCategory, flatValues);
+      this.processValue(token, valuesByCategory, flatValues, nameByVar);
       this.processVars(token, vars);
     });
     const json = mapToJson(valuesByCategory);
@@ -1033,6 +1055,7 @@ var TokenDictionaryView = class {
       colorPalettes,
       vars,
       values: flatValues,
+      nameByVar,
       json,
       get: memo((path, fallback) => {
         return flatValues.get(path) ?? fallback;
@@ -1098,7 +1121,7 @@ var TokenDictionaryView = class {
       group.set(category, /* @__PURE__ */ new Map());
     group.get(category).set(prop, token);
   }
-  processValue(token, byCategory, flat) {
+  processValue(token, byCategory, flatValues, nameByVar) {
     const { category, prop, varRef, isNegative } = token.extensions;
     if (!category)
       return;
@@ -1106,7 +1129,8 @@ var TokenDictionaryView = class {
       byCategory.set(category, /* @__PURE__ */ new Map());
     const value = isNegative ? token.extensions.condition !== "base" ? token.originalValue : token.value : varRef;
     byCategory.get(category).set(prop, value);
-    flat.set(token.name, value);
+    flatValues.set(token.name, value);
+    nameByVar.set(value, token.name);
   }
   processVars(token, group) {
     const { condition, isNegative, isVirtual, var: varName, theme } = token.extensions;
@@ -1130,5 +1154,11 @@ function replaceRootWithColorPalette(path, colorPaletteRoot) {
 }
 export {
   Token,
-  TokenDictionary
+  TokenDictionary,
+  assertTokenFormat,
+  expandReferences,
+  getReferences,
+  hasReference,
+  isToken,
+  mapToJson
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pandacss/token-dictionary",
-  "version": "0.37.0",
+  "version": "0.37.1",
   "description": "Common error messages for css panda",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -33,9 +33,9 @@
   ],
   "dependencies": {
     "ts-pattern": "5.0.8",
-    "@pandacss/logger": "^0.37.0",
-    "@pandacss/shared": "0.37.0",
-    "@pandacss/types": "0.37.0"
+    "@pandacss/logger": "^0.37.1",
+    "@pandacss/shared": "0.37.1",
+    "@pandacss/types": "0.37.1"
   },
   "scripts": {
     "build": "tsup src/index.ts --format=esm,cjs --dts",