npm - onboarding-kit - Versions diffs - 0.1.0 → 0.2.0 - Mend

onboarding-kit 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (16) hide show

package/dist/render/index.js CHANGED Viewed

@@ -4,6 +4,7 @@ exports.escapeHtml = void 0;
 exports.renderMissingPage = renderMissingPage;
 exports.renderErrorPage = renderErrorPage;
 exports.renderOnboarding = renderOnboarding;
+const brand_1 = require("../brand");
 const load_1 = require("../load");
 const template_1 = require("../template");
 const assets_1 = require("./assets");
@@ -14,39 +15,97 @@ var html_2 = require("./html");
 Object.defineProperty(exports, "escapeHtml", { enumerable: true, get: function () { return html_2.escapeHtml; } });
 const ICON_GRID = '<svg viewBox="0 0 20 20" aria-hidden="true"><path fill="currentColor" d="M3 3h5.5v5.5H3zM11.5 3H17v5.5h-5.5zM3 11.5h5.5V17H3zM11.5 11.5H17V17h-5.5z" opacity=".9"/></svg>';
 const ICON_THEME = '<svg viewBox="0 0 20 20" aria-hidden="true"><circle cx="10" cy="10" r="7" fill="none" stroke="currentColor" stroke-width="1.6"/><path d="M10 3a7 7 0 0 1 0 14z" fill="currentColor"/></svg>';
-function shell(lang, title, body, opts = {}) {
+const HUE_OFFSETS = [0, 18, -18, 36, -36];
+/**
+ * Tema a partir das cores da marca. Sem cores, mantém a paleta própria do kit.
+ * Com uma cor, os capítulos variam levemente em torno dela; com várias, se revezam entre elas.
+ * Marcas sem cor (preto/cinza) viram um tema monocromático.
+ */
+function themeFor(brand) {
+    const chromatic = brand.colors.filter((c) => !(0, brand_1.isAchromatic)(c)).map((c) => ({ ...c, h: Math.round(c.h) }));
+    const ref = chromatic[0] ?? (brand.colors[0] && { ...brand.colors[0], h: Math.round(brand.colors[0].h) });
+    if (!ref)
+        return { brand, hues: copy_1.CHAPTER_HUES, hue: copy_1.CHAPTER_HUES.welcome, css: "", mono: false };
+    const mono = chromatic.length === 0;
+    const hues = { ...copy_1.CHAPTER_HUES };
+    hues.welcome = hues.finale = ref.h;
+    slides_1.CHAPTERS.forEach(([id], i) => {
+        hues[id] = chromatic.length > 1 ? chromatic[i % chromatic.length].h : (ref.h + HUE_OFFSETS[i % HUE_OFFSETS.length] + 360) % 360;
+    });
+    const k = mono ? 0 : Math.round(Math.min(1, ref.s / 55) * 100) / 100;
+    const h2 = chromatic[1]?.h ?? (ref.h + 28) % 360;
+    const css = `:root{--brand-h:${ref.h};--h2:${h2};--k:${k};--brand-c:hsl(${ref.h} calc(var(--as) * ${k}) var(--al));--brand-on:var(--on-accent)}`;
+    return { brand, hues, hue: ref.h, css, mono };
+}
+function shell(lang, title, body, theme, opts = {}) {
+    const palette = theme.brand.colors.map(brand_1.toHex).join(" ");
     return `<!doctype html>
-<html lang="${(0, html_1.escapeHtml)(lang)}">
+<html lang="${(0, html_1.escapeHtml)(lang)}"${theme.mono ? " data-mono" : ""}${palette ? ` data-palette="${palette}"` : ""}>
 <head>
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <meta name="robots" content="noindex">
 <title>${(0, html_1.escapeHtml)(title)}</title>
+${theme.brand.favicon ? `<link rel="icon" href="${(0, html_1.escapeHtml)(theme.brand.favicon)}">` : ""}
+${theme.brand.colors[0] ? `<meta name="theme-color" content="${(0, brand_1.toHex)(theme.brand.colors[0])}">` : ""}
 ${assets_1.FONTS}
-<style>${assets_1.CSS}</style>
+<style>${assets_1.CSS}${theme.css}</style>
 </head>
-<body${opts.solo ? ' class="solo"' : ""}>
+<body${opts.solo ? ' class="solo"' : ""}${opts.state ? ` data-ok-state="${opts.state}"` : ""}>
+<div class="backdrop" id="ok-backdrop" style="--bh:${theme.hue}" aria-hidden="true"><i></i><i></i><i></i></div>
 ${body}
 <script>${assets_1.JS}</script>
 ${opts.mermaid ? `<script src="${assets_1.MERMAID_URL}" onload="window.__okMermaid&&window.__okMermaid()"></script>` : ""}
 </body>
 </html>`;
 }
-function soloPage(lang, t, heading, body, code, isError = false) {
-    const block = isError
-        ? `<pre>${(0, html_1.escapeHtml)(code)}</pre>`
-        : `<div class="prompt"><pre>${(0, html_1.escapeHtml)(code)}</pre><button type="button" class="copy" data-copy="${(0, html_1.escapeHtml)(code)}" data-done="${(0, html_1.escapeHtml)(t.setup.copied)}">${t.setup.copy}</button></div>`;
-    return shell(lang, "Onboarding", `<div class="solo-wrap"><div class="solo-card"><p class="kicker"><span class="num">👋</span>onboarding-kit</p><h1>${(0, html_1.escapeHtml)(heading)}</h1>${body ? `<p>${(0, html_1.escapeHtml)(body)}</p>` : ""}${block}</div></div>`, { solo: true });
+function logoImg(theme, cls) {
+    return theme.brand.logo ? `<span class="${cls}"><img src="${(0, html_1.escapeHtml)(theme.brand.logo)}" alt=""></span>` : "";
+}
+function soloHead(theme, name, heading, body) {
+    const kicker = `<p class="kicker"><span class="num">👋</span>${(0, html_1.escapeHtml)(name ?? "onboarding-kit")}</p>`;
+    return `${logoImg(theme, "solo-logo")}${kicker}<h1>${(0, html_1.escapeHtml)(heading)}</h1>${body ? `<p>${(0, html_1.escapeHtml)(body)}</p>` : ""}`;
+}
+function promptBlock(t, prompt) {
+    return `<ol class="solo-steps">${t.pending.steps.map((step, i) => `<li><b>${i + 1}</b><span>${(0, html_1.escapeHtml)(step)}</span></li>`).join("")}</ol>
+<div class="prompt-box"><pre class="prompt-text">${(0, html_1.escapeHtml)(prompt)}</pre><button type="button" class="cta copy-cta" data-copy="${(0, html_1.escapeHtml)(prompt)}" data-done="✓ ${(0, html_1.escapeHtml)(t.pending.copied)}">${(0, html_1.escapeHtml)(t.pending.copy)}</button></div>`;
 }
-function renderMissingPage() {
+function waiting(t) {
+    return `<p class="waiting" aria-live="polite"><span class="pulse" aria-hidden="true"></span>${(0, html_1.escapeHtml)(t.pending.waiting)}</p>`;
+}
+/** Seções do JSON acompanhadas na tela de espera enquanto a IA preenche. */
+const PROGRESS_SECTIONS = ["project", "business", "features", "domain", "stack", "architecture", "gettingStarted", "conventions", "tours", "gotchas", "decisions", "firstTasks", "brand"];
+function progressBlock(data, t) {
+    const items = PROGRESS_SECTIONS.map((key) => ({ key, done: !(0, load_1.isBlank)(data[key]) }));
+    const done = items.filter((i) => i.done).length;
+    return `<div class="progress" id="ok-progress"><p class="mini-label">${(0, html_1.escapeHtml)(t.pending.progress.replace("{done}", String(done)).replace("{total}", String(items.length)))}</p><div class="progress-bar"><span style="width:${Math.round((done / items.length) * 100)}%"></span></div><ul class="progress-list">${items
+        .map((i) => `<li data-key="${i.key}"${i.done ? ' class="is-done"' : ""}>${(0, html_1.escapeHtml)(t.pending.sections[i.key])}</li>`)
+        .join("")}</ul></div>`;
+}
+function soloPage(lang, title, inner, theme, state) {
+    return shell(lang, title, `<div class="solo-wrap" style="--h:${theme.hue}"><div class="solo-card">${inner}</div></div>`, theme, { solo: true, state });
+}
+function renderMissingPage(root) {
     const t = (0, copy_1.copyFor)("pt-BR");
-    return soloPage("pt-BR", t, t.missing.title, t.missing.body, "npx onboarding-kit init");
+    const theme = themeFor((0, brand_1.resolveBrand)(undefined, root));
+    const name = (0, brand_1.packageName)(root);
+    const inner = `${soloHead(theme, name, t.missing.title, t.missing.body)}${promptBlock(t, (0, template_1.aiPrompt)(undefined, { init: true }))}${waiting(t)}<p class="manual">${(0, html_1.escapeHtml)(t.missing.manual)} <code>npx onboarding-kit init</code></p>`;
+    return soloPage("pt-BR", name ? `${name} · Onboarding` : "Onboarding", inner, theme, "missing");
 }
-function renderErrorPage(message) {
+function renderErrorPage(message, root) {
     const t = (0, copy_1.copyFor)("pt-BR");
-    return soloPage("pt-BR", t, t.invalid.title, "", message, true);
+    const theme = themeFor((0, brand_1.resolveBrand)(undefined, root));
+    const name = (0, brand_1.packageName)(root);
+    const inner = `${soloHead(theme, name, t.invalid.title, t.invalid.body)}<pre class="error-text">${(0, html_1.escapeHtml)(message)}</pre>${waiting(t)}`;
+    return soloPage("pt-BR", "Onboarding", inner, theme, "error");
+}
+function renderPendingPage(data, root, lang, t) {
+    const theme = themeFor((0, brand_1.resolveBrand)(data, root));
+    const name = data.project?.name?.trim() || (0, brand_1.packageName)(root);
+    const inner = `${soloHead(theme, name, t.pending.title, t.pending.body)}${promptBlock(t, (0, template_1.aiPrompt)())}${waiting(t)}${progressBlock(data, t)}`;
+    return soloPage(lang, name ? `${name} · Onboarding` : "Onboarding", inner, theme, "pending");
 }
-function welcomeSlide(data, t, chapters, minutes) {
+function welcomeSlide(data, t, chapters, minutes, theme) {
     const p = data.project;
     const name = p?.name?.trim() || "Onboarding";
     const generated = data.meta?.generatedAt ? new Date(data.meta.generatedAt) : undefined;
@@ -61,13 +120,14 @@ function welcomeSlide(data, t, chapters, minutes) {
     ].filter(Boolean);
     const journey = chapters
         .filter((c) => c.id !== "welcome" && c.id !== "finale")
-        .map((c) => `<li><button type="button" data-go="${c.start}" style="--ch:${copy_1.CHAPTER_HUES[c.id]}"><span class="n">${c.num}</span>${(0, html_1.escapeHtml)(c.name)}</button></li>`)
+        .map((c) => `<li><button type="button" data-go="${c.start}" style="--ch:${theme.hues[c.id]}"><span class="n">${c.num}</span>${(0, html_1.escapeHtml)(c.name)}</button></li>`)
         .join("");
     return {
         chapter: "welcome",
         kind: "welcome",
         title: t.chapters.welcome,
         html: `<div class="welcome">
+${logoImg(theme, "brand-logo")}
 <p class="hi"><span class="wave" aria-hidden="true">👋</span>${(0, html_1.escapeHtml)(t.welcome.hi)}</p>
 <h1 class="title">${(0, html_1.escapeHtml)(t.welcome.title("")).trim()} <span class="grad">${(0, html_1.escapeHtml)(name)}</span></h1>
 ${p?.tagline ? `<p class="tagline">${(0, html_1.text)(p.tagline)}</p>` : ""}
@@ -78,10 +138,10 @@ ${journey ? `<div class="journey-wrap"><p class="mini-label">${(0, html_1.escape
 </div>`,
     };
 }
-function finaleSlide(t, chapters, hasTasks) {
+function finaleSlide(t, chapters, hasTasks, theme) {
     const recap = chapters
         .filter((c) => c.id !== "welcome" && c.id !== "finale")
-        .map((c) => `<li style="--ch:${copy_1.CHAPTER_HUES[c.id]}">${(0, html_1.escapeHtml)(c.name)}</li>`)
+        .map((c) => `<li style="--ch:${theme.hues[c.id]}">${(0, html_1.escapeHtml)(c.name)}</li>`)
         .join("");
     return {
         chapter: "finale",
@@ -97,13 +157,14 @@ ${hasTasks ? `<p class="task-count" data-task-count data-template="${(0, html_1.
 </div>`,
     };
 }
-function renderOnboarding(data) {
+function renderOnboarding(data, options = {}) {
     const lang = data.meta?.language || "pt-BR";
     const t = (0, copy_1.copyFor)(lang);
     const name = data.project?.name?.trim() || "Onboarding";
     if (data.meta?.status !== "filled") {
-        return soloPage(lang, t, t.pending.title, t.pending.body, (0, template_1.aiPrompt)());
+        return renderPendingPage(data, options.root, lang, t);
     }
+    const theme = themeFor((0, brand_1.resolveBrand)(data, options.root));
     // 1. capítulos do meio, numerados só quando têm conteúdo
     const middle = [];
     let num = 1;
@@ -126,12 +187,13 @@ function renderOnboarding(data) {
     const total = cursor + 1;
     const minutes = Math.max(3, Math.round(total * 0.4));
     const hasTasks = middle.some((c) => c.id === "mission");
-    const slides = [welcomeSlide(data, t, chapters, minutes), ...middle.flatMap((c) => c.slides), finaleSlide(t, chapters, hasTasks)];
+    const slides = [welcomeSlide(data, t, chapters, minutes, theme), ...middle.flatMap((c) => c.slides), finaleSlide(t, chapters, hasTasks, theme)];
+    const chapterNum = (id) => (id === "welcome" ? "👋" : id === "finale" ? "🎉" : String(chapters.find((c) => c.id === id)?.num ?? ""));
     const slideHtml = slides
-        .map((s, i) => `<section class="slide" data-kind="${(0, html_1.escapeHtml)(s.kind ?? s.chapter)}" data-chapter="${s.chapter}" data-chapter-name="${(0, html_1.escapeHtml)(t.chapters[s.chapter])}" style="--h:${copy_1.CHAPTER_HUES[s.chapter]}" aria-roledescription="slide" aria-label="${i + 1} / ${total}" aria-hidden="true"><div class="slide-inner">${s.html}</div></section>`)
+        .map((s, i) => `<section class="slide" data-kind="${(0, html_1.escapeHtml)(s.kind ?? s.chapter)}" data-chapter="${s.chapter}" data-chapter-name="${(0, html_1.escapeHtml)(t.chapters[s.chapter])}" data-chapter-num="${chapterNum(s.chapter)}" style="--h:${theme.hues[s.chapter]}" aria-roledescription="slide" aria-label="${i + 1} / ${total}" aria-hidden="true"><div class="slide-inner">${s.html}</div></section>`)
         .join("\n");
     const segments = chapters
-        .map((c) => `<button type="button" class="seg" data-go="${c.start}" data-start="${c.start}" data-count="${c.count}" style="--h:${copy_1.CHAPTER_HUES[c.id]};--w:${c.count}" title="${(0, html_1.escapeHtml)(c.name)}" aria-label="${(0, html_1.escapeHtml)(c.name)}"><span></span></button>`)
+        .map((c) => `<button type="button" class="seg" data-go="${c.start}" data-start="${c.start}" data-count="${c.count}" style="--h:${theme.hues[c.id]};--w:${c.count}" title="${(0, html_1.escapeHtml)(c.name)}" aria-label="${(0, html_1.escapeHtml)(c.name)}"><span></span></button>`)
         .join("");
     let index = 0;
     const overview = chapters
@@ -140,18 +202,19 @@ function renderOnboarding(data) {
             .slice(c.start, c.start + c.count)
             .map((s) => `<button type="button" data-go="${index++}">${(0, html_1.escapeHtml)(s.title)}</button>`)
             .join("");
-        return `<div class="ov-chapter" style="--ch:${copy_1.CHAPTER_HUES[c.id]}"><h3><span class="n">${c.id === "welcome" ? "👋" : c.id === "finale" ? "🎉" : c.num}</span>${(0, html_1.escapeHtml)(c.name)}</h3>${items}</div>`;
+        return `<div class="ov-chapter" style="--ch:${theme.hues[c.id]}"><h3><span class="n">${chapterNum(c.id)}</span>${(0, html_1.escapeHtml)(c.name)}</h3>${items}</div>`;
     })
         .join("");
     const body = `<div class="deck">
 <header class="topbar">
-<span class="brand">${(0, html_1.escapeHtml)(name)}</span>
+<span class="brand">${logoImg(theme, "brand-mark")}<span class="brand-name">${(0, html_1.escapeHtml)(name)}</span></span>
 <nav class="segments" aria-label="${(0, html_1.escapeHtml)(t.ui.chapters)}">${segments}</nav>
 <button type="button" class="icon-btn" data-overview title="${(0, html_1.escapeHtml)(t.ui.overview)} (O)" aria-label="${(0, html_1.escapeHtml)(t.ui.overview)}">${ICON_GRID}</button>
 <button type="button" class="icon-btn" data-theme-toggle title="${(0, html_1.escapeHtml)(t.ui.theme)}" aria-label="${(0, html_1.escapeHtml)(t.ui.theme)}">${ICON_THEME}</button>
 </header>
 <main class="stage" id="ok-stage">
 ${slideHtml}
+<div class="wipe" id="ok-wipe" aria-hidden="true"><span></span><strong></strong></div>
 </main>
 <footer class="controls">
 <button type="button" class="nav-btn" data-prev aria-label="${(0, html_1.escapeHtml)(t.ui.prev)}">← <span class="txt">${(0, html_1.escapeHtml)(t.ui.prev)}</span></button>
@@ -163,5 +226,5 @@ ${slideHtml}
 <div class="overview-inner"><div class="overview-head"><h2>${(0, html_1.escapeHtml)(t.ui.overview)}</h2><button type="button" class="icon-btn" data-close aria-label="${(0, html_1.escapeHtml)(t.ui.close)}">✕</button></div><div class="ov-grid">${overview}</div></div>
 </div>
 <div class="toast" id="ok-toast" data-template="${(0, html_1.escapeHtml)(t.ui.resume)}" role="status"><span></span><button type="button" class="yes" data-resume="0">${(0, html_1.escapeHtml)(t.ui.resumeYes)}</button><button type="button" data-dismiss>${(0, html_1.escapeHtml)(t.ui.resumeNo)}</button></div>`;
-    return shell(lang, `${name} · Onboarding`, body, { mermaid: slides.some((s) => s.kind === "diagram") && !(0, load_1.isBlank)(data.architecture?.diagram) });
+    return shell(lang, `${name} · Onboarding`, body, theme, { mermaid: slides.some((s) => s.kind === "diagram") && !(0, load_1.isBlank)(data.architecture?.diagram) });
 }

package/dist/template.d.ts CHANGED Viewed

@@ -5,5 +5,10 @@ export interface TemplateOptions {
     language?: string;
 }
 export declare function createTemplate({ framework, language }: TemplateOptions): OnboardingData;
-/** Frase para colar na IA local depois do `init`. */
-export declare function aiPrompt(file?: string): string;
+/**
+ * Frase para colar na IA local. Com `init`, pede para a IA criar o arquivo antes
+ * (usado quando o onboarding.json ainda não existe).
+ */
+export declare function aiPrompt(file?: string, options?: {
+    init?: boolean;
+}): string;

package/dist/template.js CHANGED Viewed

@@ -21,6 +21,7 @@ const SECTION_INSTRUCTIONS = {
     tours: "1 a 3 tours guiados pelo código, ex.: 'Como uma requisição é atendida', 'Ciclo de vida de um pedido'. Cada step aponta um arquivo (com linha quando ajudar) e explica o que olhar ali. Ordene os steps na sequência de leitura.",
     gotchas: "Armadilhas e cuidados: comportamentos não óbvios, partes frágeis, workarounds, TODOs/FIXMEs importantes, coisas que costumam quebrar. Só inclua o que tiver evidence.",
     decisions: "Decisões de arquitetura perceptíveis no código ou na documentação (ex.: por que tal ORM, monorepo, cache, autenticação). context: o problema. decision: o que foi escolhido. Não invente motivos: se o motivo não está documentado, descreva só a decisão.",
+    brand: "Identidade visual, usada para a apresentação ter a cara da plataforma. primaryColor: a cor principal da marca em hex (#RRGGBB). Procure em tailwind.config (theme.extend.colors: brand, primary), no @theme do Tailwind v4 (--color-primary, --color-brand), em variáveis CSS de globals.css/index.css (--primary, --brand; converta HSL/OKLCH para hex), em temas de MUI/Chakra/styled-components (palette.primary.main) e no theme_color do manifest. palette: 1 a 4 outras cores da marca em hex (secundária, destaque). Ignore branco, preto e cinzas quando houver uma cor de verdade. logo: caminho do logo do projeto (procure em public/, assets/, src/assets/, app/icon.*); prefira SVG e a versão para fundo claro; ignore os arquivos de exemplo do framework (next.svg, vercel.svg, vite.svg, react.svg). favicon: caminho do favicon (public/favicon.ico, app/favicon.ico, app/icon.png). evidence: arquivos de onde tirou as cores. Deixe vazio o que não encontrar: o onboarding-kit tenta detectar sozinho.",
     firstTasks: "3 a 5 tarefas pequenas e seguras para alguém novo começar (ex.: um teste faltando, um TODO simples, uma melhoria de mensagem de erro), com os arquivos envolvidos.",
 };
 function createTemplate({ framework, language = "pt-BR" }) {
@@ -80,9 +81,16 @@ function createTemplate({ framework, language = "pt-BR" }) {
         gotchas: [{ title: "", description: "", evidence: [""] }],
         decisions: [{ title: "", context: "", decision: "", evidence: [""] }],
         firstTasks: [{ title: "", description: "", files: [""] }],
+        brand: { primaryColor: "", palette: [""], logo: "", favicon: "", evidence: [""] },
     };
 }
-/** Frase para colar na IA local depois do `init`. */
-function aiPrompt(file = "onboarding.json") {
+/**
+ * Frase para colar na IA local. Com `init`, pede para a IA criar o arquivo antes
+ * (usado quando o onboarding.json ainda não existe).
+ */
+function aiPrompt(file = "onboarding.json", options = {}) {
+    if (options.init) {
+        return `Rode "npx onboarding-kit init" na raiz deste projeto para criar o ${file}. Depois leia o arquivo e siga as instruções em "_instructions" para preenchê-lo com base neste repositório. No final, rode "npx onboarding-kit validate" e corrija o que ele apontar.`;
+    }
     return `Leia o arquivo ${file} e siga as instruções em "_instructions" para preenchê-lo com base neste repositório. No final, rode "npx onboarding-kit validate" e corrija o que ele apontar.`;
 }

package/dist/types.d.ts CHANGED Viewed

@@ -121,6 +121,17 @@ export interface FirstTask {
     description: string;
     files: Evidence[];
 }
+export interface BrandInfo {
+    /** Cor principal da marca em hex (#RRGGBB). */
+    primaryColor: string;
+    /** Outras cores da paleta em hex. */
+    palette: string[];
+    /** Caminho relativo do logo (ex.: public/logo.svg). */
+    logo: string;
+    /** Caminho relativo do favicon (ex.: public/favicon.ico). */
+    favicon: string;
+    evidence: Evidence[];
+}
 export interface OnboardingData {
     $schema?: string;
     _instructions?: unknown;
@@ -141,6 +152,8 @@ export interface OnboardingData {
     gotchas: Gotcha[];
     decisions: Decision[];
     firstTasks: FirstTask[];
+    /** Cores e logo do projeto, usados para dar a cara da marca à apresentação. Opcional. */
+    brand?: BrandInfo;
 }
 export interface OnboardingOptions {
     /** Caminho do onboarding.json. Padrão: "<cwd>/onboarding.json". */

package/dist/validate.js CHANGED Viewed

@@ -4,6 +4,7 @@ exports.parseEvidence = parseEvidence;
 exports.validateOnboarding = validateOnboarding;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
+const brand_1 = require("./brand");
 const load_1 = require("./load");
 /** Campo que identifica cada item e precisa estar preenchido. */
 const ARRAY_SECTIONS = [
@@ -85,7 +86,7 @@ function walkEvidence(value, at, root, issues) {
         if (EVIDENCE_KEYS.has(key) && Array.isArray(v)) {
             v.forEach((ref, i) => checkEvidence(ref, `${here}[${i}]`, root, issues));
         }
-        else if (key === "file" && typeof v === "string") {
+        else if ((key === "file" || key === "logo" || key === "favicon") && typeof v === "string") {
             checkEvidence(v, here, root, issues);
         }
         else {
@@ -169,6 +170,17 @@ function validateOnboarding(data, options) {
             });
         }
     }
+    const brand = data.brand;
+    if (brand !== undefined && !isObj(brand)) {
+        err("brand", "precisa ser um objeto");
+    }
+    else if (isObj(brand)) {
+        const colors = [["brand.primaryColor", brand.primaryColor], ...(Array.isArray(brand.palette) ? brand.palette.map((c, i) => [`brand.palette[${i}]`, c]) : [])];
+        for (const [path, value] of colors) {
+            if (typeof value === "string" && !(0, load_1.isBlank)(value) && !(0, brand_1.parseColor)(value))
+                warn(String(path), `cor não reconhecida: "${value}" (use hex, ex.: #4f46e5)`);
+        }
+    }
     if (!isObj(data.gettingStarted))
         err("gettingStarted", "seção ausente");
     if (!isObj(data.domain))

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "onboarding-kit",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Onboarding de projetos gerado pela sua IA local: um JSON descreve o projeto e o onboarding-kit o apresenta em /onboarding.",
   "license": "MIT",
   "main": "./dist/index.js",
@@ -29,9 +29,15 @@
   },
   "typesVersions": {
     "*": {
-      "node": ["./dist/adapters/node.d.ts"],
-      "next": ["./dist/adapters/next.d.ts"],
-      "nest": ["./dist/adapters/nest.d.ts"]
+      "node": [
+        "./dist/adapters/node.d.ts"
+      ],
+      "next": [
+        "./dist/adapters/next.d.ts"
+      ],
+      "nest": [
+        "./dist/adapters/nest.d.ts"
+      ]
     }
   },
   "files": [