synthesisui 0.16.186 → 0.16.187

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.187",
   "description": "Bring SynthesisUI design systems into any project - tokens, typed components, whole pages and an agent-ready CLAUDE.md manifest.",
   "type": "module",
   "bin": {