# 🦷 React Advanced Odontogram
[](https://github.com/ZoliQua/React-Odontogram-Modul/releases)
[](https://github.com/ZoliQua/React-Odontogram-Modul)
[](https://www.npmjs.com/package/react-advanced-odontogram)
[](https://github.com/ZoliQua/React-Odontogram-Modul/blob/main/LICENSE)
[](https://doi.org/10.5281/zenodo.21156787)
[](https://reactjs.org/)
[](https://www.typescriptlang.org/)
---
> 🌐 **Languages:** 🇬🇧 [English](README-en.md) | 🇪🇸 [Español](README-es.md) | 🇩🇪 [Deutsch](README-de.md) | 🇭🇺 [Magyar](README-hu.md) | 🇮🇹 [Italiano](README-it.md) | 🇸🇰 [Slovenčina](README-sk.md) | 🇵🇱 [Polski](README-pl.md) | 🇷🇺 [Русский](README-ru.md) | 🇧🇷 [Português (BR)](README-pt-br.md) | 🇸🇦 [العربية](README-ar.md) | 🇨🇳 [简体中文](README-zh.md) | 🇫🇷 [Français](README-fr.md)
---
## 🇧🇷 Português (Brasil)
### 📋 Visão geral
Este projeto é um editor de odontograma interativo, executado no navegador, que agiliza o registro dentário com uma interface limpa. Ele renderiza modelos de dentes em SVG por camadas para representar restaurações, cáries, estado endodôntico, mobilidade e outros detalhes clínicos, oferecendo seleção múltipla, filtros de seleção e predefinições de estado prontas para uso.
---
🔗 **URL de teste:** https://react-odontogram-modul.vercel.app/
---
### 📦 Usar como pacote npm
O odontograma é distribuído como uma biblioteca de componentes React autocontida no npm:
[`react-advanced-odontogram`](https://www.npmjs.com/package/react-advanced-odontogram).
#### Requisitos
- **React 18 ou 19** (declarado como peer dependency — fornecido pela sua aplicação).
- Um **bundler** que entenda o campo `exports` e ESM: Vite, webpack 5, Next.js, Rollup, esbuild, Parcel. O pacote é **somente ESM**.
- Node **≥ 18** para as ferramentas.
#### Instalação
```bash
npm install react-advanced-odontogram react react-dom
```
#### Uso básico
Renderize o `OdontogramShell` e importe a folha de estilos **uma única vez** em qualquer lugar da sua aplicação:
```tsx
import { OdontogramShell } from "react-advanced-odontogram";
import "react-advanced-odontogram/style.css";
export function Chart() {
return (
);
}
```
#### Props do componente
`OdontogramShell` é um componente controlado. As props mais comuns:
| Prop | Tipo | Padrão | Descrição |
|------|------|---------|-------------|
| `language` | `Language` | `"hu"` | Idioma da interface (`hu`/`en`/`de`/`es`/`it`/`sk`/`pl`/`ru`/`pt-br`/`ar`/`zh`). |
| `numberingSystem` | `"FDI" \| "Universal" \| "Palmer"` | `"FDI"` | Sistema de numeração dentária. |
| `darkMode` | `boolean` | `false` | Alterna o tema escuro. |
| `readOnly` | `boolean` | `false` | Desativa toda a edição (somente visualização). |
| `themeConfig` | `OdontogramThemeConfig` | — | Sobrescreve as variáveis CSS do tema (`--odon-*`). |
| `plugins` | `OdontogramPlugin[]` | — | Registra plugins de estado personalizados / camadas extras. |
| `enableNotes` | `boolean` | `false` | Habilita anotações por dente. |
| `enableIcdas` | `boolean` | `false` | Habilita a pontuação de cárie ICDAS II. |
| `onLanguageChange` / `onNumberingChange` / `onDarkModeChange` | `(value) => void` | — | Disparado quando o usuário altera a configuração pela interface. |
Props de nível de detalhe mais granulares (`pulpDetailLevel`, `secondaryCariesMode`, `rootCariesMode`, `radiographicDepthMode`, `wearDetailLevel`, `discolorationDetailLevel`, `surfaceNotation`, `showStatusCard`, `showOrthoCard`) também são aceitas — veja os tipos `.d.ts` fornecidos para a lista completa e tipada.
#### API pública (exportações nomeadas)
`OdontogramShell` é tanto a exportação padrão quanto uma exportação nomeada. A API imperativa de estado, o componente independente `PerioChart`, o tour guiado e todos os tipos públicos são exportações nomeadas do mesmo ponto de entrada:
```ts
import {
OdontogramShell, // também a exportação padrão
PerioChart, // componente independente de gráfico periodontal
// ler estado
getOdontogramSummary,
getToothStateSummary,
onStateChange, // inscrever-se em mudanças de estado
// exportar / importar
exportFhir, // pacote HL7 FHIR R4
exportSvg, exportImage, // exportação vetorial / raster do gráfico
setImportFormat,
// controle
setReadOnly, getReadOnly,
clearSelection,
registerPlugins, setPluginState, getPluginState,
startIntroTour, // inicia o tour de integração
// …e muitas outras funções de configuração setX/getX
} from "react-advanced-odontogram";
```
A superfície completa (≈ 44 funções + tipos como `OdontogramSummary`, `OdontogramThemeConfig`, `OdontogramPlugin`, `FhirExportOptions`, `PerioViewMode`, …) está totalmente tipada nas declarações incluídas.
#### Usando com Next.js (App Router)
O componente é somente client-side, então renderize-o a partir de um Client Component:
```tsx
"use client";
import { OdontogramShell } from "react-advanced-odontogram";
import "react-advanced-odontogram/style.css";
export default function OdontogramClient() {
return ;
}
```
Ou carregue-o com um import dinâmico somente client-side: `dynamic(() => import("./OdontogramClient"), { ssr: false })`.
#### Notas importantes e limitações atuais
- **Somente ESM** — o pacote publica um único módulo ES (`dist/odontogram.js`) além de um ponto de entrada de declaração de tipos (`dist/index.d.ts`). Ele é voltado para a resolução de módulos de bundlers; não há build CommonJS.
- **A folha de estilos é separada** — você **deve** importar `react-advanced-odontogram/style.css` uma vez; ela não é injetada automaticamente. A estilização é CSS global escopado sob `.odontogram-root` e controlado pelas variáveis CSS `--odon-*`.
- **SSR / somente client-side** — o componente lê o DOM na montagem (`document`), portanto deve rodar no navegador. Em frameworks com SSR, renderize-o em um Client Component (`"use client"`) ou via um import dinâmico somente client-side.
- **Recursos autocontidos** — os SVGs de dentes e ícones são embutidos (inline) no bundle JavaScript em tempo de build; **não há busca de recursos em tempo de execução** a configurar e nada extra para copiar para sua pasta pública.
- **Uma instância por página** — o estado do engine é atualmente um singleton em nível de módulo, então renderizar duas instâncias de `` na mesma página faria com que compartilhassem o estado de um único gráfico. O suporte a múltiplas instâncias está planejado para uma versão futura.
---
### ✨ Principais recursos
- 🖱️ Seleção rápida e seleção múltipla (CMD/CTRL + clique)
- 🦷 Tipos de dente: permanente, decíduo (de leite), implante, subgengival, ausente
- 🦷 Substrato dentário (ortogonal a qualquer restauração): natural, resto radicular (radix), fraturado, preparado para coroa
- 👑 Restaurações por tipo × material: coroa / inlay / onlay / faceta / ponte em e.max, ouro, gradia, zircônia, metal, metalocerâmica, telescópica ou provisória (o onlay está disponível apenas em vista oclusal) — selecionadas em um único seletor combinado de poucos cliques "Fix: Coroa – …"; coroas `metal` legadas migram automaticamente para `metal-ceramic` (metalocerâmica); implantes usam o mesmo modelo tipo × material, composto com uma camada de conector de implante. O seletor é filtrado pelo tipo de dente: um implante oferece apenas coroa/ponte (além das cinco opções de fixação, abaixo); um dente ausente/espaço oferece apenas um pôntico de ponte (além de prótese parcial/total removível); um substrato `radix` oculta totalmente o controle de restauração (nenhuma restauração pode ser registrada em um resto radicular)
- 🦿 Prótese removível/de encaixe no eixo dedicado `prosthesis` (entradas "Kivehető:" no seletor combinado): cicatrizador do implante, locator, locator com sobredentadura, barra, barra com sobredentadura; prótese parcial ou total removível suportada por dentes
- 🌉 Os dentes de ponte renderizam tanto a capa da coroa quanto o conector do vão (saddle); um overlay de vão de ponte multi-dente renderiza um conector único e contínuo, sensível ao arco, ao longo de dentes de ponte consecutivos (pônticos + pilares) e dos espaços entre eles (as arcadas superior e inferior usam geometria de vão espelhada, mantendo o conector alinhado em ambas as arcadas), incluído na exportação PNG/JPG/SVG; aplicar uma ponte por uma predefinição de Estados recalcula o overlay imediatamente
- 🔍 Registro de cárie em 6 faces: mesial, distal, vestibular, lingual, oclusal, subcoroa
- 🪥 Materiais de restauração por face: amálgama, resina composta, ionômero de vidro (GIC), provisória
- 🏥 Um seletor unificado de "Estado pulpar/endodôntico" (agrupado: polpa vital vs. tratada/endo): os estados endodônticos (obturação medicamentosa, obturação de canal, obturação de canal incompleta, pino de fibra de vidro, pino metálico) e o diagnóstico pulpar AAE (`pulpDx`: normal / pulpite reversível / irreversível / necrose) são mutuamente exclusivos — um dente tratado endodonticamente (`endo` definido) não pode também ter um diagnóstico de polpa vital; ao tratar, `pulpDx` é normalizado para `normal` e o glifo de polpa doente é suprimido. A pulpite reversível renderiza um glifo de polpa reduzido. Um ajuste opcional de 3 níveis de detalhe pulpar (`pulpDetailLevel`: simple / AAE / latim prático) exibe 9 subtipos em latim prático (pulpa sana … gangraena pulpae) via `pulpLatin`; a resecção e o pino parapulpar continuam sendo indicadores especiais separados
- 🦴 O diagnóstico apical (`apicalDx`: periodontite apical sintomática/assintomática, abscesso apical agudo/crônico, osteíte condensante) determina diretamente o glifo periapical; um qualificador de subtipo de lesão granuloma/cisto é exibido apenas sob periodontite apical sintomática/assintomática (o subtipo redundante "abscesso" foi removido — já é coberto pelo diagnóstico apical)
- 🩹 Cartão unificado "Raiz e periodonto" (uma única seção recolhível para achados radiculares/periapicais e periodontais)
- ⚕️ Modificações: inflamação periapical (exibida apenas em dentes ausentes/alvéolo de extração; oculta em dentes presentes, onde apenas `apicalDx` determina o glifo periapical, e em implantes, onde `periImplant` cobre isso), doença periodontal, graus de mobilidade (M1/M2/M3, ocultos em implantes)
- 🦷🔩 Estado peri-implantar (`periImplant`: `none` / `mucositis` / `peri-implantitis-mild` / `peri-implantitis-moderate` / `peri-implantitis-severe`) — estadiamento do World Workshop de 2018, exibido como um seletor dedicado em implantes; a mucosite reutiliza o glifo gengival periodontal, a peri-implantite adiciona uma camada gradual `peri-implant-bone-loss` (opacidade 0,4/0,7/1,0). Os implantes não renderizam mais o glifo de lesão periapical — sua inflamação passa a ser expressa por esse eixo — e as caixas de seleção de modificadores periodontais ficam ocultas em implantes (a rotulagem improvisada da caixa "Peri-implantite" foi aposentada)
- 🏷️ Indicadores especiais: coroa necessária, substituição de coroa necessária, espaço fechado, extração planejada, selante de fissura, perda de ponto de contato
- 👁️ Alternância de visibilidade da vista oclusal, dos sisos, do osso e da polpa
- 🔢 12 filtros de seleção (todos, presentes, permanentes, decíduos, implantes, ausentes, superiores/inferiores, anteriores/molares)
- 📊 Predefinições de estado prontas (redefinir, dentição decídua, dentição mista, edêntulo)
- 📦 34 modelos de restauração predefinidos (pontes, próteses removíveis, próteses sobre barra com implantes)
- 💾 Exportação/importação de estado em JSON (versão 2.10; as importações continuam aceitando as versões legadas 1.4, 2.0, 2.1, 2.2, 2.3, 2.4, 2.5, 2.6, 2.7, 2.8 e 2.9 e são migradas automaticamente, com estados personalizados de plugins e anotações por dente)
- 🔗 Exportação HL7 FHIR R4 (Bundle de coleção com Observations por dente, codificação de dente ISO 3950 para dentição permanente, sistema de códigos local — mapeamento SNOMED CT planejado)
- ✚ Interface de seleção de faces em cruz/mais (B/M/O/D/L) para cáries e restaurações
- 🧱 Materiais de restauração por face (restaurações mistas, por exemplo amálgama vestibular + resina distal)
- 🖼️ Exportação da imagem do odontograma em PNG/JPG/SVG (para download; PNG/JPG rasterizados a partir do SVG vetorial)
- 🦷 Cárie/subcárie como uma máquina de estados por face: uma face cariada sem restauração é renderizada como cárie primária (opacidade em níveis ICDAS); assim que essa face tem uma restauração, ela é renderizada como cárie secundária (recorrente) (camada `subcaries-{surface}`, pontuada por CARS) — as duas nunca ficam ativas ao mesmo tempo na mesma face
- 🎯 Gravidade unificada por face (`cariesSeverity`, 0–6, substituindo os antigos campos separados de profundidade ICDAS e CARS): lida como profundidade ICDAS em uma face primária, como pontuação CARS nomeada (Hígido … Cavidade extensa) em uma recorrente, por meio de um popup contextual que mostra apenas a escala relevante para o estado atual da face
- 🌱 Cárie radicular (`rootCaries`: none / active / arrested / active-cavitated), que ativa a camada de ilustração dedicada de cárie radicular com opacidade determinada pela gravidade (active 0,5 / arrested 0,7 / active-cavitated opacidade total)
- 📡 Profundidade radiográfica da cárie (`radiographicDepth`: none / E1 / E2 / D1 / D2 / D3 por face), independente da escala visual de gravidade ICDAS/CARS, exibida como um emblema e sincronizada por meio de sua própria Observation FHIR
- 🎚️ Três configurações de granularidade de cárie (`secondaryCariesMode`, `rootCariesMode`, `radiographicDepthMode`) além de um alternador `cariesDepthEnabled`, que reduzem cada escala a uma visão de seletor mais simples sem perder o valor armazenado
- 🩹 Linha de resumo de subcárie no painel de restaurações: lista, abaixo dos controles de restauração, qualquer dente selecionado com cárie secundária e suas faces (ex.: "36 (O) tem subcárie na restauração.")
- 🪛 Defeitos de restauração por face (`fillingDefect`: none / marginal / fracture / wear) em restaurações diretas, independentes da cárie secundária — registrados por meio de um indicador por face no cartão de Restaurações (espelhando o indicador de profundidade de cárie, com sua lista de opções empilhada verticalmente), renderizados no odontograma e exibidos na dica (tooltip) e no resumo de restaurações de boca inteira com um rótulo explícito (ex.: "36 (O) – Defeito de restauração: O: marginal"), da mesma forma que a cárie secundária é rotulada na linha de Cárie; o cartão de Restaurações também exibe uma nota de dica para qualquer dente selecionado com um defeito de restauração registrado (ex.: "O dente 36 tem um defeito de restauração registrado."), em paralelo à nota de dica de subcárie já existente
- 🦷💥 Desgaste dentário tipificado por causa clínica e localização (`wearEdge`: none / attrition / erosion, incisal/oclusal; `wearCervical`: none / abrasion / abfraction / erosion, cervical) — substituindo os dois alternadores liga/desliga de desgaste por bruxismo; registrado por meio de dois menus suspensos na linha de desgaste, reaproveita a ilustração de desgaste já existente e é exibido na dica e em uma nova seção de resumo de boca inteira "Desgaste"
- 🎨 Descoloração dentária por causa (`discoloration`: none / tetracycline / fluorosis / nonvital / extrinsic / other) em dentes permanentes e decíduos — tinge a coroa natural exibida com uma cor representativa quando o dente não tem restauração e tem substrato natural; exibida na dica e em uma nova seção de resumo de boca inteira "Descoloração"; completa o conjunto de condições de superfície e estruturais junto com os defeitos de restauração e o desgaste
- ✏️ Os dentes anteriores (incisivos/caninos) rotulam sua face oclusal como "incisal" em toda a interface (seletor, popup, resumos); a chave de face armazenada permanece `occlusal`
- 🔤 Notação de face sensível à posição (Configurações → Detalhes do dente → "Notação de face", simples/completa, padrão completa): no modo completo, a letra e o rótulo da face de cárie/restauração seguem a anatomia do dente — oclusal → I/incisal em dentes anteriores, vestibular → L/labial em dentes anteriores, lingual → P/palatina em dentes superiores e L/lingual em dentes inferiores (mesial/distal/subcoroa não são afetadas); o modo simples sempre usa o conjunto genérico B/M/O/D/L/SC, independentemente da posição do dente. Aplica-se ao resumo de boca inteira e aos seletores de face de cárie e de defeito de restauração (letra + legenda); a chave de face armazenada não é afetada
- 🦷↕️ Registro ortodôntico por dente (`orthoAppliance`: none / bracket / band; `orthoDrift`: none / mesial / distal; `orthoVertical`: none / extrusion / intrusion; `orthoRotation`: booleano) em um dente natural presente (permanente ou decíduo) — reaproveita a ilustração ortodôntica dormente da v2.5.0 (nenhum SVG novo); exibido no odontograma, na dica e em uma nova seção de resumo de boca inteira "Ortodontia"
- 🪨 Cálculo, e reabsorção radicular tipificada como interna ou cervical externa (`resorptionType`)
- 📏 Profundidade da cárie por face (superficial / dentina / profunda), ou pontuação ICDAS II opcional (0–6) via `enableIcdas`
- 🩹 Alternador de infiltração marginal de coroa, exibido apenas para restauração de coroa ou ponte
- 🧰 Barra superior unificada de ícones com um modal de Configurações por abas (Geral / Painéis / Detalhes do dente / Cárie / Polpa / Notas — numeração, anotações, visibilidade de painéis, ICDAS, alternador de profundidade de cárie, granularidade de cárie radicular/radiográfica, nível de detalhe pulpar, nível de detalhe de desgaste/descoloração dentária, informações do dente)
- 🗂️ Aba Configurações → "Painéis": exibe/oculta de forma independente os painéis de resumo de boca inteira de Estados e Ortodontia
- 🩹 Configurações de cárie secundária (CARS) unificadas na aba de configurações de Cárie, posicionadas acima da Profundidade radiográfica (a aba separada "Cárie secundária" foi aposentada)
- 🎚️ Nível de detalhe dos detalhes do dente (Configurações → Detalhes do dente): um ajuste simples/complexo para o desgaste dentário e para a descoloração. O modo simples exibe um alternador sim/não por achado (desgaste ligado → attrition/abrasion, descoloração ligada → other); o modo complexo (padrão) mantém os menus suspensos de tipo/causa, e o valor armazenado é preservado ao alternar entre os níveis
- 📋 Painel de informações do dente: resumo textual ao vivo de todo o odontograma (contagens de dentes, listas de presentes/ausentes, cáries incl. secundárias, restaurações, tratamentos de canal, próteses, implantes, estado periodontal) — exibido por padrão, alternável em Configurações
- 🗂️ Menu de Exportação consolidado (Estado JSON / FHIR / PNG / JPG)
- 📥 Menu de Importação com importação FHIR (reimporta Bundles exportados)
- ⏳ Sobreposição de progresso durante a exportação de imagens
- 🎓 Tour interativo de introdução em 12 etapas
- 🔢 Três sistemas de numeração (FDI, Universal, Palmer)
- 🌐 Internacionalização (HU/EN/DE/ES/IT/SK/PL/RU/PT-BR) com seletor de idioma (190+ chaves de tradução por idioma)
- 🌗 Suporte a modo escuro com botão de alternância (autônomo ou controlado pelo app pai)
- 🎨 Configuração de tema personalizada (prop `themeConfig`) com propriedades CSS personalizadas (`--odon-*`)
- 📱 UX de toque em dispositivos móveis: popover de toque para ampliar, menu de contexto por pressão longa, pinça para ampliar, alvos de toque de 44px (WCAG), navegação por alternância de arcada
- 🔌 Sistema de plugins SVG personalizados: injete sobreposições visuais, estado personalizado por dente, suporte a exportação/importação em JSON
- ⚠️ Avisos de validação de estado para combinações incompatíveis de estados do dente
- 🏷️ Dica de estado automática nos blocos de dente (mostra todos os estados ativos)
- 🩺 Dica por dente e painel de resumo de boca inteira modernizados: ambos exibem o conjunto completo de achados clínicos (diagnóstico pulpar/apical + subtipo de lesão, reabsorção radicular, estado peri-implantar, cárie radicular graduada, cálculo, infiltração marginal de coroa, fratura, perda de contato, desgaste de borda/cervical tipificado), com uma seção dedicada "Diagnósticos" no painel, uma seção dedicada "Desgaste", e um qualificador de gravidade de cárie simplificado (superficial/moderada/profunda)
- ♿ Acessibilidade por teclado (WCAG): papéis ARIA listbox/option, seleção com Enter/Espaço, navegação com setas, contornos focus-visible
- 🔒 Modo somente leitura: desativa todas as interações para casos de impressão/laudo/visualização
- ✨ Animações de seleção: borda tracejada pulsante e sombra brilhante nos dentes selecionados (com suporte a prefers-reduced-motion)
- 📝 Anotações por dente: clique duplo para adicionar/editar anotações, ícone de anotação ao lado do número do dente, dica ao passar o mouse com o texto da anotação, exportação/importação em JSON
- 🧪 1746 testes automatizados aprovados (1 teste adicional ignorado) (Vitest) em 164 arquivos de teste (165 no total) cobrindo numeração, traduções, predefinições, i18n, componente App, tema, toque, plugins, acessibilidade e paridade dos eixos clínicos/diagnósticos
- 📖 Documentação de API em TypeDoc com comentários JSDoc em todos os exports públicos (`npm run docs`)
### 📦 Módulos
- 🦷 Grade do odontograma e interface dos blocos de dente
- 🎛️ Painel de controles e de estado
- 🎨 Motor de camadas SVG e modelos
- 🔢 Numeração de dentes e mapeamento de rótulos (FDI/Universal/Palmer)
- 🌐 Localização (HU/EN/DE/ES/IT/SK/PL/RU/PT-BR)
- 💾 Exportação/importação de estado
- 📋 Extras de estado: modelos de restauração predefinidos
- 🎨 Configuração de tema: paleta de cores personalizável via propriedades CSS `--odon-*`
- 📱 Interações de toque em dispositivos móveis (toque para ampliar, pressão longa, pinça para ampliar, alternância de arcada)
- 🔌 Sistema de plugins SVG personalizados
- ⚠️ Sistema de validação de estado e de dicas
- ♿ Acessibilidade por teclado e suporte a ARIA
- 🔒 Modo somente leitura
- ✨ Animações de seleção
- 📝 Sistema de anotações por dente
- 🧪 Suíte de testes automatizados (Vitest + Testing Library)
### 🛠️ Controles da interface
**🔝 Barra superior:**
- Seletor de idioma (menu suspenso HU/EN/DE/ES/IT/SK/PL/RU/PT-BR)
- Botão de alternância do modo escuro (ícone de sol/lua, alterna entre tema claro e escuro)
- Seletor do sistema de numeração (menu suspenso FDI/Universal/Palmer)
- Botões Exportar estado / Importar estado
**📊 Cabeçalho do odontograma:**
- Alternância da vista oclusal
- Alternância da visibilidade dos sisos
- Alternância da visibilidade do osso
- Alternância da visibilidade da polpa
- Botão de limpar seleção
**🔍 Filtros de seleção:**
- Selecionar Todos / Todos Presentes / Permanentes / Decíduos / Implantes / Todos Ausentes
- Selecionar Superiores / 6 Anteriores Superiores / Molares Superiores
- Selecionar Inferiores / 6 Anteriores Inferiores / Molares Inferiores
**📋 Predefinições de estado:**
- Redefinir Tudo (redefinir boca)
- Dentição Decídua
- Dentição Mista
- Alternância Edêntulo
**📦 Menu de extras de estado:**
- Pontes de zircônia superiores/inferiores (12-22, 13-23, 16-26, arcada completa)
- Pontes metálicas superiores/inferiores (12-22, 13-23, 16-26, arcada completa)
- Próteses removíveis parciais superiores/inferiores
- Próteses removíveis totais superiores/inferiores
- Próteses sobre barra com implantes superiores/inferiores
**🦷 Painel de edição do dente** (para o(s) dente(s) selecionado(s), agrupado em cartões recolhíveis):
- **Linha base:** seleção do dente (tipo base incl. variantes de coroa fraturada) e substrato dentário (natural/radix/fraturado/crownprep)
- **Linha de restauração:** o menu suspenso combinado de restauração "Fix: …" / "Kivehető: …" (opções fixas `restorationType`×`restorationMaterial` mais as opções de fixação/removível de `prosthesis`, filtradas pelo tipo de dente); caixa de seleção de infiltração marginal de coroa (apenas coroa/ponte); caixas de seleção de localização de coroa fraturada; alternadores de coroa necessária / substituição de coroa necessária
- **Linha de desgaste e descoloração:** menu suspenso de tipo de desgaste incisal/oclusal, menu suspenso de tipo de desgaste cervical, menu suspenso de causa de descoloração (cada um alterna para um toggle simples sim/não em Configurações → Detalhes do dente → modo simples)
- **Cartão de Ortodontia:** aparelho, desvio mesial/distal, movimento vertical (extrusão/intrusão), alternador de rotação — exibido em um dente natural presente
- **Cartão de Cárie:** menu suspenso de modo de profundidade de cárie, caixa de seleção de cárie subcoroa, menu suspenso de gravidade de cárie radicular, e o seletor de cárie por face B/M/O/D/L com um popup contextual de profundidade ICDAS/CARS e um emblema de profundidade radiográfica
- **Cartão de Restaurações:** menu suspenso de material de restauração, seletor de restauração por face (com material por face), indicador de defeito de restauração por face (marginal/fratura/desgaste), notas de dica de subcárie e de defeito de restauração
- **Cartão de Raiz e periodonto:** seletor unificado de "Estado pulpar/endodôntico", seletor de diagnóstico apical, seletor de subtipo de lesão periapical (apenas periodontite apical sintomática/assintomática), seletor de tipo de reabsorção radicular, seletor de grau de mobilidade, seletor de estado peri-implantar (apenas implantes)
- **Indicadores especiais:** plano/ferida de extração, espaço fechado, selamento de fissura, perda de ponto de contato, cálculo, pino parapulpar, resecção endodôntica, pilar de ponte
### 🦷 Tipos e estados do dente
**Seleção do dente (tipo base):**
| Valor | Descrição |
|---|---|
| `none` | Dente ausente |
| `tooth-base` | Dente permanente |
| `milktooth` | Dente decíduo (de leite) |
| `implant` | Implante dentário |
| `tooth-under-gum` | Dente subgengival (não irrompido) |
**Variantes de dente fraturado:**
`tooth-broken-inicisal`, `tooth-broken-distal-inicisal`, `tooth-broken-distal`, `tooth-broken-mesial-distal-inicisal`, `tooth-broken-mesial-distal`, `tooth-broken-mesial-inicisal`, `tooth-broken-mesial`, `no-tooth-after-extraction`
**Substrato dentário (dentes permanentes):**
`natural` (padrão), `radix` (resto radicular), `broken`, `crownprep` (preparada para coroa)
**Tipo de restauração (dentes permanentes):**
`none`, `crown`, `inlay`, `onlay` (apenas vista oclusal), `veneer`, `bridge`
**Material da restauração (dentes permanentes):**
`none`, `emax`, `gold`, `gradia`, `zircon`, `metal`, `metal-ceramic` (coroas `metal` legadas migram para cá), `telescope`, `temporary`
**As opções de restauração são filtradas pelo tipo de dente** (`restorationOptions()` em `src/registry/restorations.ts`): um implante oferece apenas os tipos de restauração `crown`/`bridge` (compostos com uma camada de conector de implante) mais as cinco entradas de fixação `prosthesis` abaixo; um dente ausente/espaço oferece apenas um pôntico `bridge` mais as duas entradas de prótese removível `prosthesis`; um substrato `radix` oculta totalmente o controle de restauração. Os antigos campos planos `crownMaterial`/`bridgeUnit` (valores de fixação de implante/ponte anteriores à v1.14) foram aposentados do modelo ativo — são aceitos apenas como caminho de migração somente leitura para payloads antigos.
**Prosthesis** (`prosthesis`; eixo ortogonal removível/de fixação, exibido como entradas "Kivehető:" no menu suspenso de restauração combinado):
`none`, `healing-abutment`, `locator`, `locator-denture`, `bar`, `bar-denture` (fixações de implante, com ou sem sobredentadura), `removable-partial`, `removable-full` (próteses suportadas por dentes em um dente ausente/espaço). Um dente tem ou uma restauração fixa ou uma prótese, nunca ambas — definir uma limpa a outra.
**Infiltração marginal de coroa** (`crownLeakage`; booleano): exibida apenas quando `restorationType` é `crown` ou `bridge`; ativa a camada de ilustração `crown-leakage`.
**Opções endodônticas (dentes permanentes):**
`none`, `endo-medical-filling`, `endo-filling`, `endo-filling-incomplete`, `endo-glass-pin`, `endo-metal-pin`
**Opções endodônticas (dentes decíduos):**
`none`, `endo-medical-filling`
`endo` e `pulpDx` são exibidos por meio de um único `