synthesisui 0.16.271 → 0.16.272

package/dist/commands/connect.js

@@ -419,10 +419,25 @@ export async function connect(opts) {
         }
     }
     await reportWhatIsLeft(root, { cli: opts.version });
+    /**
+     * O CUSTO DO HOOK, DITO SEM UM NÚMERO QUE NÃO É NOSSO.
+     *
+     * A frase prometia "about 0.7s per edit", de uma medição de 27/07. Medido em 21/08 no repositório do
+     * dono, cinco execuções: 2525 · 27 · 2513 · 2508 · 2521 ms - e a causa não é o nosso código.
+     * `npx synthesisui@<v> --version`, que nem chega no hook, custou 2555-2711ms na mesma máquina, e
+     * aquele repo tem 26 folhas de css. O hook inteiro foi medido em 84ms em 13/08, sobre 686 folhas.
+     *
+     * Ou seja: o número FIXO era o erro, porque ele descreve a rede de quem lê e não o que a gente faz.
+     * O que a frase passa a dizer é o que DOMINA (o npx resolvendo) e o ganho medido do caminho local:
+     * 2525ms -> 295ms num repo com o pacote em `node_modules`. "Ten times" era otimista; "several" é o
+     * que se sustenta.
+     */
     if (wired.command.startsWith("npx synthesisui@")) {
         console.log("");
-        console.log(body("The hook runs through npx, which costs about 0.7s per edit. Adding"));
-        console.log(body("synthesisui to your devDependencies makes it roughly ten times faster;"));
+        console.log(body("The hook runs through npx, which resolves this package against the"));
+        console.log(body("registry on every edit - that wait is the network, not the check itself"));
+        console.log(body("(the analysis is about 80ms). Adding synthesisui to your devDependencies"));
+        console.log(body("makes npx resolve it locally instead, which is several times faster;"));
         console.log(body("run this again afterwards and it will switch by itself."));
     }
 }

package/package.json

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