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 (@angular/common, @angular/core e @angular/forms), sem limite superior, e @govbr-ds/webcomponents na mesma versão do wrapper. |
@govbr-ds/webcomponents-react | React e react-dom na mesma major, e @govbr-ds/webcomponents na mesma versão do wrapper. |
@govbr-ds/webcomponents-vue | Vue 3 e @govbr-ds/webcomponents na mesma versão do wrapper. |
Fonte das faixas
As faixas exatas de cada framework estão nas peerDependencies do pacote
publicado (visíveis na página do npm) e nos manifests de cada wrapper.
Uma faixa declarada não garante toda combinação possível. O peer do Angular não
define limite superior.
Os quickstarts são exemplos de configuração mantidos em
repositórios próprios; as versões que eles usam estão nos respectivos
package.json e não alteram as faixas declaradas pelos wrappers.
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 faixas declaradas nas peerDependencies dos pacotes 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 a entrada ./ssr para SSR assíncrono com React Server Components, enquanto o SSR clássico 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.
