Repository navigation
v0.5.3 — Display Domain Optimization
Pre-release
Pre-release
Release Notes: v0.5.3 — Display Domain Optimization
1. Mobile Ergonomics & Interface Relocation
Intent: Prioritize the 3D workspace as the primary focus while improving reachability on touch devices.
- Bottom-Docked HUD: Relocated interface menus to the bottom of the viewport for mobile layouts, optimizing for thumb-reach and ergonomic stability.
- Micro-HUD Toggle: Implemented "shrink-to-hamburger" logic where the interface collapses into a 3.5rem translucent square. Selecting the hamburger triggers a width-expansion animation to restore the full control suite.
- Glassmorphism Sidebar: Replaced the solid layout gap with a semi-transparent, blur-filtered overlay (
backdrop-filter: blur(8px)), allowing 3D geometry to remain visible behind interface labels. - Responsive Feature Flag GUI: Inherited HUD location constraints for the debug panel. Implemented "stacking" logic where buttons relocate below labels on narrow viewports to prevent horizontal overflow.
2. Touch Interaction & Viewport Hardening
Intent: Maintain standard browser accessibility while protecting the 3D interactive surface from accidental scaling.
- Context-Aware Zoom: Applied
touch-action: noneexclusively to the 3D Canvas. This prevents accidental page-level zooming during 3D manipulation while preserving the user's native ability to pinch-zoom UI text and headers. - Synthetic Event Guarding: Implemented a
useOutsideDismisshook utilizingevent.isTrustedvalidation to prevent "ghost" pointer events from accidentally collapsing the HUD. - Viewport Integrity: Utilized
viewport-fit=coverand safe-area insets (env(safe-area-inset-bottom)) to ensure the HUD respects hardware boundaries like the iPhone "Home Bar."
3. Infrastructure & CI Stability
Intent: Standardize deployment pipelines and asset reliability across disparate environments.
- Trailing Slash Guard: Enforced URL consistency via a
<head>-level JavaScript guard. This ensures Web Worker assets and relative paths resolve reliably on GitHub Pages (e.g.,/parametric->/parametric/). - Shared Baseline Strategy: Standardized visual regression testing using a "Shared Baseline" approach. CI validates against OS-agnostic snapshots with refined
maxDiffPixelRatiothresholds. - Unified Coverage Integration: Successfully merged Jest and Playwright coverage into a single reporting shard, reclaiming a Statement Coverage of 84.51%.
- Snapshot Path Anchoring: Resolved
ENOENTerrors by anchoringsnapshotPathTemplateto{testDir}, ensuring snapshots are project-relative.
4. Quality Audit (Final v0.5.3 Results)
| Category | Metric | Result | Environment |
|---|---|---|---|
| Global Pass Rate | Total Success | ✅ 100% (462/462) | Chromium, Firefox, WebKit |
| Full Stack | Statement Coverage | ✅ 84.51% | Unified (Jest + Playwright) |
| Logic/Services | Line Coverage | ✅ 86.17% | Node v20 |
| Visual Regressions | Snapshot Integrity | ✅ 100% | Cross-Browser Deterministic |
5. Bug Fixes
- Canary Geometry Drift: Resolved a 12% pixel mismatch in
CIRCLErenders by surgically relaxing thresholds for high-anti-aliasing meshes (0.15 tolerance). - Drag Simulation Math: Fixed a
FormulaHUDcoordinate failure by implementing center-aware drag calculations that account for HUD dimensions. - Coordinate Decoupling: Updated HUD alignment tests to account for the new ergonomic bottom-docking logic, resolving coordinate mismatches on small-format devices.
- State Synchronization: Enhanced E2E stability by ensuring tests wait for React transition states before asserting opacity/visibility logic.
- Pointer Interception: Resolved a test-time collision where absolute-positioned interface elements intercepted clicks intended for the Micro-Nav toggle via
{ force: true }.
v0.5.3 | 2026-01-28