sagadeck 1.7.1 → 1.9.0

package/src/studio/layout-samples.js

@@ -22,11 +22,10 @@ export const LAYOUT_INFO = {
   science: ["Fórmulas e funções", "Escreva a fórmula e ela vira curva; cada letra vira um controle deslizante. Aceita pontos colados do Excel e superfície 3D"],
   infographic: ["Infográfico", "Arco, ramos, lados, trilhas ou metrô: de 2 a 8 itens coloridos em volta de um centro"],
   diagram: ["Diagrama", "Fluxograma, sequência, estados, UML, jornada, mapa mental (Mermaid) nas cores do tema"],
-  scenography: ["Texto no cenário", "13 composições (palco, terminal, café, embarque, pregão, cinema, revista…), sem animação"],
   cover: ["Capa", "Abertura com título, subtítulo e autor"],
   section: ["Seção", "Abre um novo ato ou capítulo"],
   statement: ["Frase de impacto", "Uma ideia em letras grandes"],
-  calendar: ["Calendário", "Datas num calendário: um cartão por mês com o mini calendário e os eventos marcados; o que não tem data vai em \"sem data\""],
+  calendar: ["Calendário", "Datas num calendário: um cartão por mês, um mês grande de parede, a semana com horários ou a agenda em lista; com muitos eventos, um slide por mês"],
   poster: ["Pôster (infográfico)", "Uma página como figura de revista científica: ilustração principal e painéis com letra (a, b, c), desenho, texto curto e números"],
   definition: ["Definição", "O termo em destaque, a origem da palavra em partes e a definição, com um ícone ilustrativo"],
   headline: ["Manchete", "Uma frase enorme ocupando o slide"],
@@ -48,6 +47,7 @@ export const LAYOUT_INFO = {
   timeline: ["Linha do tempo", "Eventos em sequência"],
   chart: ["Gráfico de dados", "Barras, colunas, linhas, rosca: cole a tabela do Excel ou digite os valores"],
   table: ["Tabela", "Tabela de verdade nas cores do tema: cole do Excel, destaque linha e total"],
+  map: ["Mapa", "Pontos, linhas e áreas sobre o mapa ao vivo: da planilha do projeto, de GeoJSON/GPX/KML ou valores por estado; cor por categoria, cartão ao clicar, uma camada por clique"],
   compare: ["Comparação", "A × B lado a lado"],
   matrix: ["Matriz 2×2", "Quatro quadrantes"],
   question: ["Pergunta", "Pergunta para a plateia com timer"],
@@ -57,7 +57,6 @@ export const LAYOUT_INFO = {
   codewalk: ["Código guiado", "Explique uma linha por vez, com destaques e saída simulada"],
   api: ["API ao vivo", "Requisição que executa na hora (tipo Postman): síncrono, polling ou streaming, com código curl/Python"],
   spotlight: ["Foco guiado", "Conduza o olhar por detalhes de uma imagem ou diagrama"],
-  kinetic: ["Tipografia cinética", "Frases em sequência viram parte da cena com ritmo e estilos tipográficos que mudam"],
   video: ["Vídeo", "Player YouTube online ou MP4 incorporado"],
   blocks: ["Livre (blocos)", "Monte com blocos em linhas e colunas"],
   canvas: ["Livre (posições)", "Posicione cada elemento à mão"],
@@ -65,7 +64,75 @@ export const LAYOUT_INFO = {
   end: ["Encerramento", "Obrigado e contatos"],
 };
 
+// Como pedir cada layout à IA, em português comum: aparece no "Conheça o SagaDeck" (src/studio/tour.js), para quem vê
+// o recurso saber a frase que o gera. Exemplos de áreas variadas, nunca de um setor só.
+export const LAYOUT_ASK = {
+  portal: "Abra a palestra entrando numa porta que transforma o cenário e revela o tema",
+  playground: "Faça um slide interativo em que a plateia mexe num controle e vê a cor do céu mudar",
+  codelab: "Monte um exercício de código em que os alunos alteram a entrada e executam passo a passo",
+  graphlab: "Mostre a rede de metrô da cidade e deixe testar a rota mais curta tirando uma estação",
+  mosaic: "Liste as seis frentes do projeto num mosaico que se ajusta sozinho",
+  ribbon: "Mostre as três fases da obra em cápsulas, uma ao lado da outra",
+  dossier: "Faça uma página de consulta com os comandos e as respostas da API, para guardar",
+  decisionlab: "Compare revisão humana e automação com premissas que eu possa ajustar ao vivo",
+  solution: "Resolva passo a passo quanto rende uma aplicação de R$ 1.000 a 1% ao mês em três anos",
+  calc: "Faça uma calculadora do consumo de energia de uma casa, com faixas de baixo, médio e alto",
+  algo: "Mostre a busca binária rodando de verdade, com o código e as variáveis",
+  carousel: "Apresente cinco destinos de viagem, um por clique, com foto e uma frase",
+  duel: "Simule duas pessoas editando o mesmo arquivo no Git até dar conflito",
+  terminals: "Mostre dois terminais lado a lado: um faz push e o outro puxa a mudança",
+  turns: "Encene um diálogo entre cliente e atendente, uma fala por clique",
+  science: "Mostre a parábola y = ax² + bx + c com controles para a, b e c",
+  infographic: "Faça um infográfico com os cinco pilares da sustentabilidade em volta de um centro",
+  diagram: "Desenhe o fluxo de atendimento de um pedido, da chegada à entrega",
+  cover: "Faça a capa da palestra sobre energia solar, com o meu nome e a data",
+  section: "Abra a segunda parte, sobre os resultados",
+  statement: "Uma frase de impacto: a água mais barata é a que não se desperdiça",
+  calendar: "Mostre num calendário as datas das oficinas do semestre",
+  poster: "Faça um pôster de uma página explicando como funciona uma placa solar",
+  definition: "Defina \"sustentabilidade\", com a origem da palavra",
+  headline: "Uma manchete enorme: 40% da água tratada se perde no caminho",
+  quote: "Ponha a citação de Paulo Freire sobre ensinar, com o autor",
+  onepage: "Resuma o projeto numa página: jornada, problema com números, solução e painel",
+  status: "Faça o status da semana: feito, em andamento, bloqueios e próximos passos",
+  hub: "Monte um menu em que a plateia escolhe o caminho: iniciante, intermediário ou avançado",
+  number: "Mostre o número 1,2 milhão de visitantes, contando até ele",
+  split: "Explique o ciclo da água com o texto de um lado e uma ilustração do outro",
+  full: "Uma foto de floresta ocupando o slide inteiro",
+  cards: "Três cartões com os benefícios do programa, cada um com ícone",
+  bento: "Monte um mosaico de blocos com os destaques do ano",
+  stats: "Mostre quatro indicadores do trimestre com a tendência de cada um",
+  steps: "Mostre em etapas como instalar um sensor de umidade",
+  funnel: "Faça o funil de inscrições: visitantes, cadastros, inscritos e concluintes",
+  pyramid: "Monte a pirâmide de prioridades, do essencial ao desejável",
+  list: "Liste os cinco cuidados antes de uma viagem longa",
+  agenda: "Faça a agenda do evento com a parte atual destacada",
+  timeline: "Faça a linha do tempo da história do cinema brasileiro",
+  chart: "Faça um gráfico de linhas com a temperatura média de cada mês",
+  table: "Monte a tabela comparando três planos, com o total destacado",
+  map: "Mostre no mapa as estações de medição da planilha, coloridas pelo status, com um cartão ao clicar",
+  compare: "Compare transporte público e carro próprio lado a lado",
+  matrix: "Monte uma matriz 2x2 de esforço e impacto com as ideias do time",
+  question: "Faça uma pergunta para a plateia com cronômetro de 30 segundos",
+  poll: "Faça uma enquete ao vivo: qual tema vocês querem aprofundar?",
+  image: "Ponha esta foto em tela cheia com uma legenda curta",
+  code: "Mostre este código Python com as linhas da conexão destacadas",
+  codewalk: "Explique este código uma linha por vez, com a saída simulada",
+  api: "Faça uma chamada de API ao vivo que consulta o clima e mostra a resposta",
+  spotlight: "Conduza o olhar pelas partes desta planta baixa, uma por vez",
+  video: "Ponha este vídeo do YouTube no slide",
+  blocks: "Monte livremente um slide com título, dois textos e uma imagem em colunas",
+  canvas: "Posicione o logotipo, o título e a foto onde eu indicar",
+  references: "Liste as referências bibliográficas no fim",
+  end: "Feche com um obrigado e os meus contatos",
+};
+
 export const LAYOUT_SAMPLES = {
+  map: { layout: "map", kicker: "Monitoramento", title: "Estações de ==qualidade do ar==", basemap: "claro", layers: [
+    { name: "Estações", color: "status", label: "nome", points: [
+      { nome: "Centro", lat: -23.5489, lon: -46.6388, status: "Boa", pm25: 12 }, { nome: "Pinheiros", lat: -23.5614, lon: -46.7020, status: "Moderada", pm25: 24 },
+      { nome: "Ibirapuera", lat: -23.5874, lon: -46.6576, status: "Boa", pm25: 9 }, { nome: "Mooca", lat: -23.5596, lon: -46.5996, status: "Ruim", pm25: 41 },
+      { nome: "Santana", lat: -23.5027, lon: -46.6252, status: "Moderada", pm25: 27 }], colors: { Ruim: "alert" } }] },
   portal: portalExample,
   playground: playgroundExample,
   codelab: codeLabExample,
@@ -74,8 +141,8 @@ export const LAYOUT_SAMPLES = {
   ribbon: {layout:"ribbon",title:"Do primeiro passo ao resultado",items:[{title:"Explorar",text:"Encontre uma oportunidade."},{title:"Testar",text:"Experimente em pequena escala."},{title:"Evoluir",text:"Repita o que funciona."}]},
   dossier: {layout:"dossier",title:"Referência rápida",items:[{title:"Requisição",text:"GET consulta o recurso.",code:"GET /exemplos/42"},{title:"Resposta",text:"Confira o status antes de usar o corpo.",code:'{"id":42,"status":"ok"}'}]},
   decisionlab: {layout:"decisionlab", title:"A revisão melhora o resultado?", lab:{volume:10000,errorRate:2,reviewRate:100,catchRate:60,introducedRate:0.2,seconds:30}},
-  infographic: { layout: "infographic", shape: "arco", title: "Os ==desafios== do projeto", center: { title: "Desafios" }, items: [{ title: "Acesso", text: "Pedido pela Bridge" }, { title: "Dados", text: "Mockados no experimento" }, { title: "Segurança", text: "Chaves no Key Vault" }, { title: "Infra", text: "Namespace e firewall" }] },
-  diagram: { layout: "diagram", kicker: "Processo", title: "Da ideia à ==produção==", mermaid: "flowchart LR\n  A([:lightbulb: Ideia]):::hi --> B{Vale testar?}\n  B -->|sim| C[:flask-conical: Experimento]\n  B -.->|não| X[Arquivar]:::vazado\n  C ==> D[:rocket: Produção]:::em" },
+  infographic: { layout: "infographic", shape: "arco", title: "Os ==desafios== da viagem", center: { title: "Desafios" }, items: [{ title: "Roteiro", text: "Três cidades em dez dias" }, { title: "Orçamento", text: "Hospedagem pesa mais" }, { title: "Documentos", text: "Passaporte e visto" }, { title: "Clima", text: "Chuva na segunda semana" }] },
+  diagram: { layout: "diagram", kicker: "Processo", title: "Da ideia à ==produção==", mermaid: "flowchart LR\n  A([:lightbulb: Ideia]):::hi --> B{Vale testar?}\n  B -->|sim| C[:flask-conical: Protótipo]\n  B -.->|não| X[Arquivar]:::vazado\n  C ==> D[:rocket: Produção]:::em" },
   solution: {layout:"solution", title:"Exercício: quanto rende em 3 anos?", problem:"R$ 1.000 aplicados a 1% ao mês, com juros compostos. Quanto há depois de 36 meses?", givens:[{symbol:"C", value:"1000", unit:"R\\$", label:"capital"}, {symbol:"i", value:"0,01", label:"taxa ao mês"}, {symbol:"n", value:"36", label:"meses"}], find:"M", steps:[{text:"Juros compostos", latex:"M = C\\,(1 + i)^n"}, {text:"Substitui os dados", latex:"M = 1000 \\cdot 1{,}01^{36}"}, {text:"Calcula a potência", latex:"1{,}01^{36} \\approx 1{,}4308"}], answer:{latex:"M \\approx R\\$\\,1.430{,}77", text:"Rende cerca de 43% em 3 anos."}},
   calc: {layout:"calc", title:"Qual é o regime do escoamento?", inputs:{V:{label:"Velocidade", latex:"V", value:1.5, min:0.01, max:4, step:0.01, unit:"m/s"}, D:{label:"Diâmetro", latex:"D", value:0.05, min:0.005, max:0.3, step:0.005, unit:"m"}, nu:{label:"Viscosidade (água, 20 °C)", latex:"\\nu = 1{,}0\\times10^{-6}\\ \\mathrm{m^2/s}", value:0.000001, fixed:true}}, outputs:[{name:"Re", label:"Número de Reynolds", latex:"Re = \\frac{VD}{\\nu}", fn:"V*D/nu", decimals:0}, {name:"regime", label:"Regime", of:"Re", cases:[{below:2300, text:"Laminar", color:"s3"}, {below:4000, text:"Transição", color:"em"}, {text:"Turbulento", color:"hi"}], scale:{min:100, max:1000000, log:true}}]},
   algo: {layout:"algo", title:"Bubble sort passo a passo", algorithm:"bubble", array:[5, 1, 4, 2, 8, 3]},
@@ -86,15 +153,14 @@ export const LAYOUT_SAMPLES = {
   terminals: {layout:"terminals", title:"Dois terminais", file:"README.md", base:"# Projeto\nversão 1", people:["Ana","Beto"],
     turns:[{who:1, edit:{2:"versão 2"}, commit:"sobe a versão"}, {who:1, push:true}, {who:2, pull:true}, {who:2, log:true}]},
   turns: {layout:"turns", title:"Code review ao vivo", people:[{name:"Ana", role:"autora do PR"}, {name:"Beto", role:"revisor"}],
-    turns:[{who:1, text:"Abri o PR com a validação do Pix."}, {who:2, text:"Por que não usa o **schema** que já existe?", tag:"pergunta"}, {who:1, text:"Boa. Troquei e testei assim:", method:"POST", url:"/pix", status:201, code:'{ "valor": 10 }', language:"json"}, {who:2, text:"Aprovado.", tag:"aprovado"}]},
+    turns:[{who:1, text:"Abri o PR com a validação das inscrições."}, {who:2, text:"Por que não usa o **schema** que já existe?", tag:"pergunta"}, {who:1, text:"Boa. Troquei e testei assim:", method:"POST", url:"/inscricoes", status:201, code:'{ "nome": "Ana" }', language:"json"}, {who:2, text:"Aprovado.", tag:"aprovado"}]},
   science: {layout:"science", title:"Mexa no a e no b", equations:[{label:"A função",latex:"f(x) = a\\sin(bx)"},{label:"A derivada",latex:"f'(x) = ab\\cos(bx)"}], plot:{functions:["a*sin(b*x)","a*b*cos(b*x)"], x:[-6.3,6.3], params:{a:{value:1.5,min:0,max:3,label:"amplitude"},b:{value:1,min:0.5,max:3,label:"frequência"}}}},
-  scenography: {layout:"scenography", scene:"stage", title:"ALÉM DO\nÓBVIO", kicker:"UMA NOVA PERSPECTIVA", subtitle:"Ideias que ocupam espaço.", tone:"dark", deco:"none"},
   cover: { layout: "cover", kicker: "Evento 2026", title: "Título da ==apresentação==", subtitle: "Um subtítulo curto", author: "Seu nome", figure: { icon: "rocket", size: 320 } },
   section: { layout: "section", number: 2, kicker: "Parte dois", title: "O problema" },
   statement: { layout: "statement", kicker: "A ideia", text: "Uma frase que ==muda tudo==." },
   calendar: { layout: "calendar", kicker: "Agenda", title: "Próximos lançamentos", events: [
     { date: "2026-11-12", title: "Beta aberto", tag: "Produto", text: "Para os 500 primeiros" }, { date: "2026-11-28", title: "Evento de lançamento", tag: "Evento" },
-    { date: "2027-01-15", title: "Versão 2.0", tag: "Produto", text: "Com o app de celular" }], undated: [{ title: "Integração com o banco", text: "Em negociação" }] },
+    { date: "2027-01-15", title: "Versão 2.0", tag: "Produto", text: "Com o app de celular" }], undated: [{ title: "Loja em outra cidade", text: "Em negociação" }] },
   poster: { layout: "poster", kicker: "Receita", title: "Pão de fermentação natural", subtitle: "Do fermento ao forno em quatro etapas", flow: true,
     panels: [
       { title: "Fermento", icon: "wheat", text: "Farinha e água, alimentados por 5 dias", facts: [{ value: "1:1", label: "farinha e água" }] },
@@ -105,9 +171,9 @@ export const LAYOUT_SAMPLES = {
   definition: { layout: "definition", kicker: "O que é", term: "Hidrologia", origin: "do grego", parts: [{ word: "hydor", meaning: "água" }, { word: "logos", meaning: "ciência" }], text: "É a ciência que estuda ==a água sobre a Terra==: sua quantidade, distribuição e circulação, e sua relação com o meio ambiente e com os seres vivos.", icon: "droplet" },
   headline: { layout: "headline", text: "78% ==desistem==", caption: "no segundo passo" },
   quote: { layout: "quote", quote: "Dados vencem opiniões.", by: "Alguém sábio" },
-  onepage: { layout: "onepage", title: "Cadastro digital", journey: [{ icon: "user", title: "Cliente chega", text: "Fila de 40 min" }, { icon: "file-text", title: "Preenche papel" }, { icon: "check", title: "Conta aberta", text: "Até 5 dias" }], problem: { text: "Cadastro em papel atrasa a abertura de contas", numbers: [{ value: "5 dias", label: "para abrir uma conta" }] }, solution: { text: "Cadastro no tablet, com assinatura digital", items: ["Conta aberta no mesmo dia"] } },
-  status: { layout: "status", kicker: "Semana 39", title: "Portal do cliente", health: "risco", progress: 65, done: ["Tela de login", "Integração com o cadastro"], doing: ["Recuperação de senha"], blocked: [{ text: "Liberação de firewall", owner: "Infra", due: "30/09" }], upcoming: ["Homologar com o negócio"] },
-  hub: { layout: "hub", title: "Qual é o seu caso?", question: "Cada caminho tem o seu prazo", options: [{ icon: "flask-conical", title: "Experimento", meta: "30 dias", goto: "exp" }, { icon: "rocket", title: "Projeto", meta: "DEV, HOM e PROD", goto: "proj" }] },
+  onepage: { layout: "onepage", title: "Agendamento online", journey: [{ icon: "user", title: "Paciente liga", text: "Espera de 15 min" }, { icon: "file-text", title: "Preenche a ficha" }, { icon: "check", title: "Consulta marcada", text: "Até 5 dias" }], problem: { text: "Marcar por telefone atrasa as consultas", numbers: [{ value: "5 dias", label: "para marcar uma consulta" }] }, solution: { text: "Agendamento pelo celular, com confirmação automática", items: ["Consulta marcada no mesmo dia"] } },
+  status: { layout: "status", kicker: "Semana 39", title: "Portal do cliente", health: "risco", progress: 65, done: ["Tela de login", "Integração com o cadastro"], doing: ["Recuperação de senha"], blocked: [{ text: "Aprovação do texto de privacidade", owner: "Jurídico", due: "30/09" }], upcoming: ["Teste com 20 usuários"] },
+  hub: { layout: "hub", title: "Qual é o seu caso?", question: "Cada caminho tem o seu ritmo", options: [{ icon: "user", title: "Primeira vez", meta: "4 passos", goto: "inicio" }, { icon: "rocket", title: "Já uso", meta: "Atalhos", goto: "atalhos" }] },
   number: { layout: "number", value: 42, suffix: "%", label: "mais rápido" },
   split: { layout: "split", title: "Texto e figura", bullets: ["Primeiro ponto", "Segundo ponto"], figure: { icon: "lightbulb", size: 300 } },
   full: { layout: "full", figure: { chart: "donut", value: 72, center: "72%" }, title: "Figura em página inteira", overlay: "left" },
@@ -138,11 +204,7 @@ export const LAYOUT_SAMPLES = {
     hotspots: [{ x: 4, y: 18, width: 92, height: 15, title: "O pedido", text: "O verbo GET consulta o recurso. A rota identifica a coleção de aulas." },
       { x: 4, y: 38, width: 92, height: 10, title: "A confirmação", text: "200 OK confirma o sucesso. O tempo ajuda a investigar a experiência do usuário." },
       { x: 5, y: 52, width: 78, height: 39, title: "Os dados", text: "A estrutura JSON é o contrato que o front-end precisa entender." }] },
-  kinetic: { layout: "kinetic", figure: { svg: '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1920 1080"><defs><linearGradient id="stage" x2="0" y2="1"><stop stop-color="#697a78"/><stop offset="1" stop-color="#26353a"/></linearGradient><linearGradient id="window" x2="0" y2="1"><stop stop-color="#e1cba1"/><stop offset="1" stop-color="#8d9990"/></linearGradient></defs><path fill="url(#stage)" d="M0 0h1920v1080H0z"/><path fill="#202b2e" d="M0 0h430v1080H0zM1490 0h430v1080h-430z"/><path fill="url(#window)" d="M500 90h910v660H500z"/><path fill="#d0b88e" opacity=".4" d="M500 560h910v190H500z"/><path fill="#293432" d="M0 850h1920v230H0z"/><path fill="#394342" d="M720 814h480v36H720z"/><path fill="#26302f" d="M836 555c28-120 205-154 266-14l76 263H760z"/><circle cx="960" cy="465" r="74" fill="#39403b"/></svg>' }, autoplay: true, interval: 1800,
-    beats: [{ text: "Uma ideia", style: "clean", position: "left", color: "white", size: "medium", tag: "GANHA FORMA" },
-      { text: "muda o olhar", style: "clean", position: "right", color: "gold", size: "medium" },
-      { text: "e abre caminhos", style: "clean", position: "left", color: "white", size: "medium" }] },
-  // genérico de propósito: troque método, URL e corpo pelos do seu serviço (os exemplos prontos ficam no deck "Exemplo: aula de APIs")
+  // genérico de propósito: troque método, URL e corpo pelos do seu serviço (os exemplos prontos ficam na demo "APIs com curl" e no `sagadeck ensaio-api`)
   api: { layout: "api", kicker: "Ao vivo", title: "Minha ==chamada==", text: "Troque o método, a URL e o corpo pelos do seu serviço", request: { method: "POST", url: "{{base}}/echo", body: { mensagem: "Olá, API" } }, answer: "$.recebido.mensagem" },
   video: { layout: "video", title: "Assista", url: "https://example.com", label: "Assistir" },
   blocks: { layout: "blocks", title: "Blocos livres", content: [{ row: [{ lead: "Esquerda" }, { lead: "Direita" }] }] },

package/src/studio/library-routes.js

@@ -103,15 +103,6 @@ export async function libraryRoutes({ req, res, pathname, url, W, opts, readJSON
         if (!made) throw new Error("Não há um modelo em prévia aberto.");
         return ok(made);
       }
-      case "/api/library/decks/example-cenario": {
-        // demonstração do Texto no cenário: o YAML e as imagens de exemplo (fundo e recorte transparente)
-        const dir0 = TEMPLATE_DIRS.map((d) => path.join(d, "cenario")).find((d) => fs.existsSync(d));
-        if (!dir0) throw new Error("o exemplo não veio no pacote (templates/cenario)");
-        const tpl = fs.readdirSync(dir0).find((f) => f.endsWith(".yaml"));
-        const id = L.createDeck(b.topic || "", YAML.parse(fs.readFileSync(path.join(dir0, tpl), "utf8")));
-        fs.cpSync(path.join(dir0, "imagens"), path.join(path.dirname(L.resolveId(id)), "imagens"), { recursive: true, force: false });
-        return ok({ id });
-      }
       case "/api/library/decks/example": {
         // exemplo de slides api (aula de APIs de IA): roda no ambiente embutido "ensaio", sem configurar nada
         const tpl = templateFile("ensaio-api.yaml");

package/src/studio/project.js

@@ -20,7 +20,7 @@ const toNum = (v) => rawNum(String(v ?? "").trim().replace(/^R\$\s*/i, "").repla
 export const META = ".sagadeck";
 export const CONTEXT = "contexto";
 const TEXT_EXT = new Set(["md", "markdown", "txt", "csv", "tsv", "json", "yaml", "yml", "css", "js", "mjs", "cjs", "jsx", "ts", "tsx", "html", "htm", "svg", "xml",
-  "py", "r", "m", "sql", "sh", "bash", "bat", "ps1", "ini", "toml", "cfg", "java", "c", "h", "cpp", "cs", "go", "rs", "tex", "bib", "log"]);
+  "py", "r", "m", "sql", "sh", "bash", "bat", "ps1", "ini", "toml", "cfg", "java", "c", "h", "cpp", "cs", "go", "rs", "tex", "bib", "log", "geojson", "gpx", "kml"]); // geo: as camadas do mapa (map.js) se editam aqui
 const SHEET_EXT = new Set(["csv", "tsv", "xlsx"]);
 const IMAGE_EXT = new Set(["png", "jpg", "jpeg", "gif", "webp", "svg"]);
 const extOf = (f) => (String(f).match(/\.([a-z0-9]+)$/i)?.[1] || "").toLowerCase();
@@ -226,6 +226,7 @@ export function writeSheet(P, rel, rows) {
   if (!Array.isArray(rows) || rows.some((r) => !Array.isArray(r))) throw new Error("Planilha inválida.");
   const old = fs.existsSync(abs) ? parseCSV(fs.readFileSync(abs, "utf8"), ext === "tsv" ? "\t" : undefined) : { delimiter: ext === "tsv" ? "\t" : ",", eol: "\n" };
   const tmp = abs + ".tmp";
+  fs.mkdirSync(path.dirname(abs), { recursive: true }); // planilha nova numa pasta que ainda não existe (contexto/)
   const clean = rows.map((r) => r.map((c) => String(c ?? "")));
   while (clean.length > 1 && clean.at(-1).every((c) => c === "")) clean.pop(); // linha vazia no fim (o cursor passou dela) não vai para o arquivo
   fs.writeFileSync(tmp, toCSV(clean, old));

package/src/studio/public/ai-settings.js

@@ -8,13 +8,15 @@ window.SagaAISettings = (() => {
 .ai-cfg .row{display:flex;gap:8px;justify-content:flex-end;margin-top:16px;flex-wrap:wrap}.ai-cfg button{padding:7px 14px;border-radius:8px;border:1px solid var(--border,#c9ced6);background:transparent;color:inherit;cursor:pointer;font:inherit}
 .ai-cfg .rec{background:var(--selected,#eef);border-radius:8px;padding:8px 10px;margin:6px 0 4px}.ai-cfg .rec button{margin-top:6px;display:block}
 .ai-cfg button.primary{background:var(--brand,#5b4bdb);border-color:var(--brand,#5b4bdb);color:#fff}.ai-cfg [data-status]{margin-top:10px;min-height:1.4em}.ai-cfg [data-status].ok{color:#15803d}.ai-cfg [data-status].err{color:#b91c1c}`;
-  const LABEL = { text: "Modelo de texto", vision: "Modelo que vê imagens", image: "Modelo de imagem", search: "Modelo de busca na web" };
-  const HINT = { text: "obrigatório", vision: "opcional; vazio = o de texto", image: "opcional; para gerar ilustrações", search: "opcional; no OpenRouter, um modelo :online" };
+  const LABEL = { text: "Modelo de texto", vision: "Modelo que vê imagens", image: "Modelo de imagem", search: "Modelo de busca na web", video: "Modelo de vídeo" };
+  const HINT = { text: "obrigatório", vision: "opcional; vazio = o de texto", image: "opcional; para gerar ilustrações", search: "opcional; no OpenRouter, um modelo :online", video: "opcional; para gerar clipes (cobrado por segundo)" };
   const esc = (s) => String(s ?? "").replace(/[&<>"]/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;" })[c]);
   let dialog, info, onSaved = () => {};
 
+  // o estilo da caixa serve também ao Configurar mapa (map-settings.js)
+  const ensureStyle = () => { if (!document.getElementById("ai-cfg-style")) { const st = document.createElement("style"); st.id = "ai-cfg-style"; st.textContent = css; document.head.append(st); } };
   function build() {
-    if (!document.getElementById("ai-cfg-style")) { const st = document.createElement("style"); st.id = "ai-cfg-style"; st.textContent = css; document.head.append(st); }
+    ensureStyle();
     dialog = document.createElement("dialog");
     dialog.className = "ai-cfg";
     dialog.id = "ai-settings-dialog";
@@ -85,6 +87,7 @@ window.SagaAISettings = (() => {
   }
 
   return {
+    ensureStyle,
     async open(saved) {
       onSaved = typeof saved === "function" ? saved : () => {};
       if (!dialog) build();

package/src/studio/public/app.js

@@ -35,7 +35,7 @@
   const LAYOUT_NAMES = [
     "cover", "section", "statement", "definition", "poster", "calendar", "headline", "quote", "number", "split", "full",
     "cards", "bento", "mosaic", "ribbon", "stats", "steps", "funnel", "pyramid", "list", "agenda", "timeline", "hub", "status", "onepage",
-    "chart", "table", "compare", "matrix", "decisionlab", "diagram", "infographic", "question", "poll", "image", "code", "codewalk", "spotlight", "scenography", "portal", "science", "kinetic", "video", "carousel", "duel", "terminals", "turns", "solution", "calc", "algo", "graphlab", "codelab", "playground",
+    "chart", "table", "map", "compare", "matrix", "decisionlab", "diagram", "infographic", "question", "poll", "image", "code", "codewalk", "spotlight", "portal", "science", "video", "carousel", "duel", "terminals", "turns", "solution", "calc", "algo", "graphlab", "codelab", "playground",
     "blocks", "dossier", "canvas", "references", "end",
   ];
 
@@ -43,9 +43,9 @@
   const LAYOUT_LABELS = {
     cover: "Capa", section: "Seção", statement: "Frase de impacto", definition: "Definição", poster: "Pôster (infográfico)", calendar: "Calendário", quote: "Citação", number: "Número grande",
     split: "Texto e figura", cards: "Cartões", stats: "Indicadores", steps: "Etapas", list: "Lista",
-    timeline: "Linha do tempo", chart: "Gráfico de dados", table: "Tabela", compare: "Comparação", matrix: "Matriz 2×2",
+    timeline: "Linha do tempo", chart: "Gráfico de dados", table: "Tabela", map: "Mapa", compare: "Comparação", matrix: "Matriz 2×2",
     question: "Pergunta", poll: "Enquete", image: "Imagem", code: "Código", video: "Vídeo",
-    diagram: "Diagrama", infographic: "Infográfico", mosaic: "Grade adaptável", ribbon: "Cápsulas", dossier: "Página de consulta", decisionlab: "Laboratório de decisões", science: "Fórmulas e funções", scenography: "Texto no cenário", codewalk: "Código guiado", spotlight: "Foco guiado", kinetic: "Tipografia cinética",
+    diagram: "Diagrama", infographic: "Infográfico", mosaic: "Grade adaptável", ribbon: "Cápsulas", dossier: "Página de consulta", decisionlab: "Laboratório de decisões", science: "Fórmulas e funções", codewalk: "Código guiado", spotlight: "Foco guiado",
     duel: "Duelo de commits", terminals: "Dois terminais", turns: "Turnos a dois", carousel: "Carrossel", solution: "Exercício resolvido", calc: "Calculadora ao vivo", algo: "Algoritmo animado",
     graphlab: "Rede explorável", codelab: "Código explorável", playground: "Experiência personalizada", portal: "Portal e transformação",
     blocks: "Livre (blocos)", canvas: "Livre (posições)", end: "Encerramento", references: "Referências",
@@ -394,6 +394,7 @@
     const idx = state.currentSlideIndex;
     const slide = state.deck.slides[idx];
     if (!slide) return;
+    window.SagaProject?.slideChanged?.(slide);
     if (dom.tabPanelVars.classList.contains("active")) renderStudioSavedVars();
 
     renderReviewBar(slide, idx);
@@ -424,8 +425,11 @@
 
       // Renderizar HTML no palco
       window.SagaScience?.dispose(dom.renderedSlideContainer);
+      window.SagaMap?.dispose(dom.renderedSlideContainer, { keepView: true });
       dom.renderedSlideContainer.innerHTML = data.html;
       window.SagaScience?.mount(dom.renderedSlideContainer);
+      window.SagaMap?.mount(dom.renderedSlideContainer); // só aqui (prévia grande); miniaturas e galeria ficam na prévia em SVG
+      window.SagaMapData?.attach(dom.renderedSlideContainer, slide, () => { syncDeckToServer(); renderCurrentSlide(); }, { toast: showToast, hydrate: hydrateIcons, materialized: previewMaterialized });
       window.SagaCalc?.mount(dom.renderedSlideContainer); // calculadora ao vivo: os controles funcionam no editor também
       window.SagaDiagrams?.mount(dom.renderedSlideContainer).then(() => reportDiagram(dom.renderedSlideContainer));
       window.SagaDecisionLab?.mount(dom.renderedSlideContainer);
@@ -2045,11 +2049,11 @@
   const SLIDE_GROUPS = [
     ["estrutura", "Abertura e estrutura", ["cover", "section", "agenda", "end", "references"]],
     ["texto", "Texto e ideias", ["statement", "definition", "poster", "calendar", "headline", "quote", "list", "cards", "split", "mosaic", "ribbon", "bento", "dossier"]],
-    ["dados", "Números e gráficos", ["number", "stats", "chart", "table", "science", "compare", "matrix"]],
+    ["dados", "Números e gráficos", ["number", "stats", "chart", "table", "map", "science", "compare", "matrix"]],
     ["processo", "Processos e diagramas", ["steps", "timeline", "funnel", "pyramid", "diagram", "infographic", "hub"]],
     ["gestao", "Gestão e status", ["status", "onepage", "decisionlab"]],
     ["codigo", "Código e API", ["code", "codewalk", "api"]],
-    ["visual", "Imagem e movimento", ["image", "full", "carousel", "spotlight", "video", "scenography", "portal", "kinetic"]],
+    ["visual", "Imagem e movimento", ["image", "full", "carousel", "spotlight", "video", "portal"]],
     ["plateia", "Plateia", ["question", "poll"]],
     ["dinamicas", "Dinâmicas a dois", ["duel", "terminals", "turns"]],
     ["aula", "Aula: exercícios e algoritmos", ["solution", "calc", "algo", "graphlab", "codelab", "playground"]],
@@ -2325,38 +2329,13 @@
 
   // Ao trocar de layout, o conteúdo em lista (cartões, etapas, eventos, níveis…) vai junto
   const LIST_KEY = { cards: "items", bento: "tiles", stats: "stats", steps: "steps", funnel: "stages", pyramid: "levels", list: "items",
-    agenda: "items", timeline: "events", matrix: "cells", question: "options", poll: "options", split: "bullets", statement: "lines", references: "items", end: "contacts", kinetic: "beats" };
+    agenda: "items", timeline: "events", matrix: "cells", question: "options", poll: "options", split: "bullets", statement: "lines", references: "items", end: "contacts" };
   const SOURCE_KEYS = ["items", "tiles", "stats", "kpis", "steps", "process", "flow", "stages", "levels", "events", "cells", "options", "bullets", "lines", "contacts"];
-  function kineticPhrases(value) {
-    const words = String(value || "").match(/==[^=]+==|\*\*.*?\*\*|\*[^*]+\*|~~.*?~~|`[^`]+`|\[[^\]]+\]\([^)]+\)|\S+/g) || [];
-    const connectors = new Set(["a", "as", "de", "do", "da", "dos", "das", "e", "em", "no", "na", "nos", "nas", "para", "por", "com", "o", "os"]);
-    const phrases = [];
-    while (words.length) {
-      let take = Math.ceil(words.length / Math.ceil(words.length / 4));
-      const last = words[take - 1]?.replace(/^[^A-Za-zÀ-ÿ]+|[^A-Za-zÀ-ÿ]+$/g, "").toLowerCase();
-      if (take > 1 && connectors.has(last)) take--;
-      phrases.push(words.splice(0, take).join(" "));
-    }
-    return phrases;
-  }
   function carryContent(slide, to) {
     const target = LIST_KEY[to];
     if (!target) return;
     const activeKey = LIST_KEY[slide.layout];
     if (activeKey === target && Array.isArray(slide[target]) && slide[target].length) return;
-    if (to === "kinetic") {
-      const source = SOURCE_KEYS.find((key) => Array.isArray(slide[key]) && slide[key].length);
-      if (source) {
-        slide.beats = slide[source].map((item) => {
-          if (typeof item !== "object" || item == null) return { text: String(item ?? "") };
-          return { text: item.title ?? item.label ?? item.text ?? item.name ?? "", ...(item.text && item.title ? { tag: item.text } : {}) };
-        });
-      } else {
-        const phrases = [...kineticPhrases(slide.title || slide.text), ...kineticPhrases(slide.subtitle)];
-        if (phrases.length) slide.beats = phrases.map((text, i) => ({ text, ...(i === 0 && slide.kicker ? { tag: slide.kicker } : {}) }));
-      }
-      return;
-    }
     const srcKey = [activeKey, ...SOURCE_KEYS].find((k) => k && Array.isArray(slide[k]) && slide[k].length);
     if (!srcKey) return;
     const entries = slide[srcKey].map((x) => {
@@ -2387,7 +2366,7 @@
     }
     if (layoutName === "quote") slide.quote = primary;
     if (["question", "poll"].includes(layoutName)) slide.question = primary;
-    if (LIST_KEY[layoutName] && !slide[LIST_KEY[layoutName]]?.length && !["kinetic", "statement"].includes(layoutName)) {
+    if (LIST_KEY[layoutName] && !slide[LIST_KEY[layoutName]]?.length && layoutName !== "statement") {
       const content = [slide.subtitle, slide.body, primary].find(v => typeof v === "string" && v.trim());
       if (content) slide[LIST_KEY[layoutName]] = content.split(/\n+/).filter(Boolean).map(text => ["list", "split", "question", "poll", "references", "end"].includes(layoutName) ? text : {title:text});
     }
@@ -2448,6 +2427,23 @@
         } catch (e) { showToast(`Não deu para atualizar: ${e.message}`); }
       },
       hydrate: hydrateIcons,
+      splitCalendar: async () => {
+        const at = state.currentSlideIndex, slide = state.deck.slides[at];
+        const { calendarMonth, calendarMonths } = window.SagaCalendarMonths;
+        const MESES = ["janeiro", "fevereiro", "março", "abril", "maio", "junho", "julho", "agosto", "setembro", "outubro", "novembro", "dezembro"];
+        const months = calendarMonths(slide);
+        if (months.length < 2) return;
+        const { uid, events, undated, month, week, ...base } = slide;
+        const slides = months.map((m, k) => ({ ...base, ...(k === 0 && uid ? { uid } : {}), view: "mes", month: m,
+          kicker: base.kicker || `${MESES[+m.slice(5) - 1]} ${m.slice(0, 4)}`,
+          events: events.filter((e) => calendarMonth(e?.date) === m),
+          ...(k === 0 && (undated?.length || events.some((e) => !calendarMonth(e?.date))) ? { undated: [...(undated || []), ...events.filter((e) => !calendarMonth(e?.date)).map(({ title, text }) => ({ title, ...(text ? { text } : {}) }))] } : {}) }));
+        state.deck.slides.splice(at, 1, ...slides);
+        await syncDeckToServer();
+        renderThumbnails();
+        await renderCurrentSlide();
+        showToast(`Um slide por mês: ${slides.length} slides, na visão de mês.`, 4000);
+      },
       pickIcon: (cb) => openIconPicker(null, cb),
       layoutLabel,
       generateImage: (element, btn) => {
@@ -2605,7 +2601,9 @@
   }
 
   async function startPresentation({ pen = false } = {}) {
-    await syncDeckToServer(); // a prévia é montada a partir do deck do servidor
+    // a apresentação é montada a partir do deck do servidor. Modelo em prévia: o servidor já tem o mesmo deck (qualquer
+    // mudança teria criado a cópia e saído da prévia), e enviar de novo contaria como mudança: apresentar não grava nada
+    if (!state.preview) await syncDeckToServer();
     const start = state.currentSlideIndex + 1;
     dom.presModal.classList.remove("hidden");
     dom.presFrame.src = scopedURL(`preview?t=${Date.now()}#${start}`);
@@ -2844,7 +2842,7 @@
   // outra aba/aparelho abriu outra apresentação neste Studio: nada desta foi gravado (o servidor recusou)
   function staleTab(msg) { updateSaveStatus("error"); showToast(msg, 20000, { label: "Recarregar", fn: () => location.reload() }); }
 
-  async function syncDeckToServer() {
+  async function syncDeckToServer({ throwOnError = false } = {}) {
     trackDeck("Edição");
     updateSaveStatus("saving");
     try {
@@ -2854,7 +2852,7 @@
         body: JSON.stringify({ spec: state.deck, expectFile: state.file }),
       });
       const data = await res.json().catch(() => ({}));
-      if (data.stale) return staleTab(data.error);
+      if (data.stale) { staleTab(data.error); if (throwOnError) throw new Error(data.error); return; }
       if ("file" in data) state.file = data.file;
       if (data.materialized) previewMaterialized(data.materialized);
       // o servidor dá identidade a slide novo (uid) e leva o ajuste visual junto quando um texto muda: o Studio adota
@@ -2868,9 +2866,11 @@
       if (adopted && !state.applyingHistory) deckHistory.rebase(state.deck);
       updateSaveStatus(res.ok ? "saved" : "error");
       if (res.ok) window.SagaProject?.deckChanged();
+      else if (throwOnError) throw new Error(data.error || 'Não foi possível salvar as mudanças antes de exportar.');
     } catch (err) {
       console.warn("Erro ao sincronizar com servidor:", err);
       updateSaveStatus("error");
+      if (throwOnError) throw err;
     }
   }
 
@@ -3631,9 +3631,8 @@ ${ta.value}`;
 
   const isMobile = () => window.matchMedia("(max-width: 900px)").matches;
 
-  // Painel lateral: Formatar, Assistente ou Variáveis
-  // abas do painel lateral: Formatar (conteúdo), Propriedades (inspetor), Assistente, Variáveis
-  const PANE_TABS = ["props", "inspect", "chat", "vars"];
+  // Formatar, Propriedades e Variáveis ficam agrupados; o Assistente tem acesso fixo separado, por último.
+  const PANE_TABS = ["props", "inspect", "vars", "chat"];
   const paneEls = (w) => ({ btn: document.getElementById(`tab-btn-${w}`), panel: document.getElementById(`tab-panel-${w}`) });
   const currentPane = () => PANE_TABS.find((w) => paneEls(w).panel?.classList.contains("active")) || "props";
   // menu de botão direito genérico (itens: { label, ic, fn, danger, disabled } ou { sep: true })
@@ -3661,7 +3660,7 @@ ${ta.value}`;
     const fab = document.getElementById("chat-fab");
     if (!fab) return;
     const visible = isMobile() ? dom.inspectorSidebar.classList.contains("mobile-open") : !dom.inspectorSidebar.classList.contains("collapsed");
-    fab.classList.toggle("hidden", visible && currentPane() === "chat");
+    fab.classList.toggle("hidden", visible); // com o painel aberto, o botão Assistente já está sempre à vista
     const badge = document.getElementById("chat-badge");
     if (visible && currentPane() === "chat" && badge?.classList.contains("show")) badge.classList.remove("show"); // só se precisar: o observador do selo chama esta função
     fab.classList.toggle("has-news", !!document.getElementById("chat-badge")?.classList.contains("show"));
@@ -4310,29 +4309,24 @@ ${ta.value}`;
       return { res, name };
     }
 
-    // PowerPoint / PDF / roteiro: levam alguns segundos (o Chrome invisível desenha cada slide)
+    // PowerPoint / PDF / roteiro: acompanham a fila do servidor, sem prender a página no download.
     const EXPORTS = {
-      pptx: { label: "o PowerPoint", done: "PowerPoint editável, com animações e notas." },
-      pdf: { label: "o PDF", done: "PDF com um slide por página." },
-      roteiro: { label: "o roteiro", done: "roteiro com miniaturas, notas e tempos." },
-      estudo: { label: "o material de estudo", done: "material de estudo: cada slide inteiro e o texto de consulta." },
-      "estudo-html": { label: "o material de estudo", done: "material de estudo num HTML só." },
-      tudo: { label: "o PowerPoint, o PDF e o roteiro", done: "um .zip com o PowerPoint (com notas), o PDF e o roteiro." },
+      pptx: "o PowerPoint", pdf: "o PDF", roteiro: "o roteiro", estudo: "o material de estudo",
+      "estudo-html": "o material de estudo", tudo: "o PowerPoint, o PDF e o roteiro",
     };
     document.querySelectorAll("[data-export]").forEach((btn) => {
       btn.onclick = async (e) => {
         e.preventDefault();
         if (btn.disabled) return;
         const kind = btn.dataset.export, clean = btn.dataset.notas === "0";
-        const x = clean ? { label: "o PowerPoint sem as notas", done: "PowerPoint sem as notas do apresentador, pronto para mandar." } : EXPORTS[kind];
+        const label = clean ? "o PowerPoint sem as notas" : EXPORTS[kind];
         btn.disabled = true;
-        showToast(`Gerando ${x.label} (${state.deck.slides.length} slides)… pode levar alguns segundos.`, 60000);
         try {
-          const { res, name } = await downloadFrom(`api/export/${kind}${clean ? "?notas=0" : ""}`, `apresentacao.${{ pptx: "pptx", tudo: "zip", "estudo-html": "html" }[kind] || "pdf"}`);
-          const warns = JSON.parse(decodeURIComponent(res.headers.get("X-Sagadeck-Warnings") || "%5B%5D"));
-          showToast(warns.length ? `"${name}" baixado, com ${warns.length} aviso(s): ${warns.slice(0, 2).join("; ")}` : `"${name}" baixado: ${x.done}`, warns.length ? 9000 : 4000);
+          await window.SagadeckExports.start({ kind, notes: !clean, title: state.deck.title }, { beforeStart: async () => {
+            if (!state.preview) await syncDeckToServer({ throwOnError: true });
+          } });
         } catch (err) {
-          showToast(`Não deu para gerar ${x.label}: ${err.message}`, 8000);
+          showToast(`Não deu para gerar ${label}: ${err.message}`, 8000);
         } finally {
           btn.disabled = false;
         }

package/src/studio/public/explorer.js

@@ -15,6 +15,7 @@
   let treeData = null;
   const openTabs = []; // { path, kind, name, dirty, text, sheet }
   let active = "__deck__";
+  let slideLayout = "";
   const expanded = new Set(["contexto"]);
   const $ = (s, r = document) => r.querySelector(s);
   const esc = (s) => String(s ?? "").replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
@@ -225,7 +226,8 @@
   function bindTabs() {
     $("#doc-tabs").addEventListener("click", (ev) => {
       const c = ev.target.closest("[data-close]"); if (c) { ev.stopPropagation(); closeTab(c.dataset.close); return; }
-      const t = ev.target.closest("[data-doc]"); if (t) activate(t.dataset.doc);
+      // A aba ativa já tem a grade e a seleção da pessoa: reler por clique perderia ambas na resposta tardia.
+      const t = ev.target.closest("[data-doc]"); if (t && t.dataset.doc !== active) activate(t.dataset.doc);
     });
     $("#doc-tabs").addEventListener("auxclick", (ev) => { const t = ev.target.closest("[data-doc]"); if (ev.button === 1 && t && t.dataset.doc !== "__deck__") closeTab(t.dataset.doc); });
   }
@@ -241,16 +243,26 @@
     if (!openTabs.some((t) => t.path === p)) openTabs.push({ path: p, kind, name: p.split("/").pop() });
     await activate(p);
   }
+  // Com um mapa, a planilha e os pontos precisam estar à vista e receber cliques ao mesmo tempo.
+  function syncLayout() {
+    const t = openTabs.find((x) => x.path === active);
+    const mapSheet = t?.kind === "sheet" && slideLayout === "map";
+    const side = t?.kind === "deck" || mapSheet;
+    const editor = $("#canvas-stage-wrapper");
+    editor.classList.toggle("doc-side", active !== "__deck__" && side);
+    editor.classList.toggle("doc-full", active !== "__deck__" && !side);
+    if (t?.kind === "sheet") $("#doc-view .sh-body")?.classList.toggle("no-suggest", t.hideSuggest ?? mapSheet);
+  }
+  function slideChanged(slide) { slideLayout = slide?.layout || ""; syncLayout(); ctx?.relayout(); }
   async function activate(p) {
     active = p;
     renderTabs();
     $("#project-tree")?.querySelectorAll(".ex-file").forEach((r) => r.classList.toggle("active", r.dataset.path === p));
-    const editor = $("#canvas-stage-wrapper"), view = $("#doc-view");
-    editor.classList.remove("doc-side", "doc-full");
+    const view = $("#doc-view");
+    syncLayout();
     if (p === "__deck__") { view.innerHTML = ""; view.classList.add("hidden"); ctx.relayout(); return; }
     const t = openTabs.find((x) => x.path === p);
     view.classList.remove("hidden");
-    editor.classList.add(t.kind === "deck" ? "doc-side" : "doc-full");
     try {
       if (t.kind === "deck") await showDeckText(view, t);
       else if (t.kind === "md" || t.kind === "text" || (t.kind === "sheet" && t.asText)) await showText(view, t);
@@ -349,13 +361,14 @@
     const sepInfo = data.delimiter ? ` · separado por ${DELIM[data.delimiter] || data.delimiter}` : "";
     const asText = /\.(csv|tsv)$/i.test(t.name) ? `<button type="button" class="btn btn-small" data-as-text title="Ver o arquivo como texto"><i class="ic" data-ic="file-code"></i> Texto</button>` : "";
     view.innerHTML = `<div class="dv-head"><i class="ic" data-ic="file-spreadsheet"></i><b>${esc(t.name)}</b><span class="dv-status" id="dv-status">${sheet.total} linhas · ${cols.length} colunas${sepInfo}${editable ? "" : " · só leitura"}</span>${asText}<button type="button" class="btn btn-small" data-toggle-suggest title="Gráficos que fazem sentido com estes dados"><i class="ic" data-ic="chart-column"></i> Gráficos</button></div>${tabs}
-      <div class="sh-body${t.hideSuggest ? " no-suggest" : ""}"><div class="sh-grid-wrap" id="sh-grid"></div>
+      <div class="sh-body${(t.hideSuggest ?? (slideLayout === "map")) ? " no-suggest" : ""}"><div class="sh-grid-wrap" id="sh-grid"></div>
       <aside class="sh-suggest"><div class="sh-suggest-head"><b>Gráficos que fazem sentido</b><button type="button" class="btn btn-small" data-ai-suggest title="A IA confere o tipo das colunas e sugere gráficos, títulos e nomes dos eixos"><i class="ic" data-ic="sparkles"></i> Sugerir com IA</button></div><div class="sh-cards" id="sh-cards"><div class="ex-empty">Olhando as colunas…</div></div></aside></div>`;
     const types = [];
     for (const c of cols) types[c.index] = { type: c.type, label: TYPE_LABEL[c.type] || c.type };
     let timer = 0;
-    window.SagaViewers.sheetGrid(view.querySelector("#sh-grid"), {
+    const grid = window.SagaViewers.sheetGrid(view.querySelector("#sh-grid"), {
       rows: sheet.rows, editable, hasHeader: sheet.hasHeader, types,
+      onSelect: (r) => window.SagaMapData?.selectRow(t.path, r + 1),
       onChange: (rows) => {
         const st = $("#dv-status"); st.textContent = "gravando…"; t.dirty = true; renderTabs();
         clearTimeout(timer);
@@ -365,9 +378,11 @@
         }, 500);
       },
     });
+    // planilha com posição ou endereço: "Pôr no mapa" e "Achar coordenadas" (map-data.js)
+    window.SagaMapData?.sheetTools(view, { t, rows: sheet.rows, grid, api, ctx, reload: async (p) => { if (p && p !== t.path) return; t.text = undefined; await activate(t.path); } });
     view.querySelectorAll("[data-sheet]").forEach((b) => b.onclick = () => { t.sheet = b.dataset.sheet; activate(t.path); });
     view.querySelector("[data-as-text]")?.addEventListener("click", () => { t.asText = true; t.text = undefined; activate(t.path); });
-    view.querySelector("[data-toggle-suggest]").onclick = () => { t.hideSuggest = !t.hideSuggest; view.querySelector(".sh-body").classList.toggle("no-suggest", t.hideSuggest); };
+    view.querySelector("[data-toggle-suggest]").onclick = () => { t.hideSuggest = !view.querySelector(".sh-body").classList.contains("no-suggest"); view.querySelector(".sh-body").classList.toggle("no-suggest", t.hideSuggest); };
     view.querySelector("[data-ai-suggest]").onclick = (ev) => loadSuggestions(t, true, ev.currentTarget);
     ctx.hydrate(view);
     loadSuggestions(t, false);
@@ -439,5 +454,5 @@
   // o deck mudou por outro caminho (formulário, IA, arrastar): a aba do texto da apresentação acompanha
   function deckChanged() { openTabs.find((t) => t.kind === "deck")?.refresh?.(); }
   const wantsPaste = () => !$("#project-explorer").classList.contains("hidden") || active !== "__deck__";
-  window.SagaProject = { setup, refreshTree, openFile, deckChanged, savePastedImage, uploadFile, wantsPaste, activeTab: () => active };
+  window.SagaProject = { setup, refreshTree, openFile, deckChanged, slideChanged, savePastedImage, uploadFile, wantsPaste, activeTab: () => active };
 })();