matterviz 0.4.0 → 0.4.1

package/dist/plot/scatter/ScatterPlot.svelte.d.ts

@@ -1,10 +1,10 @@
-import type { D3ColorSchemeName, D3InterpolateName } from '../../colors';
+import type { D3InterpolateName } from '../../colors';
 import type { Point2D } from '../../math';
-import type { AxisLoadError, BasePlotProps, ControlsConfig, DataLoaderFn, DataSeries, ErrorBand, FillHandlerEvent, FillRegion, HoverConfig, InternalPoint, LabelPlacementConfig, LegendConfig, PanConfig, PlotConfig, Point, RefLine, RefLineEvent, ScaleType, ScatterHandlerEvent, ScatterHandlerProps, StyleOverrides, UserContentProps } from '..';
+import type { AxisLoadError, BasePlotProps, ColorScaleConfig, ControlsConfig, DataLoaderFn, DataSeries, ErrorBand, FillHandlerEvent, FillRegion, HoverConfig, InternalPoint, LabelPlacementConfig, LegendConfig, PanConfig, PlotConfig, Point, RefLine, RefLineEvent, ScatterHandlerEvent, ScatterHandlerProps, SizeScaleConfig, StyleOverrides, UserContentProps } from '..';
 import { ColorBar } from '..';
 import type { ComponentProps, Snippet } from 'svelte';
 import type { HTMLAttributes } from 'svelte/elements';
-import { type TweenOptions } from 'svelte/motion';
+import type { TweenOptions } from 'svelte/motion';
 import type { Sides } from '../core/layout';
 declare function $$render<Metadata extends Record<string, unknown> = Record<string, unknown>>(): {
     props: HTMLAttributes<HTMLDivElement> & Omit<BasePlotProps, "change"> & PlotConfig & {
@@ -31,16 +31,8 @@ declare function $$render<Metadata extends Record<string, unknown> = Record<stri
         change?: (data: (Point<Metadata> & {
             series: DataSeries<Metadata>;
         }) | null) => void;
-        color_scale?: {
-            type?: ScaleType;
-            scheme?: D3ColorSchemeName | D3InterpolateName;
-            value_range?: [number, number];
-        } | D3InterpolateName;
-        size_scale?: {
-            type?: ScaleType;
-            radius_range?: [number, number];
-            value_range?: [number, number];
-        };
+        color_scale?: ColorScaleConfig | D3InterpolateName;
+        size_scale?: SizeScaleConfig;
         color_bar?: (ComponentProps<typeof ColorBar> & {
             margin?: number | Sides;
             tween?: TweenOptions<Point2D>;
@@ -73,7 +65,7 @@ declare function $$render<Metadata extends Record<string, unknown> = Record<stri
         pan?: PanConfig;
     };
     exports: {};
-    bindings: "display" | "fullscreen" | "series" | "hovered" | "ref_lines" | "x_axis" | "y_axis" | "x2_axis" | "y2_axis" | "wrapper" | "tooltip_point" | "fill_regions" | "selected_series_idx";
+    bindings: "display" | "x2_axis" | "y_axis" | "y2_axis" | "fullscreen" | "wrapper" | "series" | "hovered" | "ref_lines" | "x_axis" | "tooltip_point" | "fill_regions" | "selected_series_idx";
     slots: {};
     events: {};
 };
@@ -81,7 +73,7 @@ declare class __sveltets_Render<Metadata extends Record<string, unknown> = Recor
     props(): ReturnType<typeof $$render<Metadata>>['props'];
     events(): ReturnType<typeof $$render<Metadata>>['events'];
     slots(): ReturnType<typeof $$render<Metadata>>['slots'];
-    bindings(): "display" | "fullscreen" | "series" | "hovered" | "ref_lines" | "x_axis" | "y_axis" | "x2_axis" | "y2_axis" | "wrapper" | "tooltip_point" | "fill_regions" | "selected_series_idx";
+    bindings(): "display" | "x2_axis" | "y_axis" | "y2_axis" | "fullscreen" | "wrapper" | "series" | "hovered" | "ref_lines" | "x_axis" | "tooltip_point" | "fill_regions" | "selected_series_idx";
     exports(): {};
 }
 interface $$IsomorphicComponent {

package/dist/plot/scatter/ScatterPlotControls.svelte.d.ts

@@ -12,6 +12,6 @@ type $$ComponentProps = Omit<PlotControlsProps, `children` | `post_children`> &
         } & Required<PlotConfig>
     ]>;
 };
-declare const ScatterPlotControls: import("svelte").Component<$$ComponentProps, {}, "display" | "x_axis" | "y_axis" | "x2_axis" | "y2_axis" | "selected_series_idx" | "styles">;
+declare const ScatterPlotControls: import("svelte").Component<$$ComponentProps, {}, "display" | "x2_axis" | "y_axis" | "y2_axis" | "x_axis" | "selected_series_idx" | "styles">;
 type ScatterPlotControls = ReturnType<typeof ScatterPlotControls>;
 export default ScatterPlotControls;

package/dist/plot/scatter/binned-scatter-types.d.ts

@@ -1,17 +1,10 @@
-import type { D3ColorSchemeName, D3InterpolateName } from '../../colors';
+import type { D3InterpolateName } from '../../colors';
 import type { DenseInternalPoint } from './adaptive-density';
 import type ColorBar from '../core/components/ColorBar.svelte';
-import type { LabelPlacementConfig, ScaleType, ScatterHandlerProps } from '../core/types';
+import type { ColorScaleConfig, LabelPlacementConfig, ScatterHandlerProps, SizeScaleConfig } from '../core/types';
 import type { ComponentProps, Snippet } from 'svelte';
-export type BinnedColorScaleConfig = {
-    type?: ScaleType;
-    scheme?: D3ColorSchemeName | D3InterpolateName;
-    value_range?: [number, number];
-} | D3InterpolateName;
-export type BinnedSizeScaleConfig = {
-    type?: ScaleType;
-    radius_range?: [number, number];
-    value_range?: [number, number];
+export type BinnedColorScaleConfig = ColorScaleConfig | D3InterpolateName;
+export type BinnedSizeScaleConfig = SizeScaleConfig & {
     pick_radius?: number | `auto`;
 };
 export type BinnedDensityConfig = {

package/dist/plot/scatter/index.d.ts

@@ -1,4 +1,4 @@
-export type { DensePointSeries } from './adaptive-density';
+export type { DensePointSeries, NumericArray } from './adaptive-density';
 export { default as BinnedScatterPlot } from './BinnedScatterPlot.svelte';
 export type { BinnedColorScaleConfig, BinnedDensityConfig, BinnedOverlaysConfig, BinnedPointBasePayload, BinnedPointDataFn, BinnedPointLabelPlacementConfig, BinnedPointLabelsConfig, BinnedPointPayload, BinnedPointTooltipPayload, BinnedRefLine, BinnedSizeScaleConfig, } from './binned-scatter-types';
 export { default as ElementScatter } from './ElementScatter.svelte';

package/dist/plot/scatter-3d/ScatterPlot3D.svelte

@@ -2,7 +2,7 @@
   lang="ts"
   generics="Metadata extends Record<string, unknown> = Record<string, unknown>"
 >
-  import type { D3ColorSchemeName, D3InterpolateName } from '../../colors'
+  import type { D3InterpolateName } from '../../colors'
   import { FullscreenToggle } from '../../layout'
   import type { Vec2, Vec3 } from '../../math'
   import { ColorBar, PlotLegend } from '..'
@@ -11,6 +11,7 @@
   import type {
     AxisConfig3D,
     CameraProjection3D,
+    ColorScaleConfig,
     ControlsConfig3D,
     DataSeries3D,
     DisplayConfig3D,
@@ -20,6 +21,7 @@
     RefPlane,
     ScaleType,
     Scatter3DHandlerEvent,
+    SizeScaleConfig,
     StyleOverrides3D,
     Surface3DConfig,
   } from '../core/types'
@@ -30,7 +32,7 @@
   import type { HTMLAttributes } from 'svelte/elements'
   import { SvelteMap, SvelteSet } from 'svelte/reactivity'
   import type { Camera, Scene } from 'three'
-  import { create_color_scale } from '../core/scales'
+  import { calculate_domain, create_color_scale } from '../core/scales'
   import ScatterPlot3DControls from './ScatterPlot3DControls.svelte'
   import ScatterPlot3DScene from './ScatterPlot3DScene.svelte'
 
@@ -116,17 +118,9 @@
     z_axis?: AxisConfig3D
     display?: DisplayConfig3D
     styles?: StyleOverrides3D
-    color_scale?: {
-      type?: ScaleType
-      scheme?: D3ColorSchemeName | D3InterpolateName
-      value_range?: [number, number]
-    } | D3InterpolateName
+    color_scale?: ColorScaleConfig | D3InterpolateName
     color_bar?: ComponentProps<typeof ColorBar> & { margin?: number | Sides } | null
-    size_scale?: {
-      type?: ScaleType
-      radius_range?: [number, number]
-      value_range?: [number, number]
-    }
+    size_scale?: SizeScaleConfig
     legend?: LegendConfig | null
     camera_position?: Vec3
     camera_projection?: CameraProjection3D
@@ -175,11 +169,14 @@
         id_counts.set(srs.id, (id_counts.get(srs.id) ?? 0) + 1)
       }
     }
+    // Prefix classes stay disjoint: `idx:` keys have `x` at index 2 where `id:` keys
+    // have `:`, and `dup:` keys differ in first char. Within a class, idx is unique
+    // and bare ids are only used when they occur exactly once.
     return series.map((srs, idx) => {
-      if (srs?.id === undefined || srs.id === ``) return JSON.stringify([`idx`, idx])
-      return id_counts.get(srs.id) === 1
-        ? JSON.stringify([`id`, srs.id])
-        : JSON.stringify([`duplicate-id`, idx, srs.id])
+      if (srs?.id === undefined || srs.id === ``) return `idx:${idx}`
+      // include typeof so numeric/string ids (1 vs "1") don't collide on the same key
+      const id_key = `${typeof srs.id}:${String(srs.id)}`
+      return id_counts.get(srs.id) === 1 ? `id:${id_key}` : `dup:${idx}:${id_key}`
     })
   })
 
@@ -227,15 +224,7 @@
     ),
   )
 
-  let auto_color_range = $derived.by((): [number, number] => {
-    if (all_color_values.length === 0) return [0, 1]
-    let [min, max] = [Infinity, -Infinity]
-    for (const val of all_color_values) {
-      if (val < min) min = val
-      if (val > max) max = val
-    }
-    return [min, max]
-  })
+  let auto_color_range = $derived(calculate_domain(all_color_values))
 
   let color_scale_fn = $derived(
     create_color_scale(normalized_color_scale, auto_color_range),
@@ -342,7 +331,7 @@
           {z_axis}
           {display}
           {styles}
-          color_scale={normalized_color_scale}
+          {color_scale_fn}
           {size_scale}
           {camera_position}
           {camera_projection}

package/dist/plot/scatter-3d/ScatterPlot3D.svelte.d.ts

@@ -1,8 +1,8 @@
-import type { D3ColorSchemeName, D3InterpolateName } from '../../colors';
+import type { D3InterpolateName } from '../../colors';
 import type { Vec3 } from '../../math';
 import { ColorBar } from '..';
 import type { Sides } from '../core/layout';
-import type { AxisConfig3D, CameraProjection3D, ControlsConfig3D, DataSeries3D, DisplayConfig3D, InternalPoint3D, LegendConfig, RefLine3D, RefPlane, ScaleType, Scatter3DHandlerEvent, StyleOverrides3D, Surface3DConfig } from '../core/types';
+import type { AxisConfig3D, CameraProjection3D, ColorScaleConfig, ControlsConfig3D, DataSeries3D, DisplayConfig3D, InternalPoint3D, LegendConfig, RefLine3D, RefPlane, Scatter3DHandlerEvent, SizeScaleConfig, StyleOverrides3D, Surface3DConfig } from '../core/types';
 import * as extras from '@threlte/extras';
 import type { ComponentProps, Snippet } from 'svelte';
 import type { HTMLAttributes } from 'svelte/elements';
@@ -18,19 +18,11 @@ declare function $$render<Metadata extends Record<string, unknown> = Record<stri
         z_axis?: AxisConfig3D;
         display?: DisplayConfig3D;
         styles?: StyleOverrides3D;
-        color_scale?: {
-            type?: ScaleType;
-            scheme?: D3ColorSchemeName | D3InterpolateName;
-            value_range?: [number, number];
-        } | D3InterpolateName;
+        color_scale?: ColorScaleConfig | D3InterpolateName;
         color_bar?: (ComponentProps<typeof ColorBar> & {
             margin?: number | Sides;
         }) | null;
-        size_scale?: {
-            type?: ScaleType;
-            radius_range?: [number, number];
-            value_range?: [number, number];
-        };
+        size_scale?: SizeScaleConfig;
         legend?: LegendConfig | null;
         camera_position?: Vec3;
         camera_projection?: CameraProjection3D;
@@ -72,7 +64,7 @@ declare function $$render<Metadata extends Record<string, unknown> = Record<stri
         controls_extra?: Snippet;
     };
     exports: {};
-    bindings: "fullscreen" | "hovered" | "camera_position" | "wrapper" | "camera" | "tooltip_point" | "scene" | "orbit_controls";
+    bindings: "fullscreen" | "wrapper" | "hovered" | "scene" | "camera" | "orbit_controls" | "camera_position" | "tooltip_point";
     slots: {};
     events: {};
 };
@@ -80,7 +72,7 @@ declare class __sveltets_Render<Metadata extends Record<string, unknown> = Recor
     props(): ReturnType<typeof $$render<Metadata>>['props'];
     events(): ReturnType<typeof $$render<Metadata>>['events'];
     slots(): ReturnType<typeof $$render<Metadata>>['slots'];
-    bindings(): "fullscreen" | "hovered" | "camera_position" | "wrapper" | "camera" | "tooltip_point" | "scene" | "orbit_controls";
+    bindings(): "fullscreen" | "wrapper" | "hovered" | "scene" | "camera" | "orbit_controls" | "camera_position" | "tooltip_point";
     exports(): {};
 }
 interface $$IsomorphicComponent {

package/dist/plot/scatter-3d/ScatterPlot3DControls.svelte

@@ -1,7 +1,9 @@
 <script lang="ts">
+  import type { PaneProps, PaneToggleProps } from '../../overlays'
   // NOTE: Axis config objects must be reassigned (not mutated) to trigger $bindable reactivity.
   // Pattern: `x_axis = { ...x_axis, prop: value }` instead of `x_axis.prop = value`
   import { SettingsSection } from '../../layout'
+  import type { Vec2 } from '../../math'
   import DraggablePane from '../../overlays/DraggablePane.svelte'
   import type {
     AxisConfig3D,
@@ -10,6 +12,7 @@
     DisplayConfig3D,
     Surface3DConfig,
   } from '../core/types'
+  import { calculate_domain } from '../core/scales'
   import { unique_id } from '../core/utils'
   import type { ComponentProps, Snippet } from 'svelte'
 
@@ -39,19 +42,15 @@
     auto_rotate?: number
     series?: DataSeries3D[]
     surfaces?: Surface3DConfig[]
-    toggle_props?: ComponentProps<typeof DraggablePane>[`toggle_props`]
-    pane_props?: ComponentProps<typeof DraggablePane>[`pane_props`]
+    toggle_props?: PaneToggleProps
+    pane_props?: PaneProps
     children?: Snippet
   } = $props()
 
-  // Calculate auto ranges for reset
-  function calc_auto_range(values: number[]): [number, number] {
+  // Calculate auto ranges for reset (5% padding, 0.5 when all values coincide)
+  function calc_auto_range(values: number[]): Vec2 {
     if (values.length === 0) return [0, 1]
-    let [min_val, max_val] = [values[0], values[0]]
-    for (const val of values) {
-      if (val < min_val) min_val = val
-      else if (val > max_val) max_val = val
-    }
+    const [min_val, max_val] = calculate_domain(values)
     const padding = (max_val - min_val) * 0.05 || 0.5
     return [min_val - padding, max_val + padding]
   }
@@ -97,7 +96,7 @@
   type AxisEntry = {
     name: string
     axis: AxisConfig3D
-    auto_range: [number, number]
+    auto_range: Vec2
     set: (val: AxisConfig3D) => void
   }
   const axes = $derived<AxisEntry[]>([

package/dist/plot/scatter-3d/ScatterPlot3DControls.svelte.d.ts

@@ -1,6 +1,6 @@
-import DraggablePane from '../../overlays/DraggablePane.svelte';
+import type { PaneProps, PaneToggleProps } from '../../overlays';
 import type { AxisConfig3D, CameraProjection3D, DataSeries3D, DisplayConfig3D, Surface3DConfig } from '../core/types';
-import type { ComponentProps, Snippet } from 'svelte';
+import type { Snippet } from 'svelte';
 type $$ComponentProps = {
     show?: boolean;
     x_axis?: AxisConfig3D;
@@ -11,10 +11,10 @@ type $$ComponentProps = {
     auto_rotate?: number;
     series?: DataSeries3D[];
     surfaces?: Surface3DConfig[];
-    toggle_props?: ComponentProps<typeof DraggablePane>[`toggle_props`];
-    pane_props?: ComponentProps<typeof DraggablePane>[`pane_props`];
+    toggle_props?: PaneToggleProps;
+    pane_props?: PaneProps;
     children?: Snippet;
 };
-declare const ScatterPlot3DControls: import("svelte").Component<$$ComponentProps, {}, "display" | "show" | "x_axis" | "y_axis" | "camera_projection" | "auto_rotate" | "z_axis">;
+declare const ScatterPlot3DControls: import("svelte").Component<$$ComponentProps, {}, "display" | "show" | "y_axis" | "x_axis" | "camera_projection" | "auto_rotate" | "z_axis">;
 type ScatterPlot3DControls = ReturnType<typeof ScatterPlot3DControls>;
 export default ScatterPlot3DControls;