synthesisui 0.16.275 → 0.16.276

package/dist/anatomy-read.js

@@ -214,11 +214,13 @@ function measuredAt(node, sketch) {
     if (measured?.passes && Object.keys(measured.passes).length > 0) {
         out.passes = measured.passes;
         /**
-         * A FORMA VIAJA COM O VALOR, sempre. Um `passes` sem `passesExpr` obriga quem emite a adivinhar
-         * entre aspas e chaves, e as duas adivinhações produzem JSX quebrado no arquivo dele.
+         * A FORMA VIAJA COM O VALOR, SEMPRE - inclusive vazia.
+         *
+         * Um `passes` sem `passesExpr` obriga quem emite a adivinhar entre aspas e chaves, e as duas
+         * adivinhações produzem código errado no arquivo dele. A lista vazia responde "nenhuma é
+         * expressão"; a AUSÊNCIA responde "este censo é velho", e são coisas diferentes.
          */
-        if (measured.passesExpr && measured.passesExpr.length > 0)
-            out.passesExpr = measured.passesExpr;
+        out.passesExpr = measured.passesExpr ?? [];
     }
     if (measured?.repeats)
         out.repeats = measured.repeats;

package/dist/attr-shape.js

@@ -109,6 +109,19 @@ export function attrText(key, value, isExpression) {
  * adaptar e pode citar o nome dela; um arquivo gerado é para compilar.
  */
 export function emittableAttrs(node, opts) {
+    /**
+     * FORMA DESCONHECIDA SEGURA TUDO - e este é o caso do censo tirado antes de 22/08.
+     *
+     * `passesExpr` ausente não quer dizer "nenhuma é expressão": quer dizer que o leitor daquele dia
+     * não sabia responder. Tratar como literal escreveria `title="metric.label"` no arquivo dele onde
+     * ele escreveu `title={metric.label}` - uma string no lugar de uma variável, que é leitura errada
+     * virando código errado, exatamente o defeito que esta família de consertos existe para não
+     * cometer.
+     *
+     * A omissão, ao contrário, é reparável: um `sync` traz a forma e o atributo aparece.
+     */
+    if (node.passes && Object.keys(node.passes).length > 0 && !node.passesExpr)
+        return { write: "", held: Object.keys(node.passes) };
     const expr = new Set(node.passesExpr ?? []);
     const write = [];
     const held = [];

package/dist/doctor/sketch.js

@@ -563,9 +563,18 @@ export function sketchOf(source, name) {
         const given = passedProps(event.body, conditional);
         if (given) {
             node.passes = given.props;
-            /** A forma, ao lado do valor - ver `passesExpr`. Vazio não viaja. */
-            if (given.expression.length > 0)
-                node.passesExpr = given.expression;
+            /**
+             * A FORMA VIAJA SEMPRE QUE O VALOR VIAJA, inclusive VAZIA - e a lista vazia é o ponto.
+             *
+             * Se `passesExpr` só aparecesse quando há expressão, "ausente" significaria duas coisas ao
+             * mesmo tempo: *nenhuma delas é expressão* e *este censo é velho e não sabe responder*. Quem
+             * emite não tem como distinguir, e as duas exigem comportamentos OPOSTOS - escrever tudo como
+             * literal, ou não escrever nada.
+             *
+             * Com o array sempre presente, ausência quer dizer uma coisa só: censo tirado antes de
+             * 0.16.275. Ver `emittableAttrs`, que segura o atributo nesse caso em vez de adivinhar.
+             */
+            node.passesExpr = given.expression;
         }
         const list = repeatOf(source, event.at);
         if (list)

package/dist/install-marks.js

@@ -128,7 +128,7 @@
  * é sempre o bump deste PR - nunca o número que o `package.json` já carrega, porque alguém pode
  * publicar no meio.
  */
-export const MATERIALISER_SINCE = "0.16.275";
+export const MATERIALISER_SINCE = "0.16.276";
 /**
  * A ÚLTIMA VERSÃO EM QUE O QUE O HOOK RODA MUDOU.
  *

package/dist/populations.spec-input.js

@@ -0,0 +1,53 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+/**
+ * ONDE ESTÃO AS POPULAÇÕES MEDIDAS - e por que elas não moram mais na máquina de ninguém.
+ *
+ * O QUÊ. 23 specs medem contra o censo de dois repositórios reais. Até 22/08 cada um apontava para
+ * `~/projects/frontend-hub` ou `~/personal/codelevel-monorepo` na home do dono.
+ *
+ * POR QUÊ ISSO ERA UM DEFEITO. Não porque quebrava - 35 dos 36 pulavam educadamente quando o
+ * arquivo sumia. Porque ficava VERDE. Medido em 22/08: três artefatos do `signalui` já não estavam
+ * no disco e 12 testes pulavam em silêncio havia sabe-se lá quanto tempo. Uma suíte que fica verde
+ * quando parou de medir é pior que uma vermelha, e essa é a única classe de defeito que esta
+ * esteira não pode aceitar num instrumento.
+ *
+ * E O SEGUNDO CUSTO, que é o do produto: sem a segunda população, toda régua nova passa a ser
+ * medida num repositório só. Três réguas escritas em 22/08 estariam erradas por isso.
+ *
+ * COMO. `fixtures/populations/`, versionado, compacto. `npm run populations:refresh` atualiza a
+ * partir dos repositórios vivos quando eles existem - e o que mudou aparece no `git diff`, que é
+ * onde uma mudança de insumo pode ser revisada em vez de sentida.
+ *
+ * GÊMEO de `apps/web/src/lib/ds/populations.ts`: o CLI é publicado standalone e não importa de lá. As
+ * duas cópias resolvem o mesmo diretório por caminho relativo, então elas não podem divergir de
+ * conteúdo - só de posição.
+ */
+/** A raiz do monorepo, a partir deste arquivo: `packages/cli/src` → 3 níveis acima. */
+const ROOT = join(import.meta.dirname, "..", "..", "..");
+const POPULATIONS = join(ROOT, "fixtures", "populations");
+/**
+ * 323 componentes, escopo `apps/web-dashboard`. A população que derruba régua feita em cima da
+ * outra: ela não declara um `--animate-*` sequer, escreve o relógio literal na receita, e tem 62
+ * componentes cujo primeiro nó do sketch não é a raiz.
+ */
+export const FRONTEND_HUB_CENSUS = join(POPULATIONS, "frontend-hub.census.json");
+/**
+ * 59 componentes, escopo `packages/ui`. O caso de teste vivo do dia a dia - é dele que saem os
+ * números do `triage` e é nele que a jornada é conferida na tela.
+ */
+export const CODELEVEL_CENSUS = join(POPULATIONS, "codelevel-ui.census.json");
+/**
+ * OS REPOSITÓRIOS VIVOS - e estes NÃO estão congelados, de propósito.
+ *
+ * Um punhado de specs não mede o censo: eles varrem os `.tsx` de ORIGEM para exercitar o COLETOR -
+ * `sketchOf`, `rootTag`, o leitor de `cn()`. Congelar 69 arquivos de código de cliente dentro deste
+ * repositório é uma decisão diferente de congelar uma medição, e ela não foi tomada.
+ *
+ * Então estes caminhos continuam dependendo da máquina, e é aqui que isso está DITO. Todo spec que
+ * os usa tem que guardar com `existsSync` - sem o guard, a ausência derruba a suíte em vez de pular.
+ *
+ * Medido em 22/08: 5 specs no `apps/web` e no `packages/cli` estão nesta situação.
+ */
+export const CODELEVEL_REPO = join(homedir(), "personal", "codelevel-monorepo");
+export const FRONTEND_HUB_REPO = join(homedir(), "projects", "frontend-hub");

package/package.json

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