synthesisui 0.16.208 → 0.16.210

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

@@ -50,12 +50,32 @@ const SHAPE_LABEL = {
     styled: "styled-components",
     runtime: "classes built at runtime",
 };
+/**
+ * OS MOTIVOS QUE UM LEITOR NOVO ALCANÇA - e por isso os fragmentos deles viajam com o TEXTO.
+ *
+ * CONJUNTO NOMEADO, e não uma comparação com um literal, porque a comparação já falhou. Isto era
+ * `reason === "shape-not-read"`, e em 0.16.209 aquele motivo foi DIVIDIDO em dois: as sete
+ * declarações da base tipográfica do repo do dono viraram `binding-not-read` e saíram, caladas, do
+ * único lugar que carrega o texto delas. A tela então mostrava UM exemplo de sete, embaixo de um
+ * prompt que promete *"the detail page carries each fragment with its file, its line AND the text"*
+ * (dono, 11/08).
+ *
+ * O que o texto compra: um leitor novo roda no servidor sobre o censo já guardado, e o conserto vira
+ * um deploy em vez de esperar aquele repositório publicar um CLI novo e re-medir.
+ *
+ * Um motivo novo que um leitor alcance entra AQUI. Fora daqui ele vira contagem sem lugar.
+ */
+const A_READER_REACHES = new Set([
+    "shape-not-read",
+    "binding-not-read",
+]);
 const BECAUSE = {
     "shape-not-read": "no reader in this version understands this shape, so the styles it holds reach no recipe",
     "value-not-read": "the shape is read and this value is not - a utility or property outside the scales this project declares",
     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.
@@ -96,13 +116,11 @@ export function buildLedger(cli, seen) {
                 text: f.text.replace(/\s+/g, " ").trim().slice(0, 160),
             });
         /**
-         * SÓ `shape-not-read`, E SÓ TEXTO DISTINTO - as duas restrições vieram de medir, não de supor.
+         * SÓ O QUE UM LEITOR ALCANÇA, E SÓ TEXTO DISTINTO - as duas restrições vieram de medir.
          *
-         * DAS QUATRO RAZÕES, uma só é alcançável por um leitor novo. `value-not-read` diz que a forma FOI
-         * lida e o valor está fora das escalas deles - texto não ensina nada a leitor nenhum. `computed`
-         * é montado em runtime e não existe na fonte. `component-not-admitted` é o portão, não a leitura.
-         * Sobra `shape-not-read`: "nenhum leitor desta versão entende esta forma", que é exatamente a
-         * frase que um leitor novo responde.
+         * `value-not-read` diz que a forma FOI lida e o valor está fora das escalas deles - texto não
+         * ensina nada a leitor nenhum. `computed` é montado em runtime e não existe na fonte.
+         * `component-not-admitted` é o portão, não a leitura. Sobram os dois de `A_READER_REACHES`.
          *
          * E TEXTO DISTINTO, porque a primeira versão disto reprovou no spec do repo vivo: guardar todo
          * fragmento deu 723 215 bytes no dashboard dele, contra um teto de 65 536. Oito mil cópias da
@@ -111,7 +129,7 @@ export function buildLedger(cli, seen) {
          * O teto de 512 é declarado e não mudo: `uses` continua contando tudo, então a diferença entre o
          * contado e o que viajou é visível em vez de silenciosa.
          */
-        if (reason === "shape-not-read" &&
+        if (A_READER_REACHES.has(reason) &&
             group.unreadable.length < 512 &&
             !group.unreadable.some((u) => u.text === f.text))
             group.unreadable.push({

package/dist/install-marks.js

@@ -93,7 +93,11 @@ export const CHECKER_SINCE = "0.16.202";
  *     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
+ *     0.16.210  e essas 7 voltaram a viajar com o TEXTO: o array `unreadable` era preenchido por
+ *               comparação com UM literal, e a divisão do motivo as tirou dele em silêncio
  *
  * Um censo medido antes disto carrega as duas leituras erradas.
  */
-export const READER_SINCE = "0.16.208";
+export const READER_SINCE = "0.16.210";

package/package.json

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