synthesisui 0.16.472 → 0.16.474

package/dist/commands/import.js

@@ -1,4 +1,5 @@
 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 { basename, dirname, join, relative, resolve, sep } from "node:path";
@@ -4648,6 +4649,16 @@ quiet = false) {
             say(body(n));
     }
 }
+/**
+ * A FRASE DO NASCIMENTO - e ela depende de o código dele nomear alguma coisa. Bateria, 28/09 (b2): num projeto sem
+ * 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`.
+ */
+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).`
+        : `${name} - v1 is your tokens, nothing improved yet; where your code names nothing, it keeps the starting point's value (listed in the report).`;
+}
 export async function runImport(opts) {
     const root = opts.root ?? process.cwd();
     /**
@@ -5141,7 +5152,7 @@ export async function runImport(opts) {
      * NÃO "ESPELHA EXATAMENTE" - rodadas 11 e 13, 28/09: a v1 trazia um `display` de 4rem e uma mono JetBrains que
      * o projeto nunca declarou, e a frase dizia o contrário. As fundações vêm da semente onde ele não nomeia nada.
      */
-    `${paint.strong(payload?.name ?? "Your system")} - v1 is your tokens, nothing improved yet; where your code names nothing, it keeps the starting point's value (listed in the report).`));
+    birthLine(paint.strong(payload?.name ?? "Your system"), Object.keys(census.declared ?? {}).length)));
     /**
      * ONDE ELE NASCEU, dito pela plataforma e não pelo que foi pedido.
      *
@@ -5224,6 +5235,12 @@ export async function runImport(opts) {
      * mais longa do produto ficar mais longa no lugar onde ela já é mais difícil de ler.
      */
     if (payload?.slug) {
+        /**
+         * O PONTO DE PARTIDA DO PRIMEIRO `sync` - ver `importMark`. Sem ele, o que o agente cria depois do import nunca é
+         * anunciado (bateria, 28/09: 16 componentes no b7, nenhum dito). Só aqui, com o sistema nascido: um `--dry` não
+         * envia nada, e uma marca sem envio mentiria sobre o que a plataforma tem.
+         */
+        await writeSyncMark(root, importMark(census, opts.cli));
         /**
          * O QUE O CSS DELE AINDA IMPORTA - e este aviso sai do CLI, não da skill.
          *

package/dist/commands/login.js

@@ -50,9 +50,25 @@ export async function login(opts) {
      */
     if (!opts.force) {
         const existing = await readCredentials();
-        if (existing && sameRegistry(existing.registry, base)) {
+        /**
+         * E DIZ QUEM - bateria, 28/09 (b11). O passo Install da galeria acabou de dizer que a CONTA importa ("the
+         * account that owns <slug>"), e esta linha dizia só o host. A mesma pergunta que o `status` já faz (#1630).
+         * Um token que a plataforma responde e não aceita mais não é "já entrou": segue para o login de verdade.
+         * Sem resposta nenhuma, vale o que a máquina tem - offline não é motivo para abrir um browser.
+         */
+        const who = existing && sameRegistry(existing.registry, base)
+            ? await fetch(`${base}/api/auth/get-session`, {
+                headers: { Authorization: `Bearer ${existing.token}` },
+            })
+                .then(async (r) => r.ok ? (await r.json()) : null)
+                .then((j) => ({ reached: true, email: j?.user?.email ?? null }))
+                .catch(() => ({ reached: false, email: null }))
+            : null;
+        if (who && (who.email || !who.reached)) {
             console.log("");
-            console.log(`✓ Already signed in to ${base} on this machine.`);
+            console.log(who.email
+                ? `✓ Already signed in as ${who.email} on ${base}.`
+                : `✓ Already signed in to ${base} on this machine (the account could not be confirmed - the registry did not answer).`);
             console.log("  Run `synthesisui login --force` to sign in as someone else,");
             console.log("  or `synthesisui logout` to sign out of this machine.");
             return;

package/dist/doctor/scan.js

@@ -490,6 +490,44 @@ export function scanSource(file, source, table) {
     }
     return scanCore(file, source, table);
 }
+/**
+ * OS SELETORES QUE DECLARAM VOCABULÁRIO - `@theme`, `:root` e a redefinição por tema (bateria, 28/09: b5 escreve
+ * `[data-theme="dark"] { --c-bg: #0f172a; ... }`). Dentro deles uma `--x: valor` é a definição, não um uso.
+ */
+const TOKEN_SELECTOR_PART = /^(@theme\b.*|:root(\[[^\]]*\])?|html(\[[^\]]*\]|\.[\w-]+)?|\[data-(theme|mode|scheme|color-scheme)(=[^\]]*)?\]|\.(dark|light))$/;
+/**
+ * O SELETOR INTEIRO precisa ser a raiz do tema - `html.dark .shell { --shell-fill: … }` é uma variável de UM
+ * componente redefinida por tema, e essa continua sendo acusada (o corpus `css-global-custom-property`).
+ */
+function isTokenSelector(selector) {
+    const parts = selector.split(",").map((p) => p.trim());
+    return parts.length > 0 && parts.every((p) => TOKEN_SELECTOR_PART.test(p));
+}
+/**
+ * ONDE ESTÃO OS VALORES QUE ESTA LINHA ATRIBUI A UMA VARIÁVEL, dentro de um bloco de vocabulário - bateria, 28/09.
+ *
+ * A guarda de `scanCore` lia `--x:` só no COMEÇO da linha, e `:root { --q-stone: #44403c; ... }` numa linha só
+ * voltava como quatro "replace now" (b8). Trocar `#44403c` por `var(--q-stone)` na própria declaração faz o token
+ * apontar para si mesmo: o navegador descarta o valor e toda cor do app some. O seletor que governa cada
+ * declaração é o do último `{` antes dela na linha; sem `{` antes, vale o bloco multilinha em que a linha está.
+ */
+function declarationSpans(line, inBlock) {
+    const out = [];
+    for (const m of line.matchAll(DECLARES_ALL)) {
+        const start = m.index ?? 0;
+        const open = line.lastIndexOf("{", start + 1);
+        const governed = open < 0
+            ? inBlock
+            : line.lastIndexOf("}", start) < open &&
+                isTokenSelector(line.slice(line.lastIndexOf("}", open) + 1, open).trim());
+        if (!governed)
+            continue;
+        const colon = m[0].indexOf(":");
+        const valueAt = start + m[0].indexOf(m[2], colon);
+        out.push([valueAt, valueAt + m[2].length]);
+    }
+    return out;
+}
 /** `--color-ocean-500: #059aed;` - uma declaração de custom property no CSS dele. */
 /** Cada declaração `--x: valor;` da linha, quantas houver - ver o laço em `scanCore`. */
 const DECLARES_ALL = /(?:^|[\s{;])(--[a-z0-9-]+)\s*:\s*([^;{}]+);/gi;
@@ -558,7 +596,7 @@ function scanCore(file, source, table) {
         const indent = line ? raw.indexOf(line) : 0;
         const at = i + 1;
         const depthBefore = braceDepth;
-        const opensTokenBlock = /^(@theme\b|:root\b)/.test(line) && line.includes("{");
+        const opensTokenBlock = line.includes("{") && isTokenSelector(line.slice(0, line.indexOf("{")).trim());
         if (opensTokenBlock && tokenBlockDepth === 0)
             tokenBlockDepth = depthBefore + 1;
         const inTokenBlock = tokenBlockDepth > 0 && (opensTokenBlock || depthBefore >= tokenBlockDepth);
@@ -639,6 +677,8 @@ function scanCore(file, source, table) {
         // written by hand - flagging it would be telling someone to tokenize a
         // variable. And the same literal twice in one declaration (a two-stop
         // shadow) is one decision, so it is reported once.
+        const declared = declarationSpans(line, inTokenBlock && !opensTokenBlock);
+        const inDeclaration = (at) => declared.some(([a, b]) => at >= a && at < b);
         const spans = fallbackSpans(line, table);
         const inFallback = (at) => spans.some(([a, b]) => at >= a && at <= b);
         /** Ver `markupTextSpans`: HTML montado como texto sai do alcance da folha do app. */
@@ -653,6 +693,9 @@ function scanCore(file, source, table) {
         const push = (kind, literal, col = -1) => {
             if (literal.includes("$") || literal.includes("{"))
                 return;
+            /** A definição do token não é drift - ver `declarationSpans`. */
+            if (col >= 0 && inDeclaration(col))
+                return;
             if (col >= 0 && inFallback(col)) {
                 setAside("a token's own fallback");
                 return;

package/dist/fonts.js

@@ -1,5 +1,5 @@
 import { subsetsToEmit, weightsToEmit, } from "./next-font-weights.js";
-// Fallbacks genéricos do CSS - não são webfonts.
+// Fallbacks genéricos do CSS e as famílias de sistema - nenhuma delas é webfont para baixar.
 const GENERIC_FAMILIES = new Set([
     "sans-serif",
     "serif",
@@ -12,6 +12,24 @@ const GENERIC_FAMILIES = new Set([
     "fantasy",
     "inherit",
     "initial",
+    /**
+     * AS FAMÍLIAS QUE JÁ ESTÃO EM TODA MÁQUINA - bateria, 28/09. Georgia, Arial e Verdana não se baixam de lugar
+     * nenhum, e pedi-las ao Google Fonts gerava um `<link>` para o que ele não tem, logo abaixo da frase que dizia isso.
+     */
+    "arial",
+    "helvetica",
+    "helvetica neue",
+    "georgia",
+    "verdana",
+    "tahoma",
+    "trebuchet ms",
+    "times new roman",
+    "times",
+    "courier new",
+    "courier",
+    "segoe ui",
+    "-apple-system",
+    "blinkmacsystemfont",
 ]);
 /**
  * A PRIMEIRA FAMÍLIA DE UMA PILHA - `"Geist Mono", ui-monospace, monospace` é `Geist Mono`.

package/dist/install-marks.js

@@ -300,7 +300,11 @@
  * o sync destacado deixa para o fim do turno dizer (re-rodada depois do #1631). Uma pasta escrita antes deixaria esse
  * arquivo local entrar num commit.
  */
-export const MATERIALISER_SINCE = "0.16.472";
+/**
+ * 0.16.472 -> 0.16.473 em 28/09, e o passo 1 dá **SIM** (a bateria): as famílias de sistema (Georgia, Arial, Verdana)
+ * deixam de virar `<link>` do Google Fonts, e a webfont ao lado delas ganha o `fonts.ts` que antes não saía.
+ */
+export const MATERIALISER_SINCE = "0.16.473";
 /**
  * A ÚLTIMA VERSÃO EM QUE O QUE O HOOK RODA MUDOU.
  *
@@ -476,7 +480,17 @@ export const COUNTED_DIFFERENTLY = "this run counts a value as named only when Y
  * 0.16.471 -> 0.16.472 em 28/09, e o passo 1 dá **SIM**: o fim do turno entrega ao agente o que o sync destacado do turno
  * anterior mandou para o rascunho (re-rodada, f12). Um hook anterior deixa esses componentes entrarem calados.
  */
-export const CHECKER_SINCE = "0.16.472";
+/**
+ * 0.16.472 -> 0.16.473 em 28/09, e o passo 1 dá **SIM** (a bateria, b8): o hook deixa de acusar o valor que um
+ * `:root { --q-stone: #44403c; … }` de uma linha atribui ao token. Um hook anterior manda trocar a definição pelo
+ * próprio nome, e quem obedece apaga a cor.
+ */
+/**
+ * 0.16.473 -> 0.16.474 em 28/09, e o passo 1 dá **SIM** (a bateria, b5): o que o fim do turno diz de um componente novo
+ * passa a medir as regras da folha global que ele veste pelo `className`. Um hook anterior diz "no colour or spacing of
+ * its own to measure" sobre o componente de um projeto que estiliza por classe global.
+ */
+export const CHECKER_SINCE = "0.16.474";
 /**
  * A ÚLTIMA VERSÃO EM QUE OS LEITORES PASSARAM A PRODUZIR UM CENSO DIFERENTE.
  *
@@ -941,7 +955,12 @@ export const CHECKER_SINCE = "0.16.472";
  * não põe no sistema a peça do framework (`StrictMode`, `next/link`) nem a raiz do Vite (`src/App.tsx`); e o que
  * mora na pasta compartilhada de componentes nunca vira "feature". Um censo lido antes guardou tudo isso errado.
  */
-export const READER_SINCE = "0.16.471";
+/**
+ * 0.16.471 -> 0.16.473 em 28/09, e o passo 1 dá **SIM** (a bateria, b3, b5, b8): a varredura deixa de contar como valor à
+ * 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";
 /**
  * O QUE ESTÁ INSTALADO AQUI FICOU PARA TRÁS - e as DUAS condições que fazem isso ser verdade.
  *

package/dist/last-sync.js

@@ -45,6 +45,26 @@ components) {
     }
     return out;
 }
+/**
+ * A MARCA QUE O IMPORT DEIXA - o ponto de partida do primeiro `sync`. Bateria, 28/09 (b7): um projeto sem componente
+ * ganhou 16 ao longo de cinco telas e nenhum foi anunciado, porque só o `sync` gravava marca e `whatGrew` sem marca
+ * anterior não anuncia nada. Os mesmos campos que o `sync` grava, lidos do mesmo censo - nunca uma segunda conta.
+ * `components` é o que o censo admitiu, que é o que o import envia.
+ */
+export function importMark(census, cli) {
+    const sum = (r) => Object.values(r ?? {}).reduce((n, v) => n + v, 0);
+    const readings = fingerprintReadings(census.components);
+    return {
+        at: new Date().toISOString(),
+        components: Object.keys(readings).length,
+        declarations: census.coverage?.declarations ?? 0,
+        seen: sum(census.ledger?.counted),
+        interpreted: sum(census.ledger?.interpreted),
+        unread: Object.fromEntries((census.ledger?.unread ?? []).map((g) => [g.reason ?? "unknown", g.uses ?? 0])),
+        ...(cli ? { cli } : {}),
+        readings,
+    };
+}
 const path = (root) => join(root, "_synthesisui", LAST_SYNC_FILE);
 export async function readSyncMark(root) {
     try {

package/dist/not-expressed.js

@@ -1,3 +1,4 @@
+import { SKIP_LABEL } from "./doctor/component-gate.js";
 /**
  * O QUE ESTA LEITURA NÃO CONSEGUIU SEGURAR, escrito pela esteira e não pedido a ninguém.
  *
@@ -69,7 +70,9 @@ export function notExpressed(census) {
             " a reading to correct - and the reason below is the one to argue with.");
         out.push("");
         for (const s of skipped)
-            out.push(`    ${s.name}${s.file ? `  (${s.file})` : ""}\n        ${s.because}`);
+            out.push(
+            /** `because` é opcional; sem ele, o rótulo do `why` - nunca `undefined` (bateria, 28/09). */
+            `    ${s.name}${s.file ? `  (${s.file})` : ""}\n        ${s.because ?? SKIP_LABEL[s.why] ?? s.why}`);
     }
     out.push("");
     return `${out.join("\n")}\n`;

package/dist/what-grew.js

@@ -16,12 +16,16 @@ before) {
         return { born: [], gone };
     const { table } = await loadSystem(root).catch(() => ({ table: null }));
     const context = [];
+    /** As folhas GLOBAIS (não `.module.*`) - ver `globalRulesFor`. */
+    const globals = [];
     if (table) {
         for await (const file of walkAll([root])) {
             const rel = relative(root, file);
             if (!/\.(css|scss|sass|less)$/i.test(rel))
                 continue;
             const src = await readFile(file, "utf8").catch(() => "");
+            if (src && !/\.module\.[a-z]+$/i.test(rel))
+                globals.push({ rel, src });
             const report = src ? scanSource(rel, src, table) : null;
             if (report?.ownDeclared?.length)
                 context.push(report);
@@ -49,6 +53,17 @@ before) {
             if (css)
                 reports.push(scanSource(sheet, css, table));
         }
+        /**
+         * E AS REGRAS GLOBAIS QUE ELE VESTE - bateria, 28/09 (b5): o componente de um projeto que estiliza por classe global
+         * não importa folha nenhuma, e saía "no colour or spacing of its own to measure".
+         */
+        const worn = classesWorn(src);
+        if (worn.size > 0)
+            for (const g of globals) {
+                const rules = globalRulesFor(g.src, worn);
+                if (rules)
+                    reports.push(scanSource(g.rel, rules, table));
+            }
         const d = diagnose(reports, context);
         /** Classes utilitárias numa string qualquer do arquivo - `className="…"`, `cn("…")`, `cva("…")` (f11, 28/09). */
         const utilities = !d.reach.measured &&
@@ -117,3 +132,26 @@ export async function takeGrowthNote(root) {
         return null;
     }
 }
+/** As classes escritas por extenso no `className` - `className="a b"`, `'a'` ou `` `a b` `` sem interpolação. */
+function classesWorn(src) {
+    const out = new Set();
+    for (const m of src.matchAll(/className=(?:"([^"]*)"|'([^']*)'|\{`([^`$]*)`\})/g))
+        for (const c of (m[1] ?? m[2] ?? m[3] ?? "").split(/\s+/))
+            if (c)
+                out.add(c);
+    return out;
+}
+/**
+ * AS REGRAS DE UMA FOLHA GLOBAL CUJO SELETOR NOMEIA UMA DAS CLASSES QUE ELE VESTE, recortadas como CSS - só o bloco
+ * mais interno (`[^{}]`), então uma regra dentro de `@media` também entra. `null` quando nenhuma casa.
+ */
+function globalRulesFor(css, worn) {
+    const out = [];
+    for (const m of css.matchAll(/([^{}]+)\{([^{}]*)\}/g)) {
+        const selector = (m[1] ?? "").trim();
+        const names = [...selector.matchAll(/\.([A-Za-z_][\w-]*)/g)].map((x) => x[1]);
+        if (names.some((n) => worn.has(n)))
+            out.push(`${selector} { ${(m[2] ?? "").trim()} }`);
+    }
+    return out.length > 0 ? `${out.join("\n")}\n` : null;
+}

package/package.json

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