synthesisui 0.16.37 → 0.16.38

package/dist/commands/import.js

@@ -99,17 +99,27 @@ async function detectStack(root) {
         stack.push("plain css");
     return stack;
 }
-/** Their own vocabulary, read from stylesheets - the same harvest the doctor
- *  runs when nothing of ours is installed. */
-async function declaredTokens(root) {
+/**
+ * Their own vocabulary, read from stylesheets - the same harvest the doctor runs
+ * when nothing of ours is installed.
+ *
+ * Returns the TABLE, not just the names, because the scan needs it. The first
+ * version harvested the names for the payload and then scanned with an EMPTY
+ * table, which made the census blind in a way a real app exposed (dono, 30/07):
+ * a project with 2416 uses of its own `var(--dashboard-*)` reported
+ * `tokenUses: 0`, `coverage: 0`, and `token: null` on every single value. The
+ * sharpest sentence the doctor knows - "your own system already has a name for
+ * this" - could not be said, and we ended up rediscovering by colour distance
+ * what their stylesheet had spelled out all along.
+ */
+async function harvestOwnTable(root) {
     let css = "";
     for await (const file of walkAll([root])) {
         if (!/\.(css|scss|sass|less)$/i.test(file))
             continue;
         css += `\n${await readFile(file, "utf8").catch(() => "")}`;
     }
-    const table = buildTable({ css, source: "yours" });
-    return Object.fromEntries(table.byName);
+    return buildTable({ css, source: "yours" });
 }
 /**
  * EVERY distinct design value, commonest first - not just the repeated ones.
@@ -202,7 +212,7 @@ function distinctValues(d) {
     return kept.sort((a, b) => b.count - a.count || a.value.localeCompare(b.value));
 }
 export async function takeCensus(root) {
-    const table = buildTable({ css: "", source: "yours" });
+    const table = await harvestOwnTable(root);
     const reports = [];
     for await (const file of walk(root)) {
         const src = await readFile(file, "utf8").catch(() => "");
@@ -224,7 +234,7 @@ export async function takeCensus(root) {
     return {
         census: 1,
         project: { name, stack: await detectStack(root) },
-        declared: await declaredTokens(root),
+        declared: Object.fromEntries(table.byName),
         observed: distinctValues(d),
         totals: {
             scanned: d.scanned,
@@ -251,6 +261,12 @@ function summarize(c) {
     if (Object.keys(c.declared).length > 0) {
         console.log(body(`${Object.keys(c.declared).length} tokens you already declare - your names travel unchanged`));
     }
+    // The sharpest number in the report, and it only became sayable once the scan
+    // started using their own token table: not "you have drift" but "you have
+    // drift your own system already solved".
+    if (c.totals.named > 0) {
+        console.log(body(`${paint.strong(String(c.totals.named))} of those values ALREADY have a name in your system - ${c.totals.coverage}% of your design values come from it today`));
+    }
     const top = c.observed.slice(0, 5);
     if (top.length > 0) {
         console.log("");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "synthesisui",
-  "version": "0.16.37",
+  "version": "0.16.38",
   "description": "Bring SynthesisUI design systems into any project - tokens, typed components, whole pages and an agent-ready CLAUDE.md manifest.",
   "type": "module",
   "bin": {