synthesisui 0.16.509 → 0.16.511

package/dist/commands/init.js

@@ -1,14 +1,27 @@
+import { existsSync } from "node:fs";
 import { readFile, writeFile } from "node:fs/promises";
 import { join } from "node:path";
 import { DEFAULT_CONFIG, resolveRegistry, writeProjectConfig, } from "../config.js";
 import { readProjectTheme, writeBesideTheirs, writeNewProjectRoot, writeNewProjectTheme, } from "../new-project-theme.js";
 import { openTheDoor } from "../door.js";
 import { body, section, snippet } from "../output.js";
-import { fetchDesignSystem } from "../registry.js";
+import { fetchDesignSystem, RegistryError } from "../registry.js";
 import { resolveDeps, stylesFor, tailwindMajor } from "../stack.js";
 import { formMix, measuredStyle } from "../styles-flavour.js";
 import { desligarCaptura, ligarCaptura } from "../transcript.js";
 import { add } from "./add.js";
+/** A recusa de uma pasta sem app: o que falta, quem cria, e o mesmo `init` para depois. */
+export const noAppHere = (ds) => [
+    "There is no app here - this folder has no package.json.",
+    "init sets SynthesisUI up inside an app that already exists; it does not create one.",
+    "Create the Next.js app first, then run init inside it:",
+    "",
+    "    npx create-next-app@latest my-app",
+    "    cd my-app",
+    `    npx synthesisui@latest init${ds ? ` --ds ${ds}` : ""}`,
+    "",
+    "Nothing was written here.",
+].join("\n");
 const whereOf = (answer) => answer === "file" || answer === "1"
     ? "file"
     : answer === "separate" || answer === "2"
@@ -51,6 +64,17 @@ async function askWhere(tokensFile, separate, entry, intro) {
  */
 export async function init(opts) {
     const root = opts.dir ?? process.cwd();
+    /**
+     * SEM APP, O `init` RECUSA ANTES DE ESCREVER - jornada "o CLI na primeira página", E01 (12/10, medido de novo na
+     * 0.16.509 em 23/10). Numa pasta vazia, `init --target next --ds moss` escrevia `_synthesisui/`, baixava o sistema e
+     * mandava rodar o `connect`, sem dizer que não havia app nenhum. E a pasta que ficava atrás travava o passo que
+     * faltava: o `create-next-app` recusa um diretório com arquivos que ele não conhece, e `_synthesisui/` é um deles.
+     *
+     * O `init` não cria o app - quem cria é o `create-next-app`, e a recusa diz o comando. `--target general` é o caso
+     * sem Next, e segue sem `package.json`.
+     */
+    if (opts.target !== "general" && !existsSync(join(root, "package.json")))
+        throw new RegistryError(noAppHere(opts.ds));
     /**
      * O SISTEMA EXISTE ANTES DE QUALQUER ARQUIVO - bateria ampliada, item 21 (29/09). `init --ds teste-nunca-existiu`
      * recusava bem ("No design system ... that this machine can see"), mas só depois de escrever `_synthesisui/config.json`,

package/dist/commands/template.js

@@ -2,7 +2,7 @@ import { mkdir, stat, writeFile } from "node:fs/promises";
 import { dirname, join, relative } from "node:path";
 import { readProjectConfig, resolveRegistry } from "../config.js";
 import { installedSheetCss, RECIPE_HEADER, recipeRulesFor, } from "../recipe-css.js";
-import { fetchDesignSystem, fetchTemplate } from "../registry.js";
+import { fetchDesignSystem, fetchPages, fetchTemplate } from "../registry.js";
 import { inTheirTongue, projectTongue, tongueFromArtifacts, } from "../their-tongue.js";
 import { keptLine, recordWritten, editedHere as theirEdits, } from "../written.js";
 /**
@@ -46,6 +46,28 @@ function withoutTheSheetInstruction(code) {
  * path classes; the co-located CSS (Next target) carries the responsive media
  * queries + the CSS-only hamburger, so it re-vests once `tokens.css` is in.
  */
+/**
+ * `template <slug>` SEM NOME - as páginas prontas do sistema (jornada "o CLI na primeira página", E02). Antes, a única
+ * resposta era pedir os dois argumentos, e o nome só se descobria tentando. Sem página nenhuma, o caminho que existe é
+ * a landing por seções, e a lista diz isso em vez de ficar vazia.
+ */
+export async function listPages(slug, registry) {
+    const pages = await fetchPages(resolveRegistry(registry), slug);
+    if (pages === null) {
+        console.log(`The registry did not list the pages of "${slug}". Try \`synthesisui template ${slug} <name>\`.`);
+        return;
+    }
+    if (pages.length === 0) {
+        console.log(`"${slug}" has no ready pages.`);
+        console.log(`A landing is put together from its sections: synthesisui landing ${slug} "<what the page is for>"`);
+        return;
+    }
+    console.log(`"${slug}" has ${pages.length} ready page${pages.length === 1 ? "" : "s"}:`);
+    for (const page of pages)
+        console.log(`  ${page}`);
+    console.log("");
+    console.log(`  synthesisui template ${slug} ${pages[0]}`);
+}
 export async function template(slug, name, opts) {
     const base = resolveRegistry(opts.registry);
     const root = opts.dir ?? process.cwd();

package/dist/index.js

@@ -34,7 +34,7 @@ import { request } from "./commands/request.js";
 import { status } from "./commands/status.js";
 import { summary } from "./commands/summary.js";
 import { sync } from "./commands/sync.js";
-import { template } from "./commands/template.js";
+import { listPages, template } from "./commands/template.js";
 import { upgrade } from "./commands/upgrade.js";
 import { use } from "./commands/use.js";
 import { appendEvent } from "./doctor/ledger.js";
@@ -62,6 +62,7 @@ Usage - deterministic, FREE:
   synthesisui blueprint | component        the same command, spelled in full
   synthesisui template <slug> <name>       materialize a whole page from a DS template
                                            (--as landing-home names the output - multi-page safe)
+  synthesisui template <slug>              the ready pages that system has
   synthesisui upgrade <slug>               update an installed DS + regenerate your components + migration brief
   synthesisui colours [slug]               write the colours you chose on the site into your CSS, in your names (asks first)
   synthesisui use <slug> "<intent>"        print a ready-to-paste agent prompt to build/modify on-system
@@ -172,8 +173,8 @@ Examples:
   synthesisui adopt                        # you already have a system: start here
   synthesisui import --dry                 # see the census before anything is sent
   synthesisui login
-  synthesisui init                         # an empty project: one command, then ask your agent
-  synthesisui init --target next --ds halogen   bootstrap + bring a system in
+  synthesisui init                         # inside a new app (create-next-app first): one command, then ask your agent
+  synthesisui init --ds halogen            # the same, with a system from the gallery
   synthesisui doctor
   synthesisui doctor apps/web packages/ui   # scope the read in a monorepo
   synthesisui doctor --strict
@@ -608,11 +609,16 @@ async function main() {
             }
             const slug = args[0];
             const name = args[1];
-            if (!slug || !name) {
+            if (!slug) {
                 console.error("error: provide slug and template name - `synthesisui template <slug> <name>`");
                 process.exitCode = 1;
                 return;
             }
+            /** SEM NOME, A LISTA - o que o sistema tem, em vez de pedir um nome que só se descobre tentando (E02, 12/10). */
+            if (!name) {
+                await listPages(slug, registry);
+                return;
+            }
             let version;
             if (typeof flags.version === "string") {
                 version = Number.parseInt(flags.version.replace(/^v/i, ""), 10);

package/dist/registry.js

@@ -70,6 +70,23 @@ export async function fetchDesignSystem(base, slug, version) {
  * Fetches a whole page generated from a DS template (`?template=&target=`). The
  * server codegens it from `document.layouts[<template>]`; the CLI just writes it.
  */
+/**
+ * AS PÁGINAS PRONTAS DE UM SISTEMA - `template <slug>` sem nome (jornada "o CLI na primeira página", E02). `null` quando
+ * o registro ainda não sabe responder (anterior a `?pages=1`): ele devolve o documento, que não tem `pages`.
+ */
+export async function fetchPages(base, slug) {
+    const url = new URL(`${base}/api/registry/ds/${encodeURIComponent(slug)}`);
+    url.searchParams.set("pages", "1");
+    const res = await request(url.toString());
+    if (res.status === 404)
+        throw new RegistryError(`No design system "${slug}" that this machine can see. \`synthesisui list\` shows what is public.`);
+    if (!res.ok)
+        throw new RegistryError(`Registry responded ${res.status} while listing the pages of "${slug}".`);
+    const body = (await res.json().catch(() => ({})));
+    return Array.isArray(body.pages)
+        ? body.pages.filter((p) => typeof p === "string")
+        : null;
+}
 export async function fetchTemplate(base, slug, template, target, version, as_) {
     const url = new URL(`${base}/api/registry/ds/${encodeURIComponent(slug)}`);
     url.searchParams.set("template", template);

package/package.json

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