Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
75 changes: 75 additions & 0 deletions VULNERABILITIES.md
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Para manter o padrão do projeto, creio que esse arquivo deveria ser em português, ou pelo menos ter uma versão em português.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Perfeito, traduzi o arquivo VULNERABILITIES.md para o português para manter a consistência com o restante do projeto.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seria ideal que fossem indicados, no MD, os problemas que estão sendo resolvidos neste PR.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Excelente sugestão. Atualizei o arquivo VULNERABILITIES.md com uma legenda de status (✅ Resolvido, ⚠️ Parcialmente Resolvido, 📝 Documentado) para deixar claro o que foi corrigido neste PR e o que foi apenas identificado para futuras melhorias.

Original file line number Diff line number Diff line change
@@ -0,0 +1,75 @@
# Auditoria do Projeto: Segurança, Performance e Acessibilidade

Este documento lista as descobertas de uma auditoria da biblioteca do design system Cuida.

**Legenda de Status:**
- ✅ **Resolvido**: Problema corrigido neste PR.
- ⚠️ **Parcialmente Resolvido**: Melhorado, mas ainda com pontos pendentes.
- 📝 **Documentado**: Identificado para futuras melhorias.

## 1. Problemas de Segurança

### 1.1 XSS Potencial no Componente Icon (📝 Documentado)
O componente `Icon.vue` utiliza `v-html` para renderizar caminhos SVG. Embora os caminhos sejam comparados com um conjunto de ícones predefinido de `@sysvale/cuida-icons`, o uso de `v-html` é geralmente desencorajado a menos que seja estritamente necessário e sanitizado.
- **Localização**: `src/components/Icon.vue`
- **Impacto**: Baixo (se os ícones forem confiáveis), mas aumenta a superfície de ataque.

### 1.2 Vulnerabilidades de Dependências (✅ Resolvido)
Múltiplas vulnerabilidades foram encontradas em dependências (principalmente dependências de desenvolvimento):
- `form-data` (Crítica): Função aleatória insegura.
- `glob` (Alta): Injeção de comando.
- `preact` (Alta): Injeção de JSON VNode.
- `esbuild`/`vite` (Moderada): Vulnerabilidades no servidor de desenvolvimento.
- `vue` v2.7.16 (Baixa): Vulnerabilidade de ReDoS.
*Nota: Corrigido via `npm audit fix` e remoção de dependência conflitante.*

### 1.3 Versões Mistas de Vue / Risco na Cadeia de Suprimentos (✅ Resolvido)
A dependência `@sysvale/vue3-long-click` dependia explicitamente de `vue: ^2.5.22`. Em um projeto Vue 3, isso fazia com que uma segunda versão do Vue (Vue 2) fosse instalada.
- **Impacto**: Alto. Levava a instâncias duplicadas do Vue e trazia vulnerabilidades conhecidas (ReDoS).
- **Resolução**: Removida a dependência e implementada uma diretiva local `cdsLongClick` compatível com Vue 3.

---

## 2. Problemas de Performance

### 2.1 IDs Duplicados e Não Únicos (✅ Resolvido)
`Table.vue` utilizava `field.key` como um ID para cada célula (`td`) em uma coluna, gerando múltiplos elementos com o mesmo ID.
- **Impacto**: Alto. Tornava o `document.getElementById` não confiável e degradava a performance.
- **Resolução**: Removidos IDs duplicados das células e mantidos apenas nos headers onde são únicos.

### 2.2 Tamanho de Bundle Ineficiente nos Gráficos (⚠️ Parcialmente Resolvido)
Componentes de gráfico registravam todos os componentes do Chart.js usando `registerables`.
- **Impacto**: Médio. Aumentava significativamente o tamanho do bundle.
- **Resolução**: `LineChart.vue` foi refatorado para usar registro seletivo (tree-shaking). Outros componentes de gráfico ainda podem ser otimizados.

### 2.3 Watches Profundos e Clones Caros (📝 Documentado)
- `DataTable.vue` usa `lodash.clonedeep` em `customFieldsList`.
- `Table.vue` usa um watch profundo no array `select`.
- **Impacto**: Baixo a Médio.

---

## 3. Problemas de Acessibilidade (a11y)

### 3.1 Elementos Clicáveis Não Semânticos (✅ Resolvido)
`Clickable.vue` usava uma `div` sem papéis ARIA ou suporte a teclado.
- **Impacto**: Alto. Inacessível para usuários de leitor de tela e teclado.
- **Resolução**: Adicionados `role="button"`, `tabindex="0"` e suporte às teclas Enter e Espaço.

### 3.2 Checkbox Inacessível (✅ Resolvido)
`Checkbox.vue` ocultava o input nativo de forma que ele não recebia foco nem era lido corretamente.
- **Impacto**: Alto. Navegação por teclado era impossível.
- **Resolução**: Refatorado para usar input nativo (visualmente oculto, mas funcional) com anel de foco adequado.

### 3.3 Falta de Suporte ao Atributo Disabled Nativo (✅ Resolvido)
`Button.vue` não aplicava o atributo `disabled` nativo.
- **Impacto**: Médio.
- **Resolução**: Atributo `disabled` agora é aplicado corretamente ao elemento HTML.

### 3.4 Associação de Label Quebrada (✅ Resolvido)
`Label.vue` aceitava uma prop `for`, mas não a aplicava ao elemento nativo.
- **Impacto**: Alto.
- **Resolução**: Prop `for` agora é aplicada corretamente, vinculando a label ao input.

### 3.5 Falta de Roles ARIA em Tabelas (📝 Documentado)
`Table.vue` e `DataTable.vue` carecem de papéis ARIA (ex: `aria-sort`) e descrições para ações complexas.
82 changes: 61 additions & 21 deletions docs/.docgen/components-metadata.json
Original file line number Diff line number Diff line change
Expand Up @@ -811,7 +811,7 @@
},
"defaultValue": {
"func": false,
"value": "1"
"value": "5"
}
},
{
Expand All @@ -822,7 +822,7 @@
},
"defaultValue": {
"func": false,
"value": "false"
"value": "true"
}
}
],
Expand Down Expand Up @@ -1637,8 +1637,9 @@
]
},
"CdsButton": {
"displayName": "CdsButton",
"name": "CdsButton",
"exportName": "default",
"displayName": "Button",
"description": "",
"tags": {},
"props": [
Expand Down Expand Up @@ -1740,7 +1741,7 @@
},
{
"name": "loading",
"description": "Especifica se a versão do Botão é a secundária.",
"description": "Especifica se o botão deve mostrar spinner de carregamento.\nCaso o botão seja do tipo ghost ou secondary a variante do spinner é a mesma passada na prop variant.",
"type": {
"name": "boolean"
},
Expand Down Expand Up @@ -2746,10 +2747,9 @@
"events": [
{
"name": "cds-click",
"description": "Evento emitido quando o wrapper é clicado",
"type": {
"names": [
"Event"
"undefined"
]
}
}
Expand Down Expand Up @@ -4323,8 +4323,9 @@
]
},
"CdsDropdownButton": {
"displayName": "CdsDropdownButton",
"name": "CdsDropdownButton",
"exportName": "default",
"displayName": "DropdownButton",
"description": "",
"tags": {},
"props": [
Expand Down Expand Up @@ -4424,27 +4425,38 @@
"md",
"lg"
]
}
],
"events": [
},
{
"name": "click",
"description": "Evento que indica que o DropdownButton foi clicado",
"name": "disabled",
"description": "Desabilita o input.",
"type": {
"names": [
"Event"
]
"name": "boolean"
},
"defaultValue": {
"func": false,
"value": "false"
}
},
{
"name": "action-click",
"name": "tooltipText",
"description": "Texto a ser exibido como tooltip com o hover do DropdownButton quando a prop disabled estiver ativa.",
"type": {
"names": [
"undefined"
]
"name": "string"
},
"defaultValue": {
"func": false,
"value": "null"
}
}
],
"events": [
{
"name": "button-click"
},
{
"name": "action-click"
}
],
"sourceFiles": [
"src/components/DropdownButton.vue"
]
Expand Down Expand Up @@ -8390,7 +8402,7 @@
},
"defaultValue": {
"func": false,
"value": "'https://cuida.framer.wiki/'"
"value": "null"
}
},
{
Expand Down Expand Up @@ -10730,6 +10742,18 @@
"value": "false"
}
},
{
"name": "deepSearch",
"description": "Indica se a busca deve levar em consideração argumentos compostos.\nSó tem efeito se a prop `searchable` for `true`.",
"type": {
"name": "boolean"
},
"required": false,
"defaultValue": {
"func": false,
"value": "false"
}
},
{
"name": "width",
"tags": {
Expand Down Expand Up @@ -12673,6 +12697,17 @@
"func": false,
"value": "false"
}
},
{
"name": "loading",
"description": "Ativa o estado de carregamento do componente, exibindo um Skeleton para a tabela.",
"type": {
"name": "boolean"
},
"defaultValue": {
"func": false,
"value": "false"
}
}
],
"events": [
Expand Down Expand Up @@ -13354,7 +13389,7 @@
},
"defaultValue": {
"func": false,
"value": "'https://cuida.framer.wiki/'"
"value": "null"
}
},
{
Expand Down Expand Up @@ -13442,6 +13477,11 @@
}
}
],
"slots": [
{
"name": "label"
}
],
"sourceFiles": [
"src/components/TextInput.vue"
]
Expand Down
Loading