> ## 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.

# Traducciones, iconos y validación

> Idiomas del Panel Dev, la lista de iconos y cómo validar la carpeta painel-dev/ antes de aplicarla.

## Traducciones

Un archivo por idioma en `painel-dev/traducoes/`. El nombre es el código del idioma: `pt-BR.json`, `en.json`, `es.json`, `fr.json`, `ja.json`…

```json painel-dev/traducoes/es.json theme={null}
{
  "@lang": "Español",
  "nav.sales": "Ventas",
  "aviso.titulo": "Avisos",
  "comum.salvar": "Guardar"
}
```

| Regla | Límite |
| - | - |
| `@lang` | Nombre del idioma, hasta 30 caracteres |
| Clave | Minúsculas, números, `_`, `.` y `-`, hasta 80 |
| Texto | Hasta 400 caracteres |
| Textos por idioma | 800 |
| Idiomas | 10 |

### Usar una traducción

Escribe `@t.clave` en cualquier texto: `label`, `group`, `welcome`, títulos y párrafos de la pantalla.

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

El texto final sigue este orden: idioma elegido → Portugués (BR) → la propia clave.

### Idioma extra

Crea el archivo (ej.: `fr.json` con `"@lang": "Français"`). Aparece solo en la elección de idioma del Panel Dev. La pantalla **Traducciones** muestra, para cada idioma, las claves que faltan respecto al Portugués (BR).

## Iconos

Usa los nombres de abajo en `icon` (menú, `dt-stat`, `dt-alert`, `dt-button`). Otro nombre da error.

```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
```

La misma lista está en `painel-dev/icones.md`, para la IA.

## Validación

**1. Validar una rama**

`dev_panel_validate` con `script_id` y `ref` (rama o commit). No aplica nada.

**2. Leer los errores**

Cada error tiene `path` (archivo) y `message` (motivo).

**3. Aplicar**

Merge en main. `dev_panel_get` muestra `applied_sha` (versión en uso) y los errores de la última revisión.

### Errores comunes

Los mensajes del validador están en portugués; la tabla los muestra tal como aparecen.

| Mensaje | Cómo resolverlo |
| - | - |
| `@nav.id deve ser "cupons"` | El `id` de `@nav` tiene que ser igual al nombre de la carpeta |
| `ícone desconhecido "x"` | Usa un nombre de la lista de arriba |
| `posição deve ser inteiro de 1 a 999` | Ej.: `"position": 45`, sin comillas |
| `funções do menu não podem ser apagadas aqui` | Quita `hidden`/`remove`/`delete`; solo cambian icono, nombre, grupo y posición |
| `bind="x" não está em connect.keys` | Agrega `x` a `keys` o cambia el `bind` |
| `Coleções são só leitura` | Usa solo `dt-table`, `dt-stat` y `@reload` |
| `@call só funciona com connect.type "function"` | Cambia la conexión o usa `@save` |
| `<dt-option> só dentro de <dt-select>` | Pon las opciones dentro de la caja |
| `Campo não editável no Início` | `inicio.json` solo tiene `welcome`, `cards` y `shortcuts` |

> [!WARNING]
>
> Con cualquier error, el panel sigue en la última versión válida. Corrige, valida de nuevo y haz merge.

## Por el MCP

| Herramienta | Qué hace |
| - | - |
| `dev_panel_get` | Panel en uso, versión aplicada y errores |
| `dev_panel_validate` | Valida una rama o commit |
| `dev_panel_function_create` | Crea la carpeta de una función y valida |
| `get_dev_panel_guide` | Guía completa para la IA |


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