testing: detectores de UI como pacote consumível (faixa vazia, gutter, sobreposição, texto cru, hierarquia de ações, CLS com origem, foco após toque)
Maintainer thường phản hồi trong vòng 1 ngày
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 4/5
- Thời gian dự kiến
- 3-5 ngày
- Mức phù hợp với người mới
- 35/100
- Loại issue
- Tính năng
- Độ rõ ràng
- Khá rõ ràng
- Mức độ hoạt động
- Sôi nổi
- Công nghệ
- playwright, typescript
- Lĩnh vực
- testing
Hướng nghiên cứu
Read discussion #1087 §2.5 and the consumer request atlas#215 first; they define the detectors and the acceptance run. The deliverable is a stable export such as @codeatlasdev/ui/testing/detectors with the detect(page, opts) signature and one function per detector, each backed by a failing and a corrected fixture. The empty-band case (490 px of blank on a 390x844 viewport) is the explicit acceptance test; run everything through Playwright on Chromium and WebKit at 390 and 1440 px in light and dark. Done means atlas#215 passes without the detectors depending on kit DOM code.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
Pedido de codeatlasdev/atlas#215 (épico codeatlasdev/atlas#168). A Atlas Crew precisa rodar, numa página aberta pelo Playwright (Chromium e WebKit, 390 e 1440 px, claro e escuro), os detectores descritos na discussão #1087 §2.5, sem copiar a lógica para o Atlas.
O que falta aqui
Um export estável, por exemplo @codeatlasdev/ui/testing/detectors, com uma função por detector e uma que roda todos:
type Finding = { detector: string; severity: "error" | "warn"; message: string; rect?: DOMRectInit; selector?: string };
export function detect(page: Page | Window, opts?: { only?: string[] }): Promise<Finding[]>;
Detectores (cada um com fixture que falha e fixture corrigida):
- Faixa vazia na página inteira: banda horizontal sem conteúdo acima de um limite (ex.: 490 px de vazio num 390x844) — ver #1084.
- Gutter < 12 px no celular — ver #1154.
- Sobreposição de irmãos (caixas que se cobrem sem ser overlay).
- Texto cru: ids, snake_case/kebab-case em títulos e rótulos.
- Hierarquia de ações: mais de uma ação primária visível no mesmo grupo.
- CLS com origem: deslocamento acima do limite, com o elemento que causou — ver #1068 e #974.
- Foco após toque: o elemento ativado perde o foco ou ele vai para o body — ver #1229.
Por que no ui
O Atlas e qualquer app do kit usam as mesmas regras; duplicá-las no Atlas faria as duas divergirem.
Aceite (o que o Atlas vai testar)
- O detector de faixa vazia reprova uma fixture com faixa de 490 px e aprova a corrigida (codeatlasdev/atlas#215).
- Rodam no Chromium e no WebKit (WebKit é o motor do Atlas Desktop e do Safari do iPhone).
- Sem dependência de DOM do kit: funcionam em qualquer página (o Atlas roda em apps de clientes).
- Ngôn ngữ chính
- TypeScript
- Star
- 6
- Fork
- 3
- Merge trung bình
- 5 giờ 21 phút
- Pull request đã merge (30 ngày)
- 378
Chuẩn bị môi trường
- Không có Dockerfile hay tệp Docker Compose
- Có mẫu pull request
- Đọc hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của codeatlasdev/ui
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 84/100
codeatlasdev/ui#1340 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
area:a11y area:components bug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 76/100
codeatlasdev/ui#1336 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 77/100
codeatlasdev/ui#1329 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
good first issue
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 74/100
codeatlasdev/ui#1292 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
area:components enhancement good first issue
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
codeatlasdev/ui#1198 ·
Maintainer thường phản hồi trong vòng 1 ngày
Tất cả issue của codeatlasdev/ui
Issue tương tự
-
Console writes URL credentials to the local log, though AGENTS.md says secrets never reach diskĐang mở
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 86/100
sandbox-quantum/switch#2163 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
automated issue report
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 78/100
Maintainer thường phản hồi trong vòng 1 ngày
-
area/dashboard kind/bug QA/dev-automation
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 75/100
Maintainer thường phản hồi trong vòng 1 ngày
-
bug pydanty:is-working
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 82/100
pydantic/pydantic-ai#13939 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
self-host
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 70/100
funmusicplace/mirlo#2625 ·
Maintainer thường phản hồi trong vòng 1 ngày