Theme Check

corvex check complementa corvex validate com diagnósticos estruturados de qualidade e boas práticas.

Comando	Papel
`corvex validate`	Contrato obrigatório (manifest, schemas, templates, estrutura)
`corvex check`	Validate + SDK, JSX, acessibilidade estática, performance, schema experimental

Os dois usam os mesmos contratos públicos. Uma mesma infração produz o mesmo ruleId, severidade e mensagem na CLI e no MCP.

Uso

corvex check .
corvex check . --json
corvex check . --list
corvex check . --severity warning
corvex check . --fix --dry-run
corvex check . --config ./corvex.check.json

Não exige autenticação nem loja.

Flags

Flag	Efeito
`--json`	Só JSON no stdout (adequado a CI e agentes)
`--fix`	Autocorreções seguras (BOM/newline em JSON)
`--dry-run`	Com `--fix`, lista o que seria alterado
`--list`	Lista regras oficiais
`--severity` / `--fail-on`	`error` (default), `warning` ou `info`
`--config`	Caminho de `corvex.check.json`
`--path` / `--theme`	Raiz do tema
`--watch`	Reexecuta ao salvar
`--verbose`	Logs extras (em `--json`, vão para stderr)

Exit codes

0 — passou segundo failOn (default: sem error)
1 — falhou segundo failOn

Warnings sozinhos não falham o CI com o default.

Diagnóstico

Cada item inclui ruleId, severity, file, line/column quando disponíveis, message, suggestion, docsUrl, fixable e contractVersion.

{
  "ruleId": "CVX-SCHEMA-001",
  "severity": "error",
  "file": "sections/hero/schema.json",
  "message": "Tipo de configuração não suportado: \"warp\".",
  "suggestion": "Utilize um tipo previsto no contrato público.",
  "fixable": false
}

Taxonomia de regras

Prefixos oficiais:

Prefixo	Categoria
`CVX-CONTRACT-*`	Resultado do validador oficial
`CVX-SCHEMA-*`	Tipos de setting (desconhecido / experimental)
`CVX-SDK-*`	Imports do SDK / runtime
`CVX-JSX-*`	Sintaxe e export default de section/block
`CVX-A11Y-*`	Acessibilidade estática (parcial)
`CVX-PERF-*`	Heurísticas de performance
`CVX-CONFIG-*`	Configuração do próprio check

Rode corvex check --list para a lista completa.

Configuração

Arquivo opcional na raiz do tema: corvex.check.json.

{
  "version": 1,
  "failOn": "error",
  "ignore": [".corvex/**", "node_modules/**"],
  "categories": {
    "contract": true,
    "schema": true,
    "sdk": true,
    "jsx": true,
    "a11y": true,
    "performance": true
  },
  "rules": {
    "CVX-A11Y-001": "warning"
  },
  "performance": {
    "maxAssetBytes": 524288
  }
}

Desligar uma regra: "CVX-PERF-001": "off" ou false.

Autocorreção

--fix só aplica transformações determinísticas (hoje: remover BOM UTF-8 e garantir newline final em JSON de schema/config). Não altera carrinho, preço, checkout nem hooks com efeito colateral.

Acessibilidade e performance

As regras de a11y são estáticas e parciais — não são auditoria WCAG completa. Condições que dependem de renderização exigem análise dinâmica. Performance usa limiares de tamanho de asset; classificadas como warning.

CI

corvex check . --json

Use --severity warning se quiser falhar também em avisos.

Introdução

Temas

Seções

Guias

Exemplos

Storefront Components

Schema

CLI

Dados

SDK

Contratos

Marketplace

Theme Check

Theme Check

Uso

Flags

Exit codes

Diagnóstico

Taxonomia de regras

Configuração

Autocorreção

Acessibilidade e performance

CI

​Theme Check

​Uso

​Flags

​Exit codes

​Diagnóstico

​Taxonomia de regras

​Configuração

​Autocorreção

​Acessibilidade e performance

​CI

Theme Check

Uso

Flags

Exit codes

Diagnóstico

Taxonomia de regras

Configuração

Autocorreção

Acessibilidade e performance

CI