matterviz 0.4.0 → 0.4.2

package/dist/fermi-surface/marching-cubes.d.ts

@@ -1,2 +0,0 @@
-export { compute_vertex_normals, marching_cubes } from '../marching-cubes';
-export type { MarchingCubesOptions, MarchingCubesResult } from '../marching-cubes';

package/dist/fermi-surface/marching-cubes.js

@@ -1,2 +0,0 @@
-// Re-export from shared location for backward compatibility
-export { compute_vertex_normals, marching_cubes } from '../marching-cubes';

package/dist/plot/core/hover-lock.svelte.d.ts

@@ -1,14 +0,0 @@
-export declare const HOVER_DEBOUNCE_MS = 300;
-interface ReactiveBoolean {
-    readonly current: boolean;
-}
-export declare function create_hover_lock(): {
-    is_locked: ReactiveBoolean;
-    set_locked: (locked: boolean) => void;
-    cleanup: () => void;
-};
-export declare function create_dimension_tracker(): {
-    has_changed: (width: number, height: number) => boolean;
-    update: (width: number, height: number) => void;
-};
-export {};

package/dist/plot/core/hover-lock.svelte.js

@@ -1,45 +0,0 @@
-// Shared utility for hover lock behavior on plot elements (legend, colorbar)
-// Prevents element repositioning while user is hovering, with debounced release
-export const HOVER_DEBOUNCE_MS = 300;
-// Creates hover lock state and handlers for a plot element
-export function create_hover_lock() {
-    let is_locked = $state(false);
-    let timeout = null;
-    // Stable object reference with getter - Svelte tracks the getter read
-    const locked_ref = {
-        get current() {
-            return is_locked;
-        },
-    };
-    return {
-        is_locked: locked_ref,
-        set_locked(locked) {
-            // Always clear any pending unlock so rapid calls don't queue multiple timeouts
-            if (timeout)
-                clearTimeout(timeout);
-            if (locked)
-                is_locked = true;
-            else
-                timeout = setTimeout(() => (is_locked = false), HOVER_DEBOUNCE_MS);
-        },
-        // Clear pending timeout to prevent state updates after unmount
-        cleanup() {
-            if (timeout)
-                clearTimeout(timeout);
-        },
-    };
-}
-// Tracks previous dimensions for resize detection
-export function create_dimension_tracker() {
-    let prev = $state(null);
-    return {
-        has_changed(width, height) {
-            if (!prev)
-                return true;
-            return prev.width !== width || prev.height !== height;
-        },
-        update(width, height) {
-            prev = { width, height };
-        },
-    };
-}

package/dist/plot/sunburst/SunburstControls.svelte

@@ -1,200 +0,0 @@
-<script lang="ts">
-  import { SettingsSection } from '../../layout'
-  import type {
-    SunburstLabelRotation,
-    SunburstLabelText,
-    SunburstShape,
-    SunburstValueMode,
-  } from '..'
-  import { DEFAULTS, SETTINGS_CONFIG } from '../../settings'
-  import type { Snippet } from 'svelte'
-  import type { HTMLAttributes } from 'svelte/elements'
-  import ControlPane from '../core/components/ControlPane.svelte'
-
-  let {
-    show_controls = $bindable(true),
-    controls_open = $bindable(false),
-    shape = $bindable(DEFAULTS.sunburst.shape),
-    value_mode = $bindable(DEFAULTS.sunburst.value_mode),
-    max_depth = $bindable(DEFAULTS.sunburst.max_depth),
-    inner_radius = $bindable(DEFAULTS.sunburst.inner_radius),
-    pad_angle = $bindable(DEFAULTS.sunburst.pad_angle),
-    min_fraction = $bindable(DEFAULTS.sunburst.min_fraction),
-    show_labels = $bindable(DEFAULTS.sunburst.show_labels),
-    label_rotation = $bindable(DEFAULTS.sunburst.label_rotation),
-    label_text = $bindable(DEFAULTS.sunburst.label_text),
-    zoom_on_click = $bindable(DEFAULTS.sunburst.zoom_on_click),
-    show_breadcrumbs = $bindable(DEFAULTS.sunburst.show_breadcrumbs),
-    export_buttons = true,
-    on_export,
-    toggle_props = {},
-    pane_props = {},
-    children,
-  }: {
-    show_controls?: boolean
-    controls_open?: boolean
-    shape?: SunburstShape
-    value_mode?: SunburstValueMode
-    max_depth?: number
-    inner_radius?: number
-    pad_angle?: number
-    min_fraction?: number
-    show_labels?: boolean
-    label_rotation?: SunburstLabelRotation
-    label_text?: SunburstLabelText
-    zoom_on_click?: boolean
-    show_breadcrumbs?: boolean
-    export_buttons?: boolean // show SVG/PNG download buttons in the pane
-    on_export?: (format: `svg` | `png`) => void
-    toggle_props?: HTMLAttributes<HTMLButtonElement>
-    pane_props?: HTMLAttributes<HTMLDivElement>
-    children?: Snippet
-  } = $props()
-</script>
-
-{#if show_controls}
-  <!-- snippets live at the template top level (not inside the components below) so
-  they're locally renderable rather than treated as ControlPane/SettingsSection props -->
-  {#snippet options(enum_map: Record<string, string>)}
-    {#each Object.entries(enum_map) as [value, label] (value)}
-      <option {value}>{label}</option>
-    {/each}
-  {/snippet}
-  {#snippet num_row(
-    text: string,
-    [min, max, step]: [number, number, number],
-    get: () => number,
-    set: (val: number) => void,
-  )}
-    <label style="flex: 1 1 100%">
-      {text}
-      <input type="range" {min} {max} {step} bind:value={get, set} />
-      <input type="number" {min} {max} {step} bind:value={get, set} />
-    </label>
-  {/snippet}
-  {#snippet check_row(text: string, get: () => boolean, set: (val: boolean) => void)}
-    <label style="flex: 1 1 100%">
-      <input type="checkbox" bind:checked={get, set} />
-      {text}
-    </label>
-  {/snippet}
-  <ControlPane bind:controls_open controls_class="sunburst" {toggle_props} {pane_props}>
-    {@render children?.()}
-    <SettingsSection
-      title="Sunburst"
-      current_values={{
-        shape,
-        value_mode,
-        max_depth,
-        inner_radius,
-        pad_angle,
-        min_fraction,
-        show_labels,
-        label_rotation,
-        label_text,
-        zoom_on_click,
-        show_breadcrumbs,
-      }}
-      on_reset={() => {
-        ;({
-          shape,
-          value_mode,
-          max_depth,
-          inner_radius,
-          pad_angle,
-          min_fraction,
-          show_labels,
-          label_rotation,
-          label_text,
-          zoom_on_click,
-          show_breadcrumbs,
-        } = DEFAULTS.sunburst)
-      }}
-      style="display: flex; flex-wrap: wrap; gap: 2ex"
-    >
-      <!-- select options come from the settings schema so labels/values have a
-      single source of truth -->
-      <label style="flex: 1">
-        Shape:
-        <select bind:value={shape}>
-          {@render options(SETTINGS_CONFIG.sunburst.shape.enum ?? {})}
-        </select>
-      </label>
-      <label style="flex: 1">
-        Value mode:
-        <select bind:value={value_mode}>
-          {@render options(SETTINGS_CONFIG.sunburst.value_mode.enum ?? {})}
-        </select>
-      </label>
-      {#if shape === `sunburst`}
-        <!-- icicle labels are always horizontal; inner radius/pad angle are polar-only -->
-        <label style="flex: 1">
-          Labels:
-          <select bind:value={label_rotation}>
-            {@render options(SETTINGS_CONFIG.sunburst.label_rotation.enum ?? {})}
-          </select>
-        </label>
-      {/if}
-      <label style="flex: 1">
-        Label text:
-        <select bind:value={label_text}>
-          {@render options(SETTINGS_CONFIG.sunburst.label_text.enum ?? {})}
-        </select>
-      </label>
-      {@render num_row(`Max depth (0 = all):`, [0, 10, 1], () => max_depth, (val) =>
-        max_depth = val)}
-      {#if shape === `sunburst`}
-        {@render num_row(`Inner radius:`, [0, 0.8, 0.05], () => inner_radius, (val) =>
-          inner_radius = val)}
-        {@render num_row(`Pad angle (°):`, [0, 4, 0.1], () => pad_angle, (val) =>
-          pad_angle = val)}
-      {/if}
-      {@render num_row(
-        `Group slices below (fraction of total):`,
-        [0, 0.2, 0.005],
-        () => min_fraction,
-        (val) => min_fraction = val,
-      )}
-      {@render check_row(`Show arc labels`, () => show_labels, (val) =>
-        show_labels = val)}
-      {@render check_row(`Zoom on click`, () => zoom_on_click, (val) =>
-        zoom_on_click = val)}
-      {@render check_row(`Show breadcrumbs when zoomed`, () => show_breadcrumbs, (val) =>
-        show_breadcrumbs = val)}
-    </SettingsSection>
-    {#if export_buttons && on_export}
-      <div class="export-row">
-        Export:
-        {#each [`svg`, `png`] as const as fmt (fmt)}
-          <button
-            type="button"
-            class="export-btn"
-            aria-label="Download {fmt.toUpperCase()}"
-            onclick={() => on_export?.(fmt)}
-          >{fmt.toUpperCase()}</button>
-        {/each}
-      </div>
-    {/if}
-  </ControlPane>
-{/if}
-
-<style>
-  .export-row {
-    display: flex;
-    align-items: center;
-    gap: 6px;
-    margin-top: 6px;
-    font-size: 0.85em;
-  }
-  .export-btn {
-    background: var(--sunburst-btn-bg, rgba(128, 128, 128, 0.15));
-    color: inherit;
-    border: none;
-    border-radius: 3pt;
-    padding: 1px 6px;
-    cursor: pointer;
-  }
-  .export-btn:hover {
-    background: var(--sunburst-btn-hover-bg, rgba(128, 128, 128, 0.35));
-  }
-</style>

package/dist/structure/label-placement.d.ts

@@ -1,14 +0,0 @@
-import type { Vec3 } from '../math';
-import type { Camera, Object3D } from 'three';
-export declare const LABEL_OFFSET_EPS = 1e-9;
-type LabelOffsetSource = Vec3 | (() => Vec3);
-export declare const choose_site_label_offset: (bond_directions: Vec3[], base_offset: Vec3) => Vec3;
-export declare const label_screen_position: (atom_position: Vec3, label_offset: Vec3, visual_radius: number, label_screen_margin: number, label_camera: Camera, size: {
-    width: number;
-    height: number;
-}) => [number, number];
-export declare const make_label_position_calculator: (_atom_position: Vec3, label_offset: LabelOffsetSource, visual_radius: number, label_screen_margin: number) => (object: Object3D, label_camera: Camera, size: {
-    width: number;
-    height: number;
-}) => [number, number];
-export {};

package/dist/structure/label-placement.js

@@ -1,72 +0,0 @@
-import * as math from '../math';
-import { Vector3 } from 'three';
-export const LABEL_OFFSET_EPS = 1e-9;
-const LABEL_OFFSET_DIRECTIONS = [
-    [0, -1, 0],
-    [1, 0, 0],
-    [-1, 0, 0],
-    [1, 1, 0],
-    [-1, 1, 0],
-    [1, -1, 0],
-    [-1, -1, 0],
-    [0, 0, 1],
-    [0, 0, -1],
-];
-const label_direction_score = (direction, bond_directions, preferred_direction) => {
-    let max_bond_alignment = 0;
-    for (const bond_direction of bond_directions) {
-        max_bond_alignment = Math.max(max_bond_alignment, Math.max(0, math.dot(direction, bond_direction)));
-    }
-    const preferred_bonus = Math.max(0, math.dot(direction, preferred_direction)) * 0.05;
-    const screen_plane_bonus = Math.abs(direction[2]) < LABEL_OFFSET_EPS ? 0.02 : 0;
-    return -max_bond_alignment + preferred_bonus + screen_plane_bonus;
-};
-export const choose_site_label_offset = (bond_directions, base_offset) => {
-    const offset_length = Math.hypot(...base_offset);
-    if (offset_length < LABEL_OFFSET_EPS || bond_directions.length === 0) {
-        return base_offset;
-    }
-    const preferred_direction = math.normalize_vec(base_offset, [0, 1, 0]);
-    const repulsion_direction = math.normalize_vec(bond_directions.reduce((offset_sum, bond_direction) => math.subtract(offset_sum, bond_direction), [0, 0, 0]), preferred_direction);
-    let best_direction = preferred_direction;
-    let best_score = -Infinity;
-    for (const candidate_direction of [
-        preferred_direction,
-        repulsion_direction,
-        ...LABEL_OFFSET_DIRECTIONS,
-    ]) {
-        const direction = math.normalize_vec(candidate_direction, preferred_direction);
-        const score = label_direction_score(direction, bond_directions, preferred_direction);
-        if (score <= best_score + LABEL_OFFSET_EPS)
-            continue;
-        best_score = score;
-        best_direction = direction;
-    }
-    return math.scale(best_direction, offset_length);
-};
-const project_to_screen = (position, label_camera, size) => {
-    const projected = new Vector3(...position).project(label_camera);
-    return [
-        (projected.x * size.width) / 2 + size.width / 2,
-        (-projected.y * size.height) / 2 + size.height / 2,
-    ];
-};
-export const label_screen_position = (atom_position, label_offset, visual_radius, label_screen_margin, label_camera, size) => {
-    const atom_screen = project_to_screen(atom_position, label_camera, size);
-    const offset_screen = project_to_screen(math.add(atom_position, label_offset), label_camera, size);
-    const offset_x = offset_screen[0] - atom_screen[0];
-    const offset_y = offset_screen[1] - atom_screen[1];
-    const offset_length = Math.hypot(offset_x, offset_y);
-    const direction_x = offset_length > LABEL_OFFSET_EPS ? offset_x / offset_length : 0;
-    const direction_y = offset_length > LABEL_OFFSET_EPS ? offset_y / offset_length : label_offset[1] >= 0 ? -1 : 1;
-    const radius_direction = math.normalize_vec(label_offset, [0, 1, 0]);
-    const radius_edge = math.add(atom_position, math.scale(radius_direction, visual_radius));
-    const radius_screen = project_to_screen(radius_edge, label_camera, size);
-    const atom_screen_radius = Math.hypot(radius_screen[0] - atom_screen[0], radius_screen[1] - atom_screen[1]);
-    const screen_gap = atom_screen_radius + label_screen_margin;
-    return [atom_screen[0] + direction_x * screen_gap, atom_screen[1] + direction_y * screen_gap];
-};
-export const make_label_position_calculator = (_atom_position, label_offset, visual_radius, label_screen_margin) => (object, label_camera, size) => {
-    const world_position = object.getWorldPosition(new Vector3());
-    return label_screen_position([world_position.x, world_position.y, world_position.z], typeof label_offset === `function` ? label_offset() : label_offset, visual_radius, label_screen_margin, label_camera, size);
-};