> ## Documentation Index
> Fetch the complete documentation index at: https://docs.doglytdc.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Traduções, ícones e validação

> Idiomas do Painel Dev, a lista de ícones e como validar a pasta painel-dev/ antes de aplicar.

## Traduções

Um arquivo por idioma em `painel-dev/traducoes/`. O nome é o código do idioma: `pt-BR.json`, `en.json`, `es.json`, `fr.json`, `ja.json`…

```json painel-dev/traducoes/en.json theme={null}
{
  "@lang": "English",
  "nav.sales": "Sales",
  "aviso.titulo": "Notices",
  "comum.salvar": "Save"
}
```

| Regra | Limite |
| - | - |
| `@lang` | Nome do idioma, até 30 caracteres |
| Chave | Minúsculas, números, `_`, `.` e `-`, até 80 |
| Texto | Até 400 caracteres |
| Textos por idioma | 800 |
| Idiomas | 10 |

### Usar uma tradução

Escreva `@t.chave` em qualquer texto: `label`, `group`, `welcome`, títulos e parágrafos da tela.

```html theme={null}
<h2>@t.aviso.titulo</h2>
<dt-button action="@save" label="@t.comum.salvar" />
```

O texto final segue esta ordem: idioma escolhido → Português (BR) → a própria chave.

### Idioma extra

Crie o arquivo (ex.: `fr.json` com `"@lang": "Français"`). Ele aparece sozinho na escolha de idioma do Painel Dev. A tela **Traduções** mostra, para cada idioma, as chaves que faltam em relação ao Português (BR).

## Ícones

Use os nomes abaixo em `icon` (menu, `dt-stat`, `dt-alert`, `dt-button`). Outro nome dá erro.

```text theme={null}
home code rocket users user wallet bot webhook server settings languages monitor globe key lock shield
database activity chart bar-chart pie-chart trending bell mail message megaphone calendar clock history star
heart flag tag ticket gift shopping-bag credit coins percent package box layers folder file book bookmark
list grid table sliders palette brush image video music camera zap sparkles wand target trophy gamepad
terminal cpu cloud download upload link search filter refresh play pause power eye trash plus check
alert info help map pin phone smile crown graduation briefcase store truck puzzle
```

A mesma lista fica em `painel-dev/icones.md`, para a IA.

## Validação

**1. Validar uma branch**

`dev_panel_validate` com `script_id` e `ref` (branch ou commit). Não aplica nada.

**2. Ler os erros**

Cada erro tem `path` (arquivo) e `message` (motivo).

**3. Aplicar**

Merge na main. `dev_panel_get` mostra `applied_sha` (versão em uso) e os erros da última conferida.

### Erros comuns

As mensagens aparecem como abaixo.

| Mensagem | Como resolver |
| - | - |
| `@nav.id deve ser "cupons"` | O `id` do `@nav` precisa ser igual ao nome da pasta |
| `ícone desconhecido "x"` | Use um nome da lista acima |
| `posição deve ser inteiro de 1 a 999` | Ex.: `"position": 45`, sem aspas |
| `funções do menu não podem ser apagadas aqui` | Tire `hidden`/`remove`/`delete`; só ícone, nome, grupo e posição mudam |
| `bind="x" não está em connect.keys` | Adicione `x` em `keys` ou troque o `bind` |
| `Coleções são só leitura` | Use só `dt-table`, `dt-stat` e `@reload` |
| `@call só funciona com connect.type "function"` | Troque a ligação ou use `@save` |
| `<dt-option> só dentro de <dt-select>` | Coloque as opções dentro da caixa |
| `Campo não editável no Início` | No `inicio.json` só existem `welcome`, `cards` e `shortcuts` |

> [!WARNING]
>
> Com qualquer erro, o painel continua na última versão válida. Corrija, valide de novo e faça merge.

## Pelo MCP

| Ferramenta | O que faz |
| - | - |
| `dev_panel_get` | Painel em uso, versão aplicada e erros |
| `dev_panel_validate` | Valida uma branch ou commit |
| `dev_panel_function_create` | Cria a pasta de uma função e valida |
| `get_dev_panel_guide` | Guia completo para a IA |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.