matterviz 0.3.1 → 0.3.3

package/dist/convex-hull/ConvexHull.svelte

@@ -1,44 +1,99 @@
-<script lang="ts">import { extract_formula_elements } from '../composition/parse';
-import { DEFAULTS } from '../settings';
-import { SvelteSet } from 'svelte/reactivity';
-import ConvexHull2D from './ConvexHull2D.svelte';
-import ConvexHull3D from './ConvexHull3D.svelte';
-import ConvexHull4D from './ConvexHull4D.svelte';
-let { entries = [], 
-// bindable props not part of rest because Svelte 5 doesn't support spreading bindable props.
-fullscreen = $bindable(false), wrapper = $bindable(), show_stable = $bindable(true), show_unstable = $bindable(true), show_hull_faces = $bindable(true), hull_face_opacity: hull_face_opacity_prop = $bindable(undefined), color_mode = $bindable(`energy`), color_scale = $bindable(`interpolateViridis`), info_pane_open = $bindable(false), legend_pane_open = $bindable(false), max_hull_dist_show_phases = $bindable(0.1), max_hull_dist_show_labels = $bindable(0.1), show_stable_labels = $bindable(true), show_unstable_labels = $bindable(false), energy_source_mode = $bindable(`precomputed`), phase_stats = $bindable(null), display = $bindable({ x_grid: false, y_grid: false }), stable_entries = $bindable([]), unstable_entries = $bindable([]), highlighted_entries = $bindable([]), selected_entry = $bindable(null), temperature = $bindable(), gas_pressures = $bindable({}), ...rest } = $props();
-// Lightweight element extraction - count unique elements, stripping oxidation states
-// (e.g. "V4+" -> "V") to avoid counting the same element multiple times
-function extract_unique_elements(entries) {
-    const elements = new SvelteSet();
+<script lang="ts">
+  import { extract_formula_elements } from '../composition/parse'
+  import type { AxisConfig } from '../plot'
+  import { DEFAULTS } from '../settings'
+  import type { Component } from 'svelte'
+  import { SvelteSet } from 'svelte/reactivity'
+  import ConvexHull2D from './ConvexHull2D.svelte'
+  import ConvexHull3D from './ConvexHull3D.svelte'
+  import ConvexHull4D from './ConvexHull4D.svelte'
+  import type { BaseConvexHullProps, Hull3DProps } from './index'
+  import type { GasSpecies, GasThermodynamicsConfig } from './types'
+
+  // Union type combining all possible props from 2D, 3D, and 4D components
+  // each specific component will only use its relevant props from this super set
+  type ConvexHullProps = BaseConvexHullProps & Hull3DProps & {
+    x_axis?: AxisConfig
+    y_axis?: AxisConfig
+    // Gas thermodynamics config - enables atmosphere-controlled phase diagrams
+    gas_config?: GasThermodynamicsConfig
+    // Gas pressure binding - enables two-way binding for atmosphere control
+    gas_pressures?: Partial<Record<GasSpecies, number>>
+  }
+
+  let {
+    entries = [],
+    // bindable props not part of rest because Svelte 5 doesn't support spreading bindable props.
+    fullscreen = $bindable(false),
+    wrapper = $bindable(),
+    show_stable = $bindable(true),
+    show_unstable = $bindable(true),
+    show_hull_faces = $bindable(true),
+    hull_face_opacity: hull_face_opacity_prop = $bindable(
+      undefined as number | undefined,
+    ),
+    color_mode = $bindable(`energy`),
+    color_scale = $bindable(`interpolateViridis`),
+    info_pane_open = $bindable(false),
+    legend_pane_open = $bindable(false),
+    max_hull_dist_show_phases = $bindable(0.1),
+    max_hull_dist_show_labels = $bindable(0.1),
+    show_stable_labels = $bindable(true),
+    show_unstable_labels = $bindable(false),
+    energy_source_mode = $bindable(`precomputed`),
+    phase_stats = $bindable(null),
+    display = $bindable({ x_grid: false, y_grid: false }),
+    stable_entries = $bindable([]),
+    unstable_entries = $bindable([]),
+    highlighted_entries = $bindable([]),
+    selected_entry = $bindable(null),
+    temperature = $bindable(),
+    gas_pressures = $bindable({}),
+    ...rest
+  }: ConvexHullProps = $props()
+
+  // Lightweight element extraction - count unique elements, stripping oxidation states
+  // (e.g. "V4+" -> "V") to avoid counting the same element multiple times
+  function extract_unique_elements(
+    entries: { composition: Record<string, number> }[],
+  ): string[] {
+    const elements = new SvelteSet<string>()
     for (const entry of entries) {
-        for (const key of Object.keys(entry.composition)) {
-            // Extract valid element symbols, stripping oxidation states
-            for (const elem of extract_formula_elements(key, { unique: false })) {
-                elements.add(elem);
-            }
+      for (const key of Object.keys(entry.composition)) {
+        // Extract valid element symbols, stripping oxidation states
+        for (const elem of extract_formula_elements(key, { unique: false })) {
+          elements.add(elem)
         }
+      }
     }
-    return Array.from(elements).sort();
-}
-// Detect dimensionality by counting unique elements (lightweight operation)
-const elements = $derived(extract_unique_elements(entries));
-const element_count = $derived(elements.length);
-// Resolve hull face opacity: use caller's value if provided,
-// otherwise pick the right default for the dimensionality (ternary=30%, quaternary=3%)
-// Writable $derived handles forward sync (prop→local), back-sync $effect handles local→prop
-const default_opacity = $derived(element_count === 4
-    ? DEFAULTS.convex_hull.quaternary.hull_face_opacity
-    : DEFAULTS.convex_hull.ternary.hull_face_opacity);
-let hull_face_opacity = $derived(hull_face_opacity_prop ?? default_opacity);
-$effect(() => {
-    hull_face_opacity_prop = hull_face_opacity;
-});
-// Map element count to corresponding component
-// Note: Type assertion needed because TypeScript can't infer that all components
-// accept a compatible superset of props (BaseConvexHullProps + dimension-specific)
-const ConvexHullComponent = $derived({ 2: ConvexHull2D, 3: ConvexHull3D, 4: ConvexHull4D }[element_count] ??
-    null);
+    return Array.from(elements).toSorted()
+  }
+
+  // Detect dimensionality by counting unique elements (lightweight operation)
+  const elements = $derived(extract_unique_elements(entries))
+  const element_count = $derived(elements.length)
+
+  // Resolve hull face opacity: use caller's value if provided,
+  // otherwise pick the right default for the dimensionality (ternary=30%, quaternary=3%).
+  // Use writable derived so child bind updates can sync back to parent.
+  const default_opacity = $derived(
+    element_count === 4
+      ? DEFAULTS.convex_hull.quaternary.hull_face_opacity
+      : DEFAULTS.convex_hull.ternary.hull_face_opacity,
+  )
+  let hull_face_opacity = $derived(hull_face_opacity_prop ?? default_opacity)
+  $effect(() => {
+    if (hull_face_opacity_prop === hull_face_opacity) return
+    hull_face_opacity_prop = hull_face_opacity
+  })
+
+  // Map element count to corresponding component
+  // Note: Type assertion needed because TypeScript can't infer that all components
+  // accept a compatible superset of props (BaseConvexHullProps + dimension-specific)
+  const ConvexHullComponent = $derived(
+    { 2: ConvexHull2D, 3: ConvexHull3D, 4: ConvexHull4D }[element_count] ??
+      null,
+  ) as Component<ConvexHullProps> | null
 </script>
 
 {#if ConvexHullComponent}