sagadeck 1.4.0 → 1.5.0

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

package/src/library.js

@@ -9,25 +9,74 @@
 //       rascunho.yaml                 um .yaml solto no tópico também é uma apresentação
 //     rascunho.yaml                   .yaml solto na raiz = apresentação sem tópico
 // Na raiz, pasta é SEMPRE tópico. "Nova sem tópico" vai para "Sem tópico"; importar sem tópico, para "Importados".
-//     .lixeira/                       excluídas (30 dias), com .origem.json
+//     .lixeira/                       excluídas (1 dia), com .origem.json
 //     .cache/                         capas geradas
 //
 // O id de uma apresentação é o caminho do .yaml dela, relativo à biblioteca, com "/" (ex.: "Palestras/X/X.yaml").
 import fs from "node:fs";
+import { renameRetry } from "./fs-retry.js";
 import os from "node:os";
+import { execFileSync } from "node:child_process";
 import path from "node:path";
 import YAML from "yaml";
 import * as MASTER from "./master.js";
 import { unpackDeck } from "./package.js";
 import { writeDeckFile } from "./deck-file.js";
 
-export const TRASH_DAYS = 30;
+export const TRASH_DAYS = 1;
 const TRASH = ".lixeira";
 const TOPIC_META = ".topico.json";
 const COLORS = ["#d33a2c", "#0f6cbd", "#e5a50a", "#8b5cf6", "#0e9f6e", "#e8590c", "#d6336c", "#495057"];
 
-export function defaultLibraryRoot(env = process.env) {
-  return path.resolve(env.SAGADECK_HOME || path.join(os.homedir(), "sagadeck"));
+// Pasta Documentos do Windows como o Explorer a mostra: a pasta conhecida "Personal" do registro, que pode estar
+// redirecionada (OneDrive\Documents, outro disco, "Documentos"). Sem ela, %USERPROFILE%\Documents. Fora do Windows, null.
+let documentsCache;
+export function documentsDir({ platform = process.platform, home = os.homedir() } = {}) {
+  if (platform !== "win32") return null;
+  if (documentsCache !== undefined && home === os.homedir()) return documentsCache;
+  let found = null;
+  try {
+    const out = execFileSync("reg", ["query", "HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Explorer\\Shell Folders", "/v", "Personal"], { encoding: "utf8", windowsHide: true, timeout: 5000 });
+    found = out.match(/Personal\s+REG_\w+\s+(.+)/)?.[1]?.trim() || null;
+  } catch { /* sem registro: o padrão abaixo */ }
+  const dir = found && path.isAbsolute(found) ? found : path.join(home, "Documents");
+  if (home === os.homedir()) documentsCache = dir;
+  return dir;
+}
+
+// A biblioteca: SAGADECK_HOME, senão <Documentos>\sagadeck no Windows e ~/sagadeck fora dele. Enquanto a biblioteca
+// antiga (~/sagadeck, o padrão até a 1.4) não foi movida para Documentos, ela continua valendo: nunca abre vazia.
+export function defaultLibraryRoot(env = process.env, { platform = process.platform, home = os.homedir(), documents } = {}) {
+  if (env.SAGADECK_HOME) return path.resolve(env.SAGADECK_HOME);
+  const legacy = path.join(home, "sagadeck");
+  const docs = documents !== undefined ? documents : documentsDir({ platform, home });
+  if (!docs) return path.resolve(legacy);
+  const target = path.join(docs, "sagadeck");
+  if (!fs.existsSync(target) && hasContent(legacy) && !isLink(legacy)) return path.resolve(legacy);
+  return path.resolve(target);
+}
+
+const isLink = (p) => { try { return fs.lstatSync(p).isSymbolicLink(); } catch { return false; } };
+const hasContent = (p) => { try { return fs.readdirSync(p).length > 0; } catch { return false; } };
+
+// Leva a biblioteca antiga (~/sagadeck) para <Documentos>\sagadeck, uma vez: move a pasta inteira (mesma unidade:
+// instantâneo) e deixa no lugar antigo uma junção para a nova, para atalhos e configurações antigas continuarem
+// valendo. Não mexe se SAGADECK_HOME manda, se a nova já tem conteúdo (não mistura bibliotecas) ou se a antiga já
+// é a junção. Falhou (arquivo aberto, outra unidade): a antiga continua sendo a biblioteca e tenta de novo depois.
+export function migrateLegacyLibrary(env = process.env, { platform = process.platform, home = os.homedir(), documents } = {}) {
+  if (env.SAGADECK_HOME) return { skipped: "SAGADECK_HOME" };
+  const docs = documents !== undefined ? documents : documentsDir({ platform, home });
+  if (!docs) return { skipped: "fora do Windows" };
+  const legacy = path.join(home, "sagadeck"), target = path.join(docs, "sagadeck");
+  if (path.resolve(legacy) === path.resolve(target) || isLink(legacy) || !hasContent(legacy)) return { skipped: "nada a mover" };
+  if (hasContent(target)) return { skipped: "as duas têm conteúdo", legacy, target };
+  try {
+    fs.mkdirSync(docs, { recursive: true });
+    if (fs.existsSync(target)) fs.rmdirSync(target); // pasta vazia criada antes
+    renameRetry(legacy, target);
+  } catch (e) { return { error: e.message, legacy, target }; }
+  try { fs.symlinkSync(target, legacy, "junction"); } catch { /* sem a junção, a nova pasta já é a biblioteca */ }
+  return { moved: true, legacy, target };
 }
 
 // Onde uma apresentação NOVA é gravada: sempre na biblioteca. Um caminho dentro dela é respeitado; qualquer
@@ -65,8 +114,11 @@ const isYaml = (name) => /\.ya?ml$/i.test(name) && !hidden(name);
 
 // nome de pasta/arquivo válido no Windows (e no Linux): sem <>:"/\|?*, sem ponto/espaço no fim
 export function safeName(s, fallback = "Sem título") {
-  const clean = String(s || "").normalize("NFC").replace(/[<>:"/\\|?*\u0000-\u001f]/g, " ").replace(/\s+/g, " ").trim()
-    .replace(/[. ]+$/, "").slice(0, 80).trim();
+  let clean = String(s || "").normalize("NFC").replace(/[<>:"/\\|?*\u0000-\u001f]/g, " ").replace(/\s+/g, " ").trim()
+    .replace(/[. ]+$/, "");
+  // nome longo corta no último espaço antes de 80 (a pasta saía "…and Urban Flood Predic")
+  if (clean.length > 80) { const cut = clean.slice(0, 81).lastIndexOf(" "); clean = clean.slice(0, cut >= 40 ? cut : 80); }
+  clean = clean.replace(/[\s.,;:—–-]+$/, "").trim();
   return /^(con|prn|aux|nul|com\d|lpt\d)$/i.test(clean) || !clean ? fallback : clean;
 }
 
@@ -164,7 +216,7 @@ export function openLibrary(root) {
     if (color) fs.writeFileSync(path.join(dir, TOPIC_META), JSON.stringify({ ...topicMeta(dir), color }));
     if (name && safeName(name) !== path.basename(dir)) {
       const to = uniquePath(root, safeName(name));
-      fs.renameSync(dir, to);
+      renameRetry(dir, to);
       dir = to;
     }
     return path.basename(dir);
@@ -208,7 +260,7 @@ export function openLibrary(root) {
     if (path.dirname(unit) === dest) return id;
     const ext = unit === file ? path.extname(file) : "";
     const to = uniquePath(dest, path.basename(unit, ext), ext);
-    fs.renameSync(unit, to);
+    renameRetry(unit, to);
     return idOf(unit === file ? to : path.join(to, path.basename(file)));
   }
 
@@ -220,12 +272,12 @@ export function openLibrary(root) {
     if (unit === file) return id; // .yaml solto: só o título
     const to = uniquePath(path.dirname(unit), safeName(title));
     if (path.basename(to) === path.basename(unit)) return id;
-    fs.renameSync(unit, to);
+    renameRetry(unit, to);
     // o .yaml com o nome da pasta acompanha a pasta
     let yaml = path.join(to, path.basename(file));
     if (path.basename(file).replace(/\.ya?ml$/i, "") === path.basename(unit)) {
       const renamed = path.join(to, path.basename(to) + path.extname(file));
-      fs.renameSync(yaml, renamed);
+      renameRetry(yaml, renamed);
       yaml = renamed;
     }
     return idOf(yaml);
@@ -240,7 +292,7 @@ export function openLibrary(root) {
     let yaml = unit === file ? to : path.join(to, path.basename(file));
     if (unit !== file && path.basename(file).replace(/\.ya?ml$/i, "") === path.basename(unit)) {
       const renamed = path.join(to, path.basename(to) + path.extname(file));
-      fs.renameSync(yaml, renamed);
+      renameRetry(yaml, renamed);
       yaml = renamed;
     }
     const spec = YAML.parse(fs.readFileSync(yaml, "utf8")) || {};
@@ -283,9 +335,9 @@ export function openLibrary(root) {
     if (!Array.isArray(spec.slides) || !spec.slides.length) throw new Error("a geração não produziu slides: nada foi publicado");
     const dest = uniquePath(base, safeName(title || spec.title || "Nova apresentação"));
     spec.title = title || spec.title || path.basename(dest);
-    fs.renameSync(abs, dest);
+    renameRetry(abs, dest);
     const final = path.join(dest, path.basename(dest) + ".yaml");
-    fs.renameSync(path.join(dest, "deck.yaml"), final);
+    renameRetry(path.join(dest, "deck.yaml"), final);
     writeDeckFile(final, spec); // só o título muda no arquivo
     return idOf(final);
   }
@@ -296,7 +348,7 @@ export function openLibrary(root) {
     fs.mkdirSync(tdir, { recursive: true });
     const slot = path.join(tdir, `${Date.now()}-${STAGING}`);
     fs.mkdirSync(slot);
-    fs.renameSync(abs, path.join(slot, path.basename(abs)));
+    renameRetry(abs, path.join(slot, path.basename(abs)));
     const yaml = path.join(slot, path.basename(abs), "deck.yaml");
     let slides = 0, title = reason;
     try { const spec = YAML.parse(fs.readFileSync(yaml, "utf8")) || {}; slides = Array.isArray(spec.slides) ? spec.slides.length : 0; if (spec.title && spec.title !== "Gerando…") title = spec.title; } catch {}
@@ -327,7 +379,7 @@ export function openLibrary(root) {
     fs.mkdirSync(tdir, { recursive: true });
     const slot = path.join(tdir, `${Date.now()}-${path.basename(unit)}`);
     fs.mkdirSync(slot);
-    fs.renameSync(unit, path.join(slot, path.basename(unit)));
+    renameRetry(unit, path.join(slot, path.basename(unit)));
     fs.writeFileSync(path.join(slot, ".origem.json"), JSON.stringify({
       topic: info.topic, title: info.title, deleted: Date.now(), yaml: path.relative(unit === file ? path.dirname(file) : unit, file),
       unit: path.basename(unit), slides: info.slides,
@@ -348,7 +400,7 @@ export function openLibrary(root) {
     const isFile = /\.ya?ml$/i.test(o.unit);
     const ext = isFile ? path.extname(o.unit) : "";
     const to = uniquePath(dest, path.basename(o.unit, ext), ext);
-    fs.renameSync(path.join(slot, o.unit), to);
+    renameRetry(path.join(slot, o.unit), to);
     fs.rmSync(slot, { recursive: true, force: true });
     return idOf(isFile ? to : path.join(to, o.yaml));
   }

package/src/locale.js

@@ -0,0 +1,18 @@
+// Idioma dos números do deck (`lang`, padrão pt-BR): contador, gráficos e mapas formatavam sempre em português, e um
+// deck em inglês mostrava "1.403" (mil quatrocentos e três) e "0,93". A renderização é síncrona, slide a slide: quem
+// monta o deck (build.js) define o idioma antes e os desenhos leem daqui.
+let current = "pt-BR";
+
+export function normalizeLocale(lang) {
+  const l = String(lang || "").trim();
+  if (!l) return "pt-BR";
+  if (/^pt/i.test(l)) return "pt-BR";
+  if (/^en/i.test(l)) return /^en-GB/i.test(l) ? "en-GB" : "en-US";
+  try { return Intl.getCanonicalLocales(l)[0]; } catch { return "pt-BR"; }
+}
+
+export function setDeckLocale(lang) { current = normalizeLocale(lang); return current; }
+export const deckLocale = () => current;
+export const formatNumber = (v, opts) => Number(v).toLocaleString(current, opts);
+// separador decimal do idioma atual ("," em pt-BR, "." em en-US)
+export const decimalSeparator = (locale = current) => (1.5).toLocaleString(locale).replace(/\d/g, "")[0] || ",";

package/src/mcp/server.js

@@ -82,7 +82,7 @@ const TOOLS = [
     inputSchema: {
       type: "object",
       properties: {
-        path: { type: "string", description: "Nome da apresentação (ou caminho dentro da biblioteca SAGADECK_HOME/~/sagadeck). Toda apresentação é gravada na biblioteca: caminho de fora vira só o nome, e nada é sobrescrito" },
+        path: { type: "string", description: "Nome da apresentação (ou caminho dentro da biblioteca SAGADECK_HOME ou Documentos/sagadeck). Toda apresentação é gravada na biblioteca: caminho de fora vira só o nome, e nada é sobrescrito" },
         title: { type: "string", description: "Título provisório da apresentação" },
         theme: {
           type: "string",
@@ -105,7 +105,7 @@ const TOOLS = [
     inputSchema: {
       type: "object",
       properties: {
-        path: { type: "string", description: "Nome da apresentação (ou caminho dentro da biblioteca SAGADECK_HOME/~/sagadeck). Toda apresentação é gravada na biblioteca: caminho de fora vira só o nome, e nada é sobrescrito" },
+        path: { type: "string", description: "Nome da apresentação (ou caminho dentro da biblioteca SAGADECK_HOME ou Documentos/sagadeck). Toda apresentação é gravada na biblioteca: caminho de fora vira só o nome, e nada é sobrescrito" },
         title: { type: "string", description: "Título da apresentação" },
         theme: {
           type: "string",

package/src/motion.js

@@ -22,7 +22,7 @@ function drawTrace(ctx,o,t,w,h){
  ctx.restore();
 }
 function scene(o){
- let active=o.type!=='chat',started=false,epoch=performance.now(),serial=0,phase='idle',elapsed=0,previous=0;let reduced=matchMedia('(prefers-reduced-motion:reduce)').matches;const main=document.querySelector('main'),canvas=document.querySelector('canvas'),ctx=canvas.getContext('2d');
+ let active=o.type!=='chat',started=false,epoch=performance.now(),serial=0,phase='idle',elapsed=0,previous=0;let reduced=!!o.still||matchMedia('(prefers-reduced-motion:reduce)').matches;const main=document.querySelector('main'),canvas=document.querySelector('canvas'),ctx=canvas.getContext('2d');
  const message=(kind)=>parent.postMessage({sagaMotion:kind},'*');
  const chat=document.querySelector('.chat'),input=document.querySelector('.input'),thread=document.querySelector('.thread'),status=document.querySelector('.status');
  function reset(){started=false;phase='idle';elapsed=0;chat.hidden=true;input.textContent='';thread.replaceChildren();status.textContent='';}
@@ -51,6 +51,8 @@ function scene(o){
  }
  requestAnimationFrame(draw);
 }
-export function motionHTML(value,colors){const o=motionOptions(value,colors);const css=`html,body{height:100%;background:${o.type==='chat'?'transparent':o.background};color:${o.foreground};overflow:hidden}main{height:100%;position:relative}canvas{position:absolute;inset:0;width:100%;height:100%}.caption{position:absolute;top:12px;left:16px;color:${o.secondary};font:11px monospace;letter-spacing:1.5px}.feed{position:absolute;top:36px;left:16px;right:16px;bottom:12px;overflow:hidden;font:${o.type==='terminal'?o.fontSize:12}px/1.5 monospace;white-space:pre}.chat{position:absolute;inset:0;border:1px solid ${o.secondary};border-radius:16px;padding:18px;background:${o.background};display:flex;flex-direction:column;gap:12px}.chat[hidden]{display:none}.thread{flex:1;overflow:auto;display:flex;flex-direction:column;gap:12px}.bubble{font:18px/1.45 system-ui;max-width:90%;padding:10px 14px;border-radius:10px;white-space:pre-wrap}.user{align-self:flex-end;background:#263a51}.assistant{align-self:flex-start}.status{font:14px system-ui;color:${o.secondary};min-height:18px}.input{border:1px solid #51617b;border-radius:9px;min-height:48px;padding:12px;font:17px system-ui;white-space:pre-wrap}.chat-title{font:12px system-ui;letter-spacing:2px;color:${o.secondary}}`;
+// still: o deck pediu movimento nenhum (motion: none). A cena já nasce parada e completa; antes ela só sabia pela
+// mensagem da página, que sob carga chegava depois de o terminal começar a digitar.
+export function motionHTML(value,colors,{still=false}={}){const o={...motionOptions(value,colors),...(still?{still:true}:{})};const css=`html,body{height:100%;background:${o.type==='chat'?'transparent':o.background};color:${o.foreground};overflow:hidden}main{height:100%;position:relative}canvas{position:absolute;inset:0;width:100%;height:100%}.caption{position:absolute;top:12px;left:16px;color:${o.secondary};font:11px monospace;letter-spacing:1.5px}.feed{position:absolute;top:36px;left:16px;right:16px;bottom:12px;overflow:hidden;font:${o.type==='terminal'?o.fontSize:12}px/1.5 monospace;white-space:pre}.chat{position:absolute;inset:0;border:1px solid ${o.secondary};border-radius:16px;padding:18px;background:${o.background};display:flex;flex-direction:column;gap:12px}.chat[hidden]{display:none}.thread{flex:1;overflow:auto;display:flex;flex-direction:column;gap:12px}.bubble{font:18px/1.45 system-ui;max-width:90%;padding:10px 14px;border-radius:10px;white-space:pre-wrap}.user{align-self:flex-end;background:#263a51}.assistant{align-self:flex-start}.status{font:14px system-ui;color:${o.secondary};min-height:18px}.input{border:1px solid #51617b;border-radius:9px;min-height:48px;padding:12px;font:17px system-ui;white-space:pre-wrap}.chat-title{font:12px system-ui;letter-spacing:2px;color:${o.secondary}}`;
  const html=`<main><canvas aria-hidden="true"></canvas><div class="caption">${esc(o.type==='chat'?'':o.caption)}</div><div class="feed" aria-hidden="true"></div><section class="chat" hidden><div class="chat-title">${esc(o.caption||'ASSISTENTE')}</div><div class="thread" aria-live="polite"></div><div class="status"></div><div class="input" aria-label="Mensagem digitada"></div></section></main>`;
  const doc=playgroundDocument({html,css,javascript:`${drawHologram.toString()}\n${drawTrace.toString()}\n(${scene.toString()})(${JSON.stringify(o)});`});return `<iframe data-motion="${o.type}" data-motion-manual="${o.manual}" data-motion-finish="${o.finish}" title="${esc(o.caption||'Detalhe animado')}" sandbox="allow-scripts" style="width:100%;height:100%;border:0" srcdoc="${esc(doc)}"></iframe>`;}

package/src/preferences.js

@@ -1,6 +1,7 @@
 // Preferências do sagadeck nesta máquina: ~/.sagadeck/preferencias.json (ou SAGADECK_PREFERENCIAS), ao lado do
 // ambientes.yaml e do identidades.yaml. Valem para o Studio inteiro; o deck (fit:, author…) vence quando define.
 import fs from "node:fs";
+import { renameRetry } from "./fs-retry.js";
 import os from "node:os";
 import path from "node:path";
 
@@ -56,6 +57,6 @@ export function savePreferences(patch, file = preferencesFile()) {
   fs.mkdirSync(path.dirname(file), { recursive: true });
   const tmp = `${file}.tmp-${process.pid}`;
   fs.writeFileSync(tmp, JSON.stringify(out, null, 2) + "\n", "utf8");
-  fs.renameSync(tmp, file);
+  renameRetry(tmp, file);
   return out;
 }

package/src/runtime/calc.js

@@ -6,10 +6,10 @@
     if (v == null || !Number.isFinite(v)) return "—";
     if (o.sci || Math.abs(v) >= 1e7 || (Math.abs(v) < 1e-3 && v !== 0)) {
       const [m, e] = v.toExponential(2).split("e");
-      return `${m.replace(".", ",")} × 10${String(Number(e)).split("").map((c) => SUP[c] ?? c).join("")}`;
+      return `${(1.5).toLocaleString((typeof document !== "undefined" && document.documentElement.lang) || "pt-BR").includes(",") ? m.replace(".", ",") : m} × 10${String(Number(e)).split("").map((c) => SUP[c] ?? c).join("")}`;
     }
-    if (o.decimals != null) return v.toLocaleString("pt-BR", { minimumFractionDigits: o.decimals, maximumFractionDigits: o.decimals });
-    return v.toLocaleString("pt-BR", { maximumSignificantDigits: Math.abs(v) >= 1000 ? 7 : 4 });
+    if (o.decimals != null) return v.toLocaleString((typeof document !== "undefined" && document.documentElement.lang) || "pt-BR", { minimumFractionDigits: o.decimals, maximumFractionDigits: o.decimals });
+    return v.toLocaleString((typeof document !== "undefined" && document.documentElement.lang) || "pt-BR", { maximumSignificantDigits: Math.abs(v) >= 1000 ? 7 : 4 });
   }
   // todas as saídas na ordem (uma saída usa as anteriores); `cases` escolhe texto/cor/fórmula pela faixa de `of`
   function evaluate(model, values = {}) {

package/src/runtime/decision-lab.js

@@ -17,7 +17,7 @@
     return { ...s, automatic, caught, introduced, reviewed: automatic - caught + introduced,
       hours: s.volume * r * s.seconds / 3600, delta: introduced - caught };
   }
-  const fmt = n => n.toLocaleString('pt-BR', { maximumFractionDigits: 1 });
+  const fmt = n => n.toLocaleString((typeof document !== "undefined" && document.documentElement.lang) || "pt-BR", { maximumFractionDigits: 1 });
   function mount(container = document) {
     container.querySelectorAll('[data-decision-lab]').forEach(el => {
       if (el.dataset.mounted) return;

package/src/runtime/runtime.js

@@ -65,7 +65,8 @@
   }
 
   // ---------- contador ----------
-  function fmtNum(v, dec) { return v.toLocaleString("pt-BR", { minimumFractionDigits: dec, maximumFractionDigits: dec }); }
+  // no idioma do deck (<html lang>, que vem do lang do deck): em inglês "1,403" e "0.93"
+  function fmtNum(v, dec) { return v.toLocaleString((typeof document !== "undefined" && document.documentElement.lang) || "pt-BR", { minimumFractionDigits: dec, maximumFractionDigits: dec }); }
   function runCounter(c, instant) {
     const to = +c.dataset.to, from = +c.dataset.from, dec = +c.dataset.dec, cv = $(".cv", c);
     const pre = c.dataset.prefix, suf = c.dataset.suffix;

package/src/studio/ai-chat-route.js

@@ -11,11 +11,31 @@ import { reviewExperience } from "../ai/quality.js";
 import { maybeResearch } from "../research/chat-research.js";
 import { chatErrorResult } from "./errors.js";
 import { cancellable, respond } from "./ai-response.js";
-import { prepareDocumentMaterials, takeMaterials } from "../ai/document-materials.js";
+import { prepareDocumentMaterials, takeMaterials, storedDocumentMaterials } from "../ai/document-materials.js";
+import { critiqueMaterials, critiqueMarkdown, saveCritique, loadCritique, critiqueMaterial, markCritiqueItem } from "../ai/critique.js";
 import { styleAction } from "./style-routes.js";
 import * as Project from "./project.js";
 import { carryVisualEdits } from "./visual-keys.js";
 
+// Arquivos que a IA pode pedir para ver (ver: […]): imagens DENTRO da pasta da apresentação (os recortes e as
+// páginas do material ficam em contexto/visuais/). Caminho que sai da pasta, que não existe ou que não é imagem fica
+// de fora; no máximo 6.
+export function lookableFiles(deckDir, wanted = []) {
+  if (!deckDir) return [];
+  const root = path.resolve(deckDir);
+  const out = [];
+  for (const w of wanted) {
+    const rel = String(w || "").replace(/\\/g, "/").replace(/^\.\//, "").trim();
+    if (!rel || !/\.(png|jpe?g|webp|gif)$/i.test(rel)) continue;
+    const abs = path.resolve(root, rel);
+    if (abs !== root && !abs.startsWith(root + path.sep)) continue;
+    if (!fs.existsSync(abs) || !fs.statSync(abs).isFile()) continue;
+    if (!out.some((o) => o.abs === abs)) out.push({ rel, abs });
+    if (out.length >= 6) break;
+  }
+  return out;
+}
+
 export async function aiChatRoutes({ req, res, pathname, url, W, readJSON, staleTab, llmAvailable, llmConfig, lookAt, withBase, apiBlocked, ensureEnsaio, readPastedLinks, imageOptions, apiContextFor, commandRunner, diagramCheck, slideSnapshots, persist, isBundledTemplate, runTransform, transforms, apiEnv }) {
   if (pathname === "/api/ai/chat/cancel" && req.method === "POST") {
     const body = await readJSON(req);
@@ -25,6 +45,52 @@ export async function aiChatRoutes({ req, res, pathname, url, W, readJSON, stale
     res.end(JSON.stringify({ ok: true, stopped: !!job }));
     return true;
   }
+  // Leitura crítica do material da apresentação aberta (botão do chat): src/ai/critique.js. Nada muda nos slides; o
+  // resultado fica em .sagadeck/leitura-critica.json (acompanha os próximos pedidos ao chat) e volta como conversa.
+  if (pathname === "/api/ai/critique" && req.method === "POST") {
+    const body = await readJSON(req);
+    if (staleTab(body, W, res)) return true;
+    const deckDir = W.file && !isBundledTemplate(W.file) ? path.dirname(W.file) : null;
+    const spec = body.spec || W.spec;
+    await respond(res, body.stream, async (emit) => {
+      const P = deckDir ? Project.projectOf(W.file) : null;
+      let materials = deckDir ? storedDocumentMaterials(deckDir) : [];
+      if (!materials.length && P) materials = (await Project.contextMaterials(P)).filter((m) => String(m.text || "").length > 1500);
+      if (!materials.length) return { talk: true, reply: "Esta apresentação não tem material anexado para ler criticamente. Anexe o documento (PDF, Word) no chat e peça de novo.", options: [] };
+      if (!(await llmAvailable({ force: true }))) return { talk: true, reply: `A IA está desligada (nenhum LLM respondendo em ${llmConfig().url}).`, options: [] };
+      emit({ phase: "step", text: `Lendo ${materials.map((m) => m.name).join(", ")} com olho crítico…` });
+      const c = await critiqueMaterials(materials, { spec, briefing: spec?.context ? JSON.stringify(spec.context) : "" });
+      saveCritique(deckDir, c);
+      const autor = spec?.context?.autoria !== "livre";
+      const options = c.itens.length
+        ? (autor
+          ? ["Leve para os slides os achados que estão no material", "Ponha as perguntas prováveis e as inconsistências nas notes", "Corrija os slides apontados", "Só queria ler, obrigado"]
+          : ["Transforme os achados em conteúdo, marcando o que é do sagadeck", "Crie um slide de discussão crítica", "Corrija os slides apontados", "Só queria ler, obrigado"])
+        : [];
+      const head = c.itens.length
+        ? `Li ${c.material.join(", ")} como um revisor da área. ${c.itens.length} ponto(s), cada um com o trecho do material que o sustenta (conferido no texto). ${autor ? "Como a apresentação é do próprio autor, nada disso entra nos slides sem você pedir: o que é achado do material pode ir para os slides; crítica e perguntas, para as notes." : "Como a apresentação é livre, posso transformar isso em conteúdo, marcando o que é do sagadeck."}`
+        : "Não achei nada com trecho conferido no material para apontar.";
+      // os pontos vão também estruturados: o chat mostra cada um como cartão, ligado ao slide, com Aplicar e Ignorar
+      return { talk: true, reply: `${head}\n\n${critiqueMarkdown(c)}`, critique: { itens: c.itens, autor, summary: `${head}${c.naoConfirmados.length ? `
+
+_${c.naoConfirmados.length} observação(ões) descartada(s): o trecho citado não foi encontrado no material._` : ""}` }, options, actions: [`Leitura crítica: ${c.itens.length} ponto(s) conferido(s)${c.naoConfirmados.length ? `, ${c.naoConfirmados.length} descartado(s) sem trecho no material` : ""}`] };
+    });
+    return true;
+  }
+  // cartão da leitura crítica: a pessoa aplicou ou ignorou o ponto (ignorado deixa de acompanhar os pedidos)
+  if (pathname === "/api/ai/critique/item" && req.method === "POST") {
+    const body = await readJSON(req);
+    const deckDir = W.file && !isBundledTemplate(W.file) ? path.dirname(W.file) : null;
+    try {
+      const item = markCritiqueItem(deckDir, String(body.id || ""), String(body.status || ""));
+      res.writeHead(200, { "Content-Type": "application/json" });
+      res.end(JSON.stringify({ ok: true, item }));
+    } catch (e) {
+      res.writeHead(400, { "Content-Type": "application/json" });
+      res.end(JSON.stringify({ error: e.message }));
+    }
+    return true;
+  }
   if (pathname === "/api/ai/chat" && req.method === "POST") {
     const body = await readJSON(req);
     if (staleTab(body, W, res)) return true;
@@ -69,6 +135,9 @@ export async function aiChatRoutes({ req, res, pathname, url, W, readJSON, stale
         // arquivos do projeto (contexto/): material para a IA, junto com os anexos da mensagem
         const P = taskWorkspace.file && !isBundledTemplate(taskWorkspace.file) ? Project.projectOf(taskWorkspace.file) : null;
         if (P) for (const doc of await Project.contextMaterials(P)) if (!materials.some((m) => m.name === doc.name || m.name === doc.name.split("/").pop())) materials.push(doc);
+        // a leitura crítica já feita (geração ou botão) acompanha o pedido, rotulada como do sagadeck
+        const critique = critiqueMaterial(loadCritique(P ? path.dirname(taskWorkspace.file) : null));
+        if (critique) materials.push(critique);
         // links colados na mensagem: o servidor lê sozinho e conta nas ações
         const linkActions = [];
         for (const doc of await readPastedLinks(taskWorkspace, prompt, linkActions)) materials.push(doc);
@@ -77,9 +146,10 @@ export async function aiChatRoutes({ req, res, pathname, url, W, readJSON, stale
         const chatResearch = await maybeResearch({ prompt, materials, saveDir: taskWorkspace.file && !isBundledTemplate(taskWorkspace.file) ? path.dirname(taskWorkspace.file) : null, onProgress: (s) => emit({ phase: "step", text: s }) });
         materials = chatResearch.materials;
         if (chatResearch.report?.fontes?.length) linkActions.push(`Pesquisa na web: ${chatResearch.report.fontes.length} fonte(s) (${chatResearch.report.fontes.map((f) => f.site).join(", ")})`);
-        result = await editDeck({
+        const firstInstruction = chatResearch.instruction ? `${chatResearch.instruction}\n${prompt}` : prompt;
+        const editOpts = (extra = {}) => ({
           spec: withBase(taskWorkspace, spec), signal,
-          instruction: chatResearch.instruction ? `${chatResearch.instruction}\n${prompt}` : prompt,
+          instruction: firstInstruction,
           targetSlide: target,
           issues,
           images: true, // a IA decide (regra no prompt: só quando pedirem ou aceitarem)
@@ -94,8 +164,34 @@ export async function aiChatRoutes({ req, res, pathname, url, W, readJSON, stale
           runCommand: commandRunner(req, emit, body, taskWorkspace, signal),
           reviewCheck: (deck, indices) => reviewExperience(deck, indices, { snapshot: slideSnapshots, onProgress: emit, signal, briefing:prompt }),
           styles: taskWorkspace.file && !isBundledTemplate(taskWorkspace.file) ? { list: taskWorkspace.library.listStyles(), current: taskWorkspace.spec?.style?.name || null } : null,
+          ...extra,
         });
+        result = await editDeck(editOpts());
         signal.throwIfAborted();
+        // A IA pediu para VER o material (ver: [recortes, páginas]): do documento ela só recebe o texto e o
+        // inventário. O Studio carrega as imagens (só arquivos da pasta desta apresentação) e chama de novo, com elas
+        // anexadas; até 2 rodadas. Antes ela respondia "não tenho acesso ao PDF" ou dizia ter visto o que não viu.
+        const deckDir = taskWorkspace.file && !isBundledTemplate(taskWorkspace.file) ? path.dirname(taskWorkspace.file) : null;
+        const seen = [];
+        for (let round = 1; result.look?.length && round <= 2; round++) {
+          const files = lookableFiles(deckDir, result.look);
+          const missing = result.look.filter((f) => !files.some((x) => x.rel === f.replace(/\\/g, "/").replace(/^\.\//, "")));
+          emit({ phase: "step", text: files.length ? `Olhando o material: ${files.map((f) => path.basename(f.rel)).join(", ")}…` : "Os arquivos pedidos não estão na pasta da apresentação." });
+          const { imagesAsDataUrls } = await import("../import/crop.js");
+          const urls = files.length ? await imagesAsDataUrls(files.map((f) => f.abs), { width: 1600, quality: 0.9 }) : [];
+          signal.throwIfAborted();
+          files.forEach((f, k) => urls[k] && seen.push({ label: `material: ${f.rel}`, dataUrl: urls[k] }));
+          result.actions = [...(result.actions || []), files.length ? `Olhei no material: ${files.map((f) => f.rel).join(", ")}` : "Pedido de ver o material sem arquivo válido"];
+          const before = result;
+          result = await editDeck(editOpts({
+            visuals: [...visuals, ...seen],
+            history: [...history, { role: "user", text: prompt }, { role: "assistant", text: before.reply }],
+            instruction: `${files.length ? `Aqui estão as imagens do material que você pediu para ver (${files.map((f) => f.rel).join(", ")}), anexadas com o rótulo "material: <arquivo>".` : "Nenhuma das imagens pedidas existe na pasta da apresentação."}${missing.length ? ` Não encontrei: ${missing.join(", ")} (use os caminhos exatos do inventário: recortes em items[].image e páginas inteiras em pages).` : ""} Agora atenda o pedido da pessoa já vendo, sem pedir de novo o que já está aqui:\n"""\n${firstInstruction}\n"""`,
+          }));
+          signal.throwIfAborted();
+          result.actions = [...before.actions, ...(result.actions || [])];
+        }
+        if (result.look?.length) result = { ...result, look: undefined, talk: true, reply: `${result.reply}\n(Já mostrei as imagens duas vezes; me diga o que procurar nelas.)` };
         // documento anexado NESTA mensagem e a resposta montou/reescreveu a maior parte do deck (criar a apresentação
         // do paper pelo chat): a mesma conferência de cobertura da geração. Pedido pontual ("use a figura 3 no slide
         // 5") não dispara: mexe em poucos slides.