convert lib/index.js to named exports for tree-shaking

Convert all 182 methods from aggregation pattern to named exports.
Update 68 consumer files in the factory bundle to use named imports.
Keep `export default lib` for backward compat with 286 non-factory files.

Sub-modules (`loggers.js`, `mod.js`, `angles.js`, `dom.js`) also
converted to named exports for direct re-export from `lib/index.js`.

Saves ~10 KB minified across all bundles from tree-shaking 74 unused
methods. Factory: 694 KB min (was 704 KB).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: ryan-williams

perf/bundle-compare/thresholds.json

@@ -1,13 +1,13 @@
 {
     "upstream_full__min_": 4831947,
     "upstream_basic__min_": 1114816,
-    "fork_full__min_": 4807649,
-    "fork_basic__min_": 1093881,
-    "fork_minimal__min_": 986167,
-    "fork_lite__min_": 846142,
+    "fork_full__min_": 4797107,
+    "fork_basic__min_": 1083866,
+    "fork_minimal__min_": 976177,
+    "fork_lite__min_": 836151,
     "app___upstream_basic": 1115573,
-    "app___fork_basic": 1094029,
-    "app___fork_lite": 846234,
-    "fork_factory__min_": 720668,
-    "app___fork_factory": 720668
+    "app___fork_basic": 1084014,
+    "app___fork_lite": 836243,
+    "fork_factory__min_": 710590,
+    "app___fork_factory": 710590
 }

perf/thresholds.json

@@ -1,19 +1,19 @@
 {
     "bundleSize": {
         "lite": {
-            "expected_bytes": 1801210
+            "expected_bytes": 1791466
         },
         "lite-min": {
             "expected_bytes": 916326
         },
         "minimal": {
-            "expected_bytes": 2123964
+            "expected_bytes": 2114209
         },
         "minimal-min": {
             "expected_bytes": 1076875
         },
         "basic": {
-            "expected_bytes": 2429051
+            "expected_bytes": 2419312
         },
         "basic-min": {
             "expected_bytes": 1185641

src/components/colorbar/defaults.js

@@ -1,4 +1,4 @@
-import Lib from '../../lib/index.js';
+import Lib, { bigFont, coerceFont, extendFlat, noneOrAll } from '../../lib/index.js';
 import Template from '../../plot_api/plot_template.js';
 import handleTickValueDefaults from '../../plots/cartesian/tick_value_defaults.js';
 import handleTickMarkDefaults from '../../plots/cartesian/tick_mark_defaults.js';
@@ -76,7 +76,7 @@ export default function colorbarDefaults(containerIn, containerOut, layout) {
     coerce('xpad');
     coerce('yanchor', defaultYAnchor);
     coerce('ypad');
-    Lib.noneOrAll(colorbarIn, colorbarOut, ['x', 'y']);
+    noneOrAll(colorbarIn, colorbarOut, ['x', 'y']);
 
     coerce('outlinecolor');
     coerce('outlinewidth');
@@ -123,10 +123,10 @@ export default function colorbarDefaults(containerIn, containerOut, layout) {
 
     var tickFont = colorbarOut.showticklabels ? colorbarOut.tickfont : font;
 
-    var dfltTitleFont = Lib.extendFlat({}, font, {
+    var dfltTitleFont = extendFlat({}, font, {
         family: tickFont.family,
-        size: Lib.bigFont(tickFont.size)
+        size: bigFont(tickFont.size)
     });
-    Lib.coerceFont(coerce, 'title.font', dfltTitleFont);
+    coerceFont(coerce, 'title.font', dfltTitleFont);
     coerce('title.side', isVertical ? 'top' : 'right');
 }

src/components/colorbar/has_colorbar.js

@@ -1,5 +1,5 @@
-import Lib from '../../lib/index.js';
+import { isPlainObject } from '../../lib/index.js';
 
 export default function hasColorbar(container) {
-    return Lib.isPlainObject(container.colorbar);
+    return isPlainObject(container.colorbar);
 }

src/components/colorscale/calc.js

@@ -1,5 +1,5 @@
 import isNumeric from 'fast-isnumeric';
-import Lib from '../../lib/index.js';
+import { aggNums, nestedProperty } from '../../lib/index.js';
 import _helpers from './helpers.js';
 const { extractOpts } = _helpers;
 
@@ -9,7 +9,7 @@ export default function calc(gd, trace, opts) {
     var containerStr = opts.containerStr;
 
     var container = containerStr ?
-        Lib.nestedProperty(trace, containerStr).get() :
+        nestedProperty(trace, containerStr).get() :
         trace;
 
     var cOpts = extractOpts(container);
@@ -18,8 +18,8 @@ export default function calc(gd, trace, opts) {
     var max = cOpts.max;
     var mid = cOpts.mid;
 
-    var minVal = function() { return Lib.aggNums(Math.min, null, vals); };
-    var maxVal = function() { return Lib.aggNums(Math.max, null, vals); };
+    var minVal = function() { return aggNums(Math.min, null, vals); };
+    var maxVal = function() { return aggNums(Math.max, null, vals); };
 
     if(min === undefined) {
         min = minVal();

src/components/colorscale/cross_trace_defaults.js

@@ -1,4 +1,4 @@
-import Lib from '../../lib/index.js';
+import { nestedProperty } from '../../lib/index.js';
 import _helpers from './helpers.js';
 const { hasColorscale, extractOpts } = _helpers;
 
@@ -12,7 +12,7 @@ export default function crossTraceDefaults(fullData, fullLayout) {
 
     function relinkColorAttrs(outerCont, cbOpt) {
         var cont = cbOpt.container ?
-            Lib.nestedProperty(outerCont, cbOpt.container).get() :
+            nestedProperty(outerCont, cbOpt.container).get() :
             outerCont;
 
         if(cont) {

src/components/colorscale/defaults.js

@@ -1,5 +1,5 @@
 import isNumeric from 'fast-isnumeric';
-import Lib from '../../lib/index.js';
+import { nestedProperty, warn } from '../../lib/index.js';
 import hasColorbar from '../colorbar/has_colorbar.js';
 import colorbarDefaults from '../colorbar/defaults.js';
 import _scales from './scales.js';
@@ -9,7 +9,7 @@ import { traceIs } from '../../registry.js';
 function npMaybe(parentCont, prefix) {
     var containerStr = prefix.slice(0, prefix.length - 1);
     return prefix ?
-        Lib.nestedProperty(parentCont, containerStr).get() || {} :
+        nestedProperty(parentCont, containerStr).get() || {} :
         parentCont;
 }
 
@@ -36,7 +36,7 @@ export default function colorScaleDefaults(parentContIn, parentContOut, layout,
         if(colorAx) {
             var colorbarVisuals = (
                 traceIs(parentContOut, 'contour') &&
-                Lib.nestedProperty(parentContOut, 'contours.coloring').get()
+                nestedProperty(parentContOut, 'contours.coloring').get()
             ) || 'heatmap';
 
             var stash = colorAxes[colorAx];
@@ -46,7 +46,7 @@ export default function colorScaleDefaults(parentContIn, parentContOut, layout,
 
                 if(stash[0] !== colorbarVisuals) {
                     stash[0] = false;
-                    Lib.warn([
+                    warn([
                         'Ignoring coloraxis:', colorAx, 'setting',
                         'as it is linked to incompatible colorscales.'
                     ].join(' '));

src/components/colorscale/helpers.js

@@ -1,21 +1,21 @@
 import { scaleLinear, scaleLog, scaleOrdinal } from 'd3-scale';
 import tinycolor from 'tinycolor2';
 import isNumeric from 'fast-isnumeric';
-import Lib from '../../lib/index.js';
+import { isArrayOrTypedArray, isPlainObject, nestedProperty } from '../../lib/index.js';
 import Color from '../color/index.js';
 import _scales from './scales.js';
 const { isValid: isValidScale } = _scales;
 
 function hasColorscale(trace, containerStr, colorKey) {
     var container = containerStr ?
-        Lib.nestedProperty(trace, containerStr).get() || {} :
+        nestedProperty(trace, containerStr).get() || {} :
         trace;
 
     var color = container[colorKey || 'color'];
     if(color && color._inputArray) color = color._inputArray;
 
     var isArrayWithOneNumber = false;
-    if(Lib.isArrayOrTypedArray(color)) {
+    if(isArrayOrTypedArray(color)) {
         for(var i = 0; i < color.length; i++) {
             if(isNumeric(color[i])) {
                 isArrayWithOneNumber = true;
@@ -25,12 +25,12 @@ function hasColorscale(trace, containerStr, colorKey) {
     }
 
     return (
-        Lib.isPlainObject(container) && (
+        isPlainObject(container) && (
             isArrayWithOneNumber ||
             container.showscale === true ||
             (isNumeric(container.cmin) && isNumeric(container.cmax)) ||
             isValidScale(container.colorscale) ||
-            Lib.isPlainObject(container.colorbar)
+            isPlainObject(container.colorbar)
         )
     );
 }

src/components/dragelement/cursor.js

@@ -1,4 +1,4 @@
-import Lib from '../../lib/index.js';
+import { constrain } from '../../lib/index.js';
 
 // set cursors pointing toward the closest corner/side,
 // to indicate alignment
@@ -13,12 +13,12 @@ export default function getCursor(x, y, xanchor, yanchor) {
     if(xanchor === 'left') x = 0;
     else if(xanchor === 'center') x = 1;
     else if(xanchor === 'right') x = 2;
-    else x = Lib.constrain(Math.floor(x * 3), 0, 2);
+    else x = constrain(Math.floor(x * 3), 0, 2);
 
     if(yanchor === 'bottom') y = 0;
     else if(yanchor === 'middle') y = 1;
     else if(yanchor === 'top') y = 2;
-    else y = Lib.constrain(Math.floor(y * 3), 0, 2);
+    else y = constrain(Math.floor(y * 3), 0, 2);
 
     return cursorset[y][x];
 }

src/components/dragelement/index.js

@@ -1,8 +1,7 @@
 import mouseOffset from 'mouse-event-offset';
 var hasHover = typeof matchMedia === 'function' ? !matchMedia('(hover: none)').matches : typeof window !== 'undefined';
 import supportsPassive from 'has-passive-events';
-import _index from '../../lib/index.js';
-const { removeElement } = _index;
+import { removeElement } from '../../lib/index.js';
 import constants from '../../plots/cartesian/constants.js';
 import unhover from './unhover.js';
 import _req0 from './align.js';