synthesisui 0.16.471 → 0.16.473

package/dist/commands/add.js

@@ -48,6 +48,8 @@ const IGNORED = [
     ".ledger-sent",
     /** O que a última medição viu, para a próxima dizer o que mudou - descreve ESTE clone. */
     ".last-sync.json",
+    /** O que o sync destacado mandou, esperando o fim do turno seguinte dizer - ver `what-grew.ts` (28/09). */
+    ".last-growth.json",
     "not-expressed.md",
     /**
      * O RELATÓRIO QUE O `inspect` ESCREVE - a leitura inteira com forma, para ele abrir no navegador.

package/dist/commands/hook.js

@@ -11,6 +11,7 @@ import { governs, ungovernedIn } from "../governed.js";
 import { readMode } from "../mode.js";
 import { namesRemoved, previousText, rulesTouchedBy, } from "../rule-touched.js";
 import { loadSystem } from "./doctor.js";
+import { takeGrowthNote } from "../what-grew.js";
 const pass = () => ({ continue: true });
 const speak = (context) => ({
     continue: true,
@@ -664,6 +665,10 @@ async function endOfTurn(root, input) {
     const { said } = changed.length > 0
         ? await checkChanged(root, changed, mode, "turn")
         : { said: [] };
+    /** O que o sync destacado do turno anterior mandou para o rascunho - dito uma vez (re-rodada, 28/09). */
+    const grown = await takeGrowthNote(root).catch(() => null);
+    if (grown)
+        said.push(grown);
     await moveTurnClock(root);
     out(said.length === 0
         ? pass()

package/dist/commands/import.js

@@ -4648,6 +4648,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();
     /**
@@ -4983,8 +4993,10 @@ export async function runImport(opts) {
         census.scheme = scheme;
     if (!scheme && mustNotGuessPolarity(census)) {
         console.log("");
-        console.log(body("Your stylesheet does not say which face this project opens in, and nothing here declares a light or a dark scheme on its own. Nothing was guessed: the measurement is complete and the default stays yours to pick."));
-        console.log(body(`Name it with ${paint.strong("--scheme dark")} or ${paint.strong("--scheme light")}, or answer the question this command asks at a terminal.`));
+        console.log(body(
+        /** Desde a "(b)" do dono (28/09): as cores entram como a face única, e a escolha é um clique na tela. */
+        "Your stylesheet does not say which face this project opens in, and nothing here declares a light or a dark scheme on its own. Nothing was guessed: your colours came in as the system's one face."));
+        console.log(body(`Next, if you like: say light or dark on the system's page - one click - or run this with ${paint.strong("--scheme dark")} or ${paint.strong("--scheme light")}.`));
     }
     // The file on disk has to say what we sent, or the next person to read it is
     // reading a different import than the one that happened.
@@ -5139,7 +5151,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.
      *

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/commands/sync.js

@@ -13,7 +13,7 @@ import { measuredScope, rememberScope } from "../measured-scope.js";
 import { fromCensus } from "../memory/observation.js";
 import { reportMeasurement } from "../memory/report.js";
 import { mergeCensus } from "../merge-census.js";
-import { describeGrowth, whatGrew } from "../what-grew.js";
+import { describeGrowth, recordGrowthForTurn, whatGrew } from "../what-grew.js";
 import { body, paint, section, snippet } from "../output.js";
 import { repoStateOf } from "../repo-state.js";
 import { reportWhatIsLeft } from "./align.js";
@@ -617,6 +617,9 @@ export async function remeasure(args) {
             console.log(section("What your code grew"));
             for (const l of growth)
                 console.log(body(l));
+            /** Sem terminal (o fim do turno), a lista fica para o turno seguinte dizer - ver `recordGrowthForTurn`. */
+            if (!process.stdin.isTTY || !process.stdout.isTTY)
+                await recordGrowthForTurn(root, growth);
             if (!(await askToSendGrowth())) {
                 console.log(body("Nothing was sent. Your draft is untouched - run `npx synthesisui sync` again when you want them in."));
                 return null;

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

@@ -295,7 +295,16 @@
  * escrita como a função dele (`color("brand")`), nunca `$semantic-brand` (rodada 14 do refinamento). Um
  * componente escrito antes num projeto desses está sem estilo.
  */
-export const MATERIALISER_SINCE = "0.16.471";
+/**
+ * 0.16.471 -> 0.16.472 em 28/09, e o passo 1 dá **SIM**: o `.gitignore` da pasta passa a cobrir `.last-growth.json`, o que
+ * 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.
+ */
+/**
+ * 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.
  *
@@ -467,7 +476,16 @@ export const COUNTED_DIFFERENTLY = "this run counts a value as named only when Y
  * (`$palette`, `color("brand")`) - rodada 14 do refinamento. Um hook anterior acusa como valor à mão toda cor
  * que o projeto guarda num mapa.
  */
-export const CHECKER_SINCE = "0.16.471";
+/**
+ * 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.
+ */
+/**
+ * 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.
+ */
+export const CHECKER_SINCE = "0.16.473";
 /**
  * A ÚLTIMA VERSÃO EM QUE OS LEITORES PASSARAM A PRODUZIR UM CENSO DIFERENTE.
  *
@@ -932,7 +950,12 @@ export const CHECKER_SINCE = "0.16.471";
  * 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/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

@@ -1,5 +1,6 @@
 import { readFile } from "node:fs/promises";
-import { join, relative } from "node:path";
+import { dirname, join, relative } from "node:path";
+import { readStyleSheet } from "./doctor/scss-lens.js";
 import { loadSystem, walkAll } from "./commands/doctor.js";
 import { diagnose, scanSource } from "./doctor/scan.js";
 export async function whatGrew(root, census, 
@@ -26,6 +27,9 @@ before) {
                 context.push(report);
         }
     }
+    /** Os componentes dele que um arquivo monta, cada um uma vez - fora ele mesmo. */
+    const own = new Set(now.filter((c) => typeof c.api?.file === "string").map((c) => c.name));
+    const composed = (src, self) => new Set([...src.matchAll(/<([A-Z][A-Za-z0-9]*)\b/g)].map((m) => m[1]).filter((n) => n !== self && own.has(n))).size;
     const born = [];
     for (const c of fresh) {
         const file = c.api?.file;
@@ -34,13 +38,29 @@ before) {
             born.push({ name: c.name, file, fromSystem: 0, of: 0, byHand: [] });
             continue;
         }
-        const d = diagnose([scanSource(file, src, table)], context);
+        /**
+         * E A FOLHA QUE ELE IMPORTA - relato 15, 28/09: "Landing - no colour or spacing of its own to measure", com os
+         * valores no `Landing.module.css` ao lado. O componente é o `.tsx` MAIS o estilo que ele puxa.
+         */
+        const reports = [scanSource(file, src, table)];
+        for (const m of src.matchAll(/^\s*import\s+(?:[\w{}\s,*]+\s+from\s+)?["'](\.{1,2}\/[^"']+\.(?:css|scss|sass|less))["']/gm)) {
+            const sheet = join(dirname(file), m[1]);
+            const css = await readStyleSheet(join(root, sheet)).catch(() => "");
+            if (css)
+                reports.push(scanSource(sheet, css, 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 &&
+            /["'`][^"'`\n]*(?<![\w-])(bg|text|border|p[xytrbl]?|m[xytrbl]?|gap|rounded|shadow)-[a-z0-9][^"'`\n]*["'`]/.test(src);
         born.push({
             name: c.name,
             file,
             fromSystem: d.reach.measured ? d.reach.uses : 0,
             of: d.reach.measured ? d.reach.of : 0,
             byHand: [...new Set(d.findings.map((f) => f.literal))],
+            ...(utilities ? { utilities: true } : {}),
+            ...(composed(src, c.name) >= 3 ? { composes: composed(src, c.name) } : {}),
         });
     }
     return { born, gone };
@@ -50,9 +70,50 @@ export function describeGrowth(grown) {
     const out = [];
     for (const b of grown.born)
         out.push(b.of === 0
-            ? `${b.name} (${b.file}) - no colour or spacing of its own to measure`
+            ? b.utilities
+                ? `${b.name} (${b.file}) - styled with utility classes; \`npx synthesisui doctor\` measures those`
+                : `${b.name} (${b.file}) - no colour or spacing of its own to measure`
             : `${b.name} (${b.file}) - ${b.fromSystem} of ${b.of} values from your system${b.byHand.length > 0 ? `; by hand: ${b.byHand.slice(0, 4).join(", ")}${b.byHand.length > 4 ? ", …" : ""}` : ""}`);
+    /** A tela que mora na pasta de componentes: a linha pergunta, e quem responde decide. */
+    for (const [i, b] of grown.born.entries())
+        if (b.composes)
+            out[i] = `${out[i]} - it composes ${b.composes} of your components - a screen?`;
     for (const g of grown.gone)
         out.push(`${g} is no longer in your code - it leaves the draft with this send`);
     return out;
 }
+/**
+ * O QUE O SYNC DESTACADO MANDOU, PARA O FIM DO TURNO SEGUINTE DIZER - re-rodada, f12 (28/09).
+ *
+ * Pelo agente, o `sync` roda destacado do fim do turno (`auto-sync.ts`), com a saída descartada: o bloco "What your
+ * code grew" não chegava a ninguém, e o componente entrava no rascunho calado - o contrário da decisão do dono. A
+ * lista fica ao lado, e o fim do turno seguinte a entrega ao agente UMA vez, para ele contar à pessoa.
+ */
+const GROWTH_FILE = ".last-growth.json";
+export async function recordGrowthForTurn(root, lines) {
+    if (lines.length === 0)
+        return;
+    const { writeFile } = await import("node:fs/promises");
+    await writeFile(join(root, "_synthesisui", GROWTH_FILE), JSON.stringify({ at: new Date().toISOString(), lines }), "utf8").catch(() => { });
+}
+export async function takeGrowthNote(root) {
+    const { rm } = await import("node:fs/promises");
+    const path = join(root, "_synthesisui", GROWTH_FILE);
+    const raw = await readFile(path, "utf8").catch(() => null);
+    if (raw == null)
+        return null;
+    await rm(path, { force: true }).catch(() => { });
+    try {
+        const { lines } = JSON.parse(raw);
+        if (!lines?.length)
+            return null;
+        return [
+            "The last sync sent to your system's draft (the person has not seen this yet - tell the person, in one line each):",
+            ...lines.map((l) => `  ${l}`),
+            "Each one can stay out of the system on its page before the draft is published.",
+        ].join("\n");
+    }
+    catch {
+        return null;
+    }
+}

package/package.json

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