matterviz 0.4.0 → 0.4.2

package/dist/spectral/Bands.svelte.d.ts

@@ -1,3 +1,4 @@
+import type { Vec2 } from '../math';
 import ScatterPlot from '../plot/scatter/ScatterPlot.svelte';
 import type { AxisConfig } from '../plot/core/types';
 import type { BandsSpinMode, BandStructureType, BaseBandStructure, FrequencyUnit, LineKwargs, PathMode, RibbonConfig } from './types';
@@ -10,7 +11,7 @@ type $$ComponentProps = ComponentProps<typeof ScatterPlot> & {
     path_mode?: PathMode;
     band_type?: BandStructureType;
     show_legend?: boolean;
-    x_positions?: Record<string, [number, number]>;
+    x_positions?: Record<string, Vec2>;
     reference_frequency?: number | null;
     highlighted_qpoint_index?: number | null;
     ribbon_config?: RibbonConfig | Record<string, RibbonConfig>;
@@ -34,6 +35,6 @@ type $$ComponentProps = ComponentProps<typeof ScatterPlot> & {
     id?: string;
     'data-testid'?: string;
 };
-declare const Bands: import("svelte").Component<$$ComponentProps, {}, "y_axis" | "units" | "x_positions" | "band_spin_mode">;
+declare const Bands: import("svelte").Component<$$ComponentProps, {}, "y_axis" | "x_positions" | "units" | "band_spin_mode">;
 type Bands = ReturnType<typeof Bands>;
 export default Bands;

package/dist/spectral/BandsAndDos.svelte

@@ -44,10 +44,12 @@
   const bands_default_axis = (range = shared_frequency_range): AxisConfig =>
     shared_y_axis ? axis_with_range(bands_props.y_axis, range) : { ...bands_props.y_axis }
   const dos_default_axis = (range = shared_frequency_range): AxisConfig =>
-    shared_y_axis ? axis_with_range(dos_props.y_axis, range, ``) : {
-      label: ``,
-      ...dos_props.y_axis,
-    }
+    shared_y_axis
+      ? axis_with_range(dos_props.y_axis, range, ``)
+      : {
+          label: ``,
+          ...dos_props.y_axis,
+        }
 
   let synced_zoom_range = $state<Vec2 | null>(null)
   let bands_y_axis = $state<AxisConfig>(bands_default_axis())
@@ -74,31 +76,29 @@
     if (result !== undefined) synced_zoom_range = result
   })
 
-  // Propagate synced range to bands y-axis (untrack current to avoid overwriting child zoom)
-  $effect(() => {
-    const base_range = synced_zoom_range ?? shared_frequency_range
-    const current_range = untrack(() => bands_y_axis.range) as Vec2 | undefined
-    // Skip if current range already matches base, or is valid but differs (child zoom in progress)
-    if (ranges_equal(current_range, base_range)) return
-    if (is_valid_range(current_range) && !ranges_equal(current_range, base_range)) {
-      return
-    }
-    // Only include range if it's valid (don't override child's auto-range with undefined)
-    bands_y_axis = bands_default_axis(base_range)
-  })
-
-  // Propagate synced range to DOS y-axis (untrack current to avoid overwriting child zoom)
-  $effect(() => {
+  // Propagate the synced range to a child y-axis (untrack current to avoid overwriting
+  // child zoom). Skips when the current range already matches base, or is valid but
+  // differs (child zoom in progress).
+  const propagate_synced_range = (
+    current_range: Vec2 | undefined,
+    apply: (base_range: Vec2 | undefined) => void,
+  ) => {
     const base_range = synced_zoom_range ?? shared_frequency_range
-    const current_range = untrack(() => dos_y_axis.range) as Vec2 | undefined
-    // Skip if current range already matches base, or is valid but differs (child zoom in progress)
-    if (ranges_equal(current_range, base_range)) return
-    if (is_valid_range(current_range) && !ranges_equal(current_range, base_range)) {
-      return
-    }
-    // Only include range if it's valid (don't override child's auto-range with undefined)
-    dos_y_axis = dos_default_axis(base_range)
-  })
+    if (ranges_equal(current_range, base_range) || is_valid_range(current_range)) return
+    apply(base_range)
+  }
+  $effect(() =>
+    propagate_synced_range(
+      untrack(() => bands_y_axis.range) as Vec2 | undefined,
+      (base_range) => (bands_y_axis = bands_default_axis(base_range)),
+    ),
+  )
+  $effect(() =>
+    propagate_synced_range(
+      untrack(() => dos_y_axis.range) as Vec2 | undefined,
+      (base_range) => (dos_y_axis = dos_default_axis(base_range)),
+    ),
+  )
 
   let hovered_frequency = $state<number | null>(null)
 
@@ -108,7 +108,7 @@
 
 <div
   {...rest}
-  class="bands-and-dos {rest.class ?? ``}"
+  class={[`bands-and-dos`, rest.class]}
   style={`display: grid; grid-template-columns: 1fr 200px; gap: 0;` + (rest.style ?? ``)}
 >
   {@render children?.({ hovered_frequency })}

package/dist/spectral/BrillouinBandsDos.svelte

@@ -44,16 +44,13 @@
   ) as BaseBandStructure | null
 
   // Compute shared frequency/energy range from both bands and DOS data
-  let shared_frequency_range = $derived(
-    helpers.compute_frequency_range(band_structs, doses),
-  )
+  let shared_frequency_range = $derived(helpers.compute_frequency_range(band_structs, doses))
 
   // Extract Fermi level from electronic band structure or DOS data
   let fermi_level = $derived.by((): number | undefined => {
     // Check band structures for efermi
-    const bs_source = `efermi` in (band_structs as object)
-      ? band_structs
-      : Object.values(band_structs)[0]
+    const bs_source =
+      `efermi` in (band_structs as object) ? band_structs : Object.values(band_structs)[0]
     const bs_efermi = (bs_source as Record<string, unknown>)?.efermi
     if (typeof bs_efermi === `number`) return bs_efermi
 
@@ -73,15 +70,14 @@
   })
 
   let hovered_band_point = $state<InternalPoint | null>(null)
-  let bands_x_positions = $state<Record<string, [number, number]>>({})
+  let bands_x_positions = $state<Record<string, Vec2>>({})
   let hovered_qpoint_index = $derived(
-    hovered_band_point && first_band_struct &&
-      Object.keys(bands_x_positions).length > 0
+    hovered_band_point && first_band_struct && Object.keys(bands_x_positions).length > 0
       ? helpers.find_qpoint_at_rescaled_x(
-        first_band_struct,
-        hovered_band_point.x,
-        bands_x_positions,
-      )
+          first_band_struct,
+          hovered_band_point.x,
+          bands_x_positions,
+        )
       : null,
   )
   // Q-point hovered directly on the BZ k-path (reverse direction: BZ -> bands/DOS)
@@ -89,9 +85,7 @@
   // Unified hovered q-point: a band-point hover takes priority, else a BZ k-path hover
   let active_qpoint_index = $derived(hovered_qpoint_index ?? bz_hovered_qpoint_index)
   let hovered_k_point = $derived(
-    active_qpoint_index !== null
-      ? (k_path_points[active_qpoint_index] as Vec3)
-      : null,
+    active_qpoint_index !== null ? (k_path_points[active_qpoint_index] as Vec3) : null,
   )
   const [desktop_width, tablet_width] = [1200, 600]
   let clientWidth = $state(desktop_width)
@@ -101,8 +95,8 @@
     clientWidth >= desktop_width
       ? `desktop`
       : clientWidth >= tablet_width
-      ? `tablet`
-      : `phone`,
+        ? `tablet`
+        : `phone`,
   )
 
   const bands_default_axis = (range = shared_frequency_range): AxisConfig =>
@@ -169,11 +163,7 @@
   let hovered_frequency = $state<number | null>(null)
 </script>
 
-<div
-  {...rest}
-  class="bands-dos-brillouin {screen_class} {rest.class ?? ``}"
-  bind:clientWidth
->
+<div {...rest} class={[`bands-dos-brillouin`, screen_class, rest.class]} bind:clientWidth>
   {@render children?.({
     hovered_frequency,
     hovered_band_point,
@@ -199,13 +189,15 @@
     style="grid-area: bz; min-width: 0; min-height: 0; overflow: hidden; height: 100%"
     {structure}
     {k_path_points}
-    k_path_labels={first_band_struct?.qpoints?.flatMap((q, idx) =>
+    k_path_labels={first_band_struct?.qpoints?.flatMap((qpoint, idx) =>
       k_path_points[idx]
-        ? [{
-          position: k_path_points[idx],
-          label: q.label ? helpers.pretty_sym_point(q.label) : null,
-        }]
-        : []
+        ? [
+            {
+              position: k_path_points[idx],
+              label: qpoint.label ? helpers.pretty_sym_point(qpoint.label) : null,
+            },
+          ]
+        : [],
     ) ?? []}
     {hovered_k_point}
     hovered_qpoint_index={active_qpoint_index}

package/dist/spectral/Dos.svelte

@@ -2,6 +2,7 @@
   import { PLOT_COLORS } from '../colors'
   import EmptyState from '../EmptyState.svelte'
   import { SettingsSection } from '../layout'
+  import type { Vec2 } from '../math'
   import ScatterPlot from '../plot/scatter/ScatterPlot.svelte'
   import type { AxisConfig, DataSeries } from '../plot/core/types'
   import type { ComponentProps } from 'svelte'
@@ -78,7 +79,7 @@
     show_sigma_control?: boolean // Show sigma/smearing control
     show_normalize_control?: boolean // Show normalization selector
     show_units_control?: boolean // Show units selector (phonon DOS only)
-    sigma_range?: [number, number] // Min/max range for sigma slider (auto-detected if not provided)
+    sigma_range?: Vec2 // Min/max range for sigma slider (auto-detected if not provided)
   } = $props()
 
   const is_horizontal = $derived(orientation === `horizontal`)
@@ -174,17 +175,18 @@
         }
 
         // Check for spin-down data (only for electronic DOS)
-        const has_spin_down = dos.type === `electronic` &&
-          dos.spin_down_densities?.length === dos.densities.length
+        const has_spin_down =
+          dos.type === `electronic` && dos.spin_down_densities?.length === dos.densities.length
         const should_show_spin_up = effective_spin_mode !== `down_only`
-        const should_show_spin_down = has_spin_down &&
-          effective_spin_mode !== `up_only` && effective_spin_mode !== null
+        const should_show_spin_down =
+          has_spin_down && effective_spin_mode !== `up_only` && effective_spin_mode !== null
 
         // Process spin-up (or total) densities
         if (should_show_spin_up) {
-          let densities_up = sigma > 0
-            ? apply_gaussian_smearing(x_values, dos.densities, sigma)
-            : [...dos.densities]
+          let densities_up =
+            sigma > 0
+              ? apply_gaussian_smearing(x_values, dos.densities, sigma)
+              : [...dos.densities]
 
           densities_up = normalize_densities(densities_up, x_values, normalize)
 
@@ -193,8 +195,8 @@
 
           // For stacked plots, accumulate densities (only if array lengths match)
           if (stack && cumulative_spin_up?.length === densities_up.length) {
-            densities_up = densities_up.map((density, idx) =>
-              density + (cumulative_spin_up?.[idx] ?? 0)
+            densities_up = densities_up.map(
+              (density, idx) => density + (cumulative_spin_up?.[idx] ?? 0),
             )
           } else if (stack && cumulative_spin_up) {
             console.warn(`DOS stacking: length mismatch for "${label}"`)
@@ -211,9 +213,10 @@
             cumulative_spin_up = densities_up
           }
 
-          const spin_label = has_spin_down && effective_spin_mode
-            ? `${label || `DOS ${dos_idx + 1}`} (↑)`
-            : (label || `DOS ${dos_idx + 1}`)
+          const spin_label =
+            has_spin_down && effective_spin_mode
+              ? `${label || `DOS ${dos_idx + 1}`} (↑)`
+              : label || `DOS ${dos_idx + 1}`
 
           const series_up: DataSeries = {
             x: is_horizontal ? densities_up : x_values,
@@ -227,13 +230,11 @@
         }
 
         // Process spin-down densities if available
-        if (
-          should_show_spin_down && dos.type === `electronic` &&
-          dos.spin_down_densities
-        ) {
-          let densities_down = sigma > 0
-            ? apply_gaussian_smearing(x_values, dos.spin_down_densities, sigma)
-            : [...dos.spin_down_densities]
+        if (should_show_spin_down && dos.type === `electronic` && dos.spin_down_densities) {
+          let densities_down =
+            sigma > 0
+              ? apply_gaussian_smearing(x_values, dos.spin_down_densities, sigma)
+              : [...dos.spin_down_densities]
 
           densities_down = normalize_densities(densities_down, x_values, normalize)
 
@@ -245,12 +246,10 @@
           // For stacked plots with overlay mode, use separate spin-down cumulative
           // This prevents spin-down from stacking on top of spin-up within the same DOS
           if (stack && effective_spin_mode === `overlay`) {
-            const prev_spin_down = cumulative_spin_down
-              ? [...cumulative_spin_down]
-              : null
+            const prev_spin_down = cumulative_spin_down ? [...cumulative_spin_down] : null
             if (cumulative_spin_down?.length === densities_down.length) {
-              densities_down = densities_down.map((density, idx) =>
-                density + (cumulative_spin_down?.[idx] ?? 0)
+              densities_down = densities_down.map(
+                (density, idx) => density + (cumulative_spin_down?.[idx] ?? 0),
               )
             } else if (cumulative_spin_down) {
               console.warn(`DOS stacking (spin-down): length mismatch for "${label}"`)
@@ -267,9 +266,10 @@
           }
 
           // Use a slightly different shade for spin-down in overlay mode
-          const spin_down_color = effective_spin_mode === `overlay`
-            ? PLOT_COLORS[(dos_idx * 2 + 1) % PLOT_COLORS.length]
-            : color
+          const spin_down_color =
+            effective_spin_mode === `overlay`
+              ? PLOT_COLORS[(dos_idx * 2 + 1) % PLOT_COLORS.length]
+              : color
 
           const series_down: DataSeries = {
             x: is_horizontal ? densities_down : x_values,
@@ -290,9 +290,10 @@
     },
   )
 
-  let all_freqs = $derived( // for clamping phonon noise
+  let all_freqs = $derived(
+    // for clamping phonon noise
     Object.values(doses_dict).flatMap((dos) =>
-      dos.type === `phonon` ? dos.frequencies : dos.energies
+      dos.type === `phonon` ? dos.frequencies : dos.energies,
     ),
   )
   let clamp_to_zero = $derived(
@@ -303,24 +304,24 @@
   )
 
   // Check if we have mirrored spin-down data (negative densities)
-  let has_mirrored_spin = $derived(
-    effective_spin_mode === `mirror` && has_spin_polarized,
-  )
+  let has_mirrored_spin = $derived(effective_spin_mode === `mirror` && has_spin_polarized)
 
-  let x_range = $derived.by((): [number, number] | undefined => {
+  let x_range = $derived.by((): Vec2 | undefined => {
     if (series_data.length === 0) return undefined
     const all_x = series_data.flatMap((srs) => srs.x)
-    const min_x = Math.min(...all_x), max_x = Math.max(...all_x)
+    const min_x = Math.min(...all_x),
+      max_x = Math.max(...all_x)
     // For horizontal orientation with mirror mode, allow negative values (mirrored densities)
     if (is_horizontal && has_mirrored_spin) return [min_x, max_x]
     if (is_horizontal || clamp_to_zero) return [0, max_x]
     return [min_x, max_x]
   })
 
-  let y_range = $derived.by((): [number, number] | undefined => {
+  let y_range = $derived.by((): Vec2 | undefined => {
     if (series_data.length === 0) return undefined
     const all_y = series_data.flatMap((srs) => srs.y)
-    const min_y = Math.min(...all_y), max_y = Math.max(...all_y)
+    const min_y = Math.min(...all_y),
+      max_y = Math.max(...all_y)
     // For vertical orientation with mirror mode, allow negative values (mirrored densities)
     if (!is_horizontal && has_mirrored_spin) return [min_y, max_y]
     if (!is_horizontal || clamp_to_zero) return [0, max_y]
@@ -329,16 +330,10 @@
 
   // Get axis labels based on orientation
   let x_label = $derived(
-    is_horizontal
-      ? `Density of States`
-      : is_phonon
-      ? `Frequency (${units})`
-      : `Energy (eV)`,
+    is_horizontal ? `Density of States` : is_phonon ? `Frequency (${units})` : `Energy (eV)`,
   )
   let y_label = $derived(
-    is_horizontal
-      ? (is_phonon ? `Frequency (${units})` : `Energy (eV)`)
-      : `Density of States`,
+    is_horizontal ? (is_phonon ? `Frequency (${units})` : `Energy (eV)`) : `Density of States`,
   )
 
   // Compute final axis configurations with default labels
@@ -358,7 +353,6 @@
     range: y_range,
     ...y_axis,
   })
-
   // Sync zoom changes from ScatterPlot back to parent via bindable y_axis
   // Also clears parent range when internal range becomes invalid (auto-range reset)
   $effect(() => {
@@ -377,7 +371,7 @@
   let has_valid_data = $derived(series_data.length > 0)
 
   // Auto-detect sigma range based on frequency/energy range
-  let effective_sigma_range = $derived.by((): [number, number] => {
+  let effective_sigma_range = $derived.by((): Vec2 => {
     if (sigma_range) return sigma_range
     if (all_freqs.length === 0) return [0, 1]
     const freq_range = Math.max(...all_freqs) - Math.min(...all_freqs)
@@ -419,9 +413,13 @@
       lower_coords.push(`${lower_x.toFixed(2)},${lower_y.toFixed(2)}`)
     }
     // Trace upper edge forward, lower edge backward, close path
-    return `M${upper_coords[0]} ${
-      upper_coords.slice(1).map((coord) => `L${coord}`).join(` `)
-    } ${lower_coords.toReversed().map((coord) => `L${coord}`).join(` `)} Z`
+    return `M${upper_coords[0]} ${upper_coords
+      .slice(1)
+      .map((coord) => `L${coord}`)
+      .join(` `)} ${lower_coords
+      .toReversed()
+      .map((coord) => `L${coord}`)
+      .join(` `)} Z`
   }
 </script>
 
@@ -435,24 +433,22 @@
     hover_config={{ threshold_px: 50 }}
     controls={{ show: show_controls }}
     on_point_hover={(event) => {
-      hovered_frequency = is_horizontal
-        ? (event?.point?.y ?? null)
-        : (event?.point?.x ?? null)
+      hovered_frequency = is_horizontal ? (event?.point?.y ?? null) : (event?.point?.x ?? null)
     }}
     {...{ range_padding: 0, ...rest }}
   >
     {#snippet tooltip({ x_formatted, y_formatted, label })}
       {@const tooltip_data = format_dos_tooltip(
-      x_formatted,
-      y_formatted,
-      label ?? null,
-      is_horizontal,
-      is_phonon,
-      units,
-      final_x_axis.label ?? ``,
-      internal_y_axis.label ?? ``,
-      Object.keys(doses_dict).length,
-    )}
+        x_formatted,
+        y_formatted,
+        label ?? null,
+        is_horizontal,
+        is_phonon,
+        units,
+        final_x_axis.label ?? ``,
+        internal_y_axis.label ?? ``,
+        Object.keys(doses_dict).length,
+      )}
       {#if tooltip_data.title}<strong>{tooltip_data.title}</strong><br />{/if}
       {#each tooltip_data.lines as line, line_idx (line_idx)}
         {line}{#if line_idx < tooltip_data.lines.length - 1}<br />{/if}
@@ -558,15 +554,16 @@
       {/if}
 
       <!-- Fermi level line for electronic DOS -->
-      {@const fermi_pos = effective_fermi_level !== undefined
-      ? (is_horizontal
-        ? y_scale_fn(effective_fermi_level)
-        : x_scale_fn(effective_fermi_level))
-      : NaN}
+      {@const fermi_pos =
+        effective_fermi_level !== undefined
+          ? is_horizontal
+            ? y_scale_fn(effective_fermi_level)
+            : x_scale_fn(effective_fermi_level)
+          : NaN}
       {#if Number.isFinite(fermi_pos)}
         {@const [x1, x2, y1, y2] = is_horizontal
-      ? [pad.l, width - pad.r, fermi_pos, fermi_pos]
-      : [fermi_pos, fermi_pos, pad.t, height - pad.b]}
+          ? [pad.l, width - pad.r, fermi_pos, fermi_pos]
+          : [fermi_pos, fermi_pos, pad.t, height - pad.b]}
         <line
           class="fermi-level-line"
           {x1}
@@ -607,15 +604,16 @@
       {/if}
 
       <!-- Reference frequency line -->
-      {@const ref_pos = reference_frequency !== null
-      ? (is_horizontal
-        ? y_scale_fn(reference_frequency)
-        : x_scale_fn(reference_frequency))
-      : NaN}
+      {@const ref_pos =
+        reference_frequency !== null
+          ? is_horizontal
+            ? y_scale_fn(reference_frequency)
+            : x_scale_fn(reference_frequency)
+          : NaN}
       {#if Number.isFinite(ref_pos)}
         {@const [x1, x2, y1, y2] = is_horizontal
-      ? [pad.l, width - pad.r, ref_pos, ref_pos]
-      : [ref_pos, ref_pos, pad.t, height - pad.b]}
+          ? [pad.l, width - pad.r, ref_pos, ref_pos]
+          : [ref_pos, ref_pos, pad.t, height - pad.b]}
         <line
           {x1}
           {x2}

package/dist/spectral/Dos.svelte.d.ts

@@ -1,3 +1,4 @@
+import type { Vec2 } from '../math';
 import ScatterPlot from '../plot/scatter/ScatterPlot.svelte';
 import type { AxisConfig } from '../plot/core/types';
 import type { ComponentProps } from 'svelte';
@@ -22,7 +23,7 @@ type $$ComponentProps = ComponentProps<typeof ScatterPlot> & {
     show_sigma_control?: boolean;
     show_normalize_control?: boolean;
     show_units_control?: boolean;
-    sigma_range?: [number, number];
+    sigma_range?: Vec2;
 };
 declare const Dos: import("svelte").Component<$$ComponentProps, {}, "normalize" | "y_axis" | "units" | "sigma" | "hovered_frequency" | "spin_mode">;
 type Dos = ReturnType<typeof Dos>;

package/dist/spectral/helpers.d.ts

@@ -22,7 +22,7 @@ export declare function extract_spin_channels<T>(data: unknown): {
     up: T;
     down: T | null;
 } | null;
-export declare function normalize_band_structure(bs: unknown): types.BaseBandStructure | null;
+export declare function normalize_band_structure(band_struct: unknown): types.BaseBandStructure | null;
 export declare function normalize_dos(dos: unknown, options?: {
     auto_convert_units?: boolean;
 }): types.DosData | null;
@@ -30,18 +30,18 @@ export declare function extract_k_path_points(band_struct: types.BaseBandStructu
     wrap_to_bz?: boolean;
 }): Vec3[];
 export declare function find_qpoint_at_distance(band_struct: types.BaseBandStructure, target: number): number | null;
-export declare function qpoint_x_position(band_struct: types.BaseBandStructure, qpoint_index: number, x_positions: Record<string, [number, number]>): number | null;
-export declare function find_qpoint_at_rescaled_x(band_struct: types.BaseBandStructure, rescaled_x: number, x_positions: Record<string, [number, number]>): number | null;
+export declare function qpoint_x_position(band_struct: types.BaseBandStructure, qpoint_index: number, x_positions: Record<string, Vec2>): number | null;
+export declare function find_qpoint_at_rescaled_x(band_struct: types.BaseBandStructure, rescaled_x: number, x_positions: Record<string, Vec2>): number | null;
 type SpinDensities = Record<string, number[]>;
 export interface PymatgenDos {
-    '@class': string;
-    '@module': string;
+    '@class'?: string;
+    '@module'?: string;
     energies: number[];
     densities: SpinDensities | number[];
     efermi: number;
 }
 export interface PymatgenCompleteDos extends PymatgenDos {
-    '@class': `CompleteDos` | `LobsterCompleteDos`;
+    '@class'?: `CompleteDos` | `LobsterCompleteDos`;
     structure?: Record<string, unknown>;
     pdos?: Record<string, SpinDensities>[];
     atom_dos?: Record<string, PymatgenDos>;
@@ -52,7 +52,7 @@ export declare function shift_to_fermi(dos: PymatgenCompleteDos): PymatgenComple
 export declare function generate_ribbon_path(x_values: number[], y_values: number[], width_values: number[], x_scale_fn: (x: number) => number, y_scale_fn: (y: number) => number, max_width_px: number, scale?: number): string;
 export declare function extract_efermi(data: unknown): number | undefined;
 export declare function negative_fraction(values: number[]): number;
-export declare function compute_frequency_range(band_structs: unknown, doses: unknown, padding_factor?: number): [number, number] | undefined;
+export declare function compute_frequency_range(band_structs: unknown, doses: unknown, padding_factor?: number): Vec2 | undefined;
 export declare function format_dos_tooltip(x_formatted: string, y_formatted: string, label: string | null, is_horizontal: boolean, is_phonon: boolean, units: types.FrequencyUnit, x_axis_label: string, y_axis_label: string, num_series: number): {
     title?: string;
     lines: string[];
@@ -93,8 +93,8 @@ export declare const DEFAULT_SIGMA = 0;
 export declare const DEFAULT_NORMALIZE: types.NormalizationMode;
 export declare const DEFAULT_UNITS: types.FrequencyUnit;
 export declare function format_sigma(val: number): string;
-export declare const validate_sigma_range: ([min, max]: [number, number]) => [number, number];
-export declare function calculate_sigma_step(range: [number, number]): number;
+export declare const validate_sigma_range: ([min, max]: Vec2) => Vec2;
+export declare function calculate_sigma_step(range: Vec2): number;
 export interface BandPointMeta extends Record<string, unknown> {
     band_idx: number;
     spin: `up` | `down`;