synthesisui 0.16.483 → 0.16.485

package/dist/baseline-craft.js

@@ -21,6 +21,16 @@ import { body, bodyWrapped, paint } from "./output.js";
  * Vazio e não uma linha vazia: quem chama decide se imprime o título, e um bloco com cabeçalho e
  * nada embaixo é pior que bloco nenhum.
  */
+/** "A and B", "A, B, C, D and 2 more" - quatro nomes cabem numa linha de terminal. */
+function namesOf(names) {
+    const shown = names.slice(0, 4);
+    const rest = names.length - shown.length;
+    if (rest > 0)
+        return `${shown.join(", ")} and ${rest} more`;
+    return shown.length === 1
+        ? shown[0]
+        : `${shown.slice(0, -1).join(", ")} and ${shown[shown.length - 1]}`;
+}
 export function craftLines(craft) {
     if (!craft)
         return [];
@@ -50,7 +60,9 @@ export function craftLines(craft) {
      * a segunda pergunta, e ela merece a segunda linha.
      */
     if (apart)
-        lines.push(...bodyWrapped(`${apart} have no recipe yet: counted apart, never against you.`).map((l) => body(paint.dim(l))));
+        lines.push(...bodyWrapped(craft.unwrittenNames?.length
+            ? `${namesOf(craft.unwrittenNames)} have no recipe yet - nothing in their files paints them - so they are counted apart, never against you.`
+            : `${apart} have no recipe yet: counted apart, never against you.`).map((l) => body(paint.dim(l))));
     /**
      * OS RÓTULOS ALINHADOS PELO MAIS LONGO, e a largura é medida e não estimada: os nomes chegam do
      * servidor, então um padding fixo desalinharia no dia em que uma lente for renomeada lá.

package/dist/claude-md.js

@@ -3,6 +3,7 @@ import { dirname, join } from "node:path";
 import { hasHook } from "./agent-wiring.js";
 import { declaredReference } from "./group-role.js";
 import { recallAvailable } from "./memory/availability.js";
+import { readResponsiveForm, responsiveLine } from "./responsive-form.js";
 const START = "<!-- synthesisui:start -->";
 const END = "<!-- synthesisui:end -->";
 /** Reads the installed DSs from the .lock files in _synthesisui/ds/<slug>/. */
@@ -454,12 +455,19 @@ and task, call it once - an empty result means there is nothing more to retrieve
 tells you what was decided and why it matters; **the file on disk is still the authority for what is
 written now** - read the code before you edit it, never a remembered signature.`
         : "";
+    /**
+     * O TEMA É DELE - bateria ampliada, item 22 (29/09). Em c01, c02, c05, c17 e c23 o agente mexeu no tema do projeto
+     * sem perguntar: `--text-xl` no globals.css para "casar com a escala", 17 valores no tailwind.config.js, três cores
+     * de status no custom.scss, um `app/tokens.css` com os nomes `--ds-*` da plataforma. Cada um parecia ajudar, e cada
+     * um é uma decisão da pessoa tomada por outra pessoa.
+     */
+    const theirsLine = "\n\n**The project's theme is the person's.** Do not add, change or remove a token, a theme config value (tailwind.config, theme.ts, uno.config) or the stylesheet that declares them unless they ask. A value you need and the theme does not have is ONE question with your proposal - not an edit.";
     const rule = recall.available
         ? onlyAdopted
             ? `**These are true without asking anyone:** use the project's OWN custom properties, exactly as
 this system declares them. No raw colours, spacings or radii that a token already covers, and never a
 new token invented in silence - say so instead, because a new token is a decision for a person. There
-is no component index for an adopted system: the tokens ARE the contract.
+is no component index for an adopted system: the tokens ARE the contract.${theirsLine}
 
 **What the vocabulary IS is not written here.** Fetch only the piece the task requires:
 \`system_doctrine\` for the rules and the voice, \`find_token\` for a value you are about to write.${memoryLine}${selfCheck}`
@@ -471,7 +479,7 @@ is no component index for an adopted system: the tokens ARE the contract.
 - To override a style a component already sets, use this system's semantic role class - never \`!\`.
   If the override is ignored, regenerate that component: older ones predate the resolver.
 - Motion is selection, not improvisation. The base is quiet: nothing moves until a person asks, and
-  what moves comes from this system's own vocabulary - never hand-rolled \`@keyframes\` or raw durations.
+  what moves comes from this system's own vocabulary - never hand-rolled \`@keyframes\` or raw durations.${theirsLine}
 
 **When you are writing UI that belongs to one of the systems below, check its index first.** If an
 entry covers the purpose, do not write it from scratch - materialise it:
@@ -491,11 +499,11 @@ If nothing covers it, say which indexed entry you considered and why it did not
 project's OWN custom properties, exactly as the guide lists them. Do not write raw colours,
 spacings or radii that a token already covers, and do not invent a new token silently - say so
 instead, because a new token is a decision for a person to make. There is no component
-manifest for an adopted system - the tokens ARE the contract.${selfCheck}`
+manifest for an adopted system - the tokens ARE the contract.${theirsLine}${selfCheck}`
             : `**When creating or editing components, read the system's GUIDE.md and follow it:** use the
 vocabulary it lists - every name in it is a name THIS project already declares, written exactly as
 you would write it. Do not use raw values outside the system's scale, and never a name from a
-stylesheet this project does not have.
+stylesheet this project does not have.${theirsLine}
 
 **Before creating any UI element, look it up in the manifest below.** If something there
 already covers the purpose, do not write it from scratch - run
@@ -543,9 +551,15 @@ element. Write every user-facing string in that language - labels, empty states,
 \`alt\`. A screen reader pronounces \`aria-label\` using \`lang\`, so a mixed-language interface is
 worse than an untranslated one. If the attribute is wrong, change it rather than writing against
 it.`;
+    /**
+     * E COMO ELE FAZ O RESPONSIVO, medido como o idioma (item 19 da bateria, 29/09): no b9, 100% inline, o agente criou
+     * CSS Modules só para o ponto de quebra, porque ninguém tinha dito como aquele projeto faz.
+     */
+    const form = await readResponsiveForm(projectRoot).catch(() => null);
+    const responsive = form ? `\n\n${responsiveLine(form)}` : "";
     const body = `## Design Systems (via SynthesisUI)
 
-This project uses design system(s) tracked by the \`synthesisui\` CLI. ${rule}${language}
+This project uses design system(s) tracked by the \`synthesisui\` CLI. ${rule}${language}${responsive}
 
 ${sections.join("\n")}
 

package/dist/commands/add.js

@@ -870,56 +870,80 @@ export async function add(slug, opts) {
          * `fonts.ts`. Um arquivo compartilhado atravessaria a fronteira do workspace.
          */
         const wroteIn = [];
-        for (const dir of appDirs.length > 0 ? appDirs : [appDir]) {
-            const fontsPath = join(projectRoot, ...dir.split("/"), "fonts.ts");
-            /** Arquivo dele que já existe nunca é reescrito - o setup impresso diz o que ele deve exportar. */
-            if (await exists(fontsPath))
-                continue;
-            if (!(await exists(join(projectRoot, ...dir.split("/")))))
-                continue;
-            const plan = nextFontSnippet({
-                families,
-                appDir: dir,
-                facts: fontFacts,
-                declaredWeights: payload.document.foundations.typography.weights,
-            });
-            if (!plan.ok)
-                continue;
-            const snippet = plan;
-            const header = [
-                `// Self-hosted type for the "${payload.slug}" design system (via next/font -`,
-                `// preloaded, no font flash). Generated by \`synthesisui add\`; edit freely.`,
-            ];
-            await writeFile(fontsPath, `${[...header, ...snippet.fontsFile.slice(1)].join("\n")}\n`, "utf8");
-            wroteIn.push(`${dir}/fonts.ts`);
-        }
-        const wroteFonts = wroteIn.length > 0;
-        console.log("");
-        if (wroteFonts) {
-            console.log(line(`3. ✓ wrote ${wroteIn.join(", ")} - self-hosted type via next/font (preloaded, no font flash).`));
-            console.log(line("   Finish the wiring with two small edits:"));
-        }
-        else {
-            console.log(line(appDirFound
-                ? `3. Load the type via next/font (${appDir}/fonts.ts already exists - left untouched; it should export:)`
-                : /**
-                   * A FRASE DIZIA "already exists" PARA DOIS ESTADOS DIFERENTES, e um deles é o contrário
-                   * disso: não achei a pasta do app. No monorepo dele o arquivo não existia e o terminal
-                   * dizia que existia - o cliente não tem como saber que os caminhos acima são chute.
-                   */
-                    `3. Load the type via next/font (I could not find your app folder from here, so the paths above are examples - create ${appDir}/fonts.ts wherever your app router lives):`));
+        /**
+         * NO IMPORT, NENHUM ARQUIVO MORTO - bateria ampliada, item 20 (29/09). O c01 declara Inter e Space Grotesk e não as
+         * carrega; o import escrevia `app/fonts.ts` e deixava "two small edits" que ninguém fez - um arquivo que nada
+         * importa, e as fontes do sistema sem aparecer na tela. No projeto de origem o código é dele: o passo diz em uma
+         * linha o que acontece hoje e mostra a ligação inteira, para ele fazer (ou pedir ao agente) se quiser.
+         */
+        const named = [
+            ...new Set(Object.values(families)
+                .filter((f) => typeof f === "string")
+                .map((f) => f.split(",")[0]?.trim().replace(/^["']|["']$/g, "") ?? "")
+                .filter(Boolean)),
+        ];
+        if (opts.fromImport) {
+            console.log("");
+            console.log(line(`3. Your code names ${named.join(" and ") || "its fonts"} and nothing here loads ${named.length === 1 ? "it" : "them"} - today the text falls back to the browser's font. Nothing was written. To load ${named.length === 1 ? "it" : "them"}, these three edits do it:`));
             console.log("");
             console.log(snippet(nextFonts.fontsFile));
             console.log("");
-            console.log(line("   Then finish the wiring:"));
+            console.log(snippet(nextFonts.layout));
+            console.log("");
+            console.log(snippet(nextFonts.css));
         }
-        console.log("");
-        console.log(snippet(nextFonts.layout));
-        console.log("");
-        console.log(snippet(nextFonts.css));
-        if (fontsHref) {
+        else {
+            for (const dir of appDirs.length > 0 ? appDirs : [appDir]) {
+                const fontsPath = join(projectRoot, ...dir.split("/"), "fonts.ts");
+                /** Arquivo dele que já existe nunca é reescrito - o setup impresso diz o que ele deve exportar. */
+                if (await exists(fontsPath))
+                    continue;
+                if (!(await exists(join(projectRoot, ...dir.split("/")))))
+                    continue;
+                const plan = nextFontSnippet({
+                    families,
+                    appDir: dir,
+                    facts: fontFacts,
+                    declaredWeights: payload.document.foundations.typography.weights,
+                });
+                if (!plan.ok)
+                    continue;
+                const snippet = plan;
+                const header = [
+                    `// Self-hosted type for the "${payload.slug}" design system (via next/font -`,
+                    `// preloaded, no font flash). Generated by \`synthesisui add\`; edit freely.`,
+                ];
+                await writeFile(fontsPath, `${[...header, ...snippet.fontsFile.slice(1)].join("\n")}\n`, "utf8");
+                wroteIn.push(`${dir}/fonts.ts`);
+            }
+            const wroteFonts = wroteIn.length > 0;
+            console.log("");
+            if (wroteFonts) {
+                console.log(line(`3. ✓ wrote ${wroteIn.join(", ")} - self-hosted type via next/font (preloaded, no font flash).`));
+                console.log(line("   Finish the wiring with two small edits:"));
+            }
+            else {
+                console.log(line(appDirFound
+                    ? `3. Load the type via next/font (${appDir}/fonts.ts already exists - left untouched; it should export:)`
+                    : /**
+                       * A FRASE DIZIA "already exists" PARA DOIS ESTADOS DIFERENTES, e um deles é o contrário
+                       * disso: não achei a pasta do app. No monorepo dele o arquivo não existia e o terminal
+                       * dizia que existia - o cliente não tem como saber que os caminhos acima são chute.
+                       */
+                        `3. Load the type via next/font (I could not find your app folder from here, so the paths above are examples - create ${appDir}/fonts.ts wherever your app router lives):`));
+                console.log("");
+                console.log(snippet(nextFonts.fontsFile));
+                console.log("");
+                console.log(line("   Then finish the wiring:"));
+            }
+            console.log("");
+            console.log(snippet(nextFonts.layout));
             console.log("");
-            console.log(line(`   Quick alternative (works anywhere, may flash on cold loads): <link rel="stylesheet" href="${fontsHref}" /> in the <head>.`));
+            console.log(snippet(nextFonts.css));
+            if (fontsHref) {
+                console.log("");
+                console.log(line(`   Quick alternative (works anywhere, may flash on cold loads): <link rel="stylesheet" href="${fontsHref}" /> in the <head>.`));
+            }
         }
     }
     else if (fontsHref) {

package/dist/commands/component.js

@@ -77,6 +77,17 @@ export async function component(slug, name, opts) {
     if (!SAFE_NAME.test(slug)) {
         throw new RegistryError(`Invalid slug "${slug}".`);
     }
+    /**
+     * FORA DE REACT, O COMANDO DIZ E PARA - bateria ampliada, item 15 (29/09). Em Astro, Svelte, Vue, Angular e num site
+     * HTML (c11 a c14, c28) ele escrevia um `.tsx` React, e o agente traduzia à mão: no Vue sobraram `cn.ts` e
+     * `sidebar.tsx` esquecidos no projeto. A promessa é React e Next; o que não cabe nela se diz antes de escrever.
+     */
+    const other = await notReact(root);
+    if (other) {
+        console.log(`This project is written in ${other}, and \`synthesisui component\` writes React components, so nothing was written. Build it in ${other === "plain HTML" ? "your own HTML and CSS" : other} with the system's values: \`synthesisui use ${slug} "<what you want>"\` prints a prompt your agent can follow, and the MCP tools answer every value.`);
+        process.exitCode = 1;
+        return;
+    }
     console.log(`→ fetching "${name}" from "${slug}" …`);
     const res = await fetchComponent(base, slug, name, opts.version);
     // The server should only ever return a kebab-case name, but never trust a
@@ -632,3 +643,30 @@ export async function component(slug, name, opts) {
     }
     console.log("");
 }
+/** O framework que não é React, pelo `package.json` - ou "plain HTML" quando não há `package.json` e há um `.html`. */
+async function notReact(root) {
+    const raw = await readFile(join(root, "package.json"), "utf8").catch(() => null);
+    if (raw == null) {
+        const { readdir } = await import("node:fs/promises");
+        const names = await readdir(root).catch(() => []);
+        return names.some((n) => /\.html?$/i.test(n)) ? "plain HTML" : null;
+    }
+    try {
+        const pkg = JSON.parse(raw);
+        const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+        if (deps.react || deps.next || deps["react-dom"])
+            return null;
+        if (deps.nuxt || deps.vue)
+            return "Vue";
+        if (deps["@sveltejs/kit"] || deps.svelte)
+            return "Svelte";
+        if (deps.astro)
+            return "Astro";
+        if (deps["@angular/core"])
+            return "Angular";
+        return null;
+    }
+    catch {
+        return null;
+    }
+}

package/dist/commands/doctor.js

@@ -1,6 +1,6 @@
 import { mkdir, readdir, readFile, writeFile } from "node:fs/promises";
 import { readStyleSheet, scssVariables } from "../doctor/scss-lens.js";
-import { tsTokenObjects, tsTokensAsVars } from "../doctor/ts-tokens-lens.js";
+import { THEME_SOURCE, tsTokenObjects, tsTokensAsVars } from "../doctor/ts-tokens-lens.js";
 import { dirname, join, relative, resolve } from "node:path";
 import { describeIntent, intentOf, readProjectConfig } from "../config.js";
 import { describeFix, planFix, readerFor, writeFix, } from "../doctor/apply-fix.js";
@@ -472,7 +472,7 @@ measured) {
     /** E o objeto de tokens em TypeScript - ver `TokenTable.tsNames` (27/09). */
     const tsNames = new Map();
     for await (const file of walkAll(roots))
-        if (/\.(ts|tsx)$/.test(file) && !/\.d\.ts$/.test(file))
+        if (THEME_SOURCE.test(file) && !/\.d\.ts$/.test(file))
             for (const o of tsTokenObjects(await readFile(file, "utf8").catch(() => "")))
                 for (const [n, v] of o.values)
                     if (!tsNames.has(n))
@@ -774,7 +774,7 @@ export async function doctor(opts) {
     /** Os objetos de tokens em TypeScript, para a lente da varredura - lidos da RAIZ, como o vocabulário. */
     const tsObjects = [];
     for await (const file of walkAll([root]))
-        if (/\.(ts|tsx)$/.test(file) && !/\.d\.ts$/.test(file))
+        if (THEME_SOURCE.test(file) && !/\.d\.ts$/.test(file))
             tsObjects.push(...tsTokenObjects(await readFile(file, "utf8").catch(() => "")));
     const tally = emptyTally();
     const internalSpecs = await internalSpecifiers(root);

package/dist/commands/hook.js

@@ -425,7 +425,14 @@ async function report(root, filePath, mode) {
         /** O QUE FOI CORTADO É DITO - medido num `.css` real: 20 de 252, e as 232 sumiam caladas. */
         ...(unnamed.length > 20
             ? [`  … and ${unnamed.length - 20} more in this file`]
-            : []), "", "This system declares no name for them, so there is nothing to replace them with.", "Leave them as they are, or tell the person the value and what THEY would call it.");
+            : []), "", "This system declares no name for them, so there is nothing to replace them with.", 
+        /**
+         * UMA PERGUNTA COM A PROPOSTA, NÃO UMA LISTA PARA NOMEAR - bateria ampliada, item 18 (29/09). Em 17 dos 29
+         * projetos o turno terminava em "tell me what to call them" com 5 a 43 valores: a tela pronta e o trabalho
+         * aberto, esperando a pessoa inventar nomes. Quem escolhe continua sendo ela; o que muda é que ela recebe a
+         * sugestão pronta, no estilo que o projeto já usa, e responde uma vez.
+         */
+        "Do not add a name on your own. For the values that repeat, propose names in this project's own style (next to the names it already declares) as ONE question the person answers with a yes - then add them and swap the values only after that yes. Leave one-off values as they are, and do not list every value back to the person.");
     }
     if (phantoms.length > 0) {
         lines.push("", "Names this system does not declare. These look tokenized and apply nothing at all:", ...phantoms.slice(0, 20).map((p) => `  line ${p.line}  ${p.name}`), "", "Use a name the system has, or say which value you need and what you would call it. Do NOT invent a token.");
@@ -613,9 +620,17 @@ round) {
             if (src == null || !table)
                 continue;
             measured += 1;
-            const n = diagnose([scanSource(rel, src, table)]).findings.length;
-            if (n > 0)
-                dirty.push(`${rel} (${n} by hand)`);
+            /**
+             * O QUE SAI DA ESCALA CONTA AQUI TAMBÉM - bateria ampliada, item 14 (29/09). No c06 o turno mudou 18 arquivos, e
+             * três deles tinham `@media (max-width: 767px)`, fora da escala (o md é 768). A régua de 28/09 achava; esta
+             * linha só somava os valores à mão, e o turno terminava em "checked too - nothing to name".
+             */
+            const report = scanSource(rel, src, table);
+            const n = diagnose([report]).findings.length;
+            const off = report.offScale?.length ?? 0;
+            const what = [n > 0 ? `${n} by hand` : "", off > 0 ? `${off} off your scale` : ""].filter(Boolean).join(", ");
+            if (what)
+                dirty.push(`${rel} (${what})`);
         }
         const unmeasured = rest.length - measured;
         said.push([
@@ -634,6 +649,34 @@ round) {
                 : "Run `npx synthesisui doctor` to see them, or write one of them again and this will check it.",
         ].join("\n"));
     }
+    /**
+     * O QUE PASSOU DE PROPÓSITO, DITO UMA VEZ POR TURNO - a régua de 28/09 ("a checagem diz isso uma vez"), bateria
+     * ampliada, item 14. Sem esta linha, "nothing to name" ao lado de um `1px` ou de um `100dvh` parecia que a checagem
+     * não tinha visto, e o agente do c06 e do c18 foi conferir à mão. Só no fim do turno: um comando de shell não repete.
+     */
+    // Só pega carona: um turno limpo continua calado - bloquear o fim do turno para dizer que passou seria ruído.
+    if (round === "turn" && changed.length > 0 && said.length > 0) {
+        const { table } = await loadSystem(root).catch(() => ({ table: null }));
+        const passes = new Map();
+        if (table)
+            for (const { rel } of changed.slice(0, REFUSAL_CEILING)) {
+                const src = await readFile(join(root, rel), "utf8").catch(() => null);
+                if (src == null)
+                    continue;
+                for (const a of scanSource(rel, src, table).setAside ?? []) {
+                    if (!/passes$|no token holds$|on your system's scale$/.test(a.reason))
+                        continue;
+                    const files = passes.get(a.reason) ?? new Set();
+                    files.add(rel);
+                    passes.set(a.reason, files);
+                }
+            }
+        if (passes.size > 0)
+            said.push(`Passed on purpose, not missed: ${[...passes]
+                .slice(0, 6)
+                .map(([why, files]) => `${why} (${files.size} file${files.size === 1 ? "" : "s"})`)
+                .join("; ")}.`);
+    }
     return { said, block };
 }
 /**
@@ -686,5 +729,12 @@ async function endOfTurn(root, input) {
     await moveTurnClock(root);
     out(said.length === 0
         ? pass()
-        : { decision: "block", reason: said.join("\n\n") });
+        : { decision: "block", reason: [...said, CLOSE_THE_TURN].join("\n\n") });
 }
+/**
+ * A ÚLTIMA MENSAGEM É O RESUMO, NÃO O RODAPÉ - bateria ampliada, item 19 (29/09). Este bloqueio faz o agente responder
+ * mais uma vez, e essa resposta vira a última coisa que a pessoa lê: em quase todos os 30 projetos, um turno de três a
+ * cinco minutos terminava numa nota sobre a checagem ("One more note from the style checker…"), e o que foi feito
+ * ficava no meio da conversa.
+ */
+export const CLOSE_THE_TURN = "Answer this in a line or two, then END your reply with the summary of what this turn did for the person - that last message is the one they read.";