synthesisui 0.16.205 → 0.16.207

package/dist/commands/align.js

@@ -5,22 +5,27 @@ import { pinnedHookVersion } from "../agent-wiring.js";
 import { isOlderCli } from "../cli-version.js";
 import { readToken, resolveRegistry } from "../config.js";
 import { unsentEvents } from "../doctor/ledger.js";
-import { CHECKER_SINCE, MATERIALISER_SINCE } from "../install-marks.js";
+import { CHECKER_SINCE, MATERIALISER_SINCE, READER_SINCE, } from "../install-marks.js";
 import { measuredScope } from "../measured-scope.js";
-import { READER } from "../reader-version.js";
 /**
- * Qual leitor mediu o censo em disco, quando ele o registra.
+ * QUAL CLI MEDIU O CENSO EM DISCO - e era o `reader`, um inteiro, até 11/08.
  *
- * `null` para censo anterior a esta marca: um censo que não diz quem o leu não prova nada, e supor
- * que ele é velho faria toda pessoa que ainda não re-mediu ver o aviso para sempre.
+ * O carimbo `ledger.reader` existe e continua sendo gravado, mas ele não serve para responder esta
+ * pergunta: ficou parado em 1 enquanto os leitores mudavam, então censos de julho e de ontem levam
+ * o mesmo número e nada os separa. A versão que mediu separa - ver `READER_SINCE`.
+ *
+ * `null` para censo que não diz quem o mediu: um censo assim não prova nada, e supor que ele é
+ * velho faria toda pessoa que ainda não re-mediu ver o aviso para sempre.
  */
-async function censusReader(root) {
+async function censusMeasuredBy(root) {
     const raw = await readFile(join(root, "_synthesisui", "census.json"), "utf8").catch(() => null);
     if (!raw)
         return null;
     try {
         const c = JSON.parse(raw);
-        return typeof c.ledger?.reader === "number" ? c.ledger.reader : null;
+        return typeof c.ledger?.cli === "string" && c.ledger.cli
+            ? c.ledger.cli
+            : null;
     }
     catch {
         return null;
@@ -121,11 +126,13 @@ opts = {}) {
      * leitura de antes e NENHUMA re-interpretação nossa alcança isso. Só uma medição nova alcança, e
      * ela é um comando que ninguém tinha motivo para rodar.
      *
-     * Compara `READER`, não a string do CLI: em 07/08 o CLI subiu quatro vezes e nenhuma delas mudou um
-     * leitor - pedir re-medição em cada bump faria a pessoa parar de ler estas linhas.
+     * Compara contra `READER_SINCE`, e não contra a string do CLI: em 07/08 o CLI subiu quatro vezes e
+     * nenhuma delas mudou um leitor - pedir re-medição em cada bump faria a pessoa parar de ler estas
+     * linhas. E não contra o carimbo `reader`, que ficou parado em 1 enquanto os leitores andavam:
+     * medido em 11/08, 12 de 36 componentes têm árvore diferente entre o leitor de 07/08 e o de hoje.
      */
-    const reader = await censusReader(root);
-    if (reader != null && reader !== READER)
+    const measuredBy = await censusMeasuredBy(root);
+    if (behind(measuredBy, cli, READER_SINCE))
         out.push({
             says: `the measurement stored in this repo was read by an older reader, so what the platform knows about your components is what that reader could see. A re-measure is the only thing that reaches it - the fix lives on this machine, not on the server.`,
             run: "npx synthesisui sync",

package/dist/doctor/fragments.js

@@ -58,6 +58,36 @@ const MODULE_REF = /\$\{\s*[A-Za-z_$][\w$]*\.[A-Za-z_$][\w$]*\s*\}/g;
  * que nenhum leitor cobre (`sx`, `styled`, `runtime`) já saem com o motivo, porque nesses casos o
  * motivo é a própria forma e não depende de leitura.
  */
+/**
+ * O QUE ESTÁ DENTRO DE UM `cn(...)` E NÃO É CLASSE - e por que isto vira número na tela dele.
+ *
+ * O corpo da chamada é varrido por literal, e todo literal virava um fragmento de estilo. Dois deles
+ * nunca foram estilo, e a esteira estava dizendo ao cliente que não conseguia ler o que ele nem
+ * escreveu:
+ *
+ *     status === "success" ? "bg-success-500" : ...     "success" é OPERANDO da comparação
+ *     // ... to prevent the "short width" issue        "short width" está num COMENTÁRIO
+ *
+ * MEDIDO EM 11/08 no repo real, sobre as 26 declarações que o censo listava como `value-not-read`:
+ *
+ *      8 (31%)  operando de ===   Card, RadioCard x4, SelectionCard x2
+ *      2  (8%)  comentário        Input, Tag
+ *     16 (61%)  classe de verdade  sr-only, flex flex-col, data-[side=top]:top-full, ...
+ *
+ * Ou seja: 10 das 26 eram acusação NOSSA. E a lei 8 é explícita - lacuna declarada é confiança,
+ * mas lacuna FALSA custa o mesmo que a escondida: ela manda a pessoa procurar um problema que não
+ * existe no código dela, e gasta a credibilidade do número que está certo.
+ */
+/** Apaga comentários preservando o COMPRIMENTO, senão todo índice depois deles aponta para a linha errada. */
+function blankComments(body) {
+    return body
+        .replace(/\/\*[\s\S]*?\*\//g, (m) => " ".repeat(m.length))
+        .replace(/\/\/[^\n]*/g, (m) => " ".repeat(m.length));
+}
+/** `size === "md"`: o literal é o que está sendo COMPARADO, e comparar não é vestir. */
+function isComparedTo(body, index) {
+    return /(?:===|!==|==|!=)\s*$/.test(body.slice(0, index));
+}
 export function fragmentsOfSource(file, source) {
     const out = [];
     const at = (index) => source.slice(0, index).split("\n").length;
@@ -93,12 +123,14 @@ export function fragmentsOfSource(file, source) {
      * classe escrita à mão - a forma mais comum do repo dele (113 arquivos).
      */
     for (const call of source.matchAll(CALL_LITERAL)) {
-        const body = call[1] ?? "";
+        const body = blankComments(call[1] ?? "");
         const base = (call.index ?? 0) + (call[0].length - body.length - 1);
         for (const s of body.matchAll(STRING_IN_CALL)) {
             const text = s[1] ?? s[2] ?? "";
             if (!LOOKS_LIKE_CLASS.test(text))
                 continue;
+            if (isComparedTo(body, s.index ?? 0))
+                continue;
             push("class", base + (s.index ?? 0), text);
         }
     }

package/dist/install-marks.js

@@ -64,3 +64,29 @@ export const MATERIALISER_SINCE = "0.16.204";
  * Os arquivos que decidem: `doctor/` inteiro e `commands/hook.ts`.
  */
 export const CHECKER_SINCE = "0.16.202";
+/**
+ * A ÚLTIMA VERSÃO EM QUE OS LEITORES PASSARAM A PRODUZIR UM CENSO DIFERENTE.
+ *
+ * A terceira do mesmo bolo, e a que tinha o desenho MAIS antigo e mais errado. O `READER` era um
+ * inteiro carimbado no censo na hora da medição, e a comparação era `carimbo !== READER`. O defeito
+ * disso não é ruído, é PERDA DE INFORMAÇÃO: com o número parado em 1 desde 07/08, um censo medido
+ * ontem e um medido em julho carregam o mesmo `1` e nada os separa. Subir o número para 2 chamaria
+ * os dois para re-medir - inclusive quem já está em dia.
+ *
+ * Uma versão não perde nada, porque o censo já grava QUEM mediu (`StyleLedger.cli`).
+ *
+ * MEDIDO EM 11/08, rodando o leitor de 07/08 e o de hoje sobre os mesmos 35 componentes do repo
+ * real, e comparando o censo canônico:
+ *
+ *     12 de 36  componentes com ÁRVORE diferente - 10 lendo mais (LineChart +556 bytes)
+ *      8 de 36  com FRONTEIRA diferente - Tooltip, Menu, Modal, Select, ColorPicker, ...
+ *      2        custom properties que eram descartadas: --loader-color, --color-track
+ *
+ * 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.
+ */
+export const READER_SINCE = "0.16.207";

package/dist/reader-version.js

@@ -20,5 +20,21 @@
  *     READER          a medição na máquina dela   ->  npx synthesisui sync
  *     COMPILER        o CSS de uma versão já instalada  ->  npx synthesisui connect
  *     INTERPRETATION  a nossa metade, sobre censos já guardados  ->  roda no servidor, sem comando
+ *
+ * A DECISÃO SAIU DAQUI EM 11/08, e este número virou só um carimbo.
+ *
+ * O desenho acima está certo na intenção e errado no formato: um inteiro gravado no censo NO
+ * MOMENTO DA MEDIÇÃO só separa duas medições se ele tiver subido entre elas. Ele não subiu - ficou
+ * em 1 desde 07/08 - enquanto os leitores andavam. Medido rodando o leitor daquele dia e o de hoje
+ * sobre os mesmos 35 componentes do repo real: 12 de 36 componentes com ÁRVORE diferente, 8 com
+ * FRONTEIRA diferente, e 2 custom properties que eram descartadas. Todos esses censos carregam `1`,
+ * e a informação para separá-los não existe mais.
+ *
+ * Subir para 2 agora chamaria para re-medir também quem já está em dia. Então quem responde
+ * *"este censo está velho?"* passou a ser `READER_SINCE`, em `install-marks.ts`, comparado contra a
+ * VERSÃO que mediu (`StyleLedger.cli`) - que o censo sempre gravou e nunca se perde.
+ *
+ * O carimbo continua sendo escrito porque ele é barato e é registro; ele só não decide mais nada.
+ * Sobe para 2 aqui por honestidade com o que foi medido.
  */
-export const READER = 1;
+export const READER = 2;

package/package.json

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