feat(report): support WebP screenshot consumers

[quanruzhuoxiu]

Summary

• resolve screenshot sources by their real MIME type in the report UI and timeline
• export Markdown screenshots with format-aware file extensions
• preserve WebP assets in report split, merge, CLI, and verbose screenshot flows
• update visualizer consumers and the bilingual API documentation
• add regression coverage across shared, core, report, and visualizer consumers

Stack

This is PR 4 of 4 for the WebP foundation split.

• Depends on feat(core): make screenshot lifecycle format-aware #2855, which depends on feat(shared): add WebP image primitives #2854
• Browser and device screenshot producer PRs are based on this branch
• feat(core): record exact model input screenshots #2856 is independent and can merge in parallel
• The original foundation PR feat(shared): establish canonical WebP screenshot pipeline #2851 remains unchanged as a rollback option

Validation

• pnpm exec nx run-many -t build -p @midscene/shared @midscene/core @midscene/report @midscene/visualizer
• pnpm --filter @midscene/shared test (33 files, 433 tests passed)
• pnpm --filter @midscene/core test (124 files, 1,352 passed, 8 skipped)
• pnpm --filter @midscene/report test (16 files, 87 tests passed)
• pnpm --filter @midscene/visualizer test (21 files, 104 tests passed)
• pnpm run type-check:tests
• pnpm run lint

[cloudflare-workers-and-pages]

Deploying midscene with    Cloudflare Pages

Latest commit:	ebfa101
Status:	✅  Deploy successful!
Preview URL:	https://7cb2662f.midscene.pages.dev
Branch Preview URL:	https://feat-webp-report-consumers.midscene.pages.dev

View logs

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: ebfa101363

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Serve the WebP replay URLs generated here

In the server-backed playground flow, a WebP reference now resolves to screenshots/<id>.webp, but the corresponding route in packages/playground/src/server.ts:3098-3102 accepts only png|jpe?g assets and therefore returns HTTP 400. Consequently, replay dumps load but every lazily rendered WebP screenshot is broken in both playground consumers; extend that route and its response MIME mapping to support WebP.

Useful? React with 👍 / 👎.

[quanruzhuoxiu]

Closing this superseded WebP stack PR. The replacement stack is #3012 → #3013 → #3014 and incorporates the latest main branch plus the follow-up architecture, format-validation, and CI fixes. PR #2856 remains open because it is an independent model-input evidence change.