@kevinburke/flot 5.1.3 → 5.1.4

package/CHANGELOG.md

@@ -5,6 +5,31 @@ All notable changes to this project will be documented in this file.
 Starting with 5.0.0, this changelog tracks the @kevinburke/flot fork.
 For earlier upstream history, see the [flot/flot repository](https://github.com/flot/flot).
 
+## Unreleased
+
+## [5.1.4] - 2026-05-22
+
+### Changed
+
+- `jquery.flot.js` / `Makefile`: clear the remaining TypeScript
+  `checkJs` source warnings and run `make types-source` as a direct
+  `tsc --project tsconfig.json` check. The old `.tsc-baseline`
+  ratchet is no longer needed now that the source warning count is
+  zero.
+- `biome.json`: update the schema URL to match Biome 2.4.15.
+
+### Fixed
+
+- `jquery.flot.js`: make `findNearbyItems()` skip series whose
+  `datapoints` have been removed instead of letting `findItems()`
+  return `undefined`. This preserves a list return value for hover
+  lookup and adds a regression test for the malformed-series case.
+- `jquery.flot.js`: include the first and last ticks in
+  `measureTickLabels` for `showTickLabels: 'major'` (the default), so
+  that an endpoint label wider than the middle ticks no longer
+  overflows the axis box and gets clipped. Upstream `flot/flot#1729`
+  and `flot/flot#1788`.
+
 ## [5.1.3] - 2026-04-22
 
 ### Fixed

package/dist/flot.js

@@ -1,4 +1,4 @@
-/*! @kevinburke/flot v5.1.3 | MIT License | https://github.com/kevinburke/flot */
+/*! @kevinburke/flot v5.1.4 | MIT License | https://github.com/kevinburke/flot */
 var Flot = (function (exports) {
     'use strict';
 
@@ -1735,6 +1735,120 @@ var Flot = (function (exports) {
     */
 
 
+    /**
+     * @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)),
@@ -1823,6 +1937,7 @@ var Flot = (function (exports) {
             // 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"],
@@ -1935,7 +2050,9 @@ var Flot = (function (exports) {
                 eventHolder = null, // DOM element that events should be bound to
                 ctx = null,
                 octx = null,
+                /** @type {InternalAxis[]} */
                 xaxes = [],
+                /** @type {InternalAxis[]} */
                 yaxes = [],
                 plotOffset = {
                     left: 0,
@@ -1945,6 +2062,7 @@ var Flot = (function (exports) {
                 },
                 plotWidth = 0,
                 plotHeight = 0,
+                /** @type {HookRegistry} */
                 hooks = {
                     processOptions: [],
                     processRawData: [],
@@ -1964,6 +2082,7 @@ var Flot = (function (exports) {
                     resize: [],
                     shutdown: []
                 },
+                /** @type {InternalPlot} */
                 plot = this;
 
             var eventManager = {};
@@ -2030,8 +2149,8 @@ var Flot = (function (exports) {
             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;
@@ -2041,6 +2160,7 @@ var Flot = (function (exports) {
                 placeholder.innerHTML = '';
 
                 series = [];
+                // @ts-expect-error destroy clears closure references after shutdown.
                 options = null;
                 surface = null;
                 overlay = null;
@@ -2049,7 +2169,9 @@ var Flot = (function (exports) {
                 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;
             };
 
@@ -2278,6 +2400,9 @@ var Flot = (function (exports) {
                 return a;
             }
 
+            /**
+             * @returns {InternalAxis[]}
+             */
             function allAxes() {
                 // return flat array without annoying null entries
                 return xaxes.concat(yaxes).filter(function(a) {
@@ -2356,16 +2481,23 @@ var Flot = (function (exports) {
 
             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,
@@ -2788,8 +2920,13 @@ var Flot = (function (exports) {
             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",
@@ -2800,9 +2937,7 @@ var Flot = (function (exports) {
                     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;
                     }
 
@@ -3126,9 +3261,11 @@ var Flot = (function (exports) {
                 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
@@ -3137,7 +3274,7 @@ var Flot = (function (exports) {
                         max += widen;
                     }
 
-                    if (wmin != null) {
+                    if (wminSet) {
                         min = wmin;
                     }
                 }
@@ -3533,8 +3670,13 @@ var Flot = (function (exports) {
                 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];
@@ -3546,6 +3688,7 @@ var Flot = (function (exports) {
                         }
 
                         if (ranges[key]) {
+                            keyFound = true;
                             from = ranges[key].from;
                             to = ranges[key].to;
                             break;
@@ -3554,8 +3697,8 @@ var Flot = (function (exports) {
                 }
 
                 // 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"];
                 }
@@ -3570,7 +3713,7 @@ var Flot = (function (exports) {
                 return {
                     from: from,
                     to: to,
-                    axis: axis
+                    axis: /** @type {InternalAxis} */ (axis)
                 };
             }
 
@@ -3820,7 +3963,8 @@ var Flot = (function (exports) {
                 // 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;
@@ -3866,6 +4010,10 @@ var Flot = (function (exports) {
                 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 = {
@@ -4243,10 +4391,14 @@ var Flot = (function (exports) {
                     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) {
@@ -4533,7 +4685,7 @@ var Flot = (function (exports) {
         // Plugin registry. Plugins push to this array to register themselves.
         var plugins = [];
 
-        var version = "5.1.3";
+        var version = "5.1.4";
 
         // The main plot function.
         function plot(placeholder, data, options) {