sagadeck 1.3.1 → 1.5.0

package/src/ai/quality.js

@@ -4,9 +4,69 @@ import { chat } from './llm.js';
 import { auditExploration } from '../exploration.js';
 import { varietyReport } from './variety.js';
 
+// Slide de uma frase só: statement, headline e quote (o "slide com uma frase gigante" das reclamações).
+const ONE_LINER = new Set(['statement', 'headline', 'quote']);
+const words = s => String(s || '').replace(/\$[^$]*\$/g, 'x').replace(/[=*_`^~#>\[\]()]/g, ' ').split(/\s+/).filter(Boolean).length;
+const oneLinerText = s => s.text || s.quote || (Array.isArray(s.lines) ? s.lines.map(l => (typeof l === 'string' ? l : l?.text || '')).join(' ') : '') || s.title || '';
+
+// Conferência de texto sem visão (determinística, roda sempre): frase longa em layout de impacto vira tela de uma
+// frase gigante; uma apresentação feita de frases soltas não explica nada. Os achados voltam para a correção da IA.
+// Interação de plateia (enquete, votação, quiz, cronômetro): em apresentação acadêmica não entra sem pedido.
+export const votingSlide = (s) => s.layout === 'poll' || (s.layout === 'question' && Array.isArray(s.options) && s.options.length) || s.poll != null || s.timer != null;
+const ASKED_INTERACTION = /vota|votação|enquete|quiz|interativ|dinâmica|gamific|perguntas? (?:para|à) plateia/i;
+// marcação que sobrou crua no texto visível (campo que não passa pela marcação): "^^≠^^", "==x==", "**x**"
+const RAW_MARKUP = /\^\^[^^\n]{1,40}\^\^|==[^=\n]{1,60}==|\*\*[^*\n]{1,60}\*\*/;
+const CODE_LAYOUTS = new Set(['code', 'codewalk', 'codelab', 'api', 'algo', 'terminals', 'duel', 'turns', 'playground']);
+
+export function auditText(spec, indices, { briefing = '', render = null } = {}) {
+  const issues = [];
+  const slides = spec.slides || [];
+  // deck feito de um artigo (autoria decidida) é acadêmico: votação só se o pedido quis interação
+  const academic = !!spec.context?.autoria || /congresso|simp[óo]sio|confer[êe]ncia|defesa|banca|journal club|semin[áa]rio/i.test(`${briefing} ${JSON.stringify(spec.context || {})}`);
+  if (academic && !ASKED_INTERACTION.test(briefing)) for (const index of indices) {
+    const s = slides[index];
+    if (s && votingSlide(s)) issues.push({ slide: index + 1, text: 'Votação/enquete numa apresentação acadêmica que não pediu interação. Tire o mecanismo de voto (options, timer, poll): a pergunta para discussão vira slide de texto (question sem options, statement ou split) ou vai nas notes.' });
+  }
+  // slide repetido (mesmo layout e mesmo título de outro): duas capas, o mesmo resultado em dois slides seguidos
+  const sig = (s) => `${s?.layout}|${String(s?.title || s?.text || s?.question || '').replace(/[=*^_~`]/g, '').trim().toLowerCase()}`;
+  for (const index of indices) {
+    const s = slides[index]; if (!s || !(s.title || s.text || s.question)) continue;
+    const first = slides.findIndex((o) => sig(o) === sig(s));
+    if (first >= 0 && first < index) issues.push({ slide: index + 1, text: `Slide repetido: mesmo layout e mesmo título do slide ${first + 1}. Tire a cópia ou faça este slide dizer outra coisa.` });
+  }
+  if (render) for (const index of indices) {
+    const s = slides[index]; if (!s || CODE_LAYOUTS.has(s.layout)) continue;
+    let visible = '';
+    try { visible = render(s, index).replace(/<(code|pre|script|style)[\s\S]*?<\/\1>/gi, ' ').replace(/<[^>]+>/g, ' '); } catch { continue; }
+    const m = RAW_MARKUP.exec(visible);
+    if (m) issues.push({ slide: index + 1, text: `Marcação aparecendo crua na tela ("${m[0]}"): esse campo não aceita marcação. Escreva o texto sem ^^, == ou ** nesse campo.` });
+  }
+  for (const index of indices) {
+    const s = slides[index]; if (!s || !ONE_LINER.has(s.layout)) continue;
+    const n = words(oneLinerText(s));
+    const limit = s.layout === 'quote' ? 40 : 16;
+    if (n > limit) issues.push({ slide: index + 1, text: `Slide de frase única (${s.layout}) com ${n} palavras: vira uma frase gigante na tela. Encurte para a ideia central (até ~12 palavras) ou troque por um layout de conteúdo (split, list, cards, compare) que explique com evidência.` });
+  }
+  // título encolhido à mão (titleSize pequeno) para "dar espaço à figura": o deck fica com cada slide num tamanho de
+  // título; o layout da figura já reserva a área. Vale para os layouts com cabeçalho comum (não capa/seção/manchete).
+  for (const index of indices) {
+    const s = slides[index];
+    if (!s || !Number.isFinite(Number(s.titleSize)) || ONE_LINER.has(s.layout) || ['cover', 'section', 'end', 'kinetic', 'scenography', 'full'].includes(s.layout)) continue;
+    if (Number(s.titleSize) < 60) issues.push({ slide: index + 1, text: `Título com titleSize ${s.titleSize}, bem menor que o dos outros slides: a hierarquia do deck fica desigual. Tire o titleSize (o layout já dá a área da figura); se o título não couber, encurte o texto.` });
+  }
+  // muitas telas de frase solta: a partir da terceira (ou de 15% do deck), cada uma precisa justificar o lugar
+  const singles = slides.map((s, i) => (ONE_LINER.has(s.layout) ? i : -1)).filter(i => i >= 0);
+  const allowed = Math.max(2, Math.round(slides.length * 0.15));
+  for (const index of singles.slice(allowed)) if (indices.includes(index) && !issues.some(x => x.slide === index + 1))
+    issues.push({ slide: index + 1, text: `Há ${singles.length} slides de frase única (statement/headline/quote) no deck; o máximo é ${allowed}. Transforme este em conteúdo (o que, por que, evidência do material) ou junte a frase ao slide vizinho.` });
+  return issues;
+}
+
 export async function reviewExperience(spec, indices, { snapshot, complete = chat, onProgress, signal, briefing = '' } = {}) {
   const issues = [], unchecked = [], failures = [];
   const selected = [...new Set(indices)].filter(index => spec.slides[index]);
+  const { renderSlide } = await import('../build.js');
+  issues.push(...auditText(spec, selected, { briefing, render: (s, i) => renderSlide(s, i, spec).html }));
   for (const [position, index] of selected.entries()) {
     signal?.throwIfAborted();
     const slide = spec.slides[index];

package/src/api-client.js

@@ -14,6 +14,7 @@
 //         ttl_minutes: 30
 //       ca: "C:/certs/empresa.pem"                        # certificado da empresa (proxy/inspeção TLS)
 import fs from "node:fs";
+import { renameRetry } from "./fs-retry.js";
 import os from "node:os";
 import path from "node:path";
 import http from "node:http";
@@ -187,7 +188,7 @@ export class ApiEnvironments {
     fs.mkdirSync(path.dirname(this.file), { recursive: true });
     const tmp = `${this.file}.tmp-${process.pid}`;
     fs.writeFileSync(tmp, String(doc), { encoding: "utf8", mode: 0o600 });
-    fs.renameSync(tmp, this.file);
+    renameRetry(tmp, this.file);
   }
 
   // Ambiente de exemplo (embutido) editado pela pessoa: vira um ambiente dela, cópia completa no arquivo (o do arquivo

package/src/build.js

@@ -10,7 +10,8 @@ import { fileURLToPath } from "node:url";
 import YAML from "yaml";
 import { resolveTheme, themeCSS, scopedThemeCSS } from "./themes.js";
 import { identityFor, identitiesFile } from "./identity.js";
-import { LAYOUTS, SCENES } from "./layouts.js";
+import { LAYOUTS, SCENES, fullAsFigure } from "./layouts.js";
+import { setDeckLocale } from "./locale.js";
 import { applyVisualEdits } from "./visual-edits.js";
 import { el, imageSrc } from "./elements.js";
 import { iconSVG } from "./figures/icons.js";
@@ -38,6 +39,7 @@ const drawIcon = (name, size = 20) => iconSVG(name, { size, stroke: 2 }).replace
 const slug = (s) => String(s || "deck").normalize("NFD").replace(/[\u0300-\u036f]/g, "").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 40) || "deck";
 
 export function inferLayout(s) {
+  if (fullAsFigure(s)) return "image"; // figura do documento em full: sem véu e sem sangrar (src/layouts.js)
   if (s.layout) return s.layout;
   if (s.elements) return "canvas";
   if (s.stats || s.kpis) return "stats";
@@ -126,6 +128,7 @@ export function navWarnings(slides = []) {
 
 export function buildHTML(rawSpec, opts = {}) {
   const spec = normalizeSpec(meetingSpec(rawSpec,opts.audience));
+  setDeckLocale(spec.lang); // números no idioma do deck (src/locale.js)
   const theme = resolveTheme(spec.theme, spec.palette, identityOf(spec));
   const warnings = [];
   if (spec.identity && !theme.identity) warnings.push(`identidade "${spec.identity}" não está em ${identitiesFile()} nesta máquina: a apresentação saiu com as fontes do tema`);
@@ -306,6 +309,7 @@ function slideShell({ s, i, spec, theme, ctx, layout, tone, inner: innerIn, curr
 }
 
 export function renderSlide(raw, i = 0, spec = {}) {
+  setDeckLocale(spec.lang);
   const deckTheme = resolveTheme(spec.theme, spec.palette, identityOf(spec));
   const s = { ...(spec.defaults || {}), ...raw };
   const theme = slideTheme(s, deckTheme, spec);

package/src/decision-lab.js

@@ -1,9 +1,10 @@
 import './runtime/decision-lab.js';
 import { esc } from './markup.js';
+import { formatNumber } from './locale.js';
 export const calculateDecisionLab = globalThis.SagaDecisionLab.calculate;
 export function decisionLabHTML(input = {}) {
   const v = globalThis.SagaDecisionLab.normalize(input), r = calculateDecisionLab(v);
-  const fmt = n => n.toLocaleString('pt-BR', { maximumFractionDigits: 1 });
+  const fmt = n => formatNumber(n, { maximumFractionDigits: 1 });
   const controls = [
     ['errorRate', 'Erros da automação (%)', 100, .1],
     ['reviewRate', 'Casos revisados (%)', 100, 1],

package/src/deck-file.js

@@ -8,6 +8,7 @@
 //   3. o texto final é relido e comparado com o deck: se não bater, grava o deck inteiro (correção primeiro);
 //   4. a troca é atômica: escreve num temporário ao lado e renomeia (nunca fica um arquivo pela metade).
 import fs from "node:fs";
+import { renameRetry } from "./fs-retry.js";
 import path from "node:path";
 import { isDeepStrictEqual } from "node:util";
 import YAML from "yaml";
@@ -114,6 +115,6 @@ export function writeDeckFile(file, spec) {
   if (text === current) return false;
   const tmp = path.join(path.dirname(file), `.${path.basename(file)}.${process.pid}.${Date.now()}.tmp`);
   fs.writeFileSync(tmp, text, "utf8");
-  try { fs.renameSync(tmp, file); } catch (e) { fs.rmSync(tmp, { force: true }); throw e; }
+  try { renameRetry(tmp, file); } catch (e) { fs.rmSync(tmp, { force: true }); throw e; }
   return true;
 }

package/src/elements.js

@@ -6,6 +6,7 @@ import { videoPlayer } from './video-player.js';
 import { tableHTML } from "./table.js";
 import { qrSVG } from "./figures/qr.js";
 import katex from "katex";
+import { formatNumber, decimalSeparator } from "./locale.js";
 import fs from "node:fs";
 import path from "node:path";
 import { md, esc } from "./markup.js";
@@ -116,13 +117,20 @@ export function figureHTML(el, ctx, w, h) {
       const grown = matchCropAspect(el.crop, imageSize(el.image, ctx), w, h);
       const c = { l: +grown.l || 0, t: +grown.t || 0, r: +grown.r || 0, b: +grown.b || 0 };
       const fw = Math.max(0.01, 1 - c.l - c.r), fh = Math.max(0.01, 1 - c.t - c.b);
-      return `<div${attrs(el, "fig fig-img fig-crop")}><img src="${src}" alt="${esc(el.alt || "")}" style="left:${(-c.l / fw) * 100}%;top:${(-c.t / fh) * 100}%;width:${100 / fw}%;height:${100 / fh}%;${flip}"></div>`;
+      // data-crop: a apresentação mede a caixa de verdade e, se a proporção não bater com a da região (caixa sem
+      // tamanho aqui, janela que não pôde crescer), encaixa a região inteira sem esticar (src/runtime/fit.js: fitCrops)
+      return `<div${attrs(el, "fig fig-img fig-crop")}><img src="${src}" alt="${esc(el.alt || "")}" data-crop="${[c.l, c.t, c.r, c.b].map((v) => +v.toFixed(5)).join(",")}" style="left:${(-c.l / fw) * 100}%;top:${(-c.t / fh) * 100}%;width:${100 / fw}%;height:${100 / fh}%;${flip}"></div>`;
     }
     // sem fit escolhido: preenche (cover), mas quando a proporção da imagem é muito diferente da caixa (fórmula, esquema
     // largo numa coluna alta; gráfico com eixo e legenda na borda) cortar perderia informação: passou de 1,25× (corte de
     // mais de 20%), cabe inteira (contain). Sem o tamanho da caixa aqui (figura do split, do layout), a mesma conta é feita
     // na apresentação, com a caixa medida (data-autofit; src/runtime/fit.js: fitImages)
     let fit = el.fit;
+    // figura recortada do documento (mapa, gráfico, tabela do paper) é evidência: nunca deforma nem perde borda.
+    // fill/stretch achatavam o mapa na caixa do slide, e o cover automático (até 20% de corte) comia eixo, legenda e
+    // escala; vira contain (inteira, na proporção do original)
+    const docImage = /contexto\/visuais\//.test(String(el.image || "").replace(/\\/g, "/"));
+    if (docImage && (!fit || /^(fill|stretch|none|cover)$/i.test(String(fit)))) fit = "contain";
     if (!fit) {
       const sz = w && h ? imageSize(el.image, ctx) : null;
       const box = w && h ? w / h : 0, img = sz && sz.h ? sz.w / sz.h : 0;
@@ -141,7 +149,7 @@ export function figureHTML(el, ctx, w, h) {
         if (pct) { box = { ...el }; delete box.w; }
       }
     }
-    return `<div${attrs(box, "fig fig-img", flow)}><img src="${src}" alt="${esc(el.alt || "")}"${el.fit ? "" : " data-autofit"} style="object-fit:${fit};${el.radius ? `border-radius:${el.radius}px;` : ""}${flip}"></div>`;
+    return `<div${attrs(box, "fig fig-img", flow)}><img src="${src}" alt="${esc(el.alt || "")}"${el.fit || docImage ? "" : " data-autofit"} style="object-fit:${fit};${el.radius ? `border-radius:${el.radius}px;` : ""}${flip}"></div>`;
   }
   return "";
 }
@@ -260,7 +268,7 @@ export function el(e, ctx, w, h) {
   if (e.badge) return `<div${attrs(e, "badge f-label")}>${md(e.badge)}</div>`;
   if (e.aviso) return aviso(e);
   if (e.video) return video(e, ctx);
-  if (e.motion) return `<div${attrs(e, "motion")}>${motionHTML(e.motion,ctx?.theme?.colors)}</div>`;
+  if (e.motion) return `<div${attrs(e, "motion")}>${motionHTML(e.motion,ctx?.theme?.colors,{still:ctx?.spec?.motion==='none'})}</div>`;
   if (e.widget) return `<div${attrs(e, "widget")} data-widget="${esc(e.widget)}" data-opts="${esc(JSON.stringify(e))}"></div>`;
   if (e.html) return `<div${attrs(e, "raw")}>${e.html}</div>`;
   if (e.spacer != null) return `<div class="spacer" style="flex:${e.spacer === true ? 1 : 0} 0 ${px(e.spacer === true ? 0 : e.spacer)}"></div>`;
@@ -374,10 +382,39 @@ export function importedTable(e) {
   return `<div${attrs(e, "tbx-table")}><table style="border-collapse:collapse;table-layout:fixed;width:100%"><colgroup>${cols}</colgroup>${rows}</table></div>`;
 }
 
+// O contador reescreve o texto no navegador (textContent): marcação de expoente/índice no prefixo/sufixo ("km^2^",
+// "CO~2~") vira o algarismo sobrescrito/subscrito do Unicode, que sobrevive ao textContent (saía "km^2^" cru).
+const SUP = { 0: "⁰", 1: "¹", 2: "²", 3: "³", 4: "⁴", 5: "⁵", 6: "⁶", 7: "⁷", 8: "⁸", 9: "⁹", "-": "⁻", "+": "⁺" };
+const SUB = { 0: "₀", 1: "₁", 2: "₂", 3: "₃", 4: "₄", 5: "₅", 6: "₆", 7: "₇", 8: "₈", 9: "₉", "-": "₋", "+": "₊" };
+export const unicodeScripts = (t) => String(t ?? "").replace(/\^([-+]?\d+)\^/g, (_, d) => [...d].map((c) => SUP[c]).join("")).replace(/~([-+]?\d+)~/g, (_, d) => [...d].map((c) => SUB[c]).join(""));
+// Valor do contador escrito como texto ("37,67%", "1.403", "R$ 2,5 mi", "1521 km^2^"): Number() dava NaN e o slide
+// mostrava "NaN". Separa o que vem antes/depois (prefixo/sufixo) e lê o número no formato brasileiro (milhar com
+// ponto, decimal com vírgula); as casas decimais escritas valem. Sem número nenhum, o texto aparece como está.
+export function parseCounterValue(raw) {
+  if (typeof raw === "number") return { value: raw };
+  const m = /^(\D*?)(-?\d[\d.,]*)(.*)$/s.exec(String(raw ?? "").trim());
+  if (!m) return null;
+  let num = m[2].replace(/[.,]$/, ""), dec = 0;
+  if (decimalSeparator() === ".") {
+    // deck em inglês: vírgula é milhar ("1,403"), ponto é decimal ("37.67")
+    num = num.replace(/,(?=\d{3}(?:\D|$))/g, "");
+    if (num.includes(".")) dec = num.split(".").pop().length;
+    else if (num.includes(",")) { dec = num.split(",").pop().length; num = num.replace(",", "."); }
+  }
+  else if (num.includes(",")) { dec = num.split(",").pop().length; num = num.replace(/\./g, "").replace(",", "."); }
+  else if (/^-?\d{1,3}(\.\d{3})+$/.test(num)) num = num.replace(/\./g, "");
+  else if (num.includes(".")) dec = num.split(".").pop().length;
+  const value = Number(num);
+  return Number.isFinite(value) ? { value, prefix: m[1], suffix: m[3] + (m[2].length > num.length && /[.,]$/.test(m[2]) ? m[2].slice(-1) : ""), dec } : null;
+}
+
 export function counter(e) {
-  const v = Number(e.counter);
+  const parsed = parseCounterValue(e.counter);
+  if (!parsed) return `<div${attrs(e, `t f-display r-number pl`, `font-size:${e.size || SIZES[e.as || "number"]}px;`)}${e.fit ? " data-fit" : ""}>${md(String(e.counter ?? ""))}</div>`;
+  e = { ...e, prefix: unicodeScripts(`${e.prefix ?? ""}${parsed.prefix ?? ""}`), suffix: unicodeScripts(`${parsed.suffix ?? ""}${e.suffix ?? ""}`), decimals: e.decimals ?? (typeof e.counter === "number" ? undefined : parsed.dec) };
+  const v = parsed.value;
   const dec = e.decimals ?? (v % 1 ? 1 : 0);
-  const shown = v.toLocaleString("pt-BR", { minimumFractionDigits: dec, maximumFractionDigits: dec });
+  const shown = formatNumber(v, { minimumFractionDigits: dec, maximumFractionDigits: dec }); // no idioma do deck
   const size = e.size || SIZES[e.as || "number"];
   return `<div${attrs(e, `t f-display r-number counter pl`, `font-size:${size}px;`)}${e.fit ? " data-fit" : ""} data-to="${v}" data-from="${e.from ?? 0}" data-dec="${dec}" data-prefix="${esc(e.prefix || "")}" data-suffix="${esc(e.suffix || "")}"><span class="cv">${esc(e.prefix || "")}${shown}${esc(e.suffix || "")}</span></div>`;
 }
@@ -447,7 +484,7 @@ export function cards(e, ctx) {
         ${badgeHtml}
       </div>
       ${c.title ? `<div class="cd-title t f-heading">${md(c.title)}</div>` : ""}
-      ${c.text ? `<div class="cd-text t f-body">${md(c.text)}</div>` : ""}
+      ${c.text ? `<div class="cd-text t f-body${/^\s*\$\$?[^$]+\$\$?\s*$/.test(String(c.text)) ? " cd-math" : ""}">${md(c.text)}</div>` : ""}
       ${extraWidgets}
       ${c.foot ? `<div class="cd-foot t f-label">${md(c.foot)}</div>` : ""}
       ${c.goto != null && c.goto !== "" ? `<span class="goto-mark" aria-hidden="true">${iconSVG("arrow-up-right", { size: 30, stroke: 2 })}</span>` : ""}
@@ -476,7 +513,7 @@ export function stats(e, ctx) {
         ${iconHtml}
         ${trendHtml}
       </div>
-      <div class="st-val t f-display" style="${valColor}">${esc(String(st.value ?? st.stat ?? ""))}</div>
+      <div class="st-val t f-display" style="${valColor}">${md(String(st.value ?? st.stat ?? ""))}</div>
       ${st.label ? `<div class="st-lab t f-heading">${md(st.label)}</div>` : ""}
       ${st.text ? `<div class="st-sub t f-body">${md(st.text)}</div>` : ""}
     </div>`;

package/src/figures/charts.js

@@ -12,6 +12,7 @@
 // Cores: por padrão usam o tom do slide (--cb base, --ca destaque, --s1..--s5 séries).
 // Qualquer item aceita color: hi | em | fg | muted | "FF0000".
 import { esc } from "../markup.js";
+import { formatNumber } from "../locale.js";
 import { iconSVG } from "./icons.js";
 import { humanBody } from "./pictos.js";
 
@@ -24,8 +25,10 @@ const cvar = (c, d) => {
 };
 const fmt = (v, o) => {
   if (v == null || isNaN(v)) return "";
-  const d = o.decimals ?? (Math.abs(v) < 10 && v % 1 ? 1 : 0);
-  const s = Number(v).toLocaleString("pt-BR", { minimumFractionDigits: d, maximumFractionDigits: d });
+  // sem decimals pedido: as casas do próprio valor, até 2 (0.93 aparecia "0.9" com a regra antiga de 1 casa
+  // abaixo de 10, e 37.67 aparecia "38": num gráfico de paper, a precisão relatada é dado)
+  const d = o.decimals ?? Math.min(2, (String(Number(v)).split(".")[1] || "").length);
+  const s = formatNumber(v, { minimumFractionDigits: d, maximumFractionDigits: d }); // no idioma do deck (lang)
   return `${o.prefix || ""}${s}${o.suffix || ""}`;
 };
 const norm = (o) => {
@@ -198,8 +201,8 @@ export function niceTicks(min, max, want = 5) {
 }
 function line(o, W, H) {
   const series = o.series || [{ values: o.values }];
-  // rótulo que veio como número (0.5): com vírgula, como o resto do gráfico
-  const labels = (o.labels || series[0].values.map((_, i) => String(i + 1))).map((l) => (typeof l === "number" ? l.toLocaleString("pt-BR", { useGrouping: false }) : l));
+  // rótulo que veio como número (0.5): no formato do resto do gráfico (vírgula em pt-BR, ponto em inglês)
+  const labels = (o.labels || series[0].values.map((_, i) => String(i + 1))).map((l) => (typeof l === "number" ? formatNumber(l, { useGrouping: false }) : l));
   const all = series.flatMap((s) => s.values).filter((v) => v != null);
   const min = o.min ?? Math.min(0, ...all), max = o.max ?? Math.max(...all) * 1.1;
   // nomes no fim das linhas, a não ser que se encostem (as linhas terminam juntas) ou o slide peça legenda: aí, legenda em cima

package/src/figures/diagrams.js

@@ -82,6 +82,20 @@ export function spectrum(o = {}) {
   return wrap([0, 0, W, 190], g, "spectrum");
 }
 
+// Tamanho da letra que cabe na caixa (largura × altura): simula a quebra por palavras e desce de 36 até 18 px.
+// Com 36 px fixos, "Low-lying areas near the drainage network" pedia 4 linhas e vazava por baixo da caixa.
+export function boxFontSize(text, w, h, { max = 36, min = 18, lh = 1.15, em = 0.56 } = {}) {
+  const words = String(text || "").split(/\s+/).filter(Boolean);
+  for (let fs = max; fs > min; fs -= 2) {
+    const cpl = Math.max(1, Math.floor(w / (fs * em)));
+    if (words.some((wd) => wd.length > cpl)) continue;
+    let lines = 1, len = 0;
+    for (const wd of words) { if (len && len + 1 + wd.length > cpl) { lines++; len = wd.length; } else len += (len ? 1 : 0) + wd.length; }
+    if (lines * fs * lh <= h) return fs;
+  }
+  return min;
+}
+
 export function flow(o = {}) {
   const steps = o.steps || [];
   const n = steps.length, bw = 300, gap = 90, bh = 150, vgap = 130;
@@ -90,7 +104,7 @@ export function flow(o = {}) {
   const id = `ar${++uid}`;
   const box = (x, y, s, hl) =>
     `<rect x="${x}" y="${y}" width="${bw}" height="${bh}" rx="18" style="fill:var(${hl ? "--hi" : "--surface"});stroke:var(--fg)" stroke-width="${hl ? 0 : 4}"/>` +
-    `<foreignObject x="${x + 16}" y="${y + 10}" width="${bw - 32}" height="${bh - 20}"><div xmlns="http://www.w3.org/1999/xhtml" class="f-heading" style="height:100%;display:flex;align-items:center;justify-content:center;text-align:center;font-size:36px;color:var(${hl ? "--on-hi" : "--fg"})">${esc(s)}</div></foreignObject>`;
+    `<foreignObject x="${x + 16}" y="${y + 10}" width="${bw - 32}" height="${bh - 20}"><div xmlns="http://www.w3.org/1999/xhtml" class="f-heading" style="height:100%;display:flex;align-items:center;justify-content:center;text-align:center;line-height:1.15;font-size:${boxFontSize(s, bw - 32, bh - 20)}px;color:var(${hl ? "--on-hi" : "--fg"})">${esc(s)}</div></foreignObject>`;
   const arrow = (x1, y1, x2, y2) =>
     `<line x1="${x1}" y1="${y1}" x2="${x2}" y2="${y2}" style="stroke:var(--fg)" stroke-width="8" marker-end="url(#${id})"/>`;
   let g = arrowDefs(id);

package/src/figures/ufmap.js

@@ -1,6 +1,7 @@
 // Mapa do Brasil por UF em grade (cartograma de ladrilhos): cada estado é um quadrado na posição aproximada dele.
 // Sem geodados de fora (nada pede coisa à internet) e legível em slide: a cor diz o valor, o rótulo diz a UF.
 import { esc } from "../markup.js";
+import { formatNumber } from "../locale.js";
 
 // [coluna, linha] de cada UF, do norte ao sul, do oeste ao leste
 export const UF_GRID = {
@@ -14,7 +15,7 @@ export const UF_GRID = {
   RS: [1, 7],
 };
 
-const fmt = (v) => (Number.isFinite(v) ? v.toLocaleString("pt-BR", { maximumFractionDigits: 1 }) : "");
+const fmt = (v) => (Number.isFinite(v) ? formatNumber(v, { maximumFractionDigits: 1 }) : "");
 
 // o: { ufmap: { SP: 120, RJ: 80, … }, suffix, prefix, highlight: [SP], legend: "texto", showValues }
 export function ufmap(o, warnings) {

package/src/fs-retry.js

@@ -0,0 +1,19 @@
+// Renomear tolerante a arquivo travado. A biblioteca mora em Documentos, que no Windows costuma estar no OneDrive:
+// enquanto sincroniza (e também o antivírus ou o indexador), o arquivo fica preso por um instante e o rename falha
+// com EPERM/EBUSY/EACCES. Em vez de perder o salvamento da pessoa, tenta de novo com espera curta e crescente
+// (~1 s no total). Qualquer outro erro (destino inexistente, disco cheio…) sobe na hora.
+import fs from "node:fs";
+
+const LOCKED = new Set(["EPERM", "EBUSY", "EACCES"]);
+export const RENAME_DELAYS = [20, 40, 80, 150, 250, 450];
+
+const pause = (ms) => Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+
+export function renameRetry(from, to, { delays = RENAME_DELAYS } = {}) {
+  for (let i = 0; ; i++) {
+    try { return fs.renameSync(from, to); } catch (e) {
+      if (!LOCKED.has(e?.code) || i >= delays.length) throw e;
+      pause(delays[i]);
+    }
+  }
+}

package/src/import/crop.js

@@ -45,21 +45,40 @@ export async function cropRegions(jobs) {
       const outs = await page.evaluate(async ([data, list]) => {
         const img = new Image(); img.src = data; await img.decode();
         return list.map((j) => {
-          const x = Math.max(0, Math.floor(j.x)), y = Math.max(0, Math.floor(j.y));
-          const w = Math.max(1, Math.min(img.width - x, Math.ceil(j.w))), h = Math.max(1, Math.min(img.height - y, Math.ceil(j.h)));
-          const c = document.createElement("canvas"); c.width = w; c.height = h;
-          const g = c.getContext("2d", { willReadFrequently: true }); g.drawImage(img, x, y, w, h, 0, 0, w, h);
-          // densidade de tinta (fração de pixels não-papel): recorte quase em branco = caixa errada
+          let x = Math.max(0, Math.floor(j.x)), y = Math.max(0, Math.floor(j.y));
+          let w = Math.max(1, Math.min(img.width - x, Math.ceil(j.w))), h = Math.max(1, Math.min(img.height - y, Math.ceil(j.h)));
+          let c = document.createElement("canvas"); c.width = w; c.height = h;
+          let g = c.getContext("2d", { willReadFrequently: true }); g.drawImage(img, x, y, w, h, 0, 0, w, h);
+          // densidade de tinta (fração de pixels não-papel): recorte quase em branco = caixa errada (medida antes de aparar)
           let ink = 0;
           try {
             const d = g.getImageData(0, 0, w, h).data;
             for (let i = 0; i < d.length; i += 16) { if ((d[i] + d[i + 1] + d[i + 2]) / 3 < 235) ink++; }
             ink /= d.length / 16;
           } catch { ink = 1; }
-          return { png: c.toDataURL("image/png"), ink };
+          // trim: apara a margem de papel em volta (linha/coluna inteira branca), com um respiro de 6 px.
+          // Só papel puro sai: céu claro numa foto ou fundo cinza de gráfico não é branco puro em toda a linha.
+          if (j.trim && w > 24 && h > 24) {
+            const d = g.getImageData(0, 0, w, h).data;
+            const paper = (i) => d[i] >= 246 && d[i + 1] >= 246 && d[i + 2] >= 246;
+            const rowBlank = (r) => { for (let q = 0; q < w; q++) if (!paper((r * w + q) * 4)) return false; return true; };
+            const colBlank = (q, t0, t1) => { for (let r = t0; r <= t1; r++) if (!paper((r * w + q) * 4)) return false; return true; };
+            let t = 0, b = h - 1, l = 0, r = w - 1;
+            while (t < b && rowBlank(t)) t++;
+            while (b > t && rowBlank(b)) b--;
+            while (l < r && colBlank(l, t, b)) l++;
+            while (r > l && colBlank(r, t, b)) r--;
+            const pad = 6, nl = Math.max(0, l - pad), nt = Math.max(0, t - pad), nw = Math.min(w, r + pad + 1) - nl, nh = Math.min(h, b + pad + 1) - nt;
+            if (r > l && b > t && (nw < w || nh < h)) {
+              const c2 = document.createElement("canvas"); c2.width = nw; c2.height = nh;
+              const g2 = c2.getContext("2d", { willReadFrequently: true }); g2.drawImage(c, nl, nt, nw, nh, 0, 0, nw, nh);
+              c = c2; g = g2; w = nw; h = nh;
+            }
+          }
+          return { png: c.toDataURL("image/png"), ink, size: { w, h } };
         });
-      }, [data, list.map(({ x, y, w, h }) => ({ x, y, w, h }))]);
-      outs.forEach((u, k) => { fs.writeFileSync(list[k].dst, Buffer.from(u.png.split(",")[1], "base64")); list[k].ink = u.ink; done.push(list[k].dst); });
+      }, [data, list.map(({ x, y, w, h, trim }) => ({ x, y, w, h, trim }))]);
+      outs.forEach((u, k) => { fs.writeFileSync(list[k].dst, Buffer.from(u.png.split(",")[1], "base64")); list[k].ink = u.ink; list[k].size = u.size; done.push(list[k].dst); });
     }
   } finally { await browser.close(); }
   return done;

package/src/layouts.js

@@ -97,6 +97,20 @@ function chartsSideBySide(content) {
   return out;
 }
 
+// `full` com figura do documento (mapa, gráfico, tabela recortada do paper) ou figura inteira (fit: contain) e texto:
+// o véu por cima cobria a legenda do mapa e os eixos, e a figura sangrava cortando a borda. Evidência não leva texto
+// por cima nem sangra: vira a composição do layout image (título no alto, figura inteira, legenda embaixo). Para
+// figura do documento até overlay: none com título vale assim (senão título e legenda sumiam do slide).
+export function fullAsFigure(s) {
+  if (s?.layout !== "full") return false;
+  const f = s.figure ?? (s.image ? { image: s.image } : null);
+  const fig = typeof f === "string" ? { image: f } : f;
+  if (!fig || typeof fig !== "object" || !fig.image || fig.image_prompt || fig.video) return false;
+  if (!(s.title || s.caption || s.kicker)) return false;
+  const doc = /contexto\/visuais\//.test(String(fig.image).replace(/\\/g, "/"));
+  return doc || ((fig.fit || s.fit) === "contain" && s.overlay !== "none");
+}
+
 export const LAYOUTS = {
   portal(s,ctx){return portalHTML(s,ctx,head)+src(s)+add(s,ctx);},
   playground(s,ctx){return playgroundHTML(s,ctx,head)+src(s)+add(s,ctx);},
@@ -401,7 +415,7 @@ export const LAYOUTS = {
       ${c.title ? text(c.title, "h3", { class: "cp-title" }) : ""}
       ${c.text ? text(c.text, "body", { class: "cp-text" }) : ""}
       ${c.items ? list({ list: c.items, size: 32 }) : ""}</div>`;
-    return `<div class="L-compare">${head(s)}<div class="cp-row">${col(s.left, "l", 0)}<div${attrs({ step: s.right?.step ?? build(s, 1) }, "cp-vs t f-display")}>${esc(s.vs ?? "×")}</div>${col(s.right, "r", 1)}</div>
+    return `<div class="L-compare">${head(s)}<div class="cp-row">${col(s.left, "l", 0)}<div${attrs({ step: s.right?.step ?? build(s, 1) }, "cp-vs t f-display")}>${md(String(s.vs ?? "×"))}</div>${col(s.right, "r", 1)}</div>
       ${s.after ? text(s.after, "h3", { class: "cp-after", step: s.afterStep ?? (s.build ? 3 : 1), face: "quote", size: 50 }) : ""}</div>${src(s)}${add(s, ctx)}`;
   },
 
@@ -439,6 +453,7 @@ export const LAYOUTS = {
   },
 
   image(s, ctx) {
+    if (typeof s.figure === "string") s = { ...s, figure: { image: s.figure } }; // full com figure: caminho (fullAsFigure)
     // figura inteira à vista (fit: contain: gráfico, tabela, esquema): a legenda vai embaixo, sem cobrir; foto (cover)
     // segue sangrando, com o cartão por cima
     const contain = (s.figure?.fit || s.fit) === "contain" || (!s.fit&&!s.figure?.fit&&String(s.figure?.image||s.image||'').replace(/\\/g,'/').includes('contexto/visuais/'));
@@ -536,6 +551,7 @@ export const LAYOUTS = {
     const f = s.figure ?? (s.image || s.image_prompt ? { image: s.image, image_prompt: s.image_prompt } : null);
     const fig = f == null ? "" : typeof f === "object" ? { fit: s.fit || "cover", ...f } : { image: f, fit: s.fit || "cover" };
     const hasText = s.title || s.caption || s.kicker;
+    if (fullAsFigure(s)) return LAYOUTS.image({ ...s, figure: { ...fig, fit: "contain" }, fit: undefined }, ctx);
     const pos = s.overlay || (hasText ? "bottom" : "none");
     // figura desenhada (gráfico, ícone, diagrama) com texto à esquerda: vai para a direita em vez de ficar por baixo do texto
     const drawn = fig && !(fig.image || fig.image_prompt || fig.video);
@@ -545,7 +561,11 @@ export const LAYOUTS = {
 
   // Manchete: uma frase enorme que ocupa o slide (encolhe para caber)
   headline(s, ctx) {
-    return `<div class="L-headline">${kicker(s)}${text(s.text || s.title, s.as || "hero", { class: "hl-text e", style: "--d:1;", fit: true, size: s.size || 300 })}
+    // manchete é para frase curta; frase longa em "hero" de 300 px virava o slide de uma frase gigante (objetivo
+    // inteiro do paper na tela). Como no statement, o tamanho segue o comprimento; `as`/`size` explícitos vencem.
+    const chars = String(s.text || s.title || "").replace(/[=*_`^~]/g, "").length;
+    const role = s.as || (chars > 100 ? "h2" : chars > 60 ? "title" : "hero");
+    return `<div class="L-headline">${kicker(s)}${text(s.text || s.title, role, { class: "hl-text e", style: "--d:1;", fit: true, size: s.size || (role === "hero" ? 300 : undefined) })}
       ${s.caption ? text(s.caption, "lead", { class: "hl-cap muted e", style: "--d:2;" }) : ""}</div>${src(s)}${add(s, ctx)}`;
   },