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

Ouverte
#1,318 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Les mainteneurs répondent en général sous 1 jour

Personne n'a encore pris cette issue.

Évaluation

Difficulté
3/5
Temps estimé
1-2 jours
Accessibilité débutants
35/100
Type d'issue
Fonctionnalité
Clarté
Plutôt claire
Activité
Active
Stack technique
css, typescript
Domaine
frontend, tooling

Piste de recherche

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.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

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

Langage dominant
TypeScript
Étoiles
6
Forks
3
Merge moyen
5 h 21 min
PR mergées (30 j)
378

Préparer son environnement

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de codeatlasdev/ui

Toutes les issues de codeatlasdev/ui

Issues similaires

Plus d'issues TypeScript

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.