lang-typst

Fornece padrões de engenharia e tipografia digital moderna usando Typst. Cobre sintaxe de marcação, funções customizadas, criação de templates reutilizáveis, regras de exibição (show/set rules), matem

SKILL.md

GitHub

Habilidade de IA: Engenharia de Typst (Typst Specialist)

Esta skill orienta a inteligência artificial a atuar como especialista na linguagem e sistema de diagramação Typst, focando na criação de documentos acadêmicos, relatórios técnicos, apresentações e artigos de alta qualidade tipográfica com sintaxe limpa, código expressivo e alto desempenho de compilação.


🧭 Diretrizes de Desenvolvimento em Typst

Ao atuar nesta skill, aplique rigorosamente os seguintes padrões:

1. Configuração de Layout e Regras set e show

  • Separação de Conteúdo e Estilo: Defina as regras de estilo globais usando instruções #set no início do documento ou dentro de um template.
  • Transformação de Seletores (show): Utilize regras #show para customizar a aparência de elementos específicos (como títulos, links, blocos de código ou tabelas) de forma declarativa.
  • Configuração Inicial de Página:
    #set page(
      paper: "a4",
      margin: (x: 2cm, top: 2.5cm, bottom: 2.5cm),
      header: align(right)[_Relatório Técnico_],
      footer: [
        #align(center)[#counter(page).display("1 / 1", both: true)]
      ]
    )
    #set text(font: "Liberation Serif", size: 11pt, lang: "pt")
    

2. Modos de Operação (Text, Math e Code)

  • Modo Texto: Escrita natural com sintaxe leve (*negrito*, _itálico_, = Título).
  • Modo Matemática ($): Utilize blocos inline $ x^2 $ ou blocos em destaque $ sum_(i=1)^n i = (n(n+1))/2 $.
  • Modo Código (#): Todo comando ou lógica em Typst começa com #. Bloco de código em múltiplas linhas utiliza #{ ... }.

3. Funções e Modularidade

  • Templates Reutilizáveis: Exporte uma função principal de template que recebe parâmetros estruturados (título, autores, resumo, corpo) e aplica as regras de layout via #show: doc => template(doc).
  • Parâmetros com Nome: Dê preferência a parâmetros nomeados com valores padrão razoáveis nas funções customizadas.

4. Tabelas, Figuras e Layout Idiomático

  • Tabelas com table: Utilize a nova API de tabela com table.header e alinhamento explicito por coluna:
    #table(
      columns: (1fr, 2fr, 1fr),
      align: (left, left, center),
      stroke: 0.5pt + luma(150),
      table.header([*ID*], [*Descrição*], [*Status*]),
      [01], [Atualização de firmware], [OK],
      [02], [Verificação de integridade], [Pendente]
    )
    
  • Quadros e Notificações (Callouts): Crie blocos visuais estilizados usando block com bordas arredondadas e preenchimento sutil.

5. Gestão de Bibliografia e Pacotes

  • Bibliografias Nativas: Use #bibliography("works.bib", style: "ieee") para integração transparente com arquivos .bib ou .yml (Hayagriva).
  • Pacotes do Typst Universe: Importe pacotes oficiais com a sintaxe #import "@preview/pacote:versao".

🧰 Padrões de Código Recomendados

Template Profissional de Relatório / Artigo Técnico

// template.typst
#let project(
  title: "",
  authors: (),
  abstract: none,
  logo: none,
  body
) = {
  // Configuração global de página
  set page(
    paper: "a4",
    margin: (x: 2.5cm, y: 3cm),
    numbering: "1",
  )
  
  // Configuração de tipografia
  set text(font: "DejaVu Serif", size: 11pt, lang: "pt", region: "BR")
  set par(justify: true, leading: 0.65em)
  set heading(numbering: "1.1")

  // Personalização visual dos títulos
  show heading: it => [
    #v(0.5em)
    #text(fill: rgb("#1a365d"), weight: "bold")[#it]
    #v(0.3em)
  ]

  // Cabeçalho / Capa resumida
  align(center)[
    #if logo != none {
      image(logo, width: 25%)
      v(1em)
    }
    #text(size: 20pt, weight: "bold", fill: rgb("#1a365d"))[#title]
    #v(1em)
    #grid(
      columns: (1fr,) * calc.min(authors.len(), 3),
      gutter: 1em,
      ..authors.map(author => align(center)[
        #text(weight: "medium")[#author.name] \
        #text(size: 9pt, fill: luma(100))[#author.email]
      ])
    )
    #v(1.5em)
  ]

  // Resumo (se houver)
  if abstract != none {
    rect(
      width: 100%,
      fill: rgb("#f7fafc"),
      inset: 12pt,
      radius: 4pt,
      stroke: 0.5pt + rgb("#e2e8f0")
    )[
      #text(weight: "bold", fill: rgb("#2d3748"))[Resumo] \
      #v(0.3em)
      #abstract
    ]
    #v(1.5em)
  }

  // Corpo do Documento
  body
}

Exemplo de Uso do Template com Blocos e Matemática

#import "template.typst": project

#show: doc => project(
  title: "Análise de Desempenho de Algoritmos Distribuídos",
  authors: (
    (name: "Dandara Gabriel", email: "dandara@example.com"),
    (name: "Alex Silva", email: "alex@example.com")
  ),
  abstract: [
    Este documento apresenta uma avaliação comparativa de throughput e latência entre arquiteturas de mensageria assíncrona operando sob alta carga.
  ],
  doc
)

= Introdução

A escalabilidade de sistemas distribuídos modernos depende diretamente do padrão de comunicação adotado entre os nós receptores e emissores.

#let callout(title: "Nota", body, color: blue) = {
  block(
    fill: color.lighten(90%),
    stroke: (left: 4pt + color),
    inset: 10pt,
    radius: (right: 4pt),
    width: 100%,
    [
      #text(weight: "bold", fill: color.darken(20%))[#title] \
      #body
    ]
  )
}

#callout(title: "Importante", color: rgb("#2b6cb0"))[
  Certifique-se de que os nós do cluster estejam sincronizados via protocolo NTP antes de iniciar os testes de carga.
]

= Formulacão Matemática

O tempo médio de resposta $T(n)$ para um sistema de fila com $n$ requisições concorrentes é modelado pela equação:

$ T(n) = sum_(k=1)^n (lambda_k / (mu_k - lambda_k)) + float("overhead") $

Onde $lambda_k$ representa a taxa de chegada e $mu_k$ a taxa de serviço do canal $k$.

= Resultados Experimentais

#figure(
  table(
    columns: (1fr, 1.5fr, 1fr),
    align: (center, left, right),
    stroke: 0.5pt + luma(180),
    table.header([*Métrica*], [*Algoritmo*], [*Valor Médio*]),
    [Throughput], [Event-Driven Reactive], [45.200 req/s],
    [Latência p99], [Event-Driven Reactive], [1.2 ms],
    [Throughput], [Blocking I/O Standard], [12.800 req/s],
  ),
  caption: [Comparativo de Desempenho entre Arquiteturas]
)

🔒 Questões de Segurança e Práticas Seguras

  • Sandbox Escaping: Configure o compilador do Typst no modo restrito (sandbox ativo) para prevenir operações arbitrárias de leitura de arquivos locais ou caminhos de rede não autorizados.
  • Negação de Serviço (DoS): Otimize laços, funções recursivas e regras de formatação dinâmica para evitar que scripts maliciosos induzam recursão infinita e consumam toda a CPU do servidor.