sagadeck 1.4.0 → 1.6.0

package/src/ai/llm.js

@@ -1,20 +1,23 @@
 import { mediaPrompt } from './art-direction.js';
 // sagadeck · Cliente de LLM (qualquer endpoint compatível com OpenAI: /v1/chat/completions)
 //
-// Por padrão fala com o `modelrelay serve` local (http://127.0.0.1:8765/v1), que decide pela
-// configuração dele para onde a chamada vai (OpenRouter, OpenAI, gateway corporativo...).
-// Também funciona apontando direto para um provedor.
+// Fala direto com o provedor configurado nesta máquina (~/.sagadeck/ia.json, tela Configurar IA do Studio:
+// src/ai/ia-config.js). As variáveis abaixo valem por cima da configuração:
 //
-//   SAGADECK_LLM_URL      base da API            (padrão: http://127.0.0.1:8765/v1)
-//   SAGADECK_LLM_KEY      bearer token opcional  (ex.: chave do OpenRouter se apontar direto)
-//   SAGADECK_TEXT_MODEL   modelo de texto        (padrão: "text"  — apelido no [models] do modelrelay)
-//   SAGADECK_IMAGE_MODEL  modelo de imagem       (padrão: "image" — idem)
-//   SAGADECK_VISION_MODEL modelo que vê imagens  (padrão: "vision" — quando o de texto não enxerga, a chamada com
-//                         imagem vai para ele em vez de perder a imagem; quem configura o relay decide qual é)
+//   SAGADECK_LLM_URL      base da API            (ex.: https://openrouter.ai/api/v1)
+//   SAGADECK_LLM_KEY      bearer token           (ex.: a chave do OpenRouter)
+//   SAGADECK_TEXT_MODEL   modelo de texto        (padrão: o "text" da configuração)
+//   SAGADECK_IMAGE_MODEL  modelo de imagem       (padrão: o "image" da configuração)
+//   SAGADECK_VISION_MODEL modelo que vê imagens  (padrão: o "vision" da configuração; quando o de texto não enxerga,
+//                         a chamada com imagem vai para ele em vez de perder a imagem)
+//   SAGADECK_SEARCH_MODEL modelo que busca na web (padrão: o "search" da configuração)
 //   SAGADECK_LLM_TIMEOUT  segundos por chamada; em streaming, segundos sem chegar nada (padrão: 180)
 //   SAGADECK_LLM_FIRST_TIMEOUT  em streaming, segundos até a 1ª palavra (o modelo pensa antes) (padrão: 600)
 
 import { currentUsage, recordUsage } from './usage.js';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { iaFile, loadIA, keyOf, migrateModelrelay } from './ia-config.js';
 import {setTimeout as delay} from 'node:timers/promises';
 
 export class LLMError extends Error {
@@ -28,35 +31,67 @@ export class LLMError extends Error {
   }
 }
 
+// De onde vem a IA: variáveis de ambiente (SAGADECK_LLM_URL…, valem por cima; é como os testes apontam para o LLM
+// falso) ou a configuração desta máquina (~/.sagadeck/ia.json, src/ai/ia-config.js). Os papéis text, vision, image e
+// search viram os modelos configurados; sem configuração nenhuma, a IA fica desligada (o Studio usa as regras locais).
+let migrated = false;
 export function llmConfig(env = process.env) {
+  const fromEnv = !!env.SAGADECK_LLM_URL;
+  if (!fromEnv && !migrated) { migrated = true; try { migrateModelrelay({ env, file: iaFile(env) }); } catch { /* segue sem */ } }
+  const ia = fromEnv ? null : loadIA(iaFile(env));
+  const m = ia?.models || {};
   return {
-    url: (env.SAGADECK_LLM_URL || "http://127.0.0.1:8765/v1").replace(/\/+$/, ""),
-    key: env.SAGADECK_LLM_KEY || "",
-    textModel: env.SAGADECK_TEXT_MODEL || "text",
-    imageModel: env.SAGADECK_IMAGE_MODEL || "image",
-    visionModel: env.SAGADECK_VISION_MODEL || "vision",
+    url: (env.SAGADECK_LLM_URL || ia?.url || "").replace(/\/+$/, ""),
+    key: env.SAGADECK_LLM_KEY || (ia ? keyOf(ia, env) : ""),
+    textModel: env.SAGADECK_TEXT_MODEL || m.text || "text",
+    imageModel: env.SAGADECK_IMAGE_MODEL || m.image || "image",
+    visionModel: env.SAGADECK_VISION_MODEL || m.vision || m.text || "vision",
+    // busca na web pelo modelo (no OpenRouter, um modelo ":online"); sem ele, a pesquisa usa os buscadores diretos
+    searchModel: env.SAGADECK_SEARCH_MODEL || m.search || (fromEnv ? "search" : ""),
+    headers: ia?.headers || {},
+    adaptador: ia?.adaptador || "",
+    source: fromEnv ? "variável" : ia ? "arquivo" : "nenhuma",
     timeoutMs: Number(env.SAGADECK_LLM_TIMEOUT || 180) * 1000,
     firstTimeoutMs: Number(env.SAGADECK_LLM_FIRST_TIMEOUT || 600) * 1000,
-    // o modelrelay escolhe os modelos deste app em [apps.sagadeck.models] (o resto vem de [models])
-    app: env.SAGADECK_APP || "sagadeck",
   };
 }
+export const llmConfigured = (cfg = llmConfig()) => !!(cfg.url || cfg.adaptador);
+
+// o papel (text, vision, image, search) vira o modelo configurado; outro nome passa como veio
+export function resolveModel(cfg, name) {
+  const roles = { text: cfg.textModel, vision: cfg.visionModel, image: cfg.imageModel, search: cfg.searchModel };
+  return roles[name] || name;
+}
 
 function headers(cfg) {
-  const h = { "Content-Type": "application/json", "X-Modelrelay-App": cfg.app || "sagadeck" };
+  const h = { "Content-Type": "application/json", ...(cfg.headers || {}) };
   if (cfg.key) h.Authorization = `Bearer ${cfg.key}`;
   return h;
 }
 
+// Adaptador (opcional, da pessoa): um .mjs cujo default é (url, init) => Response. Serve para o que não é compatível
+// com a API da OpenAI (outro jeito de autenticar, outro endereço) sem mexer no sagadeck. Sem ele, o fetch normal.
+const adapters = new Map();
+async function send(cfg, url, init) {
+  if (!cfg.adaptador) return fetch(url, init);
+  if (!adapters.has(cfg.adaptador)) adapters.set(cfg.adaptador, import(pathToFileURL(path.resolve(cfg.adaptador)).href).then((mod) => mod.default));
+  const fn = await adapters.get(cfg.adaptador);
+  if (typeof fn !== "function") throw new LLMError(`O adaptador ${cfg.adaptador} não exporta uma função padrão (url, init) => Response.`);
+  return fn(url, init);
+}
+const notConfigured = () => new LLMError("A IA não está configurada: no Studio, abra Configurar IA (ou crie ~/.sagadeck/ia.json).", { code: "AI_NOT_CONFIGURED" });
+const howToFix = "Confira o provedor e a chave em Configurar IA, no Studio.";
+
 // Disponibilidade com cache curto, para o Studio decidir entre LLM e as regras determinísticas.
 let availability = { at: 0, ok: false, url: "" };
 
 export async function llmAvailable({ force = false } = {}) {
   const cfg = llmConfig();
+  if (!llmConfigured(cfg)) return false;
   if (!force && availability.url === cfg.url && Date.now() - availability.at < 30_000) return availability.ok;
   let ok = false;
   try {
-    const res = await fetch(`${cfg.url}/models`, { headers: headers(cfg), signal: AbortSignal.timeout(2500) });
+    const res = await send(cfg, `${cfg.url}/models`, { headers: headers(cfg), signal: AbortSignal.timeout(2500) });
     ok = res.ok;
   } catch {
     ok = false;
@@ -106,13 +141,13 @@ export async function chat(messages, opts = {}) {
 
 async function chatUnmetered(messages, opts = {}) {
   const cfg = opts.cfg || llmConfig();
-  const key = `${cfg.url}|${cfg.app}|${opts.model || cfg.textModel}`;
+  const key = `${cfg.url}|${opts.model || cfg.textModel}`;
   // o modelo de texto não enxerga: a chamada com imagem vai para o modelo de visão (se o relay tiver um)
   const viaVision = async () => {
     const vision = cfg.visionModel;
-    if (!vision || vision === (opts.model || cfg.textModel) || noVision.has(`${cfg.url}|${cfg.app}|${vision}`)) return null;
+    if (!vision || vision === (opts.model || cfg.textModel) || noVision.has(`${cfg.url}|${vision}`)) return null;
     try { return { ...(await chatOnce(messages, { ...opts, model: vision, cfg })), visionRouted: vision }; }
-    catch (e) { if (refusesImages(e) || e.status === 400 || e.status === 404) { noVision.add(`${cfg.url}|${cfg.app}|${vision}`); return null; } throw e; }
+    catch (e) { if (refusesImages(e) || e.status === 400 || e.status === 404) { noVision.add(`${cfg.url}|${vision}`); return null; } throw e; }
   };
   if (hasImageParts(messages) && noVision.has(key)) {
     return (await viaVision()) || { ...(await chatOnce(withoutImages(messages), { ...opts, cfg })), imagesDropped: true };
@@ -147,7 +182,8 @@ async function chatOnce(messages, opts = {}) {
 }
 
 async function chatOnceRaw(messages, { model, temperature, maxTokens, onDelta, signal, reasoningOff, cfg = llmConfig() } = {}) {
-  const body = { model: model || cfg.textModel, messages };
+  if (!llmConfigured(cfg)) throw notConfigured();
+  const body = { model: resolveModel(cfg, model || cfg.textModel), messages };
   if (reasoningOff) body.reasoning = { enabled: false };
   if (temperature !== undefined) body.temperature = temperature;
   if (maxTokens) body.max_tokens = maxTokens;
@@ -155,7 +191,7 @@ async function chatOnceRaw(messages, { model, temperature, maxTokens, onDelta, s
 
   let res;
   try {
-    res = await fetch(`${cfg.url}/chat/completions`, {
+    res = await send(cfg, `${cfg.url}/chat/completions`, {
       method: "POST",
       headers: headers(cfg),
       body: JSON.stringify(body),
@@ -168,7 +204,7 @@ async function chatOnceRaw(messages, { model, temperature, maxTokens, onDelta, s
     if (e.cause?.code === "UND_ERR_HEADERS_TIMEOUT") return chatStream(body, () => {}, cfg, signal);
     const why = e.name === "TimeoutError" ? `sem resposta em ${cfg.timeoutMs / 1000}s` : e.message;
     throw new LLMError(`Não consegui falar com o LLM em ${cfg.url} (${why}). ` +
-      "Rode `modelrelay serve` ou ajuste SAGADECK_LLM_URL.", { cause: e });
+      howToFix, { cause: e });
   }
 
   const raw = await res.text();
@@ -213,7 +249,7 @@ async function chatStream(body, onDelta, cfg, signal) {
 async function readStream(body, onDelta, cfg, signal, sig, alive, wrote = () => {}, noTextFor = () => 0) {
   let res;
   try {
-    res = await fetch(`${cfg.url}/chat/completions`, {
+    res = await send(cfg, `${cfg.url}/chat/completions`, {
       method: "POST",
       headers: headers(cfg),
       body: JSON.stringify({ ...body, stream: true, stream_options: { include_usage: true } }),
@@ -223,7 +259,7 @@ async function readStream(body, onDelta, cfg, signal, sig, alive, wrote = () =>
     if (signal?.aborted) throw new LLMError("Parado a pedido.", { cause: e, aborted: true });
     const why = e.name === "TimeoutError" ? `não começou a responder em ${(cfg.firstTimeoutMs ?? cfg.timeoutMs) / 1000} s` : e.message;
     throw new LLMError(`Não consegui falar com o LLM em ${cfg.url} (${why}). ` +
-      "Rode `modelrelay serve` ou ajuste SAGADECK_LLM_URL.", { cause: e });
+      howToFix, { cause: e });
   }
   alive(); // começou: daqui em diante, o limite é ficar sem chegar nada
   if (!res.ok) {

package/src/ai/progress.js

@@ -0,0 +1,23 @@
+// Quadro de etapas da geração: cada aviso de progresso diz em que etapa está ("Leitura crítica: …") e, quando duas
+// etapas correm juntas (o inventário do documento enquanto a crítica lê o texto), mostra as duas. Antes a tela
+// ficava minutos em "Pensando…" sem dizer pensando em quê.
+export function stageBoard(onEvent = () => {}) {
+  const active = new Map(), done = [];
+  const send = (extra = {}) => onEvent({ ...extra, stages: [...active.keys()], done: [...done],
+    text: [...active].map(([label, text]) => (text ? `${label}: ${text}` : label)).join(' · ') });
+  return {
+    // roda fn(emit) como a etapa `label`; emit aceita texto ou o evento { phase, text, chars, preview }
+    async run(label, fn) {
+      active.set(label, '');
+      send({ phase: 'stage' });
+      const emit = (ev) => {
+        if (!active.has(label)) return;
+        const obj = ev && typeof ev === 'object' ? ev : { phase: 'step', text: ev };
+        active.set(label, String(obj.text || ''));
+        send({ ...obj, phase: obj.phase || 'step' });
+      };
+      try { return await fn(emit); }
+      finally { active.delete(label); done.push(label); if (active.size) send({ phase: 'stage' }); }
+    },
+  };
+}

package/src/ai/quality.js

@@ -11,9 +11,36 @@ const oneLinerText = s => s.text || s.quote || (Array.isArray(s.lines) ? s.lines
 
 // 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.
-export function auditText(spec, indices) {
+// 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));
@@ -38,7 +65,8 @@ export function auditText(spec, indices) {
 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]);
-  issues.push(...auditText(spec, selected));
+  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

@@ -11,6 +11,7 @@ import YAML from "yaml";
 import { resolveTheme, themeCSS, scopedThemeCSS } from "./themes.js";
 import { identityFor, identitiesFile } from "./identity.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";
@@ -127,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`);
@@ -307,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";
@@ -267,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>`;
@@ -394,7 +395,13 @@ export function parseCounterValue(raw) {
   const m = /^(\D*?)(-?\d[\d.,]*)(.*)$/s.exec(String(raw ?? "").trim());
   if (!m) return null;
   let num = m[2].replace(/[.,]$/, ""), dec = 0;
-  if (num.includes(",")) { dec = num.split(",").pop().length; num = num.replace(/\./g, "").replace(",", "."); }
+  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);
@@ -407,7 +414,7 @@ export function counter(e) {
   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>`;
 }

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/layouts.js

@@ -415,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)}`;
   },