matterviz 0.4.1 → 0.4.2

package/dist/plot/core/utils/hierarchy-labels.js

@@ -0,0 +1,99 @@
+// Label/color helpers shared by the hierarchical part-of-whole charts
+// (Sunburst, Treemap): per-node label strings, memoized contrast picking and
+// text measurement, and SVG/PNG export. Pure + cache-factory functions so each
+// component instance owns its caches without sharing global state.
+import { pick_contrast_color } from '../../../colors';
+import { export_svg_as_png, export_svg_as_svg } from '../../../io/export';
+import { format_value } from '../../../labels';
+import { measure_text_width } from '../layout';
+export const node_display_name = (node) => node.label ?? `${node.id}`;
+// What a node's label displays, per the label_text mode (plotly textinfo
+// equivalent); percent is of the root total, parent-percent of the parent node
+export function node_label_str(node, label_text, value_format) {
+    const name = node_display_name(node);
+    if (label_text === `label`)
+        return name;
+    const val = format_value(node.value, value_format);
+    if (label_text === `value`)
+        return val;
+    if (label_text === `label+value`)
+        return `${name} ${val}`;
+    if (label_text === `label+parent-percent`) {
+        return `${name} (${format_value(node.parent_fraction ?? node.fraction, `.0%`)})`;
+    }
+    const pct = format_value(node.fraction, `.1%`);
+    if (label_text === `percent`)
+        return pct;
+    return `${name} ${pct}`; // label+percent
+}
+const COMPOUND_LABEL_MODES = new Set([
+    `label+value`,
+    `label+percent`,
+    `label+parent-percent`,
+]);
+// Base + optional richer/compact variants for fit-aware rendering: compound
+// modes degrade to the bare label when the full text doesn't fit its node,
+// and nodes with a `label_short` degrade once more to that compact form
+// before the label is hidden entirely.
+export function node_label_variants(node, label_text, value_format) {
+    const short = node.label_short;
+    const text = node_label_str(node, label_text, value_format);
+    if (!COMPOUND_LABEL_MODES.has(label_text))
+        return { text, short };
+    return { text: node_display_name(node), extended: text, short };
+}
+// Black/white label text, whichever contrasts with the given fill. Memoized per
+// color string - parsing/luminance is too slow per label per frame, and distinct
+// node colors are few.
+export function make_cached_contrast() {
+    const cache = new Map();
+    return (fill) => {
+        let contrast = cache.get(fill);
+        if (contrast === undefined) {
+            // growth guard (same as make_cached_text_width): continuous metric coloring
+            // can emit unbounded distinct fills
+            if (cache.size > 10_000)
+                cache.clear();
+            contrast = pick_contrast_color({ bg_color: fill });
+            cache.set(fill, contrast);
+        }
+        return contrast;
+    };
+}
+// Memoized canvas text measurement (far too slow per visible node per frame)
+export function make_cached_text_width() {
+    const cache = new Map();
+    return (text, font) => {
+        const key = `${font}|${text}`;
+        let text_width = cache.get(key);
+        if (text_width === undefined) {
+            if (cache.size > 10_000)
+                cache.clear(); // growth guard
+            text_width = measure_text_width(text, font);
+            cache.set(key, text_width);
+        }
+        return text_width;
+    };
+}
+// Styles these components apply via CSS that exported standalone SVGs must carry
+// as presentation attributes (inlined onto a clone by the io/export helpers)
+const EXPORT_INLINE_STYLES = [
+    `fill`,
+    `stroke`,
+    `stroke-width`,
+    `text-anchor`,
+    `dominant-baseline`,
+    `font-size`,
+    `font-family`,
+    `font-weight`,
+    `opacity`,
+];
+export function export_hierarchy_chart(svg_element, base_filename, format) {
+    if (!svg_element)
+        return;
+    const filename = `${base_filename}.${format}`;
+    if (format === `svg`)
+        export_svg_as_svg(svg_element, filename, EXPORT_INLINE_STYLES);
+    else
+        export_svg_as_png(svg_element, filename, 150, EXPORT_INLINE_STYLES);
+}

package/dist/plot/core/utils/label-placement.js

@@ -18,10 +18,10 @@ const copy_state = (target, source) => {
 export function parse_font_size(size_str) {
     if (!size_str)
         return 12;
-    const match = /^(\d+(?:\.\d+)?)(px|em|rem)?$/.exec(size_str);
+    const match = /^(?<size>\d+(?:\.\d+)?)(?<unit>px|em|rem)?$/.exec(size_str);
     if (!match)
         return 12;
-    const value = parseFloat(match[1]);
+    const value = Number(match[1]);
     return match[2] === `em` || match[2] === `rem` ? value * 16 : value;
 }
 export function estimate_label_size(text, font_size_str) {