matterviz 0.3.7 → 0.4.0

package/dist/settings.js

@@ -622,6 +622,264 @@ export const SETTINGS_CONFIG = {
         },
         display: DISPLAY_CONFIG,
     },
+    // Box plot specific
+    box: {
+        whisker_mode: {
+            value: `tukey`,
+            description: `How whiskers are computed: 'tukey' (1.5*IQR), 'minmax' (data extremes), 'percentile' (5th/95th), or 'std' (mean ± std)`,
+            enum: {
+                tukey: `Tukey (1.5·IQR)`,
+                minmax: `Min/Max`,
+                percentile: `Percentile`,
+                std: `Std Dev`,
+            },
+        },
+        box_width: {
+            value: 0.8,
+            description: `Box width as a fraction of the category slot`,
+            minimum: 0.1,
+            maximum: 1,
+        },
+        show_outliers: {
+            value: true,
+            description: `Show outlier points beyond the whiskers`,
+        },
+        show_mean: {
+            value: false,
+            description: `Show the mean marker inside each box`,
+        },
+        kind: {
+            value: `box`,
+            description: `Glyph to draw per series: box, violin (KDE density), or both`,
+            enum: { box: `Box`, violin: `Violin`, 'violin+box': `Violin + Box` },
+        },
+        side: {
+            value: `both`,
+            description: `Which half of the slot a violin occupies (one-sided / split violins)`,
+            enum: { both: `Both`, positive: `Positive`, negative: `Negative` },
+        },
+        bandwidth: {
+            value: `silverman`,
+            description: `KDE bandwidth rule for violins`,
+            enum: { silverman: `Silverman`, scott: `Scott` },
+        },
+        violin_width: {
+            value: 0.9,
+            description: `Violin width as a fraction of the category slot`,
+            minimum: 0.1,
+            maximum: 1,
+        },
+        violin_box_width: {
+            value: 0.2,
+            description: `Inner box width (fraction of slot) when a box is drawn inside a violin`,
+            minimum: 0.05,
+            maximum: 1,
+        },
+        box: {
+            color: {
+                value: `#4A9EFF`,
+                description: `Box fill color`,
+            },
+            opacity: {
+                value: 0.6,
+                description: `Box fill opacity`,
+                minimum: 0,
+                maximum: 1,
+            },
+            stroke_width: {
+                value: 0.5,
+                description: `Box outline width`,
+                minimum: 0,
+                maximum: 5,
+            },
+            stroke_color: {
+                value: `#000000`,
+                description: `Box outline color`,
+            },
+            border_radius: {
+                value: 0,
+                description: `Corner radius for boxes (px)`,
+                minimum: 0,
+                maximum: 10,
+            },
+        },
+        whisker: {
+            width: {
+                value: 1,
+                description: `Whisker line width`,
+                minimum: 0.5,
+                maximum: 5,
+            },
+            color: {
+                value: `#000000`,
+                description: `Whisker line color`,
+            },
+            cap_fraction: {
+                value: 0.3,
+                description: `Whisker cap width as a fraction of the box width`,
+                minimum: 0,
+                maximum: 1,
+            },
+        },
+        median: {
+            width: {
+                value: 1.5,
+                description: `Median line width`,
+                minimum: 0.5,
+                maximum: 6,
+            },
+            color: {
+                value: `#000000`,
+                description: `Median line color`,
+            },
+        },
+        outlier: {
+            radius: {
+                value: 2.5,
+                description: `Outlier point radius (px)`,
+                minimum: 0.5,
+                maximum: 10,
+            },
+            opacity: {
+                value: 0.6,
+                description: `Outlier point opacity`,
+                minimum: 0,
+                maximum: 1,
+            },
+            stroke_width: {
+                value: 0,
+                description: `Outlier point stroke width`,
+                minimum: 0,
+                maximum: 3,
+            },
+        },
+        violin: {
+            opacity: {
+                value: 0.5,
+                description: `Violin fill opacity`,
+                minimum: 0,
+                maximum: 1,
+            },
+            stroke_width: {
+                value: 1,
+                description: `Violin outline width`,
+                minimum: 0,
+                maximum: 5,
+            },
+        },
+        display: DISPLAY_CONFIG,
+    },
+    // Sankey diagram specific
+    sankey: {
+        orientation: {
+            value: `horizontal`,
+            description: `Flow direction of the Sankey diagram`,
+            enum: { horizontal: `Horizontal`, vertical: `Vertical` },
+        },
+        node_align: {
+            value: `justify`,
+            description: `How nodes are aligned across columns (maps to d3-sankey alignment)`,
+            enum: { justify: `Justify`, left: `Left`, right: `Right`, center: `Center` },
+        },
+        node_width: {
+            value: 24,
+            description: `Node thickness in pixels`,
+            minimum: 4,
+            maximum: 60,
+        },
+        node_padding: {
+            value: 12,
+            description: `Vertical gap in pixels between nodes sharing a column`,
+            minimum: 0,
+            maximum: 40,
+        },
+        link_opacity: {
+            value: 0.5,
+            description: `Opacity of link ribbons`,
+            minimum: 0.05,
+            maximum: 1,
+        },
+        show_node_labels: {
+            value: true,
+            description: `Show node labels next to each node`,
+        },
+        iterations: {
+            value: 6,
+            description: `Number of d3-sankey relaxation iterations for node positioning`,
+            minimum: 0,
+            maximum: 64,
+        },
+    },
+    // Sunburst chart specific
+    sunburst: {
+        shape: {
+            value: `sunburst`,
+            description: `Chart geometry: polar rings (sunburst) or stacked rows (icicle)`,
+            enum: { sunburst: `Sunburst`, icicle: `Icicle` },
+        },
+        value_mode: {
+            value: `leaf-sum`,
+            description: `How node values are interpreted (plotly branchvalues semantics): leaf-sum ignores parent values, total treats every value as authoritative, remainder adds a node's own value on top of its children`,
+            enum: { 'leaf-sum': `Leaf sum`, total: `Total`, remainder: `Remainder` },
+        },
+        max_depth: {
+            value: 0,
+            description: `Number of rings shown below the current zoom root (0 = all)`,
+            minimum: 0,
+            maximum: 10,
+        },
+        inner_radius: {
+            value: 0.25,
+            description: `Center hole size as fraction of the outer radius`,
+            minimum: 0,
+            maximum: 0.8,
+        },
+        pad_angle: {
+            value: 0.1,
+            description: `Angular gap in degrees between sibling arcs`,
+            minimum: 0,
+            maximum: 4,
+        },
+        min_fraction: {
+            value: 0,
+            description: `Group sibling arcs smaller than this fraction of the total into one 'Other' slice per parent (0 = off)`,
+            minimum: 0,
+            maximum: 0.2,
+        },
+        show_labels: {
+            value: true,
+            description: `Show labels on arcs large enough to fit them`,
+        },
+        label_rotation: {
+            value: `auto`,
+            description: `Arc label orientation (auto picks radial/tangential per arc)`,
+            enum: {
+                auto: `Auto`,
+                radial: `Radial`,
+                tangential: `Tangential`,
+                horizontal: `Horizontal`,
+            },
+        },
+        label_text: {
+            value: `label`,
+            description: `What arc labels display (percent is of the root total)`,
+            enum: {
+                label: `Label`,
+                value: `Value`,
+                percent: `Percent`,
+                'label+value': `Label + value`,
+                'label+percent': `Label + percent`,
+            },
+        },
+        zoom_on_click: {
+            value: true,
+            description: `Clicking a branch arc zooms into that subtree (center circle zooms out)`,
+        },
+        show_breadcrumbs: {
+            value: true,
+            description: `Show a clickable trail of ancestors when zoomed into a subtree`,
+        },
+    },
     // Composition specific
     composition: {
         display_mode: {
@@ -1121,6 +1379,7 @@ export const DEFAULTS = extract_values(SETTINGS_CONFIG);
 export const merge = (user) => ({
     ...DEFAULTS,
     ...user,
+    symmetry: merge_nested(DEFAULTS.symmetry, user?.symmetry),
     structure: merge_nested(DEFAULTS.structure, user?.structure),
     trajectory: merge_nested(DEFAULTS.trajectory, user?.trajectory),
     composition: merge_nested(DEFAULTS.composition, user?.composition),
@@ -1128,5 +1387,8 @@ export const merge = (user) => ({
     scatter: merge_nested(DEFAULTS.scatter, user?.scatter),
     histogram: merge_nested(DEFAULTS.histogram, user?.histogram),
     bar: merge_nested(DEFAULTS.bar, user?.bar),
+    box: merge_nested(DEFAULTS.box, user?.box),
+    sankey: merge_nested(DEFAULTS.sankey, user?.sankey),
+    sunburst: merge_nested(DEFAULTS.sunburst, user?.sunburst),
     convex_hull: merge_nested(DEFAULTS.convex_hull, user?.convex_hull),
 });

package/dist/spectral/Bands.svelte

@@ -5,8 +5,8 @@
   import { sanitize_html } from '../sanitize'
   import { SettingsSection } from '../layout'
   import type { Vec2 } from '../math'
-  import ScatterPlot from '../plot/ScatterPlot.svelte'
-  import type { AxisConfig, DataSeries, FillRegion } from '../plot/types'
+  import ScatterPlot from '../plot/scatter/ScatterPlot.svelte'
+  import type { AxisConfig, DataSeries, FillRegion } from '../plot/core/types'
   import * as helpers from './helpers'
   import type {
     BandsSpinMode,
@@ -32,6 +32,7 @@
     y_axis = $bindable({}),
     x_positions = $bindable(),
     reference_frequency = null,
+    highlighted_qpoint_index = null,
     ribbon_config = {},
     fermi_level = undefined,
     units = $bindable(`THz`),
@@ -45,8 +46,6 @@
     show_spin_control = true,
     show_annotation_controls = true,
     id = undefined,
-    class: class_name = undefined,
-    style = undefined,
     'data-testid': data_testid = undefined,
     ...rest
   }: ComponentProps<typeof ScatterPlot> & {
@@ -59,6 +58,8 @@
     show_legend?: boolean
     x_positions?: Record<string, [number, number]>
     reference_frequency?: number | null
+    // Q-point index to highlight with a vertical line (synced from BZ k-path hover)
+    highlighted_qpoint_index?: number | null
     ribbon_config?: RibbonConfig | Record<string, RibbonConfig>
     fermi_level?: number // Fermi level for electronic bands (auto-detected if not provided)
     units?: FrequencyUnit // Phonon frequency display units (electronic always eV)
@@ -78,8 +79,6 @@
     show_spin_control?: boolean
     show_annotation_controls?: boolean
     id?: string
-    class?: string
-    style?: string
     'data-testid'?: string
   } = $props()
 
@@ -258,7 +257,8 @@
     const attrs: Record<string, Dom_attr_value> = {}
     for (const [attr_name, attr_value] of Object.entries(rest)) {
       if (
-        (attr_name === `role` || attr_name.startsWith(`aria-`)) &&
+        (attr_name === `class` || attr_name === `style` || attr_name === `role` ||
+          attr_name.startsWith(`aria-`)) &&
         is_dom_attr_value(attr_value)
       ) {
         attrs[attr_name] = attr_value
@@ -590,9 +590,9 @@
     const display_values = detected_band_type === `phonon`
       ? convert_band_values(all_freqs)
       : all_freqs
-    if (!display_values.length) return undefined
+    if (display_values.length === 0) return undefined
     const finite = display_values.filter(Number.isFinite)
-    if (!finite.length) return undefined
+    if (finite.length === 0) return undefined
     let min_val = Math.min(...finite), max_val = Math.max(...finite)
     if (
       // clamp phonon min to 0 if negatives are noise
@@ -617,22 +617,12 @@
   // 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(() => {
-    const range = internal_y_axis.range
-    if (helpers.is_valid_range(range)) {
-      if (y_axis.range?.[0] !== range[0] || y_axis.range?.[1] !== range[1]) {
-        y_axis = { ...y_axis, range }
-      }
-      return
-    }
-    // Range became invalid - clear parent's range to propagate reset
-    if (`range` in y_axis) {
-      const { range: _omit, ...axis_without_range } = y_axis
-      y_axis = axis_without_range
-    }
+    const next = helpers.sync_axis_range(y_axis, internal_y_axis.range)
+    if (next !== y_axis) y_axis = next
   })
 
   let has_series = $derived(series_data.length > 0)
-  let is_strict_path_error = $derived(path_mode === `strict` && !!strict_path_error)
+  let is_strict_path_error = $derived(path_mode === `strict` && Boolean(strict_path_error))
 
   let imaginary_mode_region = $derived.by((): FillRegion[] => {
     if (
@@ -685,7 +675,7 @@
     )
     const occupied = all_energies.filter((energy) => energy <= effective_fermi_level)
     const unoccupied = all_energies.filter((energy) => energy > effective_fermi_level)
-    if (!occupied.length || !unoccupied.length) return null
+    if (occupied.length === 0 || unoccupied.length === 0) return null
     const vbm = Math.max(...occupied)
     const cbm = Math.min(...unoccupied)
     const gap = cbm - vbm
@@ -693,7 +683,7 @@
     return { vbm, cbm, gap }
   })
 
-  let empty_state_message = $derived.by(() => {
+  let empty_state_msg = $derived.by(() => {
     if (is_strict_path_error) {
       return strict_path_error ?? `Path mismatch in strict mode.`
     }
@@ -706,13 +696,18 @@
     return `No valid band structure data to display.`
   })
 
+  // X-position of the externally hovered q-point (from BZ k-path), for the highlight line
+  let highlight_x = $derived.by(() => {
+    if (highlighted_qpoint_index == null) return null
+    const bs = Object.values(band_structs_dict)[0]
+    return bs ? helpers.qpoint_x_position(bs, highlighted_qpoint_index, x_positions ?? {}) : null
+  })
+
   let display = $state({ x_grid: false, y_grid: true, y_zero_line: true })
 </script>
 {#if has_series && !is_strict_path_error}
   <ScatterPlot
     {id}
-    class={class_name}
-    {style}
     data-testid={data_testid}
     series={series_data}
     {fill_regions}
@@ -900,6 +895,23 @@
         />
       {/each}
 
+      <!-- Hovered q-point vertical line (synced from Brillouin zone k-path hover) -->
+      {#if highlight_x != null}
+        {@const hover_x = x_scale_fn(highlight_x)}
+        {#if Number.isFinite(hover_x)}
+          <line
+            x1={hover_x}
+            x2={hover_x}
+            y1={pad.t}
+            y2={height - pad.b}
+            stroke="var(--bands-hover-line-color, #ff6b35)"
+            stroke-width="var(--bands-hover-line-width, 2)"
+            opacity="var(--bands-hover-line-opacity, 0.85)"
+            pointer-events="none"
+          />
+        {/if}
+      {/if}
+
       <!-- Shared geometry for Fermi level and gap annotations -->
       {@const fermi_y = effective_fermi_level !== undefined
       ? y_scale_fn(effective_fermi_level)
@@ -1007,11 +1019,9 @@
 {:else}
   <EmptyState
     {id}
-    class={class_name}
-    {style}
     data-testid={data_testid}
     {...empty_state_attrs}
-    message={empty_state_message}
+    message={empty_state_msg}
   />
 {/if}
 

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

@@ -1,5 +1,5 @@
-import ScatterPlot from '../plot/ScatterPlot.svelte';
-import type { AxisConfig } from '../plot/types';
+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';
 import type { ComponentProps } from 'svelte';
 type $$ComponentProps = ComponentProps<typeof ScatterPlot> & {
@@ -12,6 +12,7 @@ type $$ComponentProps = ComponentProps<typeof ScatterPlot> & {
     show_legend?: boolean;
     x_positions?: Record<string, [number, number]>;
     reference_frequency?: number | null;
+    highlighted_qpoint_index?: number | null;
     ribbon_config?: RibbonConfig | Record<string, RibbonConfig>;
     fermi_level?: number;
     units?: FrequencyUnit;
@@ -31,8 +32,6 @@ type $$ComponentProps = ComponentProps<typeof ScatterPlot> & {
     show_spin_control?: boolean;
     show_annotation_controls?: boolean;
     id?: string;
-    class?: string;
-    style?: string;
     'data-testid'?: string;
 };
 declare const Bands: import("svelte").Component<$$ComponentProps, {}, "y_axis" | "units" | "x_positions" | "band_spin_mode">;

package/dist/spectral/BandsAndDos.svelte

@@ -1,6 +1,6 @@
 <script lang="ts">
   import type { Vec2 } from '../math'
-  import type { AxisConfig } from '../plot/types'
+  import type { AxisConfig } from '../plot/core/types'
   import type { ComponentProps, Snippet } from 'svelte'
   import { untrack } from 'svelte'
   import type { HTMLAttributes } from 'svelte/elements'

package/dist/spectral/BrillouinBandsDos.svelte

@@ -2,7 +2,7 @@
   import { BrillouinZone, reciprocal_lattice } from '../brillouin'
   import type { Vec2, Vec3 } from '../math'
   import type { InternalPoint, ScatterHandlerEvent } from '../plot'
-  import type { AxisConfig } from '../plot/types'
+  import type { AxisConfig } from '../plot/core/types'
   import type { Crystal } from '../structure'
   import type { ComponentProps, Snippet } from 'svelte'
   import { untrack } from 'svelte'
@@ -84,9 +84,13 @@
       )
       : null,
   )
+  // Q-point hovered directly on the BZ k-path (reverse direction: BZ -> bands/DOS)
+  let bz_hovered_qpoint_index = $state<number | null>(null)
+  // 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(
-    hovered_qpoint_index !== null
-      ? (k_path_points[hovered_qpoint_index] as Vec3)
+    active_qpoint_index !== null
+      ? (k_path_points[active_qpoint_index] as Vec3)
       : null,
   )
   const [desktop_width, tablet_width] = [1200, 600]
@@ -132,32 +136,34 @@
     if (result !== undefined) synced_zoom_range = result
   })
 
-  // Propagate synced range to bands y-axis (untrack current to avoid overwriting child zoom)
-  $effect(() => {
+  // Compute the y-axis a plot should adopt when propagating the synced range, or
+  // undefined to leave it untouched. A valid child range is either already at base
+  // or a live zoom we must not clobber, so we only push base when the child has
+  // reset to auto-range (invalid). base_range is read unconditionally to keep the
+  // effect subscribed to synced_zoom_range/shared_frequency_range; current_range is
+  // read via untrack() at the call site to avoid overwriting child zoom.
+  const propagate_synced_range = (
+    current_range: Vec2 | undefined,
+    make_axis: (range?: Vec2) => AxisConfig,
+  ): AxisConfig | undefined => {
     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 (helpers.ranges_equal(current_range, base_range)) return
-    if (
-      helpers.is_valid_range(current_range) &&
-      !helpers.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)
+    return helpers.is_valid_range(current_range) ? undefined : make_axis(base_range)
+  }
+
+  $effect(() => {
+    const next = propagate_synced_range(
+      untrack(() => bands_y_axis.range) as Vec2 | undefined,
+      bands_default_axis,
+    )
+    if (next) bands_y_axis = next
   })
 
-  // Propagate synced range to DOS y-axis (untrack current to avoid overwriting child zoom)
   $effect(() => {
-    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 (helpers.ranges_equal(current_range, base_range)) return
-    if (
-      helpers.is_valid_range(current_range) &&
-      !helpers.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)
+    const next = propagate_synced_range(
+      untrack(() => dos_y_axis.range) as Vec2 | undefined,
+      dos_default_axis,
+    )
+    if (next) dos_y_axis = next
   })
 
   let hovered_frequency = $state<number | null>(null)
@@ -168,7 +174,11 @@
   class="bands-dos-brillouin {screen_class} {rest.class ?? ``}"
   bind:clientWidth
 >
-  {@render children?.({ hovered_frequency, hovered_band_point, hovered_qpoint_index })}
+  {@render children?.({
+    hovered_frequency,
+    hovered_band_point,
+    hovered_qpoint_index: active_qpoint_index,
+  })}
   <Bands
     style="grid-area: bands; min-width: 0; min-height: 0; overflow: hidden"
     {band_structs}
@@ -178,6 +188,7 @@
     bind:y_axis={bands_y_axis}
     bind:x_positions={bands_x_positions}
     reference_frequency={hovered_frequency}
+    highlighted_qpoint_index={active_qpoint_index}
     on_point_hover={(event: ScatterHandlerEvent | null) => {
       hovered_band_point = event?.point ?? null
       bands_props.on_point_hover?.(event)
@@ -197,7 +208,8 @@
         : []
     ) ?? []}
     {hovered_k_point}
-    {hovered_qpoint_index}
+    hovered_qpoint_index={active_qpoint_index}
+    on_kpath_hover={(idx) => (bz_hovered_qpoint_index = idx)}
     {...bz_props}
   />
 

package/dist/spectral/Dos.svelte

@@ -2,8 +2,8 @@
   import { PLOT_COLORS } from '../colors'
   import EmptyState from '../EmptyState.svelte'
   import { SettingsSection } from '../layout'
-  import ScatterPlot from '../plot/ScatterPlot.svelte'
-  import type { AxisConfig, DataSeries } from '../plot/types'
+  import ScatterPlot from '../plot/scatter/ScatterPlot.svelte'
+  import type { AxisConfig, DataSeries } from '../plot/core/types'
   import type { ComponentProps } from 'svelte'
   import { tooltip as attach_tooltip } from 'svelte-multiselect/attachments'
   import {
@@ -16,12 +16,12 @@
     format_sigma,
     FREQUENCY_UNITS,
     IMAGINARY_MODE_NOISE_THRESHOLD,
-    is_valid_range,
     negative_fraction,
     NORMALIZATION_MODES,
     normalize_densities,
     normalize_dos,
     SPIN_MODES,
+    sync_axis_range,
     validate_sigma_range,
   } from './helpers'
   import type {
@@ -308,7 +308,7 @@
   )
 
   let x_range = $derived.by((): [number, number] | undefined => {
-    if (!series_data.length) return 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)
     // For horizontal orientation with mirror mode, allow negative values (mirrored densities)
@@ -318,7 +318,7 @@
   })
 
   let y_range = $derived.by((): [number, number] | undefined => {
-    if (!series_data.length) return 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)
     // For vertical orientation with mirror mode, allow negative values (mirrored densities)
@@ -346,7 +346,8 @@
     label: x_label,
     format: `.2f`,
     range: x_range,
-    label_shift: { x: 0, y: -48 }, // Increase standoff from tick labels
+    // Keep label standoff identical to Bands' x-axis so the side-by-side
+    // "Density of States" and "Wave Vector" labels align (ScatterPlot default y: -40)
     ...(is_horizontal && { ticks: 4 }),
     ...x_axis,
   })
@@ -361,18 +362,8 @@
   // 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(() => {
-    const range = internal_y_axis.range
-    if (is_valid_range(range)) {
-      if (y_axis.range?.[0] !== range[0] || y_axis.range?.[1] !== range[1]) {
-        y_axis = { ...y_axis, range }
-      }
-      return
-    }
-    // Range became invalid - clear parent's range to propagate reset
-    if (`range` in y_axis) {
-      const { range: _omit, ...axis_without_range } = y_axis
-      y_axis = axis_without_range
-    }
+    const next = sync_axis_range(y_axis, internal_y_axis.range)
+    if (next !== y_axis) y_axis = next
   })
 
   let display = $state({
@@ -388,7 +379,7 @@
   // Auto-detect sigma range based on frequency/energy range
   let effective_sigma_range = $derived.by((): [number, number] => {
     if (sigma_range) return sigma_range
-    if (!all_freqs.length) return [0, 1]
+    if (all_freqs.length === 0) return [0, 1]
     const freq_range = Math.max(...all_freqs) - Math.min(...all_freqs)
     // Reasonable sigma range: 0 to ~5% of total range
     const max_sigma = Math.max(0.1, freq_range * 0.05)

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

@@ -1,5 +1,5 @@
-import ScatterPlot from '../plot/ScatterPlot.svelte';
-import type { AxisConfig } from '../plot/types';
+import ScatterPlot from '../plot/scatter/ScatterPlot.svelte';
+import type { AxisConfig } from '../plot/core/types';
 import type { ComponentProps } from 'svelte';
 import type { DosInput, FrequencyUnit, NormalizationMode, PdosType, SpinMode } from './types';
 type $$ComponentProps = ComponentProps<typeof ScatterPlot> & {