matterviz 0.3.2 → 0.3.4

package/dist/convex-hull/ConvexHullTooltip.svelte

@@ -1,17 +1,41 @@
-<script lang="ts" generics="EntryT extends PhaseData = PhaseData">// Unified tooltip component for convex hull diagrams
-import { ELEM_SYMBOL_TO_NAME, get_electro_neg_formula } from '../composition';
-import { format_num } from '../labels';
-import { TooltipContent } from '../tooltip';
-import { is_unary_entry } from './types';
-let { entry, polymorph_stats_map, highlight_style, tooltip, show_fractional = true, } = $props();
-const is_element = $derived(is_unary_entry(entry));
-const elem_symbol = $derived(is_element
-    ? (Object.entries(entry.composition).find(([, n]) => n > 0)?.[0] ?? ``)
-    : ``);
-const elem_name = $derived(elem_symbol && ELEM_SYMBOL_TO_NAME[elem_symbol]);
-const polymorph_stats = $derived(entry.entry_id && polymorph_stats_map
-    ? polymorph_stats_map.get(entry.entry_id)
-    : null);
+<script lang="ts" generics="EntryT extends PhaseData = PhaseData">
+  // Unified tooltip component for convex hull diagrams
+  import { ELEM_SYMBOL_TO_NAME, get_electro_neg_formula } from '../composition'
+  import type { ElementSymbol } from '../element'
+  import { format_num } from '../labels'
+  import { sanitize_html } from '../sanitize'
+  import { TooltipContent } from '../tooltip'
+  import type { PolymorphStats } from './helpers'
+  import type { ConvexHullTooltipProp, TooltipSnippetProps } from './index'
+  import type { HighlightStyle, PhaseData } from './types'
+  import { is_unary_entry } from './helpers'
+
+  let {
+    entry,
+    polymorph_stats_map,
+    highlight_style,
+    tooltip,
+    show_fractional = true,
+  }: {
+    entry: EntryT
+    polymorph_stats_map?: Map<string, PolymorphStats>
+    highlight_style?: HighlightStyle
+    tooltip?: ConvexHullTooltipProp<EntryT>
+    show_fractional?: boolean
+  } = $props()
+
+  const is_element = $derived(is_unary_entry(entry))
+  const elem_symbol = $derived(
+    is_element
+      ? (Object.entries(entry.composition).find(([, n]) => n > 0)?.[0] ?? ``)
+      : ``,
+  ) as ElementSymbol | ``
+  const elem_name = $derived(elem_symbol && ELEM_SYMBOL_TO_NAME[elem_symbol])
+  const polymorph_stats = $derived(
+    entry.entry_id && polymorph_stats_map
+      ? polymorph_stats_map.get(entry.entry_id)
+      : null,
+  )
 </script>
 
 <TooltipContent
@@ -32,7 +56,7 @@ const polymorph_stats = $derived(entry.entry_id && polymorph_stats_map
       {/if}
       {#if !is_element || !entry.entry_id}
         <strong style="display: block">
-          {@html get_electro_neg_formula(entry.composition)}
+          {@html sanitize_html(get_electro_neg_formula(entry.composition))}
         </strong>
       {/if}
     </div>
@@ -56,7 +80,7 @@ const polymorph_stats = $derived(entry.entry_id && polymorph_stats_map
         .filter(([, amt]) => amt > 0)
         .map(([el, amt]) => `${el}<sub>${format_num(amt / total, `.2~`)}</sub>`)}
         {#if fractions.length > 1}
-          <div>Fractional: {@html fractions.join(` `)}</div>
+          <div>Fractional: {@html sanitize_html(fractions.join(` `))}</div>
         {/if}
       {/if}
     {/if}

package/dist/convex-hull/GasPressureControls.svelte

@@ -1,66 +1,110 @@
-<script lang="ts">import { tooltip } from 'svelte-multiselect';
-import { compute_gas_chemical_potential, format_chemical_potential, get_default_gas_provider, get_effective_pressures, } from './gas-thermodynamics';
-let { config, pressures = $bindable({}), temperature, position = `top-right`, ...rest } = $props();
-// Log scale range for pressure slider: 10^-10 to 10^2 bar
-const LOG_P_MIN = -10;
-const LOG_P_MAX = 2;
-const LOG_P_RANGE = LOG_P_MAX - LOG_P_MIN;
-const MIN_PRESSURE = 1e-15; // Safe minimum to avoid log(0) or NaN
-const THROTTLE_MS = 100;
-// Local preview state for smooth slider interaction without causing full hull re-renders
-let preview_pressures = $state({});
-let last_update_time = 0;
-// Get provider for chemical potential calculations
-const provider = $derived(config.provider ?? get_default_gas_provider());
-// Get enabled gases from config
-const enabled_gases = $derived(config.enabled_gases ?? []);
-// Effective pressures including defaults
-const effective_pressures = $derived(get_effective_pressures(config));
-// Get current pressure for a gas (preview during drag, committed, or default)
-function get_pressure(gas) {
-    const P = preview_pressures[gas] ?? pressures[gas] ?? effective_pressures[gas];
-    return Number.isFinite(P) && P > 0 ? P : MIN_PRESSURE;
-}
-// Compute chemical potential μ(T,P) for a gas at current temperature and pressure
-const get_mu = (gas) => compute_gas_chemical_potential(provider, gas, temperature, get_pressure(gas));
-// Convert pressure to log scale slider position (0-100)
-const pressure_to_slider = (P) => ((Math.max(LOG_P_MIN, Math.min(LOG_P_MAX, Math.log10(P))) - LOG_P_MIN) /
-    LOG_P_RANGE) * 100;
-// Convert slider position (0-100) to pressure
-const slider_to_pressure = (value) => Math.pow(10, LOG_P_MIN + (value / 100) * LOG_P_RANGE);
-// Format gas name for display (subscript numbers)
-const format_gas_name = (gas) => gas.replace(/(\d+)/g, `<sub>$1</sub>`);
-// Format pressure as plain text (no HTML) for the number input
-function format_pressure(P) {
-    const log_P = Math.log10(P);
-    const exp = Math.round(log_P);
-    if (Math.abs(log_P - exp) < 0.1)
-        return `1e${exp}`;
-    if (P >= 0.01 && P < 100)
-        return P.toPrecision(2);
-    return P.toExponential(1);
-}
-function set_pressure(gas, value) {
-    const P = slider_to_pressure(value);
-    preview_pressures = { ...preview_pressures, [gas]: P };
+<script lang="ts">
+  import type {
+    GasControlPosition,
+    GasSpecies,
+    GasThermodynamicsConfig,
+  } from './types'
+  import { sanitize_html } from '../sanitize'
+  import { tooltip } from 'svelte-multiselect'
+  import type { HTMLAttributes } from 'svelte/elements'
+  import {
+    compute_gas_chemical_potential,
+    format_chemical_potential,
+    get_default_gas_provider,
+    get_effective_pressures,
+  } from './gas-thermodynamics'
+
+  let {
+    config,
+    pressures = $bindable({}),
+    temperature,
+    position = `top-right`,
+    ...rest
+  }: HTMLAttributes<HTMLDivElement> & {
+    config: GasThermodynamicsConfig
+    pressures: Partial<Record<GasSpecies, number>>
+    temperature: number
+    position?: GasControlPosition
+  } = $props()
+
+  // Log scale range for pressure slider: 10^-10 to 10^2 bar
+  const LOG_P_MIN = -10
+  const LOG_P_MAX = 2
+  const LOG_P_RANGE = LOG_P_MAX - LOG_P_MIN
+  const MIN_PRESSURE = 1e-15 // Safe minimum to avoid log(0) or NaN
+  const THROTTLE_MS = 100
+
+  // Local preview state for smooth slider interaction without causing full hull re-renders
+  let preview_pressures = $state<Partial<Record<GasSpecies, number>>>({})
+  let last_update_time = 0
+
+  // Get provider for chemical potential calculations
+  const provider = $derived(config.provider ?? get_default_gas_provider())
+
+  // Get enabled gases from config
+  const enabled_gases = $derived(config.enabled_gases ?? [])
+
+  // Effective pressures including defaults
+  const effective_pressures = $derived(get_effective_pressures(config))
+
+  // Get current pressure for a gas (preview during drag, committed, or default)
+  function get_pressure(gas: GasSpecies): number {
+    const P = preview_pressures[gas] ?? pressures[gas] ?? effective_pressures[gas]
+    return Number.isFinite(P) && P > 0 ? P : MIN_PRESSURE
+  }
+
+  // Compute chemical potential μ(T,P) for a gas at current temperature and pressure
+  const get_mu = (gas: GasSpecies): number =>
+    compute_gas_chemical_potential(provider, gas, temperature, get_pressure(gas))
+
+  // Convert pressure to log scale slider position (0-100)
+  const pressure_to_slider = (P: number): number =>
+    ((Math.max(LOG_P_MIN, Math.min(LOG_P_MAX, Math.log10(P))) - LOG_P_MIN) /
+      LOG_P_RANGE) * 100
+
+  // Convert slider position (0-100) to pressure
+  const slider_to_pressure = (value: number): number =>
+    Math.pow(10, LOG_P_MIN + (value / 100) * LOG_P_RANGE)
+
+  // Format gas name for display (subscript numbers)
+  const format_gas_name = (gas: GasSpecies): string =>
+    gas.replaceAll(/(\d+)/g, `<sub>$1</sub>`)
+
+  // Format pressure as plain text (no HTML) for the number input
+  function format_pressure(P: number): string {
+    const log_P = Math.log10(P)
+    const exp = Math.round(log_P)
+    if (Math.abs(log_P - exp) < 0.1) return `1e${exp}`
+    if (P >= 0.01 && P < 100) return P.toPrecision(2)
+    return P.toExponential(1)
+  }
+
+  function set_pressure(gas: GasSpecies, value: number): void {
+    const P = slider_to_pressure(value)
+    preview_pressures = { ...preview_pressures, [gas]: P }
     // Throttle parent updates during drag to prevent hull recomputation on every pixel
-    const now = Date.now();
+    const now = Date.now()
     if (now - last_update_time >= THROTTLE_MS) {
-        last_update_time = now;
-        pressures = { ...pressures, [gas]: P };
+      last_update_time = now
+      pressures = { ...pressures, [gas]: P }
     }
-}
-function handle_slider_end(gas, event) {
-    const P = slider_to_pressure(+event.currentTarget.value);
-    pressures = { ...pressures, [gas]: P };
+  }
+
+  function handle_slider_end(gas: GasSpecies, event: Event): void {
+    const P = slider_to_pressure(+(event.currentTarget as HTMLInputElement).value)
+    pressures = { ...pressures, [gas]: P }
     // Clear only this gas's preview (don't reset other sliders being dragged simultaneously)
-    const { [gas]: _, ...rest } = preview_pressures;
-    preview_pressures = rest;
-}
-function set_pressure_direct(gas, value) {
-    const clamped = Math.max(Math.pow(10, LOG_P_MIN), Math.min(Math.pow(10, LOG_P_MAX), value));
-    pressures = { ...pressures, [gas]: clamped };
-}
+    const { [gas]: _, ...rest } = preview_pressures
+    preview_pressures = rest
+  }
+
+  function set_pressure_direct(gas: GasSpecies, value: number): void {
+    const clamped = Math.max(
+      Math.pow(10, LOG_P_MIN),
+      Math.min(Math.pow(10, LOG_P_MAX), value),
+    )
+    pressures = { ...pressures, [gas]: clamped }
+  }
 </script>
 
 {#if enabled_gases.length > 0}
@@ -88,8 +132,7 @@ function set_pressure_direct(gas, value) {
             }}
             aria-label="{gas} pressure (bar)"
           />
-          <!-- eslint-disable-next-line svelte/no-at-html-tags -->
-          <span class="gas-name">{@html format_gas_name(gas)}</span>
+          <span class="gas-name">{@html sanitize_html(format_gas_name(gas))}</span>
         </label>
         <div class="slider-wrapper">
           <span class="pressure-range">

package/dist/convex-hull/StructurePopup.svelte

@@ -1,7 +1,28 @@
-<script lang="ts">import Icon from '../Icon.svelte';
-import { format_num } from '../labels';
-import { Structure } from '../structure';
-let { structure, place_right = true, width = 500, height = 400, onclose, stats, popup_div = $bindable(), ...rest } = $props();
+<script lang="ts">
+  import type { AnyStructure } from '../structure'
+  import Icon from '../Icon.svelte'
+  import { format_num } from '../labels'
+  import { Structure } from '../structure'
+  import type { HTMLAttributes } from 'svelte/elements'
+
+  let {
+    structure,
+    place_right = true,
+    width = 500,
+    height = 400,
+    onclose,
+    stats,
+    popup_div = $bindable(),
+    ...rest
+  }: HTMLAttributes<HTMLDivElement> & {
+    structure: AnyStructure
+    place_right?: boolean
+    width?: number
+    height?: number
+    onclose?: () => void
+    stats?: { id?: string; e_above_hull?: number; e_form?: number }
+    popup_div?: HTMLDivElement
+  } = $props()
 </script>
 
 {#snippet close_button()}

package/dist/convex-hull/TemperatureSlider.svelte

@@ -1,31 +1,51 @@
-<script lang="ts">import { tooltip } from 'svelte-multiselect';
-let { available_temperatures, temperature = $bindable(), ...rest } = $props();
-// Local preview state for smooth slider interaction without causing full re-renders
-let preview_index = $state(null);
-let last_update_time = 0;
-const THROTTLE_MS = 100;
-const temp_index = $derived(Math.max(0, available_temperatures.indexOf(temperature)));
-const display_index = $derived(preview_index ?? temp_index);
-const display_temp = $derived(available_temperatures[display_index] ?? temperature);
-function handle_slider_input(event) {
-    const new_index = +event.currentTarget.value;
-    preview_index = new_index;
+<script lang="ts">
+  import { tooltip } from 'svelte-multiselect'
+  import type { HTMLAttributes } from 'svelte/elements'
+
+  let {
+    available_temperatures,
+    temperature = $bindable(),
+    ...rest
+  }: HTMLAttributes<HTMLDivElement> & {
+    available_temperatures: number[]
+    temperature: number
+  } = $props()
+
+  // Local preview state for smooth slider interaction without causing full re-renders
+  let preview_index = $state<number | null>(null)
+  let last_update_time = 0
+  const THROTTLE_MS = 100
+
+  const temp_index = $derived(
+    Math.max(0, available_temperatures.indexOf(temperature)),
+  )
+  const display_index = $derived(preview_index ?? temp_index)
+  const display_temp = $derived(available_temperatures[display_index] ?? temperature)
+
+  function handle_slider_input(event: Event): void {
+    const new_index = +(event.currentTarget as HTMLInputElement).value
+    preview_index = new_index
     // Throttle parent updates during drag to prevent scene flashing
-    const now = Date.now();
+    const now = Date.now()
     if (now - last_update_time >= THROTTLE_MS) {
-        last_update_time = now;
-        temperature = available_temperatures[new_index] ?? temperature;
+      last_update_time = now
+      temperature = available_temperatures[new_index] ?? temperature
     }
-}
-function handle_slider_end(event) {
-    const new_temp = available_temperatures[+event.currentTarget.value];
-    if (new_temp !== undefined)
-        temperature = new_temp;
-    preview_index = null;
-}
-function set_closest_temp(value) {
-    temperature = available_temperatures.reduce((prev, curr) => (Math.abs(curr - value) < Math.abs(prev - value) ? curr : prev), temperature);
-}
+  }
+
+  function handle_slider_end(event: Event): void {
+    const new_temp =
+      available_temperatures[+(event.currentTarget as HTMLInputElement).value]
+    if (new_temp !== undefined) temperature = new_temp
+    preview_index = null
+  }
+
+  function set_closest_temp(value: number): void {
+    temperature = available_temperatures.reduce(
+      (prev, curr) => (Math.abs(curr - value) < Math.abs(prev - value) ? curr : prev),
+      temperature,
+    )
+  }
 </script>
 
 <div

package/dist/convex-hull/barycentric-coords.js

@@ -1,5 +1,5 @@
 import { compute_e_form_per_atom, find_lowest_energy_unary_refs } from './thermodynamics';
-import { is_unary_entry } from './types';
+import { is_unary_entry } from './helpers';
 // --- Ternary coordinates ---
 export const TRIANGLE_VERTICES = [
     [1, 0],
@@ -81,10 +81,9 @@ export function get_ternary_3d_coordinates(entries, elements, el_refs) {
     // Map entries to ternary plot coordinates
     const result = within_system.map((entry) => {
         const barycentric = composition_to_barycentric_3d(entry.composition, elements);
-        const e_form_per_atom = typeof entry.e_form_per_atom === `number` &&
-            Number.isFinite(entry.e_form_per_atom)
+        const e_form_per_atom = typeof entry.e_form_per_atom === `number` && Number.isFinite(entry.e_form_per_atom)
             ? entry.e_form_per_atom
-            : compute_e_form_per_atom(entry, refs) ?? NaN;
+            : (compute_e_form_per_atom(entry, refs) ?? NaN);
         const xyz = barycentric_to_ternary_xyz(barycentric, e_form_per_atom);
         const is_element = is_unary_entry(entry);
         return { ...entry, ...xyz, is_element, visible: true };
@@ -93,11 +92,18 @@ export function get_ternary_3d_coordinates(entries, elements, el_refs) {
 }
 export function get_triangle_edges() {
     const [v0, v1, v2] = TRIANGLE_VERTICES.map(([x, y]) => ({ x, y, z: 0 }));
-    return [[v0, v1], [v1, v2], [v2, v0]];
+    return [
+        [v0, v1],
+        [v1, v2],
+        [v2, v0],
+    ];
 }
 export function get_triangle_vertical_edges(min_z, max_z) {
     const vertices = TRIANGLE_VERTICES.map(([x, y]) => ({ x, y, z: 0 }));
-    return vertices.map((vertex) => [{ ...vertex, z: min_z }, { ...vertex, z: max_z }]);
+    return vertices.map((vertex) => [
+        { ...vertex, z: min_z },
+        { ...vertex, z: max_z },
+    ]);
 }
 // --- N-dimensional barycentric coordinates (for 5+ element systems) ---
 // Convert composition to N-dimensional barycentric coordinates
@@ -111,7 +117,7 @@ export function composition_to_barycentric_nd(composition, elements) {
     // NaN and undefined/missing elements are treated as 0
     const amounts = elements.map((el) => {
         const val = composition[el];
-        return (val === null || val === undefined || Number.isNaN(val)) ? 0 : val;
+        return val == null || Number.isNaN(val) ? 0 : val;
     });
     let total = 0;
     const negative = [];

package/dist/convex-hull/demo-temperature.js

@@ -6,20 +6,24 @@ function seeded_random(seed) {
 export function make_demo_phase(composition, seed, entropy_boost = 0) {
     const n_elements = Object.keys(composition).length;
     const energy = -0.3 * n_elements - seeded_random(seed) * 0.5;
-    const entropy_coef = 0.5 + n_elements * 0.3 + seeded_random(seed + 1) * 2 +
-        entropy_boost;
+    const entropy_coef = 0.5 + n_elements * 0.3 + seeded_random(seed + 1) * 2 + entropy_boost;
     return {
         composition,
         energy,
         temperatures: demo_temperatures,
-        free_energies: demo_temperatures.map((temp_kelvin) => energy + entropy_coef * temp_kelvin * 0.0001 -
+        free_energies: demo_temperatures.map((temp_kelvin) => energy +
+            entropy_coef * temp_kelvin * 0.0001 -
             0.00005 * temp_kelvin * Math.log(temp_kelvin)),
     };
 }
 export function create_temp_ternary_entries_li_fe_o() {
     return [
         ...[`Li`, `Fe`, `O`].map((element, idx) => make_demo_phase({ [element]: 1 }, idx)),
-        ...[[`Li`, `Fe`], [`Li`, `O`], [`Fe`, `O`]].flatMap(([element_a, element_b], idx) => [0.33, 0.5, 0.67].flatMap((fraction, jdx) => [
+        ...[
+            [`Li`, `Fe`],
+            [`Li`, `O`],
+            [`Fe`, `O`],
+        ].flatMap(([element_a, element_b], idx) => [0.33, 0.5, 0.67].flatMap((fraction, jdx) => [
             make_demo_phase({ [element_a]: fraction, [element_b]: 1 - fraction }, 100 + idx * 10 + jdx),
             make_demo_phase({ [element_a]: fraction, [element_b]: 1 - fraction }, 200 + idx * 10 + jdx, 3),
         ])),

package/dist/convex-hull/gas-thermodynamics.js

@@ -28,7 +28,7 @@ export const GAS_STOICHIOMETRY = {
 // Source: Barin Thermochemical Tables and NBS Thermochemical Tables
 // Data compiled to match PIRO (https://github.com/GENESIS-EFRC/piro)
 // Note: These values are T*S in eV/molecule
-// deno-fmt-ignore
+// oxfmt-ignore
 const DEFAULT_TS_DATA = {
     O2: {
         temperatures: [0, 298, 300, 400, 500, 600, 700, 800, 900, 1000, 1100, 1200, 1300, 1400, 1500, 1600, 1700, 1800, 1900, 2000],
@@ -56,8 +56,14 @@ const DEFAULT_TS_DATA = {
     },
     F2: {
         // F2 not in Barin/NBS tables used by PIRO - approximated from similar homonuclear diatomics (O2, N2)
-        temperatures: [0, 298, 300, 400, 500, 600, 700, 800, 900, 1000, 1100, 1200, 1300, 1400, 1500, 1600, 1700, 1800, 1900, 2000],
-        values: [0, 0.31, 0.312, 0.435, 0.56, 0.69, 0.82, 0.96, 1.1, 1.24, 1.38, 1.53, 1.68, 1.83, 1.98, 2.13, 2.29, 2.45, 2.61, 2.77],
+        temperatures: [
+            0, 298, 300, 400, 500, 600, 700, 800, 900, 1000, 1100, 1200, 1300, 1400, 1500, 1600,
+            1700, 1800, 1900, 2000,
+        ],
+        values: [
+            0, 0.31, 0.312, 0.435, 0.56, 0.69, 0.82, 0.96, 1.1, 1.24, 1.38, 1.53, 1.68, 1.83,
+            1.98, 2.13, 2.29, 2.45, 2.61, 2.77,
+        ],
     },
 };
 // Formation enthalpies H_f at 0K in eV/molecule
@@ -81,13 +87,13 @@ function interpolate_ts(data, T) {
         return values[values.length - 1];
     }
     // Find bracketing indices
-    let i = 0;
-    while (i < temperatures.length - 1 && temperatures[i + 1] < T)
-        i++;
-    const T_low = temperatures[i];
-    const T_high = temperatures[i + 1];
-    const v_low = values[i];
-    const v_high = values[i + 1];
+    let idx = 0;
+    while (idx < temperatures.length - 1 && temperatures[idx + 1] < T)
+        idx++;
+    const T_low = temperatures[idx];
+    const T_high = temperatures[idx + 1];
+    const v_low = values[idx];
+    const v_high = values[idx + 1];
     // Linear interpolation
     const fraction = (T - T_low) / (T_high - T_low);
     return v_low + fraction * (v_high - v_low);
@@ -146,8 +152,7 @@ export function compute_gas_chemical_potential(provider, gas, T, P) {
     // μ_per_atom(T, P) = μ°_per_atom(T) + k_B·T·ln(P/P₀) / num_atoms
     // The RT·ln(P) term must be divided by num_atoms to match PIRO's per-atom convention
     const num_atoms = GAS_NUM_ATOMS[gas];
-    return mu_standard +
-        (R_EV_PER_K * T * Math.log(effective_P / P_REF)) / num_atoms;
+    return mu_standard + (R_EV_PER_K * T * Math.log(effective_P / P_REF)) / num_atoms;
 }
 // Compute chemical potential per atom of a specific element from a gas
 // Since compute_gas_chemical_potential returns per-atom of gas molecule,

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

@@ -4,6 +4,14 @@ import type { ElementSymbol } from '../element';
 import type { ConvexHullConfig, GasAnalysis, GasThermodynamicsConfig, HighlightStyle, MarkerSymbol, PhaseData } from './types';
 import { DEFAULT_GAS_TEMP } from './types';
 export { DEFAULT_GAS_TEMP };
+export declare const HULL_STABILITY_TOL = 0.000001;
+export declare function compute_hull_stability(raw_distance: number, exclude_from_hull?: boolean, tol?: number): {
+    e_above_hull: number;
+    is_stable: boolean;
+};
+export declare const is_on_hull: (entry: PhaseData, tol?: number) => boolean;
+export declare const get_arity: (entry: PhaseData) => number;
+export declare const is_unary_entry: (entry: PhaseData) => boolean;
 export declare function get_energy_color_scale(color_mode: `stability` | `energy`, color_scale: D3InterpolateName, plot_entries: {
     e_above_hull?: number;
 }[]): ((value: number) => string) | null;
@@ -55,6 +63,7 @@ export interface PolymorphStats {
     lower: number;
     equal: number;
 }
+export declare function get_composition_label_entries<T extends PhaseData>(entries: Iterable<T>): T[];
 export declare function compute_all_polymorph_stats(all_entries: PhaseData[]): Map<string, PolymorphStats>;
 export declare function draw_highlight_effect(ctx: CanvasRenderingContext2D, projected: {
     x: number;