synthesisui 0.16.186 → 0.16.188

package/dist/cli-version.js

@@ -0,0 +1,32 @@
+/**
+ * QUEM ESTÁ ATRÁS DE QUEM, e só isso.
+ *
+ * O aviso "a newer reader is published" disparava por DIFERENÇA, nos dois sentidos. Em 08/08 o dono
+ * rodou `sync` com 0.16.187 recém-publicada, e a plataforma - que ainda não tinha feito deploy -
+ * respondia 0.16.186. A tela dele disse *"You are running 0.16.187 and 0.16.186 is published"* debaixo
+ * de um título que promete o contrário, e mandou rodar `connect` para "atualizar" para uma versão
+ * mais velha que a dele.
+ *
+ * Esse estado não é raro, é a regra: publicar no npm e fazer deploy da plataforma não são o mesmo
+ * instante, então entre um e outro quem instala do npm fica na frente. Um alarme que toca quando está
+ * tudo certo é um alarme que a pessoa aprende a ignorar - e é o mesmo alarme que precisa ser lido no
+ * dia em que ela estiver de verdade para trás.
+ *
+ * Espelha `isOlderCli` de `apps/web/src/lib/ds/reinterpret.ts`. Não é um gêmeo por spec como
+ * `frontier-kind.ts`: aqui não há contrato compartilhado, só a mesma aritmética de três números.
+ */
+export function isOlderCli(mine, published) {
+    const parts = (v) => v.split(".").map((p) => Number.parseInt(p, 10));
+    const a = parts(mine);
+    const b = parts(published);
+    for (let i = 0; i < Math.max(a.length, b.length); i += 1) {
+        const left = a[i];
+        const right = b[i];
+        /** Versão que não é numérica não se compara - e acusar o que não se sabe ler é pior que calar. */
+        if (!Number.isFinite(left) || !Number.isFinite(right))
+            return false;
+        if (left !== right)
+            return left < right;
+    }
+    return false;
+}

package/dist/commands/status.js

@@ -1,5 +1,6 @@
 import { readdir, readFile } from "node:fs/promises";
 import { join, resolve } from "node:path";
+import { isOlderCli } from "../cli-version.js";
 import { readToken, resolveRegistry } from "../config.js";
 import { readEvents } from "../doctor/ledger.js";
 import { readRequests } from "../doctor/requests.js";
@@ -150,7 +151,7 @@ export async function status(opts) {
      * Não vira um item do `align`: o CLI subiu seis vezes num dia e nenhuma delas mudou um leitor, e a
      * verificação de abertura tem que ficar muda nesses casos. Aqui é diferente - a pessoa PERGUNTOU.
      */
-    const behindCli = remote.publishedCli && opts.cli && remote.publishedCli !== opts.cli
+    const behindCli = remote.publishedCli && opts.cli && isOlderCli(opts.cli, remote.publishedCli)
         ? {
             says: `your CLI is ${opts.cli} and ${remote.publishedCli} is published - a newer reader sees styles this one cannot.`,
             run: "npx synthesisui@latest upgrade",

package/dist/commands/sync.js

@@ -1,5 +1,6 @@
 import { readdir, readFile, writeFile } from "node:fs/promises";
 import { join, resolve } from "node:path";
+import { isOlderCli } from "../cli-version.js";
 import { readToken, resolveRegistry } from "../config.js";
 import { markSent, readEvents } from "../doctor/ledger.js";
 import { checkableName, closeRequest, readRequests, verifyAndCloseRequests, } from "../doctor/requests.js";
@@ -201,7 +202,9 @@ export async function remeasure(args) {
      * pode movê-lo é quem roda o comando. Então o número é dito aqui, com o comando ao lado, em vez de
      * viver numa tela que alguém precisa lembrar de abrir.
      */
-    if (stored.publishedCli && args.cli && stored.publishedCli !== args.cli) {
+    if (stored.publishedCli &&
+        args.cli &&
+        isOlderCli(args.cli, stored.publishedCli)) {
         console.log(section("A newer reader is published"));
         console.log(body(`You are running ${args.cli} and ${stored.publishedCli} is published. The measurement below uses ${args.cli}.`));
         console.log(paint.blue(snippet(["npx synthesisui@latest connect"])));

package/dist/progress.js

@@ -14,6 +14,19 @@
  * writes a carriage return into a transcript.
  */
 const BAR_WIDTH = 24;
+/**
+ * O INTERVALO MÍNIMO ENTRE DOIS QUADROS - e ele existe por causa do CLIPBOARD, não da velocidade.
+ *
+ * A linha se redesenha com `\r`, então na tela ela é UMA linha e a leitura é ótima. Copiar é outra
+ * história: o `\r` não sobrevive à seleção, então cada repintura vira um pedaço do texto colado. Em
+ * 08/08 o dono tentou copiar a saída de um `sync` e levou junto 2 172 quadros - um por arquivo de
+ * evidência -, o que enterrou o relatório que ele queria mostrar (dono, 08/08).
+ *
+ * 80ms é o teto do que um olho aproveita: acima de ~12 quadros por segundo a animação já lê como
+ * contínua, e o resto é trabalho que só o clipboard vê. No caso dele isso troca 2 172 quadros por
+ * algumas dezenas, sem tirar um único frame que alguém fosse perceber.
+ */
+const MIN_FRAME_MS = 80;
 /** Every this-many items, the non-TTY path prints one line. Enough to see movement in
  *  a piped log without turning it into the log. */
 const MILESTONE_EVERY = 25;
@@ -49,9 +62,12 @@ function tail(label, width) {
 export function startProgress(title, opts) {
     const write = opts?.write ?? ((s) => process.stdout.write(s));
     const tty = opts?.isTty ?? Boolean(process.stdout.isTTY);
+    const now = opts?.now ?? (() => Date.now());
     let total = opts?.total ?? 0;
     let done = 0;
     let last = "";
+    /** `-Infinity` para o PRIMEIRO passo pintar sempre: silêncio no começo lê como travado. */
+    let painted = Number.NEGATIVE_INFINITY;
     const paint = () => {
         const count = total > 0 ? `${done} of ${total}` : String(done);
         const line = `  ${bar(done, total)}  ${count}  ${tail(last, 40)}`;
@@ -64,6 +80,14 @@ export function startProgress(title, opts) {
             done += 1;
             last = label;
             if (tty) {
+                /**
+                 * O ÚLTIMO SEMPRE PINTA, mesmo dentro da janela: parar num "2 100 de 2 172" e pular para o
+                 * resumo faria a barra parecer que desistiu antes do fim.
+                 */
+                const at = now();
+                if (at - painted < MIN_FRAME_MS && !(total > 0 && done === total))
+                    return;
+                painted = at;
                 paint();
                 return;
             }

package/package.json

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