synthesisui 0.16.399 → 0.16.400

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.399",
+  "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": {