synthesisui 0.16.394 → 0.16.396

package/dist/doctor/style-ledger.js

@@ -450,6 +450,26 @@ export function describeValueRuler(values) {
     const decisions = values.seen - values.structure;
     const closed = values.interpreted + values.answered;
     const percent = decisions > 0 ? Math.round((closed / decisions) * 100) : 0;
+    /**
+     * NADA PARA MEDIR NÃO É ZERO POR CENTO - e a frase dizia zero três vezes.
+     *
+     * O QUE O CLIENTE VIA, caminhado em 07/09 num `create-next-app` recém-criado: *"Of the 0 class
+     * declarations on your components, 0 are structure. Of the 0 design decisions, 0 are interpreted -
+     * 0%."* Três zeros e um 0% sobre um projeto onde a régua não tinha o que medir, porque ele ainda
+     * não escreveu um componente - só páginas, e uma página não é componente de design system, o que o
+     * próprio relatório explica seis linhas acima.
+     *
+     * `0%` é um número de DESEMPENHO, e ali não houve desempenho nenhum. É a lei 14 do `CLAUDE.md`:
+     * *"um zero pelado lê como falha nossa; um zero com motivo lê como fato"* - e para quem acabou de
+     * apontar a plataforma para o próprio projeto, uma linha de 0% é a primeira impressão.
+     *
+     * A frase que substitui diz o FATO e o caminho, sem inventar percentual: não há componente para
+     * medir ainda.
+     */
+    if (values.seen === 0)
+        return [
+            "No component of yours carries a class declaration yet - so there is nothing for this ruler to read. It starts answering once a component exists, and pages do not count as components.",
+        ];
     return [
         `Of the ${values.seen} class declarations on your components, ${values.structure} are structure (layout plumbing, not design decisions). Of the ${decisions} design decisions, ${closed} are interpreted${values.answered > 0 ? ` (${values.answered} of them answered by you)` : ""} - ${percent}%.`,
     ];

package/dist/index.js

@@ -34,6 +34,7 @@ import { appendEvent } from "./doctor/ledger.js";
 import { blueprintTarget, installedSlugs } from "./installed.js";
 import { useLang } from "./lang.js";
 import { RegistryError } from "./registry.js";
+import { bearing, openingFor } from "./where-you-are.js";
 /** Our own version, for pinning the hook and MCP commands we write into a
  *  project. Read from the package we are running out of, so a pinned command
  *  always names the version that produced it. */
@@ -155,6 +156,21 @@ async function main() {
     const { positionals, flags } = parseFlags(process.argv.slice(2));
     const [command, ...args] = positionals;
     if (!command || flags.help || command === "help") {
+        /**
+         * A PRIMEIRA LINHA FALA DO PROJETO ONDE ELA FOI RODADA - ver `where-you-are.ts`.
+         *
+         * A lista continua inteira logo abaixo. O que muda é que quem digita `npx synthesisui` pela
+         * primeira vez lê uma frase sobre o próprio repositório antes de 113 linhas que serviam
+         * igualmente a um diretório vazio.
+         *
+         * Só na tela SEM comando: `--help` e `help` são um pedido pela lista, e enfeitar um pedido
+         * explícito é o oposto de responder a ele.
+         */
+        if (!command && !flags.help) {
+            const root = typeof flags.dir === "string" ? flags.dir : process.cwd();
+            for (const line of openingFor(await bearing(root)))
+                console.log(line);
+        }
         console.log(HELP);
         return;
     }

package/dist/where-you-are.js

@@ -0,0 +1,78 @@
+import { readdir, stat } from "node:fs/promises";
+import { join } from "node:path";
+const exists = async (path) => stat(path).then(() => true, () => false);
+const SKIP = new Set(["node_modules", ".next", ".git", "dist", "build", "out"]);
+/**
+ * Existe folha de estilo aqui? Para no PRIMEIRO acerto - a pergunta é "existe", não "quantas", e
+ * quantas é a resposta que o `doctor` dá depois de ser chamado.
+ */
+async function anyStylesheet(dir, depth = 2) {
+    const entries = await readdir(dir, { withFileTypes: true }).catch(() => []);
+    for (const e of entries) {
+        if (e.isFile() && /\.(css|scss|sass|less)$/i.test(e.name))
+            return true;
+    }
+    if (depth <= 0)
+        return false;
+    for (const e of entries) {
+        if (!e.isDirectory() || SKIP.has(e.name) || e.name.startsWith("."))
+            continue;
+        if (await anyStylesheet(join(dir, e.name), depth - 1))
+            return true;
+    }
+    return false;
+}
+export async function bearing(root) {
+    if (!(await exists(join(root, "package.json"))))
+        return { where: "no-project", slug: null, hasStyles: false };
+    const installed = (await readdir(join(root, "_synthesisui", "ds"), {
+        withFileTypes: true,
+    }).catch(() => [])).filter((e) => e.isDirectory());
+    const hasStyles = await anyStylesheet(root);
+    if (installed.length > 0)
+        return {
+            where: "system-installed",
+            slug: installed[0]?.name ?? null,
+            hasStyles,
+        };
+    if (await exists(join(root, "_synthesisui", "config.json")))
+        return { where: "configured-without-system", slug: null, hasStyles };
+    return { where: "project-untouched", slug: null, hasStyles };
+}
+/**
+ * A ABERTURA: uma linha sobre ESTE projeto, e o comando que responde a partir daqui.
+ *
+ * Não substitui a lista - ela continua inteira logo abaixo. O que muda é que a primeira coisa que a
+ * pessoa lê fala do repositório onde ela está, em vez de um sistema da galeria que ela não tem.
+ */
+export function openingFor(b) {
+    if (b.where === "no-project")
+        return [
+            "  There is no package.json here, so there is no project to read yet.",
+            "  Run this from your project's root, or browse what exists:",
+            "      synthesisui list",
+            "",
+        ];
+    if (b.where === "system-installed")
+        return [
+            `  ${b.slug} is installed here.`,
+            "  This tells you what your code still writes outside it, and what --fix can swap:",
+            "      synthesisui doctor",
+            "",
+        ];
+    if (b.where === "configured-without-system")
+        return [
+            "  This project is configured, and no design system is installed yet.",
+            "  This reads what you already have and turns it into one - local, free, nothing is sent:",
+            "      synthesisui import --dry",
+            "",
+        ];
+    return [
+        b.hasStyles
+            ? "  A project with its own CSS, and nothing of ours in it yet."
+            : "  A project with no design values written yet - so this starts empty and stays honest about it.",
+        "  This reads what is here and tells you what has a name and what does not:",
+        "      synthesisui doctor",
+        "",
+    ];
+}

package/package.json

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