synthesisui 0.16.488 → 0.16.490

package/dist/claude-md.js

@@ -467,7 +467,8 @@ written now** - read the code before you edit it, never a remembered signature.`
         ? `
 
 **Their page blueprints are on:** call \`preferences\` with the page's kind before building one, unless
-they say not to (\`synthesisui preferences off\`); a correction to keep is \`remember_preference\`.`
+they say not to (\`synthesisui preferences off\`), for one landing part with its \`section\`; a correction to keep
+is \`remember_preference\`.`
         : "";
     /**
      * O TEMA É DELE - bateria ampliada, item 22 (29/09). Em c01, c02, c05, c17 e c23 o agente mexeu no tema do projeto

package/dist/commands/mcp.js

@@ -16,7 +16,7 @@ import { ruleLine } from "../doctrine.js";
 import { fromCensus } from "../memory/observation.js";
 import { handleRecall, handleRemember, MEMORY_TOOLS } from "../memory/tools.js";
 import { ourSpellingLines } from "../our-spelling.js";
-import { fetchPreferences, isKind, isLayer, PREFERENCE_KINDS, PREFERENCE_LAYERS, preferencesAnswer, readOff, readSelection, sendPiece, } from "../preferences.js";
+import { fetchPreferences, isKind, isLayer, isSection, PREFERENCE_KINDS, PREFERENCE_LAYERS, preferencesAnswer, readOff, readSelection, SECTIONS, sendPiece, } from "../preferences.js";
 import { readInstalledConvention } from "../project-facts.js";
 import { repoStateOf } from "../repo-state.js";
 import { detectStack } from "../stack.js";
@@ -370,7 +370,7 @@ const TOOLS = [
      */
     {
         name: "preferences",
-        description: "The person's OWN preference blueprint for a kind of page - how they like a landing, a blog article or a dashboard built (structure, behavior, view), kept in their account and shared by all their projects. Call this BEFORE building or reshaping a page of one of these kinds - their blueprints are on by default, so a plain \"make me a landing page\" gets them too. Skip it only when the request says to build without them; a project that turned them off answers so itself. The rules name roles and steps; you resolve them to this project's --ds-* variables.",
+        description: "The person's OWN preference blueprint for a kind of page - how they like a landing, a blog article or a dashboard built (structure, behavior, view), kept in their account and shared by all their projects. Call this BEFORE building or reshaping a page of one of these kinds - their blueprints are on by default, so a plain \"make me a landing page\" gets them too. Skip it only when the request says to build without them; a project that turned them off answers so itself. Building ONE part of a landing (a hero, the pricing or offer cards, testimonials, the closing call, the footer) - most of all when the person adds one part per message - call it again with that `section` for each part. Too vague to tell what kind of page is being built? Ask one short question first instead of guessing. The rules name roles and steps; you resolve them to this project's --ds-* variables.",
         inputSchema: {
             type: "object",
             properties: {
@@ -379,6 +379,11 @@ const TOOLS = [
                     enum: [...PREFERENCE_KINDS],
                     description: "Which kind of page is being built.",
                 },
+                section: {
+                    type: "string",
+                    enum: [...SECTIONS],
+                    description: "Only with kind landing, when ONE part is being built now: hero, pricing (offer or product cards with prices), testimonials, closing (the last call to action), footer. Omit for the whole page or a part outside this list.",
+                },
             },
             required: ["kind"],
         },
@@ -1939,7 +1944,10 @@ cli) {
             const token = await readToken();
             if (!token)
                 return fromContract("Not signed in, so the person's preferences cannot be read. They have to run `synthesisui login` once in the terminal - it opens a browser, and I cannot complete it for them.");
-            const prefs = await fetchPreferences({ base: resolveRegistry(), token }, kind);
+            const section = args.section;
+            if (section !== undefined && (kind !== "landing" || !isSection(section)))
+                return fromContract(`section goes with kind landing and is one of ${SECTIONS.join(", ")} - for any other part, call with the kind alone.`);
+            const prefs = await fetchPreferences({ base: resolveRegistry(), token }, kind, section, await installedSlug(root));
             if ("failed" in prefs)
                 return fromContract(`Their preferences could not be read: ${prefs.failed}. Build with the system as usual and say so in one line.`);
             return preferencesAnswer(kind, prefs, await readSelection(root), await readOff(root));

package/dist/doctor/transcribe.js

@@ -2719,12 +2719,59 @@ export function rootClasses(source, name) {
     const own = ownClassNameExpr(tag);
     if (own == null)
         return [];
-    // Every string literal inside the className expression. Template literals and
-    // computed values are skipped on purpose: a class we cannot see in full is a
-    // class we would be guessing at.
-    return [...own.matchAll(/["']([^"']+)["']/g)]
-        .flatMap((m) => m[1].split(/\s+/))
-        .filter((c) => c.length > 0 && !c.includes("${"));
+    /**
+     * O TEXTO FIXO DE UM TEMPLATE TAMBÉM É CLASSE ESCRITA - dono, 04/10 18:28Z, no PASS com a conta zerada: o botão do
+     * projeto importado chegou sem centralizar e de canto reto. O `Button.tsx` dele escreve
+     *
+     *     className={`inline-flex items-center justify-center gap-2 rounded-pill font-medium ${variants[variant]} ${sizes[size]} ${className}`}
+     *
+     * e esta função pulava template inteiro ("a class we cannot see in full"). Só que o texto FORA do `${}` se vê
+     * inteiro: o que não se vê é a classe COLADA numa interpolação (`p-${n}`, `${tone}-500`). Então entram as classes
+     * inteiras do texto fixo, e a colada continua de fora. O que vem DENTRO de `${}` é cálculo (o mapa da variante, uma
+     * condição) e não é lido daqui - as variantes têm o leitor delas.
+     */
+    const fromTemplates = [];
+    const outside = own.replace(/`(?:\\[\s\S]|\$\{(?:[^{}]|\{[^{}]*\})*\}|[^`\\])*`/g, (lit) => {
+        fromTemplates.push(...templateStatics(lit.slice(1, -1)));
+        return " ";
+    });
+    // Every string literal inside the className expression - outside a template.
+    return [
+        ...[...outside.matchAll(/["']([^"']+)["']/g)].flatMap((m) => m[1].split(/\s+/)),
+        ...fromTemplates,
+    ].filter((c) => c.length > 0 && !c.includes("${"));
+}
+/**
+ * As classes INTEIRAS do texto fixo de um template: cada `${...}` vira uma marca, e a classe que encosta nela (sem
+ * espaço no meio) sai - ela só existe completa depois do cálculo.
+ */
+export function templateStatics(body) {
+    let out = "";
+    for (let i = 0; i < body.length; i++) {
+        if (body[i] === "\\") {
+            out += body[i + 1] ?? "";
+            i++;
+            continue;
+        }
+        if (body[i] === "$" && body[i + 1] === "{") {
+            let depth = 0;
+            let j = i + 1;
+            for (; j < body.length; j++) {
+                if (body[j] === "{")
+                    depth++;
+                else if (body[j] === "}") {
+                    depth--;
+                    if (depth === 0)
+                        break;
+                }
+            }
+            out += "\u0000";
+            i = j;
+            continue;
+        }
+        out += body[i];
+    }
+    return out.split(/\s+/).filter((c) => c.length > 0 && !c.includes("\u0000"));
 }
 /**
  * A EXPRESSÃO do `className` que é atributo DIRETO desta tag de abertura, ou `null`.

package/dist/install-marks.js

@@ -319,7 +319,7 @@
  * linha das preferências da pessoa - `preferences` quando ela pede, `remember_preference` quando ela corrige. Uma pasta
  * escrita antes não diz ao agente que essas portas existem.
  */
-export const MATERIALISER_SINCE = "0.16.488";
+export const MATERIALISER_SINCE = "0.16.489";
 /**
  * A ÚLTIMA VERSÃO EM QUE O QUE O HOOK RODA MUDOU.
  *

package/dist/preferences.js

@@ -16,6 +16,18 @@ import { join } from "node:path";
  */
 export const PREFERENCE_KINDS = ["landing", "blog", "dashboard"];
 export const PREFERENCE_LAYERS = ["structure", "behavior", "view"];
+/**
+ * AS PARTES DA LANDING - a jornada "o agente reconhece o que se constrói" (03/10). Quem pede por partes ("coloca a
+ * hero", "agora o rodapé") recebe, a cada parte, a estrutura daquela parte (apps/web lib/ds/section-structural.ts).
+ */
+export const SECTIONS = [
+    "hero",
+    "pricing",
+    "testimonials",
+    "closing",
+    "footer",
+];
+export const isSection = (s) => typeof s === "string" && SECTIONS.includes(s);
 export const isKind = (k) => typeof k === "string" && PREFERENCE_KINDS.includes(k);
 export const isLayer = (l) => typeof l === "string" && PREFERENCE_LAYERS.includes(l);
 /** Onde o projeto guarda quais blueprints dela ele usa - versionado, porque é decisão do projeto. */
@@ -83,8 +95,20 @@ export function chosen(all, selection) {
     const want = new Set(selection.map((s) => s.toLowerCase()));
     return all.filter((b) => want.has(b.name.toLowerCase()) || want.has(b.id.toLowerCase()));
 }
-export async function fetchPreferences(reach, kind) {
-    const res = await fetch(`${reach.base}/api/preferences${kind ? `?kind=${kind}` : ""}`, { headers: { Authorization: `Bearer ${reach.token}` } }).catch(() => null);
+export async function fetchPreferences(reach, kind, section, 
+/** O projeto instalado aqui - a estrutura que vale é a dele ("a alma da estrutura", 04/10). */
+ds) {
+    const params = new URLSearchParams();
+    if (kind)
+        params.set("kind", kind);
+    if (kind && section)
+        params.set("section", section);
+    if (ds)
+        params.set("ds", ds);
+    const q = params.size ? `?${params}` : "";
+    const res = await fetch(`${reach.base}/api/preferences${q}`, {
+        headers: { Authorization: `Bearer ${reach.token}` },
+    }).catch(() => null);
     if (!res)
         return { failed: "the platform could not be reached" };
     if (!res.ok)
@@ -165,13 +189,28 @@ function craftOf(kind, prefs) {
     const lines = prefs.craft?.[kind] ?? [];
     if (lines.length === 0)
         return [];
+    // a estrutura só existe para a landing: é ela que o rhythm e o type abaixo trazem
+    const structure = kind === "landing" && prefs.structure
+        ? ` with THIS project's structure, "${prefs.structure.name}"${prefs.structure.chosen ? "" : " (the default - they can pick another under Structure on the site)"}`
+        : "";
     return [
         "",
-        `HOW THIS PLATFORM BUILDS A ${kind.toUpperCase()} - the same rules its guide uses; their blueprint wins where the two disagree:`,
+        `HOW THIS PLATFORM BUILDS A ${kind.toUpperCase()}${structure} - the same rules its guide uses; their blueprint wins where the two disagree:`,
         ...lines.map((l) => `- ${l}`),
     ];
 }
-/** A resposta da ferramenta `preferences` - lida SÓ quando o pedido diz para usar as preferências dela. */
+/** A parte que se constrói agora vem PRIMEIRO: é dela que o turno trata. */
+function sectionOf(prefs) {
+    const s = prefs.section;
+    if (!s || s.lines.length === 0)
+        return [];
+    return [
+        `THE PART BEING BUILT NOW - the ${s.name} of this landing, as this platform builds it:`,
+        ...s.lines.map((l) => `- ${l}`),
+        "",
+    ];
+}
+/** A resposta da ferramenta `preferences` - ligada por padrão (03/10), e a cada parte da landing com a `section`. */
 export function preferencesAnswer(kind, prefs, selection, 
 /** O projeto desligou os blueprints (`synthesisui preferences off`). */
 off = false) {
@@ -184,9 +223,15 @@ off = false) {
             ? `The person has no ${kind} preference blueprint yet.`
             : `The person has ${mine.length} ${kind} blueprint(s) (${mine.map((b) => `"${b.name}"`).join(", ")}), but this project chose others in _synthesisui/preferences.json.`;
         // não ter preferência não é lacuna do sistema: é uma resposta verdadeira, e não entra na conta de lacunas
-        return composed(`${why} Build the ${kind} with the system as usual, and tell them in one line that they can keep their ${kind} preferences under Memory -> Preference blueprints on the site.`, `preferences:${kind}:0`);
+        return composed([
+            ...sectionOf(prefs),
+            `${why} Build the ${kind} with the system as usual, and tell them in one line that they can keep their ${kind} preferences under Memory -> Preference blueprints on the site.`,
+            // a estrutura do projeto vale com ou sem blueprint: ela é do projeto, não da pessoa
+            ...craftOf(kind, prefs),
+        ].join("\n"), `preferences:${kind}:0${prefs.section ? `:${prefs.section.name}` : ""}`);
     }
     return composed([
+        ...sectionOf(prefs),
         `The person's preference blueprint${use.length > 1 ? "s" : ""} for a ${kind} - THEIR preferences, kept by them across projects:`,
         "",
         ...use.map(describeBlueprint),
@@ -196,5 +241,5 @@ off = false) {
         "- They win over generic page craft when the two disagree; this system's tokens and rules still win over them.",
         `- When you finish, tell them in ONE line which blueprint you applied${use.length > 1 ? " (if more than one fits, use the first and name it)" : ""}, and any rule you could not follow and why.`,
         ...craftOf(kind, prefs),
-    ].join("\n"), `preferences:${kind}:${use.length}`);
+    ].join("\n"), `preferences:${kind}:${use.length}${prefs.section ? `:${prefs.section.name}` : ""}`);
 }

package/package.json

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