codeatlas-ui lint: gutter, header sem frame e superfície aninhada (resto de #1154)

Aberta
#1,318 0 comentários 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
3/5
Tempo estimado
1-2 dias
Facilidade para iniciantes
35/100
Tipo de issue
Funcionalidade
Clareza
Razoavelmente clara
Status de atividade
Ativa
Stack de tecnologia
css, typescript
Domínio
frontend, tooling

Direção de pesquisa

Start by reading how rules are registered and asserted in packages/ui/tests/ui-guard.test.ts, then the gate in scripts/mobile-gate.ts and the existing nested-surface rule from #920, which together show how a finding is produced and suppressed by a ca-ui-workaround marker. Before writing a rule, collect real gutter and fixed/sticky-header examples in the repo to pin down what each one rejects, using /docs/getting-started/layout-principles/ for the one-gutter-per-level rule. Done means each new rule has a test that fails without it, codeatlas-ui lint --rules lists it, and the nested-surface item is either extended with gate-only cases or closed with evidence.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

area:cli enhancement

Origem: o título de #1154. O PR #1317 entregou só os três critérios de aceite de #1154 (viewport-unit, fixed-bottom-offset, safe-area-bottom); estas três regras do título ficaram de fora para manter o PR pequeno.

O que falta

  • gutter: padding horizontal de página escrito à mão em vez de --ca-page-px / --ca-page-px-sm, ou um filho que soma o seu gutter ao do pai (regra 1 de /docs/getting-started/layout-principles/: um gutter por nível). Definir o que é reprovado antes de escrever a regra: p.ex. padding-inline: var(--ca-space-6) na raiz de uma página, ou AppList/AppForm dentro de PageShell sem embedded.
  • header sem frame: definir com o gate do AC (scripts/mobile-gate.ts) o que conta. Hipótese: um header position: fixed | sticky no topo sem --ca-safe-top e sem superfície opaca (--ca-chrome-surface). Reunir exemplos reais antes de escrever a regra.
  • superfície aninhada: nested-surface já existe (#920: Card/Surface como primeiro filho de outro). Verificar se o gate do AC pega casos que ela não pega (filho que não é o primeiro, Surface dentro de Card através de um wrapper, .ca-surface em CSS) e estender a regra, ou fechar este item com a evidência.

Critério de aceite (testável)

  • Cada regra nova tem um teste em packages/ui/tests/ui-guard.test.ts que falha antes da regra existir.
  • codeatlas-ui lint --rules lista as regras novas; um marcador ca-ui-workaround na linha ou acima desculpa um achado.

Relacionadas: #1154

Mãe: #1089

Linguagem predominante
TypeScript
Estrelas
6
Forks
3
Merge médio
5h 21min
PRs com merge (30d)
378

Preparar o ambiente

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de codeatlasdev/ui

Todas as issues de codeatlasdev/ui

Issues semelhantes

Mais issues de TypeScript

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.