synthesisui 0.16.297 → 0.16.299

package/dist/commands/import.js

@@ -49,6 +49,7 @@ import { phase, startProgress } from "../progress.js";
 import { repoStateOf } from "../repo-state.js";
 import { runtimeDeclaredVars, runtimeDeclaredVarsIn } from "../runtime-vars.js";
 import { detectStack, resolveDeps, stackVersions } from "../stack.js";
+import { wiredSlugs, wiringWarning } from "../wired-slugs.js";
 import { placeInWorkspace } from "../workspace-place.js";
 import { add } from "./add.js";
 import { walk, walkAll } from "./doctor.js";
@@ -373,6 +374,13 @@ function screenOf(rel) {
 }
 /** Quantas classes da folha global viajam no censo. Ver o aviso em `takeCensus`. */
 const MAX_GLOBAL_CLASSES = 300;
+/**
+ * QUANTOS NOMES DE COMPONENTE RECUSADO VIAJAM - ver o ponto de uso.
+ *
+ * Medido e não estimado: 688 recusados no `frontend-hub` e 712 num monorepo maior. 4096 cabe os
+ * dois com folga e continua sendo um teto de verdade, alinhado com `DISTINCT_CAP` do ledger.
+ */
+const SKIPPED_CAP = 4096;
 export async function takeCensus(root, opts) {
     /**
      * O RELATÓRIO SÓ SAI QUANDO ALGUÉM O PEDIU - `say` cala quando o chamador é uma RE-medição.
@@ -2113,6 +2121,17 @@ export async function takeCensus(root, opts) {
             : {}),
         ...(animations.size > 0 ? { animations: [...animations].sort() } : {}),
         ...(brokenRefs.length > 0 ? { brokenRefs } : {}),
+        /**
+         * OS SISTEMAS QUE O CSS DELE JÁ CHAMA PELO NOME - ver `wiredSlugs`.
+         *
+         * Existe porque um import de 24/08 deixou o repositório do dono SEM COMPILAR: o CSS dele
+         * carrega `_synthesisui/ds/codelevel/`, o sistema nasceu como `codelevel-ds`, e o `next build`
+         * dele terminou em exit code 1 com `Can't resolve`. Não é cor errada - é o app parado.
+         *
+         * O campo é a metade medida da resposta; a outra é a pergunta do nome saber usá-lo. Aditivo e
+         * omitido quando não há nada cabeado, que é o caso de todo primeiro import limpo.
+         */
+        ...(wiredSlugs(css).length > 0 ? { wiredSlugs: wiredSlugs(css) } : {}),
         /**
          * OS NOMES DISPUTADOS - ver `name-claim.ts`.
          *
@@ -2232,9 +2251,26 @@ export async function takeCensus(root, opts) {
             : {}),
         ...(skips.length > 0
             ? {
+                /**
+                 * TODOS OS NOMES, E NÃO 400 - a decisão de 100% no portão, aplicada aqui.
+                 *
+                 * O DONO (24/08): *"o nosso objetivo sempre é conseguir pegar tudo lá no portão, cem por
+                 * cento"*. Um componente recusado cujo NOME não viaja é um componente sobre o qual ele não
+                 * pode discordar - e discordar da recusa é exatamente o que a tela oferece.
+                 *
+                 * O TETO SUBIU E O PESO CAIU, na mesma mudança, porque uma coisa pagou a outra: o
+                 * `because` saiu de cada entrada. Medido no `frontend-hub`: 400 entradas com a frase pesam
+                 * 79 KB e sem ela 18 KB - 77% menor. A frase é o MESMO template com o nome dentro
+                 * (`AddUserIcon renders but decides nothing…`), e o template já viaja uma vez por motivo em
+                 * `gate.groups[].label`. Transportá-la 400 vezes era pagar caro pela mesma frase.
+                 *
+                 * O que se perde: a frase com o nome do componente dentro. O que se ganha: todos os nomes,
+                 * em vez de 400 de 688. Para quem quer discordar de uma recusa, o nome é o que importa - a
+                 * frase ele já lê uma vez, no grupo.
+                 */
                 skipped: skips
-                    .slice(0, 400)
-                    .map(({ name, why, because }) => ({ name, why, because })),
+                    .slice(0, SKIPPED_CAP)
+                    .map(({ name, why }) => ({ name, why })),
                 /**
                  * OS NÚMEROS VERDADEIROS DO PORTÃO, porque a lista acima é cortada em 400 e num
                  * monorepo real o corte estoura (712 recusados, 400 gravados). Contar a lista daria
@@ -3995,6 +4031,26 @@ export async function runImport(opts) {
      * mais longa do produto ficar mais longa no lugar onde ela já é mais difícil de ler.
      */
     if (payload?.slug) {
+        /**
+         * A FIAÇÃO DELE CONTRA O SLUG QUE NASCEU - e este aviso sai do CLI, não da skill.
+         *
+         * MEDIDO em 24/08: o `globals.css` dele importa `_synthesisui/ds/codelevel/`, o nome escolhido
+         * derivou `codelevel-ds`, ninguém mencionou, e o `next build` dele terminou em exit code 1 com
+         * `Can't resolve`. O aplicativo do cliente parou de compilar por causa de um comando que a
+         * plataforma conduziu do começo ao fim.
+         *
+         * AQUI e não só no playbook porque o playbook é conselho e isto é fato: o slug chegou do
+         * servidor, a pasta vai ser escrita com ele, e a divergência é aritmética. Um aviso que depende
+         * de um agente ter lido o capítulo certo é um aviso que falta exatamente quando ele não leu -
+         * foi assim que este defeito passou.
+         */
+        const warning = wiringWarning(census.wiredSlugs ?? [], payload.slug);
+        if (warning) {
+            console.log("");
+            console.log(section("Your CSS points somewhere else"));
+            for (const line of warning.split("\n"))
+                console.log(body(line));
+        }
         try {
             await add(payload.slug, {
                 registry: opts.registry,

package/dist/doctor/style-ledger.js

@@ -65,6 +65,13 @@ const SHAPE_LABEL = {
  *
  * Um motivo novo que um leitor alcance entra AQUI. Fora daqui ele vira contagem sem lugar.
  */
+/**
+ * QUANTOS TEXTOS DISTINTOS POR GRUPO VIAJAM - ver a explicação no ponto de uso.
+ *
+ * Medido e não estimado: 4 426 declarações nos módulos do `frontend-hub` são 1 108 distintas, e a
+ * população inteira daquele repositório cabe abaixo deste teto.
+ */
+const DISTINCT_CAP = 4096;
 const A_READER_REACHES = new Set([
     "shape-not-read",
     "binding-not-read",
@@ -85,6 +92,29 @@ const A_READER_REACHES = new Set([
      * O teto de 512 e o texto DISTINTO continuam valendo, e são eles que pagam a conta do tamanho.
      */
     "value-not-read",
+    /**
+     * `component-not-admitted` ENTROU EM 24/08, e é a maior de todas - 96% do volume não interpretado
+     * do repositório real.
+     *
+     * A frase que o excluía estava certa sobre o que ele É e errada sobre o que ele CUSTA:
+     * *"`component-not-admitted` é o portão, não a leitura"*. Verdade - o componente ficou fora do
+     * escopo, e nenhum leitor novo conserta isso. Mas a conclusão não seguia: o texto não é só
+     * matéria-prima de leitor, é matéria-prima de DECISÃO. São 10 206 declarações no `frontend-hub`
+     * que o cliente não tem como olhar sem abrir o repositório dele arquivo por arquivo.
+     *
+     * A DECISÃO DO DONO (24/08), e ela é de princípio: *"o nosso objetivo sempre é conseguir pegar
+     * tudo lá no portão, cem por cento"*. Um estilo que existe no código dele e não viaja é um estilo
+     * sobre o qual nenhuma tela, nenhuma proposta e nenhuma re-interpretação pode falar.
+     *
+     * O QUE PAGA A CONTA continua sendo o texto DISTINTO, e medido: nos 400 primeiros arquivos de
+     * module do `frontend-hub` são 4 426 declarações e 1 108 distintas - a dedup corta 4x. O volume
+     * bruto de 10 825 usos vira ~1 500 textos, não 10 825 linhas.
+     *
+     * E O CUSTO É DECRESCENTE, que é a observação do dono ao aprovar isto: cada forma que a
+     * interpretação aprender sai deste balde e entra em recipe. O censo encolhe à medida que a
+     * plataforma melhora - o pico é agora, não depois.
+     */
+    "component-not-admitted",
 ]);
 const BECAUSE = {
     "shape-not-read": "no reader in this version understands this shape, so the styles it holds reach no recipe",
@@ -166,11 +196,16 @@ declared) {
          * fragmento deu 723 215 bytes no dashboard dele, contra um teto de 65 536. Oito mil cópias da
          * mesma string não ensinam mais que uma - o que um leitor precisa é da variedade de FORMAS.
          *
-         * O teto de 512 é declarado e não mudo: `uses` continua contando tudo, então a diferença entre o
-         * contado e o que viajou é visível em vez de silenciosa.
+         * O TETO SUBIU PARA 4096 EM 24/08, e o número saiu de uma medição e não de um palpite: a
+         * variedade real do `frontend-hub` é de ~1 500 textos distintos sobre 10 825 usos, então 4096
+         * cabe a população inteira daquele repositório com folga e continua sendo um teto de verdade
+         * para um caso patológico.
+         *
+         * `uses` continua contando tudo, então a diferença entre o contado e o que viajou permanece
+         * visível em vez de silenciosa - e é ela que a tela mostra quando o teto corta.
          */
         if (A_READER_REACHES.has(reason) &&
-            group.unreadable.length < 512 &&
+            group.unreadable.length < DISTINCT_CAP &&
             !group.unreadable.some((u) => u.text === f.text))
             group.unreadable.push({
                 file: f.file,

package/dist/install-marks.js

@@ -253,7 +253,7 @@ export const CHECKER_SINCE = "0.16.250";
  * publicado antes deste código existir, e uma marca nele calaria o aviso para quem o instalou. Mesma
  * lição de algumas horas antes, na mesma sessão.
  */
-export const READER_SINCE = "0.16.288";
+export const READER_SINCE = "0.16.299";
 /**
  * O QUE ESTÁ INSTALADO AQUI FICOU PARA TRÁS - e as DUAS condições que fazem isso ser verdade.
  *

package/dist/wired-slugs.js

@@ -0,0 +1,86 @@
+/**
+ * OS SISTEMAS QUE O CSS DELE JÁ CHAMA PELO NOME - e o build que quebra quando o nome não bate.
+ *
+ * O QUE ACONTECEU, medido no repositório do dono em 24/08: o `globals.css` dele carrega
+ *
+ *     @import "../../../../_synthesisui/ds/codelevel/tokens.css";
+ *     @import "../../../../_synthesisui/ds/codelevel/theme.css";
+ *
+ * O import daquela corrida nasceu com o slug `codelevel-ds`, então o `add` escreveu
+ * `_synthesisui/ds/codelevel-ds/` e os dois `@import` passaram a apontar para uma pasta que não
+ * existe. O `next build` dele terminou em **exit code 1**:
+ *
+ *     Can't resolve '../../../../_synthesisui/ds/codelevel/tokens.css'
+ *
+ * Não é uma cor errada nem um token faltando: o aplicativo dele **não compila**. É o pior desfecho
+ * possível de uma esteira que existe para devolver o código dele funcionando, e ele sai de um
+ * comando que a plataforma conduziu do começo ao fim.
+ *
+ * POR QUE O SLUG PODE DIVERGIR: o nome é decisão dele, feita numa pergunta, e o slug deriva do
+ * nome. "CodeLevel" dá `codelevel`; "CodeLevel DS" dá `codelevel-ds`. As duas respostas são
+ * legítimas - o que não é legítimo é ninguém dizer que a segunda quebra o CSS que já está lá.
+ *
+ * ENTÃO A MEDIÇÃO VEM ANTES DA PERGUNTA. Este leitor responde "quais slugs o CSS deste repositório
+ * já espera encontrar", e o censo carrega a resposta. Com ela na mão, a pergunta do nome deixa de
+ * ser um campo em branco: existe um slug que faz a fiação resolver, e ele é dito em voz alta.
+ *
+ * DIZER, E NÃO DECIDIR. A plataforma não escolhe o nome do sistema dele nem reescreve o CSS dele -
+ * é o mesmo padrão do `add`, que imprime o `@import` e não o cola. O que ela deve é nunca deixá-lo
+ * escolher às cegas uma resposta que apaga o build.
+ */
+/**
+ * O caminho que a nossa própria instalação usa. Qualquer profundidade de `../`, porque a folha dele
+ * pode estar em qualquer nível - a do dono está quatro acima.
+ */
+const WIRED = /_synthesisui\/ds\/([a-z0-9][a-z0-9-]*)\//gi;
+/**
+ * Os slugs que o CSS dele já referencia, em ordem de aparição e sem repetir.
+ *
+ * Recebe o CSS já concatenado porque é isso que o censo tem em mão - uma segunda varredura de
+ * arquivos seria uma segunda medição, livre para discordar da primeira.
+ */
+export function wiredSlugs(css) {
+    const out = [];
+    for (const m of css.matchAll(WIRED))
+        if (!out.includes(m[1].toLowerCase()))
+            out.push(m[1].toLowerCase());
+    return out;
+}
+/**
+ * O QUE DIZER A ELE QUANDO O SISTEMA JÁ NASCEU COM OUTRO NOME.
+ *
+ * Roda DEPOIS do envio, com o slug que o servidor devolveu - então não é previsão, é fato: a pasta
+ * vai ser escrita com este nome e os `@import` dele apontam para outro.
+ *
+ * `null` quando o CSS não cabeia nada (todo primeiro import limpo) e quando o slug que nasceu já é
+ * um dos cabeados. Um aviso que aparece sempre é um aviso que ninguém lê.
+ *
+ * A frase carrega as três coisas que a decisão precisa: o que o CSS espera, o que existe agora, e o
+ * que acontece se ele não fizer nada. Sem a terceira isto é trivia - e foi a terceira que faltou na
+ * corrida que parou o build dele.
+ *
+ * DIZER, E NÃO CONSERTAR. O CSS é dele; reescrevê-lo por conta própria seria a plataforma editando
+ * o repositório de alguém sem pedir. É o mesmo padrão do `add`, que imprime o `@import` e não o
+ * cola.
+ */
+export function wiringWarning(
+/**
+ * A LISTA, e não o CSS - porque o censo já a carrega (`census.wiredSlugs`) e o CSS bruto não
+ * viaja nele. Recontar aqui seria uma segunda medição, livre para discordar da primeira.
+ */
+wired, slugThatWasBorn) {
+    if (wired.length === 0)
+        return null;
+    if (wired.includes(slugThatWasBorn.toLowerCase()))
+        return null;
+    return [
+        `Your CSS imports _synthesisui/ds/${wired[0]}/, and this system is "${slugThatWasBorn}".`,
+        `Those @import lines point at a folder that does not exist, and the build fails on them -`,
+        `not a missing colour, a build that stops. Point them at ${slugThatWasBorn} to fix it:`,
+        "",
+        `    @import ".../_synthesisui/ds/${slugThatWasBorn}/tokens.css";`,
+        `    @import ".../_synthesisui/ds/${slugThatWasBorn}/theme.css";`,
+        "",
+        "Yours to change - we do not edit your CSS.",
+    ].join("\n");
+}

package/package.json

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