synthesisui 0.16.397 → 0.16.399

package/dist/commands/add.js

@@ -585,6 +585,28 @@ export async function add(slug, opts) {
     const sheet = await globalSheetOf(projectRoot, `${appDir}/globals.css`);
     const importPrefix = prefixFrom(sheet);
     console.log(section("One-time setup (once per app)"));
+    /**
+     * QUANDO O SETUP É NECESSÁRIO, E QUANDO ELE É UMA ESCOLHA - a última porta onde a pergunta faltava.
+     *
+     * O `doctor` e o `component` passaram a perguntar antes de cobrar (ver `sheet-needed.ts`, 07/09,
+     * a partir da objeção do dono: *"esse import gera dependência ao design system, e a gente quer
+     * isolar os dois pontos - o nosso deve ser apenas uma REFERÊNCIA"*). Aqui a pergunta não tem como
+     * ser respondida da mesma forma: o sistema acabou de ser instalado e não há código gerado para
+     * medir.
+     *
+     * O QUE MUDA É A HONESTIDADE DO ENUNCIADO. "One-time setup" lido logo após a instalação soa como
+     * obrigação, e para metade dos casos ele não é: quem vai trazer componentes como CÓDIGO SEU não
+     * precisa de folha nenhuma - o `component` traduz para o vocabulário do próprio repositório e diz,
+     * arquivo a arquivo, se sobrou algo. Quem vai ESCREVER as classes do sistema (`bg-brand`,
+     * `rounded-lg` no valor dele) precisa, porque só o `@theme` do adaptador as gera.
+     *
+     * Então a instrução continua inteira - suprimi-la entregaria um projeto sem as classes - e ganha a
+     * linha que diz QUAL dos dois casos exige cada coisa. A escolha volta a ser dele, informada.
+     */
+    console.log(line("(needed if you will WRITE this system's utility classes - only its @theme generates them."));
+    console.log(line(" Bringing components in as YOUR code needs none of it: `component` translates them into"));
+    console.log(line(" your own vocabulary and tells you, per file, if anything is left.)"));
+    console.log("");
     /**
      * "ONCE PER APP" É LITERAL NUM MONOREPO, e calar os outros apps entrega metade da fiação. Os
      * caminhos abaixo são de um só; sem esta linha o cliente conclui que o repositório inteiro está

package/dist/commands/doctor.js

@@ -24,6 +24,7 @@ import { body, paint, section, snippet } from "../output.js";
 import { setupPrompt } from "../setup-prompt.js";
 import { installedThemeCss, whatOnlyTheSheetResolves, } from "../sheet-needed.js";
 import { resolveDeps } from "../stack.js";
+import { projectTongue } from "../their-tongue.js";
 import { danglingTheirVars } from "../their-vars.js";
 /**
  * `synthesisui doctor` - the check nobody else ships.
@@ -1054,8 +1055,24 @@ export async function doctor(opts) {
          * Sem esta linha, quem lê não tem como saber que a dependência é REMOVÍVEL, e a única saída
          * visível é aceitar o import.
          */
+        /**
+         * E A SAÍDA SÓ É OFERECIDA QUANDO ELA EXISTE - senão o comando manda consertar o que não conserta.
+         *
+         * "re-run `component` and it speaks your own names instead" só é verdade onde há MAPA: onde algum
+         * valor do sistema coincide com um nome que o repositório dele já declara. Sem mapa, a tradução
+         * roda e não tem o que traduzir, regerar devolve o mesmo arquivo, e a folha é o caminho legítimo.
+         *
+         * MEDIDO EM 07/09, validando o binário publicado num `create-next-app` que instalou o
+         * `codelevel`: `.lock` sem `tokenMap`, o componente saiu com 14 linhas `--ds-*`, e esta frase
+         * mandava regerar. No `codelevel-monorepo`, onde o `.lock` tem 33 pares, regerar É a saída - e o
+         * mesmo texto servia os dois. É o defeito que o `CLAUDE.md` registra em primeira pessoa: afirmar
+         * que um comando conserta o que ele não conserta.
+         */
+        const translatable = (await projectTongue(root, table.slug ?? "")) !== null;
         const asks = sheetNeed.variables.length > 0
-            ? `${sheetNeed.variables.slice(0, 3).join(", ")}${sheetNeed.variables.length > 3 ? `, +${sheetNeed.variables.length - 3} more` : ""} - re-run \`component\` on whatever writes ${sheetNeed.variables.length === 1 ? "it" : "them"} and it speaks your own names instead`
+            ? `${sheetNeed.variables.slice(0, 3).join(", ")}${sheetNeed.variables.length > 3 ? `, +${sheetNeed.variables.length - 3} more` : ""}${translatable
+                ? ` - re-run \`component\` on whatever writes ${sheetNeed.variables.length === 1 ? "it" : "them"} and it speaks your own names instead`
+                : ` - your code names no value this system also holds, so there is nothing to translate ${sheetNeed.variables.length === 1 ? "it" : "them"} into, and the sheet is the way`}`
             : `the ${sheetNeed.classes.slice(0, 3).join(", ")}${sheetNeed.classes.length > 3 ? `, +${sheetNeed.classes.length - 3} more` : ""} ${sheetNeed.classes.length === 1 ? "utility" : "utilities"}, which only this system's @theme generates`;
         console.log(body(`  what asks for it: ${asks}`));
         console.log("");

package/package.json

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