synthesisui 0.16.466 → 0.16.468

package/dist/commands/add.js

@@ -1,3 +1,4 @@
+import { neverMeasured } from "../never-measured.js";
 import { access, mkdir, readFile, rm, writeFile } from "node:fs/promises";
 import { join } from "node:path";
 import { agentsToMaintain } from "../agents-chosen.js";
@@ -347,7 +348,11 @@ export async function add(slug, opts) {
         registry: base,
         ...(opts.cli ? { cli: opts.cli } : {}),
         /** O que o `sync` aprendeu sobre a leitura não se perde no próximo `connect` (27/09). */
-        ...(prev?.reading === "none" ? { reading: "none" } : {}),
+        /**
+         * E O SISTEMA QUE NUNCA FOI MEDIDO NUM CÓDIGO já nasce assim - ver `neverMeasured` (rodada 5, 27/09):
+         * o fork do leigo-5 terminava o `connect` mandando rodar `sync` para uma pasta que não existe.
+         */
+        ...(prev?.reading === "none" || neverMeasured(payload.document) ? { reading: "none" } : {}),
         /** Ver `RegistryPayload.compiler`: é o que faz um conserto de CSS chegar a um install. */
         ...(payload.compiler != null ? { compiler: payload.compiler } : {}),
         ...(payload.rulesStamp ? { rules: payload.rulesStamp } : {}),
@@ -586,7 +591,7 @@ export async function add(slug, opts) {
      * A linha diz quantos utilitários do Tailwind ficaram apontando para a decisão dele e quantos
      * saíram por serem nossos, com os primeiros nomes. Quem lê pode discordar de qualquer um.
      */
-    if (aligned.dropped.length > 0 || aligned.own.length > 0) {
+    if (!opts.themeFollows && (aligned.dropped.length > 0 || aligned.own.length > 0)) {
         console.log(line(
         /**
          * A LINHA DIZ QUE FICARAM DE FORA - e nao AFIRMA por que, porque ela nao sabe.

package/dist/commands/hook.js

@@ -528,6 +528,21 @@ round) {
      * pelo nome é o que transforma uma perda silenciosa numa lacuna declarada (lei 8).
      */
     const rest = changed.slice(AT_MOST);
+    /**
+     * NO FIM DO TURNO, O REGISTRO É DO TURNO INTEIRO - rodada 5 do refinamento, 27/09.
+     *
+     * O relatório para em três, e a linha do ledger só nascia dentro dele: o agente do leigo-5 escreveu
+     * sete arquivos do dashboard num turno, o ledger ficou com três linhas `hook` e o envio com
+     * `count: 3`. O `connect` promete "every file (...) is checked at the end of each agent turn", e o
+     * painel contava três. Os demais agora são checados e registrados em silêncio; o texto continua em
+     * três, com o resto pelo nome logo abaixo.
+     *
+     * Só no turno: um comando de shell continua como era, porque ali o corte existe para um `git
+     * checkout` que muda a árvore inteira não virar trinta checagens a cada comando.
+     */
+    if (round === "turn")
+        for (const { rel } of rest.slice(0, REFUSAL_CEILING))
+            await report(root, join(root, rel), mode).catch(() => null);
     /**
      * E EM CONSUMIR, O TETO DO RELATÓRIO NÃO É O TETO DA RECUSA - achado da revisão de QA no fecho,
      * e ele falsificava a invariante inteira.

package/dist/commands/import.js

@@ -1488,8 +1488,19 @@ export async function takeCensus(root, opts) {
      * `app/` and no `pages/`, so there is nothing to count and the count would be zero for
      * everything. An app has them, and then the number means something.
      */
-    const hasScreens = [...screensOf.values()].some((at) => [...at].some((s) => s.startsWith("app/") || s.startsWith("pages/")));
-    if (hasScreens) {
+    const appScreens = new Set([...screensOf.values()].flatMap((at) => [...at].filter((s) => s.startsWith("app/") || s.startsWith("pages/"))));
+    const hasScreens = appScreens.size > 0;
+    /**
+     * E MENOS TELAS DO QUE A LINHA TAMBÉM NÃO É TESTE - rodadas 6 a 10 do refinamento, 27/09.
+     *
+     * A pergunta da regra é "duas telas compartilham isto?", e num app de UMA tela ela não tem como ser
+     * respondida: todo componente sai "composed on one screen only". Nos cinco estilos das rodadas
+     * (Tailwind, variáveis CSS, CSS Modules, atômico, SCSS) o import tirou assim os componentes do
+     * usuário, e o sistema nascia sem nenhum dele. É o mesmo raciocínio da biblioteca logo acima, do outro
+     * lado: sem telas bastantes para comparar, não há compartilhamento para medir.
+     */
+    const measurable = appScreens.size >= SCREENS_FOR_SYSTEM;
+    if (hasScreens && measurable) {
         const keep = [];
         for (const d of defined) {
             /**

package/dist/commands/init.js

@@ -168,6 +168,7 @@ export async function init(opts) {
             registry: opts.registry,
             dir: root,
             setupHints: false,
+            ...(major !== null && major >= 4 ? { themeFollows: true } : {}),
             ...(opts.cli ? { cli: opts.cli } : {}),
         });
         /**

package/dist/component-codegen.js

@@ -672,9 +672,22 @@ const preferFor = (prop) => (prop.startsWith("border") ? "border" : null);
 const namedInside = (prop, value, themeVars) => {
     if (themeVars === null)
         return value;
-    return value.replace(/\{color\.[a-zA-Z0-9.-]+\}/g, (ref) => {
+    return value
+        .replace(/\{color\.[a-zA-Z0-9.-]+\}/g, (ref) => {
         const key = theirColorKey(ref, themeVars, preferFor(prop));
         return key ? `var(--color-${key})` : ref;
+    })
+        /**
+         * E A CURVA - rodada 5, 27/09: o `card` do Zephyr saía com `cubic-bezier(0.2, 0.7, 0.2, 1)` escrito
+         * dentro da `transition`, com `--ease-lumina` declarado pelo `init`. Mesma regra: o nome dele vale
+         * quando o valor bate.
+         */
+        .replace(/\{motion\.easings\.([a-zA-Z0-9-]+)\}/g, (ref, name) => {
+        const key = kebab(name);
+        const ok = themeVars instanceof ThemeVocab
+            ? themeVars.nameFor(ref, "ease", key) === key
+            : minted(themeVars, `--ease-${key}`);
+        return ok ? `var(--ease-${key})` : ref;
     });
 };
 /** One declaration → Tailwind classes (pretty when mappable, arbitrary-property

package/dist/doctor/architecture.js

@@ -18,6 +18,18 @@
  * so this returns all of them and the person picks which one has PRIORITY. That word is
  * theirs and it is the right one: the others are still true, they just do not decide.
  */
+/**
+ * A PASTA DA FORMA `flat` - ela casa no lugar que TEM uma `components/`, e as peças moram DENTRO dela. Dizer
+ * "directly under `.`" num Next mandava o agente para a raiz (rodadas 6 a 10, 27/09). Quando o caminho já
+ * termina na pasta, ele é a resposta.
+ */
+function flatFolder(where, folder) {
+    if (!folder)
+        return where;
+    if (where === "." || where === "")
+        return folder;
+    return where === folder || where.endsWith(`/${folder}`) ? where : `${where}/${folder}`;
+}
 const SHAPES = [
     {
         kind: "atomic",
@@ -49,7 +61,7 @@ const SHAPES = [
     {
         kind: "flat",
         needs: [["components"]],
-        describe: (_a, where) => `Every component sits directly under \`${where}\`, one folder deep. It is the shape that stays legible longest while a system is small, and the one to revisit when the folder passes about forty names.`,
+        describe: (a, where) => `Every component sits directly under \`${flatFolder(where, a.evidence[0])}\`, one folder deep. It is the shape that stays legible longest while a system is small, and the one to revisit when the folder passes about forty names.`,
     },
 ];
 /**
@@ -203,7 +215,14 @@ function explains(other, shape) {
         return other.kind === shape.kind || shape.kind === "flat";
     return (pathKey(other.root) === pathKey(shape.root) &&
         shape.kind === "flat" &&
-        other.kind !== "flat");
+        other.kind !== "flat" &&
+        /**
+         * `colocated` NÃO EXPLICA A PASTA COMPARTILHADA - rodadas 6 a 10 do refinamento, 27/09. Num Next, a
+         * raiz tem `app/` e `components/`, as duas formas casam ali, e a `flat` sumia: o import dizia "BESIDE
+         * THE ROUTE" nos cinco estilos, com os componentes todos em `components/`. `colocated` diz onde moram
+         * as rotas; `flat` diz onde moram as peças que elas compartilham.
+         */
+        other.kind !== "colocated");
 }
 /**
  * O CAMINHO COMPARÁVEL - a raiz do escopo é escrita `.` pela caminhada, e comparada com `""` ela é
@@ -395,7 +414,15 @@ entries, scope) {
     const hasSrc = entries.some((e) => e.path === "src" ||
         e.path.startsWith("src/") ||
         (isRoot(e.path) && e.dirs.includes("src")));
-    const trunk = `${base ? `${base}/` : ""}${hasSrc ? "src/components" : "components"}`;
+    /**
+     * O ESCOPO QUE JÁ É A PASTA DE COMPONENTES não ganha outra dentro dele - rodadas 6 e 8, 27/09: a
+     * sugestão saía `components/ui/components/{atoms, molecules, organisms}` e `components/components/…`, e o
+     * agente da rodada 8 chamou de "a slip in the tool".
+     */
+    const insideComponents = /(^|\/)components(\/|$)/.test(base);
+    const trunk = insideComponents
+        ? base
+        : `${base ? `${base}/` : ""}${hasSrc ? "src/components" : "components"}`;
     const fresh = `${trunk}/{atoms, molecules, organisms}`;
     /** Se a proposta é o que já existe, ela não é uma pasta nova - e oferecê-la seria repetir a opção 1. */
     return found.some((a) => componentHome(a, scope) === fresh) ? null : fresh;

package/dist/guide.js

@@ -461,7 +461,17 @@ ${depLines.join("\n")}
         Object.keys(foundations.color.semanticAlt).length > 0;
     const altScheme = meta.scheme === "light" ? "dark" : "light";
     const hasTailwind = "theme.css" in payload.artifacts;
-    const hasParts = Object.values(components).some((r) => r.parts && Object.keys(r.parts).length > 0);
+    /**
+     * O EXEMPLO DE PEÇA COM PARTES SAI DE UMA QUE O SISTEMA TEM - rodada 5, 27/09. Era sempre uma tabela
+     * (`.ds-table`, `.ds-table-head`…), bastando QUALQUER peça ter partes: o Zephyr tem `streak`, `xp-bar` e
+     * `join-field`, nenhuma tabela, e o agente dele foi procurar classes que não existem. A tabela só é o
+     * exemplo quando o sistema a tem.
+     */
+    const withParts = Object.entries(components).filter(([, r]) => r.parts && Object.keys(r.parts).length > 0);
+    const picked = withParts.find(([n]) => n === "table") ?? withParts[0];
+    const multiPart = picked
+        ? { name: kebab(picked[0]), parts: Object.keys(picked[1].parts ?? {}).map(kebab) }
+        : null;
     const componentLines = Object.entries(components).map(([cname, recipe]) => componentEntry(cname, recipe));
     /**
      * O CORTE SÓ ACONTECE QUANDO ELE DE FATO CORTA - e este é o único jeito honesto de prometê-lo.
@@ -739,26 +749,15 @@ The system defines the scale; these are sensible defaults for spending it:
 - **Section gaps:** \`lg\` (or the nearest large step). **Card/panel padding:** \`md\`.
 - **Field / tight gaps:** \`2xs\`/\`3xs\`.
 - The system imposes no content max-width - cap long-form/text columns yourself for readability.
-${hasParts
+${multiPart
         ? `
 ### Multi-part components
 Components that have **parts** compile to \`.ds-<name>-<part>\` classes you nest yourself; the exact
-part classes and their \`data-*\` are listed per component below. Example - a table:
+part classes and their \`data-*\` are listed per component below. Example - ${multiPart.name}:
 \`\`\`tsx
-<table className="ds-table">
-  <thead className="ds-table-head">
-    <tr>
-      <th className="ds-table-cell-head">Name</th>
-      <th className="ds-table-cell-head" data-align="end">Updated</th>
-    </tr>
-  </thead>
-  <tbody>
-    <tr className="ds-table-row">
-      <td className="ds-table-cell">Halogen</td>
-      <td className="ds-table-cell" data-align="end">2h ago</td>
-    </tr>
-  </tbody>
-</table>
+<div className="ds-${multiPart.name}">
+${multiPart.parts.map((p) => `  <div className="ds-${multiPart.name}-${p}">…</div>`).join("\n")}
+</div>
 \`\`\`
 `
         : ""}

package/dist/install-marks.js

@@ -275,7 +275,13 @@
  * `--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";
+/**
+ * 0.16.464 -> 0.16.467 em 27/09, e o passo 1 dá **SIM**: o gerador que o `upgrade` usa passa a escrever a
+ * curva de uma `transition` pelo nome dele (`var(--ease-lumina)`), o `GUIDE.md` deixa de ensinar uma tabela
+ * que o sistema não tem, e o `.lock` de um sistema nunca medido num código nasce com `reading: "none"` -
+ * rodada 5 do refinamento. Uma pasta escrita antes ensina `.ds-table` ao agente.
+ */
+export const MATERIALISER_SINCE = "0.16.467";
 /**
  * A ÚLTIMA VERSÃO EM QUE O QUE O HOOK RODA MUDOU.
  *
@@ -437,7 +443,12 @@ export const COUNTED_DIFFERENTLY = "this run counts a value as named only when Y
  * 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";
+/**
+ * 0.16.463 -> 0.16.467 em 27/09, e o passo 1 dá **SIM**: o fim do turno passa a registrar no ledger TODOS os
+ * arquivos do turno, e não só os três que relata - rodada 5: o leigo-5 escreveu sete e o painel recebeu
+ * três. Um hook anterior segue mandando ao painel um turno pela metade.
+ */
+export const CHECKER_SINCE = "0.16.467";
 /**
  * A ÚLTIMA VERSÃO EM QUE OS LEITORES PASSARAM A PRODUZIR UM CENSO DIFERENTE.
  *
@@ -886,7 +897,12 @@ export const CHECKER_SINCE = "0.16.463";
  * deveriam estar lá. Quem tem censo gravado precisa de um `sync` para a fila de trabalho dele ser a
  * real; ver o livro-razão de `corpus.spec.ts`.
  */
-export const READER_SINCE = "0.16.440";
+/**
+ * 0.16.440 -> 0.16.468 em 27/09, e o passo 1 dá **SIM**: num app de uma tela só a regra de duas telas deixa
+ * de tirar os componentes dele - rodadas 6 a 10 do refinamento, nos cinco estilos o sistema nascia sem
+ * nenhum componente do usuário. Um censo lido antes guardou essa lista vazia, e só remedir a enche.
+ */
+export const READER_SINCE = "0.16.468";
 /**
  * O QUE ESTÁ INSTALADO AQUI FICOU PARA TRÁS - e as DUAS condições que fazem isso ser verdade.
  *

package/dist/never-measured.js

@@ -0,0 +1,21 @@
+/**
+ * O SISTEMA NUNCA FOI MEDIDO NUM CÓDIGO - rodada 5 do refinamento, 27/09.
+ *
+ * O `connect` do leigo-5 terminou com "Still out of alignment: \"zephyr\" does not record where it was
+ * measured (...) npx synthesisui sync". O aviso só se calava com `reading: "none"` no `.lock`, e isso só
+ * era gravado depois de um `sync` que perguntava. Só que o documento já responde: cada fundação carrega
+ * quem a escreveu (`foundations.source`, os `FoundationAuthor` da plataforma), e num fork nascido na
+ * plataforma todas são `seed`. Não existe pasta de onde ele veio, e não há o que remedir.
+ *
+ * OS AUTORES QUE LERAM UM CÓDIGO são `import`, `sync`, `reground` e `reinterpret`. Um deles basta para o
+ * sistema ter origem num repositório, e aí a pergunta do `sync` continua valendo. Sem `source` nenhum, o
+ * documento não diz - e o silêncio não vira afirmação.
+ */
+const FROM_CODE = new Set(["import", "sync", "reground", "reinterpret"]);
+export function neverMeasured(doc) {
+    const source = doc?.foundations?.source;
+    if (!source || typeof source !== "object")
+        return false;
+    const authors = Object.values(source);
+    return authors.length > 0 && !authors.some((a) => FROM_CODE.has(String(a)));
+}

package/package.json

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