synthesisui 0.16.68 → 0.16.70

package/dist/commands/import.js

@@ -6,7 +6,7 @@ import { isNearDuplicate, isNeutral, lightness, } from "../doctor/color-distance
 import { emptyTally, internalSpecifiers, scanComponentsInto, tallyToInventory, } from "../doctor/components-scan.js";
 import { crosswalk, observedRules } from "../doctor/crosswalk.js";
 import { reconcile, scanDefinitions, } from "../doctor/definitions-scan.js";
-import { describeConvention, detectConventions, IDIOM_LABEL, } from "../doctor/idiom.js";
+import { describeConvention, describeRemainder, detectConventions, } from "../doctor/idiom.js";
 import { diagnose, scanSource } from "../doctor/scan.js";
 import { parseSchemeBlocks } from "../doctor/scheme-blocks.js";
 import { buildTable } from "../doctor/tokens.js";
@@ -490,13 +490,12 @@ function sayConventions(c) {
     console.log(section("How you reference a value"));
     for (const conv of list) {
         console.log(body(describeConvention(conv)));
-        const off = conv.offIdiom.filter((o) => o.count > 0).slice(0, 3);
-        if (off.length > 0) {
-            console.log(body(paint.faint(`  and ${off.map((o) => `${o.count} ${IDIOM_LABEL[o.idiom]}`).join(", ")}`)));
-        }
+        const remainder = describeRemainder(conv);
+        if (remainder)
+            console.log(body(paint.faint(`  ${remainder}`)));
     }
     console.log("");
-    console.log(body(paint.faint("Nothing here is a rule we brought. It is what your own files do most, so the rest can be named against it.")));
+    console.log(body(paint.faint("Nothing here is a rule we brought - it is what your own files already do, and the system now knows it. None of the rest has to move today: this is a complement, not a correction.")));
 }
 /**
  * NOT DRIFT - BROKEN. A `var()` no declaration answers renders nothing at all,

package/dist/doctor/idiom.js

@@ -122,10 +122,38 @@ export function detectConventions(sources, minReferences = 20) {
 export function describeConvention(c) {
     const pct = Math.round(c.share * 100);
     if (c.idiom === "raw-hex") {
-        return `${c.language} has no convention - ${pct}% of its ${c.total} references are values typed in place`;
+        return `${c.language} has no single convention yet - ${pct}% of its ${c.total} references are values typed in place`;
     }
     return `${c.language} reaches for ${IDIOM_LABEL[c.idiom]} - ${pct}% of the ${c.total} references in it`;
 }
+/**
+ * WHAT IS NOT YET IN THE CONVENTION - and the wording is the whole point.
+ *
+ * "and 1154 raw hex" reads as 1154 errors in the author's face. The measurement
+ * is the same and the accusation is gratuitous: this system exists to make their
+ * work SCALABLE, not to mark it wrong, and a design system is somebody's
+ * judgement before it is anybody's audit (dono, 01/08 - "entrar como um
+ * complemento").
+ *
+ * So the number is stated as coverage, not as a count of mistakes, and it says
+ * out loud that none of it has to change today.
+ */
+export function describeRemainder(c) {
+    const off = c.offIdiom.filter((o) => o.count > 0);
+    if (off.length === 0)
+        return null;
+    const total = off.reduce((n, o) => n + o.count, 0);
+    const named = off
+        .slice(0, 3)
+        .map((o) => `${o.count} ${IDIOM_LABEL[o.idiom]}`)
+        .join(", ");
+    // The reassurance belongs at the END of the section, once. Repeated on every
+    // line it becomes noise, and noise is how a report stops being read.
+    if (!hasConvention(c)) {
+        return `the other ${total} are ${named} - no single answer dominates here yet`;
+    }
+    return `${total} are not in it yet: ${named}`;
+}
 /** True when this language's dominant answer is "no answer". */
 export function hasConvention(c) {
     return c.idiom !== "raw-hex";

package/dist/doctor/transcribe.js

@@ -227,6 +227,7 @@ export function transcribe(classes, declared) {
         states: {},
         dark: {},
         skipped: [],
+        literals: [],
         fromToken: 0,
         fromLiteral: 0,
     };
@@ -267,12 +268,28 @@ export function transcribe(classes, declared) {
         }
         if (!decl || !target)
             continue;
+        /**
+         * EVERYTHING IT READS TRAVELS, literals included - as DATA.
+         *
+         * Which of these becomes a recipe declaration is not this module's call: a
+         * literal cannot re-theme, and whether `#ffffff` is a white or a SURFACE
+         * depends on the two palettes, which only exist on the platform. An earlier
+         * version wrote literals straight into `base` and a dark preview rendered a
+         * white box with white text on it; the version after that dropped them and
+         * carried almost nothing. Both were this module deciding something it cannot
+         * see (dono, 01/08).
+         *
+         * So it reports the whole reading and the platform pairs base against dark
+         * to recover the role. See `exclusive-contract.ts`.
+         */
         // First write wins, matching how a class list resolves for the properties
         // we read: later duplicates in the same list are almost always a merge
         // artefact rather than an override.
         if (target[decl.property] != null)
             continue;
         target[decl.property] = decl.value;
+        // Both travel now, so both are counted honestly. The platform decides which
+        // becomes a declaration; this only reports what the reading was made of.
         if (decl.token)
             out.fromToken += 1;
         else

package/package.json

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