v5.0.0

5.0.0 (2026-10-20)

⚠ BREAKING CHANGES

• the frameYaw and templeWidth props and the templeWidthBoost calibration field are removed. Delete the props; old calibration manifests keep working (the field is ignored).

Features

• capture() snapshot of the composited try-on (32c7328)
• capture() snapshot of the composited try-on (5f794bc), closes #93
• face measurements, face shape and catalog-wide fit ranking (e4f5a13)
• face measurements, face shape and catalog-wide fit ranking (584905b), closes #98
• freeze() / unfreeze() to compare frames on a held pose (fdb4016)
• freeze() / unfreeze() to compare frames on a held pose (9b7c2ea), closes #97
• GLB cache and neighbour prefetch for instant frame switching (0712f63)
• GLB cache and neighbour prefetch for instant frame switching (fd9b6d3), closes #94
• lens darkness in physical units, gradient lenses, colour QA tooling (28093fa)
• lens darkness in physical units, gradient lenses, colour QA tooling (20499d9), closes #85
• lens reflections from the camera feed and the room's light direction (4598ace)
• lens reflections from the camera feed and the room's light direction (6ca35aa), closes #84
• match the webcam with grain, a slight blur and light wrap (57c8411)
• match the webcam with grain, a slight blur and light wrap (d2ee85a), closes #86
• multiply contact shadow and add soft contact occlusion (9ac1493)
• multiply contact shadow and add soft contact occlusion (974c669), closes #88
• one-command model prep, model lint and calibration validation (a90c52a)
• one-command model prep, model lint and calibration validation (2a3d5a4), closes #103
• open temple arms at the hinge to meet the tracked head (63231a1)
• open temple arms at the hinge to meet the tracked head (383bac1), closes #83
• opt-in tinted lens shadow (90b7d7c)
• opt-in tinted lens shadow (6a02658), closes #88
• optional card calibration for a ±1 mm PD (35e6f74)
• optional card calibration for a ±1 mm PD (3fb7b4f), closes #96
• optional ear bend of the temple tips behind the ear (45026eb)
• optional ear bend of the temple tips behind the ear (a5cb4f5), closes #83
• pad-contact nose seat (opt-in) and a pantoscopic tilt audit (1f739bc)
• pad-contact nose seat (opt-in) and a pantoscopic tilt audit (db9253e), closes #87
• remove frameYaw, templeWidth and templeWidthBoost (cd1369d), closes #101
• size the frame true to size from the iris-measured PD (8d31c3f)
• size the frame true to size from the iris-measured PD (962b7d4), closes #92

Bug Fixes

• contact-occlusion spheres follow the hinged temple arms and the ear bend (5a45def)
• contact-occlusion spheres follow the hinged temple arms and the ear bend (7a1efed)
• eight cross-feature bugs found by auditing the Roadmap 2 merge (d63e44e)
• eight cross-feature bugs found by auditing the Roadmap 2 merge (6842ac1)
• gate the contact-shadow receiver on the prop again (6710bee)
• hold the frame through short tracking dropouts; turnBack and tooDark hints (3d58b3f)
• hold the frame through short tracking dropouts; turnBack and tooDark hints (0cfa7e7), closes #99

Performance

• time-to-first-frame budget: measure, parallelise, preconnect, self-host (eb417fe)
• time-to-first-frame budget: measure, parallelise, preconnect, self-host (ab1fd99), closes #95

Documentation

• agents: internal scene/experience composables and the 400-line SFC rule (4cb2e83)
• drop the company name from the license note (334f1ee)
• frame-removal research spike (41006f9)
• frame-removal research spike (e363726), closes #100
• public demo on GitHub Pages and README overhaul (2561e6e)
• public demo on GitHub Pages and README overhaul (512c6fb), closes #104
• record the landed roadmap-2 PRs (55fe695)
• record the landed roadmap-2 PRs (eedcd6c), closes #88
• research realism of shadows, fit, temples and colour (49ce06b)
• research realism of shadows, fit, temples and colour (e6c1b42)
• roadmap 2 status and merge plan (e01ee0a)
• roadmap 2 status and merge plan (a1f8f42)

Refactoring

• experience: split VirtualTryOnExperience.vue into internal composables (4384770)
• scene: split TryOnScene.vue into internal composables (3e80aee)
• split TryOnScene and VirtualTryOnExperience into internal composables (2fb4f74)