test(frontend): e2e main flow (login→shelf→cbz→bookmark→logout) + axe scans

frontend/e2e/helpers/axe.ts

@@ -12,16 +12,34 @@ interface Waiver {
  * 仅允许「属于将被 ② 阅读器改版重写的旧 chrome」的问题进这里，reason 必须写明归属。
  * 例：{ page: "reader-chrome", rule: "color-contrast", reason: "旧 rd-* chrome 配色，② 迁移 shadcn token 后移除本豁免" }
  */
-const WAIVERS: Waiver[] = [];
+const WAIVERS: Waiver[] = [
+  {
+    page: "reader-chrome",
+    rule: "color-contrast",
+    reason:
+      "旧 chrome:Reader.tsx 头栏(书架返回钮/书名/库名/进度)用 stone-* 配色,对比不足;② 阅读器改版迁移 shadcn token 后移除本豁免",
+  },
+];
 
 export async function scanA11y(page: Page, name: string): Promise<void> {
+  // 等 CSS 动画/过渡收尾(如 fx-rise 入场淡入)再扫:动画途中采样会因不透明度混色造成 contrast 误报;2s 上限兜底长动画
+  await page.evaluate(() =>
+    Promise.race([
+      Promise.allSettled(document.getAnimations().map((a) => a.finished)),
+      new Promise((r) => setTimeout(r, 2000)),
+    ]),
+  );
   const results = await new AxeBuilder({ page }).withTags(["wcag2a", "wcag2aa", "wcag21a", "wcag21aa"]).analyze();
 
   if (results.violations.length > 0) {
     console.log(
       `[axe:${name}]`,
       JSON.stringify(
-        results.violations.map((v) => ({ id: v.id, impact: v.impact, nodes: v.nodes.length })),
+        results.violations.map((v) => ({
+          id: v.id,
+          impact: v.impact,
+          nodes: v.nodes.map((n) => n.target.join(" ")),
+        })),
         null,
         2,
       ),