synthesisui 0.16.483 → 0.16.485

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";
@@ -11,7 +11,7 @@ import { PAGES_MAX, pageCompositionOf } from "../census-pages.js";
 import { readCredentials, readProjectConfig, readToken, resolveRegistry, sameRegistry, } from "../config.js";
 import { declaredElsewhere } from "../declared-elsewhere.js";
 import { architectureGap, architectureRule, componentHome, describeArchitecture, describeChoice, describeGap, detectArchitectures, homeLine, packagingOf, proposeNewHome, resolvesAs, countsAsOrganization, } from "../doctor/architecture.js";
-import { findBrokenRefs } from "../doctor/broken-refs.js";
+import { findBrokenRefs, findOrphanVars, findSynonyms, synonymLine } from "../doctor/broken-refs.js";
 import { nestingRules, propRules, readDefinitionProps, readNesting, readRuntime, } from "../doctor/call-sites.js";
 import { asCatalogueTable, describeFallback, fetchCatalogue, } from "../doctor/catalogue-fetch.js";
 import { describeClassStyle, detectClassStyle, } from "../doctor/class-style.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),
@@ -2620,6 +2684,8 @@ export async function takeCensus(root, opts) {
         }
     }
     const brokenRefs = findBrokenRefs(sources, declaredNames);
+    const orphanVars = findOrphanVars(css, sources);
+    const synonyms = findSynonyms(css, sources);
     const conventions = detectConventions(sources);
     const classStyle = detectClassStyle(sources);
     /**
@@ -2696,6 +2762,8 @@ export async function takeCensus(root, opts) {
             : {}),
         ...(animations.size > 0 ? { animations: [...animations].sort() } : {}),
         ...(brokenRefs.length > 0 ? { brokenRefs } : {}),
+        ...(orphanVars.length > 0 ? { orphanVars } : {}),
+        ...(synonyms.length > 0 ? { synonyms } : {}),
         /**
          * OS SISTEMAS QUE O CSS DELE JÁ CHAMA PELO NOME - ver `wiredSlugs`.
          *
@@ -2757,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 } : {}),
@@ -3051,6 +3123,38 @@ async function summarize(c, root, scope) {
     sayAdoption(c);
     sayCollisions(c);
     await sayBrokenRefs(c, root, scope);
+    sayOrphanVars(c);
+    saySynonyms(c);
+}
+/**
+ * A MESMA COR COM VÁRIOS NOMES - uma linha por cor, até três (item 16 da bateria, 29/09). Propõe o nome que o código
+ * mais lê; quem decide se junta é ele.
+ */
+function saySynonyms(c) {
+    const all = c.synonyms ?? [];
+    if (all.length === 0)
+        return;
+    console.log("");
+    console.log(section("One colour, several names"));
+    for (const g of all.slice(0, 3))
+        console.log(body(synonymLine(g)));
+    if (all.length > 3)
+        console.log(body(paint.faint(`(${all.length - 3} more colours with more than one name)`)));
+}
+/**
+ * DECLARADAS E NUNCA USADAS - uma linha, nunca uma acusação (item 15 da bateria, 29/09).
+ *
+ * No b1 eram três sobras de um tema antigo, e o import passava calado. Quem lê decide se apaga: pode ser de propósito.
+ */
+function sayOrphanVars(c) {
+    const all = c.orphanVars ?? [];
+    if (all.length === 0)
+        return;
+    const names = all.slice(0, 6).map((o) => paint.strong(o.name));
+    const more = all.length > 6 ? ` and ${all.length - 6} more` : "";
+    console.log("");
+    console.log(section("Declared and never used"));
+    console.log(body(`${all.length} variable${all.length === 1 ? "" : "s"} your CSS declares and nothing reads: ${names.join(", ")}${more}. Usually left over from an old theme - yours to delete or keep.`));
 }
 /**
  * OS ESCOPOS QUE VIRARAM UM SISTEMA, e o que cada um perdeu no empate.
@@ -3908,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;
@@ -3920,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
@@ -4138,6 +4263,13 @@ const DECIDEM = [
 const NA_TELA_DO_IMPORT = [
     "How this project is organised",
     ...DECIDEM,
+    /**
+     * E AS ÓRFÃS, numa linha (item 15 da bateria, 29/09): no b1 o dev contava três sobras de tema e o import passava
+     * calado. Cabe porque é uma linha só, e ela muda o que ele faz a seguir: apagar ou manter.
+     */
+    "Declared and never used",
+    /** E a mesma cor com vários nomes (item 16 da bateria, 29/09): até três linhas, e cada uma propõe um nome. */
+    "One colour, several names",
 ];
 function sayReach(c) {
     const reach = ladderReach(c.declared);
@@ -4654,6 +4786,20 @@ quiet = false) {
  * token nenhum o sistema inteiro é a semente, e "v1 is your tokens" levava ao contrário. Ver
  * `nao-espelha-o-que-nao-existe.spec.ts`.
  */
+/**
+ * AS CORES QUE O PROJETO NÃO TEM - item 18 da bateria (28/09), liberado por ele em 29/09. No b4 a borda, o sucesso e o
+ * perigo vinham do nosso ponto de partida, e o dev achava que eram dele. O servidor manda quais (`fromSeed`).
+ */
+export function fromSeedLine(roles) {
+    if (roles.length === 0)
+        return null;
+    const list = roles.length === 1
+        ? roles[0]
+        : `${roles.slice(0, -1).join(", ")} or ${roles[roles.length - 1]}`;
+    return roles.length === 1
+        ? `Your code names no ${list} colour, so it comes from our starting point - yours to change on the colours page.`
+        : `Your code names no ${list} colour, so those come from our starting point - yours to change on the colours page.`;
+}
 export function birthLine(name, declared) {
     return declared === 0
         ? `${name} - your code names no token yet, so this system is our starting point, with your colours and sizes measured next to it (listed in the report).`
@@ -5160,6 +5306,15 @@ export async function runImport(opts) {
      */
     if (payload?.primary)
         console.log(body(payload.primary));
+    /**
+     * E AS QUE ELE NÃO TEM (item 18 da bateria, 29/09). Com a porta das cores aberta a frase dela já diz tudo, e com zero
+     * token a frase do nascimento já diz que o sistema inteiro é o ponto de partida - aí esta linha seria repetição.
+     */
+    const seedLine = !payload?.coloursDoor && Object.keys(census.declared ?? {}).length > 0
+        ? fromSeedLine(payload?.fromSeed ?? [])
+        : null;
+    if (seedLine)
+        console.log(body(seedLine));
     /**
      * A PORTA - convite, nunca bloqueio (o ponto 1 que ele aprovou em 28/09). O servidor manda a frase pronta, a mesma
      * que o quadro do sistema mostra, e o link da tela de escolher daquele sistema.
@@ -5298,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/commands/sync.js

@@ -405,6 +405,16 @@ export async function remeasure(args) {
      * a frase diz que é o esperado, e o `.lock` guarda isso, para o `align` não pedir de novo.
      */
     if (head?.status === 404) {
+        /**
+         * MAS O 404 TAMBÉM É A RESPOSTA A UMA SESSÃO RECUSADA (29/09): a rota não diz "não te conheço" para não revelar
+         * sistema de ninguém. O token de www.synthesisui.com num sync contra o localhost caía aqui, e o `teste-e09-fechamento`,
+         * que TEM leitura, foi marcado como nunca medido. Antes de concluir, pergunta à sessão.
+         */
+        if (!(await sessionAccepted(base, token))) {
+            console.log(section("Sync"));
+            console.log(body(`${base} does not accept this machine's login, so nothing was re-measured - and nothing was marked. Sign in there and run this again: npx synthesisui login --registry ${base}`));
+            return null;
+        }
         await markNoReading(root, slug);
         console.log(section("Sync"));
         console.log(body(`"${slug}" was not read from a repository - it comes from the gallery or was built on the platform - so there is nothing here to re-measure. That is expected, and this repo will stop asking.`));
@@ -422,10 +432,22 @@ export async function remeasure(args) {
      * SEM CENSO GRAVADO NÃO HÁ O QUE REMEDIR CONTRA. Um sistema que nasceu da galeria não tem escopo
      * nem leitura, e medir o repo dele produziria um censo de um projeto que ninguém mapeou para ele.
      */
+    /**
+     * A LEITURA EXISTE, então uma marca "nunca medido" no `.lock` está errada - a que uma sessão recusada deixou antes de
+     * 29/09 (ver o 404 acima). Sai aqui, para o `align` voltar a pedir o que precisa.
+     */
+    if (stored.hasCensus)
+        await unmarkNoReading(root, slug);
+    /**
+     * O SISTEMA DA GALERIA APRENDE COM O QUE ELE CONSTRÓI - item 8 da bateria (28/09), liberado por ele em 29/09.
+     *
+     * Esta resposta era "did not come from an import (...) Import it first", e no b11 tudo o que o agente construiu em cima
+     * do sistema da galeria ficava fora da plataforma. Sem leitura gravada, a medição vai sobre o repositório inteiro (a
+     * mesma queda de escopo que `scopes` abaixo já faz), e a frase diz que é a primeira.
+     */
     if (!stored.hasCensus) {
         console.log(section("Sync"));
-        console.log(body(`"${slug}" did not come from an import, so there is no measurement to refresh. Import it first: npx synthesisui import`));
-        return null;
+        console.log(body(`This is the first measurement of what this project built on "${slug}" - it came from the gallery, so the platform had not read this repo yet. What you created goes to your system's draft; the system's own colours and type stay as they are.`));
     }
     /**
      * A DISTÂNCIA ATÉ O CLI PUBLICADO, dita onde ele já está.
@@ -1094,6 +1116,32 @@ async function askForScope(root) {
 export async function installedSlug(root) {
     return (await installedSlugs(root))[0] ?? null;
 }
+/** A sessão desta máquina vale em `base`? - a mesma pergunta que o `status` faz. Sem resposta, diz que não. */
+async function sessionAccepted(base, token) {
+    const res = await fetch(`${base}/api/auth/get-session`, {
+        headers: { Authorization: `Bearer ${token}` },
+    }).catch(() => null);
+    if (!res?.ok)
+        return false;
+    const who = (await res.json().catch(() => null));
+    return Boolean(who?.user);
+}
+/** Tira do `.lock` a marca de "sem leitura", quando a plataforma diz que a leitura existe. */
+async function unmarkNoReading(root, slug) {
+    const path = join(root, "_synthesisui", "ds", slug, ".lock");
+    const raw = await readFile(path, "utf8").catch(() => "");
+    if (!raw)
+        return;
+    try {
+        const { reading, ...rest } = JSON.parse(raw);
+        if (reading !== "none")
+            return;
+        await writeFile(path, `${JSON.stringify(rest, null, 2)}\n`, "utf8");
+    }
+    catch {
+        /** Um `.lock` ilegível não é deste passo consertar. */
+    }
+}
 /** Anota no `.lock` que a plataforma não tem leitura deste sistema - ver o 404 em `remeasure`. */
 async function markNoReading(root, slug) {
     const path = join(root, "_synthesisui", "ds", slug, ".lock");

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/broken-refs.js

@@ -174,3 +174,64 @@ export function findBrokenRefs(sources, declared) {
         b.count - a.count ||
         a.name.localeCompare(b.name));
 }
+const THEME_BLOCK = /@theme\b[^{]*\{[^}]*\}/g;
+const DECLARES_VAR = /(--[a-zA-Z0-9_-]+)\s*:/g;
+const READS_IN_JS = /getPropertyValue\(\s*['"`](--[a-zA-Z0-9_-]+)/g;
+const TAILWIND_SHORT = /\((--[a-zA-Z0-9_-]+)\)/g;
+export function findOrphanVars(css, sources) {
+    const declared = new Set();
+    for (const m of css.replace(THEME_BLOCK, "").matchAll(DECLARES_VAR))
+        declared.add(m[1]);
+    if (declared.size === 0)
+        return [];
+    const used = new Set();
+    for (const text of [css, ...sources.map((s) => s.source)]) {
+        for (const m of text.matchAll(VAR_REF))
+            used.add(m[1]);
+        for (const m of text.matchAll(READS_IN_JS))
+            used.add(m[1]);
+        for (const m of text.matchAll(TAILWIND_SHORT))
+            used.add(m[1]);
+    }
+    return [...declared].filter((n) => !used.has(n)).map((name) => ({ name }));
+}
+const DECLARES_COLOUR = /(--[a-zA-Z0-9_-]+)\s*:\s*(#[0-9a-fA-F]{3,8}|rgba?\([^)]*\)|hsla?\([^)]*\))\s*[;}]/g;
+export function findSynonyms(css, sources) {
+    const byValue = new Map();
+    for (const m of css.replace(THEME_BLOCK, "").matchAll(DECLARES_COLOUR)) {
+        const value = m[2].replace(/\s+/g, "").toLowerCase();
+        const names = byValue.get(value) ?? [];
+        if (!names.includes(m[1]))
+            names.push(m[1]);
+        byValue.set(value, names);
+    }
+    const uses = new Map();
+    /** Só nas fontes: a folha `css` é a soma das folhas que também estão lá, e contar as duas dobraria cada leitura. */
+    for (const text of sources.length > 0 ? sources.map((s) => s.source) : [css])
+        for (const m of text.matchAll(VAR_REF))
+            uses.set(m[1], (uses.get(m[1]) ?? 0) + 1);
+    const groups = [];
+    for (const [value, names] of byValue) {
+        if (names.length < 2)
+            continue;
+        groups.push({
+            value,
+            names: names
+                .map((name) => ({ name, uses: uses.get(name) ?? 0 }))
+                .sort((a, b) => b.uses - a.uses),
+        });
+    }
+    return groups.sort((a, b) => b.names.length - a.names.length);
+}
+/** "#2563eb has 4 names: ... Your code reads --brand the most - keeping one would make the rest aliases." */
+export function synonymLine(g) {
+    const listed = g.names
+        .map((n) => `${n.name} (${n.uses > 0 ? `${n.uses}×` : "never read"})`)
+        .join(", ");
+    const top = g.names[0]?.uses ?? 0;
+    const most = g.names.filter((n) => n.uses === top && top > 0).map((n) => n.name);
+    const tail = most.length === 0
+        ? "Nothing reads any of them yet - keeping one would make the rest aliases."
+        : `Your code reads ${most.length === 1 ? most[0] : `${most.slice(0, -1).join(", ")} and ${most[most.length - 1]}`} the most - keeping one would make the rest aliases.`;
+    return `${g.value} has ${g.names.length} names: ${listed}. ${tail}`;
+}

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/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] : [];
 }