@kevinburke/flot 5.1.2 → 5.1.4

package/dist/flot.mjs

@@ -1,4 +1,4 @@
-/*! @kevinburke/flot v5.1.2 | MIT License | https://github.com/kevinburke/flot */
+/*! @kevinburke/flot v5.1.4 | MIT License | https://github.com/kevinburke/flot */
 var browser = {
     getPageXY: function (e) {
         var doc = document.documentElement,
@@ -1732,6 +1732,120 @@ Licensed under the MIT license.
 */
 
 
+/**
+ * @typedef {{ [key: string]: any }} PluginOptions
+ */
+
+/**
+ * @typedef {PluginOptions & {
+ *   points: PluginOptions,
+ *   lines: PluginOptions,
+ *   bars: PluginOptions,
+ *   shadowSize: number,
+ *   highlightColor: string | null
+ * }} InternalSeriesOptions
+ */
+
+/**
+ * @typedef {PluginOptions & {
+ *   position?: string,
+ *   color?: string | number | null,
+ *   tickColor?: string | number | null,
+ *   font?: PluginOptions | null,
+ *   autoScale?: string,
+ *   offset?: PluginOptions,
+ *   boxPosition?: AxisBoxPosition
+ * }} InternalAxisOptions
+ */
+
+/**
+ * @typedef {{ top: number, right: number, bottom: number, left: number }} BorderWidth
+ */
+
+/**
+ * @typedef {{ top: string, right: string, bottom: string, left: string }} BorderColor
+ */
+
+/**
+ * @typedef {{ left: number, top: number, width: number, height: number, padding: number }} AxisBox
+ */
+
+/**
+ * @typedef {{ centerX: number, centerY: number }} AxisBoxPosition
+ */
+
+/**
+ * @typedef {PluginOptions & {
+ *   n: number,
+ *   direction: "x" | "y",
+ *   options: InternalAxisOptions,
+ *   used: boolean,
+ *   show: boolean,
+ *   reserveSpace: boolean,
+ *   labelWidth: number,
+ *   labelHeight: number,
+ *   box: AxisBox,
+ *   boxPosition: AxisBoxPosition,
+ *   min: number,
+ *   max: number,
+ *   datamin: number | null,
+ *   datamax: number | null,
+ *   scale: number,
+ *   tickSize: number,
+ *   tickDecimals: number,
+ *   ticks: Array<PluginOptions>,
+ *   p2c: function(string | number): number,
+ *   c2p: function(string | number): number
+ * }} InternalAxis
+ */
+
+/**
+ * @typedef {PluginOptions & {
+ *   show: boolean,
+ *   aboveData: boolean,
+ *   color: string,
+ *   backgroundColor: string | PluginOptions | null,
+ *   borderColor: string | BorderColor | null,
+ *   tickColor: string | null,
+ *   margin: number | PluginOptions,
+ *   borderWidth: number | BorderWidth,
+ *   minBorderMargin: number | null,
+ *   markings: any,
+ *   markingsColor: string,
+ *   markingsLineWidth: number,
+ *   clickable: boolean,
+ *   hoverable: boolean,
+ *   autoHighlight: boolean,
+ *   mouseActiveRadius: number
+ * }} InternalGridOptions
+ */
+
+/**
+ * @typedef {PluginOptions & {
+ *   colors: string[],
+ *   xaxis: InternalAxisOptions,
+ *   yaxis: InternalAxisOptions,
+ *   xaxes: InternalAxisOptions[],
+ *   yaxes: InternalAxisOptions[],
+ *   series: InternalSeriesOptions,
+ *   grid: InternalGridOptions,
+ *   interaction: PluginOptions,
+ *   hooks: PluginOptions
+ * }} InternalOptions
+ */
+
+/**
+ * @typedef {{ [key: string]: Array<function(...any): any> }} HookRegistry
+ */
+
+/**
+ * @typedef {PluginOptions} InternalPlot
+ */
+
+/**
+ * @typedef {{ from?: number, to?: number, axis: InternalAxis }} ExtractedRange
+ */
+
     function defaultTickGenerator(axis) {
         var ticks = [],
             start = saturated.saturate(saturated.floorInBase(axis.min, axis.tickSize)),
@@ -1820,6 +1934,7 @@ Licensed under the MIT license.
         // or { data: [ [x1, y1], [x2, y2], ... ], label: "some label", ... }
 
         var series = [],
+            /** @type {InternalOptions} */
             options = {
                 // the color theme used for graphs
                 colors: ["#edc240", "#afd8f8", "#cb4b4b", "#4da74d", "#9440ed"],
@@ -1932,7 +2047,9 @@ Licensed under the MIT license.
             eventHolder = null, // DOM element that events should be bound to
             ctx = null,
             octx = null,
+            /** @type {InternalAxis[]} */
             xaxes = [],
+            /** @type {InternalAxis[]} */
             yaxes = [],
             plotOffset = {
                 left: 0,
@@ -1942,6 +2059,7 @@ Licensed under the MIT license.
             },
             plotWidth = 0,
             plotHeight = 0,
+            /** @type {HookRegistry} */
             hooks = {
                 processOptions: [],
                 processRawData: [],
@@ -1961,6 +2079,7 @@ Licensed under the MIT license.
                 resize: [],
                 shutdown: []
             },
+            /** @type {InternalPlot} */
             plot = this;
 
         var eventManager = {};
@@ -2027,8 +2146,8 @@ Licensed under the MIT license.
         plot.triggerRedrawOverlay = triggerRedrawOverlay;
         plot.pointOffset = function(point) {
             return {
-                left: parseInt(xaxes[axisNumber(point, "x") - 1].p2c(+point.x) + plotOffset.left, 10),
-                top: parseInt(yaxes[axisNumber(point, "y") - 1].p2c(+point.y) + plotOffset.top, 10)
+                left: parseInt(String(xaxes[axisNumber(point, "x") - 1].p2c(+point.x) + plotOffset.left), 10),
+                top: parseInt(String(yaxes[axisNumber(point, "y") - 1].p2c(+point.y) + plotOffset.top), 10)
             };
         };
         plot.shutdown = shutdown;
@@ -2038,6 +2157,7 @@ Licensed under the MIT license.
             placeholder.innerHTML = '';
 
             series = [];
+            // @ts-expect-error destroy clears closure references after shutdown.
             options = null;
             surface = null;
             overlay = null;
@@ -2046,7 +2166,9 @@ Licensed under the MIT license.
             octx = null;
             xaxes = [];
             yaxes = [];
+            // @ts-expect-error destroy clears closure references after shutdown.
             hooks = null;
+            // @ts-expect-error destroy clears closure references after shutdown.
             plot = null;
         };
 
@@ -2275,6 +2397,9 @@ Licensed under the MIT license.
             return a;
         }
 
+        /**
+         * @returns {InternalAxis[]}
+         */
         function allAxes() {
             // return flat array without annoying null entries
             return xaxes.concat(yaxes).filter(function(a) {
@@ -2353,16 +2478,23 @@ Licensed under the MIT license.
 
         function getOrCreateAxis(axes, number) {
             if (!axes[number - 1]) {
-                axes[number - 1] = {
+                axes[number - 1] = /** @type {InternalAxis} */ (/** @type {unknown} */ ({
                     n: number, // save the number for future reference
                     direction: axes === xaxes ? "x" : "y",
                     options: extend(true, {}, axes === xaxes ? options.xaxis : options.yaxis)
-                };
+                }));
             }
 
             return axes[number - 1];
         }
 
+        function firstAxis(axes) {
+            if (!axes[0]) {
+                throw new Error("missing first axis");
+            }
+            return axes[0];
+        }
+
         function fillInSeriesOptions() {
             var neededColors = series.length,
                 maxIndex = -1,
@@ -2785,8 +2917,13 @@ Licensed under the MIT license.
         function measureTickLabels(axis) {
             var opts = axis.options,
                 ticks = opts.showTickLabels !== 'none' && axis.ticks ? axis.ticks : [],
-                showMajorTickLabels = opts.showTickLabels === 'major' || opts.showTickLabels === 'all',
-                showEndpointsTickLabels = opts.showTickLabels === 'endpoints' || opts.showTickLabels === 'all',
+                // Mirror drawAxisLabels: 'major' and 'all' draw every tick;
+                // only 'endpoints' skips middle ticks. Measurement must cover
+                // every label that will be drawn, otherwise labelWidth can be
+                // too small for the widest one — e.g. a top tick of 100 next
+                // to 70/80/90 gets clipped to "00" because the axis box was
+                // sized for 2-char labels. See flot/flot#1729, flot/flot#1788.
+                endpointsOnly = opts.showTickLabels === 'endpoints',
                 labelWidth = opts.labelWidth || 0,
                 labelHeight = opts.labelHeight || 0,
                 legacyStyles = axis.direction + "Axis " + axis.direction + axis.n + "Axis",
@@ -2797,9 +2934,7 @@ Licensed under the MIT license.
                 var t = ticks[i];
                 var label = t.label;
 
-                if (!t.label ||
-                    (showMajorTickLabels === false && i > 0 && i < ticks.length - 1) ||
-                    (showEndpointsTickLabels === false && (i === 0 || i === ticks.length - 1))) {
+                if (!t.label || (endpointsOnly && i > 0 && i < ticks.length - 1)) {
                     continue;
                 }
 
@@ -3123,9 +3258,11 @@ Licensed under the MIT license.
             if (delta === 0.0) {
                 // degenerate case
                 var widen = max === 0 ? 1 : 0.01;
-                var wmin = null;
+                var wmin = 0;
+                var wminSet = false;
                 if (min == null) {
-                    wmin -= widen;
+                    wmin = -widen;
+                    wminSet = true;
                 }
 
                 // always widen max if we couldn't widen min to ensure we
@@ -3134,7 +3271,7 @@ Licensed under the MIT license.
                     max += widen;
                 }
 
-                if (wmin != null) {
+                if (wminSet) {
                     min = wmin;
                 }
             }
@@ -3530,8 +3667,13 @@ Licensed under the MIT license.
             triggerRedrawOverlay();
         }
 
+        /**
+         * @returns {ExtractedRange}
+         */
         function extractRange(ranges, coord) {
-            var axis, from, to, key, axes = allAxes();
+            var axis, from, to, axes = allAxes();
+            var key = "";
+            var keyFound = false;
 
             for (var i = 0; i < axes.length; ++i) {
                 axis = axes[i];
@@ -3543,6 +3685,7 @@ Licensed under the MIT license.
                     }
 
                     if (ranges[key]) {
+                        keyFound = true;
                         from = ranges[key].from;
                         to = ranges[key].to;
                         break;
@@ -3551,8 +3694,8 @@ Licensed under the MIT license.
             }
 
             // backwards-compat stuff - to be removed in future
-            if (!ranges[key]) {
-                axis = coord === "x" ? xaxes[0] : yaxes[0];
+            if (!keyFound) {
+                axis = firstAxis(coord === "x" ? xaxes : yaxes);
                 from = ranges[coord + "1"];
                 to = ranges[coord + "2"];
             }
@@ -3567,7 +3710,7 @@ Licensed under the MIT license.
             return {
                 from: from,
                 to: to,
-                axis: axis
+                axis: /** @type {InternalAxis} */ (axis)
             };
         }
 
@@ -3817,7 +3960,8 @@ Licensed under the MIT license.
             // check if the line will be overlapped with a border
             var overlappedWithBorder = function (value) {
                 var bw = options.grid.borderWidth;
-                return (((typeof bw === "object" && bw[axis.position] > 0) || bw > 0) && (value === axis.min || value === axis.max));
+                var overlapsBorder = typeof bw === "object" ? bw[axis.position] > 0 : bw > 0;
+                return overlapsBorder && (value === axis.min || value === axis.max);
             };
 
             ctx.strokeStyle = options.grid.tickColor;
@@ -3863,6 +4007,10 @@ Licensed under the MIT license.
             var bw = options.grid.borderWidth,
                 bc = options.grid.borderColor;
 
+            if (bc == null) {
+                bc = options.grid.color;
+            }
+
             if (typeof bw === "object" || typeof bc === "object") {
                 if (typeof bw !== "object") {
                     bw = {
@@ -4240,10 +4388,14 @@ Licensed under the MIT license.
                 smallestDistance = radius * radius + 1;
 
             for (i = series.length - 1; i >= 0; --i) {
-                if (!seriesFilter(i)) continue;
+                if (!seriesFilter(i)) {
+                    continue;
+                }
 
                 var s = series[i];
-                if (!s.datapoints) return;
+                if (!s.datapoints) {
+                    continue;
+                }
 
                 var foundPoint = false;
                 if (s.lines.show || s.points.show) {
@@ -4530,7 +4682,7 @@ Licensed under the MIT license.
     // Plugin registry. Plugins push to this array to register themselves.
     var plugins = [];
 
-    var version = "5.1.2";
+    var version = "5.1.4";
 
     // The main plot function.
     function plot(placeholder, data, options) {