synthesisui 0.16.295 → 0.16.296

package/dist/commands/import.js

@@ -47,6 +47,7 @@ import { body, paint, section } from "../output.js";
 import { outsideScope } from "../outside-scope.js";
 import { phase, startProgress } from "../progress.js";
 import { repoStateOf } from "../repo-state.js";
+import { runtimeDeclaredVars } from "../runtime-vars.js";
 import { detectStack, resolveDeps, stackVersions } from "../stack.js";
 import { placeInWorkspace } from "../workspace-place.js";
 import { add } from "./add.js";
@@ -1934,6 +1935,16 @@ export async function takeCensus(root, opts) {
     for (const m of css.matchAll(/(--[a-zA-Z0-9_-]+)\s*:/g)) {
         declaredNames.add(m[1]);
     }
+    /**
+     * E O QUE ELE DECLARA FORA DO CSS - ver `runtimeDeclaredVars`.
+     *
+     * `next/font` gera a variável em tempo de execução, então uma varredura de folhas `.css` não a
+     * enxerga e o relatório acusava as quatro fontes do repositório dele de "não resolvem para nada".
+     * Medido em 24/08: 4 das 6 variáveis reportadas como mortas estavam vivas, e o agente teve que se
+     * desdizer na frente do cliente.
+     */
+    for (const name of runtimeDeclaredVars(sources))
+        declaredNames.add(name);
     /**
      * HOW SOMEBODY CALLS THE COMPONENT THEY ALREADY HAVE.
      *

package/dist/runtime-vars.js

@@ -0,0 +1,49 @@
+/**
+ * AS VARIÁVEIS QUE O CÓDIGO DELE DECLARA FORA DO CSS - e sem elas a plataforma acusa o repositório
+ * dele de um defeito que não existe.
+ *
+ * O QUE O CLIENTE VIA, medido numa corrida real em 24/08 contra o `codelevel`:
+ *
+ *     "6 var() que não resolvem para nada: --font-ds-display, --font-ds-body,
+ *      --font-ds-mono, --font-ds-serif, --ring-circ, --ring-target"
+ *
+ * Quatro das seis resolvem. Elas são declaradas por `next/font`, que gera a variável em tempo de
+ * execução e a injeta pelo `className` - o inventário de declarações lia só folhas `.css`, então
+ * para ele aquilo não existia. O agente teve que se desdizer na frente do cliente no MESMO
+ * fechamento, e uma afirmação errada custa mais confiança que a lacuna que ela tentava reportar.
+ *
+ * O ALCANCE, medido no mesmo repositório: 27 arquivos usam `next/font`, declarando 8 variáveis.
+ * Não é caso de borda - é a forma recomendada de carregar fonte em Next, e o nosso próprio
+ * `fonts.ts` a ESCREVE para o cliente. Sabíamos escrever a forma e não sabíamos lê-la.
+ *
+ * POR QUE O IMPORT PRECISA DO ARQUIVO, e não só do padrão: `variable: "--x"` é texto comum o
+ * bastante para aparecer em CSS-in-JS e em objetos de configuração de qualquer biblioteca. Contar
+ * aquilo como declaração em todo lugar trocaria um falso positivo por um falso negativo - a
+ * plataforma deixaria de avisar sobre uma variável genuinamente morta. Então a regra é a origem, e
+ * não o nome: só vale num arquivo que importa de `next/font`, que é o pacote cujo contrato promete
+ * a declaração.
+ */
+/** Um arquivo importa de `next/font`? É a origem que autoriza a leitura abaixo. */
+const IMPORTS_NEXT_FONT = /from\s+["']next\/font(?:\/[a-z]+)?["']/;
+/**
+ * O CAMPO DO CONTRATO. `next/font` aceita `variable` em `Inter({...})` e em `localFont({...})`, e nos
+ * dois casos a promessa é a mesma: a classe devolvida declara essa variável no elemento.
+ */
+const VARIABLE_FIELD = /\bvariable\s*:\s*["'](--[a-zA-Z0-9_-]+)["']/g;
+/**
+ * Os nomes que os arquivos dele declaram em tempo de execução, e que nenhuma folha `.css` carrega.
+ *
+ * Devolve um `Set` porque é assim que o inventário de declarações do import é consultado - a
+ * intenção é somar a ele, nunca substituí-lo: uma variável pode ser declarada nos dois lugares, e
+ * duas fontes que concordam não são um conflito.
+ */
+export function runtimeDeclaredVars(sources) {
+    const out = new Set();
+    for (const { source } of sources) {
+        if (!IMPORTS_NEXT_FONT.test(source))
+            continue;
+        for (const m of source.matchAll(VARIABLE_FIELD))
+            out.add(m[1]);
+    }
+    return out;
+}

package/package.json

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