synthesisui 0.16.462 → 0.16.464

package/dist/changed-files.js

@@ -1,5 +1,5 @@
 import { execFile } from "node:child_process";
-import { stat } from "node:fs/promises";
+import { readdir, readFile, stat } from "node:fs/promises";
 import { join } from "node:path";
 import { promisify } from "node:util";
 const run = promisify(execFile);
@@ -25,8 +25,69 @@ async function listed(root) {
             if (line.trim())
                 out.push(line.trim());
     }
+    if (out.length === 0 && !(await isGitRepo(root)))
+        return walked(root);
     return [...new Set(out)];
 }
+/**
+ * FORA DO GIT, A PASTA É A LISTA - rodada 3 do refinamento, 27/09. O leigo-3 nasceu sem repositório, e
+ * as duas perguntas ao git voltavam vazias: o fim do turno não checava arquivo nenhum, nunca - o ledger
+ * sem uma linha `hook`, o envio com `count: 0`, o dashboard inteiro do agente sem checagem. Sem git, a
+ * resposta é andar pela pasta; o filtro pelo relógio do turno (em `changedSince`) continua valendo.
+ */
+const WALK_SKIP = new Set(["node_modules", ".next", "dist", "build", "out", "_synthesisui", "coverage"]);
+const WALK_MAX = 5000;
+async function isGitRepo(root) {
+    const { stdout } = await run("git", ["rev-parse", "--is-inside-work-tree"], { cwd: root }).catch(() => ({
+        stdout: "",
+    }));
+    return stdout.trim() === "true";
+}
+/**
+ * O `.gitignore` DA RAIZ, NA FORMA SIMPLES - rodada 4 do refinamento, 27/09. No leigo-4 (sem git) o fim
+ * do turno checou o `next-env.d.ts`, que o Next gera e que o `.gitignore` do `create-next-app` já exclui:
+ * sem git, ninguém lia aquele arquivo. Cobre nome, `/` na frente (só na raiz), `/` no fim (só pasta) e
+ * `*`; a negação (`!`) é ignorada - no pior caso um arquivo que ele quer checado fica de fora, como era
+ * antes do conserto de 27/09 para a pasta inteira.
+ */
+async function ignoredBy(root) {
+    const text = await readFile(join(root, ".gitignore"), "utf8").catch(() => "");
+    const rules = text
+        .split("\n")
+        .map((l) => l.trim())
+        .filter((l) => l && !l.startsWith("#") && !l.startsWith("!"))
+        .map((l) => {
+        const onlyDir = l.endsWith("/");
+        const body = l.replace(/^\//, "").replace(/\/$/, "");
+        const anchored = l.startsWith("/") || body.includes("/");
+        const glob = body.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, "[^/]*").replace(/\?/g, "[^/]");
+        return { onlyDir, re: new RegExp(anchored ? `^${glob}$` : `(^|/)${glob}$`) };
+    });
+    return (rel, dir) => rules.some((r) => (!r.onlyDir || dir) && r.re.test(rel));
+}
+async function walked(root) {
+    const out = [];
+    const ignored = await ignoredBy(root);
+    const go = async (rel) => {
+        if (out.length >= WALK_MAX)
+            return;
+        for (const entry of await readdir(join(root, rel), { withFileTypes: true }).catch(() => [])) {
+            if (entry.name.startsWith(".") || WALK_SKIP.has(entry.name))
+                continue;
+            const next = rel ? `${rel}/${entry.name}` : entry.name;
+            if (ignored(next, entry.isDirectory()))
+                continue;
+            if (entry.isDirectory())
+                await go(next);
+            else if (entry.isFile())
+                out.push(next);
+            if (out.length >= WALK_MAX)
+                return;
+        }
+    };
+    await go("");
+    return out;
+}
 /**
  * OS ARQUIVOS INTERESSANTES QUE MUDARAM DESDE `since`, do mais recente para o mais antigo.
  *

package/dist/commands/connect.js

@@ -1,3 +1,4 @@
+import { armTurnClock } from "./hook.js";
 import { mkdir, readdir, readFile, rm, writeFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
 import { codexPinBefore, exists, wireAgent } from "../agent-wiring.js";
@@ -477,6 +478,9 @@ export async function connect(opts) {
             ? say("✓ what the check records is sent to your dashboard at the end of each turn - your system changes only from a commit on a clean main")
             : say("· what the check records stays on this machine - run `npx synthesisui sync` to send it"));
     }
+    /** O relógio do turno nasce aqui - ver `armTurnClock`: o primeiro turno depois do `connect` é checado. */
+    if (want.hook && wired.hook !== "skipped")
+        await armTurnClock(root);
     if (want.hook && wired.hook !== "skipped") {
         row(wired.hook !== "already there", (() => {
             return wired.hook === "added"

package/dist/commands/hook.js

@@ -88,6 +88,17 @@ const startClock = (root) => writeFile(ledgerPath(root), "", { flag: "a" }).catc
 const TURN_CLOCK = "_synthesisui/.turn-clock";
 const turnClockOf = (root) => stat(join(root, TURN_CLOCK)).then((s) => s.mtimeMs, () => 0);
 const moveTurnClock = (root) => writeFile(join(root, TURN_CLOCK), "", "utf8").catch(() => { });
+/**
+ * O RELÓGIO NASCE NO `connect`, E NÃO NO PRIMEIRO TURNO - rodada 3 do refinamento, 27/09.
+ *
+ * Sem relógio, o primeiro fim de turno só o acertava e calava (ver `startClock`). Isso protegia o
+ * repositório com trabalho antigo em aberto, e cobrava um preço que ninguém tinha medido: num projeto
+ * NOVO o primeiro turno é o trabalho inteiro. O dashboard do leigo-3 - cinco arquivos - e as telas das
+ * rodadas 1 e 2 nunca foram checados: o `ledger.jsonl` tinha zero linhas `hook` e o envio marcava
+ * `count: 0`. Armado na instalação, o relógio deixa de fora o que veio antes do `connect` (a intenção
+ * de antes) e vê tudo o que veio depois. `flag: "wx"`: um relógio que já existe não recua.
+ */
+export const armTurnClock = (root) => writeFile(join(root, TURN_CLOCK), "", { encoding: "utf8", flag: "wx" }).catch(() => { });
 /**
  * QUANTOS ARQUIVOS UM COMANDO DE SHELL PODE FAZER O PRODUTO RELATAR DE UMA VEZ.
  *

package/dist/component-codegen.js

@@ -611,8 +611,11 @@ export class ThemeVocab extends Set {
      * O nome que casa vale se o valor também casa - ou se um dos dois lados não tem valor conhecido, que
      * é o comportamento de antes. Sem nome que case, o VALOR acha o nome, mas só quando exatamente uma
      * variável dele o segura: duas seria adivinhar qual das duas ele quis dizer.
+     *
+     * `prefer` desempata, e só ele: quando o empate inclui a palavra da própria propriedade (`border`
+     * numa declaração de borda), é esse o nome. Sem ela no empate, continua sem adivinhar (rodada 4).
      */
-    nameFor(ref, ns, byName) {
+    nameFor(ref, ns, byName, prefer = null) {
         const path = /^\{([^}]+)\}$/.exec(ref.trim())?.[1];
         const want = path ? this.dsValues.get(`--ds-${path.replace(/\./g, "-")}`) : undefined;
         if (byName && this.has(`--${ns}-${byName}`)) {
@@ -625,17 +628,55 @@ export class ThemeVocab extends Set {
         const hits = [...this.theirValues]
             .filter(([n, v]) => n.startsWith(`--${ns}-`) && sameValue(v, want))
             .map(([n]) => n.slice(ns.length + 3));
-        return hits.length === 1 ? hits[0] : null;
+        if (hits.length === 1)
+            return hits[0];
+        return prefer && hits.includes(prefer) ? prefer : null;
     }
 }
 const sameValue = (a, b) => a.trim().toLowerCase().replace(/\s+/g, " ") === b.trim().toLowerCase().replace(/\s+/g, " ");
 /** A chave de cor que ele escreve: pelo `ThemeVocab` quando há valores, pelo nome quando não. */
-const theirColorKey = (value, themeVars) => {
-    const key = colorKey(value);
+/**
+ * O DEGRAU DA PALETA PELO NOME - `{color.coral.700}` -> `coral-700` - rodada 3 do refinamento, 27/09.
+ *
+ * O badge do Zephyr pede degraus (`{color.coral.700}`, `{color.teal.700}`…), o projeto do leigo-3 declara
+ * `--color-coral-700` com o mesmo valor, e o badge saía com `#c2410c` cru: pelo nome só os papéis
+ * semânticos eram traduzidos, e pelo valor só quando UMA variável segura aquele valor - ali duas seguravam.
+ * Só vale pelo `ThemeVocab`, que confere o valor.
+ */
+const paletteKey = (v) => {
+    const m = /^\{color\.([a-z0-9-]+)\.([a-z0-9-]+)\}$/.exec(v.trim());
+    if (!m || m[1] === "semantic" || m[1] === "series")
+        return null;
+    return `${m[1]}-${m[2]}`;
+};
+const theirColorKey = (value, themeVars, prefer = null) => {
+    const key = colorKey(value) ?? (themeVars instanceof ThemeVocab ? paletteKey(value) : null);
     if (themeVars instanceof ThemeVocab)
-        return themeVars.nameFor(value, "color", key);
+        return themeVars.nameFor(value, "color", key, prefer);
     return key && minted(themeVars, `--color-${key}`) ? key : null;
 };
+/** A palavra da propriedade que desempata dois nomes dele com o mesmo valor - ver `nameFor`. */
+const preferFor = (prop) => (prop.startsWith("border") ? "border" : null);
+/**
+ * AS CORES DE DENTRO DE UM VALOR COMPOSTO, NO NOME DELE - rodada 4 do refinamento, 27/09.
+ *
+ * O gradiente do botão do Gossamer (`linear-gradient(135deg, {color.semantic.accent}, …)`) não tem
+ * utilitário e ia inteiro para o arbitrário, onde a cor só achava o nome dele depois de um build: num
+ * Next novo saía `#eaa83c` com `--color-accent` declarado. Cada referência de cor é resolvida aqui pela
+ * mesma regra do utilitário (`theirColorKey`, que não precisa de build) e vira `var(--color-<nome>)`; a
+ * que não tem nome segue para a porta de tradução, que escreve o valor.
+ *
+ * `null` é "ninguém mediu", e aí nada é trocado: escrever `var(--color-x)` sem saber se ele declara
+ * seria uma cor que some.
+ */
+const namedInside = (prop, value, themeVars) => {
+    if (themeVars === null)
+        return value;
+    return value.replace(/\{color\.[a-zA-Z0-9.-]+\}/g, (ref) => {
+        const key = theirColorKey(ref, themeVars, preferFor(prop));
+        return key ? `var(--color-${key})` : ref;
+    });
+};
 /** One declaration → Tailwind classes (pretty when mappable, arbitrary-property
  *  otherwise - never dropped). */
 function declToTailwind(prop, value, themeVars) {
@@ -658,7 +699,7 @@ function declToTailwind(prop, value, themeVars) {
             break;
         }
         case "borderColor": {
-            const key = theirColorKey(value, themeVars);
+            const key = theirColorKey(value, themeVars, "border");
             if (key)
                 return [`border-${key}`];
             break;
@@ -667,7 +708,7 @@ function declToTailwind(prop, value, themeVars) {
             // "1px solid {color.semantic.x}" → border + border-<x>
             const m = value.match(/^1px\s+solid\s+(\{[^}]+\})$/);
             if (m) {
-                const key = theirColorKey(m[1], themeVars);
+                const key = theirColorKey(m[1], themeVars, "border");
                 if (key)
                     return ["border", `border-${key}`];
             }
@@ -753,7 +794,7 @@ function declToTailwind(prop, value, themeVars) {
             break;
         }
     }
-    return [arbitrary(prop, value)];
+    return [arbitrary(prop, namedInside(prop, value, themeVars))];
 }
 /**
  * TAILWIND'S OWN WORD FOR A STATE, WHEN IT HAS ONE - and a mechanical rule when it

package/dist/guarantee.js

@@ -1,5 +1,5 @@
-import { readFile, writeFile } from "node:fs/promises";
-import { join } from "node:path";
+import { readFile, stat, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
 import { hasHook } from "./agent-wiring.js";
 import { ungovernedIn } from "./governed.js";
 /**
@@ -104,7 +104,14 @@ system) {
      * invisível: um arquivo novo nunca apagou nada, então a checagem cala com razão e a pessoa lê
      * esse silêncio como aprovação.
      */
-    lines.push(plain("What a file no longer has is measured against your last commit. A file git has never seen has no before, so nothing is reported as removed there."));
+    /**
+     * SEM GIT, A METADE DO "ANTES" NÃO EXISTE - rodada 3 do refinamento, 27/09. O leigo-3 nasceu sem
+     * repositório (o `create-next-app` dele não criou um), e a frase de baixo falava de "your last commit"
+     * numa pasta que não tem commit nenhum. Dizer é o que transforma o silêncio em um passo.
+     */
+    lines.push(plain((await inGitRepo(root))
+        ? "What a file no longer has is measured against your last commit. A file git has never seen has no before, so nothing is reported as removed there."
+        : "This folder is not in a git repository, so nothing can be measured against a last commit - what a file lost goes unseen. `git init` and a first commit turn that on."));
     lines.push(system.utilities.size > 0
         ? {
             text: "A value counts as coming from your system in two spellings: `var(--token)`, and the {n} utility names your own theme generates - `bg-primary`, `p-6`, `rounded-lg`.",
@@ -169,3 +176,16 @@ export async function guaranteeIfNew(root, system) {
     await writeFile(join(root, SAID), `${answer.fingerprint}\n`, "utf8").catch(() => { });
     return answer.lines;
 }
+/** Esta pasta, ou uma acima dela, tem `.git`? - um monorepo tem o `.git` na raiz, não no app. */
+async function inGitRepo(root) {
+    let at = root;
+    for (let i = 0; i < 40; i += 1) {
+        if (await stat(join(at, ".git")).then(() => true, () => false))
+            return true;
+        const up = dirname(at);
+        if (up === at)
+            return false;
+        at = up;
+    }
+    return false;
+}

package/dist/install-marks.js

@@ -264,7 +264,18 @@
  * animação, e os componentes com `as` passam a ter o tipo genérico - rodada 1 do refinamento. Uma pasta
  * escrita antes ensina o agente a colar uma fonte que não carrega.
  */
-export const MATERIALISER_SINCE = "0.16.462";
+/**
+ * 0.16.462 -> 0.16.463 em 27/09, e o passo 1 dá **SIM**: o gerador que o `upgrade` usa passa a achar pelo
+ * nome os degraus da paleta que o projeto declara (`{color.coral.700}` -> `bg-coral-700`) - o badge do
+ * Zephyr saía com quatro cores cruas (rodada 3 do refinamento).
+ */
+/**
+ * 0.16.463 -> 0.16.464 em 27/09, e o passo 1 dá **SIM**: o gerador que o `upgrade` usa passa a achar o nome
+ * dele dentro de um valor composto - o gradiente do botão do Gossamer saía `#eaa83c, #dd4161` com
+ * `--color-accent` e `--color-primary` declarados - e a desempatar pela palavra da propriedade numa borda
+ * (rodada 4 do refinamento).
+ */
+export const MATERIALISER_SINCE = "0.16.464";
 /**
  * A ÚLTIMA VERSÃO EM QUE O QUE O HOOK RODA MUDOU.
  *
@@ -420,7 +431,13 @@ export const COUNTED_DIFFERENTLY = "this run counts a value as named only when Y
  * hand" no `@theme` que o leigo copiou do GUIDE). Um hook fixado antes continua acusando o vocabulário do
  * projeto como valor à mão, em todo turno.
  */
-export const CHECKER_SINCE = "0.16.458";
+/**
+ * 0.16.458 -> 0.16.463 em 27/09, e o passo 1 dá **SIM**: o fim do turno passa a checar o primeiro turno
+ * depois do `connect` (o relógio nasce na instalação) e a enxergar os arquivos de uma pasta sem git -
+ * rodada 3 do refinamento: o dashboard do leigo-3 inteiro nunca foi checado. Um hook anterior segue calado
+ * nos dois casos.
+ */
+export const CHECKER_SINCE = "0.16.463";
 /**
  * A ÚLTIMA VERSÃO EM QUE OS LEITORES PASSARAM A PRODUZIR UM CENSO DIFERENTE.
  *

package/dist/registry.js

@@ -53,7 +53,13 @@ export async function fetchDesignSystem(base, slug, version) {
         url.searchParams.set("version", String(version));
     const res = await request(url.toString());
     if (res.status === 404) {
-        throw new RegistryError(`No design system published with slug "${slug}"${version != null ? ` at version v${version}` : ""}. Run \`synthesisui list\` to see what's available.`);
+        throw new RegistryError(
+        /**
+         * A CONTA É A PRIMEIRA SUSPEITA - rodada 3 do refinamento, 27/09. O fork `zephyr` do dono estava na
+         * conta do navegador, e o terminal, logado em outra: o registry só entrega um sistema que não é
+         * público à conta dona, e a frase dizia "no design system published". Ele parou ali.
+         */
+        `No design system "${slug}"${version != null ? ` at version v${version}` : ""} that this machine can see. If it is a system in your account, this machine may be signed in to another one - run \`npx synthesisui@latest login\` with the account that owns it. Otherwise, \`synthesisui list\` shows what is public.`);
     }
     if (!res.ok) {
         throw new RegistryError(`Registry responded ${res.status} while fetching "${slug}".`);

package/package.json

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