test: design-lab 加 E2e 防画面偏差——结构契约断言 + 五页视觉基线（reducedMotion 稳定截图）

2026-10-05 20:17:28 +08:00
1 parent 869e38aef7
commit 15f66a8fa6
@@ -0,0 +1,159 @@
+import { expect, test } from '@playwright/test'
+
+/**
+ * 设计系统结构契约断言——规格级防回归。
+ * 布局微调不误报，但破坏设计规格（描边/投影/比例/半嵌/裁切）必红。
+ */
+
+const PAGES = ['index', 'colors', 'symbols', 'components', 'shelf'] as const
+
+test.describe('全局画布', () => {
+  for (const p of PAGES) {
+    test(`${p}.html 渲染且有内容`, async ({ page }) => {
+      await page.goto(`/${p}.html`)
+      await expect(page.locator('#root')).not.toBeEmpty()
+      await expect(page.locator('main')).toBeVisible()
+    })
+  }
+
+  test('body 大底为纸色 #FFF9F0', async ({ page }) => {
+    await page.goto('/index.html')
+    const bg = await page.evaluate(() => getComputedStyle(document.body).backgroundColor)
+    expect(bg).toBe('rgb(255, 249, 240)')
+  })
+
+  test('全站无色彩渐变', async ({ page }) => {
+    await page.goto('/shelf.html')
+    const gradients = await page.evaluate(() => {
+      const bad: string[] = []
+      document.querySelectorAll<HTMLElement>('*').forEach((el) => {
+        if (getComputedStyle(el).backgroundImage.includes('gradient')) bad.push(el.tagName)
+      })
+      return bad
+    })
+    expect(gradients, gradients.join(',')).toEqual([])
+  })
+})
+
+test.describe('CourseCard 规格契约', () => {
+  test.beforeEach(async ({ page }) => await page.goto('/components.html'))
+
+  test('2px ink 描边 + 硬投影 + 纸叠三层边', async ({ page }) => {
+    const card = page.locator('a[href="#ch1"]').first()
+    await expect(card).toBeVisible()
+    const s = await card.evaluate((el) => {
+      const cs = getComputedStyle(el)
+      return { bw: cs.borderTopWidth, bc: cs.borderTopColor, shadow: cs.boxShadow }
+    })
+    expect(s.bw).toBe('2px')
+    expect(s.bc).toBe('rgb(17, 17, 17)')
+    expect((s.shadow.match(/rgb|#/g) ?? []).length).toBeGreaterThanOrEqual(4) // 三层纸叠+硬投影（按色值计数）
+    expect(s.shadow).toContain('rgb(17, 17, 17)')
+  })
+
+  test('16:9 相框：比例、3px 黑边、内阴影、章节撞色', async ({ page }) => {
+    const zone = page.locator('a[href="#ch1"] .aspect-video').first()
+    const s = await zone.evaluate((el) => {
+      const cs = getComputedStyle(el)
+      const r = el.getBoundingClientRect()
+      return { ratio: r.width / r.height, bw: cs.borderTopWidth, shadow: cs.boxShadow, bg: cs.backgroundColor }
+    })
+    expect(Math.abs(s.ratio - 16 / 9)).toBeLessThan(0.02)
+    expect(s.bw).toBe('3px')
+    expect(s.shadow).toContain('inset')
+    expect(s.bg).toBe('rgb(255, 107, 107)') // ch1 coral 只进相框
+  })
+
+  test('卡头三件套：▲ + 标题 + 积木点（实心=已学）', async ({ page }) => {
+    const card = page.locator('a[href="#ch2"]').first()
+    const dots = card.locator('span[aria-label^="积木"] i')
+    expect(await dots.count()).toBe(4)
+    const filled = await dots.evaluateAll((ns) => ns.filter((n) => getComputedStyle(n).backgroundColor === 'rgb(17, 17, 17)').length)
+    expect(filled).toBe(2) // ch2 已学 2/4
+    expect(await card.locator('svg').first()).toBeVisible() // ▲
+  })
+
+  test('入口徽章 ①②（推荐起点，非强制）', async ({ page }) => {
+    await expect(page.locator('span[aria-label="推荐入口 1"]')).toBeVisible()
+    await expect(page.locator('span[aria-label="推荐入口 2"]')).toBeVisible()
+  })
+})
+
+test.describe('RouteLine 规格契约', () => {
+  test.beforeEach(async ({ page }) => await page.goto('/shelf.html'))
+
+  test('线形：实线先后 2.5px 无 dash；点线同族 0.1/6 圆帽', async ({ page }) => {
+    const specs = await page.locator('svg path').evaluateAll((ns) =>
+      ns.map((n) => ({ w: n.getAttribute('stroke-width'), dash: n.getAttribute('stroke-dasharray'), cap: n.getAttribute('stroke-linecap') })),
+    )
+    expect(specs.some((s) => s.w === '2.5' && !s.dash)).toBeTruthy()
+    expect(specs.some((s) => s.dash === '0.1 6' && s.cap === 'round')).toBeTruthy()
+  })
+
+  test('虚线相关 4:2（symbols 页线形样张）', async ({ page }) => {
+    await page.goto('/symbols.html')
+    const specs = await page.locator('svg path').evaluateAll((ns) => ns.map((n) => n.getAttribute('stroke-dasharray')))
+    expect(specs).toContain('4 2')
+  })
+
+  test('站点 r6 半嵌：源骑卡右黑影外缘、目标贴左描边', async ({ page }) => {
+    const c1 = await page.locator('a[href="#ch1"]').first().boundingBox()
+    const c2 = await page.locator('a[href="#ch2"]').first().boundingBox()
+    const wrap = await page.locator('main div.relative').first().boundingBox()
+    expect(c1 && c2 && wrap).toBeTruthy()
+
+    const stations = await page.locator('svg circle').evaluateAll((ns) =>
+      ns.map((n) => ({ cx: +(n.getAttribute('cx') ?? 0), r: +(n.getAttribute('r') ?? 0) })).filter((s) => s.r === 6), // 排除散落 ○ 预期环
+    )
+    expect(stations.length).toBeGreaterThanOrEqual(4)
+
+    const c1ShadowEdge = c1!.x - wrap!.x + c1!.width + 7 // 描边外 + 7px 黑影
+    const c2Border = c2!.x - wrap!.x
+    expect(stations.some((s) => Math.abs(s.cx - c1ShadowEdge) <= 3), `源站点应骑黑影外缘 x≈${c1ShadowEdge}`).toBeTruthy()
+    expect(stations.some((s) => Math.abs(s.cx - c2Border) <= 3), `目标站点应贴左描边 x≈${c2Border}`).toBeTruthy()
+  })
+
+  test('实线端点落在水平端口（M x y H 起、H x 止）', async ({ page }) => {
+    const d = await page.locator('svg path[stroke-width="2.5"]').first().getAttribute('d')
+    expect(d).toMatch(/^M [\d.]+ [\d.]+ H/)
+    expect(d).toMatch(/H [\d.]+$/)
+  })
+})
+
+test.describe('票券规格契约', () => {
+  test.beforeEach(async ({ page }) => await page.goto('/symbols.html'))
+
+  test('裁切式：overflow hidden + 单一 2px 描边 + 头部色块无独立边框', async ({ page }) => {
+    const done = page.locator('.ticket-pk').first()
+    await expect(done).toBeVisible()
+    const s = await done.evaluate((el) => {
+      const cs = getComputedStyle(el)
+      const head = el.firstElementChild as HTMLElement
+      const hcs = getComputedStyle(head)
+      return { ov: cs.overflow, bw: cs.borderTopWidth, headBorder: hcs.borderTopWidth, headBg: hcs.backgroundColor }
+    })
+    expect(s.ov).toBe('hidden')
+    expect(s.bw).toBe('2px')
+    expect(s.headBorder).toBe('0px') // 头部色块永不自带描边
+    expect(s.headBg).not.toBe('rgba(0, 0, 0, 0)')
+  })
+
+  test('打孔伪元素在位（完成票 ×2 孔）', async ({ page }) => {
+    const holes = await page.locator('.ticket-pk').first().evaluate((el) => {
+      const b = getComputedStyle(el, '::before')
+      const a = getComputedStyle(el, '::after')
+      return [b.content, a.content].filter((c) => c !== 'none').length
+    })
+    expect(holes).toBe(2)
+  })
+
+  test('撕线：完成=虚线、未开始=实线', async ({ page }) => {
+    const styles = await page.evaluate(() =>
+      [...document.querySelectorAll('div')]
+        .filter((el) => String(el.className).includes('w-[216px]'))
+        .map((el) => getComputedStyle(el.lastElementChild as HTMLElement).borderLeftStyle),
+    )
+    expect(styles).toContain('dashed')
+    expect(styles).toContain('solid')
+  })
+})