synthesisui 0.16.398 → 0.16.400

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/component.js

@@ -12,7 +12,7 @@ import { installedThemeCss, whatOnlyTheSheetResolves, } from "../sheet-needed.js
 import { flavourResolver } from "../styles-flavour.js";
 import { inTheirTongue, projectTongue, sumSpoken, } from "../their-tongue.js";
 import { readCensus, unreadComment, unreadForComponent, } from "../unread-for-component.js";
-import { recordWritten } from "../written.js";
+import { editedSinceWritten, readWritten, recordWritten } from "../written.js";
 /**
  * Writes the shared `cn.ts` next to the components, built from THIS project's
  * installed theme.
@@ -233,6 +233,36 @@ export async function component(slug, name, opts) {
          * a mesma pergunta - qual nome este comando vai ocupar - e duas respostas para ela é o defeito.
          */
         const local = localName(res.name, opts.as);
+        /**
+         * A EDIÇÃO DELE NO QUE NÓS ESCREVEMOS - a mesma promessa do `upgrade`, no comando que a violava.
+         *
+         * O QUE ACONTECIA, caminhado em 07/09 com o binário publicado: gerei `btn2`, escrevi uma linha
+         * à mão no topo do arquivo, rodei `component codelevel button --as btn2` de novo - e a linha
+         * sumiu. Sem aviso, sem `--force`, sem uma frase.
+         *
+         * O GUARD QUE EXISTE ACIMA RESPONDE OUTRA PERGUNTA: *"você já tem este componente no seu
+         * repositório?"*, sobre o arquivo de ORIGEM (`recipe.api.file`), de onde o sistema foi
+         * importado. Ele nada sabe sobre o que NÓS escrevemos depois.
+         *
+         * E a informação existia o tempo todo: `recordWritten` grava o fingerprint de cada arquivo a
+         * cada escrita, e o `upgrade` a lê para dizer `kept YOUR file(s)`. Este comando gravava e nunca
+         * lia - a promessa valia num caminho e não no outro, e o outro é o mais percorrido: alguém traz
+         * o componente, ajusta, e roda de novo para pegar uma correção.
+         *
+         * A saída oferecida é a mesma que o `upgrade` oferece, e é a que ele já tem na mão: `--force`.
+         */
+        const slugDir = join(root, "_synthesisui", "ds", slug);
+        const editedHere = await editedSinceWritten((await readWritten(slugDir))[local], join(root, config.componentsDir, local));
+        if (editedHere && editedHere.length > 0 && !opts.force) {
+            console.log(section("You edited this one"));
+            console.log(body(`${editedHere.join(", ")} in ${config.componentsDir}/${local} changed after we wrote ${editedHere.length === 1 ? "it" : "them"} - kept YOUR file(s).`));
+            console.log("");
+            console.log(body("To take the new version anyway:"));
+            console.log(snippet([
+                `npx synthesisui component ${slug} ${res.name}${opts.as ? ` --as ${opts.as}` : ""} --force`,
+            ]));
+            return;
+        }
         const localPascal = local
             .split(/[^a-zA-Z0-9]+/)
             .filter(Boolean)

package/dist/doctor/signals.js

@@ -360,6 +360,26 @@ export function describeSignals(s) {
     else if (t.prefersColorScheme > 0) {
         out.push(`no dark utilities, but ${t.prefersColorScheme} \`prefers-color-scheme\` rule${t.prefersColorScheme === 1 ? "" : "s"} - the second scheme lives in CSS rather than in class names.`);
     }
+    else if (t.library) {
+        /**
+         * NENHUM SINAL DE SEGUNDO ESQUEMA, MAS UM ALTERNADOR INSTALADO - e as duas frases se negavam.
+         *
+         * MEDIDO EM 07/09 no `~/projects/web-subscribe`, caminhando o ATO 3: o relatório imprimia, em
+         * linhas CONSECUTIVAS, *"one scheme, and adding a second is a decision rather than a
+         * discovery"* e *"switched by next-themes"*. Quem lê recebe as duas ao mesmo tempo: não existe
+         * segundo esquema, e existe uma biblioteca que alterna entre esquemas.
+         *
+         * AS DUAS METADES ESTÃO CERTAS separadamente, e é isso que torna a contradição fácil de
+         * escrever: uma conta utilitários `dark:` e regras `prefers-color-scheme` no CSS; a outra lê o
+         * `package.json` e o provider. O que faltava era uma olhar para a outra.
+         *
+         * E O FATO COMBINADO É MAIS ÚTIL QUE QUALQUER UMA DAS DUAS: o alternador está instalado e não
+         * há nada para ele alternar. Isso é uma pendência do projeto dele - e é acionável, ao contrário
+         * de "adicionar um segundo esquema é uma decisão", que ele já tomou quando instalou a
+         * biblioteca.
+         */
+        out.push(`no dark utilities and no \`prefers-color-scheme\` - so the second scheme has nothing to paint yet, even though ${t.library} is installed to switch between them.`);
+    }
     else {
         out.push("no dark utilities and no `prefers-color-scheme` - one scheme, and adding a second is a decision rather than a discovery.");
     }

package/package.json

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