Changelog

Current version: v0.2.23

Versions

Highlights

Default

Latest open

—Native .gro/.tpr + .xtc/.trr PAUSE stays clickable by mouse while dense frame commits are in flight
—Native multi-frame sessions now show movie export controls in RENDER using the decoded native frame count
—H-bond visualization refreshes to the selected native frame instead of showing previous-frame geometry

Fixed

•Native PLAY/PAUSE no longer disables the PAUSE button during frame loading, matching Space-key behavior
•Standard and path-traced movie export controls are visible for native trajectory sessions with more than one decoded frame
•Video export loads each native frame before preparing TRACE cages or H-bonds, so exports do not reuse frame-zero overlays
•Native frame navigation clears stale H-bond and cage geometry while preserving overlay intent for the current-frame TRACE refresh

—Native .gro/.tpr + .xtc/.trr uploads now offer continuous PLAY/PAUSE playback from the browser worker cache
—H-bond and hydrate-cage visualization context stays mounted while native frames advance
—Native frame controls block overlapping requests during dense commits while keeping PREV/NEXT/JUMP available

Added

+Browser-local native playback controls with loop and speed settings for decoded GROMACS trajectories

Fixed

•Native playback no longer clears analysis surfaces on ordinary view or playback frame changes
•Scene performance policy keeps active native TRACE/H-bond/cage overlays mounted during selected-frame loads
•Native playback clamps or wraps at trajectory boundaries instead of overflowing past the decoded frame count

—Native trajectories now render bonds at rest, matching the static .gro ball-and-stick appearance
—Cage / H-bond overlays no longer vanish after advancing one native frame — they appear immediately for the current frame
—Fixed a crash when auto-analysis ran on a native frame advance

Changed

~Bonds are suppressed only during an in-flight native frame fetch (dense transition), not permanently for large native scenes
~The analysis overlay gate reopens on the next paint after results commit instead of after a fixed delay

Fixed

•Native trajectory rendering matches static .gro at rest (bonds shown), without the previous bare-spheres mismatch
•Per-frame auto-analysis no longer crashes on native trajectories and reads the correct current-frame coordinates
•Cage and H-bond overlays surface immediately after each native frame advance instead of requiring a second advance

—Large native GROMACS trajectories (.gro/.tpr + .xtc/.trr) now render as full instanced spheres instead of a flat point cloud
—Frame scrubbing stays responsive — coordinates stream into instance matrices without rebuilding topology or colors
—Unsupported TPR files (e.g. TPX 122) now guide you to load the matching .gro topology, which works and renders identically

Changed

~Scene performance policy caps preview atoms only during an in-flight native frame load; at rest, all atoms render as spheres
~AtomCloud separates topology/appearance grouping from per-frame coordinate buffers so only instance matrices update per frame

Fixed

•Large native GROMACS trajectories render with the normal sphere-and-bond molecular style instead of tiny dots
•Unsupported-TPR errors point users to the .gro topology path instead of suggesting another TPR binary

—Large static systems (50k+ atoms) now render as full instanced spheres instead of a flat point cloud, matching the look of small systems
—Dense emulsion and solvated `.gro`/`.pdb` inputs no longer appear as tiny dots
—The point-cloud path is now reserved for large native GROMACS trajectory streaming where frame-scrub responsiveness needs it

Changed

~Scene performance policy now drives the point renderer only for large native trajectory scenes, not for large static structures
~The viewport render branch is now governed solely by the performance policy instead of a redundant raw atom-count threshold

Fixed

•Large static structures (50k+ atoms) render with the normal sphere-and-bond molecular style, restoring the expected appearance for big emulsion systems

—Large native GROMACS frame jumps now stay responsive by keeping dense viewport navigation on a capped point-preview path
—Native selected-frame updates stream worker coordinate buffers directly into render positions instead of rebuilding full atom objects
—Molecular point geometry and typed attributes are reused across same-count frame updates
—Position buffers are separated from residue style buffers so coordinate-only frame changes avoid color and opacity rebuilds
—Browser and Chrome QA now verify real seed_growth_235K TPR/XTC frame jumps with performance evidence

Added

+Native frame decode, post-decode, and commit timing measures for dense trajectory QA
+Large native trajectory Browser/Chromium and Chrome-channel evidence for frame 12/24/12 navigation

Changed

~Dense native GROMACS viewport rendering now keeps the capped point preview active after frame loading so the next frame command remains interactive
~Native view frame commits now use renderPositions while analysis requests can still materialize a full scientific Frame
~Point rendering now reuses geometry and style buffers when topology and visual settings are unchanged

Fixed

•Large native trajectory frame jumps no longer freeze the viewport for tens of seconds after the visible frame changes
•Dense native scenes no longer expand immediately back to full-detail atom rendering after every selected-frame update
•TRACE/HTR/GRADE overlay commit feedback stays bounded by the dense-scene performance policy while preserving current-frame analysis state

—.gro + .xtc and .gro + .trr uploads now preserve GRO residue and atom metadata during native binary playback
—Mixed TPR layouts now fail safely instead of being silently relabeled as all-SOL water when topology metadata is unsupported
—Dense residue/layer visual edits show busy feedback and coalesce rapid slider changes so large scenes feel active instead of frozen
—TRACE/H-bond overlays refresh by trajectory frame and share one preparation path for WebGL and path-traced video export
—Standard Export now follows Preview Mode render-frame crop and output dimensions while excluding preview-only guide artifacts
—Background-only path-traced renders now include recovery actions such as Center Frame and Reset 16:9

Added

+GRO topology metadata pairing for native XTC/TRR playback with atom-index validation and count-specific mismatch errors
+Frame-aware TRACE/H-bond cache keys across algorithm, layer, frame, cutoff, and active trajectory state
+Busy-work feedback for dense visual setting commits such as high-count residue opacity and size changes
+Background-only render recovery controls that update camera/crop state without requiring a page reload

Changed

~Exact-residue binary trajectory guidance now recommends .gro + .xtc/.trr when TPR metadata cannot be decoded faithfully
~WebGL and path-traced video exports now prepare active overlays through the same frame preparation helper
~Standard WebGL PNG export now uses the configured render frame when Preview Mode is active instead of raw viewport capture

Fixed

•GRO-paired binary trajectories no longer collapse HSL, SOL, SLAB, CH4, or other residue channels into a generic trajectory scene
•Unsupported mixed TPR topologies no longer fall through to the simple water recipe
•Trajectory frame changes no longer automatically discard active TRACE/H-bond overlay intent
•Native frame loading and analysis-commit overlays now show visibly animated indeterminate progress instead of a static-looking bar
•HTR/GRADE trajectory frame changes no longer start stale analysis-commit overlays when only TRACE has a frame-aware auto-refresh path
•Preview-only render-frame guides, focus markers, and light indicators are hidden during Standard Export capture
•HTR analysis visualization no longer triggers a Maximum update depth error while committing overlays

—Paired .tpr + .xtc and .tpr + .trr uploads now open as native browser-local trajectory sessions
—Binary GROMACS frames decode in a worker and use selected-frame PREV/NEXT/JUMP controls for dense native sessions
—Mixed-residue layers now expose residue channels for independent visibility and styling
—GROMACS upload copy now points users to paired native playback instead of conversion-first guidance

Added

+Stable TPR topology metadata decoding with real atom names, residue names, residue numbers, and molecule-block summaries
+GROMACS 2026.2 fixture-backed decoder proof for .tpr + .xtc and .tpr + .trr sessions
+Worker-backed native GROMACS trajectory loading with staged busy overlay progress
+Decoded-frame GRO adapter so trajectory analysis can run on native binary sessions
+Residue-aware layer channels for per-residue visibility, atom scale, stick width, opacity, color mode, and render style

Changed

~Dashboard file picker accepts paired topology/trajectory selections in one upload action
~Native binary GROMACS sessions now disable continuous scrubber playback and guide users toward selected-frame streaming
~Binary GROMACS capability copy now distinguishes paired playback from unsupported standalone .tpr files
~Path-traced render dimensions now start at a lighter 1280 x 720 default while keeping 1080p as an explicit preset

Fixed

•Corrupt binary trajectories now fail with typed decoder errors instead of stale scene mutation
•Native TRR playback uses a CLAVISCAGE padding-aware parser fallback for GROMACS 2026 TRR files

—Hydrate-water aliases such as HSL now participate in cage-water analysis instead of being treated as guest residues
—PDB and CIF/mmCIF text structures now load into the same browser-local frame model as GRO structures
—GROMACS XTC, TRR, and TPR uploads are recognized with topology/trajectory guidance instead of failing as unknown file types
—Large path-traced exports keep far molecular scenes inside the export camera clipping range

Added

+Shared residue taxonomy for water, hydrate-water, guest, metal/slab, geologic/mineral, biomolecule, and unknown categories
+PDB CRYST1 plus ATOM/HETATM coordinate parsing and CIF/mmCIF atom_site Cartesian coordinate parsing
+Metal and geologic residue coloring for structures such as SLAB/Fe and montmorillonite-like residues
+X/Y/Z viewport orientation controls that initialize and reset the camera from the selected positive axis toward the scene
+CPU Path Tracer availability now follows browser Worker/ImageData support by default, with explicit deployment opt-out support
+Mouse-pointer Drag Frame affordance for crop adjustment discovery
+Live scene busy overlay for file processing, frame streaming, and analysis work
+HTR complete-cage guest occupancy assignment when guest residues are present
+Richer staged loading and long-running-work overlays for startup, parsing, frame streaming, and analysis

Changed

~Dashboard upload controls now accept .gro, .pdb, .cif, .mmcif, .xtc, .trr, and .tpr inputs
~Water extraction, guest extraction, live preview colors, and path-traced colors now share residue classification logic
~H-bond visualization defaults now start at line width 2.0 and opacity 50% in preview and path-traced fallback surfaces

Fixed

•Orthographic close-zoom inspection no longer drops molecular batches when the camera frustum becomes tight
•CPU path-traced renders now use the live camera target and the same render-frame crop selection as GPU path tracing
•Path-traced render completion now rejects empty scenes and all-background outputs instead of presenting a blank preview/download as complete
•Algorithm-specific analysis snapshots prevent TRACE, HTR, and GRADE cage/occupancy overlays from mixing after algorithm switches
•New primary structure uploads clear stale analysis-complete popups before scene rebuild
•Recognized .xtc/.trr/.tpr inputs show topology/trajectory guidance instead of a red parser error

—Dashboard render IA now exposes clearer VIEW, ANALYZE, RESULTS, LAYERS, and RENDER states with semantic chips
—RAY-TRACED EXPORT now shows a Render Resource selector for GPU WebGL and the gated CPU still-image fallback
—Drag Frame crops now update output WIDTH/HEIGHT to match the drawn crop aspect while preserving pixel area

Added

+Desktop sidebar resizing with drag clamps while preserving the mobile layout
+CPU still-image fallback behind NEXT_PUBLIC_ENABLE_CPU_RENDERER=true with deterministic Worker rendering, progress, cancel, and typed render limits
+Render Resource controls that identify GPU WebGL as the default browser path-tracer backend and CPU as a feature-flagged still PNG path
+ARIA tab, tabpanel, aria-controls, aria-labelledby, roving focus, Home/End, and arrow-key support for dashboard sidebar tabs

Changed

~Dashboard navigation uses orientation-aware sidebar tabs on desktop plus semantic chips such as Render ready, Layers N, and Analysis pending
~Browser GPU Status and Render Resource cards prioritize concise summaries and hide dense GPU details behind disclosure
~Output Frame presents DRAG FRAME as the primary crop-adjustment action with a short scene hint
~Sidebar tab switching is controlled by React state instead of DOM query clicks

Fixed

•Drag Frame crops preserve pixel area while changing output dimensions, preventing stretched path-traced exports without runaway growth
•Render Resource backend cards stay contained at the minimum desktop sidebar width
•Local development without DATABASE_URL now returns JSON for AuthJS session and FREE usage checks instead of an HTML ClientFetchError
•Mobile sidebar tab labels stay readable by hiding compact icons/badges before the sm breakpoint
•Changelog accent buttons use black-on-yellow contrast for better readability
•The post-analysis VIEW RESULTS action now switches to RESULTS through React state instead of clicking a CSS selector

—RAY-TRACED EXPORT now shows a Render Resource selector so users can see the active GPU WebGL backend
—CPU path tracing is listed as unavailable instead of silently implying that WebGL rendering can be forced onto CPU
—The render button is guarded when an unavailable backend is selected, preventing misleading CPU render attempts

Added

+Render Resource controls for GPU WebGL versus CPU Path Tracer backend preference in the RENDER tab
+Truthful CPU path-tracing availability copy explaining that a separate JavaScript/WASM backend is required

Changed

~Path-traced render controls now report the selected compute resource before render starts

—The RENDER tab now reports browser GPU status so users can see when the WebGL path tracer is active
—Path-traced renders now request the browser high-performance GPU path and show render throughput metrics
—Atom geometry is grouped into baked merged BufferGeometry so the path tracer preserves atom positions while reducing scene object count

Added

+GPU capability probing for WebGL, WebGPU availability, exposed renderer details, and browser backend limitations
+Render metrics for scene build time, samples per second, mesh/object counts, triangle estimates, and path-tracer tile layout

Changed

~Path-traced renderer creation now consistently uses a high-performance WebGL context hint for both interactive renders and frame captures
~Atom path-tracing geometry now uses material/radius grouped baked BufferGeometry instead of cloning one sphere mesh per atom

—Path-traced output now matches the yellow Preview Mode render frame instead of stretching or zooming the scene into the wrong aspect
—Centered render frames and user-drawn crops now share the same viewport-normalized camera crop logic
—Orthographic and perspective path-traced cameras now start from the live preview viewport before applying the export crop

Added

+Shared render-frame helpers that resolve centered Preview Mode frames into explicit camera crop selections

Fixed

•Centered Preview Mode exports no longer ignore the yellow frame and render from a mismatched output aspect camera
•Orthographic path-traced exports now preserve the live viewport aspect before cropping to the requested output frame

—The public Features section now leads with the complete Clavis algorithm suite instead of implying cage detection is TRACE-only
—Landing feature cards now explicitly name TRACE, HTR, GRADE, F3/F4, guest occupancy, trajectory/layer workflows, and preview-matched exports
—The Features heading now frames the section as the Current Clavis Algorithm Suite for clearer scientific positioning

Changed

~Renamed the first landing feature card to Hydrate Algorithm Suite
~Rewrote visible feature-card copy to avoid deprecated TRACE-only or generic path-tracing language
~Updated structured-data and social metadata so SEO no longer frames Clavis as TRACE-only cage detection
~Bumped app metadata to v0.2.10 for the landing-copy clarification

—The public Features section now describes the current WASM-local Clavis workflow instead of older one-line capability blurbs
—Landing copy now names TRACE, HTR, GRADE, F3/F4, guest occupancy, trajectories, layers, and path-traced figure parity together
—Hero and SEO descriptions now emphasize browser-local analysis and no-backend upload expectations

Changed

~Renamed the landing feature heading to Current Clavis Workflow
~Refreshed feature cards for cage/ring detection, structure metrics, path-traced figures, trajectory/layer workflows, and guest occupancy filters
~Updated marketing metadata to match the current WASM-first product surface

—Path-traced renders now honor occupied guest highlights, guest size, guest bonds, cage occupancy emphasis, and hydrogen-bond width/opacity settings
—Drag Frame now uses the exact user-drawn crop instead of only deriving a centered aspect frame
—Dashboard theme changes carry into Changelog so dark/neon app sessions no longer open a light release page

Added

+Normalized render-frame crop selection shared by the scene overlay and path-traced camera view offsets
+Path-tracer guest highlight geometry with cyan neon halos and bonds for occupied guest molecules

Changed

~The former HD RESET control is now RESET 16:9 and resets both output dimensions and the crop frame
~Cage and H-bond path-traced geometry now follows the same visual controls used in the live preview more closely

Fixed

•Path-traced export no longer drops occupied guest emphasis or line-width settings compared with Preview Mode
•Small Drag Frame selections now define the exported crop instead of expanding back to a large centered frame
•Changelog theme state stays synchronized with the selected dashboard theme

—Marketing and dashboard layouts are easier to use on narrow mobile screens
—The #features landing-page anchor now resolves correctly from claviscage.app/#features
—Documentation and Terms now match the current WASM-first Clavis workflow

Added

+Responsive mobile menu behavior with an opaque foreground panel and body scroll lock
+Production-style Terms of Service copy covering scientific use, browser-local session state, and Lemon Squeezy billing

Changed

~Dashboard controls and tab lists now compact for mobile viewports instead of squeezing the scene
~Docs now describe Overall occupancy, occupied guest filters, render-frame export controls, browser-local recovery, and WASM/local processing more accurately

Fixed

•The landing-page Features navigation target is restored with an explicit features section anchor

—Camera position and OrbitControls target now restore with the recovered scene session
—Refresh/navigation recovery preserves the exact molecular viewing angle instead of only restoring settings

Fixed

•Recovered sessions no longer initialize the 3D scene back to the default camera view after settings restore

—Normal-size .gro scenes restore after accidental refresh or a quick Changelog visit
—Changelog entries now load as a folded timeline with the newest release expanded
—Release history remains scannable as more versions accumulate

Added

+Session-local scene recovery for recoverable .gro layers, view toggles, filters, and analysis overlays
+Accessible changelog accordion with latest-version default expansion

Changed

~The NEW badge can be used without discarding the current app scene session
~Large trajectory sessions intentionally skip Web Storage recovery to avoid quota failures

—Occupied guest SIZE now scales guest bonds together with atom cores
—Occupied guest highlight controls are accessible independently from cage wireframe visibility
—Guest visuals use a cleaner neon halo palette instead of warm/brown emphasis colors

Changed

~Guest bond thickness now follows the HIGHLIGHT OCCUPIED GUESTS size slider
~Multi-atom occupied guests receive translucent additive halos and cyan emissive bonds
~Single-atom occupied guest markers use brighter cyan-family emissive halos
~The aggregate metric label is now OVERALL OCCUPANCY where shown in the app UI

—Cage overlays no longer force occupied guest emphasis by default
—Occupied guests can be filtered by enclosing cage type and current GRADE structure bucket
—Single-atom guests now render as focused halo markers while multi-atom guests remain ball-and-stick

Added

+Explicit HIGHLIGHT OCCUPIED GUESTS toggle with visible/total guest count
+Guest-specific cage-type and current/global structure filters independent from cage wireframe filters
+Pure guest filter helpers with stale-selection reconciliation tests

Changed

~Guest highlights reset to off on new files, resets, and new cage-analysis results
~Single-atom occupied guests use a subtle emissive halo instead of the multi-atom molecule path

—RENDER tab now supports custom path-traced output width and height
—Preview Mode displays a centered Blender-style render frame overlay before export
—Drag Frame mode lets users set render aspect visually without changing normal scene navigation

Added

+OUTPUT FRAME controls with px inputs, common aspect presets, and HD reset
+Scene overlay that previews the centered render frame used by path-traced export
+Shared render dimension normalization and aspect helper tests

Changed

~Path-traced export no longer hardcodes 1920 × 1080; it uses user-selected dimensions
~Frontend test harness now pins jsdom 26.1 to keep Vitest compatible with the current local Node 20.9 environment

—Enclathrated CP/ECP guests now render as full atom-level molecules instead of one enlarged marker
—Guest occupancy uses molecule centroids while preserving cage assignment results
—RESULTS tab contrast improved for dark and neon themes

Added

+PBC-aware guest molecule extraction with per-atom metadata for .gro residues
+Ball-and-stick guest overlay for multi-atom enclathrated guests

Changed

~Guest SIZE control now scales atom-level guest overlays and keeps single-point fallback for legacy data

Fixed

•Multi-atom guests such as CP and ECP no longer collapse to a single yellow sphere in the cage view
•Several RESULTS cards and empty states now inherit theme text and border colors

—Calculate cage occupancy ratios (θ_S, θ_L) for guest molecules
—Multi-layer analysis with cross-layer guest detection
—Enclathrated guests visualized as spheres inside cage wireframes
—ENCLATHRATED GUESTS overlay panel with size control

Added

+Guest occupancy calculation via WASM calculate_occupancy
+Cross-layer guest collection from separate .gro layers
+ENCLATHRATED GUESTS checkbox and SIZE slider in overlay controls
+Guest sphere visualization (only enclathrated guests shown as spheres)

Fixed

•Guest layer click in LAYERS tab no longer shows error (silent ignore)
•Cage wire thickness restored to default 0.30 (was incorrectly set to 0.10)
•Filter used != null instead of !== null to correctly handle Rust Option::None → JS undefined

—Large .gro trajectory file support with background frame counting
—OAuth account linking fixed

Added

+Streaming large trajectory worker with frame anchoring

Fixed

•OAuth provider account linking
•WASM import compatibility

—TRACE, HTR, GRADE cage detection algorithms
—F3/F4 order parameters
—GPU path-traced rendering (PRO)
—MD trajectory support
—Layer management system

Added

+Core WASM engine with Rust-based cage detection
+React Three Fiber 3D visualization
+Lemon Squeezy payment integration
+Mintlify documentation site

Initializing ClavisCage

Large trajectories can take a moment. Work continues in your browser.

Still working locallyDecoder / WebGL / Analysis

Parsing structure workspace

Preparing WebGL viewport

Streaming molecular assets

Syncing analysis modules

← Back to App Home

Changelog

Current version: v0.2.23

Versions

Highlights

Default

Latest open

—Native .gro/.tpr + .xtc/.trr PAUSE stays clickable by mouse while dense frame commits are in flight
—Native multi-frame sessions now show movie export controls in RENDER using the decoded native frame count
—H-bond visualization refreshes to the selected native frame instead of showing previous-frame geometry

Fixed

•Native PLAY/PAUSE no longer disables the PAUSE button during frame loading, matching Space-key behavior
•Standard and path-traced movie export controls are visible for native trajectory sessions with more than one decoded frame
•Video export loads each native frame before preparing TRACE cages or H-bonds, so exports do not reuse frame-zero overlays
•Native frame navigation clears stale H-bond and cage geometry while preserving overlay intent for the current-frame TRACE refresh

—Native .gro/.tpr + .xtc/.trr uploads now offer continuous PLAY/PAUSE playback from the browser worker cache
—H-bond and hydrate-cage visualization context stays mounted while native frames advance
—Native frame controls block overlapping requests during dense commits while keeping PREV/NEXT/JUMP available

Added

+Browser-local native playback controls with loop and speed settings for decoded GROMACS trajectories

Fixed

•Native playback no longer clears analysis surfaces on ordinary view or playback frame changes
•Scene performance policy keeps active native TRACE/H-bond/cage overlays mounted during selected-frame loads
•Native playback clamps or wraps at trajectory boundaries instead of overflowing past the decoded frame count

—Native trajectories now render bonds at rest, matching the static .gro ball-and-stick appearance
—Cage / H-bond overlays no longer vanish after advancing one native frame — they appear immediately for the current frame
—Fixed a crash when auto-analysis ran on a native frame advance

Changed

~Bonds are suppressed only during an in-flight native frame fetch (dense transition), not permanently for large native scenes
~The analysis overlay gate reopens on the next paint after results commit instead of after a fixed delay

Fixed

•Native trajectory rendering matches static .gro at rest (bonds shown), without the previous bare-spheres mismatch
•Per-frame auto-analysis no longer crashes on native trajectories and reads the correct current-frame coordinates
•Cage and H-bond overlays surface immediately after each native frame advance instead of requiring a second advance

—Large native GROMACS trajectories (.gro/.tpr + .xtc/.trr) now render as full instanced spheres instead of a flat point cloud
—Frame scrubbing stays responsive — coordinates stream into instance matrices without rebuilding topology or colors
—Unsupported TPR files (e.g. TPX 122) now guide you to load the matching .gro topology, which works and renders identically

Changed

~Scene performance policy caps preview atoms only during an in-flight native frame load; at rest, all atoms render as spheres
~AtomCloud separates topology/appearance grouping from per-frame coordinate buffers so only instance matrices update per frame

Fixed

•Large native GROMACS trajectories render with the normal sphere-and-bond molecular style instead of tiny dots
•Unsupported-TPR errors point users to the .gro topology path instead of suggesting another TPR binary

—Large static systems (50k+ atoms) now render as full instanced spheres instead of a flat point cloud, matching the look of small systems
—Dense emulsion and solvated `.gro`/`.pdb` inputs no longer appear as tiny dots
—The point-cloud path is now reserved for large native GROMACS trajectory streaming where frame-scrub responsiveness needs it

Changed

~Scene performance policy now drives the point renderer only for large native trajectory scenes, not for large static structures
~The viewport render branch is now governed solely by the performance policy instead of a redundant raw atom-count threshold

Fixed

•Large static structures (50k+ atoms) render with the normal sphere-and-bond molecular style, restoring the expected appearance for big emulsion systems

—Large native GROMACS frame jumps now stay responsive by keeping dense viewport navigation on a capped point-preview path
—Native selected-frame updates stream worker coordinate buffers directly into render positions instead of rebuilding full atom objects
—Molecular point geometry and typed attributes are reused across same-count frame updates
—Position buffers are separated from residue style buffers so coordinate-only frame changes avoid color and opacity rebuilds
—Browser and Chrome QA now verify real seed_growth_235K TPR/XTC frame jumps with performance evidence

Added

+Native frame decode, post-decode, and commit timing measures for dense trajectory QA
+Large native trajectory Browser/Chromium and Chrome-channel evidence for frame 12/24/12 navigation

Changed

~Dense native GROMACS viewport rendering now keeps the capped point preview active after frame loading so the next frame command remains interactive
~Native view frame commits now use renderPositions while analysis requests can still materialize a full scientific Frame
~Point rendering now reuses geometry and style buffers when topology and visual settings are unchanged

Fixed

•Large native trajectory frame jumps no longer freeze the viewport for tens of seconds after the visible frame changes
•Dense native scenes no longer expand immediately back to full-detail atom rendering after every selected-frame update
•TRACE/HTR/GRADE overlay commit feedback stays bounded by the dense-scene performance policy while preserving current-frame analysis state

—.gro + .xtc and .gro + .trr uploads now preserve GRO residue and atom metadata during native binary playback
—Mixed TPR layouts now fail safely instead of being silently relabeled as all-SOL water when topology metadata is unsupported
—Dense residue/layer visual edits show busy feedback and coalesce rapid slider changes so large scenes feel active instead of frozen
—TRACE/H-bond overlays refresh by trajectory frame and share one preparation path for WebGL and path-traced video export
—Standard Export now follows Preview Mode render-frame crop and output dimensions while excluding preview-only guide artifacts
—Background-only path-traced renders now include recovery actions such as Center Frame and Reset 16:9

Added

+GRO topology metadata pairing for native XTC/TRR playback with atom-index validation and count-specific mismatch errors
+Frame-aware TRACE/H-bond cache keys across algorithm, layer, frame, cutoff, and active trajectory state
+Busy-work feedback for dense visual setting commits such as high-count residue opacity and size changes
+Background-only render recovery controls that update camera/crop state without requiring a page reload

Changed

~Exact-residue binary trajectory guidance now recommends .gro + .xtc/.trr when TPR metadata cannot be decoded faithfully
~WebGL and path-traced video exports now prepare active overlays through the same frame preparation helper
~Standard WebGL PNG export now uses the configured render frame when Preview Mode is active instead of raw viewport capture

Fixed

•GRO-paired binary trajectories no longer collapse HSL, SOL, SLAB, CH4, or other residue channels into a generic trajectory scene
•Unsupported mixed TPR topologies no longer fall through to the simple water recipe
•Trajectory frame changes no longer automatically discard active TRACE/H-bond overlay intent
•Native frame loading and analysis-commit overlays now show visibly animated indeterminate progress instead of a static-looking bar
•HTR/GRADE trajectory frame changes no longer start stale analysis-commit overlays when only TRACE has a frame-aware auto-refresh path
•Preview-only render-frame guides, focus markers, and light indicators are hidden during Standard Export capture
•HTR analysis visualization no longer triggers a Maximum update depth error while committing overlays

—Paired .tpr + .xtc and .tpr + .trr uploads now open as native browser-local trajectory sessions
—Binary GROMACS frames decode in a worker and use selected-frame PREV/NEXT/JUMP controls for dense native sessions
—Mixed-residue layers now expose residue channels for independent visibility and styling
—GROMACS upload copy now points users to paired native playback instead of conversion-first guidance

Added

+Stable TPR topology metadata decoding with real atom names, residue names, residue numbers, and molecule-block summaries
+GROMACS 2026.2 fixture-backed decoder proof for .tpr + .xtc and .tpr + .trr sessions
+Worker-backed native GROMACS trajectory loading with staged busy overlay progress
+Decoded-frame GRO adapter so trajectory analysis can run on native binary sessions
+Residue-aware layer channels for per-residue visibility, atom scale, stick width, opacity, color mode, and render style

Changed

~Dashboard file picker accepts paired topology/trajectory selections in one upload action
~Native binary GROMACS sessions now disable continuous scrubber playback and guide users toward selected-frame streaming
~Binary GROMACS capability copy now distinguishes paired playback from unsupported standalone .tpr files
~Path-traced render dimensions now start at a lighter 1280 x 720 default while keeping 1080p as an explicit preset

Fixed

•Corrupt binary trajectories now fail with typed decoder errors instead of stale scene mutation
•Native TRR playback uses a CLAVISCAGE padding-aware parser fallback for GROMACS 2026 TRR files

—Hydrate-water aliases such as HSL now participate in cage-water analysis instead of being treated as guest residues
—PDB and CIF/mmCIF text structures now load into the same browser-local frame model as GRO structures
—GROMACS XTC, TRR, and TPR uploads are recognized with topology/trajectory guidance instead of failing as unknown file types
—Large path-traced exports keep far molecular scenes inside the export camera clipping range

Added

+Shared residue taxonomy for water, hydrate-water, guest, metal/slab, geologic/mineral, biomolecule, and unknown categories
+PDB CRYST1 plus ATOM/HETATM coordinate parsing and CIF/mmCIF atom_site Cartesian coordinate parsing
+Metal and geologic residue coloring for structures such as SLAB/Fe and montmorillonite-like residues
+X/Y/Z viewport orientation controls that initialize and reset the camera from the selected positive axis toward the scene
+CPU Path Tracer availability now follows browser Worker/ImageData support by default, with explicit deployment opt-out support
+Mouse-pointer Drag Frame affordance for crop adjustment discovery
+Live scene busy overlay for file processing, frame streaming, and analysis work
+HTR complete-cage guest occupancy assignment when guest residues are present
+Richer staged loading and long-running-work overlays for startup, parsing, frame streaming, and analysis

Changed

~Dashboard upload controls now accept .gro, .pdb, .cif, .mmcif, .xtc, .trr, and .tpr inputs
~Water extraction, guest extraction, live preview colors, and path-traced colors now share residue classification logic
~H-bond visualization defaults now start at line width 2.0 and opacity 50% in preview and path-traced fallback surfaces

Fixed

•Orthographic close-zoom inspection no longer drops molecular batches when the camera frustum becomes tight
•CPU path-traced renders now use the live camera target and the same render-frame crop selection as GPU path tracing
•Path-traced render completion now rejects empty scenes and all-background outputs instead of presenting a blank preview/download as complete
•Algorithm-specific analysis snapshots prevent TRACE, HTR, and GRADE cage/occupancy overlays from mixing after algorithm switches
•New primary structure uploads clear stale analysis-complete popups before scene rebuild
•Recognized .xtc/.trr/.tpr inputs show topology/trajectory guidance instead of a red parser error

—Dashboard render IA now exposes clearer VIEW, ANALYZE, RESULTS, LAYERS, and RENDER states with semantic chips
—RAY-TRACED EXPORT now shows a Render Resource selector for GPU WebGL and the gated CPU still-image fallback
—Drag Frame crops now update output WIDTH/HEIGHT to match the drawn crop aspect while preserving pixel area

Added

+Desktop sidebar resizing with drag clamps while preserving the mobile layout
+CPU still-image fallback behind NEXT_PUBLIC_ENABLE_CPU_RENDERER=true with deterministic Worker rendering, progress, cancel, and typed render limits
+Render Resource controls that identify GPU WebGL as the default browser path-tracer backend and CPU as a feature-flagged still PNG path
+ARIA tab, tabpanel, aria-controls, aria-labelledby, roving focus, Home/End, and arrow-key support for dashboard sidebar tabs

Changed

~Dashboard navigation uses orientation-aware sidebar tabs on desktop plus semantic chips such as Render ready, Layers N, and Analysis pending
~Browser GPU Status and Render Resource cards prioritize concise summaries and hide dense GPU details behind disclosure
~Output Frame presents DRAG FRAME as the primary crop-adjustment action with a short scene hint
~Sidebar tab switching is controlled by React state instead of DOM query clicks

Fixed

•Drag Frame crops preserve pixel area while changing output dimensions, preventing stretched path-traced exports without runaway growth
•Render Resource backend cards stay contained at the minimum desktop sidebar width
•Local development without DATABASE_URL now returns JSON for AuthJS session and FREE usage checks instead of an HTML ClientFetchError
•Mobile sidebar tab labels stay readable by hiding compact icons/badges before the sm breakpoint
•Changelog accent buttons use black-on-yellow contrast for better readability
•The post-analysis VIEW RESULTS action now switches to RESULTS through React state instead of clicking a CSS selector

—RAY-TRACED EXPORT now shows a Render Resource selector so users can see the active GPU WebGL backend
—CPU path tracing is listed as unavailable instead of silently implying that WebGL rendering can be forced onto CPU
—The render button is guarded when an unavailable backend is selected, preventing misleading CPU render attempts

Added

+Render Resource controls for GPU WebGL versus CPU Path Tracer backend preference in the RENDER tab
+Truthful CPU path-tracing availability copy explaining that a separate JavaScript/WASM backend is required

Changed

~Path-traced render controls now report the selected compute resource before render starts

—The RENDER tab now reports browser GPU status so users can see when the WebGL path tracer is active
—Path-traced renders now request the browser high-performance GPU path and show render throughput metrics
—Atom geometry is grouped into baked merged BufferGeometry so the path tracer preserves atom positions while reducing scene object count

Added

+GPU capability probing for WebGL, WebGPU availability, exposed renderer details, and browser backend limitations
+Render metrics for scene build time, samples per second, mesh/object counts, triangle estimates, and path-tracer tile layout

Changed

~Path-traced renderer creation now consistently uses a high-performance WebGL context hint for both interactive renders and frame captures
~Atom path-tracing geometry now uses material/radius grouped baked BufferGeometry instead of cloning one sphere mesh per atom

—Path-traced output now matches the yellow Preview Mode render frame instead of stretching or zooming the scene into the wrong aspect
—Centered render frames and user-drawn crops now share the same viewport-normalized camera crop logic
—Orthographic and perspective path-traced cameras now start from the live preview viewport before applying the export crop

Added

+Shared render-frame helpers that resolve centered Preview Mode frames into explicit camera crop selections

Fixed

•Centered Preview Mode exports no longer ignore the yellow frame and render from a mismatched output aspect camera
•Orthographic path-traced exports now preserve the live viewport aspect before cropping to the requested output frame

—The public Features section now leads with the complete Clavis algorithm suite instead of implying cage detection is TRACE-only
—Landing feature cards now explicitly name TRACE, HTR, GRADE, F3/F4, guest occupancy, trajectory/layer workflows, and preview-matched exports
—The Features heading now frames the section as the Current Clavis Algorithm Suite for clearer scientific positioning

Changed

~Renamed the first landing feature card to Hydrate Algorithm Suite
~Rewrote visible feature-card copy to avoid deprecated TRACE-only or generic path-tracing language
~Updated structured-data and social metadata so SEO no longer frames Clavis as TRACE-only cage detection
~Bumped app metadata to v0.2.10 for the landing-copy clarification

—The public Features section now describes the current WASM-local Clavis workflow instead of older one-line capability blurbs
—Landing copy now names TRACE, HTR, GRADE, F3/F4, guest occupancy, trajectories, layers, and path-traced figure parity together
—Hero and SEO descriptions now emphasize browser-local analysis and no-backend upload expectations

Changed

~Renamed the landing feature heading to Current Clavis Workflow
~Refreshed feature cards for cage/ring detection, structure metrics, path-traced figures, trajectory/layer workflows, and guest occupancy filters
~Updated marketing metadata to match the current WASM-first product surface

—Path-traced renders now honor occupied guest highlights, guest size, guest bonds, cage occupancy emphasis, and hydrogen-bond width/opacity settings
—Drag Frame now uses the exact user-drawn crop instead of only deriving a centered aspect frame
—Dashboard theme changes carry into Changelog so dark/neon app sessions no longer open a light release page

Added

+Normalized render-frame crop selection shared by the scene overlay and path-traced camera view offsets
+Path-tracer guest highlight geometry with cyan neon halos and bonds for occupied guest molecules

Changed

~The former HD RESET control is now RESET 16:9 and resets both output dimensions and the crop frame
~Cage and H-bond path-traced geometry now follows the same visual controls used in the live preview more closely

Fixed

•Path-traced export no longer drops occupied guest emphasis or line-width settings compared with Preview Mode
•Small Drag Frame selections now define the exported crop instead of expanding back to a large centered frame
•Changelog theme state stays synchronized with the selected dashboard theme

—Marketing and dashboard layouts are easier to use on narrow mobile screens
—The #features landing-page anchor now resolves correctly from claviscage.app/#features
—Documentation and Terms now match the current WASM-first Clavis workflow

Added

+Responsive mobile menu behavior with an opaque foreground panel and body scroll lock
+Production-style Terms of Service copy covering scientific use, browser-local session state, and Lemon Squeezy billing

Changed

~Dashboard controls and tab lists now compact for mobile viewports instead of squeezing the scene
~Docs now describe Overall occupancy, occupied guest filters, render-frame export controls, browser-local recovery, and WASM/local processing more accurately

Fixed

•The landing-page Features navigation target is restored with an explicit features section anchor

—Camera position and OrbitControls target now restore with the recovered scene session
—Refresh/navigation recovery preserves the exact molecular viewing angle instead of only restoring settings

Fixed

•Recovered sessions no longer initialize the 3D scene back to the default camera view after settings restore

—Normal-size .gro scenes restore after accidental refresh or a quick Changelog visit
—Changelog entries now load as a folded timeline with the newest release expanded
—Release history remains scannable as more versions accumulate

Added

+Session-local scene recovery for recoverable .gro layers, view toggles, filters, and analysis overlays
+Accessible changelog accordion with latest-version default expansion

Changed

~The NEW badge can be used without discarding the current app scene session
~Large trajectory sessions intentionally skip Web Storage recovery to avoid quota failures

—Occupied guest SIZE now scales guest bonds together with atom cores
—Occupied guest highlight controls are accessible independently from cage wireframe visibility
—Guest visuals use a cleaner neon halo palette instead of warm/brown emphasis colors

Changed

~Guest bond thickness now follows the HIGHLIGHT OCCUPIED GUESTS size slider
~Multi-atom occupied guests receive translucent additive halos and cyan emissive bonds
~Single-atom occupied guest markers use brighter cyan-family emissive halos
~The aggregate metric label is now OVERALL OCCUPANCY where shown in the app UI

—Cage overlays no longer force occupied guest emphasis by default
—Occupied guests can be filtered by enclosing cage type and current GRADE structure bucket
—Single-atom guests now render as focused halo markers while multi-atom guests remain ball-and-stick

Added

+Explicit HIGHLIGHT OCCUPIED GUESTS toggle with visible/total guest count
+Guest-specific cage-type and current/global structure filters independent from cage wireframe filters
+Pure guest filter helpers with stale-selection reconciliation tests

Changed

~Guest highlights reset to off on new files, resets, and new cage-analysis results
~Single-atom occupied guests use a subtle emissive halo instead of the multi-atom molecule path

—RENDER tab now supports custom path-traced output width and height
—Preview Mode displays a centered Blender-style render frame overlay before export
—Drag Frame mode lets users set render aspect visually without changing normal scene navigation

Added

+OUTPUT FRAME controls with px inputs, common aspect presets, and HD reset
+Scene overlay that previews the centered render frame used by path-traced export
+Shared render dimension normalization and aspect helper tests

Changed

~Path-traced export no longer hardcodes 1920 × 1080; it uses user-selected dimensions
~Frontend test harness now pins jsdom 26.1 to keep Vitest compatible with the current local Node 20.9 environment

—Enclathrated CP/ECP guests now render as full atom-level molecules instead of one enlarged marker
—Guest occupancy uses molecule centroids while preserving cage assignment results
—RESULTS tab contrast improved for dark and neon themes

Added

+PBC-aware guest molecule extraction with per-atom metadata for .gro residues
+Ball-and-stick guest overlay for multi-atom enclathrated guests

Changed

~Guest SIZE control now scales atom-level guest overlays and keeps single-point fallback for legacy data

Fixed

•Multi-atom guests such as CP and ECP no longer collapse to a single yellow sphere in the cage view
•Several RESULTS cards and empty states now inherit theme text and border colors

—Calculate cage occupancy ratios (θ_S, θ_L) for guest molecules
—Multi-layer analysis with cross-layer guest detection
—Enclathrated guests visualized as spheres inside cage wireframes
—ENCLATHRATED GUESTS overlay panel with size control

Added

+Guest occupancy calculation via WASM calculate_occupancy
+Cross-layer guest collection from separate .gro layers
+ENCLATHRATED GUESTS checkbox and SIZE slider in overlay controls
+Guest sphere visualization (only enclathrated guests shown as spheres)

Fixed

•Guest layer click in LAYERS tab no longer shows error (silent ignore)
•Cage wire thickness restored to default 0.30 (was incorrectly set to 0.10)
•Filter used != null instead of !== null to correctly handle Rust Option::None → JS undefined

—Large .gro trajectory file support with background frame counting
—OAuth account linking fixed

Added

+Streaming large trajectory worker with frame anchoring

Fixed

•OAuth provider account linking
•WASM import compatibility

—TRACE, HTR, GRADE cage detection algorithms
—F3/F4 order parameters
—GPU path-traced rendering (PRO)
—MD trajectory support
—Layer management system

Added

+Core WASM engine with Rust-based cage detection
+React Three Fiber 3D visualization
+Lemon Squeezy payment integration
+Mintlify documentation site