sagadeck 1.9.0 → 1.10.0

package/README.md

@@ -16,7 +16,7 @@ Ele vem com 11 temas (incluindo prata limpo e respirável, artesanal desenhado
 ```bash
 npm install -g sagadeck
 ```
-Requer **Node.js 22.13+** e **Chrome ou Edge** instalados (o PDF, o PNG e as conferências visuais usam o navegador).
+Requer **Node.js 24+** e **Chrome ou Edge** instalados (o PDF, o PNG e as conferências visuais usam o navegador).
 É tudo Node: não precisa de Python. (O pacote do PyPI parou na 1.5.0.)
 
 ## Comece aqui
@@ -285,6 +285,12 @@ navegador, mas não para editar.
 
 ## Slides para devs: API ao vivo
 
+Na biblioteca, **Programação** e **APIs com cURL** abrem a criação com exemplos de pedidos, código colado,
+anexos técnicos e prévia do briefing. Também há duas bases curtas para começar **sem IA**.
+No editor, **Início ou Inserir → Código / cURL** transforma conteúdo colado em código, explicação guiada
+ou requisição de API. Selecione linhas para criar as etapas; Bash/cURL, JSON e SQL têm realce offline.
+Os temas **Terminal Pro** e **Aurora Dev**, em Design, trazem código legível e capas com rede animada.
+
 O layout `api` é um slide tipo Postman: mostra o pedido (URL, corpo, cabeçalhos) e o código equivalente
 (curl, Python e Python comentado), e o botão **Executar** roda o pedido de verdade na frente da plateia:
 síncrono, polling com linha do tempo, streaming, upload, token (JWT decodificado), embeddings, TTS/STT e

package/SKILL.md

@@ -11,7 +11,7 @@ O sagadeck gera apresentações profissionais a partir de um arquivo YAML, ofere
 
 Quando a pessoa pede para instalar o sagadeck e deixar pronto:
 
-1. `npm install -g sagadeck` (Node 22.13+; não precisa de Python).
+1. `npm install -g sagadeck` (Node 24+; não precisa de Python).
 2. `sagadeck studio`: o navegador abre sozinho em **http://127.0.0.1:3517** (é também a primeira linha que o
    comando escreve; `--sem-navegador` não abre). **O Studio é a interface do sagadeck**: biblioteca, editor e chat com
    IA. O terminal fica aberto enquanto ela usa.

package/docs/ANDAMENTO.md

@@ -8,6 +8,121 @@ começar. Trabalho em curso vai para o GitHub (commit + push) a cada etapa, nunc
 
 ---
 
+## UX para programação e APIs com cURL — 12/10/2026 (branch `codex/ux-dev-slides`, versão 1.10.0)
+
+Pedido: reduzir dificuldade de uso, facilitar geração técnica, acrescentar recursos e dois temas bonitos com
+animação; testar, PR, merge, publicar no npm e atualizar sagadeck-dev. Trabalho somente na pasta oficial,
+sem worktrees, conforme AGENTS.md. Main começou limpa em `46e0afd`, com a CI dos quatro ambientes verde.
+
+Diagnóstico: recursos técnicos existiam, mas começar dependia de descobrir layouts, escrever briefing do zero e
+preencher campos estruturados. cURL era exibido sem realce de sintaxe; demos extensas não eram uma base curta.
+Mudanças:
+- Biblioteca com entradas Programação/APIs com cURL; Nova com IA oferece exemplos de pedidos, material técnico
+  colado, público/objetivo/roteiro opcionais, resumo, prévia do pedido e Ctrl+Enter. Intenção explícita orienta o
+  modelo pelo prompt, sem regras de decisão por regex; texto e estilo manual continuam prioritários.
+- Bases sem IA (`src/studio/developer-starters.js`), cinco slides com exemplo consistente, guia, saída e terminal
+  de cenas. Criação pela biblioteca; a de APIs usa ENSAIO e funciona localmente sem credenciais externas.
+- Início/Inserir › Código / cURL: conteúdo colado vira código, código guiado ou requisição de API. Parser de
+  argumentos sem shell e sem executar; opções não suportadas geram mensagem antes de inserir. Credenciais
+  reconhecidas viram referências a Segredos antes de gravar. Código de exibição é preservado literalmente.
+- Etapas guiadas por seleção de linhas, no modal e em Formatar; linguagem inferida/selecionável; realce offline
+  novo de Bash/cURL, JSON e SQL. Anexos de código/configuração preservam espaços, indentação e linhas em branco.
+- `terminal-pro` (grafite/menta, IDE) e `aurora-dev` (azul noite/lilás/ciano, painéis e luz suave): fontes embutidas,
+  contraste de texto/sintaxe, rede de capa que para fora dela e em movimento reduzido/exportação. Design usa o
+  mesmo caminho existente de tema salvo; nenhum deck pessoal modificado.
+
+Regressões cobrem parser, segredos, código literal, etapas e arquivos gravados, prompts ao LLM, anexos técnicos,
+criação sem IA, escolha dos temas por teclado, contraste, animação, movimento reduzido e exportação. Testes
+direcionados de motor/fontes/guards: 85 aprovados; temas e geração passaram também no navegador.
+Geração com IA real também aprovada: briefing técnico aplica Aurora Dev e mantém o cURL original copiável (62 s).
+Revisão independente achou e reproduziu perdas de inteiros grandes ao proteger JSON e de variáveis na codificação
+do formulário: proteção agora edita só spans sensíveis do texto. Interpolação contextual opt-in
+(`request.bodyEncoding`/`urlEncoding`) mantém JSON/form/query corretos no envio; ensaio HTTP real confere `&`, aspas,
+barras, Unicode, números grandes e máscara de respostas/gravações. URL com Segredo agora é enviada já resolvida.
+Callbacks de upload/geração são invalidados ao trocar/cancelar modal; Tab fica no diálogo e Escape devolve foco.
+Essas regressões falharam antes das correções e passaram depois. Suíte completa iniciada com as frentes estáveis.
+Entrega final aguardando suíte completa e CI; publicação de `sagadeck@1.10.0` por release com trusted publishing.
+Oracle: atualizar apenas `/opt/sagadeck-dev`/`sagadeck-dev.service` (3518), preservando produção. Reiniciar também
+a instância local verificada na 3517 e conferir versão/recursos depois da atualização.
+Retomada em 13/10 após limite da sessão. Suíte inicial: 1.084 testes, 1.054 aprovados, 27 condicionais pulados e
+3 falhas (uma de Python ausente no PATH, uma de rótulo e a contagem do teste pai). Python passou isolado com o
+runtime disponível no PATH; a guarda de palavras grudadas agora reconhece o nome técnico cURL sem enfraquecer
+os demais rótulos. A revisão final também cobre execução pelo navegador preservando corpo JSON literal e comandos
+equivalentes copiáveis com segredos em JSON/form/query. Suíte final concluída: `npm test`, 1.093 testes,
+1.066 aprovados, 27 condicionais pulados, zero falhas (24 min). Geradores de cURL/JavaScript/Python também
+enviaram pedidos reais ao ensaio HTTP. Preview e Formatar mantêm JSON literal; respostas/gravações não permitem
+recuperar segredos mesmo em logs com JSON aninhado. Instância local reiniciada na 3517, versão 1.10.0, com os novos
+módulos/CSS respondendo 200. PR #197 publicado; os quatro checks originais Ubuntu/Windows, Node 22/24, passaram.
+Por orientação posterior do usuário, o suporte passa a Node 24+: engines, instruções de instalação e matriz da
+CI atualizados, sem mudança no código já aprovado. YAML e metadados conferidos; a nova CI exige Ubuntu e Windows
+com Node 24 antes de merge/release. DEV da Oracle recebeu `135cfd2`, com versão 1.10.0 e ambos os temas disponíveis;
+produção preservada. A publicação npm ainda aguarda merge e CI do commit final.
+PR #197 integrado em `03f9ff4`; local na 3517 e DEV na 3518 reiniciados com esse commit e versão 1.10.0.
+Os dois checks do PR passaram, mas a nova rodada da main encontrou uma corrida no teste de Formatar: o helper
+confirmava a gravação no servidor antes de o formulário do novo slide terminar de renderizar, lendo o corpo
+do slide anterior. Publicação npm suspensa até corrigir e validar essa sincronização. Correção na branch
+`codex/ux-dev-format-sync`; nenhuma mudança no conteúdo das apresentações nem no código da aplicação.
+Atrasar `api/render-slide` em 400 ms reproduziu exatamente a falha da Ubuntu. O helper agora aguarda a
+identidade do formulário pelo campo Título, além da gravação; a mesma regressão passou após o ajuste.
+Seis testes dirigidos aprovados, zero erros JavaScript e corpos JSON/form conferidos também no arquivo salvo.
+Suíte completa após o ajuste: `npm test`, 1.093 testes, 1.066 aprovados, 27 condicionais pulados e zero falhas
+(30 min). A falha da main ficou restrita a essa sincronização; Windows passou. Correção pronta para commit/PR
+e checks Ubuntu/Windows Node 24 antes de integrar e publicar a versão 1.10.0.
+
+## Assistente em prévia de modelo na Oracle — 12/10/2026
+
+O erro `APP_UNKNOWN · a4670ccb` da produção era `path.dirname(null)` no preparo dos anexos: modelos abertos
+pela vitrine ainda não têm arquivo. O pedido parava antes de chegar ao modelo. Agora o chat só prepara documentos
+em uma pasta existente; documento binário, imagem gerada e edição materializam a cópia com os helpers da biblioteca.
+Conversa simples continua sem criar arquivo. A aba do servidor e o endereço do editor passam a usar essa mesma
+cópia, evitando edição perdida ou segunda cópia no pedido seguinte. Modelo de fábrica e outras pessoas preservados.
+Regressão em `test/studio-ai-preview.test.js`: falhou antes com o erro exato; cobre conversa, edição salva,
+recarregamento no navegador, isolamento por usuário e documento inventariado na pasta pessoal.
+Imagem gerada também é conferida no arquivo e na pasta pessoal. Texto e visão reais passaram nos dois serviços.
+A CI da main apresentou timeout no teclado ao mudar o título logo após abrir o editor no Windows 24; o teste da
+biblioteca agora espera a página terminar de carregar antes de editar, mantendo a conferência do arquivo salvo.
+Validação: npm test com 1.034 testes, 1.008 aprovados, 26 condicionais pulados, zero falhas; quatro regressões novas
+passaram na suíte. O teste da biblioteca com a espera de carregamento passou também isolado (13 testes).
+Entrega: commit da correção para os dois serviços da Oracle após validação local; merge do PR somente com os quatro
+checks verdes (Ubuntu/Windows, Node 22/24). Não há mudança de dependências nem publicação de versão no npm.
+PR #196 publicado. Oracle dev (3518) e produção (3517) receberam o commit `e32a3c1` e reiniciaram; nos dois,
+o pedido real em uma prévia voltou com `mode: llm`, conversa, sem diagnóstico de erro e sem criar cópia.
+Bibliotecas pessoais não foram alteradas. A CI do PR continua sendo acompanhada para concluir o merge.
+Revisão adicional reproduziu perda ao recarregar quando o patch só mudava campos do deck (tema, contexto…) ou
+excluía slides: a lista de slides alterados era vazia e a cópia não nascia. A materialização agora vale para toda
+ação do modelo, preservando conversa e alternativas em prévia. Regressão confere tema salvo, exclusão e demais
+slides preservados; falhou antes da correção.
+Suíte completa após esse ajuste: 1.035 testes, 1.009 aprovados, 26 condicionais pulados e zero falhas.
+Os cinco testes de prévia passaram; nova CI será exigida para o commit final antes do merge do PR #196.
+Oracle dev e produção receberam também `333857f`: conversa real e mudança de tema pelo modelo funcionaram;
+o tema permaneceu ao reabrir o arquivo pelas APIs nativas. Apresentações sintéticas removidas pela biblioteca.
+A CI aprovou Ubuntu 22/24 e Windows 22. Windows 24 teve timeout na galeria; o teste isolado passou (3/3) e a
+reexecução aprovou o carrossel, mas encontrou `ERR_NO_BUFFER_SPACE` durante exportação. Isso indica pressão de
+recursos de rede no runner; a faixa TCP dinâmica agora é ampliada somente nas máquinas descartáveis da CI,
+com diagnóstico de estados TCP em falhas. Testes e exigência de zero erros de navegador preservados.
+Código da aplicação permanece o mesmo da suíte local completa aprovada (1.009/26/0); ajuste de CI validado como
+YAML, e os quatro ambientes serão novamente conferidos antes do merge.
+
+## Sobre legível no tema escuro — 12/10/2026 (branch `sobre-tema-escuro`)
+
+Narumi (com print): no Windows e no dev da Oracle o Sobre "não abre direito", com texto apagado. Causa: o CSS do
+`about.js` pegava o fundo de `--panel`/`--bg`, que nenhuma página define (caía no branco), e o texto de `--text`,
+que no tema escuro é claro, o que dava contraste 1,16. Agora fundo, borda e botão vêm de `--chrome`, `--ui-line` e
+`--brand-fill`, que o editor (style.css/studio-next.css) e a biblioteca (library.css) definem nos dois temas. Teste
+novo em `test/sobre.test.js`: contraste WCAG mínimo de 4,5 do texto contra o fundo da janela, nos temas claro e
+escuro, no editor e na biblioteca. Ele falha com o CSS antigo.
+
+## Ajuda › Sobre o SagaDeck — 12/10/2026 (branch `ajuda-sobre`)
+
+Narumi: "insira um help com about no menu onde eu posso ver a versão". A aba **Ajuda** fecha a faixa do editor
+(depois de Avançado, como no PowerPoint) com Sobre o SagaDeck, O que mudou (CHANGELOG) e Demos. O Sobre
+(`src/studio/public/about.js`, `window.SagaAbout`; qualquer elemento com `data-about` abre) mostra a versão em
+destaque, commit, Node e sistema (novos em `/api/instance`), desde quando está no ar, a biblioteca (no multiusuário,
+só que é do servidor) e se a IA está configurada, com Copiar informações para suporte. Na biblioteca, um botão com o
+ícone de informação no alto. Achados de passagem: o `dialog` nativo abria colado no canto (uma regra global zerava
+a margem; o Sobre põe `margin:auto`) e botão da faixa que é link (`a.rbtn`) saía sublinhado. Teste:
+`test/sobre.test.js`; a ordem da faixa em `studio.test.js`.
+
 ## `sagadeck ia-check`: o que de IA funciona, sem tela — 12/10/2026 (branch `ia-check`)
 
 Narumi: "o sagadeck está preparado para ser testado por um agente de IA (tipo o Copilot) sem o front-end?

package/docs/REFERENCIA.md

@@ -15,7 +15,7 @@ Mídia paga não é proibida por padrão. Quando for apropriada, proponha seu us
 ```yaml
 title: Nome da palestra          # obrigatório (vira rodapé e título da janela)
 author: Seu Nome · Cargo
-theme: sinal                     # sinal | editorial | noite | bauhaus | terminal | jornal | rabisco | oceano | pop | aurora | prata | aluminio | arcade | relevo | musgo | wine | caderno | lousa | cartaz | infografico (ou customizado, ver fim)
+theme: sinal                     # sinal | editorial | noite | bauhaus | terminal | terminal-pro | jornal | rabisco | oceano | pop | aurora | aurora-dev | prata | aluminio | arcade | relevo | musgo | wine | caderno | lousa | cartaz | infografico (ou customizado, ver fim)
 palette: floresta                # opcional: só as cores, vale em qualquer tema (ver "Temas e paletas"); sem ela, as cores do tema
 duration: 50                     # minutos — o modo apresentador mostra se você está adiantado/atrasado
 event: Summit de Dados 2026       # opcional — para {evento} no rodapé/cabeçalho
@@ -132,7 +132,7 @@ Tabela em markdown no meio de um texto (`problem`, `body`, `text`, passo do `sol
 
 ### Cenas interativas para ensinar
 
-`codewalk` mantém o código estável e revela a explicação, o destaque de linhas e uma saída esperada por etapa. O código e os comandos cURL são texto; não há execução. No Studio, a linguagem é inferida pela extensão do arquivo e pode ser escolhida no menu: Python (`.py`), Java (`.java`), JavaScript (`.js`, `.jsx`, `.mjs`, `.cjs`), TypeScript (`.ts`, `.tsx`, `.mts`, `.cts`) ou C# (`.cs`). Node.js é um runtime de JavaScript, não uma linguagem separada; arquivos Node usam a opção JavaScript. A apresentação aplica realce sintático a essas cinco linguagens sem depender de serviços externos. Use as setas da apresentação ou os botões numerados. Depois da última etapa, a seta avança ao slide seguinte. As etapas também aparecem corretamente na prévia do apresentador e são restauradas pelo endereço da apresentação.
+`codewalk` mantém o código estável e revela a explicação, o destaque de linhas e uma saída esperada por etapa. O código e os comandos cURL são texto; não há execução. No Studio, a linguagem é inferida pela extensão do arquivo e pode ser escolhida no menu: Python, Java, JavaScript, TypeScript, C#, Bash/cURL, JSON ou SQL. Node.js é um runtime de JavaScript, não uma linguagem separada; arquivos Node usam a opção JavaScript. A apresentação aplica realce sintático a essas oito linguagens sem depender de serviços externos. Use as setas da apresentação ou os botões numerados. Depois da última etapa, a seta avança ao slide seguinte. As etapas também aparecem corretamente na prévia do apresentador e são restauradas pelo endereço da apresentação.
 
 ```yaml
 - layout: codewalk
@@ -172,6 +172,46 @@ O cabeçalho do deck aceita `fit: { minCodePt, minTextPt, wrapCode }`: até onde
 
 O cabeçalho do deck aceita `motion: none | subtle | expressive` (padrão `subtle`; no Studio, menu **Apresentar ▾ › Animações**: Sem animação, Suaves, Expressivas). A preferência do sistema por movimento reduzido tem prioridade. A intensidade muda a animação; os controles e revelações continuam funcionando.
 
+## Criar apresentações de programação e APIs no Studio
+
+Na biblioteca, **Programação** e **APIs com cURL** abrem a criação com IA já orientada ao assunto. A pessoa pode
+escrever livremente, usar um exemplo de pedido, colar código/comando/resposta ou anexar arquivos técnicos. Público,
+objetivo e roteiro são opcionais. A prévia mostra o pedido completo antes de gerar; Ctrl+Enter inicia a geração.
+O tema sugerido é `terminal-pro` para programação e `aurora-dev` para APIs; uma escolha manual de estilo prevalece.
+Essas escolhas orientam o modelo pelo prompt, sem impor uma sequência fixa de layouts.
+
+**Começar com um exemplo, sem IA** cria uma base editável de cinco slides na biblioteca, com exemplo consistente,
+código guiado, saída e capa com terminal animado. Programação inclui um diagrama do fluxo. APIs inclui uma chamada
+POST ao ambiente `ensaio`, que funciona no Studio local sem configurar credenciais. No servidor multiusuário,
+chamadas de API seguem o modo de gravação existente. Cada uso cria uma apresentação independente.
+
+**Inserir › Código / cURL** aceita conteúdo colado e oferece código para mostrar, código guiado por etapas ou
+requisição de API a partir de cURL. O importador lê os argumentos sem abrir um shell e sem executar a chamada.
+Nos guias, selecionar linhas e adicionar uma etapa cria o destaque, com explicação e saída ilustrativa editáveis;
+o painel Formatar também oferece essa ação. Código de exibição e guia não são executados.
+
+A importação de cURL aceita método/URL, cabeçalhos, corpo literal/JSON, consulta com `-G` e `--data-urlencode`,
+aspas e continuação de linha. Credenciais reconhecidas em cabeçalhos, consulta ou corpo são substituídas por
+`{{secret.nome}}`; a prévia informa os nomes para cadastrar em Ambientes. Os demais bytes do JSON, inclusive números
+grandes e formatação, são preservados. Variáveis existentes `{{nome}}` continuam referenciadas. Opções sem equivalente
+no executor, como `-L`, `-k`, multipart `-F`, corpo vindo de arquivo `@` e substituição de shell, geram um erro claro;
+para apenas exibir o comando completo, escolha Código no slide.
+
+O importador acrescenta `request.bodyEncoding: json | urlencoded` e `request.urlEncoding: query` quando apropriado.
+Esses campos preservam o escape dos valores interpolados no corpo e nos parâmetros da URL, primeiro com variáveis
+e depois com Segredos, inclusive aspas, Unicode e `&`. O restante do corpo literal permanece intacto. Não é preciso
+configurá-los no formulário. Pedidos existentes sem esses campos mantêm a interpolação anterior.
+Os exemplos copiáveis de cURL, JavaScript e Python respeitam esses mesmos escapes. O cURL simples continua curto;
+quando um Segredo precisa ser escapado em JSON/form/query, o exemplo Bash inclui um pequeno helper Node.js e indica
+essa dependência no próprio comando. Literais como `$HOME` continuam literais quando vieram assim no cURL original.
+
+Além de Python, Java, JavaScript, TypeScript e C#, o realce offline aceita **Bash** (`.sh`, `.bash`; aliases `shell`,
+`sh`, `curl`), **JSON** (`.json`, `.jsonc`) e **SQL** (`.sql`). Bash destaca comandos, opções e variáveis; JSON,
+chaves e valores; SQL, palavras-chave sem exigir maiúsculas. O conteúdo continua copiável, com indentação e linhas
+preservadas. Anexos de código (`js`, `ts`, `py`, `sh`, `http`, `sql`, `go`, `rs`, `java`, `cs` e outros) entram como
+material de contexto sem remover espaços ou linhas em branco. Saídas simuladas devem ser identificadas como exemplos;
+nunca afirme execução sem evidência nem invente endpoints ou resultados reais.
+
 ## Screenshots com destaques no Studio
 
 Em **Início → Screenshot**, cole (Ctrl+V), arraste ou escolha uma imagem PNG, JPEG ou WebP de até 8 MB.
@@ -547,6 +587,12 @@ Linhas que começam com PALAVRAS EM MAIÚSCULAS seguidas de `:` viram etiquetas
 
 ## Temas e paletas
 
+Temas de desenvolvimento: `terminal-pro` usa grafite, menta e azul, títulos alinhados à esquerda, rótulos
+monoespaçados e janelas de código; `aurora-dev` usa azul noite, lilás e ciano, luz suave e painéis arredondados.
+Ambos usam Space Grotesk e IBM Plex Mono embutidas, código sem ligaduras e cores de sintaxe com contraste de leitura.
+A rede ambiente da capa anima enquanto ela está ativa; `ambient: false` remove o efeito. Movimento reduzido,
+`motion: none` e exportação deixam a rede estática, com código e explicações legíveis.
+
 Como no PowerPoint, são duas escolhas independentes:
 
 - **Tema** (`theme`): fontes, raio das bordas, textura e uma **pele** própria que rearruma capa, seção e encerramento, muda o jeito dos slides de conteúdo (título, cartões, marcadores da lista, citação, número grande, frase) e põe ornamentos (`sinal`: faixa zebrada e selo no chapéu; `editorial`: fios e capa centralizada; `noite`: moldura fina; `bauhaus`: círculo, quadrado e triângulo; `terminal`: janela com barra e prompt; `jornal`: fios de jornal e manchete sublinhada; `rabisco`: fitas adesivas e títulos inclinados; `oceano`: ondas e chapéu em pílula; `pop`: adesivos e sombra chapada; `aurora`: brilhos e traço em gradiente; `prata`: limpo e centralizado; `relevo`: ficção científica sóbria (sala de controle de filme, sem néon): grafite profundo, curvas de nível ao fundo, cantoneiras de mira, título leve embaixo à esquerda, rótulos técnicos em monoespaçada; combina com ilustração 3D realista (terreno, cidade, água) e gráfico 3D (`science` com superfície); `arcade`: videogame e fliperama, tela de tubo com linhas de varredura, neon, título em pixel no meio e chão de tijolos de jogo de plataforma; `aluminio`: prata metálico de lançamento de aparelho premium, título cromado embaixo à esquerda e um disco de metal polido; `wine`: o `musgo` em vinho (mesmo arranjo, fontes, faixa e rede na capa): fundo vinho quase preto, vermelho-rosado e rosé, com o vermelho forte só no detalhe; `caderno`: visual thinking em papel claro — título em letra de mão alta (Amatic SC) com traço de lápis, chapéu coral em serifada (Gelasio), frase em lilás, rabiscos de ícones em pastel nos cantos (lupa, ampulheta, engrenagem, lápis, chave, lâmpada); `lousa`: quadro-negro verde com giz — título em giz amarelo (Cabin Sketch) com traço laranja, linha de giz sob o título, poeira e marcas de giz apagado, lâmpada e lápis de giz na capa; `cartaz`: cartaz de protesto em papel cinza com grão — condensada pesada (Bebas Neue) em faixa vermelha torta, chapéu como etiqueta amarela, moldura preta grossa na capa, número da seção num disco amarelo; `infografico`: dados chapados — capa azul com chão verde e nuvem, títulos em maiúsculas, chapéu numa tarja verde, números enormes em condensada; `musgo`: laboratório noturno de bom gosto (verde-musgo quase preto, âmbar e sálvia, serifada Fraunces com o destaque do título em âmbar itálico, rótulos em IBM Plex Mono com fio âmbar, texto em Space Grotesk): grade de pontos que some nas bordas e luz âmbar na capa, seção como separador com o número entre fios na linha do chapéu e o título grande embaixo, e a faixa que corre no pé da capa com os títulos das seções (`ticker`); combina com o terminal de cenas (`motion: {type: console}`) na figura da capa ou num `canvas`; `manual` e `manual-noite`: documentação técnica, sem ornamento, código e texto corrido legíveis — o par claro/escuro do mesmo arranjo, para material de consulta, tutorial e apostila: `manual` imprime bem, `manual-noite` descansa a vista). Nos slides de conteúdo: `sinal` barra de aviso e placas; `editorial` fios finos e citação centralizada; `noite` tudo centralizado e cartões vazados; `bauhaus` faixas de cor primária e círculos; `terminal` título como comando e cartões-janela; `jornal` fios duplos e colunas; `oceano` cartões flutuando e balões; `pop` contorno grosso e sombra dura; `prata` centralizado e sem caixa; `aluminio` cartões de alumínio com chanfro de luz; `relevo` painéis de vidro fosco com traço gelo; `arcade` cartões de 8 bits com borda de pixel e sombra dura; `rabisco` tracejados e números circulados; `aurora` vidro com brilho; `caderno` cartões brancos com moldura grossa pastel (menta, lilás, amarelo, coral) e marcador amarelo contornado; `lousa` cartões contornados a giz com borda torta e marcadores em pingo de giz; `cartaz` cartões brancos girados como fotos coladas, números de lista em etiqueta e destaque em vermelho; `infografico` cartões com a faixa da cor do grupo, números em cartões coloridos e números de lista em círculos coloridos; `musgo`/`wine` cartões vazados que sobem no mouse, números em monoespaçada âmbar, marcador em losango, código em janela com três bolinhas e botões âmbar. Trocar o tema já muda o arranjo: não reescreva slides só para "combinar" com o tema.

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "sagadeck",
-  "version": "1.9.0",
+  "version": "1.10.0",
   "description": "Gerador de apresentações: YAML -> HTML animado + PowerPoint editável, com temas e figuras geradas na hora.",
   "type": "module",
   "bin": {
     "sagadeck": "bin/sagadeck.js"
   },
   "engines": {
-    "node": ">=22.13.0"
+    "node": ">=24.0.0"
   },
   "license": "MIT",
   "homepage": "https://github.com/naruminho/sagadeck#readme",
@@ -29,7 +29,7 @@
   ],
   "dependencies": {
     "jszip": "^3.10.2",
-    "katex": "^0.18.9",
+    "katex": "^0.19.0",
     "lucide-static": "^1.47.0",
     "pdfjs-dist": "^6.3.289",
     "playwright-core": "^1.63.0",
@@ -65,7 +65,7 @@
     "jsqr": "^1.4.0",
     "leaflet": "1.9.4",
     "maplibre-gl": "6.13.0",
-    "mermaid": "^11.17.2"
+    "mermaid": "^12.1.0"
   },
   "scripts": {
     "dev": "node bin/sagadeck.js studio",

package/src/ai/context.js

@@ -23,7 +23,12 @@ export async function extractDocText(name, buf) {
   if (buf.length > UPLOAD_MAX_BYTES) throw new Error(`Arquivo grande demais (${(buf.length / 1048576).toFixed(1)} MB, limite 15 MB).`);
   const ext = (String(name).match(/\.([a-z0-9]+)$/i)?.[1] || "").toLowerCase();
   if(ext==='doc')return {...await extractDocText('converted.docx',await convertLegacyWord(buf)),detail:'doc (convertido para docx)'};
-  if (["txt", "md", "markdown", "csv", "json", "yaml", "yml"].includes(ext)) {
+  // Código é material da pessoa: espaços e linhas podem fazer parte de strings ou da sintaxe.
+  if (["js", "mjs", "cjs", "ts", "tsx", "jsx", "py", "sh", "bash", "ps1", "http", "sql", "go", "rs", "java", "c", "cpp", "h", "cs", "rb", "php", "html", "css"].includes(ext)) {
+    return { text: buf.toString("utf8"), detail: `código (.${ext})` };
+  }
+  if (["json", "jsonc", "yaml", "yml"].includes(ext)) return { text: buf.toString("utf8"), detail: "texto" };
+  if (["txt", "md", "markdown", "csv"].includes(ext)) {
     return { text: clean(buf.toString("utf8")), detail: "texto" };
   }
   if (ext === "docx") {
@@ -74,7 +79,7 @@ export async function extractDocText(name, buf) {
     return { text: clean(parts.join("\n\n")), detail: `xlsx (${sheets.length} planilha(s))` };
   }
   if (ext === "pdf") return pdfText(buf);
-  throw new Error(`Tipo não suportado${ext ? ` (.${ext})` : ""}: vale txt, md, csv, docx, xlsx, pptx e pdf.`);
+  throw new Error(`Tipo não suportado${ext ? ` (.${ext})` : ""}: anexe texto, código (js, ts, py, sh, http, sql e outros), docx, xlsx, pptx ou pdf.`);
 }
 
 async function pdfText(buf) {

package/src/ai/deck-ai.js

@@ -1063,7 +1063,7 @@ Antes de responder, verifique (e siga as Regras de edição):
   const touched = { ...edited, slides: changed.map((i) => edited.slides[i]).filter(Boolean) }; // mesmos objetos: gera no lugar
   const nImgs = images && !deferImages ? countImagePrompts(touched) : 0; // deferImages: quem chamou gera depois (Criar com IA)
   const imgs = nImgs
-    ? await materializeImages(touched, { ...imageOptions, keepFailed: true,
+    ? await materializeImages(touched, { ...(typeof imageOptions === "function" ? imageOptions() : imageOptions), keepFailed: true,
       onProgress: (m) => onProgress?.({ phase: "images", text: `${m[0].toUpperCase()}${m.slice(1)} (${nImgs} no total)…` }) })
     : { done: [], failed: [] };
   imgs.done.forEach((d) => actions.push(`Imagem gerada: ${path.basename(d.file)}`));
@@ -1148,6 +1148,8 @@ export function slidesForMinutes(min) {
 // Estilo do modal (uma coleção) → { theme, direction } para a geração. Desconhecido: null.
 // estilos que não são coleção: material técnico, o par claro/escuro do tema manual
 const TECH_STYLES = {
+  "terminal-pro": { theme: "terminal-pro", direction: "Desenvolvimento em Terminal Pro: fundo grafite, menta, código legível em janelas de IDE e transições discretas. Use os recursos nativos de código guiado, terminal de cenas e API quando ajudarem a explicar o conteúdo; preserve os exemplos da pessoa. Use o tema terminal-pro, sem trocar sua paleta escura por uma clara." },
+  "aurora-dev": { theme: "aurora-dev", direction: "Desenvolvimento em Aurora Dev: azul noite com lilás e ciano, luz ambiente, diagramas e código em painéis legíveis, movimento suave sem competir com a leitura. Use recursos nativos de programação e APIs conforme o pedido; preserve os exemplos da pessoa. Use o tema aurora-dev, sem trocar sua paleta escura por uma clara." },
   manual: { theme: "manual", direction: "Documentação técnica clara: texto corrido legível, código completo, diagramas e avisos; boa para imprimir. Use o tema manual." },
   "manual-noite": { theme: "manual-noite", direction: "Documentação técnica escura: texto corrido legível, código em destaque, diagramas e avisos; descansa a vista. Use o tema manual-noite." },
 };

package/src/api-client.js

@@ -362,12 +362,43 @@ export class ApiEnvironments {
     return out.filter((s) => typeof s === "string" && s.length >= 6);
   }
 
-  maskText(env, text) {
+  maskText(env, text, contextual = false) {
     let s = String(text);
-    for (const secret of this.secrets(env)) s = s.split(secret).join(C.mask(secret));
+    if (!contextual) { for (const secret of this.secrets(env)) s = s.split(secret).join(C.mask(secret)); return s; }
+    // Pedidos importados codificam segredos em JSON/query/form. A resposta e o relatório podem
+    // devolver essas representações; nenhuma delas deve revelar o valor, mesmo quando curto.
+    const replacements = new Map();
+    for (const secret of [...this.secrets(env), ...Object.values(this.secretVars(env))].filter(Boolean)) {
+      const masked = C.mask(secret);
+      for (const [raw, safe] of [[secret, masked], [encodeURIComponent(secret), encodeURIComponent(masked)], [JSON.stringify(secret).slice(1, -1), JSON.stringify(masked).slice(1, -1)]]) if (!replacements.has(raw)) replacements.set(raw, safe);
+    }
+    for (const [raw, safe] of [...replacements].sort((a, b) => b[0].length - a[0].length)) s = s.split(raw).join(safe);
     return s;
   }
 
+  maskValue(env, value, depth = 0) {
+    if (typeof value === "string") {
+      const masked = this.maskText(env, value, true);
+      if (depth > 64 || !/^\s*[\[{\"]/.test(value) || Object.values(this.secretVars(env)).includes(value)) return masked;
+      try { JSON.parse(value); } catch { return masked; }
+      // APIs podem devolver JSON dentro de strings de logs. Decodifica cada string e mascara
+      // recursivamente; troca apenas esses spans para preservar números grandes e formatação.
+      let result = "", last = 0;
+      for (let at = 0; at < value.length; at++) {
+        if (value[at] !== '"') continue;
+        const from = at++;
+        while (at < value.length) { if (value[at] === "\\") at += 2; else if (value[at++] === '"') break; }
+        const decoded = JSON.parse(value.slice(from, at)), safe = this.maskValue(env, decoded, depth + 1);
+        if (safe !== decoded) { result += value.slice(last, from) + JSON.stringify(safe); last = at; }
+        at--;
+      }
+      return result + value.slice(last);
+    }
+    if (Array.isArray(value)) return value.map(item => this.maskValue(env, item, depth + 1));
+    if (value && typeof value === "object") return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, this.maskValue(env, item, depth + 1)]));
+    return value;
+  }
+
   async token(env, { renew = false } = {}) {
     const t = env.token;
     if (!t || !t.url) return null;
@@ -420,13 +451,13 @@ export class ApiEnvironments {
       });
       throw new ApiError(`Ambiente "${env.name}" não tem ${names.join(", ")} configurado em secrets:`, "config");
     }
-    req = { ...req, url: C.render(req.url, sv), headers: C.render(req.headers || {}, sv), body: C.render(req.body, sv) };
+    req = { ...req, url: C.renderURL(req.url, sv, req.urlEncoding), headers: C.render(req.headers || {}, sv), body: C.renderBody(req.body, sv, req.bodyEncoding) };
     const headers = { Accept: "application/json, text/event-stream, */*", ...C.render(env.headers || {}, sv), ...(req.headers || {}) };
     let body = req.body;
     const file = req.file || null; // { name, type, data: Buffer } — o arquivo do slide (upload ou base64)
     const needsFile = (req.form && Object.values(req.form).includes("@file")) || /\{\{\s*file\./.test(JSON.stringify(body ?? ""));
     if (needsFile && !file) throw new ApiError("Este slide precisa de um arquivo: arraste um para o slide ou defina file: no YAML.", "config");
-    if (file && body != null) body = C.render(body, { "file.base64": file.data.toString("base64"), "file.name": file.name, "file.type": file.type || "application/octet-stream" });
+    if (file && body != null) body = C.renderBody(body, { "file.base64": file.data.toString("base64"), "file.name": file.name, "file.type": file.type || "application/octet-stream" }, req.bodyEncoding);
     if (req.form) {
       // multipart/form-data, montado à mão (sem dependências)
       const boundary = "----sagadeck" + Math.random().toString(16).slice(2);
@@ -453,8 +484,9 @@ export class ApiEnvironments {
       const tok = await this.token(env, { renew });
       return tok ? { ...headers, [authHeader]: (t.prefix ?? "Bearer ") + tok } : headers;
     };
-    const sent = (h) => ({ method, url: this.maskText(env, req.url), headers: JSON.parse(this.maskText(env, JSON.stringify(h))), ...(file ? { file: { name: file.name, type: file.type, size: file.data.length } } : {}) });
-    return { env, method, body, withToken, sent, timeout: (Number(env.timeout) || 60) * 1000 };
+    const contextual = !!(req.bodyEncoding || req.urlEncoding);
+    const sent = (h) => ({ method, url: this.maskText(env, req.url, contextual), headers: contextual ? this.maskValue(env, h) : JSON.parse(this.maskText(env, JSON.stringify(h))), ...(file ? { file: { name: file.name, type: file.type, size: file.data.length } } : {}) });
+    return { env, method, url: req.url, body, withToken, sent, contextual, timeout: (Number(env.timeout) || 60) * 1000 };
   }
 
   // Pedido completo: a resposta volta inteira (JSON ou texto), com os segredos mascarados.
@@ -463,7 +495,7 @@ export class ApiEnvironments {
     const run = async (renew) => {
       const headers = await p.withToken(renew);
       const t0 = Date.now();
-      const res = await open({ method: p.method, url: req.url, headers, body: p.body, ca: this.ca(p.env), insecure: !!p.env.insecure, timeout: p.timeout });
+      const res = await open({ method: p.method, url: p.url, headers, body: p.body, ca: this.ca(p.env), insecure: !!p.env.insecure, timeout: p.timeout });
       const buf = await readAll(res);
       return { res, buf, headers, ms: Date.now() - t0 };
     };
@@ -483,7 +515,7 @@ export class ApiEnvironments {
     }
     // áudio (TTS): vai inteiro, em base64, para o slide tocar
     const body = /^audio\//i.test(type) ? { _audio: true, type: type.split(";")[0], base64: r.buf.toString("base64") }
-      : parseBody(Buffer.from(this.maskText(p.env, r.buf.toString("utf8"))), type);
+      : p.contextual ? this.maskValue(p.env, parseBody(r.buf, type)) : parseBody(Buffer.from(this.maskText(p.env, r.buf.toString("utf8"))), type);
     return {
       ok: r.res.statusCode < 400, status: r.res.statusCode, statusText: r.res.statusMessage || "", ms: r.ms, size: r.buf.length,
       type, body, sent: p.sent(r.headers), env: p.env.name, token: this.tokenInfo(p.env.name), ...(jwt ? { jwt } : {}),
@@ -610,7 +642,7 @@ export class ApiEnvironments {
   async open(req) {
     const p = await this.prepare(req);
     const headers = await p.withToken(false);
-    const res = await open({ method: p.method, url: req.url, headers, body: p.body, ca: this.ca(p.env), insecure: !!p.env.insecure, timeout: p.timeout });
-    return { res, env: p.env, sent: p.sent(headers), mask: (s) => this.maskText(p.env, s) };
+    const res = await open({ method: p.method, url: p.url, headers, body: p.body, ca: this.ca(p.env), insecure: !!p.env.insecure, timeout: p.timeout });
+    return { res, env: p.env, sent: p.sent(headers), mask: (s) => this.maskText(p.env, s, p.contextual) };
   }
 }

package/src/code-highlight.js

@@ -6,6 +6,9 @@ const KEYWORDS = {
   JavaScript: new Set("async await break case catch class const continue debugger default delete do else export extends finally for from function if import in instanceof let new of return static super switch this throw try typeof var void while with yield".split(" ")),
   TypeScript: new Set("abstract any as asserts async await bigint boolean break case catch class const constructor continue declare default delete do else enum export extends finally for from function get if implements import in infer instanceof interface is keyof let namespace never new number object of package private protected public readonly return set static string super switch symbol this throw try type typeof undefined unique unknown var void while with yield".split(" ")),
   "C#": new Set("abstract as async await base bool break byte case catch char checked class const continue decimal default delegate do double else enum event explicit extern false finally fixed float for foreach goto if implicit in int interface internal is lock long namespace new null object operator out override params private protected public readonly ref return sbyte sealed short sizeof stackalloc static string struct switch this throw try typeof uint ulong unchecked unsafe ushort using virtual void volatile while".split(" ")),
+  Bash: new Set("if then else elif fi for in do done while until case esac function select time export local readonly return exit source".split(" ")),
+  JSON: new Set(),
+  SQL: new Set("SELECT FROM WHERE JOIN INNER LEFT RIGHT FULL OUTER CROSS ON AS AND OR NOT IN IS NULL DISTINCT GROUP BY ORDER HAVING LIMIT OFFSET ASC DESC INSERT INTO VALUES UPDATE SET DELETE CREATE TABLE INDEX VIEW DROP ALTER WITH UNION ALL EXISTS CASE WHEN THEN ELSE END BETWEEN LIKE RETURNING BEGIN COMMIT ROLLBACK PRIMARY KEY REFERENCES DEFAULT".split(" ")),
 };
 
 const TYPES = {
@@ -14,11 +17,19 @@ const TYPES = {
   JavaScript: new Set("Array Boolean Date Map Number Object Promise Set String".split(" ")),
   TypeScript: new Set("Array any bigint boolean never number object string symbol unknown void".split(" ")),
   "C#": new Set("bool byte char DateTime decimal double float int List long object short string Task uint ulong var void".split(" ")),
+  Bash: new Set(),
+  JSON: new Set(),
+  SQL: new Set("INT INTEGER BIGINT TEXT VARCHAR BOOLEAN FLOAT DOUBLE DECIMAL NUMERIC DATE TIMESTAMP JSON JSONB".split(" ")),
 };
 
+const SHELL_COMMANDS = new Set("curl echo printf git npm node python python3 pip pytest jq cat grep sed awk ls cd pwd mkdir rm cp mv sleep read test find sort head tail".split(" "));
+
 const CONSTANTS = new Set(["False", "None", "True", "false", "null", "true", "undefined", "NaN", "Infinity"]);
 
 function tokenPattern(language) {
+  if (language === "Bash") return /(?<comment>(?<!\S)#[^\n]*)|(?<string>'[^']*'|"(?:\\[\s\S]|[^"\\])*")|(?<variable>\$(?:\{[^}\n]+\}|[A-Za-z_][\w]*|[\d?@#*!$-]))|(?<flag>(?<!\S)--?[A-Za-z][\w-]*(?:=[^\s]+)?)|(?<number>\b\d+(?:\.\d+)?\b)|(?<identifier>[A-Za-z_][\w]*)|(?<operator>[|&;<>]+)|(?<punctuation>[{}()\[\]])/g;
+  if (language === "JSON") return /(?<comment>\/\/[^\n]*|\/\*[\s\S]*?\*\/)|(?<string>"(?:\\.|[^"\\])*")|(?<number>\b\d+(?:\.\d+)?(?:[eE][+-]?\d+)?\b)|(?<identifier>true|false|null)|(?<punctuation>[{}\[\],:])/g;
+  if (language === "SQL") return /(?<comment>--[^\n]*|\/\*[\s\S]*?\*\/)|(?<string>'(?:''|[^'])*'|"(?:""|[^"])*"|`[^`]*`)|(?<number>\b\d+(?:\.\d+)?(?:[eE][+-]?\d+)?\b)|(?<identifier>[A-Za-z_][\w$]*)|(?<operator>[-+*/%=&|^!<>~]+)|(?<punctuation>[{}()\[\].,;])/g;
   const comments = language === "Python"
     ? "#[^\\n]*"
     : "\\/\\/[^\\n]*|\\/\\*[\\s\\S]*?\\*\\/";
@@ -32,13 +43,18 @@ function tokenPattern(language) {
 function classify(match, language, source, offset) {
   const groups = match.groups;
   if (groups.comment) return "comment";
+  if (groups.variable) return "constant";
+  if (groups.flag) return "keyword";
+  if (groups.string && language === "JSON" && /^\s*:/.test(source.slice(offset + match[0].length))) return "type";
   if (groups.string) return "string";
   if (groups.number) return "number";
   if (groups.identifier) {
     const word = groups.identifier;
-    if (KEYWORDS[language].has(word)) return "keyword";
+    const normalized = language === "SQL" ? word.toUpperCase() : word;
+    if (KEYWORDS[language].has(normalized)) return "keyword";
     if (CONSTANTS.has(word)) return "constant";
-    if (TYPES[language].has(word)) return "type";
+    if (TYPES[language].has(normalized)) return "type";
+    if (language === "Bash" && SHELL_COMMANDS.has(word)) return "function";
     if (/^\s*\(/.test(source.slice(offset + match[0].length))) return "function";
   }
   if (groups.operator) return "operator";
@@ -47,6 +63,7 @@ function classify(match, language, source, offset) {
 }
 
 export function highlightCode(source, language) {
+  if (!KEYWORDS[language]) return source.split("\n").map(esc);
   const pattern = tokenPattern(language);
   const lines = [""];
   const append = (value, kind = "") => {

package/src/code-language.js

@@ -11,6 +11,11 @@ const EXTENSIONS = new Map([
   [".mts", "TypeScript"],
   [".cts", "TypeScript"],
   [".cs", "C#"],
+  [".sh", "Bash"],
+  [".bash", "Bash"],
+  [".json", "JSON"],
+  [".jsonc", "JSON"],
+  [".sql", "SQL"],
 ]);
 
 const ALIASES = new Map([
@@ -26,6 +31,13 @@ const ALIASES = new Map([
   ["c#", "C#"],
   ["csharp", "C#"],
   ["cs", "C#"],
+  ["bash", "Bash"],
+  ["shell", "Bash"],
+  ["sh", "Bash"],
+  ["curl", "Bash"],
+  ["json", "JSON"],
+  ["jsonc", "JSON"],
+  ["sql", "SQL"],
 ]);
 
 export function inferCodeLanguage(filename) {
@@ -48,5 +60,6 @@ export function resolveCodeLanguage(language, filename) {
 
 export function displayCodeLanguage(language, filename) {
   const requested = String(language || "").trim();
+  if (requested.toLowerCase() === "curl") return "cURL";
   return normalizeCodeLanguage(requested) || requested || inferCodeLanguage(filename);
 }