tokvista 1.11.1 → 1.11.2

package/dist/bin/tokvista.js

@@ -1097,6 +1097,45 @@ function isRecord7(value) {
 function isTokenLike5(obj) {
   return isRecord7(obj) && "value" in obj;
 }
+function validateTokenStructure(tokens) {
+  const issues = [];
+  function walk(node, path2 = [], level = 0) {
+    if (!isRecord7(node)) return;
+    if (path2.length === 0 && Object.keys(node).some((k) => k.includes("/"))) {
+      Object.values(node).forEach((val) => walk(val, [], level));
+      return;
+    }
+    if (isTokenLike5(node)) {
+      const tokenPath = path2.join(".");
+      const value = String(node.value || "");
+      const isSemanticToken = path2.some(
+        (p) => p.toLowerCase().includes("semantic") || p.toLowerCase().includes("component")
+      );
+      if (isSemanticToken && !value.startsWith("{")) {
+        if (/#[0-9A-Fa-f]{3,8}/.test(value) || /rgba?\(/.test(value)) {
+          issues.push({
+            path: tokenPath,
+            issue: "Semantic token uses hardcoded color",
+            value
+          });
+        }
+        if (/\d+px/.test(value) && (node.type === "spacing" || node.type === "sizing")) {
+          issues.push({
+            path: tokenPath,
+            issue: "Semantic token uses hardcoded spacing",
+            value
+          });
+        }
+      }
+      return;
+    }
+    Object.entries(node).forEach(([key, val]) => {
+      walk(val, [...path2, key], level + 1);
+    });
+  }
+  walk(tokens);
+  return issues;
+}
 function extractTokenNames(tokens) {
   const tokenMap = /* @__PURE__ */ new Map();
   function walk(node, path2 = []) {
@@ -1171,6 +1210,10 @@ async function scanDirectory(dir, tokenVars, extensions) {
         } else if (entry.isFile()) {
           const ext = extname(entry.name);
           if (extensions.has(ext)) {
+            const fileName = entry.name.toLowerCase();
+            if (fileName.includes("token") && (ext === ".css" || ext === ".scss" || ext === ".js")) {
+              continue;
+            }
             const result = await scanFile(fullPath, tokenVars);
             filesScanned++;
             result.usedVars.forEach((v) => usedVars.add(v));
@@ -1191,6 +1234,7 @@ async function scanTokenUsage(tokensPath, scanDir, tokens) {
   if (detection.format !== "token-studio" && detection.format !== "unknown") {
     normalizedTokens = normalizeTokenFormat(tokens, detection.format);
   }
+  const tokenFileIssues = validateTokenStructure(normalizedTokens);
   const tokenMap = extractTokenNames(normalizedTokens);
   const tokenVars = new Set(tokenMap.keys());
   const extensions = /* @__PURE__ */ new Set([".css", ".scss", ".sass", ".less", ".tsx", ".jsx", ".ts", ".js", ".vue", ".svelte"]);
@@ -1212,6 +1256,7 @@ async function scanTokenUsage(tokensPath, scanDir, tokens) {
     // Limit to 50
     hardcodedSpacing: scanResult.hardcodedSpacing.slice(0, 50),
     // Limit to 50
+    tokenFileIssues,
     filesScanned: scanResult.filesScanned
   };
 }
@@ -2406,6 +2451,13 @@ Scanning ${scanDir2} for token usage...
         }
         console.log("");
       }
+      if (result2.tokenFileIssues.length > 0) {
+        console.log(`\u{1F6A8} Token File Issues:`);
+        result2.tokenFileIssues.forEach(({ path: path2, issue, value }) => {
+          console.log(`  ${path2}: ${issue} (${value})`);
+        });
+        console.log("");
+      }
       if (result2.hardcodedColors.length > 0) {
         console.log(`\u{1F3A8} Hardcoded Colors (should use tokens):`);
         result2.hardcodedColors.slice(0, 10).forEach(({ file, line, value }) => {
@@ -2464,6 +2516,13 @@ Scanning ${scanDir} for token usage...
     }
     console.log("");
   }
+  if (result.tokenFileIssues.length > 0) {
+    console.log(`\u{1F6A8} Token File Issues:`);
+    result.tokenFileIssues.forEach(({ path: path2, issue, value }) => {
+      console.log(`  ${path2}: ${issue} (${value})`);
+    });
+    console.log("");
+  }
   if (result.hardcodedColors.length > 0) {
     console.log(`\u{1F3A8} Hardcoded Colors (should use tokens):`);
     result.hardcodedColors.slice(0, 10).forEach(({ file, line, value }) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tokvista",
-  "version": "1.11.1",
+  "version": "1.11.2",
   "description": "Interactive visual documentation for design tokens.",
   "type": "module",
   "main": "./dist/index.cjs",