NEWS

---

trama 0.5.16

• Relatório Quarto: gráfico no tema "padrão" sai num tema claro quando o padrão do projeto é escuro (o primeiro claro do projeto, ou o claro embutido). Tema escolhido no card e script .R não mudam.
• tr_type(report_always = TRUE): a saída aparece no relatório mesmo consumida por um fio, salvo quando quem consome devolve o mesmo tipo (numa cadeia, só o último elo aparece).
• Relatório Quarto: "Referências dos métodos" vira "Software". O documento cita as ferramentas, não o método nem o livro-texto: uma tabela bloco → pacote::função() (das tr_ref de implementação) e um chunk que cita o R e cada pacote com citation() na hora de renderizar. O que cada bloco usou vem do resultado (atributo trama_ferramentas, posto pela coleção no ramo que rodou) ou, sem ele, do que o bloco declara; a tabela só mostra ferramentas de fora da base do R e do trama. As referências de teoria, livro-texto e complementares continuam na ajuda do bloco.

trama 0.5.15

• Galeria: sem marca, só entram sozinhos os blocos de visualização, que declaram tr_node(galeria = TRUE). Gráfico de outro bloco (diagnóstico de modelo, coeficientes…) entra só marcado com ☆ ou Shift+G. Antes, todo preview de imagem entrava, e o rolo enchia.
• Menu do card (botão direito): "Bifurcar a trama a partir daqui", "Pôr / tirar da galeria" e, numa cópia de ramo, "Desligar do espelhamento" / "Religar ao ramo".

trama 0.5.14

• Galeria: G abre um rolo com as imagens da análise, e clicar numa miniatura abre o lightbox, com setas, "ir ao card" e "tirar da galeria". Gráficos entram sozinhos; qualquer outro card entra pela estrela ☆ do preview (ou Shift+G). Cada card tem um arquivo na pasta da galeria (gallery/ por padrão), sempre a versão atual e com nome estável, regravado só quando o resultado muda. Gráficos são re-renderizados em qualidade de publicação (PNG a 300 dpi por padrão), e tabelas são fotografadas pelo editor. Pasta, formato, dpi e "gráficos entram sozinhos" ficam em trama.json (chave galeria), editáveis nas Configurações e pelo launcher. Op set_galeria (cosmética), tr_project_set_galeria(), tr_galeria_sincronizar(). O preview de um tipo recebe ctx$qualidade (dpi, formato) quando a galeria pede a versão de publicação.
• Bifurcar: B copia o card selecionado e tudo o que vem depois dele, pendurado nas mesmas entradas, e abre os params da cópia para mudar a decisão. Os ramos levam selo (⑂ A, ⑂ B…). Params a jusante ficam espelhados entre gêmeos, exceto no card onde a decisão difere; clicar no selo de uma cópia a desliga do espelhamento. Selecionar um card acende os gêmeos, e a Vista (P) mostra os ramos lado a lado com a linha do que difere. Ops add_ramo, remove_ramo e ligar_ramo (cosméticas), em ui.ramos. O espelhamento é do editor: um set pelo trama-agente ou pelo MCP muda só o card nomeado.

trama 0.5.13

• Exportar em Quarto não falha mais com "Character encoding must be UTF-8, Latin-1 or bytes" quando uma referência de coleção instalada tem acento sem marca de encoding (ex.: Banzatto & Kronka, Experimentação agrícola).

trama 0.5.12

• tr_mcp(): servidor MCP por stdio com os verbos do trama-agente como tools (abrir, estado, catalogo, explicar, adicionar, ajustar, ligar, remover, resultado, desfazer, validar). Sobe o editor em segundo plano quando não há um aberto e devolve gráficos como imagem. Registro de uma linha: claude mcp add trama -- Rscript -e "trama::tr_mcp()".

trama 0.5.11

• tr_node_raiox(node): percorre a função do bloco e as funções internas do mesmo pacote e devolve as chamadas a outros pacotes (stats::aov(...), lmerTest::lmer(...)), com o código, o arquivo e a linha. O site usa isso na seção Implementação de cada página de bloco, para mostrar onde a conta de fato é feita.

trama 0.5.10

• Saídas nomeadas: duplo clique no rótulo de uma saída dá a ela um nome; o card mostra o nome e toda entrada ligada mostra porta ← nome. Fica em ui.saidas do documento (op set_saida, cosmética: não muda resultado), acompanha desfazer, cópia, duplicação e templates.
• A ajuda do bloco (F1) abre num modal com índice das seções, no lugar do painel lateral. O Markdown da ajuda passa pelo mesmo renderizador das notas: tabelas, ###, listas numeradas, links e itálico deixam de sair crus, e aspas não aparecem mais como ".

trama 0.5.9

• tr_type(tema = TRUE): o preview do tipo é um gráfico que segue o tema padrão do projeto. O padrão entra na chave das saídas desse tipo (trocar o tema redesenha o card) e vale como "padrão" enquanto o preview roda. Antes, o card de uma série, decomposição, PCA etc. ficava no tema embutido escuro num projeto claro.

trama 0.5.8

• tr_project() numa pasta sem trama.json passa a criar o manifesto. Antes o projeto abria, mas salvar um tema falhava com "lexical error: invalid char in json text".

trama 0.5.7

• Editor: tema papel (preto no branco, sem relevo, sombra nem cor de categoria) para imprimir ou projetar sem cor. Escolhido no menu "…" ou em Configurações › Aparência do editor; vale também para os PNG dos frames. Layout e posição dos cards não mudam.
• PNG dos frames: as setas das portas voltam à imagem (os fios terminavam no ar, a alguns pixels do card) e a exportação não falha mais quando algum card tem coluna vazia com sugestão ("não foi possível exportar").

trama 0.5.6

• Editor: os fios entre cards passam a ser roteados em ângulo reto por um roteador que enxerga todos os cards (nenhum fio atravessa um bloco que não é a origem nem o destino) e separa em faixas paralelas os fios que dividem o mesmo corredor. Fio sem rota possível volta ao traçado anterior.

trama 0.5.5

• Editor: grupos (Ctrl+G agrupa, Ctrl+Alt+G desagrupa; gravados no fluxo em ui.grupos, ops add_grupo/remove_grupo), empilhar na vertical (V) e na horizontal (H), alinhar por passos com Ctrl+setas, espaçar igualmente, e menu de contexto no vazio do canvas. O frame da seleção passa a Ctrl+Shift+G; a ajuda vai para F1, a vista em tela cheia para P e os parâmetros para Shift+P.

trama 0.5.4

• Robustez do motor: o fluxo é gravado de forma atômica (crash no autosave não trunca mais flows/main.json); worker que morre (falta de memória, daemon morto) não vira erro cacheado; fingerprint() que lança invalida só o nó em vez de abortar o plano; handle sem objeto não conta como cache; o GC não apaga o tmp/ de workers em voo; uma cadeia de pump por run; preview parcial com caminho relativo (gráfico em branco durante o run); arquivo de progresso atômico.
• A impressão digital das funções segue helpers de outras coleções do registro (inclusive pkg::nome): mudar um helper de trama.models invalida o cache dos blocos de trama.experiments que o usam.
• Proveniência: cada handle registra a versão do R e de cada pacote de coleção que o produziu; tr_provenance(projeto) lista isso por nó.
• O Quarto exportado ganha a seção "Referências dos métodos", com as tr_ref dos blocos usados no fluxo.
• Editor: limite de erro por card (renderer que lança não derruba a página), aviso quando o Shiny não conecta, refazer (Ctrl+Shift+Z / Ctrl+Y), revisão das ops em voo (duas edições rápidas não são mais recusadas) e cards memoizados.
• trama-agente: erros sempre em JSON; catalog, explain e validate funcionam sem o editor aberto.
• O componente de um renderer recebe entradas: os handles que chegam nas portas de entrada do card (os mesmos do ctx dos widgets). O núcleo só repassa; é o que deixa uma coleção comparar a saída com a entrada — o data/table mostra "−12 linhas".

trama 0.5.3

• Widget de coleção recebe ctx também fora do kind cols: { id, valores, entradas } — o nó, os valores dos params e o handle que chega em cada porta. É o que deixa um widget (o editor SQL de trama.sql) saber o que está ligado no bloco sem o núcleo saber o que há no handle.
• tr_param_int(vazio = , example = ): vazio é o valor que o campo vazio representa (o "automático"). Com o param nesse valor, o campo aparece vazio com example em cinza, e apagar o número volta a ele em vez de acusar "obrigatório".

trama 0.5.2

• Exportar como Quarto gera um relatório, e não um bloco de código: um chunk por card, os frames como seções (na ordem de slide), as notas como texto, as saídas que nenhum fio consome à mostra, cabeçalho com sumário, código recolhível e HTML autocontido, versões dos pacotes no início e sessionInfo() no fim.
• O script exportado (R ou Quarto) nomeia as variáveis pelo rótulo do card (correlograma_acf, não o id), trata nó de várias saídas como uma variável lida por porta (ajuste$out) e passa os params EFETIVOS, como o executor: antes, um param não tocado caía no default da função, que pode diferir do default do bloco. Params iguais ao default literal da função são omitidos; o tema vira uma variável só no topo.
• tr_type(report = ): função exportada que mostra o valor no relatório exportado (uma série vira o gráfico dela). Sem ela, o relatório imprime o objeto.
• Exportar uma imagem de frame não pinta mais as ligações de preto.

trama 0.5.1

• options(trama.encerrar_ao_fechar = TRUE) faz o processo do editor encerrar alguns segundos depois de a última janela fechar. O launcher liga essa opção ao abrir um projeto.
• trama-agente: catalog --busca termo devolve só os blocos que casam (a mesma busca do "+"), em vez do catálogo inteiro; toda edição aceita --wait N, que espera o fluxo rodar e devolve em efeito o status dos nós tocados e dos que estão abaixo deles. Nó blocked (em state, result e efeito) traz causa: os ancestrais que falharam.

trama 0.5.0

• Catálogo de bases públicas. As coleções declaram bases de pacotes R (tr_collection(datasets = list(tr_dataset(...)))), só com metadados: fonte, tamanho, temas e licença. O botão "Bases públicas" da barra abre um modal com busca, filtro por tema e pacote, prévia, instalação do pacote em um R à parte (com confirmação), "Baixar CSV" e "Adicionar ao canvas", que insere o bloco declarado pela base. Novas funções: tr_dataset(), tr_datasets() e tr_dataset_load().
• Colar um link sozinho no canvas cria um bloco "Ler dados" com ele.

trama 0.4.1

• O aviso "não existe na entrada" do campo de colunas (sumidas, em colunas.js) não acusa mais valores escritos como seletor (starts_with("x"), a:c): quem valida é o R. Necessário para o data/select da trama.data 0.3.0, que passa a aceitar seletores.

trama 0.4.0

• Próximo bloco como fantasmas. O "+" do card, ou soltar um conector no vazio, abre uma busca e até três miniaturas translúcidas dos blocos sugeridos, ligadas à porta por uma conexão tracejada. Digitar filtra com busca aproximada (sem acento, início de palavra, letras em sequência) entre todos os blocos compatíveis. Enter/Tab aceita, setas navegam, Esc fecha. Preferência "Sugestões" liga ou desliga as três iniciais; a busca vale sempre. Substitui o popover de tagzinhas.
• Canal de controle para agentes. tr_app() sobe um servidor em 127.0.0.1, protegido por token (.trama/control-agente.json), por onde um agente lê e edita o fluxo aberto na tela. O CLI trama-agente (inst/bin/, ou tr_cli()) tem state, catalog, add, link, set, rm, op, apply, result e undo. As edições passam pelo mesmo caminho do editor: revisão, undo, autosave e re-execução. Desligue com options(trama.controle = FALSE).
• httpuv passa a ser Imports (já vinha com o shiny); curl entra em Suggests, usado só pelo CLI.