v0.5.0

11 August 2026

⚠️ Breaking Changes

• Narrow the public API: import plot components from matterviz/plot rather than matterviz/plot/...; the matterviz/json-path, matterviz/marching-cubes, and matterviz/file-viewer/eligibility subpaths and broad root/core re-exports are no longer public #431
• Require Svelte 5.48 or newer
• Migrate VS Code settings: matterviz.structure.show_cell and matterviz.plot.show_x2_grid are no longer supported; replace matterviz.plot.{show_x_grid,show_y_grid,show_y2_grid} with the corresponding matterviz.{histogram,bar,box,scatter}.display.{x_grid,y_grid,y2_grid} setting.
• The removed camera settings matterviz.convex_hull.binary.camera_center_x, matterviz.convex_hull.binary.camera_center_y, matterviz.convex_hull.ternary.camera_center_x, matterviz.convex_hull.ternary.camera_center_y, matterviz.convex_hull.quaternary.camera_center_x, and matterviz.convex_hull.quaternary.camera_center_y have no setting replacements; pan hull views interactively instead.
• The remaining removed legacy matterviz.plot.* and matterviz.trajectory.* settings have no replacements. This includes plot animation, auto-range, zoom, trajectory caching/chunking, playback-loop, prefetch, memory, formatting, tooltip, and compact-control settings.

🚀 New Features

• Add a JupyterLab file viewer for structures, trajectories, volumetric data, bands, DOS, and other supported materials files #421
• Add per-atom trajectory analysis, CNA and centrosymmetry, VACF/VDOS, trajectory lines, a data inspector, and CSV export #422
• Add plot facets, coordinated axes, adaptive ticks and titles, shared decoration placement, and improved accessibility #425

🛠 Enhancements

• Improve camera framing, color parsing, extXYZ fidelity, and trajectory data export #420
• Overhaul plot controls, legends, dense rendering, searchable settings, and viewer preferences #424 #426 #427
• Speed up plots, convex hulls, and tables while improving their correctness and interaction behavior #428
• Derive readable foreground colors automatically from a shared theme backdrop token #429

💡 Refactoring

• Share reusable file-parsing utilities across the library and extensions #423
• Consolidate common tooling, test helpers, settings factories, and maintenance infrastructure #430