matterviz 0.4.1 → 0.4.3

package/dist/element/helpers.d.ts

@@ -0,0 +1,4 @@
+import type { ElementSymbol } from './types';
+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/helpers.js

@@ -0,0 +1,18 @@
+import { ELEM_SYMBOLS } from '../labels';
+// 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/element/index.d.ts

@@ -1,12 +1,9 @@
-import type { ElementSymbol } from './types';
 export type * from './types';
 export { default as BohrAtom } from './BohrAtom.svelte';
-export { default as element_data } from './data';
+export { default as element_data, element_by_symbol } from './data';
 export { default as ElementHeading } from './ElementHeading.svelte';
 export { default as ElementPhoto } from './ElementPhoto.svelte';
 export { default as ElementStats } from './ElementStats.svelte';
 export { default as ElementTile } from './ElementTile.svelte';
+export * from './helpers';
 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,25 +1,10 @@
-import { ELEM_SYMBOLS } from '../labels';
 export { default as BohrAtom } from './BohrAtom.svelte';
-export { default as element_data } from './data';
+export { default as element_data, element_by_symbol } from './data';
 export { default as ElementHeading } from './ElementHeading.svelte';
 export { default as ElementPhoto } from './ElementPhoto.svelte';
 export { default as ElementStats } from './ElementStats.svelte';
 export { default as ElementTile } from './ElementTile.svelte';
+// Pure helpers live in ./helpers (no Svelte imports) so parser modules can use
+// them inside Web Workers; re-exported here for everyone else.
+export * from './helpers';
 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

@@ -1,19 +1,19 @@
 <script lang="ts">
   import Icon from '../Icon.svelte'
+  import type { HTMLAttributes } from 'svelte/elements'
 
   let {
     visible = false,
-    message = `Drop JSON file to load phase diagram data`,
-    style = undefined,
+    message = `Drop file to load`,
+    ...rest
   }: {
     visible?: boolean
     message?: string
-    style?: string
-  } = $props()
+  } & HTMLAttributes<HTMLDivElement> = $props()
 </script>
 
 {#if visible}
-  <div class="drag-overlay" {style}>
+  <div {...rest} class={[`drag-overlay`, rest.class]}>
     <div class="drag-message">
       <Icon icon="Info" />
       <span>{message}</span>

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

@@ -1,8 +1,8 @@
+import type { HTMLAttributes } from 'svelte/elements';
 type $$ComponentProps = {
     visible?: boolean;
     message?: string;
-    style?: string;
-};
+} & HTMLAttributes<HTMLDivElement>;
 declare const DragOverlay: import("svelte").Component<$$ComponentProps, {}, "">;
 type DragOverlay = ReturnType<typeof DragOverlay>;
 export default DragOverlay;

package/dist/feedback/StatusMessage.svelte

@@ -1,7 +1,12 @@
 <script lang="ts">
   import type { HTMLAttributes } from 'svelte/elements'
 
-  let { message = $bindable(), type = `info`, dismissible = false, ...rest }: {
+  let {
+    message = $bindable(),
+    type = `info`,
+    dismissible = false,
+    ...rest
+  }: {
     message?: string
     type?: `info` | `error` | `warning`
     dismissible?: boolean
@@ -17,9 +22,7 @@
   >
     {message}
     {#if dismissible}
-      <button onclick={() => (message = undefined)} aria-label="Dismiss message">
-        ✕
-      </button>
+      <button onclick={() => (message = undefined)} aria-label="Dismiss message"> ✕ </button>
     {/if}
   </div>
 {/if}

package/dist/fermi-surface/FermiSlice.svelte

@@ -86,7 +86,10 @@
     const isolines = slice_data?.isolines
     if (!isolines?.length) return { min: [-1, -1], max: [1, 1] }
 
-    let xmin = Infinity, xmax = -Infinity, ymin = Infinity, ymax = -Infinity
+    let xmin = Infinity,
+      xmax = -Infinity,
+      ymin = Infinity,
+      ymax = -Infinity
     for (const iso of isolines) {
       for (const pt of iso.points_2d) {
         if (pt[0] < xmin) xmin = pt[0]
@@ -97,13 +100,14 @@
     }
     if (!isFinite(xmin)) return { min: [-1, -1], max: [1, 1] }
 
-    const pad = 0.1, rx = xmax - xmin || 1, ry = ymax - ymin || 1
+    const pad = 0.1,
+      rx = xmax - xmin || 1,
+      ry = ymax - ymin || 1
     return {
       min: [xmin - rx * pad, ymin - ry * pad],
       max: [xmax + rx * pad, ymax + ry * pad],
     }
   })
-
   function toggle_band(series_idx: number) {
     const band = slice_data?.isolines[series_idx]?.band_index
     if (band === undefined) return
@@ -114,9 +118,7 @@
   function isolate_band(series_idx: number) {
     const band = slice_data?.isolines[series_idx]?.band_index
     if (band === undefined) return
-    const all_bands = [
-      ...new Set(slice_data?.isolines.map((iso) => iso.band_index)),
-    ]
+    const all_bands = [...new Set(slice_data?.isolines.map((iso) => iso.band_index))]
     const is_solo = all_bands.every((bid) => bid === band || hidden_bands.has(bid))
     hidden_bands.clear()
     if (!is_solo) {
@@ -127,8 +129,7 @@
   }
 
   // Returns null if SVG not found, making export failures explicit
-  const export_svg = (): string | null =>
-    wrapper?.querySelector(`svg`)?.outerHTML ?? null
+  const export_svg = (): string | null => wrapper?.querySelector(`svg`)?.outerHTML ?? null
 </script>
 
 <ScatterPlot
@@ -143,16 +144,16 @@
   controls={{ show: false }}
   fullscreen_toggle={false}
   legend={show_legend && series.length > 0
-  ? {
-    on_toggle: toggle_band,
-    on_double_click: isolate_band,
-    draggable: false,
-    // pin bottom-right so it clears the top-left title/controls overlay (e.g. in the demo)
-    style: `left: auto; top: auto; right: 8px; bottom: 8px`,
-  }
-  : null}
+    ? {
+        on_toggle: toggle_band,
+        on_double_click: isolate_band,
+        draggable: false,
+        // pin bottom-right so it clears the top-left title/controls overlay (e.g. in the demo)
+        style: `left: auto; top: auto; right: 8px; bottom: 8px`,
+      }
+    : null}
   padding={{ t: 5, b: 5, l: 5, r: 5 }}
-  class="fermi-slice {rest.class ?? ``}"
+  class={[`fermi-slice`, rest.class]}
   style={rest.style}
 >
   {#snippet user_content({ x_scale_fn, y_scale_fn, pad, width, height })}
@@ -192,6 +193,8 @@
   }
   .fermi-label {
     fill: var(--fermi-surface-axis-color, #888);
-    font: 12px system-ui, sans-serif;
+    font:
+      12px system-ui,
+      sans-serif;
   }
 </style>

package/dist/fermi-surface/FermiSurface.svelte

@@ -5,7 +5,7 @@
   import EmptyState from '../EmptyState.svelte'
   import { StatusMessage } from '../feedback'
   import Spinner from '../feedback/Spinner.svelte'
-  import { create_file_drop_handler, drag_over_handlers, load_from_url } from '../io'
+  import * as io from '../io'
   import { type FullscreenToggleProp, toggle_fullscreen, ViewerChrome } from '../layout'
   import { sync_fullscreen } from '../layout/fullscreen.svelte'
   import { PlotTooltip } from '../plot'
@@ -34,13 +34,9 @@
     RepresentationMode,
   } from './types'
 
-  type FermiHandlerData = {
+  type FermiFullscreenData = {
     fermi_data?: FermiSurfaceData
-    band_data?: BandGridData
     bz_data?: BrillouinZoneData
-    filename?: string
-    file_size?: number
-    error_msg?: string
     fullscreen?: boolean
   }
 
@@ -136,13 +132,11 @@
     spinner_props?: ComponentProps<typeof Spinner>
     loading?: boolean
     error_msg?: string
-    children?: Snippet<
-      [{ fermi_data?: FermiSurfaceData; bz_data?: BrillouinZoneData }]
-    >
+    children?: Snippet<[{ fermi_data?: FermiSurfaceData; bz_data?: BrillouinZoneData }]>
     on_file_drop?: (filename: string) => void
     on_file_load?: (data: FermiFileLoadData) => void
     on_error?: (data: FermiErrorData) => void
-    on_fullscreen_change?: (data: FermiHandlerData) => void
+    on_fullscreen_change?: (data: FermiFullscreenData) => void
     on_mu_change?: (mu: number) => void
     tooltip_config?: Snippet<[{ hover_data: FermiHoverData }]> | FermiTooltipConfig
     on_point_hover?: (data: FermiHoverData | null) => void
@@ -173,17 +167,12 @@
   // Yield to browser so spinner can render before heavy computation
   const tick = () =>
     new Promise<void>((resolve) =>
-      requestAnimationFrame(() => requestAnimationFrame(() => resolve()))
+      requestAnimationFrame(() => requestAnimationFrame(() => resolve())),
     )
 
   // Parse and load Fermi surface from content (async for UI responsiveness)
-  async function parse_fermi_content(
-    content: string | ArrayBuffer,
-    filename: string,
-  ) {
-    const text = content instanceof ArrayBuffer
-      ? new TextDecoder().decode(content)
-      : content
+  async function parse_fermi_content(content: string | ArrayBuffer, filename: string) {
+    const text = content instanceof ArrayBuffer ? new TextDecoder().decode(content) : content
 
     // parse_fermi_file throws a descriptive error when parsing fails
     const parsed = parse_fermi_file(text, filename)
@@ -208,9 +197,7 @@
     try {
       await parse_fermi_content(content, filename)
     } catch (err) {
-      error_msg = `Failed to parse ${filename}: ${
-        to_error(err).message
-      }`
+      error_msg = `Failed to parse ${filename}: ${to_error(err).message}`
       on_error?.({ error_msg, filename })
     }
   }
@@ -277,11 +264,10 @@
   // Compute BZ when structure or fermi_data changes
   $effect(() => {
     // Get k_lattice from available sources (priority order)
-    const k_lattice = fermi_data?.k_lattice ??
+    const k_lattice =
+      fermi_data?.k_lattice ??
       band_data?.k_lattice ??
-      (structure?.lattice?.matrix
-        ? reciprocal_lattice(structure.lattice.matrix)
-        : null)
+      (structure?.lattice?.matrix ? reciprocal_lattice(structure.lattice.matrix) : null)
 
     if (!k_lattice) {
       bz_data = undefined
@@ -313,23 +299,26 @@
   // Load from URL (with race condition protection for rapid URL changes)
   let load_id = 0
   $effect(() => {
-    if (data_url && !fermi_data && !band_data) {
-      const current_load_id = ++load_id
-      loading = true
-      error_msg = undefined
-      load_from_url(data_url, safe_parse)
-        .catch((err) => {
-          if (current_load_id !== load_id) return // stale request
-          error_msg = to_error(err).message
-          on_error?.({ error_msg, filename: data_url })
-        })
-        .finally(() => {
-          if (current_load_id === load_id) loading = false
-        })
-    }
+    const requested_url = data_url
+    if (!requested_url || fermi_data || band_data) return
+    const current_load_id = ++load_id
+    loading = true
+    error_msg = undefined
+    io.load_from_url(requested_url, (content, filename) => {
+      if (current_load_id !== load_id) return
+      return safe_parse(content, filename)
+    })
+      .catch((err) => {
+        if (current_load_id !== load_id) return
+        error_msg = to_error(err).message
+        on_error?.({ error_msg, filename: io.basename_from_url(requested_url) })
+      })
+      .finally(() => {
+        if (current_load_id === load_id) loading = false
+      })
   })
 
-  const handle_file_drop = create_file_drop_handler({
+  const handle_file_drop = io.create_file_drop_handler({
     allow: () => allow_file_drop,
     on_drop: async (content, filename) => {
       on_file_drop?.(filename)
@@ -361,8 +350,7 @@
     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 }),
+    on_change: (val) => on_fullscreen_change?.({ fermi_data, bz_data, fullscreen: val }),
   })
 </script>
 
@@ -379,9 +367,12 @@
   onmouseenter={() => (hovered = true)}
   onmouseleave={() => (hovered = false)}
   ondrop={handle_file_drop}
-  {...drag_over_handlers({ allow: () => allow_file_drop, set_dragover: (over) => dragover = over })}
+  {...io.drag_over_handlers({
+    allow: () => allow_file_drop,
+    set_dragover: (over) => (dragover = over),
+  })}
   {...rest}
-  class="fermi-surface {rest.class ?? ``}"
+  class={[`fermi-surface`, rest.class]}
 >
   {@render children?.({ fermi_data, bz_data })}
   {#if loading}

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

@@ -7,13 +7,9 @@ import type { Crystal } from '../structure';
 import type { ComponentProps, Snippet } from 'svelte';
 import type { HTMLAttributes } from 'svelte/elements';
 import type { BandGridData, ColorProperty, FermiErrorData, FermiFileLoadData, FermiHoverData, FermiSurfaceData, FermiTooltipConfig, RepresentationMode } from './types';
-type FermiHandlerData = {
+type FermiFullscreenData = {
     fermi_data?: FermiSurfaceData;
-    band_data?: BandGridData;
     bz_data?: BrillouinZoneData;
-    filename?: string;
-    file_size?: number;
-    error_msg?: string;
     fullscreen?: boolean;
 };
 type $$ComponentProps = {
@@ -52,16 +48,14 @@ type $$ComponentProps = {
     spinner_props?: ComponentProps<typeof Spinner>;
     loading?: boolean;
     error_msg?: string;
-    children?: Snippet<[
-        {
-            fermi_data?: FermiSurfaceData;
-            bz_data?: BrillouinZoneData;
-        }
-    ]>;
+    children?: Snippet<[{
+        fermi_data?: FermiSurfaceData;
+        bz_data?: BrillouinZoneData;
+    }]>;
     on_file_drop?: (filename: string) => void;
     on_file_load?: (data: FermiFileLoadData) => void;
     on_error?: (data: FermiErrorData) => void;
-    on_fullscreen_change?: (data: FermiHandlerData) => void;
+    on_fullscreen_change?: (data: FermiFullscreenData) => void;
     on_mu_change?: (mu: number) => void;
     tooltip_config?: Snippet<[{
         hover_data: FermiHoverData;
@@ -69,6 +63,6 @@ type $$ComponentProps = {
     on_point_hover?: (data: FermiHoverData | null) => void;
     on_hover?: (data: FermiHoverData | null) => void;
 } & HTMLAttributes<HTMLDivElement>;
-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">;
+declare const FermiSurface: import("svelte").Component<$$ComponentProps, {}, "height" | "width" | "dragover" | "fullscreen" | "wrapper" | "hovered" | "controls_open" | "camera_projection" | "color_scale" | "loading" | "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

@@ -2,7 +2,7 @@
   import SettingsSection from '../layout/SettingsSection.svelte'
   import DraggablePane from '../overlays/DraggablePane.svelte'
   import type { CameraProjection } from '../settings'
-  import { make_change_detector } from '../utils'
+  import { make_change_detector, parse_num_token } from '../utils'
   import type { Snippet } from 'svelte'
   import type {
     BandGridData,
@@ -90,8 +90,8 @@
   let available_bands = $derived(
     fermi_data
       ? [...new Set(fermi_data.isosurfaces.map((iso) => iso.band_index))].toSorted(
-        (a, b) => a - b,
-      )
+          (a, b) => a - b,
+        )
       : [],
   )
   let available_bands_key = $derived(available_bands.join(`,`))
@@ -119,8 +119,7 @@
   }
 
   function handle_mu_change(event: Event & { currentTarget: HTMLInputElement }) {
-    const trimmed = event.currentTarget.value.trim()
-    const parsed = parseFloat(trimmed)
+    const parsed = parse_num_token(event.currentTarget.value)
     // Only update mu when input is valid; keep last valid value during transient
     // invalid states (e.g. empty string while user is typing a new value)
     if (Number.isFinite(parsed)) {
@@ -147,14 +146,7 @@
   >
     <label>
       <span>μ offset (eV):</span>
-      <input
-        type="range"
-        min="-1"
-        max="1"
-        step="0.01"
-        value={mu}
-        oninput={handle_mu_change}
-      />
+      <input type="range" min="-1" max="1" step="0.01" value={mu} oninput={handle_mu_change} />
       <input
         type="number"
         step="0.01"
@@ -300,13 +292,7 @@
       </label>
       <label>
         <span>Position:</span>
-        <input
-          type="range"
-          min="-1"
-          max="1"
-          step="0.01"
-          bind:value={clip_position}
-        />
+        <input type="range" min="-1" max="1" step="0.01" bind:value={clip_position} />
         <span class="value">{clip_position.toFixed(2)}</span>
       </label>
       <label>

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" | "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">;
+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">;
 type FermiSurfaceControls = ReturnType<typeof FermiSurfaceControls>;
 export default FermiSurfaceControls;