matterviz 0.3.4 → 0.3.6

package/dist/settings.js

@@ -1,1123 +0,0 @@
-// 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,
-        },
-        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: `#ffffff`,
-            description: `Text color for atom labels`,
-        },
-        site_label_bg_color: {
-            value: `#000000`,
-            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,
-    },
-    // 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 || {}),
-    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),
-    convex_hull: merge_nested(DEFAULTS.convex_hull, user?.convex_hull),
-});