primocode 7.18.0 → 8.0.0

package/studio/ferramentas/01-modelos.md

@@ -0,0 +1,202 @@
+# MODELOS — três formatos servem as seis ferramentas
+
+Aprenda o modelo `cena` e você já opera Prisma, Tela, Corte e Traço.
+Prosa usa `documento`. Grade usa `planilha`.
+
+---
+
+## Modelo CENA — Prisma, Tela, Corte, Traço
+
+```json
+{
+  "tema": "meia-noite",
+  "largura": 1920,
+  "altura": 1080,
+  "cenas": [
+    {
+      "layout": "capa",
+      "fundo": "malha",
+      "duracao": 4,
+      "notas": "o que falar nesta cena",
+      "elementos": [
+        { "tipo": "texto", "papel": "chapeu", "texto": "Panorama 2026" },
+        { "tipo": "texto", "papel": "titulo", "texto": "Energia solar no Brasil" },
+        { "tipo": "texto", "papel": "apoio",  "texto": "De nicho a segunda maior fonte." }
+      ]
+    }
+  ]
+}
+```
+
+### Layouts — o estúdio posiciona sozinho
+
+| `layout` | Para quê | Ordem esperada |
+|---|---|---|
+| `capa` | abertura, tudo centralizado | chapéu, título, apoio |
+| `titulo` | cena de conteúdo (padrão) | título e depois o corpo |
+| `secao` | divisor entre partes | chapéu e título |
+| `duas-colunas` | comparação, antes/depois | título e dois blocos |
+| `tres-colunas` | três frentes, três pilares | título e três blocos |
+| `numeros` | métricas em destaque | título e um `numeros` |
+| `citacao` | uma frase que fica | um `citacao` |
+| `imagem-direita` / `imagem-esquerda` | texto ao lado de imagem sangrada | texto e uma `imagem` |
+| `centro` | qualquer coisa centralizada |  |
+| `livre` | você define `x`, `y`, `l`, `a` de cada elemento | canvas puro |
+
+**Regra que economiza tempo:** com layout nomeado, **não mande coordenadas**.
+Mande só o conteúdo na ordem certa. Coordenadas só em `livre` — ou quando quiser
+um elemento flutuando por cima do layout.
+
+### Fundos
+
+`"fundo"` aceita:
+- palavra: `malha` · `brilho` · `grade` · `pontos` · `suave` · `vinheta`
+- cor: `"#0b0d10"` ou qualquer CSS válido
+- gradiente: `{"tipo":"gradiente","de":"#1a1030","para":"#06070c","angulo":160}`
+- foto: `{"imagem":"https://…","escurecer":0.6}`
+
+### Elementos
+
+```jsonc
+// TEXTO — papel define o tamanho e o peso automaticamente
+{ "tipo":"texto", "papel":"titulo", "texto":"Aceita **negrito** e *itálico*" }
+// papel: chapeu | titulo | subtitulo | apoio | corpo | legenda
+// opcionais: tamanho, peso, cor, alinhar ("center"), fonte:"mono", maiusculas
+
+// LISTA
+{ "tipo":"lista", "itens":["Primeiro","Segundo"], "numerada":false, "revelar":true }
+
+// CARTÕES — 2 a 4 viram colunas sozinhos
+{ "tipo":"cartoes", "itens":["Título | descrição","Título | descrição"] }
+
+// NÚMEROS
+{ "tipo":"numeros", "itens":["55 GW | capacidade instalada","2ª | maior fonte"] }
+
+// TABELA — a primeira linha é o cabeçalho
+{ "tipo":"tabela", "linhas":[["Etapa","Antes","Agora"],["Custo","alto","resolvido"]] }
+
+// CITAÇÃO
+{ "tipo":"citacao", "texto":"A frase.", "autor":"Quem disse" }
+
+// GRÁFICO
+{ "tipo":"grafico", "grafico":"barras", "dados":[["2024",30],["2025",55]] }
+// grafico: barras | linha | area | pizza | rosca
+
+// IMAGEM
+{ "tipo":"imagem", "src":"https://…", "ajuste":"cobrir", "raio":18 }
+
+// ÍCONE — nomes em /api/ferramentas/tela
+{ "tipo":"icone", "nome":"raio", "tamanho":120, "cor":"#ffb03a" }
+
+// FORMA
+{ "tipo":"forma", "forma":"retangulo", "x":200,"y":200,"l":400,"a":220,
+  "preenchimento":"#ff5a36", "raio":24, "rotacao":-4, "opacidade":0.9 }
+// forma: retangulo | circulo | triangulo | linha | seta
+
+// CÓDIGO
+{ "tipo":"codigo", "texto":"npm install primocode" }
+
+// NÓ e CONECTOR — Traço
+{ "id":"a", "tipo":"no", "texto":"Início", "x":300,"y":460,"l":340,"a":160 }
+{ "tipo":"conector", "de":"a", "para":"b", "estilo":"curva", "texto":"aprovado" }
+```
+
+### Animação
+
+`"anim"` em qualquer elemento: `subir` (padrão) · `surgir` · `esquerda` · `direita` ·
+`zoom` · `desfoque` · `cair` · `girar` · `saltar` · `revelar` · `cortina` ·
+`elastico` · `palavra` (palavra por palavra) · `nenhuma`.
+Sem declarar nada, os elementos já entram em cascata na ordem em que aparecem.
+
+### Estilo — o que tira a cara de template
+
+```jsonc
+// no elemento de texto
+"estilo": "gradiente" | "contorno" | "contorno-tom" | "sombra" | "brilho" |
+          "relevo" | "marcador" | "fita" | "caixa"
+
+// na cena (ou no documento inteiro): textura por cima
+"acabamento": "grao" | "vinheta" | "scanlines" | "luz" | "brilho" | "moldura"
+
+// na cena: troca a cor de destaque só ali
+"tom": "#ff5a36", "tom2": "#ffb03a"
+
+// na imagem
+"movimento": "aproximar" | "afastar" | "esquerda" | "direita" | "cima"
+"filtro": "cinza" | "sepia" | "contraste" | "desbotado"
+
+// em numeros: o número sobe do zero
+"contar": true
+
+// em lista: itens aparecem um a um
+"revelar": true, "intervalo": 0.9
+```
+
+### Temas
+
+`meia-noite` `claro` `papel` `neon` `brasa` `floresta` `retro` `oceano` `doce` `mono`
+
+Vale no documento ou por cena. Uma cena com tema diferente no meio cria respiro —
+use uma vez, não cinco.
+
+### Mídia do computador
+
+Suba o arquivo e use a URL devolvida em `src`, `fundo.imagem` ou `trilha.src`:
+
+```bash
+curl -s -X POST http://localhost:7777/api/midia \
+  -H 'Content-Type: application/json' \
+  -d '{"nome":"foto.jpg","dados":"data:image/jpeg;base64,..."}'
+# → {"nome":"foto.jpg","url":"/midia/foto.jpg","tipo":"imagem","bytes":184223}
+```
+
+`GET /api/midia` lista o que já foi enviado — sempre confira antes de pedir um
+arquivo novo ao usuário. Aceita imagem, áudio e vídeo até 60 MB.
+
+---
+
+## Modelo DOCUMENTO — Prosa
+
+```json
+{
+  "tema": "papel",
+  "capa": { "chapeu":"Relatório", "titulo":"...", "apoio":"...", "autor":"...", "data":"2026" },
+  "blocos": [
+    { "tipo":"secao", "texto":"Contexto" },
+    { "tipo":"paragrafo", "texto":"Texto corrido com **negrito** e [link](url)." },
+    { "tipo":"lista", "itens":["um","dois"] },
+    { "tipo":"destaque", "titulo":"Atenção", "texto":"O ponto que não pode passar." }
+  ]
+}
+```
+
+Blocos: `titulo` `chapeu` `apoio` `secao` `subsecao` `paragrafo` `lista` `numerada`
+`citacao` `codigo` `tabela` `imagem` `destaque` `sumario` `divisor` `quebra`.
+
+---
+
+## Modelo PLANILHA — Grade
+
+```json
+{
+  "tema": "claro",
+  "abas": [{
+    "nome": "Custos",
+    "colunas": ["Item", "Qtd", "Unitário", "Total"],
+    "linhas": [
+      ["Servidor", 3, 240, "=B1*C1"],
+      ["Licenças", 12, 89, "=B2*C2"],
+      ["Total", "", "", "=SOMA(D1:D2)"]
+    ],
+    "formatos": { "Unitário": "moeda", "Total": "moeda" },
+    "regras": [{ "coluna": "Total", "acima": 1000 }],
+    "grafico": { "tipo": "barras", "rotulo": "Item", "valor": "Total" }
+  }]
+}
+```
+
+Fórmulas: `=SOMA(A1:A9)` `=MEDIA(B1:B4)` `=MIN(...)` `=MAX(...)` `=CONT(...)`
+`=ARRED(...)` e aritmética com referências (`=B2*1.2`). Colunas são A, B, C…;
+linhas começam em 1. Argumentos de função separados por `;`.
+
+Formatos: `texto` `inteiro` `decimal` `moeda` `percentual`.

package/studio/ferramentas/README.md

@@ -0,0 +1,32 @@
+# ferramentas/
+
+Esta pasta é a fonte da verdade do estúdio. O servidor lê estes arquivos e os
+entrega juntos em `GET /api/manual` — não existe spec duplicada em outro lugar.
+Editar um `.md` aqui muda o que a IA sabe, na hora, sem reiniciar nada.
+
+| Arquivo | Conteúdo |
+|---|---|
+| `00-protocolo.md` | como o agente se comporta, a frase de abertura, a tabela de equivalência e a API |
+| `01-modelos.md` | os três modelos de documento — `cena`, `documento`, `planilha` |
+| `prisma.md` | apresentações |
+| `tela.md` | design gráfico |
+| `prosa.md` | documentos |
+| `grade.md` | planilhas |
+| `corte.md` | vídeo |
+| `traco.md` | diagramas |
+
+## Ordem de leitura para um agente
+
+1. `00-protocolo.md` — decide **o quê** e **como responder**
+2. `01-modelos.md` — aprende **o formato**
+3. o `.md` da ferramenta escolhida — pega o **exemplo pronto** e adapta
+
+Um agente com pressa pode buscar tudo de uma vez em `GET /api/manual`.
+
+## Endpoints
+
+```
+GET /api/manual                 tudo isto, concatenado
+GET /api/ferramentas            as seis, em JSON
+GET /api/ferramentas/<slug>     um destes arquivos, em texto
+```

package/studio/ferramentas/corte.md

@@ -0,0 +1,193 @@
+# CORTE — vídeo
+
+No lugar de CapCut, Premiere e After Effects. Modelo `cena`, com `duracao` em cada
+cena, trilha sonora, transições e gravação em `.webm`.
+
+## Como pensar um vídeo curto
+
+Um Reels de 30 s são 7 a 9 cenas de 3 a 5 segundos. A regra é dura:
+**uma frase por cena**. Se não dá para ler em voz alta dentro da duração, corte texto.
+
+| Cena | Papel | Duração |
+|---|---|---|
+| 1 | gancho — a frase que segura o dedo | 2–3 s |
+| 2–3 | o problema, concreto | 3–4 s |
+| 4–6 | a virada, um argumento por cena | 4 s |
+| 7 | número ou prova | 4 s |
+| 8 | chamada — o que fazer agora | 3 s |
+
+Vertical é `1080 × 1920`. Horizontal (`1920 × 1080`) só quando o destino for YouTube
+ou tela grande. Em vertical, os tamanhos padrão de texto já crescem sozinhos.
+
+---
+
+## Trilha sonora
+
+Vai no **documento**, não na cena:
+
+```json
+"trilha": { "tipo": "gerada", "estilo": "pulso", "volume": 0.7 }
+```
+
+### Geradas pelo estúdio
+
+Música sintetizada na hora, sem arquivo e sem licença de terceiro.
+
+| `estilo` | Cara | BPM |
+|---|---|---|
+| `pulso` | eletrônico, batida marcada | 112 |
+| `ambiente` | pads longos, sem bateria | 68 |
+| `lofi` | levada atrasada, acordes soltos | 76 |
+| `epico` | grave, crescendo | 88 |
+| `alegre` | maior, arpejo rápido | 124 |
+| `tenso` | menor, suspense | 100 |
+
+A trilha gerada não acaba — acompanha o vídeo até a última cena.
+
+### Arquivo do usuário
+
+```json
+"trilha": { "tipo": "arquivo", "src": "/midia/minha-faixa.mp3",
+            "volume": 0.7, "inicio": 0, "repetir": true }
+```
+
+`src` vem de `POST /api/midia` (upload) ou é uma URL direta de áudio.
+`inicio` pula os primeiros segundos da faixa.
+
+**Não baixe áudio de YouTube, Spotify ou similares** — quebra os termos dessas
+plataformas e o direito autoral da faixa. Use música do próprio usuário, faixa
+livre de direitos, ou uma das trilhas geradas acima.
+
+---
+
+## Transições
+
+Na cena, `transicao` define como ela **entra**:
+
+`corte` (sem efeito) · `fade` · `deslizar` · `subir` · `zoom` · `limpar` ·
+`persiana` · `flash`
+
+Vale o mesmo conselho das animações: varie. Tudo em `fade` parece slide, não vídeo.
+
+## Acabamento
+
+Textura por cima da cena inteira — é o que tira a cara de template:
+
+`grao` · `vinheta` · `scanlines` · `luz` · `brilho` · `moldura`
+
+Pode ir no documento (vale para tudo) ou por cena. `grao` no documento inteiro
+dá unidade de película ao vídeo.
+
+## Fundos
+
+`malha` `brilho` `grade` `pontos` `suave` `vinheta` `aurora` `raios` `ondas`
+`nevoa` `xadrez`, ou cor, gradiente e foto:
+
+```json
+"fundo": { "imagem": "/midia/foto.jpg", "escurecer": 0.55 }
+```
+
+## Movimento de imagem (Ken Burns)
+
+```json
+{ "tipo": "imagem", "src": "/midia/foto.jpg", "x": 0, "y": 0, "l": 1080, "a": 1920,
+  "raio": 0, "movimento": "aproximar", "filtro": "contraste" }
+```
+
+`movimento`: `aproximar` `afastar` `esquerda` `direita` `cima` ·
+`filtro`: `cinza` `sepia` `contraste` `desbotado`
+
+Imagem parada em vídeo denuncia preguiça. Sempre dê movimento.
+
+## Texto com estilo
+
+`estilo` no elemento de texto:
+
+`gradiente` · `contorno` · `contorno-tom` · `sombra` · `brilho` · `relevo` ·
+`marcador` (fundo tipo caneta) · `fita` (tarja cheia) · `caixa`
+
+## Animações de entrada
+
+`subir` `surgir` `esquerda` `direita` `zoom` `desfoque` `cair` `girar` `saltar`
+`revelar` `cortina` `elastico` `palavra` (palavra por palavra) `nenhuma`
+
+Em `numeros`, `"contar": true` faz o número subir do zero — funciona muito bem
+combinado com `saltar`.
+
+Em `lista`, `"revelar": true` distribui os itens dentro da duração da cena;
+`intervalo` (segundos) controla o espaçamento entre eles.
+
+---
+
+## Exemplo completo
+
+```json
+{
+  "ferramenta": "corte",
+  "titulo": "Reels — por que sua conta de luz subiu",
+  "doc": {
+    "tema": "brasa",
+    "largura": 1080, "altura": 1920,
+    "acabamento": "grao",
+    "trilha": { "tipo": "gerada", "estilo": "pulso", "volume": 0.7 },
+    "cenas": [
+      { "layout": "centro", "duracao": 3, "fundo": "aurora", "transicao": "flash",
+        "elementos": [
+          { "tipo": "texto", "papel": "titulo", "texto": "Sua conta subiu\nde novo.",
+            "tamanho": 124, "estilo": "gradiente", "anim": "desfoque" }]},
+
+      { "layout": "centro", "duracao": 3, "fundo": "vinheta", "transicao": "limpar",
+        "elementos": [
+          { "tipo": "texto", "papel": "titulo", "texto": "E não foi o seu chuveiro.",
+            "tamanho": 78, "estilo": "marcador", "anim": "palavra" }]},
+
+      { "layout": "centro", "duracao": 4, "transicao": "zoom", "acabamento": "vinheta",
+        "fundo": { "imagem": "/midia/torre.jpg", "escurecer": 0.5 },
+        "elementos": [
+          { "tipo": "numeros", "contar": true, "anim": "saltar", "tamanho": 180,
+            "itens": ["+38% | bandeira tarifária em 12 meses"] }]},
+
+      { "layout": "livre", "duracao": 4, "transicao": "deslizar",
+        "elementos": [
+          { "tipo": "imagem", "src": "/midia/campo.jpg", "x": 0, "y": 0,
+            "l": 1080, "a": 1920, "raio": 0, "movimento": "aproximar", "filtro": "contraste" },
+          { "tipo": "forma", "forma": "retangulo", "x": 0, "y": 1180, "l": 1080, "a": 740,
+            "preenchimento": "rgba(10,5,6,.72)" },
+          { "tipo": "texto", "x": 90, "y": 1320, "l": 900, "a": 420,
+            "texto": "O custo está\nna transmissão", "tamanho": 104, "peso": 750,
+            "estilo": "sombra", "anim": "cortina" }]},
+
+      { "layout": "centro", "duracao": 5, "fundo": "raios", "transicao": "subir",
+        "elementos": [
+          { "tipo": "lista", "revelar": true, "tamanho": 52, "intervalo": 0.9,
+            "itens": ["Linhas saturadas no Nordeste",
+                      "Usina gerando sem escoar",
+                      "A conta chega em quem consome"] }]},
+
+      { "layout": "centro", "duracao": 3, "fundo": "brilho", "transicao": "fade",
+        "acabamento": "luz",
+        "elementos": [
+          { "tipo": "texto", "papel": "titulo", "texto": "Segue para\nentender a próxima.",
+            "tamanho": 96, "estilo": "contorno-tom", "anim": "elastico" }]}
+    ]
+  }
+}
+```
+
+---
+
+## No modo Abrir
+
+Toca sozinho ao carregar, com barra de transporte embaixo:
+play/pausa, linha do tempo clicável com marca por cena, tempo, volume e **Gravar**.
+
+`K` toca e pausa · `M` corta o som · `→` `←` pulam cena · `F` tela cheia · `Escape` para.
+
+## Virar arquivo de vídeo
+
+O botão **Gravar** usa a captura de tela do navegador: escolha a aba, o vídeo toca do
+começo, para sozinho no fim e baixa um `.webm` com a trilha junto. Para o melhor
+resultado, entre em tela cheia (`F`) antes de gravar.
+
+O export normal (`/api/arquivos/<id>/export`) devolve um `.html` autônomo com a
+mídia embutida — abre offline em qualquer navegador e toca igual.

package/studio/ferramentas/grade.md

@@ -0,0 +1,92 @@
+# GRADE — planilhas
+
+No lugar de Excel e Google Sheets. Modelo `planilha`, com fórmulas de verdade
+resolvidas no navegador.
+
+## Exemplo
+
+```json
+{
+  "ferramenta": "grade",
+  "titulo": "Orçamento de infraestrutura 2026",
+  "doc": {
+    "tema": "claro",
+    "abas": [
+      {
+        "nome": "Custos",
+        "colunas": ["Item", "Qtd", "Unitário", "Total"],
+        "linhas": [
+          ["Servidor de aplicação", 6, 18400, "=B1*C1"],
+          ["Servidor de banco", 3, 26800, "=B2*C2"],
+          ["Licenças anuais", 12, 4200, "=B3*C3"],
+          ["Rede e cabeamento", 1, 38000, "=B4*C4"],
+          ["Total", "", "", "=SOMA(D1:D4)"]
+        ],
+        "formatos": { "Qtd": "inteiro", "Unitário": "moeda", "Total": "moeda" },
+        "regras": [{ "coluna": "Total", "acima": 100000 }],
+        "grafico": { "tipo": "barras", "rotulo": "Item", "valor": "Total" }
+      },
+      {
+        "nome": "Projeção",
+        "colunas": ["Mês", "Receita", "Custo", "Margem", "Margem %"],
+        "linhas": [
+          ["Jan", 320000, 214000, "=B1-C1", "=ARRED(D1/B1*100)"],
+          ["Fev", 348000, 219000, "=B2-C2", "=ARRED(D2/B2*100)"],
+          ["Mar", 391000, 226000, "=B3-C3", "=ARRED(D3/B3*100)"],
+          ["Média", "=MEDIA(B1:B3)", "=MEDIA(C1:C3)", "=MEDIA(D1:D3)", ""]
+        ],
+        "formatos": { "Receita": "moeda", "Custo": "moeda", "Margem": "moeda", "Margem %": "percentual" },
+        "grafico": { "tipo": "linha", "rotulo": "Mês", "valor": "Margem" }
+      }
+    ]
+  }
+}
+```
+
+## Fórmulas
+
+Escreva na célula, começando com `=`.
+
+| Função | Exemplo |
+|---|---|
+| `SOMA` | `=SOMA(D1:D9)` |
+| `MEDIA` | `=MEDIA(B1:B12)` |
+| `MIN` / `MAX` | `=MAX(C1:C20)` |
+| `CONT` | `=CONT(A1:A50)` |
+| `ARRED` | `=ARRED(D1/B1*100)` |
+| aritmética | `=B2*1.2` · `=(B3-C3)/B3` |
+
+- Colunas são **A, B, C…** na ordem de `colunas`; linhas começam em **1** na
+  primeira entrada de `linhas` (o cabeçalho **não** conta como linha).
+- Argumentos de função separados por `;` — `=SOMA(A1:A3;B5)`.
+- Referência circular devolve `#ERRO` em vez de travar.
+
+## Formatação
+
+```json
+"formatos": { "Receita": "moeda", "Margem %": "percentual", "Qtd": "inteiro" }
+```
+
+`texto` · `inteiro` · `decimal` · `moeda` (R$, pt-BR) · `percentual`.
+
+Cores condicionais:
+
+```json
+"regras": [ { "coluna": "Total", "acima": 100000 },
+            { "coluna": "Margem %", "abaixo": 20 } ]
+```
+
+`acima` pinta de verde, `abaixo` de vermelho.
+
+## Gráfico da aba
+
+```json
+"grafico": { "tipo": "barras", "rotulo": "Item", "valor": "Total" }
+```
+
+`barras` · `linha` · `area` · `pizza` · `rosca`. Linhas de fórmula (totais e médias)
+ficam fora do gráfico automaticamente.
+
+## Export
+
+`GET /api/arquivos/<id>/export` devolve **CSV** com os valores já calculados.

package/studio/ferramentas/prisma.md

@@ -0,0 +1,99 @@
+# PRISMA — apresentações
+
+No lugar de PowerPoint, Keynote e Canva Apresentações. Modelo `cena`, 1920×1080.
+
+## Receita de um deck que funciona
+
+1. **capa** — chapéu, título, uma linha de apoio
+2. **contexto** — por que isso importa agora (`titulo` + `lista`)
+3. **secao** — divisor antes de cada parte
+4. o miolo: `numeros`, `tabela`, `cartoes`, `grafico`, `citacao`
+5. **o pedido** — o que você quer que a pessoa faça
+6. **fecho** — `capa` de novo, com contato
+
+Entre 8 e 14 cenas para 10 minutos. Uma ideia por cena.
+
+## Exemplo completo
+
+```json
+{
+  "ferramenta": "prisma",
+  "titulo": "Energia solar no Brasil",
+  "doc": {
+    "tema": "meia-noite",
+    "cenas": [
+      { "layout": "capa", "fundo": "malha", "elementos": [
+        { "tipo": "texto", "papel": "chapeu", "texto": "Panorama 2026" },
+        { "tipo": "texto", "papel": "titulo", "texto": "Energia solar no Brasil" },
+        { "tipo": "texto", "papel": "apoio", "texto": "De nicho a segunda maior fonte da matriz em uma década." }
+      ]},
+
+      { "layout": "secao", "fundo": "brilho", "elementos": [
+        { "tipo": "texto", "papel": "chapeu", "texto": "Parte 01" },
+        { "tipo": "texto", "papel": "titulo", "texto": "O que aconteceu" }
+      ]},
+
+      { "layout": "titulo", "notas": "abrir pelo custo, é o argumento mais forte", "elementos": [
+        { "tipo": "texto", "papel": "titulo", "texto": "Três forças empurraram a curva" },
+        { "tipo": "lista", "revelar": true, "itens": [
+          "Queda de 82% no custo do painel desde 2012",
+          "Marco legal da geração distribuída em 2022",
+          "Leilões que destravaram a geração centralizada"
+        ]}
+      ]},
+
+      { "layout": "numeros", "elementos": [
+        { "tipo": "texto", "papel": "titulo", "texto": "Onde estamos" },
+        { "tipo": "numeros", "itens": [
+          "55 GW | capacidade instalada",
+          "2ª | maior fonte da matriz",
+          "R$ 200 bi | investidos desde 2012"
+        ]}
+      ]},
+
+      { "layout": "titulo", "elementos": [
+        { "tipo": "texto", "papel": "titulo", "texto": "O gargalo mudou de lugar" },
+        { "tipo": "tabela", "linhas": [
+          ["Etapa", "Antes", "Agora"],
+          ["Custo do módulo", "proibitivo", "resolvido"],
+          ["Licenciamento", "simples", "lento"],
+          ["Transmissão", "ociosa", "saturada"]
+        ]}
+      ]},
+
+      { "layout": "citacao", "tema": "papel", "elementos": [
+        { "tipo": "citacao",
+          "texto": "O sol já é barato. O caro agora é o fio que leva a energia até quem consome.",
+          "autor": "Relatório do setor, 2026" }
+      ]},
+
+      { "layout": "tres-colunas", "elementos": [
+        { "tipo": "texto", "papel": "titulo", "texto": "O que fazer em 2026" },
+        { "tipo": "cartoes", "itens": [
+          "Armazenamento | Baterias para segurar o excedente do meio-dia",
+          "Transmissão | Novos leilões de linha no Nordeste",
+          "Previsibilidade | Regras estáveis para o investidor longo"
+        ]}
+      ]},
+
+      { "layout": "capa", "fundo": "malha", "elementos": [
+        { "tipo": "texto", "papel": "titulo", "texto": "Obrigado" },
+        { "tipo": "texto", "papel": "apoio", "texto": "perguntas?" }
+      ]}
+    ]
+  }
+}
+```
+
+## Detalhes que valem
+
+- **`tema` por cena** sobrepõe o do deck. Uma citação em `papel` no meio de um deck
+  `meia-noite` cria respiro — use uma vez, não cinco.
+- **`revelar: true`** na lista faz os itens aparecerem um a um.
+- **`notas`** na cena aparecem só para quem apresenta.
+- **Imagem de capa:** `"fundo": {"imagem":"url","escurecer":0.6}` com `layout: "capa"`.
+- Conteúdo grande demais encolhe sozinho para caber — mas isso é remendo, não plano.
+
+## Na hora de apresentar
+
+`→` avança · `←` volta · `F` tela cheia · `P` salva em PDF (uma cena por página).