synthesisui 0.16.395 → 0.16.396

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.395",
+  "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": {