matterviz 0.3.6 → 0.4.0

package/dist/settings.js

@@ -0,0 +1,1394 @@
+// MatterViz settings schema - single source of truth for all MatterViz settings
+// Used by both main package and VSCode extension
+import { symbol_names } from './labels';
+import { merge_nested } from './utils';
+export const SHOW_BONDS_OPTIONS = [`never`, `always`, `crystals`, `molecules`];
+export const VECTOR_COLOR_MODES = [
+    `auto`,
+    `element`,
+    `spin_direction`,
+    `magnitude`,
+    `uniform`,
+];
+export const ATOM_COLOR_MODE_OPTIONS = [
+    `element`,
+    `coordination`,
+    `wyckoff`,
+    `custom`,
+];
+const DISPLAY_CONFIG = {
+    x_grid: {
+        value: true,
+        description: `Show X-axis grid lines`,
+    },
+    y_grid: {
+        value: true,
+        description: `Show Y-axis grid lines`,
+    },
+    y2_grid: {
+        value: false,
+        description: `Show Y2-axis grid lines`,
+    },
+    x_zero_line: {
+        value: true,
+        description: `Show X-axis zero reference line`,
+    },
+    y_zero_line: {
+        value: true,
+        description: `Show Y-axis zero reference line`,
+    },
+};
+// Complete settings configuration with values, descriptions, and constraints
+export const SETTINGS_CONFIG = {
+    // General display settings
+    color_scheme: {
+        value: `Vesta`,
+        description: `Color scheme for atoms and bonds`,
+        enum: {
+            Vesta: `Vesta`,
+            Jmol: `Jmol`,
+            Alloy: `Alloy`,
+            Pastel: `Pastel`,
+            Muted: `Muted`,
+            'Dark Mode': `Dark Mode`,
+        },
+    },
+    background_color: {
+        value: `#000000`,
+        description: `Background color of the 3D viewport`,
+    },
+    background_opacity: {
+        value: 0,
+        description: `Opacity of the background (0.0 = transparent, 1.0 = opaque)`,
+        minimum: 0,
+        maximum: 1,
+    },
+    // Symmetry Analysis
+    symmetry: {
+        symprec: {
+            value: 1e-4,
+            description: `Symmetry precision tolerance for spacegroup detection`,
+            minimum: 1e-8,
+            maximum: 1,
+        },
+        algo: {
+            value: `Moyo`,
+            description: `Algorithm for symmetry analysis`,
+            enum: { Moyo: `Moyo`, Spglib: `Spglib` },
+        },
+    },
+    // Structure viewer settings
+    structure: {
+        // Atoms & Bonds
+        atom_radius: {
+            value: 0.7,
+            description: `Radius multiplier for atoms (0.7 = standard atomic radii)`,
+            minimum: 0.1,
+            maximum: 3.0,
+        },
+        same_size_atoms: {
+            value: false,
+            description: `Render all atoms with the same size regardless of element`,
+        },
+        show_atoms: {
+            value: true,
+            description: `Display atoms in the structure`,
+        },
+        show_image_atoms: {
+            value: true,
+            description: `Show atoms on the edge of the cell that are not part of the primitive basis`,
+        },
+        sphere_segments: {
+            value: 20,
+            description: `Number of segments for sphere rendering (higher = smoother)`,
+            minimum: 8,
+            maximum: 64,
+        },
+        bond_thickness: {
+            value: 0.07,
+            description: `Thickness of bonds relative to atom radius`,
+            minimum: 0.01,
+            maximum: 1.0,
+        },
+        auto_bond_order: {
+            value: false,
+            description: `Automatically perceive double/triple/aromatic bonds from geometry (main-group/organic; metals fall back to single)`,
+        },
+        aromatic_display: {
+            value: `aromatic`,
+            description: `How to render perceived aromatic rings`,
+            enum: { aromatic: `Aromatic (1.5)`, kekule: `Kekulé (alternating)` },
+        },
+        show_bonds: {
+            value: `always`,
+            description: `When to display bonds between atoms`,
+            enum: Object.fromEntries(SHOW_BONDS_OPTIONS.map((key) => [key, key[0].toUpperCase() + key.slice(1)])),
+        },
+        bond_color: {
+            value: `#666666`,
+            description: `Color for bonds (hex color code)`,
+        },
+        bonding_strategy: {
+            value: `electroneg_ratio`,
+            description: `Method for determining bonds between atoms`,
+            enum: {
+                electroneg_ratio: `Electronegativity Ratio`,
+                solid_angle: `Solid Angle`,
+            },
+        },
+        atom_color_mode: {
+            value: `element`,
+            description: `Property to use for atom coloring`,
+            enum: {
+                element: `Element`,
+                coordination: `Coordination Number`,
+                wyckoff: `Wyckoff Position`,
+            },
+        },
+        atom_color_scale: {
+            value: `interpolateViridis`,
+            description: `D3 color scale for property-based coloring (e.g. interpolateViridis, interpolatePlasma)`,
+        },
+        atom_color_scale_type: {
+            value: `continuous`,
+            description: `Color scale type for property-based coloring`,
+            enum: {
+                continuous: `Continuous Gradient`,
+                categorical: `Discrete Categories`,
+            },
+        },
+        // Camera & Controls
+        show_gizmo: {
+            value: true,
+            description: `Show orientation gizmo in the corner of structure viewer`,
+        },
+        camera_position: {
+            value: [0, 0, 0],
+            description: `Initial camera position [x, y, z]`,
+            minItems: 3,
+            maxItems: 3,
+        },
+        camera_projection: {
+            value: `orthographic`,
+            description: `Camera projection type`,
+            enum: {
+                perspective: `Perspective`,
+                orthographic: `Orthographic`,
+            },
+        },
+        initial_zoom: {
+            value: 35,
+            description: `Initial zoom level for orthographic projection (ignored for perspective)`,
+            minimum: 0.1,
+            maximum: 200,
+        },
+        fov: {
+            value: 10,
+            description: `Field of view in degrees for perspective projection`,
+            minimum: 10,
+            maximum: 150,
+        },
+        rotation_damping: {
+            value: 0.1,
+            description: `Camera rotation damping factor (0 = no damping, 1 = heavy damping)`,
+            minimum: 0,
+            maximum: 1,
+        },
+        rotate_speed: {
+            value: 1.0,
+            description: `Mouse rotation sensitivity (set to 0 to disable rotation)`,
+            minimum: 0,
+            maximum: 2.0,
+        },
+        zoom_speed: {
+            value: 0.5,
+            description: `Mouse wheel zoom sensitivity`,
+            minimum: 0.1,
+            maximum: 2.0,
+        },
+        pan_speed: {
+            value: 0.5,
+            description: `Mouse pan sensitivity`,
+            minimum: 0.1,
+            maximum: 2.0,
+        },
+        zoom_to_cursor: {
+            value: false,
+            description: `Zoom toward cursor position instead of scene center (double click canvas to reset camera)`,
+        },
+        max_zoom: {
+            value: 500,
+            description: `Maximum zoom level (orthographic: larger = more zoomed out, perspective: larger = further away)`,
+        },
+        min_zoom: {
+            value: 10,
+            description: `Minimum zoom level (orthographic: smaller = more zoomed in, perspective: smaller = closer)`,
+        },
+        auto_rotate: {
+            value: 0.2,
+            description: `Automatic rotation speed (0 = disabled, positive = clockwise)`,
+            minimum: 0,
+            maximum: 10,
+        },
+        rotation: {
+            value: [0, 0, 0],
+            description: `Manual rotation around X, Y, Z axes, displayed in degrees [0, 360] but normalized as radians to [-π, π] for each of [x, y, z]. Combines additively with auto-rotation when both are active.`,
+            minItems: 3,
+            maxItems: 3,
+        },
+        // Labels & Lighting
+        show_site_labels: {
+            value: false,
+            description: `Show element labels on atoms`,
+        },
+        show_site_indices: {
+            value: false,
+            description: `Show site index numbers on atoms`,
+        },
+        site_label_size: {
+            value: 1,
+            description: `Font size for atom labels`,
+            minimum: 0.5,
+            maximum: 5,
+        },
+        site_label_color: {
+            value: `#111111`,
+            description: `Text color for atom labels`,
+        },
+        site_label_bg_color: {
+            value: `color-mix(in srgb, #000000 0%, transparent)`,
+            description: `Background color for atom labels`,
+        },
+        site_label_padding: {
+            value: 2,
+            description: `Padding around atom labels in pixels`,
+            minimum: 0,
+            maximum: 20,
+        },
+        site_label_offset: {
+            value: [0, 0.5, 0],
+            description: `3D offset for atom labels [x, y, z]`,
+            minItems: 3,
+            maxItems: 3,
+        },
+        ambient_light: {
+            value: 1.5,
+            description: `Ambient light intensity (0 = dark, higher = brighter)`,
+            minimum: 0,
+            maximum: 4,
+        },
+        directional_light: {
+            value: 2.2,
+            description: `Directional light intensity (0 = no shadows, higher = stronger shadows)`,
+            minimum: 0,
+            maximum: 4,
+        },
+        // Site Vectors (force, magmom, spin) & Lattice
+        vector_configs: {
+            value: {},
+            description: `Per-key configuration for site vector layers. Keys map to site property names (e.g. force, magmom, force_DFT). Auto-populated when a structure with vector data loads.`,
+        },
+        vector_scale: {
+            value: 1.0,
+            description: `Scale factor for site vector arrows`,
+            minimum: 0.1,
+            maximum: 10.0,
+        },
+        vector_color: {
+            value: `#ff0000`,
+            description: `Color for site vector arrows (used in uniform mode and as fallback)`,
+        },
+        vector_color_mode: {
+            value: `auto`,
+            description: `How to color arrows. auto = element for force, spin-direction for magmom/spin. element = majority species color. spin_direction = red/blue by z-component. magnitude = continuous color scale by vector length. uniform = single color (vector_color).`,
+        },
+        vector_color_scale: {
+            value: `interpolateViridis`,
+            description: `D3 color scale for magnitude coloring mode`,
+        },
+        vector_normalize: {
+            value: false,
+            description: `Show all arrows at the same length (direction only). Useful for spin/magmom visualization where orientation matters but magnitude does not.`,
+        },
+        vector_uniform_thickness: {
+            value: false,
+            description: `Use the same shaft and head size for all arrows regardless of length. When off (default), thickness scales with arrow length.`,
+        },
+        vector_origin_gap: {
+            value: 0,
+            description: `Fraction of visual atom radius to offset each arrow origin when multiple vectors are shown per site. 0 = all from atom center, 0.5 = halfway to surface.`,
+            minimum: 0,
+            maximum: 0.5,
+        },
+        vector_shaft_radius: {
+            value: -0.03,
+            description: `Radius of vector shaft (negative = relative to length, positive = absolute)`,
+            minimum: -0.1,
+            maximum: 0.1,
+        },
+        vector_arrow_head_radius: {
+            value: -0.06,
+            description: `Radius of vector arrow head (negative = relative to length, positive = absolute)`,
+            minimum: -0.2,
+            maximum: 0.2,
+        },
+        vector_arrow_head_length: {
+            value: -0.15,
+            description: `Length of vector arrow head (negative = relative to length, positive = absolute)`,
+            minimum: -0.5,
+            maximum: 0.5,
+        },
+        show_cell: {
+            value: false,
+            description: `Display system cell`,
+        },
+        show_cell_vectors: {
+            value: true,
+            description: `Display cell vectors`,
+        },
+        cell_edge_opacity: {
+            value: 0.3,
+            description: `Opacity of cell edge lines`,
+            minimum: 0,
+            maximum: 1,
+        },
+        cell_surface_opacity: {
+            value: 0.1,
+            description: `Opacity of cell surfaces`,
+            minimum: 0,
+            maximum: 1,
+        },
+        cell_edge_color: {
+            value: `#808080`,
+            description: `Color of cell edges`,
+        },
+        cell_surface_color: {
+            value: `#e0e0e0`,
+            description: `Color of cell surfaces`,
+        },
+        cell_edge_width: {
+            value: 1.5,
+            description: `Width of cell edge lines`,
+            minimum: 0.5,
+            maximum: 5.0,
+        },
+        fullscreen_toggle: {
+            value: true,
+            description: `Show fullscreen toggle button (web-only, always false in other contexts)`,
+            context: `web`,
+        },
+    },
+    // Trajectory viewer settings
+    trajectory: {
+        // Core trajectory settings
+        auto_play: {
+            value: false,
+            description: `Automatically start playing trajectory when opened`,
+        },
+        fps: {
+            value: 10,
+            description: `Frames per second for trajectory playback`,
+            minimum: 0.1,
+            maximum: 60,
+        },
+        fps_range: {
+            value: [0.2, 60],
+            description: `Allowed range for playback speed [min, max]`,
+            minItems: 2,
+            maxItems: 2,
+        },
+        display_mode: {
+            value: `structure+scatter`,
+            description: `Visualization mode for trajectory data`,
+            enum: {
+                'structure+scatter': `Structure + Scatter`,
+                structure: `Structure`,
+                scatter: `Scatter`,
+                histogram: `Histogram`,
+                'structure+histogram': `Structure + Histogram`,
+            },
+        },
+        show_controls: {
+            value: true,
+            description: `Show playback controls`,
+        },
+        fullscreen_toggle: {
+            value: true,
+            description: `Show fullscreen toggle button (web-only, always false in other contexts)`,
+            context: `web`,
+        },
+        step_labels: {
+            value: 5,
+            description: `Number of frame labels to display`,
+            minimum: 0,
+            maximum: 20,
+        },
+        layout: {
+            value: `auto`,
+            description: `Layout arrangement for trajectory viewer`,
+            enum: {
+                auto: `Auto`,
+                horizontal: `Horizontal`,
+                vertical: `Vertical`,
+            },
+        },
+        // File handling and loading
+        allow_file_drop: {
+            value: true,
+            description: `Allow drag-and-drop of trajectory files`,
+        },
+        bin_file_threshold: {
+            value: 50000000,
+            description: `File size threshold for binary loading (bytes)`,
+            minimum: 1000000,
+            maximum: 500000000,
+        },
+        text_file_threshold: {
+            value: 25000000,
+            description: `File size threshold for text loading (bytes)`,
+            minimum: 500000,
+            maximum: 250000000,
+        },
+        use_indexing: {
+            value: false,
+            description: `Use frame indexing for large trajectories`,
+        },
+        chunk_size: {
+            value: 1000,
+            description: `Number of frames to process at once`,
+            minimum: 10,
+            maximum: 10000,
+        },
+        // Formatting
+        step_label_format: {
+            value: `.3~s`,
+            description: `Number format for step labels (D3 format specifier)`,
+        },
+        property_value_format: {
+            value: `.2~s`,
+            description: `Number format for property values (D3 format specifier)`,
+        },
+        tooltip_format: {
+            value: `.3~s`,
+            description: `Number format for tooltips (D3 format specifier)`,
+        },
+        // UI/UX
+        enable_keyboard_shortcuts: {
+            value: true,
+            description: `Enable keyboard shortcuts for playback`,
+        },
+        show_parsing_progress: {
+            value: true,
+            description: `Show progress indicator while parsing files`,
+        },
+        compact_controls: {
+            value: false,
+            description: `Use compact layout for playback controls`,
+        },
+        show_filename_in_controls: {
+            value: true,
+            description: `Display filename in control pane`,
+        },
+        // Playback behavior
+        smooth_playback: {
+            value: false,
+            description: `Use smooth interpolation between frames`,
+        },
+        loop_playback: {
+            value: true,
+            description: `Loop trajectory playback`,
+        },
+        pause_on_hover: {
+            value: false,
+            description: `Pause playback when hovering over controls`,
+        },
+        highlight_current_frame: {
+            value: true,
+            description: `Highlight current frame in timeline`,
+        },
+        show_frame_info: {
+            value: true,
+            description: `Show frame information overlay`,
+        },
+        // Performance
+        max_frames_in_memory: {
+            value: 1000,
+            description: `Maximum frames to keep in memory`,
+            minimum: 10,
+            maximum: 10000,
+        },
+        memory_usage_warning_threshold: {
+            value: 500,
+            description: `Frame count threshold for memory warnings`,
+            minimum: 10,
+            maximum: 5000,
+        },
+        enable_performance_monitoring: {
+            value: false,
+            description: `Enable performance monitoring`,
+        },
+        prefetch_frames: {
+            value: 5,
+            description: `Number of frames to prefetch ahead`,
+            minimum: 0,
+            maximum: 100,
+        },
+        cache_parsed_data: {
+            value: true,
+            description: `Cache parsed trajectory data`,
+        },
+    },
+    // Histogram specific
+    histogram: {
+        mode: {
+            value: `overlay`,
+            description: `Histogram display mode. 'overlay' shows multiple histograms in the same plot, 'single' shows a single histogram`,
+            enum: {
+                overlay: `Overlay`,
+                single: `Single`,
+            },
+        },
+        show_legend: {
+            value: true,
+            description: `Show legend in histogram plots`,
+        },
+        bin_count: {
+            value: 100,
+            description: `Number of bins for histogram plots`,
+            minimum: 1,
+            maximum: 1000,
+        },
+        bar: {
+            color: {
+                value: `#4A9EFF`,
+                description: `Histogram bar fill color`,
+            },
+            opacity: {
+                value: 0.7,
+                description: `Histogram bar opacity`,
+                minimum: 0,
+                maximum: 1,
+            },
+            stroke_width: {
+                value: 1,
+                description: `Histogram bar stroke width`,
+                minimum: 0,
+                maximum: 5,
+            },
+            stroke_color: {
+                value: `#000000`,
+                description: `Histogram bar stroke color`,
+            },
+            stroke_opacity: {
+                value: 0.5,
+                description: `Histogram bar stroke opacity`,
+                minimum: 0,
+                maximum: 1,
+            },
+        },
+        display: DISPLAY_CONFIG,
+    },
+    // Bar plot specific
+    bar: {
+        bar: {
+            color: {
+                value: `#4A9EFF`,
+                description: `Bar plot fill color`,
+            },
+            opacity: {
+                value: 0.6,
+                description: `Bar plot opacity (overlay mode)`,
+                minimum: 0,
+                maximum: 1,
+            },
+            border_radius: {
+                value: 3,
+                description: `Corner radius for bar tops (px)`,
+                minimum: 0,
+                maximum: 10,
+            },
+        },
+        line: {
+            width: {
+                value: 2,
+                description: `Bar plot line width`,
+                minimum: 0.5,
+                maximum: 10,
+            },
+            color: {
+                value: `#4A9EFF`,
+                description: `Bar plot line color`,
+            },
+        },
+        display: DISPLAY_CONFIG,
+    },
+    // Box plot specific
+    box: {
+        whisker_mode: {
+            value: `tukey`,
+            description: `How whiskers are computed: 'tukey' (1.5*IQR), 'minmax' (data extremes), 'percentile' (5th/95th), or 'std' (mean ± std)`,
+            enum: {
+                tukey: `Tukey (1.5·IQR)`,
+                minmax: `Min/Max`,
+                percentile: `Percentile`,
+                std: `Std Dev`,
+            },
+        },
+        box_width: {
+            value: 0.8,
+            description: `Box width as a fraction of the category slot`,
+            minimum: 0.1,
+            maximum: 1,
+        },
+        show_outliers: {
+            value: true,
+            description: `Show outlier points beyond the whiskers`,
+        },
+        show_mean: {
+            value: false,
+            description: `Show the mean marker inside each box`,
+        },
+        kind: {
+            value: `box`,
+            description: `Glyph to draw per series: box, violin (KDE density), or both`,
+            enum: { box: `Box`, violin: `Violin`, 'violin+box': `Violin + Box` },
+        },
+        side: {
+            value: `both`,
+            description: `Which half of the slot a violin occupies (one-sided / split violins)`,
+            enum: { both: `Both`, positive: `Positive`, negative: `Negative` },
+        },
+        bandwidth: {
+            value: `silverman`,
+            description: `KDE bandwidth rule for violins`,
+            enum: { silverman: `Silverman`, scott: `Scott` },
+        },
+        violin_width: {
+            value: 0.9,
+            description: `Violin width as a fraction of the category slot`,
+            minimum: 0.1,
+            maximum: 1,
+        },
+        violin_box_width: {
+            value: 0.2,
+            description: `Inner box width (fraction of slot) when a box is drawn inside a violin`,
+            minimum: 0.05,
+            maximum: 1,
+        },
+        box: {
+            color: {
+                value: `#4A9EFF`,
+                description: `Box fill color`,
+            },
+            opacity: {
+                value: 0.6,
+                description: `Box fill opacity`,
+                minimum: 0,
+                maximum: 1,
+            },
+            stroke_width: {
+                value: 0.5,
+                description: `Box outline width`,
+                minimum: 0,
+                maximum: 5,
+            },
+            stroke_color: {
+                value: `#000000`,
+                description: `Box outline color`,
+            },
+            border_radius: {
+                value: 0,
+                description: `Corner radius for boxes (px)`,
+                minimum: 0,
+                maximum: 10,
+            },
+        },
+        whisker: {
+            width: {
+                value: 1,
+                description: `Whisker line width`,
+                minimum: 0.5,
+                maximum: 5,
+            },
+            color: {
+                value: `#000000`,
+                description: `Whisker line color`,
+            },
+            cap_fraction: {
+                value: 0.3,
+                description: `Whisker cap width as a fraction of the box width`,
+                minimum: 0,
+                maximum: 1,
+            },
+        },
+        median: {
+            width: {
+                value: 1.5,
+                description: `Median line width`,
+                minimum: 0.5,
+                maximum: 6,
+            },
+            color: {
+                value: `#000000`,
+                description: `Median line color`,
+            },
+        },
+        outlier: {
+            radius: {
+                value: 2.5,
+                description: `Outlier point radius (px)`,
+                minimum: 0.5,
+                maximum: 10,
+            },
+            opacity: {
+                value: 0.6,
+                description: `Outlier point opacity`,
+                minimum: 0,
+                maximum: 1,
+            },
+            stroke_width: {
+                value: 0,
+                description: `Outlier point stroke width`,
+                minimum: 0,
+                maximum: 3,
+            },
+        },
+        violin: {
+            opacity: {
+                value: 0.5,
+                description: `Violin fill opacity`,
+                minimum: 0,
+                maximum: 1,
+            },
+            stroke_width: {
+                value: 1,
+                description: `Violin outline width`,
+                minimum: 0,
+                maximum: 5,
+            },
+        },
+        display: DISPLAY_CONFIG,
+    },
+    // Sankey diagram specific
+    sankey: {
+        orientation: {
+            value: `horizontal`,
+            description: `Flow direction of the Sankey diagram`,
+            enum: { horizontal: `Horizontal`, vertical: `Vertical` },
+        },
+        node_align: {
+            value: `justify`,
+            description: `How nodes are aligned across columns (maps to d3-sankey alignment)`,
+            enum: { justify: `Justify`, left: `Left`, right: `Right`, center: `Center` },
+        },
+        node_width: {
+            value: 24,
+            description: `Node thickness in pixels`,
+            minimum: 4,
+            maximum: 60,
+        },
+        node_padding: {
+            value: 12,
+            description: `Vertical gap in pixels between nodes sharing a column`,
+            minimum: 0,
+            maximum: 40,
+        },
+        link_opacity: {
+            value: 0.5,
+            description: `Opacity of link ribbons`,
+            minimum: 0.05,
+            maximum: 1,
+        },
+        show_node_labels: {
+            value: true,
+            description: `Show node labels next to each node`,
+        },
+        iterations: {
+            value: 6,
+            description: `Number of d3-sankey relaxation iterations for node positioning`,
+            minimum: 0,
+            maximum: 64,
+        },
+    },
+    // Sunburst chart specific
+    sunburst: {
+        shape: {
+            value: `sunburst`,
+            description: `Chart geometry: polar rings (sunburst) or stacked rows (icicle)`,
+            enum: { sunburst: `Sunburst`, icicle: `Icicle` },
+        },
+        value_mode: {
+            value: `leaf-sum`,
+            description: `How node values are interpreted (plotly branchvalues semantics): leaf-sum ignores parent values, total treats every value as authoritative, remainder adds a node's own value on top of its children`,
+            enum: { 'leaf-sum': `Leaf sum`, total: `Total`, remainder: `Remainder` },
+        },
+        max_depth: {
+            value: 0,
+            description: `Number of rings shown below the current zoom root (0 = all)`,
+            minimum: 0,
+            maximum: 10,
+        },
+        inner_radius: {
+            value: 0.25,
+            description: `Center hole size as fraction of the outer radius`,
+            minimum: 0,
+            maximum: 0.8,
+        },
+        pad_angle: {
+            value: 0.1,
+            description: `Angular gap in degrees between sibling arcs`,
+            minimum: 0,
+            maximum: 4,
+        },
+        min_fraction: {
+            value: 0,
+            description: `Group sibling arcs smaller than this fraction of the total into one 'Other' slice per parent (0 = off)`,
+            minimum: 0,
+            maximum: 0.2,
+        },
+        show_labels: {
+            value: true,
+            description: `Show labels on arcs large enough to fit them`,
+        },
+        label_rotation: {
+            value: `auto`,
+            description: `Arc label orientation (auto picks radial/tangential per arc)`,
+            enum: {
+                auto: `Auto`,
+                radial: `Radial`,
+                tangential: `Tangential`,
+                horizontal: `Horizontal`,
+            },
+        },
+        label_text: {
+            value: `label`,
+            description: `What arc labels display (percent is of the root total)`,
+            enum: {
+                label: `Label`,
+                value: `Value`,
+                percent: `Percent`,
+                'label+value': `Label + value`,
+                'label+percent': `Label + percent`,
+            },
+        },
+        zoom_on_click: {
+            value: true,
+            description: `Clicking a branch arc zooms into that subtree (center circle zooms out)`,
+        },
+        show_breadcrumbs: {
+            value: true,
+            description: `Show a clickable trail of ancestors when zoomed into a subtree`,
+        },
+    },
+    // Composition specific
+    composition: {
+        display_mode: {
+            value: `pie`,
+            description: `Display mode for composition data`,
+            enum: {
+                pie: `Pie`,
+                bubble: `Bubble`,
+                bar: `Bar`,
+            },
+        },
+        color_scheme: {
+            value: `Vesta`,
+            description: `Color scheme for composition visualization`,
+            enum: {
+                Vesta: `Vesta`,
+                Jmol: `Jmol`,
+                Alloy: `Alloy`,
+                Pastel: `Pastel`,
+                Muted: `Muted`,
+                'Dark Mode': `Dark Mode`,
+            },
+        },
+    },
+    // Scatter plot specific
+    scatter: {
+        symbol_type: {
+            value: `Circle`,
+            description: `Default symbol type for scatter plots`,
+            enum: Object.fromEntries(symbol_names.map((name) => [name, name])),
+        },
+        show_legend: {
+            value: true,
+            description: `Show legend in scatter plots`,
+        },
+        show_points: {
+            value: true,
+            description: `Show points in scatter plots`,
+        },
+        show_lines: {
+            value: true,
+            description: `Show connecting lines in scatter plots`,
+        },
+        display: DISPLAY_CONFIG,
+        point: {
+            size: {
+                value: 4,
+                description: `Point size for scatter plots`,
+                minimum: 1,
+                maximum: 20,
+            },
+            color: {
+                value: `#4A9EFF`,
+                description: `Default color for scatter plot points`,
+            },
+            opacity: {
+                value: 1,
+                description: `Opacity of scatter plot points`,
+                minimum: 0,
+                maximum: 1,
+            },
+            stroke_width: {
+                value: 1,
+                description: `Stroke width for scatter plot points`,
+                minimum: 0,
+                maximum: 5,
+            },
+            stroke_color: {
+                value: `#000000`,
+                description: `Stroke color for scatter plot points`,
+            },
+            stroke_opacity: {
+                value: 1,
+                description: `Stroke opacity for scatter plot points`,
+                minimum: 0,
+                maximum: 1,
+            },
+        },
+        line: {
+            width: {
+                value: 2,
+                description: `Line width for scatter plot connections`,
+                minimum: 0.5,
+                maximum: 10,
+            },
+            color: {
+                value: `#4A9EFF`,
+                description: `Default color for scatter plot lines`,
+            },
+            opacity: {
+                value: 1,
+                description: `Opacity of scatter plot lines`,
+                minimum: 0,
+                maximum: 1,
+            },
+            dash: {
+                value: `solid`,
+                description: `Line dash pattern for scatter plots (e.g. "4,4" for dashed)`,
+            },
+        },
+    },
+    // Plot general
+    plot: {
+        animation_duration: {
+            value: 200,
+            description: `Duration of plot animations in milliseconds`,
+            minimum: 0,
+            maximum: 2000,
+        },
+        enable_zoom: {
+            value: true,
+            description: `Enable zooming in plots`,
+        },
+        zoom_factor: {
+            value: 1.5,
+            description: `Zoom factor for plot interactions`,
+            minimum: 1.1,
+            maximum: 5.0,
+        },
+        auto_fit_range: {
+            value: true,
+            description: `Automatically fit plot range to data`,
+        },
+        grid_lines: {
+            value: true,
+            description: `Show grid lines in plots`,
+        },
+        axis_labels: {
+            value: true,
+            description: `Show axis labels in plots`,
+        },
+        show_x_zero_line: {
+            value: true,
+            description: `Show X-axis zero reference line`,
+        },
+        show_y_zero_line: {
+            value: true,
+            description: `Show Y-axis zero reference line`,
+        },
+        show_x_grid: {
+            value: true,
+            description: `Show X-axis grid lines`,
+        },
+        show_x2_grid: {
+            value: false,
+            description: `Show secondary X-axis grid lines`,
+        },
+        show_y_grid: {
+            value: true,
+            description: `Show Y-axis grid lines`,
+        },
+        show_y2_grid: {
+            value: true,
+            description: `Show secondary Y-axis grid lines`,
+        },
+        x_format: {
+            value: `.2~s`,
+            description: `Number format for X-axis ticks (D3 format specifier)`,
+        },
+        x2_format: {
+            value: ``,
+            description: `Number format for secondary X-axis ticks (D3 format specifier)`,
+        },
+        y_format: {
+            value: `d`,
+            description: `Number format for Y-axis ticks (D3 format specifier)`,
+        },
+        y2_format: {
+            value: ``,
+            description: `Number format for secondary Y-axis ticks (D3 format specifier)`,
+        },
+        x_scale_type: {
+            value: `linear`,
+            description: `Scale type for X-axis`,
+            enum: {
+                linear: `Linear`,
+                log: `Log`,
+            },
+        },
+        y_scale_type: {
+            value: `linear`,
+            description: `Scale type for Y-axis`,
+            enum: {
+                linear: `Linear`,
+                log: `Log`,
+            },
+        },
+        x_ticks: {
+            value: 8,
+            description: `Number of ticks on X-axis`,
+            minimum: 2,
+            maximum: 20,
+        },
+        y_ticks: {
+            value: 6,
+            description: `Number of ticks on Y-axis`,
+            minimum: 2,
+            maximum: 20,
+        },
+    },
+    convex_hull: {
+        // Convex hull defaults (binary/ternary/quaternary)
+        binary: {
+            camera_zoom: {
+                value: 1.0,
+                description: `Initial zoom for binary (2D) convex hull`,
+                minimum: 0.1,
+                maximum: 10,
+            },
+            camera_center_x: {
+                value: 0,
+                description: `Initial X center for binary (2D) convex hull`,
+            },
+            camera_center_y: {
+                value: 0,
+                description: `Initial Y center for binary (2D) convex hull`,
+            },
+            color_mode: {
+                value: `energy`,
+                description: `Color mode for 2D convex hull points`,
+                enum: {
+                    stability: `Stability`,
+                    energy: `Energy`,
+                },
+            },
+            color_scale: {
+                value: `interpolateViridis`,
+                description: `D3 interpolate color scale for 2D convex hull energy mode`,
+            },
+            show_stable: {
+                value: true,
+                description: `Show stable phases in 2D convex hull`,
+            },
+            show_unstable: {
+                value: true,
+                description: `Show unstable phases in 2D convex hull`,
+            },
+            show_stable_labels: {
+                value: true,
+                description: `Show labels for stable phases in 2D convex hull`,
+            },
+            show_unstable_labels: {
+                value: false,
+                description: `Show labels for unstable phases in 2D convex hull`,
+            },
+            max_hull_dist_show_phases: {
+                value: 0.1,
+                description: `Max eV/atom above hull for showing unstable entries in 2D convex hull`,
+                minimum: 0,
+                maximum: 2,
+            },
+            max_hull_dist_show_labels: {
+                value: 0.1,
+                description: `Max eV/atom above hull for labeling unstable entries in 2D convex hull`,
+                minimum: 0,
+                maximum: 2,
+            },
+            fullscreen: {
+                value: false,
+                description: `Start in fullscreen for 2D convex hull`,
+            },
+            info_pane_open: {
+                value: false,
+                description: `Info pane open by default for 2D convex hull`,
+            },
+            legend_pane_open: {
+                value: false,
+                description: `Legend pane open by default for 2D convex hull`,
+            },
+        },
+        ternary: {
+            camera_elevation: {
+                value: 45,
+                description: `Initial camera elevation (deg) for ternary (3D) convex hull`,
+                minimum: -180,
+                maximum: 180,
+            },
+            camera_azimuth: {
+                value: 60,
+                description: `Initial camera azimuth (deg) for ternary (3D) convex hull`,
+                minimum: -360,
+                maximum: 360,
+            },
+            camera_zoom: {
+                value: 1.5,
+                description: `Initial camera zoom for ternary (3D) convex hull`,
+                minimum: 0.1,
+                maximum: 10,
+            },
+            camera_center_x: {
+                value: 0,
+                description: `Initial X center for ternary (3D) convex hull`,
+            },
+            camera_center_y: {
+                value: -50,
+                description: `Initial Y center for ternary (3D) convex hull`,
+            },
+            color_mode: {
+                value: `energy`,
+                description: `Color mode for 3D convex hull points`,
+                enum: {
+                    stability: `Stability`,
+                    energy: `Energy`,
+                },
+            },
+            color_scale: {
+                value: `interpolateViridis`,
+                description: `D3 interpolate color scale for 3D convex hull energy mode`,
+            },
+            show_stable: {
+                value: true,
+                description: `Show stable phases in 3D convex hull`,
+            },
+            show_unstable: {
+                value: true,
+                description: `Show unstable phases in 3D convex hull`,
+            },
+            show_stable_labels: {
+                value: true,
+                description: `Show labels for stable phases in 3D convex hull`,
+            },
+            show_unstable_labels: {
+                value: false,
+                description: `Show labels for unstable phases in 3D convex hull`,
+            },
+            max_hull_dist_show_phases: {
+                value: 0.5,
+                description: `Max eV/atom above hull for showing unstable entries in 3D convex hull`,
+                minimum: 0,
+                maximum: 2,
+            },
+            max_hull_dist_show_labels: {
+                value: 0.1,
+                description: `Max eV/atom above hull for labeling unstable entries in 3D convex hull`,
+                minimum: 0,
+                maximum: 2,
+            },
+            show_hull_faces: {
+                value: true,
+                description: `Render lower hull faces in 3D convex hull`,
+            },
+            hull_face_color: {
+                value: `#4caf50`,
+                description: `Color for lower hull faces in 3D convex hull`,
+            },
+            hull_face_opacity: {
+                value: 0.3,
+                description: `Opacity for hull faces in 3D convex hull (0-1)`,
+                minimum: 0,
+                maximum: 1,
+            },
+            hull_face_color_mode: {
+                value: `uniform`,
+                description: `Coloring mode for hull faces: uniform (single color), formation_energy (by E_form), dominant_element (by element), or facet_index (categorical)`,
+                enum: {
+                    uniform: `Uniform`,
+                    formation_energy: `Formation energy`,
+                    dominant_element: `Dominant element`,
+                    facet_index: `Facet index`,
+                },
+            },
+            fullscreen: {
+                value: false,
+                description: `Start in fullscreen for 3D convex hull`,
+            },
+            info_pane_open: {
+                value: false,
+                description: `Info pane open by default for 3D convex hull`,
+            },
+            legend_pane_open: {
+                value: false,
+                description: `Legend pane open by default for 3D convex hull`,
+            },
+        },
+        quaternary: {
+            camera_rotation_x: {
+                value: -0.6,
+                description: `Initial camera X rotation (rad) for quaternary (4D) convex hull`,
+                minimum: -6.283,
+                maximum: 6.283,
+            },
+            camera_rotation_y: {
+                value: 0.8,
+                description: `Initial camera Y rotation (rad) for quaternary (4D) convex hull`,
+                minimum: -6.283,
+                maximum: 6.283,
+            },
+            camera_zoom: {
+                value: 1.4,
+                description: `Initial camera zoom for quaternary (4D) convex hull`,
+                minimum: 0.1,
+                maximum: 20,
+            },
+            camera_center_x: {
+                value: 0,
+                description: `Initial X center for quaternary (4D) convex hull`,
+            },
+            camera_center_y: {
+                value: 20,
+                description: `Initial Y center for quaternary (4D) convex hull`,
+            },
+            color_mode: {
+                value: `energy`,
+                description: `Color mode for 4D convex hull points`,
+                enum: {
+                    stability: `Stability`,
+                    energy: `Energy`,
+                },
+            },
+            color_scale: {
+                value: `interpolateViridis`,
+                description: `D3 interpolate color scale for 4D convex hull energy mode`,
+            },
+            show_stable: {
+                value: true,
+                description: `Show stable phases in 4D convex hull`,
+            },
+            show_unstable: {
+                value: true,
+                description: `Show unstable phases in 4D convex hull`,
+            },
+            show_stable_labels: {
+                value: true,
+                description: `Show labels for stable phases in 4D convex hull`,
+            },
+            show_unstable_labels: {
+                value: false,
+                description: `Show labels for unstable phases in 4D convex hull`,
+            },
+            show_hull_faces: {
+                value: true,
+                description: `Show convex hull faces in 4D convex hull`,
+            },
+            hull_face_color: {
+                value: `#4caf50`,
+                description: `Color for hull faces in 4D convex hull`,
+            },
+            hull_face_opacity: {
+                value: 0.03,
+                description: `Opacity for hull faces in 4D convex hull (0-1)`,
+                minimum: 0,
+                maximum: 1,
+            },
+            hull_face_color_mode: {
+                value: `dominant_element`,
+                description: `Coloring mode for hull faces: uniform (single color), formation_energy (by E_form), dominant_element (by element), or facet_index (categorical)`,
+                enum: {
+                    uniform: `Uniform`,
+                    formation_energy: `Formation energy`,
+                    dominant_element: `Dominant element`,
+                    facet_index: `Facet index`,
+                },
+            },
+            max_hull_dist_show_phases: {
+                value: 0.1,
+                description: `Max eV/atom above hull for showing unstable entries in 4D convex hull`,
+                minimum: 0,
+                maximum: 2,
+            },
+            max_hull_dist_show_labels: {
+                value: 0.1,
+                description: `Max eV/atom above hull for labeling unstable entries in 4D convex hull`,
+                minimum: 0,
+                maximum: 2,
+            },
+            fullscreen: {
+                value: false,
+                description: `Start in fullscreen for 4D convex hull`,
+            },
+            info_pane_open: {
+                value: false,
+                description: `Info pane open by default for 4D convex hull`,
+            },
+            legend_pane_open: {
+                value: false,
+                description: `Legend pane open by default for 4D convex hull`,
+            },
+        },
+    },
+};
+// Extract values from settings config for runtime use
+const extract_values = (config) => {
+    const result = {};
+    for (const [key, value] of Object.entries(config)) {
+        if (value && typeof value === `object` && `value` in value) {
+            result[key] = value.value;
+        }
+        else if (value && typeof value === `object`) {
+            result[key] = extract_values(value);
+        }
+    }
+    return result;
+};
+// Runtime defaults - extracted values for use in components
+export const DEFAULTS = extract_values(SETTINGS_CONFIG);
+// Helper to merge with defaults - handles nested structure
+export const merge = (user) => ({
+    ...DEFAULTS,
+    ...user,
+    symmetry: merge_nested(DEFAULTS.symmetry, user?.symmetry),
+    structure: merge_nested(DEFAULTS.structure, user?.structure),
+    trajectory: merge_nested(DEFAULTS.trajectory, user?.trajectory),
+    composition: merge_nested(DEFAULTS.composition, user?.composition),
+    plot: merge_nested(DEFAULTS.plot, user?.plot),
+    scatter: merge_nested(DEFAULTS.scatter, user?.scatter),
+    histogram: merge_nested(DEFAULTS.histogram, user?.histogram),
+    bar: merge_nested(DEFAULTS.bar, user?.bar),
+    box: merge_nested(DEFAULTS.box, user?.box),
+    sankey: merge_nested(DEFAULTS.sankey, user?.sankey),
+    sunburst: merge_nested(DEFAULTS.sunburst, user?.sunburst),
+    convex_hull: merge_nested(DEFAULTS.convex_hull, user?.convex_hull),
+});