Transform - JSON → TOON

TOON (Token-Oriented Object Notation) é um formato de texto para representar os mesmos dados de um JSON, pensado para ocupar menos tokens quando esse texto é enviado dentro do prompt de um modelo de linguagem (LLM). Tokens são a unidade que serviços como o ChatGPT ou o Claude cobram e limitam — quanto menos tokens um prompt usa, mais barato ele sai e mais espaço sobra para o resto da conversa.

O JSON gasta uma boa parte desses tokens em pontuação que se repete: chaves, colchetes, aspas em volta de cada texto e, em uma lista de objetos parecidos, o nome de cada campo copiado em cada item. O TOON remove essa repetição.

A ideia central: quando uma lista tem vários objetos com os mesmos campos, o TOON escreve os nomes dos campos uma única vez, em um cabeçalho, e cada item vira uma linha só com os valores, separados por vírgula, como uma tabela CSV. Para objetos aninhados, ele usa indentação, no estilo do YAML.

{
  "users": [
    { "id": 1, "name": "Ana", "role": "admin" },
    { "id": 2, "name": "Beto", "role": "user" },
    { "id": 3, "name": "Cátia", "role": "user" }
  ]
}

users[3]{id,name,role}:
  1,Ana,admin
  2,Beto,user
  3,Cátia,user

Neste exemplo, o JSON tem 167 caracteres e o TOON tem 66 — cerca de 60% menor (contagem de caracteres desta página, calculada com o conversor real; a economia de tokens de um LLM costuma ficar entre 30% e 60%, segundo a especificação do formato, variando com o tamanho e o formato dos dados).

• users[3] diz que a lista tem 3 itens — o modelo (e quem está lendo) sabe de antemão quantas linhas esperar, o que ajuda a conferir se algum item faltou.
• {id,name,role} é o cabeçalho: o nome de cada campo aparece uma vez só, não em cada item.
• Cada linha seguinte é um item, na mesma ordem dos campos do cabeçalho.

Nem todo JSON tem essa forma de tabela. Quando os itens de uma lista têm campos diferentes entre si, o TOON usa uma forma de lista simples (uma linha por item, sem tabela) — ainda uma conversão válida e sem perdas, só que com menos economia de tokens:

{
  "events": [
    { "type": "login", "userId": 1 },
    { "type": "purchase", "userId": 2, "amount": 49.9, "coupon": "PROMO10" },
    { "type": "logout", "userId": 1, "durationMin": 12 }
  ]
}

events[3]:
  - type: login
    userId: 1
  - type: purchase
    userId: 2
    amount: 49.9
    coupon: PROMO10
  - type: logout
    userId: 1
    durationMin: 12

• Vale a pena: listas grandes e uniformes (mesmos campos em todo item) dentro de um prompt para um LLM — resultados de busca, linhas de uma planilha, registros de um banco, histórico de eventos parecidos entre si.
• Ganho pequeno: dados muito aninhados, com poucos itens, ou com formato irregular entre os itens de uma lista.
• Não use: para se comunicar com uma API, salvar em banco de dados ou qualquer lugar que espera JSON de verdade — TOON serve para o texto dentro do prompt, não para substituir o JSON como formato de integração.

Aqui está a lista de usuários ativos:

users[3]{id,name,role}:
  1,Ana,admin
  2,Beto,user
  3,Cátia,user

Liste os usuários com papel "user".

1. Escolha JSON → TOON para comprimir um JSON antes de colar em um prompt, ou TOON → JSON para o caminho inverso (por exemplo, se um modelo respondeu em TOON e você quer o JSON de volta).
2. Cole o conteúdo no campo de entrada e clique em Transformar.
3. Em Opções, dá para trocar o separador das colunas (vírgula, tabulação ou barra vertical) — útil se os seus dados já usam vírgula dentro dos valores.

O Transform converte dados e código de um formato para outro sem sair do navegador. Cole um JSON e receba as interfaces TypeScript, o schema Zod ou o JSON Schema correspondentes; converta arquivos de configuração entre YAML, JSON e TOML; transforme CSS em classes Tailwind. Tudo é processado localmente, sem enviar o seu conteúdo para servidor algum.

1. Clique no seletor Transformação e escolha a conversão. Dá para buscar pelo nome, e as últimas usadas e as favoritas ficam à mão.
2. Cole o conteúdo no campo Input (ou use o botão Colar). Para JSON, o botão Formatar deixa o texto indentado.
3. Se a conversão tiver opções, como o nome do tipo raiz, ajuste-as no painel acima dos editores.
4. Clique em Transformar. O resultado aparece em Output, onde você pode copiar ou baixar o arquivo.

A conversão JSON → TypeScript lê a estrutura do JSON e gera uma interface para cada objeto, incluindo os objetos aninhados. Este é o resultado real da ferramenta para o JSON abaixo:

{
  "id": 1,
  "nome": "Ana Souza",
  "email": "ana@exemplo.com",
  "ativo": true,
  "tags": ["admin", "beta"],
  "endereco": { "cidade": "São Paulo", "cep": "01310-100" }
}

interface Endereco {
  cidade: string;
  cep: string;
}

interface Usuario {
  id: number;
  nome: string;
  email: string;
  ativo: boolean;
  tags: string[];
  endereco: Endereco;
}

Precisa validar os dados em tempo de execução, e não só tipá-los? A mesma entrada pode virar um schema Zod escolhendo JSON → Zod no seletor.