import type { ColorScaleType, D3InterpolateName } from './colors';
import type { HullFaceColorMode } from './convex-hull/types';
import type { D3SymbolName } from './labels';
import type { Vec2, Vec3 } from './math';
import type { BandwidthOption, Orientation, SankeyNodeAlign, SankeyOrientation, SunburstLabelRotation, SunburstLabelText, SunburstShape, SunburstValueMode, ViolinKind, ViolinSide, WhiskerMode } from './plot';
import type { BondingStrategy } from './structure/bonding';
import type { PolyhedraColorMode } from './structure/polyhedra';
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 declare const SHOW_BONDS_OPTIONS: readonly ["never", "always", "crystals", "molecules"];
export type ShowBonds = (typeof SHOW_BONDS_OPTIONS)[number];
export type CameraProjection = `perspective` | `orthographic`;
export declare const VECTOR_COLOR_MODES: readonly ["auto", "element", "spin_direction", "magnitude", "uniform"];
export type VectorColorMode = (typeof VECTOR_COLOR_MODES)[number];
export type VectorLayerConfig = {
    visible: boolean;
    color: string | null;
    scale: number | null;
};
export declare const ATOM_COLOR_MODE_OPTIONS: readonly ["element", "coordination", "wyckoff", "custom"];
export type AtomColorMode = (typeof ATOM_COLOR_MODE_OPTIONS)[number];
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 BoxStyleType = {
    color: SettingType<string>;
    opacity: SettingType<number>;
    stroke_width: SettingType<number>;
    stroke_color: SettingType<string>;
    border_radius: SettingType<number>;
};
type BoxWhiskerStyleType = {
    width: SettingType<number>;
    color: SettingType<string>;
    cap_fraction: SettingType<number>;
};
type BoxLineStyleType = {
    width: SettingType<number>;
    color: SettingType<string>;
};
type BoxOutlierStyleType = {
    radius: SettingType<number>;
    opacity: SettingType<number>;
    stroke_width: SettingType<number>;
};
type BoxViolinStyleType = {
    opacity: SettingType<number>;
    stroke_width: SettingType<number>;
};
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 {
    color_scheme: SettingType<string>;
    background_color: SettingType<string>;
    background_opacity: SettingType<number>;
    symmetry: {
        symprec: SettingType<number>;
        algo: SettingType<`Moyo` | `Spglib`>;
    };
    structure: {
        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>;
        show_polyhedra: SettingType<ShowBonds>;
        polyhedra_opacity: SettingType<number>;
        polyhedra_show_edges: SettingType<boolean>;
        polyhedra_edge_color: SettingType<string>;
        polyhedra_color_mode: SettingType<PolyhedraColorMode>;
        polyhedra_color: SettingType<string>;
        polyhedra_hide_center_atoms: SettingType<boolean>;
        polyhedra_min_neighbors: SettingType<number>;
        polyhedra_max_neighbors: SettingType<number>;
        polyhedra_excluded_elements: SettingType<readonly string[]>;
        polyhedra_included_elements: SettingType<readonly string[]>;
        atom_color_mode: SettingType<AtomColorMode>;
        atom_color_scale: SettingType<D3InterpolateName>;
        atom_color_scale_type: SettingType<ColorScaleType>;
        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>;
        rotation: SettingType<Vec3>;
        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>;
        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: {
        auto_play: SettingType<boolean>;
        fps: SettingType<number>;
        fps_range: SettingType<Vec2>;
        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>;
        allow_file_drop: SettingType<boolean>;
        bin_file_threshold: SettingType<number>;
        text_file_threshold: SettingType<number>;
        use_indexing: SettingType<boolean>;
        chunk_size: SettingType<number>;
        step_label_format: SettingType<string>;
        property_value_format: SettingType<string>;
        tooltip_format: SettingType<string>;
        enable_keyboard_shortcuts: SettingType<boolean>;
        show_parsing_progress: SettingType<boolean>;
        compact_controls: SettingType<boolean>;
        show_filename_in_controls: SettingType<boolean>;
        smooth_playback: SettingType<boolean>;
        loop_playback: SettingType<boolean>;
        pause_on_hover: SettingType<boolean>;
        highlight_current_frame: SettingType<boolean>;
        show_frame_info: SettingType<boolean>;
        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: {
        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: {
        show_legend: SettingType<boolean>;
        show_points: SettingType<boolean>;
        show_lines: SettingType<boolean>;
        symbol_type: SettingType<D3SymbolName>;
        display: DisplayConfigType;
        point: PointStyleType;
        line: LineStyleType;
    };
    histogram: {
        mode: SettingType<`overlay` | `single`>;
        show_legend: SettingType<boolean>;
        bin_count: SettingType<number>;
        bar: BarStyleType;
        display: DisplayConfigType;
    };
    bar: {
        display: DisplayConfigType;
        bar: SimpleBarStyleType;
        line: SimpleLineStyleType;
    };
    box: {
        whisker_mode: SettingType<WhiskerMode>;
        box_width: SettingType<number>;
        show_outliers: SettingType<boolean>;
        show_mean: SettingType<boolean>;
        kind: SettingType<ViolinKind>;
        side: SettingType<ViolinSide>;
        bandwidth: SettingType<Exclude<BandwidthOption, number>>;
        violin_width: SettingType<number>;
        violin_box_width: SettingType<number>;
        box: BoxStyleType;
        whisker: BoxWhiskerStyleType;
        median: BoxLineStyleType;
        outlier: BoxOutlierStyleType;
        violin: BoxViolinStyleType;
        display: DisplayConfigType;
    };
    sankey: {
        orientation: SettingType<SankeyOrientation>;
        node_align: SettingType<SankeyNodeAlign>;
        node_width: SettingType<number>;
        node_padding: SettingType<number>;
        link_opacity: SettingType<number>;
        show_node_labels: SettingType<boolean>;
        iterations: SettingType<number>;
    };
    sunburst: {
        shape: SettingType<SunburstShape>;
        value_mode: SettingType<SunburstValueMode>;
        max_depth: SettingType<number>;
        inner_radius: SettingType<number>;
        pad_angle: SettingType<number>;
        min_fraction: SettingType<number>;
        show_labels: SettingType<boolean>;
        label_rotation: SettingType<SunburstLabelRotation>;
        label_text: SettingType<SunburstLabelText>;
        zoom_on_click: SettingType<boolean>;
        show_breadcrumbs: SettingType<boolean>;
    };
    composition: {
        display_mode: SettingType<`pie` | `bubble` | `bar`>;
        color_scheme: SettingType<string>;
    };
    convex_hull: {
        binary: ConvexHullCommonType;
        ternary: ConvexHullWith3DType & {
            camera_elevation: SettingType<number>;
            camera_azimuth: SettingType<number>;
        };
        quaternary: ConvexHullWith3DType & {
            camera_rotation_x: SettingType<number>;
            camera_rotation_y: SettingType<number>;
        };
    };
}
export declare const SETTINGS_CONFIG: SettingsConfig;
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;
};
export declare const DEFAULTS: DefaultSettings;
export declare const merge: (user?: Partial<DefaultSettings>) => DefaultSettings;
export {};