matterviz 0.3.6 → 0.4.0

package/dist/src/lib/settings.ts

@@ -1,1479 +0,0 @@
-// MatterViz settings schema - single source of truth for all MatterViz settings
-// Used by both main package and VSCode extension
-
-import type { ColorScaleType, D3InterpolateName } from '$lib/colors'
-import type { HullFaceColorMode } from '$lib/convex-hull/types'
-import type { D3SymbolName } from '$lib/labels'
-import { symbol_names } from '$lib/labels'
-import type { Vec3 } from '$lib/math'
-import type { Orientation } from '$lib/plot'
-import type { BondingStrategy } from '$lib/structure/bonding'
-import { merge_nested } from './utils'
-
-// SettingType interface with optional context to control where settings apply
-// context: 'web' = web browser only, 'editor' = VSCode extension only, 'notebook' = Jupyter/marimo only, 'all' or undefined = all contexts
-export interface SettingType<T = unknown> {
-  value: T
-  description: string
-  enum?: Readonly<Record<Extract<T, string>, string>>
-  minimum?: number
-  maximum?: number
-  minItems?: number
-  maxItems?: number
-  context?: `web` | `editor` | `notebook` | `all`
-}
-
-export const SHOW_BONDS_OPTIONS = [`never`, `always`, `crystals`, `molecules`] as const
-export type ShowBonds = (typeof SHOW_BONDS_OPTIONS)[number]
-
-export type CameraProjection = `perspective` | `orthographic`
-
-export const VECTOR_COLOR_MODES = [
-  `auto`,
-  `element`,
-  `spin_direction`,
-  `magnitude`,
-  `uniform`,
-] as const
-export type VectorColorMode = (typeof VECTOR_COLOR_MODES)[number]
-
-// Per-key configuration for site vector layers (force, magmom, spin, etc.)
-export type VectorLayerConfig = {
-  visible: boolean
-  color: string | null // null = auto from palette
-  scale: number | null // null = use global scale only (multiplier of 1.0)
-}
-
-export const ATOM_COLOR_MODE_OPTIONS = [
-  `element`,
-  `coordination`,
-  `wyckoff`,
-  `custom`,
-] as const
-export type AtomColorMode = (typeof ATOM_COLOR_MODE_OPTIONS)[number]
-
-// Reusable type definitions for common setting patterns
-type DisplayConfigType = {
-  x_grid: SettingType<boolean>
-  y_grid: SettingType<boolean>
-  y2_grid: SettingType<boolean>
-  x_zero_line: SettingType<boolean>
-  y_zero_line: SettingType<boolean>
-}
-
-type BarStyleType = {
-  color: SettingType<string>
-  opacity: SettingType<number>
-  stroke_width: SettingType<number>
-  stroke_color: SettingType<string>
-  stroke_opacity: SettingType<number>
-}
-
-type PointStyleType = {
-  size: SettingType<number>
-  color: SettingType<string>
-  opacity: SettingType<number>
-  stroke_width: SettingType<number>
-  stroke_color: SettingType<string>
-  stroke_opacity: SettingType<number>
-}
-
-type LineStyleType = {
-  width: SettingType<number>
-  color: SettingType<string>
-  opacity: SettingType<number>
-  dash: SettingType<string>
-}
-
-type SimpleBarStyleType = {
-  color: SettingType<string>
-  opacity: SettingType<number>
-  border_radius: SettingType<number>
-}
-
-type SimpleLineStyleType = { width: SettingType<number>; color: SettingType<string> }
-
-type ConvexHullCommonType = {
-  camera_zoom: SettingType<number>
-  camera_center_x: SettingType<number>
-  camera_center_y: SettingType<number>
-  color_mode: SettingType<`stability` | `energy`>
-  color_scale: SettingType<string>
-  show_stable: SettingType<boolean>
-  show_unstable: SettingType<boolean>
-  show_stable_labels: SettingType<boolean>
-  show_unstable_labels: SettingType<boolean>
-  max_hull_dist_show_phases: SettingType<number>
-  max_hull_dist_show_labels: SettingType<number>
-  fullscreen: SettingType<boolean>
-  info_pane_open: SettingType<boolean>
-  legend_pane_open: SettingType<boolean>
-}
-
-type ConvexHullWith3DType = ConvexHullCommonType & {
-  show_hull_faces: SettingType<boolean>
-  hull_face_color: SettingType<string>
-  hull_face_opacity: SettingType<number>
-  hull_face_color_mode: SettingType<HullFaceColorMode>
-}
-
-export interface SettingsConfig {
-  // General display settings
-  color_scheme: SettingType<string>
-  background_color: SettingType<string>
-  background_opacity: SettingType<number>
-
-  // Symmetry Analysis
-  symmetry: {
-    symprec: SettingType<number>
-    algo: SettingType<`Moyo` | `Spglib`>
-  }
-
-  structure: {
-    // Structure viewer settings
-    // Atoms & Bonds
-    atom_radius: SettingType<number>
-    same_size_atoms: SettingType<boolean>
-    show_atoms: SettingType<boolean>
-    show_image_atoms: SettingType<boolean>
-    sphere_segments: SettingType<number>
-    bond_thickness: SettingType<number>
-    auto_bond_order: SettingType<boolean>
-    aromatic_display: SettingType<`aromatic` | `kekule`>
-    show_bonds: SettingType<ShowBonds>
-    bond_color: SettingType<string>
-    bonding_strategy: SettingType<BondingStrategy>
-    atom_color_mode: SettingType<AtomColorMode>
-    atom_color_scale: SettingType<D3InterpolateName>
-    atom_color_scale_type: SettingType<ColorScaleType>
-
-    // Camera & Controls
-    show_gizmo: SettingType<boolean>
-    camera_position: SettingType<Vec3>
-    camera_projection: SettingType<CameraProjection>
-    initial_zoom: SettingType<number>
-    fov: SettingType<number>
-    rotation_damping: SettingType<number>
-    rotate_speed: SettingType<number>
-    zoom_speed: SettingType<number>
-    pan_speed: SettingType<number>
-    zoom_to_cursor: SettingType<boolean>
-    max_zoom: SettingType<number | undefined>
-    min_zoom: SettingType<number | undefined>
-    auto_rotate: SettingType<number>
-    // Manual rotation controls [x, y, z] in radians
-    rotation: SettingType<Vec3>
-
-    // Labels & Lighting
-    show_site_labels: SettingType<boolean>
-    show_site_indices: SettingType<boolean>
-    site_label_size: SettingType<number>
-    site_label_color: SettingType<string>
-    site_label_bg_color: SettingType<string>
-    site_label_padding: SettingType<number>
-    site_label_offset: SettingType<Vec3>
-    ambient_light: SettingType<number>
-    directional_light: SettingType<number>
-
-    // Site Vectors (force, magmom, spin) & Lattice
-    vector_configs: SettingType<Record<string, VectorLayerConfig>>
-    vector_scale: SettingType<number>
-    vector_color: SettingType<string>
-    vector_color_mode: SettingType<VectorColorMode>
-    vector_color_scale: SettingType<D3InterpolateName>
-    vector_normalize: SettingType<boolean>
-    vector_uniform_thickness: SettingType<boolean>
-    vector_origin_gap: SettingType<number>
-    vector_shaft_radius: SettingType<number>
-    vector_arrow_head_radius: SettingType<number>
-    vector_arrow_head_length: SettingType<number>
-    show_cell: SettingType<boolean>
-    show_cell_vectors: SettingType<boolean>
-    cell_edge_opacity: SettingType<number>
-    cell_surface_opacity: SettingType<number>
-    cell_edge_color: SettingType<string>
-    cell_surface_color: SettingType<string>
-    cell_edge_width: SettingType<number>
-    fullscreen_toggle: SettingType<boolean>
-  }
-
-  trajectory: {
-    // Trajectory viewer settings
-    // Core trajectory settings
-    auto_play: SettingType<boolean>
-    fps: SettingType<number>
-    fps_range: SettingType<[number, number]>
-    display_mode: SettingType<
-      `structure+scatter` | `structure` | `scatter` | `histogram` | `structure+histogram`
-    >
-    show_controls: SettingType<boolean>
-    fullscreen_toggle: SettingType<boolean>
-    step_labels: SettingType<number>
-    layout: SettingType<`auto` | Orientation>
-
-    // File handling and loading
-    allow_file_drop: SettingType<boolean>
-    bin_file_threshold: SettingType<number>
-    text_file_threshold: SettingType<number>
-    use_indexing: SettingType<boolean>
-    chunk_size: SettingType<number>
-
-    // Formatting
-    step_label_format: SettingType<string>
-    property_value_format: SettingType<string>
-    tooltip_format: SettingType<string>
-
-    // UI/UX
-    enable_keyboard_shortcuts: SettingType<boolean>
-    show_parsing_progress: SettingType<boolean>
-    compact_controls: SettingType<boolean>
-    show_filename_in_controls: SettingType<boolean>
-
-    // Playback behavior
-    smooth_playback: SettingType<boolean>
-    loop_playback: SettingType<boolean>
-    pause_on_hover: SettingType<boolean>
-    highlight_current_frame: SettingType<boolean>
-    show_frame_info: SettingType<boolean>
-
-    // Performance
-    max_frames_in_memory: SettingType<number>
-    memory_usage_warning_threshold: SettingType<number>
-    enable_performance_monitoring: SettingType<boolean>
-    prefetch_frames: SettingType<number>
-    cache_parsed_data: SettingType<boolean>
-  }
-
-  plot: {
-    // General plot settings
-    animation_duration: SettingType<number>
-    enable_zoom: SettingType<boolean>
-    zoom_factor: SettingType<number>
-    auto_fit_range: SettingType<boolean>
-    grid_lines: SettingType<boolean>
-    axis_labels: SettingType<boolean>
-    show_x_zero_line: SettingType<boolean>
-    show_y_zero_line: SettingType<boolean>
-    show_x_grid: SettingType<boolean>
-    show_x2_grid: SettingType<boolean>
-    show_y_grid: SettingType<boolean>
-    show_y2_grid: SettingType<boolean>
-    x_format: SettingType<string>
-    x2_format: SettingType<string>
-    y_format: SettingType<string>
-    y2_format: SettingType<string>
-    x_scale_type: SettingType<string>
-    y_scale_type: SettingType<string>
-    x_ticks: SettingType<number>
-    y_ticks: SettingType<number>
-  }
-
-  scatter: {
-    // Scatter plot settings
-    show_legend: SettingType<boolean>
-    show_points: SettingType<boolean>
-    show_lines: SettingType<boolean>
-    symbol_type: SettingType<D3SymbolName>
-    display: DisplayConfigType
-    point: PointStyleType
-    line: LineStyleType
-  }
-
-  histogram: {
-    // Histogram settings
-    mode: SettingType<`overlay` | `single`>
-    show_legend: SettingType<boolean>
-    bin_count: SettingType<number>
-    bar: BarStyleType
-    display: DisplayConfigType
-  }
-
-  bar: {
-    // Bar plot settings
-    display: DisplayConfigType
-    bar: SimpleBarStyleType
-    line: SimpleLineStyleType
-  }
-
-  composition: {
-    // Composition specific settings
-    display_mode: SettingType<`pie` | `bubble` | `bar`>
-    color_scheme: SettingType<string>
-  }
-
-  convex_hull: {
-    // Convex hull defaults (binary/ternary/quaternary)
-    binary: ConvexHullCommonType
-    ternary: ConvexHullWith3DType & {
-      camera_elevation: SettingType<number>
-      camera_azimuth: SettingType<number>
-    }
-    quaternary: ConvexHullWith3DType & {
-      camera_rotation_x: SettingType<number>
-      camera_rotation_y: SettingType<number>
-    }
-  }
-}
-
-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`,
-  },
-} as const
-
-// Complete settings configuration with values, descriptions, and constraints
-export const SETTINGS_CONFIG: SettingsConfig = {
-  // 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` as const,
-      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)]),
-      ) as Readonly<Record<ShowBonds, string>>,
-    },
-    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`,
-      } as Readonly<Record<AtomColorMode, string>>,
-    },
-    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] as const,
-      description: `Initial camera position [x, y, z]`,
-      minItems: 3,
-      maxItems: 3,
-    },
-    camera_projection: {
-      value: `orthographic` as const,
-      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] as const,
-      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] as const,
-      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: {} as Record<string, VectorLayerConfig>,
-      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` as VectorColorMode,
-      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` as D3InterpolateName,
-      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] as const,
-      description: `Allowed range for playback speed [min, max]`,
-      minItems: 2,
-      maxItems: 2,
-    },
-    display_mode: {
-      value: `structure+scatter` as const,
-      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` as const,
-      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` as const,
-      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` as const,
-      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])) as Readonly<
-        Record<D3SymbolName, string>
-      >,
-    },
-    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 the value types for runtime use (up to 3 nested levels)
-export type DefaultSettings = {
-  [K in keyof SettingsConfig]: SettingsConfig[K] extends SettingType<infer T>
-    ? T
-    : SettingsConfig[K] extends Record<string, unknown>
-      ? {
-          [NK in keyof SettingsConfig[K]]: SettingsConfig[K][NK] extends SettingType<infer T>
-            ? T
-            : SettingsConfig[K][NK] extends Record<string, unknown>
-              ? {
-                  [NNK in keyof SettingsConfig[K][NK]]: SettingsConfig[K][NK][NNK] extends SettingType<
-                    infer T
-                  >
-                    ? T
-                    : never
-                }
-              : never
-        }
-      : never
-}
-
-// Extract values from settings config for runtime use
-const extract_values = (
-  config: SettingsConfig | SettingType | Record<string, unknown>,
-): DefaultSettings => {
-  const result = {} as Record<string, unknown>
-  for (const [key, value] of Object.entries(config)) {
-    if (value && typeof value === `object` && `value` in value) {
-      result[key] = (value as SettingType).value
-    } else if (value && typeof value === `object`) {
-      result[key] = extract_values(value as Record<string, unknown>)
-    }
-  }
-  return result as DefaultSettings
-}
-
-// 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?: Partial<DefaultSettings>): DefaultSettings =>
-  ({
-    ...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),
-  }) as DefaultSettings