design-constraint-validator 2.0.1 → 2.2.0

package/core/flatten.ts

@@ -1,16 +1,22 @@
+import { normalizeDtcgValue } from "./dtcg.js";
+
 export type TokenId = string; // e.g. "color.palette.brand.600"
 export type TokenValue = string | number;
-export type TokenNode = { 
-  $type?: string; 
-  $value?: TokenValue; 
-  [k: string]: TokenNode | string | number | undefined;
+// $value may also be a DTCG 2025.10 structured object (color / dimension); it is
+// normalized to a TokenValue at ingestion. See normalizeDtcgValue.
+export type DtcgStructuredValue = Record<string, unknown>;
+export type TokenNode = {
+  $type?: string;
+  $value?: TokenValue | DtcgStructuredValue;
+  $extensions?: DtcgStructuredValue; // spec passthrough — preserved, never interpreted
+  [k: string]: TokenNode | string | number | DtcgStructuredValue | undefined;
 };
 
 export type FlatToken = {
   id: TokenId;
   type: string;
   value: TokenValue;       // resolved (if ref)
-  raw: TokenValue;         // original $value
+  raw: TokenValue | DtcgStructuredValue; // original $value
   refs: TokenId[];         // referenced token IDs found in raw
 };
 
@@ -19,9 +25,19 @@ export type FlattenResult = {
   edges: Array<[from: TokenId, to: TokenId]>; // from ref -> to dependent
 };
 
-const REF_RE = /\{([a-z0-9.-]+)\}/gi;
+const REF_RE = /\{([a-z0-9_.-]+)\}/gi;
+const escapeRegExp = (s: string) => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 
 export function flattenTokens(root: TokenNode): FlattenResult {
+  // Fail closed on a malformed token root (TASK-017). A non-object root — null,
+  // an array, or a scalar — previously walked to a silently-empty set that
+  // "validated" with ok:true; that hid garbage input. The token root must be a
+  // JSON object. (An empty object `{}` is still valid — it just has no tokens.)
+  if (root === null || typeof root !== 'object' || Array.isArray(root)) {
+    const got = root === null ? 'null' : Array.isArray(root) ? 'array' : typeof root;
+    throw new Error(`Token root must be a JSON object (got ${got}).`);
+  }
+
   const flat: Record<TokenId, FlatToken> = {};
   const edges: Array<[TokenId, TokenId]> = [];
 
@@ -31,14 +47,18 @@ export function flattenTokens(root: TokenNode): FlattenResult {
     
     if (Object.prototype.hasOwnProperty.call(node, '$value')) {
       const id = path.join('.');
+      if (node.$value === undefined) return; // Skip tokens without values
+      // Normalize DTCG 2025.10 structured color/dimension objects to the
+      // string/number form the engine + plugins expect (strings, incl. aliases,
+      // pass through unchanged). Keeps the color math in core/color.ts untouched.
       const raw = node.$value;
-      if (raw === undefined) return; // Skip tokens without values
-      
+      const normalized = normalizeDtcgValue(raw, node.$type);
+
       const refs: TokenId[] = [];
       
       // Find all references in the value
-      if (typeof raw === 'string') {
-        const matches = raw.matchAll(REF_RE);
+      if (typeof normalized === 'string') {
+        const matches = normalized.matchAll(REF_RE);
         for (const match of matches) {
           refs.push(match[1]);
         }
@@ -47,7 +67,7 @@ export function flattenTokens(root: TokenNode): FlattenResult {
       flat[id] = { 
         id, 
         type: String(node.$type ?? 'unknown'), 
-        value: raw,
+        value: normalized,
         raw, 
         refs 
       };
@@ -72,8 +92,8 @@ export function flattenTokens(root: TokenNode): FlattenResult {
   // Second pass: resolve references iteratively
   let changed = true;
   let iterations = 0;
-  const maxIterations = Object.keys(flat).length * 2; // Safety limit
-  
+  const maxIterations = Object.keys(flat).length * 2 + 1; // Safety limit (never 0)
+
   while (changed && iterations < maxIterations) {
     changed = false;
     iterations++;
@@ -96,7 +116,7 @@ export function flattenTokens(root: TokenNode): FlattenResult {
           }
           
           // Replace the reference with the resolved value
-          const refPattern = new RegExp(`\\{${refId}\\}`, 'g');
+          const refPattern = new RegExp(`\\{${escapeRegExp(refId)}\\}`, 'g');
           newValue = newValue.replace(refPattern, String(refToken.value));
         }
         
@@ -108,8 +128,20 @@ export function flattenTokens(root: TokenNode): FlattenResult {
     }
   }
   
-  if (iterations >= maxIterations) {
-    throw new Error('Token resolution exceeded maximum iterations - possible circular reference');
+  // A token still carrying an unresolved "{ref}" placeholder after the fixpoint
+  // means a genuine cycle (a -> b -> a) or a self-reference. An empty or
+  // fully-literal token set resolves cleanly and must never trip this guard —
+  // the old `iterations >= maxIterations` check threw a bogus "circular
+  // reference" error whenever no tokens were found (maxIterations === 0).
+  const unresolved = Object.values(flat).filter(
+    (t) => typeof t.value === 'string' && t.value.includes('{'),
+  );
+  if (unresolved.length > 0) {
+    throw new Error(
+      `Token resolution exceeded maximum iterations - possible circular reference (unresolved: ${unresolved
+        .map((t) => t.id)
+        .join(', ')})`,
+    );
   }
 
   return { flat, edges };

package/core/image-export.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"image-export.d.ts","sourceRoot":"","sources":["image-export.ts"],"names":[],"mappings":"AAmBA,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,KAAK,CAAC;AACrC,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,KAAK,CAAC;AAEzC,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EAAe,6BAA6B;AAC7D,OAAO,EAAE,MAAM,EAAiB,wBAAwB;AACxD,GAAG,EAAE,QAAQ,EAAmB,gBAAgB;AAChD,QAAQ,EAAE,QAAQ,GACjB;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAoBhC"}
+{"version":3,"file":"image-export.d.ts","sourceRoot":"","sources":["image-export.ts"],"names":[],"mappings":"AAsBA,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,KAAK,CAAC;AACrC,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,KAAK,CAAC;AAEzC,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EAAe,6BAA6B;AAC7D,OAAO,EAAE,MAAM,EAAiB,wBAAwB;AACxD,GAAG,EAAE,QAAQ,EAAmB,gBAAgB;AAChD,QAAQ,EAAE,QAAQ,GACjB;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAoBhC"}

package/core/image-export.js

@@ -5,13 +5,16 @@ import { spawnSync } from "node:child_process";
 function which(cmd) {
     const paths = (process.env.PATH || "").split(path.delimiter);
     for (const p of paths) {
-        const full = path.join(p, cmd + (process.platform === "win32" ? ".cmd" : ""));
-        try {
-            fs.accessSync(full, fs.constants.X_OK);
-            return full;
-        }
-        catch {
-            // File not accessible, continue to next path
+        const names = process.platform === "win32" ? [cmd + ".cmd", cmd + ".exe", cmd] : [cmd];
+        for (const name of names) {
+            const full = path.join(p, name);
+            try {
+                fs.accessSync(full, fs.constants.X_OK);
+                return full;
+            }
+            catch {
+                // File not accessible, continue to next path
+            }
         }
     }
     return null;

package/core/image-export.ts

@@ -6,12 +6,15 @@ import { spawnSync } from "node:child_process";
 function which(cmd: string): string | null {
   const paths = (process.env.PATH || "").split(path.delimiter);
   for (const p of paths) {
-    const full = path.join(p, cmd + (process.platform === "win32" ? ".cmd" : ""));
-    try { 
-      fs.accessSync(full, fs.constants.X_OK); 
-      return full; 
-    } catch {
-      // File not accessible, continue to next path
+    const names = process.platform === "win32" ? [cmd + ".cmd", cmd + ".exe", cmd] : [cmd];
+    for (const name of names) {
+      const full = path.join(p, name);
+      try {
+        fs.accessSync(full, fs.constants.X_OK);
+        return full;
+      } catch {
+        // File not accessible, continue to next path
+      }
     }
   }
   return null;

package/core/index.d.ts

@@ -7,4 +7,6 @@
 export type { TokenId, TokenValue } from "./flatten.js";
 export type { ConstraintIssue, ConstraintPlugin, Graph } from "./engine.js";
 export { Engine } from "./engine.js";
+export { validate } from "../cli/validate-api.js";
+export type { ValidateInput, ValidateResult } from "../cli/validate-api.js";
 //# sourceMappingURL=index.d.ts.map

package/core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACxD,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACxD,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAKrC,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC"}

package/core/index.js

@@ -5,3 +5,7 @@
  * See engine.ts for full implementation with Phase 3C enhancements.
  */
 export { Engine } from "./engine.js";
+// Programmatic convenience API (validate tokens against constraints in one call).
+// Implemented in the CLI layer atop the shared registry; surfaced here as the
+// package's public entry point.
+export { validate } from "../cli/validate-api.js";

package/core/index.ts

@@ -8,3 +8,9 @@
 export type { TokenId, TokenValue } from "./flatten.js";
 export type { ConstraintIssue, ConstraintPlugin, Graph } from "./engine.js";
 export { Engine } from "./engine.js";
+
+// Programmatic convenience API (validate tokens against constraints in one call).
+// Implemented in the CLI layer atop the shared registry; surfaced here as the
+// package's public entry point.
+export { validate } from "../cli/validate-api.js";
+export type { ValidateInput, ValidateResult } from "../cli/validate-api.js";

package/core/poset.d.ts

@@ -3,7 +3,12 @@ export type Comp = "<=" | ">=";
 export type Order = [Id, Comp, Id];
 export type Digraph = Map<Id, Set<Id>>;
 export type EdgeLabels = Map<string, string>;
-/** Safe ID for Mermaid/DOT node identifiers */
+/**
+ * Safe, INJECTIVE node identifier for Mermaid/DOT. Each non-alphanumeric byte
+ * (including `_`) is encoded as `_<charCode>_`, so distinct token ids can never
+ * collapse to the same node id (e.g. `a.b` -> `a_46_b`, `a_b` -> `a_95_b`).
+ * A naive `[^a-zA-Z0-9_] -> _` replacement merged those, corrupting graphs.
+ */
 export declare function sanitizeId(id: string): string;
 export type Highlight = {
     nodes?: Set<string>;

package/core/poset.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"poset.d.ts","sourceRoot":"","sources":["poset.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,EAAE,GAAG,MAAM,CAAC;AACxB,MAAM,MAAM,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAC/B,MAAM,MAAM,KAAK,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;AAEnC,MAAM,MAAM,OAAO,GAAG,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;AAGvC,MAAM,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAM7C,+CAA+C;AAC/C,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACpB,KAAK,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAgB,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAYnD;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAwBvD;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,EAAC,KAAe,EAAC;;CAAK,GAAG,MAAM,CAQ9E;AAGD,wBAAgB,oBAAoB,CAClC,CAAC,EAAE,OAAO,EACV,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,UAAU,CAAA;CAAO,GACxE,MAAM,CAuCR;AAED,wBAAgB,UAAU,CACxB,MAAM,EAAE,OAAO,EACf,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,UAAU,CAAA;CAAO,GACjD,MAAM,CAoBR;AAGD,wBAAgB,gBAAgB,CAC9B,CAAC,EAAE,OAAO,EACV,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,UAAU,CAAA;CAAO,GACxE,MAAM,CAyCR;AAGD,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,CAAA;CAAE,CA2C7E;AAED,wBAAgB,aAAa,CAC3B,CAAC,EAAE,OAAO,EACV,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,GACjC,OAAO,CAYT;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAKtE;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAK3E;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,SAAI,GAAG,OAAO,CA8B3E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAOxF"}
+{"version":3,"file":"poset.d.ts","sourceRoot":"","sources":["poset.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,EAAE,GAAG,MAAM,CAAC;AACxB,MAAM,MAAM,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAC/B,MAAM,MAAM,KAAK,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;AAEnC,MAAM,MAAM,OAAO,GAAG,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;AAGvC,MAAM,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAM7C;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACpB,KAAK,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAgB,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAYnD;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAwBvD;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,EAAC,KAAe,EAAC;;CAAK,GAAG,MAAM,CAQ9E;AAGD,wBAAgB,oBAAoB,CAClC,CAAC,EAAE,OAAO,EACV,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,UAAU,CAAA;CAAO,GACxE,MAAM,CAuCR;AAED,wBAAgB,UAAU,CACxB,MAAM,EAAE,OAAO,EACf,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,UAAU,CAAA;CAAO,GACjD,MAAM,CAoBR;AAGD,wBAAgB,gBAAgB,CAC9B,CAAC,EAAE,OAAO,EACV,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,UAAU,CAAA;CAAO,GACxE,MAAM,CAyCR;AAGD,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,CAAA;CAAE,CA2C7E;AAED,wBAAgB,aAAa,CAC3B,CAAC,EAAE,OAAO,EACV,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,GACjC,OAAO,CAYT;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAKtE;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAK3E;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,SAAI,GAAG,OAAO,CA8B3E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAOxF"}

package/core/poset.js

@@ -3,9 +3,14 @@
 // Small escapes so Mermaid/DOT don't choke on special characters
 const escMermaid = (s) => s.replace(/"/g, '\\"').replace(/\n/g, "\\n");
 const escDot = (s) => s.replace(/"/g, '\\"').replace(/\n/g, "\\n");
-/** Safe ID for Mermaid/DOT node identifiers */
+/**
+ * Safe, INJECTIVE node identifier for Mermaid/DOT. Each non-alphanumeric byte
+ * (including `_`) is encoded as `_<charCode>_`, so distinct token ids can never
+ * collapse to the same node id (e.g. `a.b` -> `a_46_b`, `a_b` -> `a_95_b`).
+ * A naive `[^a-zA-Z0-9_] -> _` replacement merged those, corrupting graphs.
+ */
 export function sanitizeId(id) {
-    return id.replace(/[^a-zA-Z0-9_]/g, "_");
+    return id.replace(/[^a-zA-Z0-9]/g, (c) => `_${c.charCodeAt(0)}_`);
 }
 export function buildPoset(orders) {
     const g = new Map();

package/core/poset.ts

@@ -14,9 +14,14 @@ export type EdgeLabels = Map<string, string>; // key = "a|b" (raw ids)
 const escMermaid = (s: string) => s.replace(/"/g, '\\"').replace(/\n/g, "\\n");
 const escDot = (s: string) => s.replace(/"/g, '\\"').replace(/\n/g, "\\n");
 
-/** Safe ID for Mermaid/DOT node identifiers */
+/**
+ * Safe, INJECTIVE node identifier for Mermaid/DOT. Each non-alphanumeric byte
+ * (including `_`) is encoded as `_<charCode>_`, so distinct token ids can never
+ * collapse to the same node id (e.g. `a.b` -> `a_46_b`, `a_b` -> `a_95_b`).
+ * A naive `[^a-zA-Z0-9_] -> _` replacement merged those, corrupting graphs.
+ */
 export function sanitizeId(id: string): string {
-  return id.replace(/[^a-zA-Z0-9_]/g, "_");
+  return id.replace(/[^a-zA-Z0-9]/g, (c) => `_${c.charCodeAt(0)}_`);
 }
 
 export type Highlight = {

package/core/why.d.ts

@@ -2,7 +2,7 @@ import type { FlatToken } from "./flatten.js";
 export type WhyReport = {
     id: string;
     value: string | number | undefined;
-    raw?: string | number;
+    raw?: unknown;
     refs?: string[];
     provenance: "base" | "theme" | "override" | "unknown";
     dependsOn: string[];

package/core/why.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"why.d.ts","sourceRoot":"","sources":["why.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACnC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;IACtD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,MAAM,EAAC,MAAM,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAQxF;AAED,wBAAgB,OAAO,CACrB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAC/B,KAAK,EAAE,KAAK,CAAC,CAAC,MAAM,EAAC,MAAM,CAAC,CAAC,EAC7B,MAAM,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAO,GACpF,SAAS,CAkCX"}
+{"version":3,"file":"why.d.ts","sourceRoot":"","sources":["why.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACnC,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;IACtD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,MAAM,EAAC,MAAM,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAQxF;AAED,wBAAgB,OAAO,CACrB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAC/B,KAAK,EAAE,KAAK,CAAC,CAAC,MAAM,EAAC,MAAM,CAAC,CAAC,EAC7B,MAAM,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAO,GACpF,SAAS,CAkCX"}

package/core/why.ts

@@ -3,7 +3,7 @@ import type { FlatToken } from "./flatten.js";
 export type WhyReport = {
   id: string;
   value: string | number | undefined;
-  raw?: string | number;
+  raw?: unknown;
   refs?: string[];
   provenance: "base" | "theme" | "override" | "unknown";
   dependsOn: string[];     // immediate refs (parents)