matterviz 0.4.0 → 0.4.1

package/dist/convex-hull/types.d.ts

@@ -1,7 +1,6 @@
 import type { CompositionType } from '../composition';
-import type { ShowControlsProp } from '../controls';
 import type { ElementSymbol } from '../element';
-import type { Point2D, Point3D, Vec3 } from '../math';
+import type { Point2D, Point3D, Vec2, Vec3 } from '../math';
 import type { Rect, Sides } from '../plot/core/layout';
 import type { AnyStructure } from '../structure';
 export interface StructurePopupStats {
@@ -36,7 +35,17 @@ export interface PhaseData {
     data?: Record<string, unknown>;
     structure?: Record<string, unknown>;
     attributes?: Record<string, unknown>;
+    magnetic_ordering?: MagneticOrdering | (string & {});
 }
+export interface EntryCategoryConfig {
+    label: string;
+    property: string | string[];
+    markers: Record<string, MarkerSymbol>;
+    labels?: Record<string, string>;
+    aliases?: Record<string, string>;
+}
+export type MagneticOrdering = `FM` | `FiM` | `AFM` | `NM`;
+export declare const MAGNETIC_ORDERING_CATEGORY: EntryCategoryConfig;
 export interface ProcessedPhaseData {
     entries: PhaseData[];
     stable_entries: PhaseData[];
@@ -77,7 +86,6 @@ export interface ConvexHullConfig {
 }
 export interface ConvexHullControlsType {
     title?: string;
-    show?: ShowControlsProp;
     position?: `top-left` | `top-right` | `bottom-left` | `bottom-right`;
     width?: number;
     show_counts?: boolean;
@@ -145,7 +153,7 @@ export declare const DEFAULT_GAS_PRESSURES: Readonly<Record<GasSpecies, number>>
 export interface GasThermodynamicsProvider {
     get_standard_chemical_potential(gas: GasSpecies, T: number): number;
     get_supported_gases(): GasSpecies[];
-    get_temperature_range(): [number, number];
+    get_temperature_range(): Vec2;
 }
 export interface GasThermodynamicsConfig {
     enabled_gases?: GasSpecies[];

package/dist/convex-hull/types.js

@@ -1,3 +1,15 @@
+// Built-in preset for magnetic orderings (MP/pymatgen conventions) and the default
+// entry_category of all convex hull components: entries carrying magnetic_ordering
+// (or an MP-style `ordering` field) auto-render as shape-coded points with filter toggles
+export const MAGNETIC_ORDERING_CATEGORY = {
+    label: `Magnetic`,
+    property: [`magnetic_ordering`, `ordering`],
+    markers: { FM: `triangle`, FiM: `diamond`, AFM: `square`, NM: `circle` },
+    // oxfmt-ignore
+    labels: { FM: `Ferromagnetic`, FiM: `Ferrimagnetic`, AFM: `Antiferromagnetic`, NM: `Non-magnetic` },
+    // oxfmt-ignore
+    aliases: { ferromagnetic: `FM`, ferrimagnetic: `FiM`, antiferromagnetic: `AFM`, 'non-magnetic': `NM`, nonmagnetic: `NM`, diamagnetic: `NM` },
+};
 export const HULL_FACE_COLOR_MODES = [
     `uniform`,
     `formation_energy`,

package/dist/coordination/CoordinationBarPlot.svelte

@@ -1,8 +1,9 @@
 <script lang="ts">
   import { PLOT_COLORS } from '../colors'
   import { StatusMessage } from '../feedback'
-  import { create_file_drop_handler } from '../io'
+  import { create_file_drop_handler, drag_over_handlers } from '../io'
   import { format_value } from '../labels'
+  import type { Vec2 } from '../math'
   import { BarPlot } from '../plot'
   import type {
     AxisConfig,
@@ -99,7 +100,7 @@
     for (const entry of entries_with_data) {
       for (const [cn] of entry.data.cn_histogram) max_cn = Math.max(max_cn, cn)
     }
-    const cn_range: [number, number] = [-0.5, max_cn + 0.5]
+    const cn_range: Vec2 = [-0.5, max_cn + 0.5]
 
     return { count: [0, null] as [number, null], cn: cn_range } // Count axis should always start at 0
   })
@@ -297,15 +298,7 @@
     bind:display
     {tooltip}
     ondrop={handle_file_drop}
-    ondragover={(event) => {
-      event.preventDefault()
-      if (!allow_file_drop) return
-      dragover = true
-    }}
-    ondragleave={(event) => {
-      event.preventDefault()
-      dragover = false
-    }}
+    {...drag_over_handlers({ allow: () => allow_file_drop, set_dragover: (over) => dragover = over })}
     class={(rest.class ?? ``) + (dragover ? ` dragover` : ``)}
   />
 {/if}

package/dist/element/BohrAtom.svelte

@@ -115,7 +115,8 @@
               {shell_idx + 1}.{elec_idx + 1}
               <!-- {:else if [`sequential`, true].includes(number_electrons)} -->
             {:else}
-              {@const nth_electron = shells.slice(0, shell_idx).reduce((a, b) => a + b, 0) +
+              {@const nth_electron =
+          shells.slice(0, shell_idx).reduce((sum, count) => sum + count, 0) +
           elec_idx + 1}
               {nth_electron}
             {/if}

package/dist/element/ElementTile.svelte.d.ts

@@ -24,6 +24,6 @@ type $$ComponentProps = Omit<HTMLAttributes<HTMLElement>, `onclick`> & {
         event: MouseEvent;
     }) => void;
 };
-declare const ElementTile: import("svelte").Component<$$ComponentProps, {}, "node" | "text_color">;
+declare const ElementTile: import("svelte").Component<$$ComponentProps, {}, "text_color" | "node">;
 type ElementTile = ReturnType<typeof ElementTile>;
 export default ElementTile;

package/dist/element/index.d.ts

@@ -1,3 +1,4 @@
+import type { ElementSymbol } from './types';
 export type * from './types';
 export { default as BohrAtom } from './BohrAtom.svelte';
 export { default as element_data } from './data';
@@ -6,3 +7,6 @@ export { default as ElementPhoto } from './ElementPhoto.svelte';
 export { default as ElementStats } from './ElementStats.svelte';
 export { default as ElementTile } from './ElementTile.svelte';
 export { default as Nucleus } from './Nucleus.svelte';
+export declare const is_elem_symbol: (symbol: string) => symbol is ElementSymbol;
+export declare const coerce_elem_symbol: (symbol: string) => ElementSymbol | undefined;
+export declare const FALLBACK_ELEMENTS: readonly ["H", "He", "Li", "Be", "B", "C", "N", "O", "F", "Ne"];

package/dist/element/index.js

@@ -1,3 +1,4 @@
+import { ELEM_SYMBOLS } from '../labels';
 export { default as BohrAtom } from './BohrAtom.svelte';
 export { default as element_data } from './data';
 export { default as ElementHeading } from './ElementHeading.svelte';
@@ -5,3 +6,20 @@ export { default as ElementPhoto } from './ElementPhoto.svelte';
 export { default as ElementStats } from './ElementStats.svelte';
 export { default as ElementTile } from './ElementTile.svelte';
 export { default as Nucleus } from './Nucleus.svelte';
+// Set-backed O(1) element-symbol guard shared by all parsers
+const ELEM_SYMBOL_SET = new Set(ELEM_SYMBOLS);
+export const is_elem_symbol = (symbol) => ELEM_SYMBOL_SET.has(symbol);
+export const coerce_elem_symbol = (symbol) => is_elem_symbol(symbol) ? symbol : undefined;
+// Default element symbols used when a file omits or mangles element info
+export const FALLBACK_ELEMENTS = [
+    `H`,
+    `He`,
+    `Li`,
+    `Be`,
+    `B`,
+    `C`,
+    `N`,
+    `O`,
+    `F`,
+    `Ne`,
+];

package/dist/feedback/DragOverlay.svelte

@@ -4,14 +4,16 @@
   let {
     visible = false,
     message = `Drop JSON file to load phase diagram data`,
+    style = undefined,
   }: {
     visible?: boolean
     message?: string
+    style?: string
   } = $props()
 </script>
 
 {#if visible}
-  <div class="drag-overlay">
+  <div class="drag-overlay" {style}>
     <div class="drag-message">
       <Icon icon="Info" />
       <span>{message}</span>

package/dist/feedback/DragOverlay.svelte.d.ts

@@ -1,6 +1,7 @@
 type $$ComponentProps = {
     visible?: boolean;
     message?: string;
+    style?: string;
 };
 declare const DragOverlay: import("svelte").Component<$$ComponentProps, {}, "">;
 type DragOverlay = ReturnType<typeof DragOverlay>;

package/dist/feedback/StatusMessage.svelte

@@ -26,7 +26,11 @@
 
 <style>
   .status-message {
+    display: flex;
+    align-items: center;
+    gap: 1em;
     border-radius: var(--border-radius, 3pt);
+    backdrop-filter: blur(8px);
     &.info {
       border: 2px dashed var(--text-color-muted, #ccc);
       background: transparent;
@@ -47,11 +51,17 @@
     }
   }
   button {
-    margin-left: 1em;
-    padding: 0.2em 0.5em;
+    flex: none;
+    display: grid;
+    place-items: center;
+    margin-left: auto;
+    box-sizing: border-box;
+    width: 1.6em;
+    height: 1.6em;
+    padding: 0;
     background: var(--btn-bg, #ddd);
     border: 1px solid var(--border-color, #bbb);
-    border-radius: var(--border-radius, 3pt);
+    border-radius: 50%;
     cursor: pointer;
     &:hover {
       background: var(--btn-bg-hover, #ccc);

package/dist/fermi-surface/FermiSurface.svelte

@@ -1,14 +1,13 @@
 <script lang="ts">
   import type { BrillouinZoneData } from '../brillouin'
   import { compute_brillouin_zone, reciprocal_lattice } from '../brillouin'
-  import type { ShowControlsProp } from '../controls'
-  import { normalize_show_controls } from '../controls'
+  import { normalize_show_controls, type ShowControlsProp } from '../controls'
   import EmptyState from '../EmptyState.svelte'
   import { StatusMessage } from '../feedback'
   import Spinner from '../feedback/Spinner.svelte'
-  import Icon from '../Icon.svelte'
-  import { create_file_drop_handler, load_from_url } from '../io'
-  import { set_fullscreen_bg, toggle_fullscreen } from '../layout'
+  import { create_file_drop_handler, drag_over_handlers, load_from_url } from '../io'
+  import { type FullscreenToggleProp, toggle_fullscreen, ViewerChrome } from '../layout'
+  import { sync_fullscreen } from '../layout/fullscreen.svelte'
   import { PlotTooltip } from '../plot'
   import type { CameraProjection } from '../settings'
   import { DEFAULTS } from '../settings'
@@ -16,7 +15,6 @@
   import { Canvas } from '@threlte/core'
   import type { ComponentProps, Snippet } from 'svelte'
   import { untrack } from 'svelte'
-  import { tooltip } from 'svelte-multiselect/attachments'
   import type { HTMLAttributes } from 'svelte/elements'
   import type { Camera, Scene } from 'three'
   import { detect_irreducible_bz, extract_fermi_surface } from './compute'
@@ -91,6 +89,7 @@
     on_error,
     on_fullscreen_change,
     on_mu_change,
+    on_point_hover,
     on_hover,
     ...rest
   }: {
@@ -117,15 +116,13 @@
     clip_flip?: boolean
     interpolation_factor?: number
     camera_projection?: CameraProjection
-    /**
-     * Controls visibility configuration.
-     * - 'always': controls always visible
-     * - 'hover': controls visible on component hover (default)
-     * - 'never': controls never visible
-     * - object: { mode, hidden, style } for fine-grained control
-     *
-     * Control names: 'filename', 'fullscreen', 'controls'
-     */
+    // Controls visibility configuration.
+    // - 'always': controls always visible
+    // - 'hover': controls visible on component hover (default)
+    // - 'never': controls never visible
+    // - object: { mode, hidden, style } for fine-grained control
+    //
+    // Control names: 'filename', 'fullscreen', 'controls'
     show_controls?: ShowControlsProp
     fullscreen?: boolean
     width?: number
@@ -134,7 +131,7 @@
     hovered?: boolean
     dragover?: boolean
     allow_file_drop?: boolean
-    fullscreen_toggle?: Snippet<[{ fullscreen: boolean }]> | boolean
+    fullscreen_toggle?: FullscreenToggleProp
     data_url?: string
     spinner_props?: ComponentProps<typeof Spinner>
     loading?: boolean
@@ -148,6 +145,8 @@
     on_fullscreen_change?: (data: FermiHandlerData) => void
     on_mu_change?: (mu: number) => void
     tooltip_config?: Snippet<[{ hover_data: FermiHoverData }]> | FermiTooltipConfig
+    on_point_hover?: (data: FermiHoverData | null) => void
+    // Deprecated alias for on_point_hover (honored when on_point_hover is unset)
     on_hover?: (data: FermiHoverData | null) => void
   } & HTMLAttributes<HTMLDivElement> = $props()
 
@@ -157,9 +156,16 @@
   let recompute_job_id = 0 // monotonic counter to track latest recompute call
   let hover_data = $state<FermiHoverData | null>(null)
 
-  // Call on_hover callback when hover_data changes
+  // Call on_point_hover callback when hover_data changes (on_hover is a deprecated alias)
+  let warned_deprecated_on_hover = false
   $effect(() => {
-    on_hover?.(hover_data)
+    if (on_hover && !on_point_hover && !warned_deprecated_on_hover) {
+      warned_deprecated_on_hover = true
+      console.warn(
+        `FermiSurface: the on_hover prop was renamed to on_point_hover; the alias will be removed in a future release`,
+      )
+    }
+    ;(on_point_hover ?? on_hover)?.(hover_data)
   })
 
   let controls_config = $derived(normalize_show_controls(show_controls))
@@ -179,8 +185,8 @@
       ? new TextDecoder().decode(content)
       : content
 
+    // parse_fermi_file throws a descriptive error when parsing fails
     const parsed = parse_fermi_file(text, filename)
-    if (!parsed) throw new Error(`Failed to parse Fermi surface from ${filename}`)
 
     const file_size = new Blob([content]).size
     current_filename = filename
@@ -349,28 +355,19 @@
     else if (event.key === `Escape`) controls_open = false
   }
 
-  $effect(() => {
-    if (typeof window === `undefined`) return
-    const fs_el = document.fullscreenElement
-    if (fullscreen && fs_el !== wrapper && wrapper) {
-      wrapper.requestFullscreen().catch((err) => {
-        console.error(err)
-        fullscreen = false
-      })
-    } else if (!fullscreen && fs_el === wrapper) document.exitFullscreen()
-    set_fullscreen_bg(wrapper, fullscreen, `--fermi-bg-fullscreen`)
+  sync_fullscreen({
+    get_wrapper: () => wrapper,
+    get_fullscreen: () => fullscreen,
+    set_fullscreen: (val) => (fullscreen = val),
+    bg_css_var: `--fermi-bg-fullscreen`,
+    on_request_error: () => (fullscreen = false),
+    on_change: (val) =>
+      on_fullscreen_change?.({ fermi_data, bz_data, fullscreen: val }),
   })
 </script>
 
 <svelte:window onkeydown={handle_keydown} />
 
-<svelte:document
-  onfullscreenchange={() => {
-    fullscreen = Boolean(document.fullscreenElement)
-    on_fullscreen_change?.({ fermi_data, bz_data, fullscreen })
-  }}
-/>
-
 <div
   class:dragover
   class:active={controls_open}
@@ -382,15 +379,7 @@
   onmouseenter={() => (hovered = true)}
   onmouseleave={() => (hovered = false)}
   ondrop={handle_file_drop}
-  ondragover={(event) => {
-    event.preventDefault()
-    if (!allow_file_drop) return
-    dragover = true
-  }}
-  ondragleave={(event) => {
-    event.preventDefault()
-    dragover = false
-  }}
+  {...drag_over_handlers({ allow: () => allow_file_drop, set_dragover: (over) => dragover = over })}
   {...rest}
   class="fermi-surface {rest.class ?? ``}"
 >
@@ -409,61 +398,41 @@
       style="position: absolute; top: 50%; left: 50%; transform: translate(-50%, -50%); max-width: 90%; text-align: center"
     />
   {:else if fermi_data || band_data}
-    <section
-      class="control-buttons {controls_config.class}"
-      style={controls_config.style}
+    <ViewerChrome
+      {controls_config}
+      filename={current_filename}
+      {fullscreen}
+      {fullscreen_toggle}
+      {wrapper}
     >
-      {#if controls_config.mode !== `never`}
-        {#if current_filename && controls_config.visible(`filename`)}
-          <span class="filename">{current_filename}</span>
-        {/if}
-
-        {#if fullscreen_toggle && controls_config.visible(`fullscreen`)}
-          <button
-            type="button"
-            onclick={() => fullscreen_toggle && toggle_fullscreen(wrapper)}
-            title="{fullscreen ? `Exit` : `Enter`} fullscreen"
-            aria-pressed={fullscreen}
-            class="fullscreen-toggle"
-            {@attach tooltip()}
-          >
-            {#if typeof fullscreen_toggle === `function`}
-              {@render fullscreen_toggle({ fullscreen })}
-            {:else}
-              <Icon icon="{fullscreen ? `Exit` : ``}Fullscreen" />
-            {/if}
-          </button>
-        {/if}
-
-        {#if controls_config.visible(`controls`)}
-          <FermiSurfaceControls
-            bind:controls_open
-            {fermi_data}
-            {band_data}
-            bind:mu
-            bind:color_property
-            bind:color_scale
-            {custom_property_label}
-            bind:representation
-            bind:surface_opacity
-            bind:selected_bands
-            bind:show_bz
-            bind:bz_opacity
-            bind:show_vectors
-            bind:tile_bz
-            bind:clip_enabled
-            bind:clip_axis
-            bind:clip_position
-            bind:clip_flip
-            bind:interpolation_factor
-            bind:camera_projection
-            on_mu_change={handle_mu_change}
-            on_interpolation_change={handle_interpolation_change}
-            on_export={handle_export}
-          />
-        {/if}
+      {#if controls_config.visible(`controls`)}
+        <FermiSurfaceControls
+          bind:controls_open
+          {fermi_data}
+          {band_data}
+          bind:mu
+          bind:color_property
+          bind:color_scale
+          {custom_property_label}
+          bind:representation
+          bind:surface_opacity
+          bind:selected_bands
+          bind:show_bz
+          bind:bz_opacity
+          bind:show_vectors
+          bind:tile_bz
+          bind:clip_enabled
+          bind:clip_axis
+          bind:clip_position
+          bind:clip_flip
+          bind:interpolation_factor
+          bind:camera_projection
+          on_mu_change={handle_mu_change}
+          on_interpolation_change={handle_interpolation_change}
+          on_export={handle_export}
+        />
       {/if}
-    </section>
+    </ViewerChrome>
 
     {#if typeof WebGLRenderingContext !== `undefined`}
       <Canvas renderMode="on-demand" dpr={Math.min(2, window.devicePixelRatio)}>
@@ -555,52 +524,4 @@
   .fermi-surface :global(canvas) {
     user-select: none;
   }
-  section.control-buttons {
-    position: absolute;
-    display: flex;
-    top: var(--fermi-buttons-top, var(--ctrl-btn-top, 1ex));
-    right: var(--fermi-buttons-right, var(--ctrl-btn-right, 1ex));
-    gap: clamp(6pt, 1cqmin, 9pt);
-    z-index: var(
-      --fermi-buttons-z-index,
-      var(--z-index-overlay-controls, 100000000)
-    );
-    opacity: 0;
-    pointer-events: none;
-    transition: opacity 0.2s ease;
-    align-items: center;
-  }
-  /* Mode: always - controls always visible */
-  section.control-buttons.always-visible {
-    opacity: 1;
-    pointer-events: auto;
-  }
-  /* Mode: hover - controls visible on component hover */
-  .fermi-surface:hover section.control-buttons.hover-visible,
-  .fermi-surface:focus-within section.control-buttons.hover-visible {
-    opacity: 1;
-    pointer-events: auto;
-  }
-  /* Mode: never - stays hidden (default state, no additional CSS needed) */
-  section.control-buttons > :global(button) {
-    background-color: transparent;
-    display: flex;
-    padding: 4px;
-    border-radius: var(--border-radius, 3pt);
-    font-size: clamp(0.85em, 2cqmin, 1.3em);
-  }
-  section.control-buttons :global(button:hover) {
-    background-color: color-mix(in srgb, currentColor 8%, transparent);
-  }
-  .filename {
-    font-family: monospace;
-    font-size: 0.9em;
-    background: var(--code-bg, rgba(0, 0, 0, 0.1));
-    padding: 3pt 6pt;
-    border-radius: 3pt;
-    max-width: 200px;
-    overflow: hidden;
-    text-overflow: ellipsis;
-    white-space: nowrap;
-  }
 </style>

package/dist/fermi-surface/FermiSurface.svelte.d.ts

@@ -1,6 +1,7 @@
 import type { BrillouinZoneData } from '../brillouin';
-import type { ShowControlsProp } from '../controls';
+import { type ShowControlsProp } from '../controls';
 import Spinner from '../feedback/Spinner.svelte';
+import { type FullscreenToggleProp } from '../layout';
 import type { CameraProjection } from '../settings';
 import type { Crystal } from '../structure';
 import type { ComponentProps, Snippet } from 'svelte';
@@ -38,15 +39,6 @@ type $$ComponentProps = {
     clip_flip?: boolean;
     interpolation_factor?: number;
     camera_projection?: CameraProjection;
-    /**
-     * Controls visibility configuration.
-     * - 'always': controls always visible
-     * - 'hover': controls visible on component hover (default)
-     * - 'never': controls never visible
-     * - object: { mode, hidden, style } for fine-grained control
-     *
-     * Control names: 'filename', 'fullscreen', 'controls'
-     */
     show_controls?: ShowControlsProp;
     fullscreen?: boolean;
     width?: number;
@@ -55,9 +47,7 @@ type $$ComponentProps = {
     hovered?: boolean;
     dragover?: boolean;
     allow_file_drop?: boolean;
-    fullscreen_toggle?: Snippet<[{
-        fullscreen: boolean;
-    }]> | boolean;
+    fullscreen_toggle?: FullscreenToggleProp;
     data_url?: string;
     spinner_props?: ComponentProps<typeof Spinner>;
     loading?: boolean;
@@ -76,8 +66,9 @@ type $$ComponentProps = {
     tooltip_config?: Snippet<[{
         hover_data: FermiHoverData;
     }]> | FermiTooltipConfig;
+    on_point_hover?: (data: FermiHoverData | null) => void;
     on_hover?: (data: FermiHoverData | null) => void;
 } & HTMLAttributes<HTMLDivElement>;
-declare const FermiSurface: import("svelte").Component<$$ComponentProps, {}, "dragover" | "height" | "width" | "fullscreen" | "hovered" | "controls_open" | "loading" | "camera_projection" | "color_scale" | "wrapper" | "error_msg" | "surface_opacity" | "show_vectors" | "bz_data" | "mu" | "selected_bands" | "interpolation_factor" | "fermi_data" | "band_data" | "color_property" | "representation" | "show_bz" | "bz_opacity" | "tile_bz" | "clip_enabled" | "clip_axis" | "clip_position" | "clip_flip">;
+declare const FermiSurface: import("svelte").Component<$$ComponentProps, {}, "height" | "width" | "dragover" | "fullscreen" | "wrapper" | "hovered" | "controls_open" | "color_scale" | "loading" | "camera_projection" | "error_msg" | "surface_opacity" | "show_vectors" | "bz_data" | "mu" | "selected_bands" | "interpolation_factor" | "fermi_data" | "band_data" | "color_property" | "representation" | "show_bz" | "bz_opacity" | "tile_bz" | "clip_enabled" | "clip_axis" | "clip_position" | "clip_flip">;
 type FermiSurface = ReturnType<typeof FermiSurface>;
 export default FermiSurface;

package/dist/fermi-surface/FermiSurfaceControls.svelte.d.ts

@@ -30,6 +30,6 @@ type $$ComponentProps = {
         band_data?: BandGridData;
     }]>;
 };
-declare const FermiSurfaceControls: import("svelte").Component<$$ComponentProps, {}, "controls_open" | "camera_projection" | "color_scale" | "surface_opacity" | "show_vectors" | "mu" | "selected_bands" | "interpolation_factor" | "color_property" | "representation" | "show_bz" | "bz_opacity" | "tile_bz" | "clip_enabled" | "clip_axis" | "clip_position" | "clip_flip">;
+declare const FermiSurfaceControls: import("svelte").Component<$$ComponentProps, {}, "controls_open" | "color_scale" | "camera_projection" | "surface_opacity" | "show_vectors" | "mu" | "selected_bands" | "interpolation_factor" | "color_property" | "representation" | "show_bz" | "bz_opacity" | "tile_bz" | "clip_enabled" | "clip_axis" | "clip_position" | "clip_flip">;
 type FermiSurfaceControls = ReturnType<typeof FermiSurfaceControls>;
 export default FermiSurfaceControls;