synthesisui 0.16.207 → 0.16.209

package/dist/commands/doctor.js

@@ -758,6 +758,26 @@ export async function doctor(opts) {
         console.log("");
         console.log(body(`Token coverage  ${meter(d.coverage)}  ${paint.strong(`${String(d.coverage).padStart(3)}%`)}`));
         console.log(body(paint.dim(`                ${d.tokenUses} from the system, ${d.findings.length} by hand${d.phantomUses > 0 ? `, ${d.phantomUses} naming nothing` : ""}`)));
+        /**
+         * ZERO NUM REPO QUE ORIGINOU O SISTEMA É O ESTADO CERTO, e sem esta linha ele lê como falha
+         * NOSSA.
+         *
+         * "Token coverage 0% - 1 from the system, 4433 by hand" é literalmente verdade e ainda assim
+         * engana: quando o sistema foi medido A PARTIR daqui, esses valores escritos à mão são a FONTE
+         * de onde os tokens saíram, não um desvio deles. Não há nada consertado ainda porque não havia
+         * nada quebrado - o passo seguinte é o código passar a apontar para os nomes que agora existem.
+         *
+         * O sinal é `measured.system`: a pasta de onde o import mediu. Ele só existe quando este
+         * repositório é a origem, então a frase não aparece para quem instalou um sistema de fora - ali
+         * um zero significa outra coisa e merece outra frase.
+         *
+         * A lei 14 em uma linha: um zero pelado lê como falha nossa, um zero com motivo lê como fato.
+         */
+        if (d.tokenUses === 0 && measured.system) {
+            console.log(body(paint.dim(`                zero is the expected start here - this system was measured FROM`)));
+            console.log(body(paint.dim(`                \`${measured.system}\`, so these values are its source, not a drift`)));
+            console.log(body(paint.dim(`                from it. They count once the code points at the names they became.`)));
+        }
         // The strongest number leads, not trails: it used to sit two screens
         // down, after the phantom list (30/07). For the reader who already owns
         // a system - the ICP - THIS line is the report.

package/dist/doctor/fragments.js

@@ -262,6 +262,26 @@ kind) {
  */
 export function judgeFragments(seen, declared, admitted) {
     return seen.map((f) => {
+        /**
+         * UMA DECLARAÇÃO SEM LEITOR CUJO VALOR É UM TOKEN QUE ELES JÁ DECLARAM.
+         *
+         * `h1 { font-size: var(--text-h1) }` num CSS global não tem leitor, e a frase que ia junto -
+         * *"os estilos que ela carrega não chegam a receita nenhuma"* - é falsa: `--text-h1` está
+         * declarado, capturado, e vale 2rem no sistema dele. O que não foi capturado é a LIGAÇÃO, qual
+         * elemento veste qual token.
+         *
+         * Medido em 11/08 na base tipográfica dele: das 13 declarações do `src/styles.css` arquivadas
+         * como sem leitor, SETE são desta forma - `--font-sans` (3x), `--text-h1`, `--text-h2`,
+         * `--text-h3` e `--color-blue-600`. Nenhuma delas carrega um valor que o sistema não tenha.
+         *
+         * A referência precisa apontar para algo DECLARADO. Um `var(--nao-existe)` continua sendo o que
+         * era: o browser descarta a declaração, e ali não há token nenhum a reivindicar.
+         */
+        if (f.reason === "shape-not-read") {
+            const ref = /:\s*var\(\s*(--[a-z0-9-]+)/i.exec(f.text);
+            if (ref && declared.has(ref[1]))
+                return { ...f, reason: "binding-not-read" };
+        }
         if (f.reason)
             return f;
         switch (f.shape) {

package/dist/doctor/gap-triage.js

@@ -46,6 +46,11 @@ const OWNER = {
 function verdictOf(reason) {
     switch (reason) {
         case "shape-not-read":
+        /**
+         * A LIGAÇÃO TAMBÉM É TRABALHO DE LEITOR - o que muda é a frase, não o veredito. O valor já
+         * está no sistema; o que falta é um leitor que registre qual elemento veste qual token.
+         */
+        case "binding-not-read":
             return "no-reader";
         case "value-not-read":
             return "value-gap";

package/dist/doctor/style-ledger.js

@@ -56,6 +56,7 @@ const BECAUSE = {
     computed: "the value is assembled at render time, so it is not in the source at any level and there is nothing to read",
     "component-not-admitted": "read, and it belongs to a component this scope does not admit into the system - the styles exist and no recipe claims them",
     "sheet-not-imported": "this is a sass partial and no stylesheet imports it, so your own build never compiles it - it paints nothing today, here or anywhere",
+    "binding-not-read": "the value here is a token your system already declares, so nothing is lost - what is not captured is which element wears it",
 };
 /**
  * O ledger de uma varredura, a partir dos fragmentos vistos.

package/dist/doctor/transcribe.js

@@ -1325,12 +1325,44 @@ function layerFor(out, when, at) {
  * attempt.
  */
 const INLINE_STYLE = /style=\{\{([^{}]*(?:\{[^{}]*\}[^{}]*)*)\}\}/;
+/**
+ * AS PROPRIEDADES, SEPARADAS PELA VÍRGULA QUE SEPARA - e não pela que está dentro de um valor.
+ *
+ * `split(",")` partia `var(--color-track, var(--color-darkgray-300))` ao meio e entregava duas
+ * metades que não são nada. Vírgula dentro de parêntese ou de aspas pertence ao valor.
+ */
+function splitProperties(body) {
+    const out = [];
+    let depth = 0;
+    let quote = null;
+    let start = 0;
+    for (let i = 0; i < body.length; i += 1) {
+        const c = body[i];
+        if (quote) {
+            if (c === quote && body[i - 1] !== "\\")
+                quote = null;
+            continue;
+        }
+        if (c === '"' || c === "'" || c === "`")
+            quote = c;
+        else if (c === "(" || c === "[")
+            depth += 1;
+        else if (c === ")" || c === "]")
+            depth -= 1;
+        else if (c === "," && depth === 0) {
+            out.push(body.slice(start, i));
+            start = i + 1;
+        }
+    }
+    out.push(body.slice(start));
+    return out;
+}
 export function readInlineStyle(source) {
     const m = INLINE_STYLE.exec(source);
     if (!m)
         return {};
     const out = {};
-    for (const piece of m[1].split(",")) {
+    for (const piece of splitProperties(m[1])) {
         const colon = piece.indexOf(":");
         if (colon === -1)
             continue;
@@ -1339,10 +1371,24 @@ export function readInlineStyle(source) {
             .trim()
             .replace(/^["']|["']$/g, "");
         let value = piece.slice(colon + 1).trim();
+        /**
+         * UMA STRING ENTRE ASPAS ESTÁ NO FONTE, e o que ela tem dentro não muda isso.
+         *
+         * O guarda descartava todo valor com parêntese, e com isso todo `var()`, `linear-gradient()`,
+         * `calc()` e `rgb()` escrito em estilo inline - que são exatamente os valores que carregam
+         * decisão de design. Medido em 11/08 no repo dele: 2 dos 6 fragmentos que o censo chamava de
+         * `computed` eram literais, entre eles
+         * `style={{ stroke: "var(--color-track, var(--color-darkgray-300))" }}`.
+         *
+         * A distinção certa não é "tem parêntese", é "está no fonte": literal entre aspas se lê inteiro,
+         * e só o que NÃO está entre aspas passa pelo guarda de expressão.
+         */
+        const quoted = /^(["'])([\s\S]*)\1$/.exec(value);
+        if (quoted)
+            value = quoted[2];
         // A value computed at runtime is not in the source, so there is nothing to read.
-        if (!value || /[`$]|\?|=>|\(/.test(value))
+        else if (!value || /[`$]|\?|=>|\(/.test(value))
             continue;
-        value = value.replace(/^["']|["']$/g, "");
         if (!/^[a-zA-Z][\w]*$/.test(prop))
             continue;
         if (/[<>{}@;]/.test(value))

package/dist/install-marks.js

@@ -85,8 +85,17 @@ export const CHECKER_SINCE = "0.16.202";
  * Ou seja, o `READER` estava errado e ninguém tinha sido avisado. A marca nasceu em `0.16.202`,
  * bisseccionada: o censo de 0.16.201 difere do de então, o de 0.16.202 é byte a byte igual.
  *
- * ANDOU PARA `0.16.207` no mesmo dia, e desta vez o portão é que mandou. `fragmentsOfSource` parou
- * de tomar operando de `===` e texto de comentário por classe - 11 das 26 declarações que o censo
- * dele listava como ilegíveis eram acusação NOSSA. Um censo medido antes disto carrega as onze.
+ * ANDOU DUAS VEZES no mesmo dia, e nas duas foi o portão que mandou:
+ *
+ *     0.16.207  `fragmentsOfSource` parou de tomar operando de `===` e texto de comentário por
+ *               classe - 11 das 26 declarações que o censo dele listava como ilegíveis eram
+ *               acusação NOSSA
+ *     0.16.208  `readInlineStyle` parou de descartar valor com parêntese - `var()` e
+ *               `linear-gradient()` em `style={{}}` chegam na receita, e 2 dos 6 fragmentos
+ *               chamados de `computed` eram literais no fonte
+ *     0.16.209  uma declaração global cujo valor é token JÁ declarado deixou de ser arquivada
+ *               como "nenhum leitor entende esta forma" - 7 das 13 da base tipográfica dele
+ *
+ * Um censo medido antes disto carrega as duas leituras erradas.
  */
-export const READER_SINCE = "0.16.207";
+export const READER_SINCE = "0.16.209";

package/package.json

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