synthesisui 0.16.484 → 0.16.487

package/dist/claude-md.js

@@ -455,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}`
@@ -472,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:
@@ -492,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

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

@@ -5,6 +5,7 @@ import { readAutoSync, startSync } from "../auto-sync.js";
 import { changedSince } from "../changed-files.js";
 import { emptyTally, exportedNames, internalSpecifiers, scanComponentsInto, tallyToInventory, } from "../doctor/components-scan.js";
 import { checkContracts } from "../doctor/contract-check.js";
+import { componentOf } from "../doctor/component-of.js";
 import { appendEvent, ledgerPath } from "../doctor/ledger.js";
 import { describeOffScale, diagnose, nameToWrite, scanSource } from "../doctor/scan.js";
 import { declarados, falaDaPrateleira, naPrateleira } from "../doctor/shelf.js";
@@ -317,12 +318,16 @@ async function report(root, filePath, mode) {
     // just flagged is the evidence the agent read the report and acted. Without
     // the clean lines the record could only ever say "found", never "fixed",
     // which is the half we could not answer when asked (28/07).
+    const component = componentOf(rel, documents);
     await appendEvent(root, {
         kind: "hook",
         at: new Date().toISOString(),
         file: rel,
         named: named.length,
         phantoms: phantoms.length,
+        unnamed: unnamed.length,
+        offScale: d.files.reduce((n, f) => n + (f.offScale?.length ?? 0), 0),
+        ...(component ? { component } : {}),
     });
     /** O bloqueio de CONSUMIR é a única saída que recusa, e ele acompanha o relatório seja qual for. */
     const block = mode === "consume" && composed.length > 0;
@@ -425,7 +430,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 +625,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 +654,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 +734,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.";

package/dist/commands/import.js

@@ -1,7 +1,7 @@
 import { mkdir, readdir, readFile, stat, writeFile } from "node:fs/promises";
 import { importMark, writeSyncMark } from "../last-sync.js";
 import { readStyleSheet } 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 { basename, dirname, join, relative, resolve, sep } from "node:path";
 import { anatomyFromSketch } from "../anatomy-from-sketch.js";
 import { applyAnatomyPatch, hasEdits, } from "../anatomy-patch.js";
@@ -36,6 +36,9 @@ import { aliasesOf, describeReachability, edgesIn, reachabilityOf, } from "../do
 import { rootGroundOf } from "../doctor/root-ground.js";
 import { diagnose, scanSource } from "../doctor/scan.js";
 import { parseSchemeBlocks } from "../doctor/scheme-blocks.js";
+import { attributeFaces } from "../doctor/scheme-scope.js";
+import { cssImportLists, resolveSheetConflicts, unloadedSheets } from "../doctor/sheet-order.js";
+import { unreadComponentFiles } from "../doctor/other-frameworks.js";
 import { describeSignals, emptySignals, finishSignals, readSignalsInto, } from "../doctor/signals.js";
 import { sketchOf } from "../doctor/sketch.js";
 import { describeForeign, readStyleIslands, } from "../doctor/style-island.js";
@@ -282,6 +285,34 @@ alsoGlobalsFrom) {
         const body = await readStyleSheet(file);
         sheets.push({ file, body });
     }
+    /**
+     * O QUE UMA FOLHA DELE IMPORTA DE DENTRO DE UMA PASTA QUE A VARREDURA PULA - bateria ampliada, 29/09.
+     *
+     * O Style Dictionary gera `build/css/variables.css` e o `globals.css` o importa. A varredura pula `build/`
+     * (lá costuma morar saída de build, e ler aquilo seria ler o bundle), então as 14 variáveis dele nunca
+     * entravam, e o import dizia "your code names no token yet" a quem tinha o sistema mais organizado do kit.
+     *
+     * A pasta continua pulada; o que muda é que uma folha que ELE importa entra, porque o `@import` é a palavra
+     * dele dizendo que aquilo faz parte do CSS dele. Só dentro do escopo medido.
+     */
+    const lidas = new Set(sheets.map((s) => s.file));
+    for (let i = 0; i < sheets.length; i++) {
+        for (const spec of sheetImports(sheets[i].body)) {
+            for (const candidate of partialCandidates(spec)) {
+                const alvo = join(dirname(sheets[i].file), candidate);
+                if (lidas.has(alvo))
+                    break;
+                if (!alvo.startsWith(`${root}${sep}`))
+                    break;
+                const body = await readStyleSheet(alvo);
+                if (!body)
+                    continue;
+                lidas.add(alvo);
+                sheets.push({ file: alvo, body });
+                break;
+            }
+        }
+    }
     /**
      * AS FOLHAS DO RESTO DO REPOSITÓRIO - lidas com a MESMA régua, e nunca com uma segunda.
      * `deForaDoEscopo` marca quais são, porque elas só podem virar classe global: nem `css`, nem
@@ -564,13 +595,45 @@ export async function takeCensus(root, opts) {
      */
     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 tsRoot = tsObjects
         .flatMap((o) => [...o.values].map(([n, v]) => `${n}: ${v};`))
         .join(" ");
-    const table = buildTable({ css: tsRoot ? `${css}\n:root { ${tsRoot} }` : css, source: "yours" });
-    const schemes = parseSchemeBlocks(css);
+    /**
+     * O MESMO TOKEN EM DUAS FOLHAS: fica o que a TELA mostra - ver `sheet-order.ts` (bateria ampliada, c20). O leitor de
+     * raiz fica com a primeira declaração; aqui a folha que o código importa por último vem primeiro, só para os tokens.
+     * As classes continuam lendo `css` na ordem de sempre.
+     */
+    const codeFiles = [];
+    const citingFiles = [];
+    for await (const file of walkAll([root])) {
+        if (/\.(tsx|ts|jsx|js|mjs)$/.test(file) && !/\.d\.ts$/.test(file))
+            codeFiles.push(file);
+        if (/\.(tsx|ts|jsx|js|mjs|cjs|vue|svelte|astro|html|json)$/.test(file) && !/\.d\.ts$/.test(file))
+            citingFiles.push(file);
+    }
+    // A varredura não entra em `.json` nem em `.html`, e é na RAIZ que eles dizem que folhas carregam: `angular.json`,
+    // `index.html` (Vite, site estático). Sem isto o `styles.scss` do Angular parecia não carregado.
+    for (const name of await readdir(root).catch(() => []))
+        if (/\.(json|html)$/.test(name) && name !== "package-lock.json")
+            citingFiles.push(join(root, name));
+    const sheetsInScope = globalSheets
+        .filter((g) => !g.outside)
+        .map((g) => ({ file: resolve(root, g.file), body: g.body }));
+    /** A folha que ninguém carrega não dá token - ver `unloadedSheets` (bateria ampliada, c17 e c18). */
+    const unloaded = new Set(await unloadedSheets(sheetsInScope, citingFiles));
+    const loaded = sheetsInScope.filter((g) => !unloaded.has(g.file));
+    const { ordered, conflicts: declaredConflicts } = resolveSheetConflicts(loaded, await cssImportLists(codeFiles));
+    const tokenCss = unloaded.size > 0 || declaredConflicts.some((c) => c.decidedBy) ? ordered.map((g) => g.body).join("\n") : css;
+    const declaredUnloaded = [...unloaded];
+    /** Componentes que esta versão não lê (Vue, Svelte, Astro, Angular) - ver `other-frameworks.ts`. */
+    const everyFile = (await readdir(root, { recursive: true }).catch(() => []))
+        .filter((f) => !/(^|[/\\])(node_modules|\.git|\.next|\.nuxt|\.svelte-kit|\.astro|\.angular|dist|build|_synthesisui)([/\\]|$)/.test(f))
+        .map((f) => join(root, f));
+    const unreadComponents = await unreadComponentFiles(everyFile);
+    const table = buildTable({ css: tsRoot ? `${tokenCss}\n:root { ${tsRoot} }` : tokenCss, source: "yours" });
+    const schemes = parseSchemeBlocks(tokenCss);
     const reports = [];
     const tally = emptyTally();
     const internal = await internalSpecifiers(root);
@@ -2469,6 +2532,7 @@ export async function takeCensus(root, opts) {
     globalSheets
         .filter((g) => !g.outside)
         .map((g) => ({ file: g.file, css: g.body })));
+    const declaredBrands = attributeFaces(css, new Set(schemes.base.keys()));
     const declaredSchemes = {
         base: Object.fromEntries(schemes.base),
         light: Object.fromEntries(schemes.light),
@@ -2761,6 +2825,10 @@ export async function takeCensus(root, opts) {
             ? { declaredAlt: Object.fromEntries(schemes.dark) }
             : {}),
         declaredSchemes,
+        ...(declaredBrands.length > 0 ? { declaredBrands } : {}),
+        ...(declaredConflicts.length > 0 ? { declaredConflicts } : {}),
+        ...(declaredUnloaded.length > 0 ? { declaredUnloaded } : {}),
+        ...(unreadComponents.length > 0 ? { unreadComponents } : {}),
         observed: distinctValues(d),
         ...(components.length > 0 ? { components } : {}),
         ...(defined.length > 0 ? { defined } : {}),
@@ -3944,6 +4012,11 @@ export function defaultScheme(declared) {
  * transcrito em vez de serem reescritas: a régua que as produziu é a mesma, então a tela nunca
  * diverge do relatório.
  */
+/** O caminho a partir da pasta do projeto, que é como ele o reconhece. */
+function relativeish(file) {
+    const cwd = process.cwd();
+    return file.startsWith(`${cwd}${sep}`) ? file.slice(cwd.length + 1) : file;
+}
 function mostrarLeitura(c, secoes, titulos = DECIDEM) {
     const valores = c.values?.classes;
     const decisoes = valores ? valores.seen - valores.structure : 0;
@@ -3956,6 +4029,22 @@ function mostrarLeitura(c, secoes, titulos = DECIDEM) {
     console.log(body(`${paint.strong(`${lidos} of ${total}`)} components came out with a blueprint${pct === null
         ? ""
         : `, and ${paint.strong(`${pct}%`)} of your ${decisoes} style decisions carry your own vocabulary`}.`));
+    for (const u of c.unreadComponents ?? []) {
+        const ext = { Vue: ".vue", Svelte: ".svelte", Astro: ".astro", Angular: "Angular" }[u.framework] ?? u.framework;
+        console.log(body(`Your components are written in ${u.framework} (${u.files} ${ext === "Angular" ? "Angular component" : ext} file${u.files === 1 ? "" : "s"}), and this version reads components written in React only. Your colours, spacing and type came in; your components did not - the system starts without them.`));
+    }
+    for (const f of c.declaredUnloaded ?? [])
+        console.log(body(`${relativeish(f)} declares variables, and nothing in this project loads it - no import, no link, no config. They were left out of this system.`));
+    for (const k of c.declaredConflicts ?? []) {
+        const onde = k.values.map((v) => `${v.value} in ${relativeish(v.file)}`).join(", ");
+        console.log(body(k.decidedBy
+            ? `${k.name} is declared twice (${onde}). Your screen shows ${k.shown}, the one ${relativeish(k.decidedBy)} imports last, and that is the value this system keeps.`
+            : `${k.name} is declared twice (${onde}), and nothing here says which one loads last. This system keeps ${k.shown} - check which one your screen shows.`));
+    }
+    if (c.declaredBrands?.length) {
+        const outras = c.declaredBrands.map((b) => b.selector).join(", ");
+        console.log(body(`Your code names ${c.declaredBrands.length === 1 ? "one more brand" : `${c.declaredBrands.length} more brands`} with the same names (${outras}). This system is the one in :root; ${c.declaredBrands.length === 1 ? "the other was" : "the others were"} read and left out, not mixed in.`));
+    }
     /**
      * TODAS as ocorrências, e não a primeira: um import com dois escopos declara a organização de
      * CADA um, e `find` mostraria `packages/ui` e engoliria `packages/charts` - a segunda lacuna
@@ -5364,6 +5453,8 @@ export async function runImport(opts) {
                  * `import-installs.spec.ts` provava que a chamada existe e não que ela leva o que precisa.
                  */
                 cli: opts.cli,
+                /** O projeto é o de origem: nenhum `fonts.ts` morto no código dele - ver `AddOptions.fromImport`. */
+                fromImport: true,
             });
         }
         catch (error) {

package/dist/commands/init.js

@@ -6,6 +6,8 @@ import { readFile } from "node:fs/promises";
 import { join } from "node:path";
 import { readProjectTheme, writeBesideTheirs, writeNewProjectRoot, writeNewProjectTheme } from "../new-project-theme.js";
 import { add } from "./add.js";
+import { resolveRegistry } from "../config.js";
+import { fetchDesignSystem } from "../registry.js";
 const whereOf = (answer) => answer === "file" || answer === "1"
     ? "file"
     : answer === "separate" || answer === "2"
@@ -48,6 +50,14 @@ async function askWhere(tokensFile, separate, entry, intro) {
  */
 export async function init(opts) {
     const root = opts.dir ?? process.cwd();
+    /**
+     * O SISTEMA EXISTE ANTES DE QUALQUER ARQUIVO - bateria ampliada, item 21 (29/09). `init --ds teste-nunca-existiu`
+     * recusava bem ("No design system ... that this machine can see"), mas só depois de escrever `_synthesisui/config.json`,
+     * o `ledger.jsonl` e a statusline: o projeto ficava com o rastro de uma instalação que não aconteceu. A pergunta
+     * vai ao registry primeiro; a recusa é a mesma, e agora nada fica para trás.
+     */
+    if (opts.ds)
+        await fetchDesignSystem(resolveRegistry(opts.registry), opts.ds);
     const target = opts.target === "general" ? "general" : "next";
     const config = {
         target,

package/dist/doctor/architecture.js

@@ -72,8 +72,11 @@ const SHAPES = [
  * Next (app e pages) são do framework: dizem onde a tela mora, não onde um componente nasce.
  */
 const ROUTE_FILE = /(^|\/)(page|layout|loading|error|global-error|not-found|template|default|route|head|_app|_document|_error)\.(tsx|jsx|ts|js)$/i;
+/** E todo arquivo de `pages/` do pages router - bateria ampliada, c30: `index.tsx` e `about.tsx` são rotas, não
+ *  componentes "ao lado da rota". */
+const PAGES_DIR = /^(src\/)?pages\//i;
 export function countsAsOrganization(rel) {
-    return /\.(tsx|jsx|vue|svelte)$/i.test(rel) && !ROUTE_FILE.test(rel);
+    return /\.(tsx|jsx|vue|svelte)$/i.test(rel) && !ROUTE_FILE.test(rel) && !PAGES_DIR.test(rel.replace(/\\/g, "/"));
 }
 /**
  * O MESMO NOME, MÓDULO CAIXA E SEPARADOR - a única normalização deste arquivo.

package/dist/doctor/component-gate.js

@@ -30,6 +30,8 @@ import { localOnlyNames } from "./components-scan.js";
  * so a file called `page.tsx` IS a route in every Next codebase there is.
  */
 const RESERVED_FILE = /(^|[/\\])(page|layout|template|default|error|global-error|not-found|loading|route|middleware|instrumentation|sitemap|robots|opengraph-image|icon|apple-icon|manifest)\.[jt]sx?$/;
+/** `pages/…` na raiz ou em `src/` - o roteador por arquivo do Next antigo (e as telas de um app Vite). */
+const PAGES_ROUTER = /^(src[/\\])?pages[/\\].+\.[jt]sx?$/;
 /** Nuxt, SvelteKit and Remix equivalents, for the same exact reason. */
 const RESERVED_FILE_OTHER = /(^|[/\\])(\+page|\+layout|\+server|_app|_document|_layout)\.[a-z]+$/;
 /**
@@ -229,6 +231,18 @@ export function gateComponent(input) {
             because: `\`${file}\` is the root the app mounts - the whole screen, not a component somebody can import`,
         };
     }
+    /**
+     * O PAGES ROUTER - bateria ampliada, c30 (29/09). No Next antigo cada arquivo de `pages/` É uma rota
+     * (`pages/index.tsx` é `/`), e o nome dele não é reservado: o census contava 0 páginas, e o import chamava
+     * `pages/` de "componentes ao lado da rota". Em um app Vite, `src/pages/Home.tsx` também é uma tela inteira.
+     */
+    if (PAGES_ROUTER.test(file)) {
+        return {
+            ok: false,
+            why: "route",
+            because: `\`${file}\` lives in pages/ - each file there is a route, not a component somebody can import`,
+        };
+    }
     if (RESERVED_FILE.test(file) || RESERVED_FILE_OTHER.test(file)) {
         return {
             ok: false,

package/dist/doctor/component-of.js

@@ -0,0 +1,68 @@
+import { basename, dirname } from "node:path";
+/**
+ * DE QUAL COMPONENTE É ESTE ARQUIVO - a ponte que o documento já tem, e nenhuma outra (E01, 30/09).
+ *
+ * A receita diz onde o componente mora (`components.<Nome>.source.file`), escrito pela leitura do
+ * import. O arquivo que a checagem olha pode ser esse mesmo, ou o estilo ao lado dele:
+ * `components/Card.module.css` é do `Card` cujo arquivo é `components/Card.tsx` - mesma pasta, mesmo
+ * nome antes do primeiro ponto.
+ *
+ * E A PASTA DO COMPONENTE É DELE (medido no `codelevel` em 30/09, na E03): `packages/ui/src/CourseCover/motion.ts` é
+ * do `course-cover`, porque a pasta tem o nome do arquivo do componente. `components/`, que é de todos, não vira de
+ * ninguém: ali só o arquivo e o estilo com o mesmo nome.
+ *
+ * DUAS RECEITAS NO MESMO ARQUIVO: fica a que tem o nome dele. O `codelevel` tem `course-cover` e `covers` em
+ * `CourseCover.tsx`, e a regra antiga ("duas reclamam, nenhuma") deixava sem componente as 21 checagens do
+ * componente mais checado do sistema. Se nenhuma tem o nome, continua nenhuma.
+ *
+ * SEM RECEITA, SEM COMPONENTE. Um `app/page.module.css` que nenhuma receita reclama não vira "Page":
+ * o palpite pelo nome contaria checagens para um componente que não existe no sistema dele, e é
+ * dessa contagem que os degraus do jogo vão sair. E se duas receitas diferentes reclamam o mesmo
+ * arquivo, também não há resposta - escolher uma seria o mesmo palpite com outra roupa.
+ */
+export function componentOf(file, documents) {
+    const exact = new Map();
+    const sibling = new Map();
+    const folder = new Map();
+    const dir = dirname(file);
+    const stem = stemOf(file);
+    for (const doc of documents) {
+        const components = doc?.components;
+        if (!components || typeof components !== "object")
+            continue;
+        for (const [name, recipe] of Object.entries(components)) {
+            const at = recipe?.source
+                ?.file;
+            if (typeof at !== "string" || at === "")
+                continue;
+            if (at === file)
+                exact.set(name, at);
+            else if (dirname(at) !== dir)
+                continue;
+            else if (stemOf(at) === stem)
+                sibling.set(name, at);
+            else if (basename(dir) === stemOf(at))
+                folder.set(name, at);
+        }
+    }
+    const found = [exact, sibling, folder].find((m) => m.size > 0);
+    if (!found)
+        return undefined;
+    if (found.size === 1)
+        return [...found.keys()][0];
+    const named = [...found].filter(([name, at]) => name === kebab(stemOf(at)));
+    return named.length === 1 ? named[0]?.[0] : undefined;
+}
+/**
+ * `CourseCover` -> `course-cover`: a chave que a plataforma dá à receita - cópia de `contractName`
+ * (apps/web/src/lib/ds/exclusive-contract.ts), porque o CLI é publicado sozinho e não importa de lá.
+ */
+const kebab = (name) => name
+    .split(".")
+    .join("-")
+    .replace(/([a-z0-9])([A-Z])/g, "$1-$2")
+    .toLowerCase()
+    .replace(/[^a-z0-9-]/g, "-")
+    .replace(/-+/g, "-")
+    .replace(/^-|-$/g, "");
+const stemOf = (path) => basename(path).split(".")[0] ?? "";

package/dist/doctor/components-scan.js

@@ -348,6 +348,15 @@ internal = []) {
         return;
     const owners = importedNames(source, internal);
     const private_ = localOnlyNames(source);
+    /**
+     * `function App({ Component, pageProps })` - A TELA QUE CHEGA COMO PROP (bateria ampliada, c30, 29/09). O `_app.tsx`
+     * do pages router renderiza `<Component {...pageProps} />`, e `Component` entrava no sistema como um componente
+     * dele. Um nome com maiúscula que o arquivo recebe como parâmetro desestruturado é fiação, igual a um local privado.
+     */
+    for (const m of source.matchAll(/\(\s*\{([^}]*)\}\s*(?::[^)]*)?\)/g))
+        for (const part of m[1].split(","))
+            for (const id of /^\s*(?:[\w$]+\s*:\s*)?([A-Z][\w$]*)\b/.exec(part)?.slice(1) ?? [])
+                private_.add(id);
     /**
      * Abertura por regex, corpo por SCANNER - ver `bodyOf`. A regex só encontra `<Nome`; onde a
      * tag termina é uma pergunta que só um scanner com estado responde.

package/dist/doctor/other-frameworks.js

@@ -0,0 +1,26 @@
+import { readFile } from "node:fs/promises";
+export async function unreadComponentFiles(files) {
+    const count = { Vue: 0, Svelte: 0, Astro: 0, Angular: 0 };
+    for (const f of files) {
+        if (/\.vue$/i.test(f)) {
+            if (!/(^|\/)(pages|layouts)\//.test(f) && !/(^|\/)app\.vue$/i.test(f))
+                count.Vue += 1;
+        }
+        else if (/\.svelte$/i.test(f) &&
+            !/(^|\/)\+(page|layout|error)\.svelte$/.test(f))
+            count.Svelte += 1;
+        else if (/\.astro$/i.test(f) && !/(^|\/)pages\//.test(f))
+            count.Astro += 1;
+        else if (/\.ts$/i.test(f) && !/\.(spec|test)\.ts$/.test(f)) {
+            const src = await readFile(f, "utf8").catch(() => "");
+            const root = /(^|\/)app(\.component)?\.ts$/.test(f);
+            if (!root &&
+                /@Component\s*\(\s*\{/.test(src) &&
+                /from\s+["']@angular\/core["']/.test(src))
+                count.Angular += 1;
+        }
+    }
+    return Object.entries(count)
+        .filter(([, n]) => n > 0)
+        .map(([framework, n]) => ({ framework, files: n }));
+}

package/dist/doctor/scan.js

@@ -12,6 +12,7 @@
 import { propertyAt, roleFits } from "./their-names.js";
 import { utilitiesOn } from "./idiom-names.js";
 import { normalizeValue, tokenMatch } from "./tokens.js";
+import { THEME_SOURCE, tsTokenObjects } from "./ts-tokens-lens.js";
 /**
  * O NOME QUE SE ESCREVE NO ARQUIVO DELE - e ele é SEMPRE do vocabulário dele (`INV-GERAL-13`).
  *
@@ -488,7 +489,74 @@ export function scanSource(file, source, table) {
                 : null),
         };
     }
-    return scanCore(file, source, table);
+    return stretchedStack(file, source, themeDefinitionsAside(file, source, scanCore(file, source, table)));
+}
+/**
+ * A GRADE QUE DIVIDE A ALTURA DA TELA - bateria ampliada, item 17 (29/09).
+ *
+ * Em 11 dos 28 projetos com tela, o celular abria com meia tela vazia antes do conteúdo, e o agente dizia "works on
+ * mobile" nos 11. A causa é uma só, escrita pelo próprio agente na casca: `display: grid` com `min-height: 100dvh` e as
+ * colunas empilhando em `1fr` no celular. Sem `grid-template-rows`, as duas linhas automáticas dividem a altura - a da
+ * barra lateral cresce até a metade da tela. O conserto é uma linha (`grid-template-rows: auto 1fr`, ou
+ * `align-content: start`), e é dito aqui porque o agente não vê o celular.
+ */
+function stretchedStack(file, source, report) {
+    if (!/\.(css|scss|sass|less|tsx|jsx)$/i.test(file))
+        return report;
+    const stacks = /grid-template-columns\s*:\s*1fr\s*[;}]|gridTemplateColumns\s*:[^,}\n]*["']1fr["']/.test(source);
+    if (!stacks)
+        return report;
+    const found = [];
+    const ROWS = /grid-template-rows|gridTemplateRows|align-content|alignContent|place-content|placeContent/;
+    /** O seletor que recebe a regra de linhas em QUALQUER bloco (o `@media` do c06 põe `grid-template-rows` ali). */
+    const settled = new Set();
+    const blocks = /([^{};]*)\{([^{}]*)\}/g;
+    for (const m of source.matchAll(blocks))
+        if (ROWS.test(m[2]))
+            settled.add(m[1].trim());
+    for (const m of source.matchAll(blocks)) {
+        const body = m[2];
+        const selector = m[1].trim();
+        const grid = /display\s*:\s*["']?grid\b/.test(body);
+        const tall = /min-?[hH]eight\s*:\s*["']?100(dvh|svh|lvh|vh)\b/.exec(body);
+        if (!grid || !tall || ROWS.test(body) || (selector.startsWith(".") && settled.has(selector)))
+            continue;
+        const at = source.slice(0, (m.index ?? 0) + m[1].length + 1 + body.indexOf(tall[0])).split("\n").length;
+        found.push({ line: at, literal: `min-height: 100${tall[1]}`, why: "stretch" });
+    }
+    if (found.length === 0)
+        return report;
+    return { ...report, offScale: [...(report.offScale ?? []), ...found] };
+}
+/**
+ * O ARQUIVO ONDE O TEMA NASCE NÃO É DERIVA - bateria ampliada, item 13 (29/09).
+ *
+ * A checagem do fim do turno dizia "11 hand-written values in src/theme.ts" (c03), 18 no do Emotion (c04), 13 no
+ * `theme.css.ts` (c05), 18 no `uno.config.ts` (c15) e 7 no `custom.scss` do Bootstrap (c17). São as DEFINIÇÕES
+ * dele: o único lugar onde um valor pode e deve estar escrito. O agente gastava o fim de cada turno explicando isso.
+ *
+ * Postos de lado com o motivo, como os de fixture: não acusados e não creditados. Num `.ts`/`.js` com objeto de tema
+ * (o mesmo leitor de `ts-tokens-lens`), o arquivo todo; num `.scss`, as linhas `$nome: valor`.
+ */
+function themeDefinitionsAside(file, source, report) {
+    if (report.findings.length === 0)
+        return report;
+    let aside = [];
+    if (THEME_SOURCE.test(file) && !/\.(tsx|jsx)$/i.test(file) && tsTokenObjects(source).length > 0)
+        aside = report.findings;
+    else if (/\.(scss|sass)$/i.test(file)) {
+        const lines = source.split("\n");
+        // `$primary: #7c2d12;` - a definição simples. Um mapa (`$r: (radius: 6px, …)`) segue lido como antes.
+        aside = report.findings.filter((f) => /^\s*\$[\w-]+\s*:\s*[^(]*;?\s*$/.test(lines[f.line - 1] ?? ""));
+    }
+    if (aside.length === 0)
+        return report;
+    const kept = report.findings.filter((f) => !aside.includes(f));
+    return {
+        ...report,
+        findings: kept,
+        setAside: [...(report.setAside ?? []), { reason: "your theme is defined here - these are its definitions", count: aside.length }],
+    };
 }
 /**
  * OS SELETORES QUE DECLARAM VOCABULÁRIO - `@theme`, `:root` e a redefinição por tema (bateria, 28/09: b5 escreve
@@ -1072,7 +1140,9 @@ context = []) {
 }
 const MEDIA_WIDTH = /\b(?:(?:min|max)-)?width\s*(?::|[<>]=?)\s*([\d.]+)(px|rem|em)\b/g;
 const TOKEN_ARITHMETIC = /(?:\$\{\s*|:\s*)([A-Za-z_$][\w$]*(?:\.[\w$]+)*\.(?:[\w$]*(?:space|spacing|gap|radius|size|font)[\w$]*)(?:\.[\w$]+)*)\s*([+\-*/])\s*(\d+(?:\.\d+)?)\b/gi;
-const BORDER_WIDTH = /\bborder(?:-(?:top|right|bottom|left))?(?:-width)?\s*:\s*(\d+(?:\.\d+)?px)\b/g;
+const BORDER_WIDTH = /\b(?:border(?:-(?:top|right|bottom|left|inline|block)(?:-(?:start|end))?)?|outline)(?:-width|-offset)?\s*:\s*(\d+(?:\.\d+)?px)\b/g;
+/** `100dvh`, `50vw` - uma medida da janela, que nenhum token guarda. */
+const VIEWPORT = /(?<![\w.-])(\d+(?:\.\d+)?(?:dvh|svh|lvh|vh|dvw|svw|lvw|vw))\b/g;
 const BORDER_NAME = /border|line|hairline|stroke|rule|divider|thin/i;
 /**
  * FORA DA ESCALA, linha a linha - ver `OffScale`. `setAside` recebe o que foi medido e está certo: o ponto de quebra
@@ -1105,7 +1175,14 @@ function offScaleOf(file, line, table, setAside) {
         const theirs = [table.aliases.get(`spacing:${v}`), table.aliases.get(`radius:${v}`)].find((a) => a && BORDER_NAME.test(a.name));
         if (theirs)
             out.push({ literal: m[1], why: "named", nearest: `var(${theirs.name})` });
+        /**
+         * SEM NOME DELE, PASSA - E É DITO (a régua de 28/09, "a checagem diz isso uma vez"; bateria ampliada, item 14). O
+         * fim do turno do c06 dizia "nothing to name" com 1px e 2px nos arquivos, e o agente os achava à mão.
+         */ else if (/^[12]px$/.test(v))
+            setAside(`a ${v} border or outline - nothing in this project names a border width, so it passes`);
     }
+    for (const m of line.matchAll(VIEWPORT))
+        setAside(`${m[1]} - a size of the window, which no token holds`);
     return out;
 }
 /** As linhas que o `check_file` e o fim do turno dizem sobre `OffScale` - uma frase por caso, a mesma nos dois. */
@@ -1114,6 +1191,8 @@ export function describeOffScale(files) {
         ? `  ${f.file}:${o.line}  ${o.literal} - a breakpoint off your system's widths; the nearest is ${o.nearest} (a media query cannot use a token, so match the width)`
         : o.why === "arithmetic"
             ? `  ${f.file}:${o.line}  ${o.literal} - arithmetic on a token lands between the steps; use a step the system has, or ask for one`
-            : `  ${f.file}:${o.line}  ${o.literal} - this repo calls it ${o.nearest}`));
+            : o.why === "stretch"
+                ? `  ${f.file}:${o.line}  ${o.literal} on a grid that stacks to one column - on a phone its rows split the screen's height, so the bar above the content grows to half the screen; add grid-template-rows: auto 1fr (or align-content: start)`
+                : `  ${f.file}:${o.line}  ${o.literal} - this repo calls it ${o.nearest}`));
     return rows.length > 0 ? ["", "Off this system's scale:", ...rows] : [];
 }

package/dist/doctor/scheme-scope.js

@@ -33,6 +33,8 @@ const DARK_MARK = /(\.dark\b|\.theme-dark\b|\[data-(?:theme|scheme|mode)\s*[~^|*
 const LIGHT_MARK = /(\.light\b|\.theme-light\b|\[data-(?:theme|scheme|mode)\s*[~^|*$]?=\s*["']?light["']?\s*\])/i;
 /** As raízes do documento - os lugares onde alguém escreve o vocabulário do projeto. */
 const ROOT_MARK = /(^|[\s>+~,])(:root|html|:host|body)\b/gi;
+/** Um seletor que é SÓ atributo, sem elemento nem classe: `[data-brand="acme"]`. */
+const DOCUMENT_ATTRIBUTE = /^(\[[\w-]+(?:\s*[~^|*$]?=\s*(?:"[^"]*"|'[^']*'|[\w-]+))?\s*\])+$/;
 /** `@theme` do Tailwind v4 é raiz por definição: é onde a paleta inteira é declarada. */
 const AT_THEME = /^@theme\b/i;
 /**
@@ -71,7 +73,22 @@ function isDocumentScoped(selector) {
     // real virava local, e com ele os dois tokens que o comentário de `tokens.ts` cita
     // por nome (`--loader-color`, `--color-track`).
     const flat = selector.replace(/:(?:where|is)\s*\(/gi, "").replace(/\)/g, "");
-    return flat.split(",").every((one) => {
+    const parts = flat.split(",");
+    /**
+     * `:root, [data-brand="acme"] { … }` - A MARCA PADRÃO DITA DUAS VEZES (bateria ampliada, c07, 29/09).
+     *
+     * O projeto multimarca declara a marca padrão na raiz E sob o atributo que a troca, na mesma regra. O
+     * atributo sozinho, sem elemento, é o que ele põe no `<html>`; ao lado de uma raiz na MESMA lista, ele fala
+     * do documento, e não de um componente. Sem isto a regra inteira caía em `other`, as 5 variáveis dele não
+     * entravam, e o sistema nascia misturando as duas marcas pelo "the colour your code paints most".
+     */
+    const rootInList = parts.some((one) => {
+        ROOT_MARK.lastIndex = 0;
+        return ROOT_MARK.test(one);
+    });
+    return parts.every((one) => {
+        if (rootInList && DOCUMENT_ATTRIBUTE.test(one.trim()))
+            return true;
         SCHEME_MARK.lastIndex = 0;
         const scoped = SCHEME_MARK.test(one);
         ROOT_MARK.lastIndex = 0;
@@ -270,3 +287,24 @@ export function scopedBlocks(css) {
  * consumo.
  */
 const NAME = /^(--[a-z0-9_-]+|-{0,2}[a-z][a-z0-9-]*)$/i;
+/**
+ * AS OUTRAS MARCAS - `[data-brand="globex"] { --brand: …; }` redeclarando os nomes da raiz (bateria ampliada, c07).
+ *
+ * Um bloco só de atributo que redeclara pelo menos dois nomes da raiz é outra marca (ou outro tema) do mesmo
+ * sistema, e não vocabulário novo. Ele não entra na base - a base é a marca da raiz -, mas a pessoa precisa saber
+ * que ele foi visto e deixado de fora, e não misturado nem esquecido.
+ */
+export function attributeFaces(css, baseNames) {
+    const out = new Map();
+    for (const block of scopedBlocks(css)) {
+        if (block.scope !== "other" || block.stack.length !== 1)
+            continue;
+        const selector = block.stack[0].trim();
+        if (!DOCUMENT_ATTRIBUTE.test(selector))
+            continue;
+        const same = block.declarations.filter((d) => baseNames.has(d.name)).length;
+        if (same >= 2)
+            out.set(selector, (out.get(selector) ?? 0) + same);
+    }
+    return [...out].map(([selector, names]) => ({ selector, names }));
+}

package/dist/doctor/sheet-order.js

@@ -0,0 +1,99 @@
+import { readFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { parseRootTokens } from "./tokens.js";
+const CSS_IMPORT = /import\s+(?:[\w*{}\s,]+\s+from\s+)?["']([^"']+\.(?:css|scss|sass|less))["']/g;
+/** Os `import "…css"` de cada arquivo de código, resolvidos, na ordem em que aparecem. */
+export async function cssImportLists(codeFiles) {
+    const out = new Map();
+    for (const file of codeFiles) {
+        const src = await readFile(file, "utf8").catch(() => "");
+        if (!src.includes(".css") && !src.includes(".scss"))
+            continue;
+        const list = [];
+        for (const m of src.matchAll(CSS_IMPORT)) {
+            const spec = m[1];
+            if (!spec.startsWith("."))
+                continue;
+            list.push(join(dirname(file), spec));
+        }
+        if (list.length > 1)
+            out.set(file, list);
+    }
+    return out;
+}
+/**
+ * Os conflitos entre folhas, e a ORDEM das folhas para o leitor de raiz (que fica com a primeira): quem a tela mostra
+ * vem antes. Folha que não está em conflito nenhum mantém o lugar.
+ */
+export function resolveSheetConflicts(sheets, importLists) {
+    const perSheet = sheets.map((s) => ({
+        ...s,
+        tokens: parseRootTokens(s.body),
+    }));
+    const byName = new Map();
+    for (const s of perSheet)
+        for (const [name, value] of s.tokens) {
+            const list = byName.get(name) ?? [];
+            list.push({ file: s.file, value });
+            byName.set(name, list);
+        }
+    const conflicts = [];
+    /** Folha -> quantas folhas ela vence. A que vence mais sobe na ordem. */
+    const wins = new Map();
+    for (const [name, values] of byName) {
+        const distinct = new Set(values.map((v) => v.value.trim().toLowerCase()));
+        if (values.length < 2 || distinct.size < 2)
+            continue;
+        let decidedBy = null;
+        let winner = null;
+        for (const [importer, list] of importLists) {
+            const positions = values.map((v) => list.indexOf(v.file));
+            if (positions.some((p) => p === -1))
+                continue;
+            const last = positions.indexOf(Math.max(...positions));
+            winner = values[last] ?? null;
+            decidedBy = importer;
+            break;
+        }
+        if (winner)
+            wins.set(winner.file, (wins.get(winner.file) ?? 0) + 1);
+        conflicts.push({
+            name,
+            shown: (winner ?? values[0])?.value ?? "",
+            values,
+            decidedBy,
+        });
+    }
+    const ordered = [...sheets].sort((a, b) => (wins.get(b.file) ?? 0) - (wins.get(a.file) ?? 0));
+    return { ordered, conflicts };
+}
+/**
+ * A FOLHA QUE NINGUÉM CARREGA - bateria ampliada, c17 e c18 (29/09).
+ *
+ * O create-next-app deixa um `app/globals.css` com `--foreground: #ededed`, e quem troca por outra folha (o
+ * `vendor.min.css` do c18, o `custom.scss` do Bootstrap no c17) costuma esquecer o arquivo. Nenhuma página o importa,
+ * ele não pinta nada, e a cor do texto do sistema saía dele.
+ *
+ * Uma folha só dá token quando algum arquivo a cita pelo nome: um `import` no código, um `<link>` no HTML, a lista de
+ * estilos de uma config (`angular.json`, `nuxt.config.ts`) ou um `@import` de outra folha. Quando nada no projeto cita
+ * folha nenhuma, a pergunta não tem resposta, e nada é tirado.
+ */
+export async function unloadedSheets(sheets, textFiles) {
+    if (sheets.length < 2)
+        return [];
+    const texts = await Promise.all(textFiles.map((f) => readFile(f, "utf8").catch(() => "")));
+    const all = [...texts, ...sheets.map((s) => s.body)].join("\n");
+    const base = (f) => f.slice(f.lastIndexOf("/") + 1);
+    const cited = (f) => {
+        const name = base(f);
+        const stem = name.replace(/\.(css|scss|sass|less)$/, "");
+        return all.includes(name) || new RegExp(`["'/]_?${stem.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}["']`).test(all);
+    };
+    const citedAny = sheets.some((s) => cited(s.file));
+    if (!citedAny)
+        return [];
+    return sheets
+        .filter((s) => !/\.module\./.test(s.file) && !base(s.file).startsWith("_"))
+        .filter((s) => parseRootTokens(s.body).size > 0 && !cited(s.file))
+        .map((s) => s.file);
+}

package/dist/doctor/ts-tokens-lens.js

@@ -1,5 +1,13 @@
 const kebab = (k) => k.replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase();
-/** Um literal de objeto a partir de `{`, ou `null` quando aparece algo que não é literal. */
+/**
+ * Um literal de objeto a partir de `{`, ou `null` quando a própria estrutura não fecha.
+ *
+ * UMA ENTRADA ILEGÍVEL CUSTA SÓ ELA - bateria ampliada, 29/09. O tema do styled-components tinha
+ * `space: [0, 4, 8, 16, 24, 32]` e o do Emotion `spacing: (n) => \`${n * 4}px\``, e o objeto inteiro caía
+ * por causa de uma chave: o import dizia "your code names no token yet" com seis cores nomeadas ao lado. Agora
+ * um array vira escala (números) ou pilha de fonte (textos), e o que não é literal (função, chamada, spread,
+ * referência) fica sem leitura SÓ naquela chave. Uma expressão sobre token continua sem leitura, como antes.
+ */
 function parseObject(s, start) {
     let i = start + 1;
     const tree = {};
@@ -26,61 +34,168 @@ function parseObject(s, start) {
         i = end + 1;
         return out;
     };
+    /** Anda até a próxima `,` ou `}` do MESMO nível, atravessando parênteses, colchetes, chaves e textos. */
+    const skip = () => {
+        let depth = 0;
+        while (i < s.length) {
+            const c = s[i];
+            if (c === '"' || c === "'" || c === "`") {
+                const end = s.indexOf(c, i + 1);
+                if (end === -1)
+                    return false;
+                i = end + 1;
+                continue;
+            }
+            if (c === "(" || c === "[" || c === "{")
+                depth += 1;
+            else if (c === ")" || c === "]" || c === "}") {
+                if (depth === 0)
+                    return c === "}";
+                depth -= 1;
+            }
+            else if (c === "," && depth === 0)
+                return true;
+            i += 1;
+        }
+        return false;
+    };
+    /** `[0, 4, 8]` -> escala; `["Inter", "sans-serif"]` -> uma pilha de fonte. Outra coisa: `undefined`. */
+    const array = () => {
+        const close = s.indexOf("]", i);
+        if (close === -1)
+            return undefined;
+        const inner = s.slice(i + 1, close);
+        if (/[[{(]/.test(inner))
+            return undefined;
+        const items = inner
+            .split(",")
+            .map((x) => x.trim())
+            .filter((x) => x !== "");
+        if (items.length === 0)
+            return undefined;
+        if (items.every((x) => /^-?\d+(\.\d+)?$/.test(x))) {
+            i = close + 1;
+            return Object.fromEntries(items.map((x, n) => [String(n), Number(x)]));
+        }
+        if (items.every((x) => /^(["'])[^"']*\1$/.test(x))) {
+            i = close + 1;
+            return items.map((x) => x.slice(1, -1)).join(", ");
+        }
+        return undefined;
+    };
     for (;;) {
         ws();
         if (s[i] === "}")
             return { tree, end: i + 1 };
+        if (i >= s.length)
+            return null;
         let key = str();
         if (key === null) {
             const m = /^[A-Za-z_$][\w$]*|^\d+/.exec(s.slice(i));
-            if (!m)
-                return null;
+            if (!m) {
+                // `...spread` ou chave computada: a entrada fica sem leitura, o resto do objeto segue
+                if (!skip())
+                    return s[i] === "}" ? { tree, end: i + 1 } : null;
+                if (s[i] === ",")
+                    i += 1;
+                continue;
+            }
             key = m[0];
             i += key.length;
         }
         ws();
-        if (s[i] !== ":")
-            return null;
+        if (s[i] !== ":") {
+            // `{ primary, secondary }` (atalho) ou método: sem valor literal para ler
+            if (!skip())
+                return s[i] === "}" ? { tree, end: i + 1 } : null;
+            if (s[i] === ",")
+                i += 1;
+            continue;
+        }
         i += 1;
         ws();
+        let value;
         if (s[i] === "{") {
             const inner = parseObject(s, i);
-            if (!inner)
-                return null;
-            tree[key] = inner.tree;
-            i = inner.end;
+            if (inner) {
+                value = inner.tree;
+                i = inner.end;
+            }
         }
+        else if (s[i] === "[")
+            value = array();
         else {
             const text = str();
             if (text !== null)
-                tree[key] = text;
+                value = text;
             else {
-                const m = /^-?\d+(\.\d+)?/.exec(s.slice(i));
-                if (!m)
-                    return null;
-                tree[key] = Number(m[0]);
-                i += m[0].length;
+                const m = /^-?\d+(\.\d+)?(?=\s*[,}\n])/.exec(s.slice(i));
+                if (m) {
+                    value = Number(m[0]);
+                    i += m[0].length;
+                }
             }
         }
+        if (value === undefined) {
+            if (!skip())
+                return s[i] === "}" ? { tree, end: i + 1 } : null;
+        }
+        else
+            tree[key] = value;
         ws();
         if (s[i] === ",")
             i += 1;
     }
 }
 const DESIGN = /^(#[0-9a-f]{3,8}|rgba?\(|hsla?\(|oklch\(|cubic-bezier\(|-?\d+(\.\d+)?(px|rem|em|%|ms|s)\b)|,|['"]/i;
+/** Número que NÃO é medida: peso, camada, altura de linha, opacidade. Ganha `px` só o resto. */
+const UNITLESS = /(font-?weight|weight|z-?index|line-?height|opacity|flex|order)$/i;
+/**
+ * INVÓLUCROS DE CONFIG - `theme.extend.colors` do Tailwind 3, `theme.tokens.colors` do Chakra. Eles dizem ONDE o
+ * vocabulário mora na config, e não fazem parte do nome dele: `--theme-extend-colors-brand` seria um nome que ele
+ * nunca escreveu. Só saem no começo do caminho.
+ */
+const WRAPPER = new Set(["theme", "extend", "tokens"]);
 function flatten(tree, prefix, out) {
     for (const [k, v] of Object.entries(tree)) {
-        const path = [...prefix, kebab(k)];
-        if (typeof v === "object")
+        if (prefix.length === 0 && ["content", "plugins", "presets", "dark-mode", "darkMode", "safelist"].includes(k))
+            continue;
+        const seg = kebab(k);
+        if (prefix.every((p) => WRAPPER.has(p)) && WRAPPER.has(seg) && typeof v === "object") {
+            flatten(v, [...prefix, seg], out);
+            continue;
+        }
+        // `brand: { DEFAULT: "#0f766e", soft: … }` - no Tailwind o DEFAULT É o `brand`, e não um tom chamado "default"
+        const path = [...prefix.filter((p) => !WRAPPER.has(p)), ...(k === "DEFAULT" ? [] : [seg])];
+        if (typeof v === "object") {
+            // `{ value: "#1e3a8a" }` - a forma de token do Chakra e do Style Dictionary: o nome é o de cima
+            const keys = Object.keys(v);
+            if (keys.length === 1 && keys[0] === "value" && typeof v.value !== "object") {
+                out.set(`--${path.join("-")}`, typeof v.value === "number" ? `${v.value}px` : v.value);
+                continue;
+            }
             flatten(v, path, out);
+        }
         else
-            out.set(`--${path.join("-")}`, typeof v === "number" ? `${v}px` : v);
+            out.set(`--${path.join("-")}`, typeof v === "number" ? (UNITLESS.test(k) ? String(v) : `${v}px`) : v);
     }
 }
-/** Os objetos exportados que seguram valores de design - um objeto de rotas ou de textos não conta. */
+/**
+ * ONDE UM OBJETO DE TOKENS COMEÇA - bateria ampliada, 29/09. Antes só `export const x = {`, e por isso nenhum dos
+ * temas escritos como a biblioteca manda entrava: `createTheme({...})` (MUI, vanilla-extract), `defineConfig({...})`
+ * (Chakra, UnoCSS), `module.exports = {...}` (tailwind.config.js), `export default {...}`. Uma const não exportada só
+ * conta quando a chamada é de tema, porque `const style = {` dentro de um componente não é o sistema dele.
+ */
+const THEME_CALL = /^(createTheme|defineConfig|createSystem|extendTheme|defineTokens|createGlobalTheme|defineTheme)$/;
+const OPENERS = /(?:(export\s+)?(?:const|let)\s+(\[[^\]]*\]|[A-Za-z_$][\w$]*)\s*(?::[^=]+)?=|export\s+default|module\.exports\s*=)\s*(?:([A-Za-z_$][\w$.]*)\s*\(\s*(?:[A-Za-z_$][\w$]*\s*,\s*)?)?\{/g;
+/** Os objetos que seguram valores de design - um objeto de rotas ou de textos não conta. */
 export function tsTokenObjects(source) {
     const out = [];
-    for (const m of source.matchAll(/export\s+const\s+([A-Za-z_$][\w$]*)\s*(?::[^=]+)?=\s*\{/g)) {
+    for (const m of source.matchAll(OPENERS)) {
+        const exported = /^(export|module)/.test(m[0]) || m[1] !== undefined;
+        const call = (m[3] ?? "").split(".").pop() ?? "";
+        if (!exported && !THEME_CALL.test(call))
+            continue;
         const parsed = parseObject(source, (m.index ?? 0) + m[0].length - 1);
         if (!parsed)
             continue;
@@ -88,8 +203,9 @@ export function tsTokenObjects(source) {
         flatten(parsed.tree, [], values);
         const leaves = [...values.values()];
         const design = leaves.filter((v) => DESIGN.test(v) || /^\d+(\.\d+)?px$/.test(v)).length;
+        const name = (m[2] ?? "default").replace(/^\[\s*|\s*\]$/g, "").split(",").pop()?.trim() || "default";
         if (leaves.length >= 4 && design * 10 >= leaves.length * 6)
-            out.push({ name: m[1], values });
+            out.push({ name, values });
     }
     return out;
 }
@@ -135,3 +251,9 @@ export function tsTokensAsVars(source, objects) {
     });
     return out;
 }
+/**
+ * OS ARQUIVOS ONDE UM TEMA PODE MORAR - TypeScript e também JavaScript, porque o `tailwind.config.js` do Tailwind 3 é
+ * o sistema inteiro de quem o usa (bateria ampliada, c02). O filtro de valor de design de `tsTokenObjects` é o que
+ * separa o tema de um `next.config.js`.
+ */
+export const THEME_SOURCE = /\.(ts|tsx|js|jsx|mjs|cjs)$/;

package/dist/install-marks.js

@@ -509,7 +509,25 @@ export const COUNTED_DIFFERENTLY = "this run counts a value as named only when Y
  * 0.16.475 -> 0.16.478 em 28/09, e o passo 1 dá **SIM** (etapa 02, "a nossa grafia conta como nossa"): o fim do turno diz
  * quando o arquivo usa `var(--ds-*)` - o valor do sistema com o NOSSO nome. Um hook anterior cala sobre esse arquivo.
  */
-export const CHECKER_SINCE = "0.16.478";
+/**
+ * 0.16.478 -> 0.16.485 em 29/09, e o passo 1 dá **SIM** (a bateria ampliada, itens 13, 14, 17, 18 e 19): o fim do turno
+ * deixa de acusar o arquivo onde o tema é definido, nomeia o que sai da escala depois do corte, diz uma vez o que passou
+ * de propósito, avisa a grade que divide a altura da tela no celular, propõe os nomes numa pergunta só e termina pedindo
+ * o resumo por último. Um hook anterior diz outra coisa sobre o mesmo turno.
+ */
+/**
+ * 0.16.485 -> 0.16.486 em 30/09, e o passo 1 dá **SIM** (o jogo dos envios, E01): a linha que o hook grava no ledger
+ * passa a dizer quantos valores sem nome e quantos fora da escala a checagem achou, e de qual componente é o arquivo. Um
+ * hook anterior grava "limpo" sobre o arquivo que acabou de acusar, e é dessas linhas que os degraus de cada componente
+ * vão ser contados - quem está atrás vê o componente amadurecer com checagens que não foram limpas.
+ */
+/**
+ * 0.16.486 -> 0.16.487 em 30/09, e o passo 1 dá **SIM** (o jogo dos envios, E03): a ponte arquivo -> componente passa a
+ * dar dono ao arquivo da pasta do componente (`CourseCover/motion.ts`) e, quando duas receitas reclamam o mesmo arquivo,
+ * à que tem o nome dele. Medido no `codelevel`: 33 checagens do componente mais checado chegavam sem componente. Um
+ * hook anterior continua mandando essas checagens sem dono, e elas não contam para o degrau.
+ */
+export const CHECKER_SINCE = "0.16.487";
 /**
  * A ÚLTIMA VERSÃO EM QUE OS LEITORES PASSARAM A PRODUZIR UM CENSO DIFERENTE.
  *
@@ -979,7 +997,13 @@ export const CHECKER_SINCE = "0.16.478";
  * mão o que um `:root { --a: x; }` ou um `[data-theme="dark"] { … }` de UMA linha atribui a uma variável - a definição do
  * token. Quatro apps do corpus moveram. Um censo lido antes guardou essas declarações como drift.
  */
-export const READER_SINCE = "0.16.473";
+/**
+ * 0.16.473 -> 0.16.485 em 29/09, e o passo 1 dá **SIM** (a bateria ampliada, itens 1 a 11): o censo lê a folha que ele
+ * importa de dentro de build/, a marca da raiz do multimarca, o tema em JS/TS de sete bibliotecas, o token que a tela
+ * mostra quando duas folhas brigam, deixa de fora a folha que ninguém carrega, conta o pages router como rota e diz os
+ * componentes em Vue, Svelte, Astro e Angular. Um censo lido antes guardou "names no token yet" onde havia tokens.
+ */
+export const READER_SINCE = "0.16.485";
 /**
  * O QUE ESTÁ INSTALADO AQUI FICOU PARA TRÁS - e as DUAS condições que fazem isso ser verdade.
  *

package/package.json

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