matterviz 0.3.7 → 0.4.1

package/dist/structure/export.d.ts

@@ -12,9 +12,29 @@ export declare function structure_to_xyz_str(structure?: AnyStructure): string;
 export declare function structure_to_cif_str(structure?: AnyStructure): string;
 export declare function structure_to_poscar_str(structure?: AnyStructure): string;
 export declare function structure_to_json_str(structure?: AnyStructure): string;
-export declare function export_structure_as_cif(structure?: AnyStructure): void;
-export declare function export_structure_as_poscar(structure?: AnyStructure): void;
-export declare function export_structure_as_xyz(structure?: AnyStructure): void;
-export declare function export_structure_as_json(structure?: AnyStructure): void;
+export declare const STRUCT_TEXT_FORMATS: {
+    readonly json: {
+        readonly to_str: typeof structure_to_json_str;
+        readonly ext: "json";
+        readonly mime: "application/json";
+    };
+    readonly xyz: {
+        readonly to_str: typeof structure_to_xyz_str;
+        readonly ext: "xyz";
+        readonly mime: "text/plain";
+    };
+    readonly cif: {
+        readonly to_str: typeof structure_to_cif_str;
+        readonly ext: "cif";
+        readonly mime: "chemical/x-cif";
+    };
+    readonly poscar: {
+        readonly to_str: typeof structure_to_poscar_str;
+        readonly ext: "poscar";
+        readonly mime: "text/plain";
+    };
+};
+export type StructTextFormat = keyof typeof STRUCT_TEXT_FORMATS;
+export declare function export_structure_as(fmt: StructTextFormat, structure?: AnyStructure): void;
 export declare function export_structure_as_glb(scene: Scene | null, structure: AnyStructure | undefined): void;
 export declare function export_structure_as_obj(scene: Scene | null, structure: AnyStructure | undefined): void;

package/dist/structure/export.js

@@ -1,11 +1,13 @@
 import { get_electro_neg_formula } from '../composition';
 import { download } from '../io/fetch';
 import * as math from '../math';
+import { is_plain_object } from '../utils';
 import { Color, Group, Matrix4, Mesh, MeshStandardMaterial, ShaderMaterial } from 'three';
 import { GLTFExporter } from 'three/examples/jsm/exporters/GLTFExporter.js';
 import { OBJExporter } from 'three/examples/jsm/exporters/OBJExporter.js';
-// Type guard to check if a material has a color property (duck typing for bundler compatibility)
-// Uses duck typing to work across different Three.js instances (Threlte vs vanilla Three.js)
+// @internal exported only for tests - not part of the public API.
+// Type guard to check if a material has a color property (duck typing for bundler
+// compatibility across different Three.js instances - Threlte vs vanilla Three.js).
 export function has_color_property(mat) {
     if (!(`color` in mat))
         return false;
@@ -47,8 +49,9 @@ function convert_shader_to_standard(shader_mat) {
     standard_mat.name = shader_mat.name || `converted_shader_material`;
     return standard_mat;
 }
-// Extract bond gradient colors from geometry attributes for a specific instance
-// Returns midpoint color between start and end colors for the bond
+// @internal exported only for tests - not part of the public API.
+// Extract bond gradient colors from geometry attributes for a specific instance.
+// Returns midpoint color between start and end colors for the bond.
 export function extract_bond_color_for_instance(geometry, instance_idx) {
     const color_start_attr = geometry.getAttribute(`instanceColorStart`);
     const color_end_attr = geometry.getAttribute(`instanceColorEnd`);
@@ -70,8 +73,10 @@ export function extract_bond_color_for_instance(geometry, instance_idx) {
     const [mid_r, mid_g, mid_b] = math.scale(math.add(start_rgb, end_rgb), 0.5);
     return new Color(mid_r, mid_g, mid_b);
 }
-// Remove custom/non-standard attributes from geometry that cause export issues
-// Standard GLTF attributes: position, normal, tangent, texcoord_N, color_N, joints_N, weights_N
+// @internal exported only for tests - not part of the public API.
+// Remove custom/non-standard attributes from geometry that cause export issues.
+// Standard GLTF attributes: position, normal, tangent, texcoord_N, color_N, joints_N,
+// weights_N.
 export function clean_geometry_for_export(geometry) {
     const standard_attrs = new Set([
         `position`,
@@ -98,7 +103,8 @@ export function clean_geometry_for_export(geometry) {
         geometry.deleteAttribute(attr_name);
     }
 }
-// Generate MTL (Wavefront Material) content from scene materials
+// @internal exported only for tests - not part of the public API.
+// Generate MTL (Wavefront Material) content from scene materials.
 export function generate_mtl_content(scene) {
     const lines = [`# MTL file generated by MatterViz`, ``];
     const processed_materials = new Set();
@@ -108,6 +114,7 @@ export function generate_mtl_content(scene) {
         const materials = Array.isArray(object.material) ? object.material : [object.material];
         for (const mat of materials) {
             // Skip if already processed or no name
+            // oxlint-disable-next-line @typescript-eslint/prefer-nullish-coalescing -- empty name should use default
             const mat_name = mat.name || `default_material`;
             if (processed_materials.has(mat_name))
                 continue;
@@ -294,10 +301,10 @@ function convert_instanced_meshes_to_regular(scene) {
 // Generate a filename for structure exports based on structure metadata
 // Sanitize string for use in filenames by removing problematic characters.
 const sanitize_filename_part = (text) => text
-    .replace(/<\/?[^>]+>/g, ``) // strip HTML tags
-    .replace(/[/\\:*?"<>|]/g, `_`) // replace filesystem-invalid chars
-    .replace(/_+/g, `_`) // condense consecutive underscores
-    .replace(/^_|_$/g, ``); // remove leading/trailing underscores
+    .replaceAll(/<\/?[^>]+>/g, ``) // strip HTML tags
+    .replaceAll(/[/\\:*?"<>|]/g, `_`) // replace filesystem-invalid chars
+    .replaceAll(/_+/g, `_`) // condense consecutive underscores
+    .replaceAll(/^_|_$/g, ``); // remove leading/trailing underscores
 export function create_structure_filename(structure, extension) {
     if (!structure)
         return `structure.${extension}`;
@@ -340,6 +347,17 @@ export function create_structure_filename(structure, extension) {
     const base_name = parts.length > 0 ? parts.join(`-`) : `structure`;
     return `${base_name}.${extension}`;
 }
+// First species' element of a site, or `X` when the site has no species
+const site_element = (site) => site.species?.[0]?.element || `X`;
+// Fractional coordinates from abc, falling back to converting xyz; throws when neither
+// is available. idx (when given) is included in the error message.
+function get_frac_coords(site, cart_to_frac, idx) {
+    if (Array.isArray(site.abc) && site.abc.length >= 3)
+        return site.abc.slice(0, 3);
+    if (site.xyz?.length >= 3 && cart_to_frac)
+        return cart_to_frac(site.xyz.slice(0, 3));
+    throw new Error(`No valid coordinates found for site${idx === undefined ? `` : ` ${idx}`}`);
+}
 // Generate XYZ content string without saving
 export function structure_to_xyz_str(structure) {
     if (!structure?.sites)
@@ -357,8 +375,7 @@ export function structure_to_xyz_str(structure) {
     // Include extended XYZ lattice information when available so round-trips preserve lattice
     if (`lattice` in structure && structure.lattice?.matrix?.length === 3) {
         const lattice_values = structure.lattice.matrix
-            .flat()
-            .map((value) => (Number.isFinite(value) ? value : 0).toFixed(8))
+            .flatMap((row) => row.map((value) => (Number.isFinite(value) ? value : 0).toFixed(8)))
             .join(` `);
         comment_parts.push(`Lattice="${lattice_values}"`);
     }
@@ -370,14 +387,7 @@ export function structure_to_xyz_str(structure) {
         : null;
     // Atom lines: element symbol followed by x, y, z coordinates
     for (const site of structure.sites) {
-        // Extract element symbol from species
-        let element_symbol = `X`; // default fallback
-        if (site.species && Array.isArray(site.species) && site.species.length > 0) {
-            // species is an array of Species objects with element property
-            const first_species = site.species[0];
-            if (first_species && `element` in first_species && first_species.element)
-                element_symbol = first_species.element;
-        }
+        const element_symbol = site_element(site);
         // Get coordinates - prefer xyz; fallback to abc (converted to cartesian if lattice available)
         let coords;
         if (site.xyz && Array.isArray(site.xyz) && site.xyz.length >= 3) {
@@ -432,7 +442,7 @@ function get_cif_block_name(structure) {
         if (structure.id) {
             // Remove invalid CIF characters (keep alphanumerics and underscores)
             // and condense consecutive underscores for cleaner block names
-            return structure.id.replace(/[^a-zA-Z0-9_]/g, `_`).replace(/_+/g, `_`);
+            return structure.id.replaceAll(/[^a-zA-Z0-9_]/g, `_`).replaceAll(/_+/g, `_`);
         }
         return `structure`;
     }
@@ -463,13 +473,11 @@ export function structure_to_cif_str(structure) {
         lines.push(`_cell_angle_gamma ${lattice.gamma.toFixed(6)}`);
     }
     // Space group information
-    if (`symmetry` in structure &&
-        structure.symmetry &&
-        typeof structure.symmetry === `object`) {
-        const symmetry = structure.symmetry;
-        const { space_group_number, space_group_symbol } = symmetry;
+    if (`symmetry` in structure && is_plain_object(structure.symmetry)) {
+        const { space_group_number, space_group_symbol } = structure.symmetry;
         if (typeof space_group_symbol === `string` && space_group_symbol) {
-            lines.push(`_space_group_name_H-M_alt ${space_group_symbol}`);
+            // Quote H-M symbols: their spaces (e.g. 'F m -3 m') would break CIF tokenization
+            lines.push(`_space_group_name_H-M_alt '${space_group_symbol}'`);
         }
         if ((typeof space_group_number === `number` || typeof space_group_number === `string`) &&
             space_group_number) {
@@ -477,6 +485,9 @@ export function structure_to_cif_str(structure) {
         }
     }
     lines.push(``);
+    // Explicit identity-only symmetry-ops loop (like pymatgen's CifWriter): sites are the
+    // full P1 list, so without it parsers would re-apply the H-M ops and multiply sites
+    lines.push(`loop_`, `_symmetry_equiv_pos_as_xyz`, `  'x, y, z'`, ``);
     // Atom site loop header
     lines.push(`loop_`);
     lines.push(`_atom_site_label`);
@@ -487,34 +498,24 @@ export function structure_to_cif_str(structure) {
     lines.push(`_atom_site_occupancy`);
     // Cache inverse transpose for Cartesian→fractional conversion (avoids recomputing per site)
     const cart_to_frac = lattice.matrix?.length === 3 ? math.create_cart_to_frac(lattice.matrix) : null;
-    // Atom sites
+    // Atom sites: one row per species entry so disordered (multi-species) sites
+    // keep every component with its own occupancy instead of only species[0]
     for (let idx = 0; idx < structure.sites.length; idx++) {
         const site = structure.sites[idx];
         if (!site)
             continue; // Skip if site is undefined
-        // Extract element symbol from species
-        let element_symbol = `X`; // default fallback
-        let occupancy = 1;
-        if (site.species && Array.isArray(site.species) && site.species.length > 0) {
-            const first_species = site.species[0];
-            if (first_species && `element` in first_species && first_species.element) {
-                element_symbol = first_species.element;
-                occupancy = first_species?.occu ?? 1;
-            }
+        const frac_coords = get_frac_coords(site, cart_to_frac, idx);
+        const coords_str = frac_coords.map((coord) => coord.toFixed(8)).join(` `);
+        const species_list = site.species?.length ? site.species : [{ element: `X`, occu: 1 }];
+        for (const [spec_idx, species] of species_list.entries()) {
+            const elem = species?.element || `X`;
+            // Row format: label element x y z occupancy. Labels must be unique per row,
+            // so disordered sites get a per-species suffix.
+            const label = species_list.length > 1
+                ? `${elem}${idx + 1}_${spec_idx}`
+                : site.label || `${elem}${idx + 1}`;
+            lines.push(`${label} ${elem} ${coords_str} ${(species?.occu ?? 1).toFixed(8)}`);
         }
-        // Get fractional coordinates
-        let frac_coords;
-        if (site.abc && Array.isArray(site.abc) && site.abc.length >= 3) {
-            frac_coords = site.abc.slice(0, 3);
-        }
-        else if (site.xyz?.length >= 3 && cart_to_frac) {
-            frac_coords = cart_to_frac(site.xyz);
-        }
-        else
-            throw new Error(`No valid coordinates found for site ${idx}`);
-        // Format: label element_symbol x y z
-        const label = site.label || `${element_symbol}${idx + 1}`;
-        lines.push(`${label} ${element_symbol} ${frac_coords[0].toFixed(8)} ${frac_coords[1].toFixed(8)} ${frac_coords[2].toFixed(8)} ${occupancy.toFixed(8)}`);
     }
     return lines.join(`\n`);
 }
@@ -528,8 +529,8 @@ export function structure_to_poscar_str(structure) {
     const lines = [];
     // Use plain text formula for POSCAR title to avoid HTML tags
     const formula = get_electro_neg_formula(structure, true);
-    const title = structure.id ||
-        (formula && formula !== `Unknown` ? formula : null) ||
+    const title = structure.id || // oxlint-disable-line @typescript-eslint/prefer-nullish-coalescing -- first non-empty string
+        (formula && formula !== `Unknown` ? formula : null) || // oxlint-disable-line @typescript-eslint/prefer-nullish-coalescing -- first non-empty string
         `Generated from structure`;
     lines.push(title);
     lines.push(`1.0`); // Scale factor (1.0 for direct coordinates)
@@ -544,27 +545,20 @@ export function structure_to_poscar_str(structure) {
     else {
         throw new Error(`No valid lattice matrix for POSCAR export`);
     }
-    // Count atoms by element
-    const element_counts = new Map();
-    const element_symbols = [];
+    // Group sites by element in one pass, preserving first-appearance element order
+    const sites_by_element = new Map();
     for (const site of structure.sites) {
-        let element_symbol = `X`; // default fallback
-        if (site.species && Array.isArray(site.species) && site.species.length > 0) {
-            const first_species = site.species[0];
-            if (first_species && `element` in first_species && first_species.element) {
-                element_symbol = first_species.element;
-            }
-        }
-        if (!element_counts.has(element_symbol)) {
-            element_counts.set(element_symbol, 0);
-            element_symbols.push(element_symbol);
-        }
-        element_counts.set(element_symbol, Number(element_counts.get(element_symbol)) + 1);
+        const element_symbol = site_element(site);
+        const group = sites_by_element.get(element_symbol);
+        if (group)
+            group.push(site);
+        else
+            sites_by_element.set(element_symbol, [site]);
     }
     // Element symbols line
-    lines.push(element_symbols.join(` `));
+    lines.push([...sites_by_element.keys()].join(` `));
     // Atom counts line
-    lines.push(element_symbols.map((el) => element_counts.get(el)).join(` `));
+    lines.push([...sites_by_element.values()].map((group) => group.length).join(` `));
     // Check if any site has selective dynamics
     const has_selective_dynamics = structure.sites.some((site) => site.properties?.selective_dynamics);
     if (has_selective_dynamics) {
@@ -575,38 +569,19 @@ export function structure_to_poscar_str(structure) {
     // Cache inverse transpose for Cartesian→fractional conversion (avoids recomputing per site)
     const cart_to_frac = lattice.matrix?.length === 3 ? math.create_cart_to_frac(lattice.matrix) : null;
     // Atom coordinates grouped by element
-    for (const element_symbol of element_symbols) {
-        for (const site of structure.sites) {
-            let site_element = `X`;
-            if (site.species && Array.isArray(site.species) && site.species.length > 0) {
-                const first_species = site.species[0];
-                if (first_species && `element` in first_species && first_species.element) {
-                    site_element = first_species.element;
-                }
-            }
-            if (site_element === element_symbol) {
-                // Get fractional coordinates
-                let frac_coords;
-                if (site.abc && Array.isArray(site.abc) && site.abc.length >= 3) {
-                    frac_coords = site.abc.slice(0, 3);
-                }
-                else if (site.xyz?.length >= 3 && cart_to_frac) {
-                    frac_coords = cart_to_frac(site.xyz.slice(0, 3));
-                }
-                else {
-                    throw new Error(`No valid coordinates found for site`);
-                }
-                let selective_dynamics_str = ``;
-                if (has_selective_dynamics) {
-                    const sel_dyn = (site.properties?.selective_dynamics ?? [
-                        true,
-                        true,
-                        true,
-                    ]);
-                    selective_dynamics_str = ` ${sel_dyn[0] ? `T` : `F`} ${sel_dyn[1] ? `T` : `F`} ${sel_dyn[2] ? `T` : `F`}`;
-                }
-                lines.push(`${frac_coords[0].toFixed(8)} ${frac_coords[1].toFixed(8)} ${frac_coords[2].toFixed(8)}${selective_dynamics_str}`);
+    for (const group of sites_by_element.values()) {
+        for (const site of group) {
+            const frac_coords = get_frac_coords(site, cart_to_frac);
+            let selective_dynamics_str = ``;
+            if (has_selective_dynamics) {
+                const sel_dyn = (site.properties?.selective_dynamics ?? [
+                    true,
+                    true,
+                    true,
+                ]);
+                selective_dynamics_str = ` ${sel_dyn[0] ? `T` : `F`} ${sel_dyn[1] ? `T` : `F`} ${sel_dyn[2] ? `T` : `F`}`;
             }
+            lines.push(`${frac_coords[0].toFixed(8)} ${frac_coords[1].toFixed(8)} ${frac_coords[2].toFixed(8)}${selective_dynamics_str}`);
         }
     }
     return lines.join(`\n`);
@@ -617,51 +592,22 @@ export function structure_to_json_str(structure) {
         throw new Error(`No structure to export`);
     return JSON.stringify(structure, null, 2);
 }
-// Export structure as CIF format
-export function export_structure_as_cif(structure) {
-    try {
-        const content = structure_to_cif_str(structure);
-        const filename = create_structure_filename(structure, `cif`);
-        download(content, filename, `chemical/x-cif`);
-    }
-    catch (error) {
-        console.error(`Failed to export CIF:`, error);
-    }
-}
-// Export structure as VASP POSCAR format
-export function export_structure_as_poscar(structure) {
-    try {
-        const content = structure_to_poscar_str(structure);
-        const filename = create_structure_filename(structure, `poscar`);
-        download(content, filename, `text/plain`);
-    }
-    catch (error) {
-        console.error(`Failed to export POSCAR:`, error);
-    }
-}
-// Export structure as XYZ format. Format specification:
-// - Line 1: Number of atoms
-// - Line 2: Comment line (structure ID, formula, etc.)
-// - Remaining lines: Element symbol followed by x, y, z coordinates (in Angstrom)
-export function export_structure_as_xyz(structure) {
-    try {
-        const xyz_content = structure_to_xyz_str(structure);
-        const filename = create_structure_filename(structure, `xyz`);
-        download(xyz_content, filename, `text/plain`);
-    }
-    catch (error) {
-        console.error(`Error exporting XYZ:`, error);
-    }
-}
-// Export structure in pymatgen JSON format
-export function export_structure_as_json(structure) {
+// Text export formats: serializer + file extension + MIME type per format
+export const STRUCT_TEXT_FORMATS = {
+    json: { to_str: structure_to_json_str, ext: `json`, mime: `application/json` },
+    xyz: { to_str: structure_to_xyz_str, ext: `xyz`, mime: `text/plain` },
+    cif: { to_str: structure_to_cif_str, ext: `cif`, mime: `chemical/x-cif` },
+    poscar: { to_str: structure_to_poscar_str, ext: `poscar`, mime: `text/plain` },
+};
+// Serialize structure in the given text format and trigger a browser download
+export function export_structure_as(fmt, structure) {
+    const { to_str, ext, mime } = STRUCT_TEXT_FORMATS[fmt];
     try {
-        const data = structure_to_json_str(structure);
-        const filename = create_structure_filename(structure, `json`);
-        download(data, filename, `application/json`);
+        const content = to_str(structure);
+        download(content, create_structure_filename(structure, ext), mime);
     }
     catch (error) {
-        console.error(`Error exporting JSON:`, error);
+        console.error(`Failed to export ${fmt.toUpperCase()}:`, error);
     }
 }
 // Export Three.js scene as GLB (binary GLTF) file

package/dist/structure/index.d.ts

@@ -15,6 +15,8 @@ export { default as CanvasTooltip } from './CanvasTooltip.svelte';
 export { default as Cylinder } from './Cylinder.svelte';
 export { default as Lattice } from './Lattice.svelte';
 export * from './pbc';
+export * from './polyhedra';
+export * from './site';
 export { default as Structure } from './Structure.svelte';
 export { default as StructureControls } from './StructureControls.svelte';
 export { default as StructureExportPane } from './StructureExportPane.svelte';
@@ -36,9 +38,7 @@ export type Site = {
     properties: Record<string, unknown>;
 };
 export declare const LATTICE_PARAM_KEYS: readonly ["a", "b", "c", "alpha", "beta", "gamma"];
-export type LatticeParams = {
-    [key in (typeof LATTICE_PARAM_KEYS)[number]]: number;
-};
+export type LatticeParams = Record<(typeof LATTICE_PARAM_KEYS)[number], number>;
 export type LatticeType = {
     matrix: math.Matrix3x3;
     pbc: Pbc;
@@ -84,7 +84,7 @@ export declare const atomic_radii: CompositionType;
 export declare function get_density(structure: Crystal): number;
 export declare function get_center_of_mass(structure: AnyStructure): Vec3;
 export declare const VECTOR_KEY_PREFIXES: readonly ["force", "forces", "magmom", "magmoms", "spin", "spins"];
-export declare function is_vector_key(key: string): boolean;
+export declare const is_vector_key: (key: string) => boolean;
 export declare const VECTOR_PALETTE: readonly ["#e74c3c", "#3498db", "#2ecc71", "#f39c12", "#9b59b6", "#1abc9c"];
 export declare const default_vector_configs: (keys: string[]) => {
     [k: string]: {

package/dist/structure/index.js

@@ -10,6 +10,8 @@ export { default as CanvasTooltip } from './CanvasTooltip.svelte';
 export { default as Cylinder } from './Cylinder.svelte';
 export { default as Lattice } from './Lattice.svelte';
 export * from './pbc';
+export * from './polyhedra';
+export * from './site';
 export { default as Structure } from './Structure.svelte';
 export { default as StructureControls } from './StructureControls.svelte';
 export { default as StructureExportPane } from './StructureExportPane.svelte';
@@ -94,9 +96,7 @@ export const VECTOR_KEY_PREFIXES = [
     `spin`,
     `spins`,
 ];
-export function is_vector_key(key) {
-    return VECTOR_KEY_PREFIXES.some((prefix) => key === prefix || key.startsWith(`${prefix}_`));
-}
+export const is_vector_key = (key) => VECTOR_KEY_PREFIXES.some((prefix) => key === prefix || key.startsWith(`${prefix}_`));
 // Default color palette for distinguishing multiple vector layers
 export const VECTOR_PALETTE = [
     `#e74c3c`,

package/dist/structure/measure.d.ts

@@ -1,6 +1,7 @@
 import type { LatticeConverters, Matrix3x3, Vec3 } from '../math';
+import type { Pbc } from './pbc';
 export type AngleMode = `degrees` | `radians`;
 export declare const MAX_SELECTED_SITES = 8;
-export declare function displacement_pbc(from: Vec3, to: Vec3, lattice_matrix: Matrix3x3 | null | undefined, converters?: LatticeConverters): Vec3;
-export declare function distance_pbc(a: Vec3, b: Vec3, lattice_matrix: Matrix3x3): number;
+export declare function displacement_pbc(from: Vec3, to: Vec3, lattice_matrix: Matrix3x3 | null | undefined, converters?: LatticeConverters, pbc?: Pbc): Vec3;
+export declare function distance_pbc(a: Vec3, b: Vec3, lattice_matrix: Matrix3x3, converters?: LatticeConverters, pbc?: Pbc): number;
 export declare function angle_between_vectors(v1: Vec3, v2: Vec3, mode?: AngleMode): number;

package/dist/structure/measure.js

@@ -2,14 +2,15 @@
 import { min_image_displacement, subtract } from '../math';
 export const MAX_SELECTED_SITES = 8;
 // Calculate minimum image displacement between two points under PBC
-// If lattice_matrix is null/undefined, returns Euclidean displacement
-export function displacement_pbc(from, to, lattice_matrix, converters) {
+// If lattice_matrix is null/undefined, returns Euclidean displacement.
+// pbc flags disable wrapping along non-periodic axes (e.g. slab vacuum directions).
+export function displacement_pbc(from, to, lattice_matrix, converters, pbc) {
     if (!lattice_matrix)
         return subtract(to, from);
-    return min_image_displacement(from, to, lattice_matrix, converters);
+    return min_image_displacement(from, to, lattice_matrix, converters, pbc);
 }
-export function distance_pbc(a, b, lattice_matrix) {
-    const [dx, dy, dz] = displacement_pbc(a, b, lattice_matrix);
+export function distance_pbc(a, b, lattice_matrix, converters, pbc) {
+    const [dx, dy, dz] = displacement_pbc(a, b, lattice_matrix, converters, pbc);
     return Math.hypot(dx, dy, dz);
 }
 export function angle_between_vectors(v1, v2, mode = `degrees`) {

package/dist/structure/parse.d.ts

@@ -54,9 +54,10 @@ export declare function parse_xyz(content: string): ParsedStructure | null;
 export declare function parse_cif(content: string, wrap_fractional_coords?: boolean, strict?: boolean): ParsedStructure | null;
 export type CellType = `primitive_cell` | `unit_cell` | `supercell` | `phonon_primitive_cell` | `phonon_supercell` | `auto`;
 export declare function parse_phonopy_yaml(content: string, cell_type?: CellType): ParsedStructure | null;
+export declare function is_parsed_structure(obj: unknown): obj is ParsedStructure;
 export declare function normalize_fractional_coords(structure: ParsedStructure): ParsedStructure;
-export declare function parse_structure_file(content: string, filename?: string): ParsedStructure | null;
-export declare function parse_any_structure(content: string, filename: string): AnyStructure | null;
+export declare function parse_structure_file(content: string, filename?: string): ParsedStructure;
+export declare function parse_any_structure(content: string, filename: string): AnyStructure;
 export declare function parse_optimade_json(content: string): ParsedStructure | null;
 export declare function parse_optimade_from_raw(raw: unknown): ParsedStructure | null;
 export declare function is_optimade_json(content: string): boolean;