synthesisui 0.16.247 → 0.16.249

package/dist/commands/import.js

@@ -1586,7 +1586,7 @@ export async function takeCensus(root, opts) {
         islandRead: islandClassesRead,
         refused: new Set(skips.map((s) => s.file)),
     }));
-    const coverageLines = describeCoverage(coverage, composition);
+    const coverageLines = describeCoverage(coverage, composition, skips.length);
     if (coverageLines.length > 0) {
         say("");
         say(section("What this version reads, on your files"));

package/dist/commands/list.js

@@ -1,8 +1,40 @@
 import { resolveRegistry } from "../config.js";
-import { fetchList } from "../registry.js";
-/** Lists the published design systems available in the registry. */
+import { fetchList, fetchMine } from "../registry.js";
+/**
+ * O CATÁLOGO, E OS SISTEMAS DELA - duas perguntas diferentes, um comando.
+ *
+ * Sem `--mine` este comando sempre respondeu "o que existe para instalar": a
+ * galeria pública, sem dono. Ele nunca mostrou os sistemas de quem o roda, ao
+ * contrário do que o levantamento dizia - e essa era a lacuna real.
+ *
+ * NO TERMINAL NÃO HAVIA COMO SABER DE QUE GRUPO É CADA SISTEMA, e isso passou a
+ * ter consequência: o `sync` escreve direto no rascunho e o Autopilot publica
+ * sozinho quando ligado. Até aqui, o único freio contra mexer no sistema errado
+ * era a pessoa lembrar de cabeça.
+ */
 export async function list(opts) {
     const base = resolveRegistry(opts.registry);
+    if (opts.mine) {
+        const mine = await fetchMine(base);
+        if (mine.length === 0) {
+            console.log("You have no design systems yet. `synthesisui init` starts one from this repo.");
+            return;
+        }
+        console.log("Your design systems:\n");
+        const width = Math.max(...mine.map((s) => s.slug.length));
+        for (const s of mine) {
+            /**
+             * O GRUPO ENTRE PARÊNTESES, e "invited" quando ele não é dela - as duas
+             * informações que decidem se aquele é o sistema em que ela quer escrever.
+             */
+            const group = s.group
+                ? `${s.group}${s.mine ? "" : ", invited"}`
+                : "no group";
+            console.log(`  ${s.slug.padEnd(width)}  ${s.name}  (v${s.version}) · ${group}`);
+        }
+        console.log('\nWork in one with:  synthesisui use <slug> "<what you are building>"');
+        return;
+    }
     const systems = await fetchList(base);
     if (systems.length === 0) {
         console.log(`No design systems published at ${base}.`);
@@ -14,4 +46,10 @@ export async function list(opts) {
         console.log(`  ${s.slug.padEnd(width)}  ${s.name}  (v${s.version})`);
     }
     console.log(`\nBring one in with:  synthesisui add <slug>`);
+    /**
+     * E A OUTRA PERGUNTA FICA DITA. Quem roda `list` procurando os PRÓPRIOS
+     * sistemas recebia a galeria e nenhuma pista de que existe outra lista - a
+     * lacuna calada mais barata de fechar que existe.
+     */
+    console.log(`Your own systems:   synthesisui list --mine`);
 }

package/dist/doctor/component-gate.js

@@ -304,6 +304,13 @@ export function groupSkips(skips) {
  *
  * The sentence a person needs in order to trust a number that just dropped by an
  * order of magnitude - and to notice if it dropped too far.
+ *
+ * ─────────────────────────────────────────────────────────────────────────
+ * E ELA VIAJA COLADA À MANCHETE (dono, 18/08).
+ *
+ * "340 de 340 com blueprint - 100%" sozinho é autoelogio: um portão que admite
+ * pouco fecha 100% fácil. As duas linhas juntas são uma promessa que se pode
+ * conferir - o que entrou, e o que ficou de fora com o motivo de cada um.
  */
 export function describeGate(kept, skipped) {
     if (skipped === 0) {

package/dist/doctor/coverage.js

@@ -110,7 +110,7 @@ export function summarizeCoverage(counts, components, read, declarations) {
 /**
  * The report, in the words a person needs before they decide whether to import.
  *
- * Leads with the number that matters - how many components came out with a look - and
+ * Leads with the number that matters - how many components came out with a blueprint - and
  * then names every shape that is not fully read, with the reason. No percentages without
  * the count behind them: "75%" of an unknown total is a marketing number.
  */
@@ -123,12 +123,41 @@ export function describeCoverage(c,
  * arranjo e fluxo, e é isso que a receita deles carrega. Medido no dashboard dele: 235 de
  * 271 (04/08).
  */
-composition) {
+composition, 
+/**
+ * O QUE O PORTÃO DEIXOU DE FORA - e ele viaja COLADO à manchete (dono, 18/08).
+ *
+ * A explicação longa e a lista nominal continuam onde sempre estiveram, 79
+ * linhas abaixo. O que sobe para cá é só o número, porque é ele que impede a
+ * manchete de ser autoelogio: um portão que admite pouco fecha 100% fácil, e
+ * as duas contas juntas são uma promessa que se pode conferir.
+ */
+leftOut) {
     if (c.components === 0)
         return [];
     const lines = [];
     const pct = Math.round((c.read / c.components) * 100);
-    lines.push(`${c.read} of ${c.components} components came out with a look - ${pct}%, ${c.declarations} declarations in total. This is measured on your files, not an estimate.`);
+    /**
+     * A MANCHETE É BLUEPRINT POR COMPONENTE, e não fragmento de estilo (dono, 18/08).
+     *
+     * As duas contas existiam, e a que liderava era a errada. "62% dos fragmentos
+     * interpretados" mistura no mesmo denominador coisas que NÃO PODEM ser lidas
+     * por natureza - medido no repo real: 120 fragmentos são `computed`, o valor
+     * nasce no navegador e não está no código em nível nenhum; 4 são partials que
+     * o build dele nem compila. Perseguir 100% ali é perseguir um número que
+     * obriga a mentir.
+     *
+     * A conta que pode fechar em 100%, e que é o objetivo do recurso, é esta:
+     * dos componentes ADMITIDOS, quantos saíram com blueprint. Medido no
+     * `frontend-hub`: 340 de 340.
+     *
+     * `blueprint` é o nome público do que a plataforma produz; `recipe` continua
+     * sendo o nome interno, no documento e no código.
+     */
+    lines.push(`${c.read} of ${c.components} components came out with a blueprint - ${pct}%, ${c.declarations} declarations in total. This is measured on your files, not an estimate.`);
+    if (leftOut && leftOut > 0) {
+        lines.push(`  and ${leftOut} export${leftOut === 1 ? "" : "s"} did not become one - each is named below with the reason, so a 100% here never means "we admitted little".`);
+    }
     if (composition && composition > 0) {
         lines.push(
         /**

package/dist/index.js

@@ -39,6 +39,7 @@ Usage - deterministic, FREE:
   synthesisui login [options]              connect the CLI to your account (device-flow; --force to switch accounts)
   synthesisui init [options]               write _synthesisui/config.json (target, dirs); --ds to bring one in
   synthesisui list [options]               list the published design systems
+  synthesisui list --mine                  your own systems, with their group
   synthesisui add <slug> [options]         materialize a DS into _synthesisui/ds/<slug>/
   synthesisui component <slug> <name>      bring one EXISTING component in as YOUR <Pascal>.tsx
   synthesisui template <slug> <name>       materialize a whole page from a DS template
@@ -365,7 +366,17 @@ async function main() {
             });
             break;
         case "list":
-            await list({ registry });
+            /**
+             * `--mine` responde a OUTRA pergunta: os sistemas desta pessoa, com o
+             * grupo de cada um. Sem a flag, o comando segue sendo o catálogo público
+             * que ele sempre foi.
+             */
+            /**
+             * `flags.mine`, e não `args`: o parser tira toda `--flag` dos
+             * posicionais, então procurá-la ali sempre responderia não - e o comando
+             * cairia calado no catálogo público, que é a lista errada.
+             */
+            await list({ registry, mine: flags.mine === true });
             break;
         case "add": {
             const slug = args[0];

package/dist/registry.js

@@ -25,6 +25,24 @@ export async function fetchList(base) {
     const body = (await res.json());
     return body.designSystems ?? [];
 }
+/**
+ * OS SISTEMAS DELA - e esta é a chamada que exige conta.
+ *
+ * `fetchList` traz a galeria pública e funciona deslogado. Esta responde sobre o
+ * que pertence a alguém, então um 401 aqui é uma resposta e não uma falha: quem
+ * chama transforma isso na frase que manda rodar `login`.
+ */
+export async function fetchMine(base) {
+    const res = await request(`${base}/api/registry/mine`);
+    if (res.status === 401) {
+        throw new RegistryError("This lists your own systems, so it needs an account. Run `synthesisui login` and try again.");
+    }
+    if (!res.ok) {
+        throw new RegistryError(`Registry responded ${res.status} while listing.`);
+    }
+    const body = (await res.json());
+    return body.designSystems ?? [];
+}
 /**
  * Fetches a published DS already compiled (document + artifacts). Without
  * `version` it returns the latest; with `version` it returns that one.

package/package.json

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