synthesisui 0.16.461 → 0.16.463

package/dist/changed-files.js

@@ -1,5 +1,5 @@
 import { execFile } from "node:child_process";
-import { stat } from "node:fs/promises";
+import { readdir, stat } from "node:fs/promises";
 import { join } from "node:path";
 import { promisify } from "node:util";
 const run = promisify(execFile);
@@ -25,8 +25,44 @@ 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";
+}
+async function walked(root) {
+    const out = [];
+    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 (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/add.js

@@ -199,7 +199,9 @@ export async function add(slug, opts) {
      * Falha calada de propósito: um repositório sem folha de estilo, ou sem build, devolve o que veio
      * do servidor. A folha nunca fica pior do que estava.
      */
-    const theirVars = await pointTokensAtTheirNames(projectRoot, payload);
+    const theirVars = await pointTokensAtTheirNames(projectRoot, payload, 
+    /** O que um build anterior provou - ver `provenBefore`. Sem build aqui, é a melhor prova que há. */
+    (prev?.tokenMap ?? []).map((p) => p.theirs));
     /**
      * O `theme.css` ALINHA ONDE HÁ O QUE ALINHAR - ver `onlyWhatMatched`.
      *
@@ -619,6 +621,12 @@ export async function add(slug, opts) {
      */
     if (theirVars.cycles > 0)
         console.log(`  ${theirVars.cycles} ${theirVars.cycles === 1 ? "value" : "values"} already had the bridge pointing the other way, so ${theirVars.cycles === 1 ? "it was" : "they were"} left alone - your own utility still resolves through this system, and pointing back would have cancelled both.`);
+    /**
+     * SEM BUILD, A TELA DIZ DE ONDE VEIO A PROVA - 27/09. Antes, o mapa sumia e a única pista era "0
+     * Tailwind utilities now point at your own decisions"; o dono passou uma tarde sem saber por quê.
+     */
+    if (theirVars.provedBy === "before")
+        console.log(`  No build found here (no CSS in .next, dist, build or out), so the ${theirVars.pairs.length} name${theirVars.pairs.length === 1 ? "" : "s"} an earlier build proved ${theirVars.pairs.length === 1 ? "was" : "were"} kept. Run your build and \`connect\` again to prove them on this machine.`);
     if (theirVars.pointed > 0)
         console.log(`  ${theirVars.pointed} value${theirVars.pointed === 1 ? "" : "s"} in tokens.css now point at the name YOUR code already gives ${theirVars.pointed === 1 ? "it" : "them"} - change yours and the system follows${theirVars.pruned > 0 ? `; ${theirVars.pruned} matched but your build does not emit ${theirVars.pruned === 1 ? "that name" : "those names"}, so ${theirVars.pruned === 1 ? "it keeps" : "they keep"} the value` : ""}`);
     /**

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

@@ -367,12 +367,30 @@ function propsType(axes, tag, base, withAs = false) {
     const extras = axes.map((a) => a.boolean
         ? `  ${a.prop}?: boolean;`
         : `  ${a.prop}?: ${a.options.map((o) => `"${o}"`).join(" | ")};`);
-    if (withAs)
-        extras.push("  /** Render as a different element (th, dt, h2, li…) - the recipe is", "   *  styling only, so the document's semantics stay yours. */", "  as?: ElementType;");
+    /**
+     * COM `as`, AS PROPS SEGUEM O ELEMENTO ESCOLHIDO - rodada 1 do refinamento, 27/09.
+     *
+     * O tipo era `ComponentProps<"button"> & { as?: ElementType }`: aceitava `as={Link}` e recusava o
+     * `href` que o `Link` exige - o `npm run build` do leigo quebrou em "Property 'href' does not exist",
+     * e ele contornou com `{...{ href }}`. Genérico no elemento, com o padrão sendo a tag da receita: sem
+     * `as`, nada muda para quem chama.
+     */
+    if (withAs) {
+        extras.push("  /** Render as a different element (th, dt, h2, li, a Link…) - the recipe is", "   *  styling only, so the document's semantics stay yours, and the props follow it. */", "  as?: T;");
+        /**
+         * SOBREPOSIÇÃO, e não troca: o tipo da tag da receita continua escrito por inteiro, e o elemento
+         * escolhido só ACRESCENTA o que ele tem a mais (o `href` do `Link`). Sem `as`, o `Omit` é vazio e o
+         * tipo é o de antes - e quem lê a raiz no texto (`ComponentProps<"button">`) continua lendo.
+         */
+        const own = ["as", ...axes.map((a) => a.prop)].map((k) => `"${k}"`).join(" | ");
+        return `${base}<"${tag}"> & Omit<${base}<T>, keyof ${base}<"${tag}"> | ${own}> & {\n${extras.join("\n")}\n}`;
+    }
     if (extras.length === 0)
         return `${base}<"${tag}">`;
     return `${base}<"${tag}"> & {\n${extras.join("\n")}\n}`;
 }
+/** O parâmetro de tipo que acompanha `propsType(..., withAs)` - vazio quando não há `as`. */
+const asGeneric = (tag, withAs) => withAs ? `<T extends ElementType = "${tag}">` : "";
 /**
  * THE ELEMENT IS THE CALLER'S DECISION (1kro2o, 29/07).
  *
@@ -385,7 +403,7 @@ function propsType(axes, tag, base, withAs = false) {
  * offered takes the same attributes in practice - the pattern is the exact
  * one the field agent wrote by hand.
  */
-const asTagLine = (tag) => `  const Tag = (as ?? "${tag}") as "${tag}";`;
+const asTagLine = (tag) => `  const Tag = (as ?? "${tag}") as ElementType;`;
 /** The render pieces for an element that offers `as`. `type="button"` must
  *  follow the RENDERED tag - a Button rendered as an <a> with type="button"
  *  is invalid HTML wearing a straight face. Void elements never offer `as`:
@@ -612,8 +630,22 @@ export class ThemeVocab extends Set {
 }
 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. */
+/**
+ * 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) => {
-    const key = colorKey(value);
+    const key = colorKey(value) ?? (themeVars instanceof ThemeVocab ? paletteKey(value) : null);
     if (themeVars instanceof ThemeVocab)
         return themeVars.nameFor(value, "color", key);
     return key && minted(themeVars, `--color-${key}`) ? key : null;
@@ -1324,7 +1356,7 @@ localName = name) {
         ].join(", ");
         return `
 /** Part "${partName}" of ${comp}${formOf.get(partName) ? ` (${formOf.get(partName)})` : ""} - compose it inside <${comp}>. */
-export function ${partComp}({ ${partDestructure} }: ${propsType(partAxes, partTag, props, partEl.offersAs)}) {
+export function ${partComp}${asGeneric(partTag, partEl.offersAs)}({ ${partDestructure} }: ${propsType(partAxes, partTag, props, partEl.offersAs)}) {
 ${partEl.setup}  return (
     <${partEl.jsxTag}${partEl.jsxAttrs}
       className={${joinCls([`"${partClassName(name, partName, convention)}"`, "className"])}}
@@ -1339,10 +1371,10 @@ import "./${localName}.css";
 
 import type { ${needsElementType ? `ElementType, ${props}` : props} } from "react";
 
-type ${comp}Props = ${propsType(axes, tag, props, el.offersAs)};
+type ${comp}Props${asGeneric(tag, el.offersAs)} = ${propsType(axes, tag, props, el.offersAs)};
 
 ${compositionHint(comp, name, recipe, voidEl)}
-export function ${comp}({ ${destructure} }: ${comp}Props) {
+export function ${comp}${asGeneric(tag, el.offersAs)}({ ${destructure} }: ${comp}Props${el.offersAs ? "<T>" : ""}) {
 ${el.setup}  return (
 ${rootJsx}
   );
@@ -1454,10 +1486,10 @@ import { cn } from "../cn";
 const BASE = ${JSON.stringify([needsGroup ? "group" : "", tailwindClassList(recipe, resolved, themeVars, excluded)].filter(Boolean).join(" "))};
 ${[...variantConsts, ...booleanConsts].join("\n")}
 
-type ${comp}Props = ${propsType(axes, tag, props, el.offersAs)};
+type ${comp}Props${asGeneric(tag, el.offersAs)} = ${propsType(axes, tag, props, el.offersAs)};
 
 ${compositionHint(comp, name, recipe, voidEl)}
-export function ${comp}({ ${destructure} }: ${comp}Props) {
+export function ${comp}${asGeneric(tag, el.offersAs)}({ ${destructure} }: ${comp}Props${el.offersAs ? "<T>" : ""}) {
 ${el.setup}  return (
 ${hasShape
         ? `${rootOpen}  {...props}
@@ -1525,7 +1557,7 @@ ${orderedParts
         ].join(", ");
         return `
 /** Part "${partName}" of ${comp}${formOf.get(partName) ? ` (${formOf.get(partName)})` : ""} - compose it inside <${comp}>. */
-export function ${partComp}({ ${partDestructure} }: ${propsType(partAxes, partTag, props, partEl.offersAs)}) {
+export function ${partComp}${asGeneric(partTag, partEl.offersAs)}({ ${partDestructure} }: ${propsType(partAxes, partTag, props, partEl.offersAs)}) {
 ${partEl.setup}  return (
     <${partEl.jsxTag}${partEl.jsxAttrs}
       className={${resolveCls([JSON.stringify(partCls), "className"])}}

package/dist/fonts.js

@@ -248,9 +248,15 @@ export function nextFontSnippet(input) {
      * Nenhuma linha aqui menciona o sistema, o slug ou uma variável nossa: é a fonte dele, ligada ao
      * Tailwind dele.
      */
+    /**
+     * `@theme inline`, e não `@theme` - rodada 1 do refinamento, 27/09. O Tailwind escreve um `@theme`
+     * comum no `:root`, e a variável do `next/font` mora na classe do `<body>`: no `:root` ela não existe,
+     * e `font-display` caía na fonte genérica. `inline` faz a utility ler a variável no próprio elemento,
+     * que é o padrão do `create-next-app`.
+     */
     const css = [
         `/* ${appDir}/globals.css - in your own @theme */`,
-        `@theme {`,
+        `@theme inline {`,
         ...emitted.map((role) => `  --font-${role}: var(${roleVar(role)});`),
         `}`,
     ];

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/guide.js

@@ -841,8 +841,9 @@ ${pageBaseSection}${pendingSection}${keyframeLines.length > 0
 ## Motion vocabulary
 
 The base is QUIET: nothing moves until someone asks. When they do, animation is **selection
-from this list**, not improvisation - these are the system's own animations, already compiled
-into ${hasTailwind && hasAnimateKeys ? "`theme.css` as ready utilities" : `\`tokens.css\` as \`@keyframes ds-${slug}-<name>\``}, each on the clock its intent calls for:
+from this list**, not improvisation - these are the system's own animations, each on the clock its
+intent calls for. They are written in ${hasTailwind && hasAnimateKeys ? "`theme.css`" : "`tokens.css`"} next to this guide, which your app does not load -
+nothing of ours is imported. To use one, copy its \`@keyframes\` block${hasTailwind && hasAnimateKeys ? " and its `--animate-<name>` line into your own `@theme`, and the utility below starts to exist" : " into your own stylesheet, and write the `animation` below"}:
 
 ${keyframeLines.join("\n")}
 ${patternLines.length > 0

package/dist/install-marks.js

@@ -258,7 +258,18 @@
  * o nome dele pelo valor quando a receita pede um degrau - rodada 1 do refinamento. Um componente escrito
  * antes carrega o valor cru onde o projeto tem nome.
  */
-export const MATERIALISER_SINCE = "0.16.459";
+/**
+ * 0.16.459 -> 0.16.462 em 27/09, e o passo 1 dá **SIM**: o `GUIDE.md` que cai na pasta passa a entregar
+ * as fontes num `@theme inline` (no `@theme` comum a fonte não carregava) e a dizer de onde vem cada
+ * 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.
+ */
+/**
+ * 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).
+ */
+export const MATERIALISER_SINCE = "0.16.463";
 /**
  * A ÚLTIMA VERSÃO EM QUE O QUE O HOOK RODA MUDOU.
  *
@@ -414,7 +425,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/dist/their-vars.js

@@ -180,13 +180,14 @@ const FAMILY_KIND = {
     "--ds-motion-durations-": "motion",
     "--ds-motion-easings-": "motion",
 };
+export async function pointTokensAtTheirNames(root, payload, 
 /**
- * A JORNADA INTEIRA, num chamador só - varrer, medir o build, reescrever.
- *
- * Recebe o payload em vez do CSS solto porque um argumento opcional a menos é uma chamada pela
- * metade a menos: quem chama não tem como esquecer de passar a folha certa.
+ * Os nomes DELE que um build anterior provou - `theirs` do `tokenMap` do `.lock`. Usados só quando
+ * esta máquina não tem build: antes de 27/09, sem build o mapa saía vazio e o `connect` apagava 36
+ * pares provados no CodeLevel, sem dizer por quê. O cruzamento é refeito contra o CSS dele de hoje,
+ * então um nome que sumiu do código continua não casando.
  */
-export async function pointTokensAtTheirNames(root, payload) {
+provenBefore = []) {
     const css = payload.artifacts["tokens.css"] ?? "";
     if (!css)
         return {
@@ -196,12 +197,20 @@ export async function pointTokensAtTheirNames(root, payload) {
             compiledAway: 0,
             cycles: 0,
             pairs: [],
+            provedBy: "nothing",
         };
-    const [theirs, resolvable] = await Promise.all([
+    const [theirs, built] = await Promise.all([
         harvestTheirCss(root),
         resolvableVars(root),
     ]);
-    return pointAtTheirNames(css, theirs, resolvable);
+    if (built)
+        return { ...pointAtTheirNames(css, theirs, built), provedBy: "build" };
+    if (provenBefore.length > 0)
+        return {
+            ...pointAtTheirNames(css, theirs, new Set(provenBefore)),
+            provedBy: "before",
+        };
+    return { ...pointAtTheirNames(css, theirs, null), provedBy: "nothing" };
 }
 /** As folhas de estilo DELE, e nenhuma da nossa pasta. Gêmeo de `harvestOwnTokens` no doctor. */
 async function harvestTheirCss(root) {

package/package.json

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