primocode 8.42.2 → 9.1.0

package/studio/ferramentas/grade.md

@@ -1,92 +0,0 @@
-# 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

@@ -1,107 +0,0 @@
-# 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
-
-- **A cena compõe sozinha.** Com título e conteúdo, o título ancora no alto e o
-  conteúdo ocupa o corpo, em escala de projetor; o rodapé com o nome do deck e
-  "03 / 08" entra sozinho (menos na capa e nas seções). Não simule isso com
-  `livre`.
-- **Varie o layout entre as cenas**: `numeros` para o dado que decide,
-  `imagem-direita` com foto ou `dispositivo` quando há produto, `cartoes` em
-  `tres-colunas` para as opções, `citacao` para a voz de fora, `tabela` para
-  comparar. Cinco cenas `titulo` + `lista` seguidas é o deck que ninguém lembra.
-- **`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).

package/studio/ferramentas/prosa.md

@@ -1,86 +0,0 @@
-# PROSA — documentos
-
-No lugar de Word, Google Docs e Notion. Modelo `documento`, página A4.
-
-## Estrutura de um documento que se lê até o fim
-
-1. `capa` — chapéu, título, apoio, autor e data
-2. `sumario` — só se passar de 4 seções
-3. `secao` a cada bloco de raciocínio, com `paragrafo` de 3 a 5 linhas
-4. `destaque` para o que não pode passar batido
-5. `tabela` quando comparar, `lista` quando enumerar, `citacao` quando emprestar autoridade
-6. fecho com o próximo passo concreto
-
-## Exemplo
-
-```json
-{
-  "ferramenta": "prosa",
-  "titulo": "Proposta — modernização do parque de servidores",
-  "doc": {
-    "tema": "papel",
-    "capa": {
-      "chapeu": "Proposta técnica",
-      "titulo": "Modernização do parque de servidores",
-      "apoio": "Diagnóstico, plano em três ondas e estimativa de custo.",
-      "autor": "Time de Infraestrutura",
-      "data": "Agosto de 2026"
-    },
-    "blocos": [
-      { "tipo": "sumario", "texto": "Sumário" },
-
-      { "tipo": "secao", "texto": "Onde estamos" },
-      { "tipo": "paragrafo", "texto": "O parque atual tem **34 máquinas**, das quais 11 passaram do fim de suporte do fabricante. O custo de manutenção subiu 40% em dois anos enquanto a capacidade útil ficou parada." },
-      { "tipo": "destaque", "titulo": "Risco imediato",
-        "texto": "Três servidores de banco não recebem correção de segurança desde março." },
-
-      { "tipo": "secao", "texto": "O que propomos" },
-      { "tipo": "numerada", "itens": [
-        "Onda 1 — trocar os 11 equipamentos fora de suporte",
-        "Onda 2 — consolidar cargas em 6 máquinas novas",
-        "Onda 3 — mover o que for elástico para nuvem"
-      ]},
-      { "tipo": "tabela", "linhas": [
-        ["Onda", "Prazo", "Investimento"],
-        ["1", "60 dias", "R$ 420 mil"],
-        ["2", "120 dias", "R$ 310 mil"],
-        ["3", "180 dias", "custo variável"]
-      ]},
-
-      { "tipo": "secao", "texto": "Próximo passo" },
-      { "tipo": "paragrafo", "texto": "Aprovar a Onda 1 até o fim do mês para caber na janela de manutenção de outubro." }
-    ]
-  }
-}
-```
-
-## Blocos
-
-| tipo | campos | vira |
-|---|---|---|
-| `titulo` | `texto` | H1 |
-| `chapeu` | `texto` | sobretítulo colorido |
-| `apoio` | `texto` | linha de apoio, cinza |
-| `secao` | `texto` | H2 |
-| `subsecao` | `texto` | H3 |
-| `paragrafo` | `texto` | parágrafo |
-| `lista` / `numerada` | `itens[]` | lista |
-| `citacao` | `texto`, `autor` | citação com barra |
-| `codigo` | `texto` | bloco monoespaçado |
-| `tabela` | `linhas[][]` | primeira linha é cabeçalho |
-| `imagem` | `src`, `legenda` | figura |
-| `destaque` | `titulo`, `texto` | caixa de atenção |
-| `sumario` | `texto` | índice das seções, automático |
-| `divisor` | — | linha |
-| `quebra` | — | quebra de página no PDF |
-
-No texto: `**negrito**`, `*itálico*`, `` `código` ``, `[link](url)`.
-
-## Temas
-
-`papel` para leitura longa (serifado, bege) · `claro` para corporativo ·
-`meia-noite` para leitura em tela.
-
-## Export
-
-`GET /api/arquivos/<id>/export` devolve **Markdown**. Para PDF, abra `/v/<id>` e `P`.

package/studio/ferramentas/tela.md

@@ -1,93 +0,0 @@
-# TELA — design gráfico
-
-No lugar de Photoshop, Figma e Canva. Modelo `cena` com `layout: "livre"`:
-você controla cada `x`, `y`, `l`, `a` em pixels da tela.
-
-## Tamanhos
-
-| Peça | largura × altura |
-|---|---|
-| Post quadrado | 1080 × 1080 |
-| Story / Reels capa | 1080 × 1920 |
-| Capa e thumbnail | 1920 × 1080 |
-| Banner de topo | 1600 × 600 |
-| Apresentação de perfil | 1200 × 630 |
-
-## Como compor sem ficar feio
-
-- **Margem viva:** nada encosta na borda. Reserve ~8% de cada lado (86 px em 1080).
-- **Conte as linhas antes de definir `a`.** Em texto, `a` é altura mínima — o bloco
-  cresce se precisar, então deixe folga abaixo dele. Uma linha ocupa ~1,15 × `tamanho`.
-- **Um foco só.** Um elemento manda; o resto apoia.
-- **Escala com folga:** título 110–160 px em 1080, apoio 34–44 px. Meio-termo some.
-- **Camadas de fundo primeiro:** forma grande → foto → texto por cima. `z` resolve empates.
-- **Cor:** duas do tema, uma de destaque. `preenchimento` com `opacidade: 0.15` cria
-  fundo sem brigar com o texto.
-
-## Exemplo — post 1080×1080
-
-```json
-{
-  "ferramenta": "tela",
-  "titulo": "Post — lançamento",
-  "doc": {
-    "tema": "brasa",
-    "largura": 1080, "altura": 1080,
-    "cenas": [{
-      "layout": "livre",
-      "fundo": { "tipo": "gradiente", "de": "#1b0a04", "para": "#0a0506", "angulo": 155 },
-      "elementos": [
-        { "tipo": "forma", "forma": "circulo", "x": 640, "y": -140, "l": 620, "a": 620,
-          "preenchimento": "#ff5a36", "opacidade": 0.16 },
-        { "tipo": "icone", "nome": "foguete", "x": 86, "y": 140, "tamanho": 88, "cor": "#ffb03a" },
-        { "tipo": "texto", "x": 86, "y": 292, "l": 900, "a": 44,
-          "texto": "LANÇAMENTO", "tamanho": 30, "peso": 700, "espacamento": 0.2, "cor": "#ffb03a" },
-        { "tipo": "texto", "x": 86, "y": 372, "l": 908, "a": 460,
-          "texto": "A primeira versão\nestá no ar", "tamanho": 118, "peso": 750 },
-        { "tipo": "forma", "forma": "linha", "x": 86, "y": 880, "l": 180, "a": 8,
-          "preenchimento": "#ff5a36", "espessura": 8 },
-        { "tipo": "texto", "x": 86, "y": 926, "l": 800, "a": 60,
-          "texto": "primocode.studio", "tamanho": 36, "cor": "#bf9c8a" }
-      ]
-    }]
-  }
-}
-```
-
-## Ícones disponíveis
-
-`raio` `alvo` `foguete` `escudo` `relogio` `usuario` `pessoas` `coracao` `estrela`
-`nuvem` `engrenagem` `lampada` `cadeado` `casa` `email` `telefone` `camera` `fogo`
-`globo` `chave` `presente` `sino` `mapa` `dinheiro` `crescimento` `grafico` `balao`
-`pasta` `livro` `play2` `check` `imagem` `codigo` `tabela` `lista`
-
-## Vidro e ícone-objeto
-
-`"material": "vidro"` em qualquer elemento é o liquid glass: painel
-translúcido que **desfoca o que está atrás**, com bisel de luz em cima e
-reflexo diagonal. Precisa de algo atrás (gradiente, forma colorida, foto) para
-aparecer. Na forma, `preenchimento` vira a tinta do vidro.
-
-```json
-{ "tipo": "forma", "forma": "retangulo", "material": "vidro", "raio": 32,
-  "x": 86, "y": 300, "l": 908, "a": 380, "preenchimento": "#ff5a36" }
-```
-
-`"estilo": "app"` no ícone faz o azulejo de aplicativo (gradiente da cor,
-brilho, sombra, traço branco); `"estilo": "vidro"` faz o mesmo azulejo em
-vidro. `fundo` pinta o azulejo. É o ícone de produto para capa e post de
-lançamento:
-
-```json
-{ "tipo": "icone", "nome": "foguete", "estilo": "app", "x": 86, "y": 120, "tamanho": 200, "fundo": "#8b5cf6" }
-```
-
-## Várias artes no mesmo arquivo
-
-Cada item de `cenas` é uma prancha independente. Um carrossel de Instagram é um
-arquivo com 5 cenas de 1080×1080 — o modo Abrir passa uma a uma com `→`.
-
-## Export
-
-`GET /api/arquivos/<id>/export` devolve um `.html` autônomo. Para PNG, abra em
-`/v/<id>` e use a captura de tela do sistema, ou `P` para gerar PDF em escala real.

package/studio/ferramentas/traco.md

@@ -1,79 +0,0 @@
-# TRAÇO — diagramas
-
-No lugar de Miro, Whimsical e Lucidchart. Modelo `cena` com `layout: "livre"`:
-nós posicionados e conectores que se ligam sozinhos pela borda mais curta.
-
-## Regra que faz o diagrama ficar legível
-
-- **Grade invisível de 60 px.** Use `x` e `y` múltiplos de 60. Alinhamento é o que
-  separa diagrama de rabisco.
-- **Fluxo lê da esquerda para a direita** (processo) ou **de cima para baixo**
-  (hierarquia). Não misture os dois no mesmo diagrama.
-- **Nó padrão:** `l: 340, a: 150`. Mantenha o mesmo tamanho para nós do mesmo nível.
-- **Espaço entre colunas:** 200 px. Entre linhas: 90 px.
-- **`destaque: true`** em no máximo dois nós — o começo e o resultado.
-
-## Exemplo — fluxo de aprovação
-
-```json
-{
-  "ferramenta": "traco",
-  "titulo": "Fluxo de aprovação de compras",
-  "doc": {
-    "tema": "meia-noite",
-    "largura": 1920, "altura": 1080,
-    "cenas": [{
-      "layout": "livre",
-      "fundo": "pontos",
-      "elementos": [
-        { "id": "ped", "tipo": "no", "texto": "Pedido aberto",  "x": 120,  "y": 480, "l": 320, "a": 140, "destaque": true },
-        { "id": "val", "tipo": "no", "texto": "Validação\nfiscal",  "x": 620,  "y": 480, "l": 320, "a": 140 },
-        { "id": "ger", "tipo": "no", "texto": "Aprovação\ngerência", "x": 1120, "y": 300, "l": 320, "a": 140 },
-        { "id": "dir", "tipo": "no", "texto": "Aprovação\ndiretoria", "x": 1120, "y": 660, "l": 320, "a": 140 },
-        { "id": "ok",  "tipo": "no", "texto": "Compra\nemitida", "x": 1560, "y": 480, "l": 280, "a": 140, "destaque": true },
-
-        { "tipo": "conector", "de": "ped", "para": "val" },
-        { "tipo": "conector", "de": "val", "para": "ger", "texto": "até R$ 20 mil" },
-        { "tipo": "conector", "de": "val", "para": "dir", "texto": "acima de R$ 20 mil" },
-        { "tipo": "conector", "de": "ger", "para": "ok" },
-        { "tipo": "conector", "de": "dir", "para": "ok" },
-
-        { "tipo": "texto", "x": 120, "y": 120, "l": 900, "a": 120,
-          "texto": "Compras · fluxo vigente", "papel": "chapeu" }
-      ]
-    }]
-  }
-}
-```
-
-## Nós e conectores
-
-```jsonc
-{ "id": "a", "tipo": "no", "texto": "Etapa",
-  "x": 300, "y": 460, "l": 340, "a": 150,
-  "destaque": false,        // pinta com a cor do tema
-  "formato": "circulo",     // opcional
-  "cor": "#1f8fe0" }        // opcional, sobrepõe o tema
-
-{ "tipo": "conector", "de": "a", "para": "b",
-  "estilo": "curva",        // curva | reta | cotovelo
-  "texto": "rótulo da seta",
-  "tracejado": false,
-  "seta": true }
-```
-
-O conector calcula sozinho de qual lado sai e entra. Se `de` ou `para` apontar para
-um `id` que não existe, ele simplesmente não é desenhado — sem quebrar o resto.
-
-## Também serve para
-
-- **Mapa mental:** nó central `destaque` e ramos em volta, `estilo: "curva"`.
-- **Arquitetura:** uma `forma` grande atrás como área ("Nuvem", "On-premise") e os
-  nós por cima; use `opacidade: 0.06` na área.
-- **Organograma:** fluxo de cima para baixo, `estilo: "cotovelo"`.
-- **Jornada:** uma linha só, `estilo: "reta"`, com `icone` acima de cada etapa.
-
-## Vários diagramas
-
-Cada item de `cenas` é uma prancha. Um arquivo pode ter o "como é hoje" e o
-"como fica depois" — o modo Abrir alterna com `→`.