matterviz 0.4.1 → 0.4.2

package/dist/settings.js

@@ -40,6 +40,49 @@ const DISPLAY_CONFIG = {
         description: `Show Y-axis zero reference line`,
     },
 };
+// Settings shared by the sunburst + treemap sections below so the two charts'
+// options can't drift; `node` names the chart's visual unit (arc/cell) and
+// `levels` its depth unit (rings/levels) in descriptions.
+const hierarchy_chart_settings = (node, levels, zoom_desc) => ({
+    value_mode: {
+        value: `leaf-sum`,
+        description: `How node values are interpreted (plotly branchvalues semantics): leaf-sum ignores parent values, total treats every value as authoritative, remainder adds a node's own value on top of its children`,
+        enum: { 'leaf-sum': `Leaf sum`, total: `Total`, remainder: `Remainder` },
+    },
+    max_depth: {
+        value: 0,
+        description: `Number of ${levels} shown below the current zoom root (0 = all)`,
+        minimum: 0,
+        maximum: 10,
+    },
+    min_fraction: {
+        value: 0,
+        description: `Group sibling ${node}s smaller than this fraction of the total into one 'Other' ${node === `arc` ? `slice` : `cell`} per parent (0 = off)`,
+        minimum: 0,
+        maximum: 0.2,
+    },
+    show_labels: {
+        value: true,
+        description: `Show labels on ${node}s large enough to fit them`,
+    },
+    label_text: {
+        value: `label`,
+        description: `What ${node} labels display (percent is of the root total, parent-percent of the parent node)`,
+        enum: {
+            label: `Label`,
+            value: `Value`,
+            percent: `Percent`,
+            'label+value': `Label + value`,
+            'label+percent': `Label + percent`,
+            'label+parent-percent': `Label + % of parent`,
+        },
+    },
+    zoom_on_click: { value: true, description: zoom_desc },
+    show_breadcrumbs: {
+        value: true,
+        description: `Show a clickable ${node === `arc` ? `trail` : `pathbar`} of ancestors when zoomed into a subtree`,
+    },
+});
 // Complete settings configuration with values, descriptions, and constraints
 export const SETTINGS_CONFIG = {
     // General display settings
@@ -347,7 +390,7 @@ export const SETTINGS_CONFIG = {
             description: `Per-key configuration for site vector layers. Keys map to site property names (e.g. force, magmom, force_DFT). Auto-populated when a structure with vector data loads.`,
         },
         vector_scale: {
-            value: 1.0,
+            value: 0.75,
             description: `Scale factor for site vector arrows`,
             minimum: 0.1,
             maximum: 10.0,
@@ -369,8 +412,8 @@ export const SETTINGS_CONFIG = {
             description: `Show all arrows at the same length (direction only). Useful for spin/magmom visualization where orientation matters but magnitude does not.`,
         },
         vector_uniform_thickness: {
-            value: false,
-            description: `Use the same shaft and head size for all arrows regardless of length. When off (default), thickness scales with arrow length.`,
+            value: true,
+            description: `Use the same shaft and head size for all arrows regardless of length. Negative radii are scaled by characteristic atom spacing.`,
         },
         vector_origin_gap: {
             value: 0,
@@ -379,20 +422,20 @@ export const SETTINGS_CONFIG = {
             maximum: 0.5,
         },
         vector_shaft_radius: {
-            value: -0.03,
-            description: `Radius of vector shaft (negative = relative to length, positive = absolute)`,
+            value: -0.01,
+            description: `Radius of vector shaft (negative = relative to length or atom spacing with uniform thickness, positive = absolute)`,
             minimum: -0.1,
             maximum: 0.1,
         },
         vector_arrow_head_radius: {
-            value: -0.06,
-            description: `Radius of vector arrow head (negative = relative to length, positive = absolute)`,
+            value: -0.04,
+            description: `Radius of vector arrow head (negative = relative to length or atom spacing with uniform thickness, positive = absolute)`,
             minimum: -0.2,
             maximum: 0.2,
         },
         vector_arrow_head_length: {
-            value: -0.15,
-            description: `Length of vector arrow head (negative = relative to length, positive = absolute)`,
+            value: -0.1,
+            description: `Length of vector arrow head (negative = relative to length or atom spacing with uniform thickness, positive = absolute)`,
             minimum: -0.5,
             maximum: 0.5,
         },
@@ -751,7 +794,7 @@ export const SETTINGS_CONFIG = {
                 maximum: 5,
             },
             stroke_color: {
-                value: `#000000`,
+                value: `var(--text-color, black)`, // theme-responsive like axis/grid colors
                 description: `Box outline color`,
             },
             border_radius: {
@@ -769,7 +812,7 @@ export const SETTINGS_CONFIG = {
                 maximum: 5,
             },
             color: {
-                value: `#000000`,
+                value: `var(--text-color, black)`, // theme-responsive like axis/grid colors
                 description: `Whisker line color`,
             },
             cap_fraction: {
@@ -787,7 +830,7 @@ export const SETTINGS_CONFIG = {
                 maximum: 6,
             },
             color: {
-                value: `#000000`,
+                value: `var(--text-color, black)`, // theme-responsive like axis/grid colors
                 description: `Median line color`,
             },
         },
@@ -870,22 +913,12 @@ export const SETTINGS_CONFIG = {
     },
     // Sunburst chart specific
     sunburst: {
+        ...hierarchy_chart_settings(`arc`, `rings`, `Clicking a branch arc zooms into that subtree (center circle zooms out)`),
         shape: {
             value: `sunburst`,
             description: `Chart geometry: polar rings (sunburst) or stacked rows (icicle)`,
             enum: { sunburst: `Sunburst`, icicle: `Icicle` },
         },
-        value_mode: {
-            value: `leaf-sum`,
-            description: `How node values are interpreted (plotly branchvalues semantics): leaf-sum ignores parent values, total treats every value as authoritative, remainder adds a node's own value on top of its children`,
-            enum: { 'leaf-sum': `Leaf sum`, total: `Total`, remainder: `Remainder` },
-        },
-        max_depth: {
-            value: 0,
-            description: `Number of rings shown below the current zoom root (0 = all)`,
-            minimum: 0,
-            maximum: 10,
-        },
         inner_radius: {
             value: 0.25,
             description: `Center hole size as fraction of the outer radius`,
@@ -898,16 +931,6 @@ export const SETTINGS_CONFIG = {
             minimum: 0,
             maximum: 4,
         },
-        min_fraction: {
-            value: 0,
-            description: `Group sibling arcs smaller than this fraction of the total into one 'Other' slice per parent (0 = off)`,
-            minimum: 0,
-            maximum: 0.2,
-        },
-        show_labels: {
-            value: true,
-            description: `Show labels on arcs large enough to fit them`,
-        },
         label_rotation: {
             value: `auto`,
             description: `Arc label orientation (auto picks radial/tangential per arc)`,
@@ -918,24 +941,27 @@ export const SETTINGS_CONFIG = {
                 horizontal: `Horizontal`,
             },
         },
-        label_text: {
-            value: `label`,
-            description: `What arc labels display (percent is of the root total)`,
-            enum: {
-                label: `Label`,
-                value: `Value`,
-                percent: `Percent`,
-                'label+value': `Label + value`,
-                'label+percent': `Label + percent`,
-            },
+    },
+    // Treemap chart specific
+    treemap: {
+        ...hierarchy_chart_settings(`cell`, `levels`, `Clicking any cell zooms into it, plotly-style (the breadcrumb pathbar zooms out)`),
+        padding_inner: {
+            value: 0,
+            description: `Pixel gap between sibling cells (0 = cells share a single stroke divider; gaps > 0 show the parent's fill)`,
+            minimum: 0,
+            maximum: 10,
         },
-        zoom_on_click: {
-            value: true,
-            description: `Clicking a branch arc zooms into that subtree (center circle zooms out)`,
+        padding_top: {
+            value: 18,
+            description: `Pixel strip reserved at the top of branch cells for their label (0 = no headers)`,
+            minimum: 0,
+            maximum: 40,
         },
-        show_breadcrumbs: {
-            value: true,
-            description: `Show a clickable trail of ancestors when zoomed into a subtree`,
+        padding_outer: {
+            value: 3,
+            description: `Pixel inset of child cells within their parent's left/right/bottom edges, so parents visibly enclose their subtree (plotly marker.pad)`,
+            minimum: 0,
+            maximum: 10,
         },
     },
     // Composition specific
@@ -984,7 +1010,7 @@ export const SETTINGS_CONFIG = {
         display: DISPLAY_CONFIG,
         point: {
             size: {
-                value: 4,
+                value: 3,
                 description: `Point size for scatter plots`,
                 minimum: 1,
                 maximum: 20,
@@ -1448,5 +1474,6 @@ export const merge = (user) => ({
     box: merge_nested(DEFAULTS.box, user?.box),
     sankey: merge_nested(DEFAULTS.sankey, user?.sankey),
     sunburst: merge_nested(DEFAULTS.sunburst, user?.sunburst),
+    treemap: merge_nested(DEFAULTS.treemap, user?.treemap),
     convex_hull: merge_nested(DEFAULTS.convex_hull, user?.convex_hull),
 });