synthesisui 0.16.69 → 0.16.71

package/dist/commands/import.js

@@ -6,11 +6,11 @@ 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";
-import { rootClasses, transcribe, } from "../doctor/transcribe.js";
+import { rootClasses, rootTag, transcribe, } from "../doctor/transcribe.js";
 import { body, paint, section } from "../output.js";
 import { walk, walkAll } from "./doctor.js";
 /**
@@ -312,8 +312,10 @@ export async function takeCensus(root) {
                 const size = Object.keys(t.base).length +
                     Object.keys(t.dark).length +
                     Object.keys(t.states).length;
-                if (size > 0)
-                    looks[found[0].name] = t;
+                const tag = rootTag(src);
+                if (size > 0 || tag) {
+                    looks[found[0].name] = tag ? { ...t, rootTag: tag } : t;
+                }
             }
         }
     }
@@ -490,13 +492,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

@@ -288,7 +288,12 @@ export function transcribe(classes, declared) {
         if (target[decl.property] != null)
             continue;
         target[decl.property] = decl.value;
-        out.fromToken += 1;
+        // 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
+            out.fromLiteral += 1;
     }
     return out;
 }
@@ -304,6 +309,25 @@ export function transcribe(classes, declared) {
  * nothing, and nothing is a contract with an empty base - which is exactly what
  * the import already produces, so failing here costs no ground.
  */
+/**
+ * The TAG of the element a component returns - `button`, `input`, `div`.
+ *
+ * Cheap, and it is half of what decides a preview's anatomy: a component whose
+ * root is a `<button>` is an action however it is named, and one whose root is a
+ * bare `<span>` is an indicator. The platform pairs this with the name; see
+ * `preview-kind.ts`.
+ *
+ * A composed root (`<Radio.Root>`) returns the component name, not an HTML tag -
+ * which is still a signal, just a weaker one, so it travels as written and the
+ * platform decides what to do with it.
+ */
+export function rootTag(source) {
+    const ret = source.search(/return\s*\(/);
+    if (ret === -1)
+        return null;
+    const m = /<([A-Za-z][A-Za-z0-9.]*)/.exec(source.slice(ret));
+    return m ? m[1] : null;
+}
 export function rootClasses(source) {
     const ret = source.search(/return\s*\(/);
     if (ret === -1)

package/package.json

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