[Yipxiyi]

Summary

• migrate all supported Web UI controls and interaction patterns to HeroUI v3 native components
• align styling with HeroUI semantic tokens and component variants
• fix glossary table accessibility, responsive modal layout, macOS EPUB3 nav path resolution, and version metadata drift

Version impact

• patch release: 0.8.1

Validation

• 77 Python tests
• Python bytecode compilation
• 8 Web behavior tests on bundled Node 22
• TypeScript and Vite production build
• desktop and mobile Browser QA
• glossary pagination, search, settings, disclosure, and alert-dialog interactions
• zero relevant browser console errors or warnings

Docker compose config was not run locally because Docker is unavailable; GitHub CI covers it.

Risks

• the Web bundle is larger because HeroUI v3 is now included
• native file inputs remain for upload/import because HeroUI 3.1.0 does not export FileTrigger or DropZone

Rollback

• revert commit 566615e

Release notes

• full HeroUI v3 native interface migration
• accessible glossary review and translation warning flows
• release version 0.8.1