Compatibilidade
Os pacotes publicados possuem contratos de compatibilidade diferentes. Use a linha correspondente ao pacote que será instalado:
| Pacote | Compatibilidade específica |
|---|---|
@govbr-ds/webcomponents | JavaScript/TypeScript com alvo ES2020, Custom Elements, Shadow DOM e navegadores no Baseline Widely Available. |
@govbr-ds/webcomponents-angular | Angular >=14.0.0, incluindo @angular/common, @angular/core e @angular/forms, além de @govbr-ds/webcomponents 2.1.3. |
@govbr-ds/webcomponents-react | React ^18 ou ^19 e react-dom na mesma major, além de @govbr-ds/webcomponents 2.1.3. |
@govbr-ds/webcomponents-vue | Vue >=3.4.38 <4.0.0 e @govbr-ds/webcomponents 2.1.3. |
Referências de versão
O quadro compara a versão mínima declarada pelos peers com as versões usadas nos quickstarts. Os quickstarts são exemplos de configuração e não equivalem a um teste de integração automatizado de cada wrapper com o framework.
| Integração | Mínimo declarado | Versão do quickstart |
|---|---|---|
| Angular | 14.0.0 | 18.2.14 |
| React | 18.0.0 | 19.2.8 |
| Vue | 3.4.38 | 3.5.40 |
Consulte as peerDependencies no manifest de cada pacote para as faixas de peers e as referências dos quickstarts. A faixa declarada não garante toda combinação possível.
O peer do Angular não define um limite superior. O Quickstart Angular da branch
main usa Angular 18.2.14, Angular CLI 18.2.21 e TypeScript 5.5.4. Essa
combinação identifica o exemplo mantido e não altera a faixa >=14.0.0 declarada
pelo wrapper.
Navegadores e restrições
Internet Explorer não é suportado. O alvo de navegadores é baseline widely available, conforme a configuração do Browserslist do projeto; a lista pode mudar entre releases.
Os contratos críticos são executados em Chromium, Firefox e WebKit. Isso não representa suporte a uma versão específica que não tenha sido validada automaticamente.
Como interpretar a matriz
As versões acima são as faixas declaradas nas peerDependencies dos pacotes. Elas não substituem a compatibilidade do navegador do núcleo: todo wrapper renderiza os Web Components e, portanto, também depende do Baseline Widely Available. O pacote Angular oferece as entradas NgModule e standalone; o React oferece uma entrada específica para SSR assíncrono a partir do React 19, enquanto o SSR clássico no React 18 usa a entrada principal; e o Vue requer Vue 3, não Vue 2.
Referências oficiais
- Compatibilidade de versões do Angular e Angular Package Format.
- Versões e política de versionamento do React e política de versionamento.
- FAQ de compatibilidade do Vue e guia de início do Vue 3.
- Baseline e consulta Baseline do Browserslist.
Para detalhes de instalação, configuração e formulários, consulte a página da integração com frameworks e o README do pacote correspondente.
