sagadeck 1.3.1 → 1.5.0

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/base.css

@@ -247,6 +247,9 @@ code.f-mono{font-size:.86em;background:color-mix(in srgb,var(--fg) 9%,transparen
 .cd-num{font-size:110px;line-height:.9}
 .cd-title{font-size:52px}
 .cd-text{font-size:33px;color:var(--muted)}
+/* cartão cujo texto é só uma fórmula: a fórmula é o conteúdo, não nota de rodapé (no tamanho do texto ela sumia) */
+.cd-text.cd-math{font-size:52px;color:var(--fg);margin:.15em 0}
+.card-hi .cd-text.cd-math{color:var(--on-hi)}
 .card-hi .cd-text{color:var(--on-hi)}
 .cd-foot{margin-top:auto;font-size:20px;color:var(--muted)}
 

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

@@ -225,6 +225,24 @@
     });
   }
 
+  // Recorte (crop): a região vira a caixa por porcentagem, o que só é proporcional quando a caixa tem a proporção da
+  // região. Medida a caixa de verdade, se não bater (mais de 3%), a região inteira é encaixada no centro (como
+  // contain), em vez de esticar a figura na largura ou na altura.
+  function fitCrops(root) {
+    root.querySelectorAll(".fig-crop img[data-crop]").forEach((img) => {
+      if (!img.naturalWidth) { if (!img.dataset.cropWait) { img.dataset.cropWait = "1"; img.addEventListener("load", () => fitCrops(img.parentElement || img), { once: true }); } return; }
+      const box = img.parentElement, W = box.clientWidth, H = box.clientHeight;
+      if (!W || !H) return;
+      const [l, t, r, b] = img.dataset.crop.split(",").map(Number);
+      const fw = Math.max(0.01, 1 - l - r), fh = Math.max(0.01, 1 - t - b);
+      const region = (fw * img.naturalWidth) / (fh * img.naturalHeight);
+      if (Math.abs(region - W / H) / (W / H) < 0.03) return;
+      const rw = region > W / H ? W : H * region, rh = rw / region; // a região inteira, sem esticar
+      const iw = rw / fw, ih = rh / fh;
+      Object.assign(img.style, { width: `${iw}px`, height: `${ih}px`, left: `${(W - rw) / 2 - l * iw}px`, top: `${(H - rh) / 2 - t * ih}px` });
+    });
+  }
+
   // Passos do exercício resolvido (solution): a coluna é alinhada pelo fim (o passo novo embaixo) e o que sobra vaza por
   // cima, apagando. Antes de cortar, encolhe (até 60%) para os passos caberem inteiros. Quadro escondido não mede: o
   // runtime chama de novo a cada clique.
@@ -257,6 +275,7 @@
   function fitAllIn(root) {
     fitStages(root);
     fitImages(root);
+    fitCrops(root);
     fitSteps(root);
     fitChartText(root);
     fitCode(root);
@@ -264,5 +283,5 @@
     fitText(root);
   }
 
-  g.SagadeckFit = { fitText: fitAllIn, fitChartText, fitCode, fitWide, fitImages, fitSteps, fitStages, shrink };
+  g.SagadeckFit = { fitText: fitAllIn, fitChartText, fitCode, fitWide, fitImages, fitCrops, fitSteps, fitStages, shrink };
 })(typeof window !== "undefined" ? window : globalThis);

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

@@ -6,16 +6,36 @@ import path from "node:path";
 import crypto from "node:crypto";
 import { loadSpec } from "../build.js";
 import { writeRecording } from "../api-client.js";
-import { editDeck } from "../ai/deck-ai.js";
+import { editDeck, coverDocumentVisuals, checkNumbers } from "../ai/deck-ai.js";
 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,53 @@ 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.
+        const attachedDocs = (Array.isArray(body.attachments) ? body.attachments : []).some((a) => a && typeof a === "object" && a.type === "doc");
+        if (attachedDocs && !result.talk && !result.transform && !result.style && !result.variants && result.spec?.slides) {
+          const rewritten = Array.isArray(result.changed) ? result.changed.length : 0;
+          if (rewritten >= Math.max(5, result.spec.slides.length / 2)) {
+            const covered = await coverDocumentVisuals(result.spec, { materials, briefing: prompt, say: (s) => emit({ phase: "step", text: s }),
+              edit: (o) => editDeck({ signal, images: true, imageOptions: imageOptions(taskWorkspace, withBase(taskWorkspace, spec)), onProgress: emit, materials, drawCheck: diagramCheck, ...o }) });
+            signal.throwIfAborted();
+            if (covered.spec !== result.spec) { result.spec = covered.spec; result.actions = [...(result.actions || []), ...covered.actions]; }
+            if (covered.coverage?.missing.length) result.actions = [...(result.actions || []), `Sem slide (figuras/tabelas do material): ${covered.coverage.missing.join("; ")}`];
+            const checked = await checkNumbers(result.spec, { materials, say: (s) => emit({ phase: "step", text: s }),
+              edit: (o) => editDeck({ signal, images: true, imageOptions: imageOptions(taskWorkspace, withBase(taskWorkspace, spec)), onProgress: emit, materials, drawCheck: diagramCheck, ...o }) });
+            signal.throwIfAborted();
+            if (checked.spec !== result.spec) { result.spec = checked.spec; result.actions = [...(result.actions || []), ...checked.actions]; }
+            if (checked.facts?.unsupported.length) result.actions = [...(result.actions || []), `Números sem base no material: ${checked.facts.unsupported.map((b) => `${b.number} (slide ${b.slide})`).join(", ")}`];
+          }
+        }
         if (linkActions.length) result.actions = [...linkActions, ...(result.actions || [])];
         // a IA decidiu transformar a apresentação inteira (transform:): o trabalho em etapas, com o andamento aqui
         if (result.transform) {

package/src/studio/code-version.js

@@ -0,0 +1,35 @@
+// Impressão do código do sagadeck (caminho, data e tamanho de cada arquivo). O Studio guarda a de quando subiu e a
+// página consulta de tempos em tempos: se o código mudou no disco (git pull, npm update, merge), o servidor que está
+// rodando ainda é o velho e a página avisa "reinicie". Antes, um Studio aberto antes de uma atualização recebia
+// arquivos novos do disco com o servidor velho e quebrava em silêncio (nenhum slide abria).
+import fs from "node:fs";
+import path from "node:path";
+import crypto from "node:crypto";
+
+const CODE = /\.(m?js|html|css|json)$/i;
+
+export function codeFingerprint(root) {
+  const h = crypto.createHash("sha1");
+  const walk = (dir) => {
+    let entries;
+    try { entries = fs.readdirSync(dir, { withFileTypes: true }); } catch { return; }
+    for (const e of entries.sort((a, b) => (a.name < b.name ? -1 : 1))) {
+      if (e.name === "node_modules" || e.name.startsWith(".")) continue;
+      const p = path.join(dir, e.name);
+      if (e.isDirectory()) walk(p);
+      else if (CODE.test(e.name)) { try { const st = fs.statSync(p); h.update(`${path.relative(root, p)}|${st.mtimeMs}|${st.size}\n`); } catch {} }
+    }
+  };
+  walk(root);
+  return h.digest("hex").slice(0, 16);
+}
+
+// a que vale para o servidor: a de quando ele subiu × a de agora (recalculada no máximo a cada poucos segundos)
+export function codeWatch(root, { every = 3000 } = {}) {
+  const started = codeFingerprint(root);
+  let now = started, at = Date.now();
+  return () => {
+    if (Date.now() - at > every) { now = codeFingerprint(root); at = Date.now(); }
+    return { started, now, changed: now !== started };
+  };
+}

package/src/studio/generate.js

@@ -0,0 +1,53 @@
+// Gerar uma apresentação pelo caminho do Studio ("Criar com IA" e chat de deck novo): Preferências, anexos guardados
+// na pasta do deck (com o inventário visual), imagens, revisão pelos slides renderizados e pesquisa. Fica fora do
+// servidor para a avaliação ao vivo (test/bench-live.test.js) medir exatamente o que a pessoa recebe.
+import path from "node:path";
+import { generateDeck } from "../ai/deck-ai.js";
+import { prepareDocumentMaterials } from "../ai/document-materials.js";
+import { reviewExperience } from "../ai/quality.js";
+import { stageBoard } from "../ai/progress.js";
+import { loadPreferences } from "../preferences.js";
+import { slideSnapshots, diagramCheck } from "./snapshot.js";
+
+const DOCUMENT = /\.(pdf|docx?)$/i;
+
+// b: o corpo do pedido (briefing, answer, theme, style, slides, duration, direction); materials: [{ name, text, detail, bytes }]
+// O inventário do documento (a visão lendo página a página: minutos num paper) corre JUNTO com o resto: entender o
+// pedido, pesquisar e a leitura crítica usam só o texto; a escrita espera o inventário. Parou antes (a IA perguntou,
+// deu erro): o inventário é cancelado e a pasta fica livre.
+export async function generateForStudio(b, { dir, materials = [], emit, prefs = loadPreferences().ia, prepare = prepareDocumentMaterials } = {}) {
+  const board = stageBoard((ev) => emit?.(ev));
+  const stop = new AbortController();
+  const withBytes = materials.some((m) => m.bytes);
+  const pending = withBytes ? board.run("Lendo o documento", (onProgress) => prepare(materials, dir, { onProgress, signal: stop.signal })) : null;
+  pending?.catch(() => {}); // quem espera é a geração; se ela parou antes, o erro do cancelamento não importa
+  // enquanto isso, o texto do documento (o binário fica com o inventário); `document` marca que é um documento
+  const text = materials.map(({ bytes, ...m }) => (bytes && DOCUMENT.test(m.name || "") ? { ...m, document: true } : m));
+  try {
+    const gen = await generateDeck(String(b.briefing || ""), {
+      ask: prefs.perguntar !== false && !b.answer, answer: b.answer ? String(b.answer).slice(0, 500) : "",
+      author: prefs.autor || "", language: prefs.idioma || "auto",
+      theme: b.theme || undefined,
+      style: b.style || undefined,
+      slides: Number(b.slides) || undefined,
+      duration: Number(b.duration) || undefined,
+      direction: b.direction || undefined,
+      materials: text,
+      pendingMaterials: pending,
+      board,
+      images: prefs.imagens !== false, // o briefing diz se quer imagens (e onde); Preferências podem desligar
+      imageOptions: { baseDir: dir, assetsDir: path.join(dir, "imagens") },
+      onEvent: emit,
+      drawCheck: diagramCheck,
+      reviewCheck: (deck, indices, o = {}) => reviewExperience({ ...deck, _dir: dir }, indices, { snapshot: slideSnapshots, onProgress: o.onProgress || emit, briefing: b.briefing }),
+      // pesquisa na web quando a IA decidir que precisa (Preferências › IA pode desligar; SAGADECK_WEB=0 no banco);
+      // as fontes lidas ficam em contexto/pesquisa/ do deck
+      research: prefs.pesquisa === false ? false : "auto",
+      researchDir: dir,
+    });
+    return gen;
+  } finally {
+    stop.abort();
+    await pending?.catch(() => {});
+  }
+}