Skip to content

v0.5.3 — Display Domain Optimization

Pre-release
Pre-release

Choose a tag to compare

@jaseknighter jaseknighter released this 30 Jan 16:56
· 48 commits to main since this 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: none exclusively 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 useOutsideDismiss hook utilizing event.isTrusted validation to prevent "ghost" pointer events from accidentally collapsing the HUD.
  • Viewport Integrity: Utilized viewport-fit=cover and 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 maxDiffPixelRatio thresholds.
  • 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 ENOENT errors by anchoring snapshotPathTemplate to {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 CIRCLE renders by surgically relaxing thresholds for high-anti-aliasing meshes (0.15 tolerance).
  • Drag Simulation Math: Fixed a FormulaHUD coordinate 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