chore: deep clean codebase, bump version to 0.5.6

Remove dead code (HEX_ROTATION_MAP, pick_structure_at_screen_pos,
set_background_color, frame_tick/request_redraw stubs). Narrow
#[allow(dead_code)] to specific fields. Consolidate boilerplate
with impl_transform_accessors! and impl_structure_accessors! macros.
Add From<u32> impls on camera enums to simplify ui_sync.rs.
Net reduction of ~350 lines.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: xarthurx

CHANGELOG.md

@@ -5,6 +5,16 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.5.6] - 2026-02-03
+
+### Changed
+- **Code cleanup:** Removed dead code (unused `HEX_ROTATION_MAP`, `pick_structure_at_screen_pos`, `set_background_color`, `frame_tick`, `request_redraw`)
+- **Code cleanup:** Narrowed `#[allow(dead_code)]` from struct-level to field-level on `ShadowMapPass`, `CurveNetwork`, `VolumeGridCellScalarQuantity`; removed unnecessary annotation from `VolumeGrid`
+- **Code consolidation:** Introduced `impl_transform_accessors!` macro to deduplicate transform getter/setter boilerplate
+- **Code consolidation:** Introduced `impl_structure_accessors!` macro to deduplicate `get_*`/`with_*`/`with_*_ref` across 6 structure modules
+- **Code consolidation:** Added `From<u32>` / `From<Enum> for u32` impls on `NavigationStyle`, `ProjectionMode`, `AxisDirection` to simplify `ui_sync.rs`
+- Net reduction of ~350 lines of boilerplate
+
 ## [0.5.5] - 2025-02-03
 
 ### Added

CLAUDE.md

@@ -4,7 +4,7 @@ This file provides guidance to Claude Code when working with this repository.
 
 ## Project Overview
 
-polyscope-rs is a Rust-native 3D visualization library for geometric data, ported from C++ [Polyscope](https://polyscope.run). **Core paradigm**: Structures (geometric objects) + Quantities (data on structures). Version 0.5.5, ~100% feature parity with C++ Polyscope 2.x.
+polyscope-rs is a Rust-native 3D visualization library for geometric data, ported from C++ [Polyscope](https://polyscope.run). **Core paradigm**: Structures (geometric objects) + Quantities (data on structures). Version 0.5.6, ~100% feature parity with C++ Polyscope 2.x.
 
 ## Build Commands
 

Cargo.toml

@@ -9,7 +9,7 @@ members = [
 ]
 
 [workspace.package]
-version = "0.5.5"
+version = "0.5.6"
 edition = "2024"
 rust-version = "1.85"
 license = "MIT"

crates/polyscope-render/src/camera.rs

@@ -21,6 +21,32 @@ pub enum NavigationStyle {
     None,
 }
 
+impl From<u32> for NavigationStyle {
+    fn from(v: u32) -> Self {
+        match v {
+            0 => Self::Turntable,
+            1 => Self::Free,
+            2 => Self::Planar,
+            3 => Self::Arcball,
+            4 => Self::FirstPerson,
+            _ => Self::None,
+        }
+    }
+}
+
+impl From<NavigationStyle> for u32 {
+    fn from(v: NavigationStyle) -> Self {
+        match v {
+            NavigationStyle::Turntable => 0,
+            NavigationStyle::Free => 1,
+            NavigationStyle::Planar => 2,
+            NavigationStyle::Arcball => 3,
+            NavigationStyle::FirstPerson => 4,
+            NavigationStyle::None => 5,
+        }
+    }
+}
+
 /// Camera projection mode.
 #[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
 pub enum ProjectionMode {
@@ -31,6 +57,24 @@ pub enum ProjectionMode {
     Orthographic,
 }
 
+impl From<u32> for ProjectionMode {
+    fn from(v: u32) -> Self {
+        match v {
+            0 => Self::Perspective,
+            _ => Self::Orthographic,
+        }
+    }
+}
+
+impl From<ProjectionMode> for u32 {
+    fn from(v: ProjectionMode) -> Self {
+        match v {
+            ProjectionMode::Perspective => 0,
+            ProjectionMode::Orthographic => 1,
+        }
+    }
+}
+
 /// Axis direction for up/front vectors.
 #[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
 pub enum AxisDirection {
@@ -49,6 +93,32 @@ pub enum AxisDirection {
     NegZ,
 }
 
+impl From<u32> for AxisDirection {
+    fn from(v: u32) -> Self {
+        match v {
+            0 => Self::PosX,
+            1 => Self::NegX,
+            2 => Self::PosY,
+            3 => Self::NegY,
+            4 => Self::PosZ,
+            _ => Self::NegZ,
+        }
+    }
+}
+
+impl From<AxisDirection> for u32 {
+    fn from(v: AxisDirection) -> Self {
+        match v {
+            AxisDirection::PosX => 0,
+            AxisDirection::NegX => 1,
+            AxisDirection::PosY => 2,
+            AxisDirection::NegY => 3,
+            AxisDirection::PosZ => 4,
+            AxisDirection::NegZ => 5,
+        }
+    }
+}
+
 impl AxisDirection {
     /// Returns the unit vector for this direction.
     #[must_use]

crates/polyscope-render/src/shadow_map.rs

@@ -43,9 +43,9 @@ impl Default for BlurUniforms {
 }
 
 /// Shadow map render resources.
-#[allow(dead_code)]
 pub struct ShadowMapPass {
-    /// Shadow map depth texture.
+    /// Shadow map depth texture (kept alive for GPU resource lifetime).
+    #[allow(dead_code)]
     depth_texture: wgpu::Texture,
     /// Shadow map depth view.
     depth_view: wgpu::TextureView,

crates/polyscope-structures/src/curve_network/mod.rs

@@ -15,7 +15,6 @@ use wgpu::util::DeviceExt;
 pub use quantities::*;
 
 /// A curve network structure (nodes connected by edges).
-#[allow(dead_code)]
 pub struct CurveNetwork {
     name: String,
 
@@ -41,10 +40,14 @@ pub struct CurveNetwork {
     /// Render mode: 0 = line, 1 = tube (cylinder)
     render_mode: u32,
 
-    // Variable radius
+    // Variable radius (reserved for future use)
+    #[allow(dead_code)]
     node_radius_quantity_name: Option<String>,
+    #[allow(dead_code)]
     edge_radius_quantity_name: Option<String>,
+    #[allow(dead_code)]
     node_radius_autoscale: bool,
+    #[allow(dead_code)]
     edge_radius_autoscale: bool,
 
     // GPU resources

crates/polyscope-structures/src/volume_grid/mod.rs

@@ -17,7 +17,6 @@ use polyscope_render::CurveNetworkRenderData;
 /// - Bounding box (min and max corners in world space)
 ///
 /// Node values are at grid vertices, cell values are at grid cell centers.
-#[allow(dead_code)]
 pub struct VolumeGrid {
     name: String,
 

crates/polyscope-structures/src/volume_grid/scalar_quantity.rs

@@ -606,7 +606,6 @@ impl Quantity for VolumeGridNodeScalarQuantity {
 }
 
 /// A scalar quantity defined at grid cells.
-#[allow(dead_code)]
 pub struct VolumeGridCellScalarQuantity {
     name: String,
     structure_name: String,
@@ -623,8 +622,10 @@ pub struct VolumeGridCellScalarQuantity {
     gridcube_render_data: Option<GridcubeRenderData>,
     gridcube_dirty: bool,
 
-    // Grid geometry
+    // Grid geometry (reserved for future gridcube world-space mapping)
+    #[allow(dead_code)]
     bound_min: Vec3,
+    #[allow(dead_code)]
     bound_max: Vec3,
 
     // Pick state

crates/polyscope-structures/src/volume_mesh/mod.rs

@@ -1439,19 +1439,6 @@ pub struct VolumeMeshRenderGeometry {
     pub vertex_colors: Option<Vec<Vec3>>,
 }
 
-/// Rotation map for hex vertices to place vertex 0 in canonical position.
-#[allow(dead_code)]
-const HEX_ROTATION_MAP: [[usize; 8]; 8] = [
-    [0, 1, 2, 3, 4, 5, 6, 7],
-    [1, 0, 4, 5, 2, 3, 7, 6],
-    [2, 1, 5, 6, 3, 0, 4, 7],
-    [3, 0, 1, 2, 7, 4, 5, 6],
-    [4, 0, 3, 7, 5, 1, 2, 6],
-    [5, 1, 0, 4, 6, 2, 3, 7],
-    [6, 2, 1, 5, 7, 3, 0, 4],
-    [7, 3, 2, 6, 4, 0, 1, 5],
-];
-
 /// Diagonal decomposition patterns (5 tets).
 const HEX_TO_TET_PATTERN: [[usize; 4]; 5] = [
     [0, 1, 2, 5],

crates/polyscope/src/app/mod.rs

@@ -139,12 +139,6 @@ impl App {
         self.screenshot_counter += 1;
         self.screenshot_pending = Some(filename);
     }
-
-    /// Sets the background color.
-    #[allow(dead_code)]
-    pub fn set_background_color(&mut self, color: Vec3) {
-        self.background_color = color;
-    }
 }
 
 impl Default for App {