@kevinburke/flot 5.0.0

package/source/helpers.js

@@ -0,0 +1,168 @@
+// Vanilla replacements for jQuery utility functions used throughout flot.
+
+function isPlainObject(value) {
+    if (!value || Object.prototype.toString.call(value) !== '[object Object]') {
+        return false;
+    }
+
+    var prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+
+function cloneDeepValue(value) {
+    if (Array.isArray(value)) {
+        return value.map(cloneDeepValue);
+    }
+
+    if (isPlainObject(value)) {
+        var copy = {};
+        var keys = Object.keys(value);
+        for (var i = 0; i < keys.length; i++) {
+            var key = keys[i];
+            var nestedValue = value[key];
+            if (nestedValue !== undefined) {
+                copy[key] = cloneDeepValue(nestedValue);
+            }
+        }
+        return copy;
+    }
+
+    return value;
+}
+
+// Deep-extend target with one or more source objects. When `deep` is true,
+// nested objects are recursively merged rather than replaced. Arrays are
+// replaced, not concatenated (matching $.extend behavior that flot relies on).
+export function extend(deep, target) {
+    var sources = Array.prototype.slice.call(arguments, 2);
+    if (typeof deep !== 'boolean') {
+        sources.unshift(target);
+        target = deep;
+        deep = false;
+    }
+
+    for (var i = 0; i < sources.length; i++) {
+        var src = sources[i];
+        if (src == null) continue;
+        var keys = Object.keys(src);
+        for (var k = 0; k < keys.length; k++) {
+            var key = keys[k];
+            var val = src[key];
+            if (val === undefined) {
+                continue;
+            }
+            if (deep && Array.isArray(val)) {
+                target[key] = cloneDeepValue(val);
+                continue;
+            }
+            if (deep && isPlainObject(val)) {
+                if (typeof target[key] !== 'object' || target[key] == null) {
+                    target[key] = {};
+                }
+                extend(true, target[key], val);
+            } else {
+                target[key] = val;
+            }
+        }
+    }
+
+    return target;
+}
+
+// Get inner width of an element (content area, no padding/border/scrollbar).
+export function width(el) {
+    return el.clientWidth;
+}
+
+// Get inner height of an element.
+export function height(el) {
+    return el.clientHeight;
+}
+
+// Get or set a CSS property on an element.
+export function css(el, prop, val) {
+    if (val !== undefined) {
+        el.style[prop] = typeof val === 'number' ? val + 'px' : val;
+        return;
+    }
+    return getComputedStyle(el)[prop];
+}
+
+// Store or retrieve arbitrary data on an element.
+var dataStore = new WeakMap();
+
+export function data(el, key, val) {
+    var store = dataStore.get(el);
+    if (!store) {
+        store = {};
+        dataStore.set(el, store);
+    }
+    if (val !== undefined) {
+        store[key] = val;
+        return;
+    }
+    return store[key];
+}
+
+export function removeData(el, key) {
+    var store = dataStore.get(el);
+    if (store) {
+        if (key) {
+            delete store[key];
+        } else {
+            dataStore.delete(el);
+        }
+    }
+}
+
+// Trigger a custom event on an element. Extra args are passed as the
+// event's `detail` property (an array). For jQuery adapter compatibility,
+// the adapter re-dispatches these as jQuery events so $(el).on() works.
+export function trigger(el, type, args) {
+    var event = new CustomEvent(type, {
+        detail: args || [],
+        bubbles: true,
+        cancelable: true
+    });
+    el.dispatchEvent(event);
+    return event;
+}
+
+// Bind an event listener, tracking it so unbindAll can remove it later.
+var listenerStore = new WeakMap();
+
+export function bind(el, type, handler) {
+    el.addEventListener(type, handler);
+    var listeners = listenerStore.get(el);
+    if (!listeners) {
+        listeners = [];
+        listenerStore.set(el, listeners);
+    }
+    listeners.push({ type: type, handler: handler });
+}
+
+export function unbind(el, type, handler) {
+    if (type && handler) {
+        el.removeEventListener(type, handler);
+        var listeners = listenerStore.get(el);
+        if (listeners) {
+            listenerStore.set(el, listeners.filter(function(l) {
+                return l.type !== type || l.handler !== handler;
+            }));
+        }
+        return;
+    }
+    // Remove all listeners (optionally filtered by type)
+    var listeners = listenerStore.get(el);
+    if (listeners) {
+        var remaining = [];
+        for (var i = 0; i < listeners.length; i++) {
+            if (type && listeners[i].type !== type) {
+                remaining.push(listeners[i]);
+            } else {
+                el.removeEventListener(listeners[i].type, listeners[i].handler);
+            }
+        }
+        listenerStore.set(el, remaining);
+    }
+}

package/source/index.js

@@ -0,0 +1,70 @@
+// Main entry point for @kevinburke/flot.
+//
+// This module has NO jQuery dependency. It exports the core plot
+// function and all bundled plugins. Use it directly:
+//
+//   import { plot } from '@kevinburke/flot';
+//   plot(document.getElementById('ph'), data, options);
+//
+// For jQuery backwards compatibility ($.plot), import the adapter:
+//
+//   import '@kevinburke/flot/jquery';
+
+// Core modules
+import { Canvas } from './jquery.canvaswrapper.js';
+import { color } from './jquery.colorhelpers.js';
+import { saturated } from './jquery.flot.saturated.js';
+import { browser } from './jquery.flot.browser.js';
+import { uiConstants } from './jquery.flot.uiConstants.js';
+import { drawSeries as drawSeriesModule } from './jquery.flot.drawSeries.js';
+
+// Core plot function and plugin registry
+import {
+    plot,
+    plugins,
+    version,
+    linearTickGenerator,
+    defaultTickFormatter,
+    expRepTickFormatter,
+} from './jquery.flot.js';
+
+// Bundled plugins (side-effect imports — each pushes to `plugins`)
+import './jquery.flot.errorbars.js';
+import { logTicksGenerator, logTickFormatter } from './jquery.flot.logaxis.js';
+import './jquery.flot.symbol.js';
+import './jquery.flot.flatdata.js';
+import './jquery.flot.navigate.js';
+import './jquery.flot.fillbetween.js';
+import './jquery.flot.categories.js';
+import './jquery.flot.stack.js';
+import './jquery.flot.touchNavigate.js';
+import './jquery.flot.hover.js';
+import './jquery.flot.touch.js';
+import { formatDate, makeUtcWrapper, dateGenerator, dateTickGenerator } from './jquery.flot.time.js';
+import './jquery.flot.axislabels.js';
+import './jquery.flot.selection.js';
+import { composeImages } from './jquery.flot.composeImages.js';
+import './jquery.flot.legend.js';
+
+// Named exports.
+export {
+    Canvas,
+    color,
+    saturated,
+    browser,
+    uiConstants,
+    drawSeriesModule as drawSeries,
+    plot,
+    plugins,
+    version,
+    linearTickGenerator,
+    defaultTickFormatter,
+    expRepTickFormatter,
+    logTicksGenerator,
+    logTickFormatter,
+    formatDate,
+    makeUtcWrapper,
+    dateGenerator,
+    dateTickGenerator,
+    composeImages,
+};

package/source/jquery-adapter.js

@@ -0,0 +1,83 @@
+// jQuery adapter for @kevinburke/flot.
+//
+// Loads the core (jQuery-free) and wires everything onto the jQuery
+// namespace so existing $.plot() code works unchanged.
+//
+// Usage:
+//   <script src="jquery.js"></script>
+//   <script src="dist/jquery.flot.js"></script>
+//   <script>$.plot("#placeholder", data, options);</script>
+//
+// Or as ESM:
+//   import '@kevinburke/flot/jquery';
+//   $.plot("#placeholder", data, options);
+
+import $ from 'jquery';
+
+import {
+    Canvas,
+    color,
+    saturated,
+    browser,
+    uiConstants,
+    drawSeries,
+    plot,
+    plugins,
+    version,
+    linearTickGenerator,
+    defaultTickFormatter,
+    expRepTickFormatter,
+    logTicksGenerator,
+    logTickFormatter,
+    formatDate,
+    makeUtcWrapper,
+    dateGenerator,
+    dateTickGenerator,
+    composeImages,
+} from './index.js';
+
+// Register $.plot and $.color on the jQuery object.
+$.plot = function(placeholder, data, options) {
+    var el = typeof placeholder === 'string'
+        ? document.querySelector(placeholder)
+        : (placeholder instanceof $ ? placeholder[0] : placeholder);
+    return plot(el, data, options);
+};
+
+$.plot.plugins = plugins;
+$.plot.version = version;
+$.plot.saturated = saturated;
+$.plot.browser = browser;
+$.plot.uiConstants = uiConstants;
+$.plot.drawSeries = drawSeries;
+$.plot.linearTickGenerator = linearTickGenerator;
+$.plot.defaultTickFormatter = defaultTickFormatter;
+$.plot.expRepTickFormatter = expRepTickFormatter;
+$.plot.logTicksGenerator = logTicksGenerator;
+$.plot.logTickFormatter = logTickFormatter;
+$.plot.formatDate = formatDate;
+$.plot.makeUtcWrapper = makeUtcWrapper;
+$.plot.dateGenerator = dateGenerator;
+$.plot.dateTickGenerator = dateTickGenerator;
+$.plot.composeImages = composeImages;
+// Wrap color.extract to accept jQuery-wrapped elements.
+var origExtract = color.extract;
+$.color = Object.create(color);
+$.color.extract = function(elem, cssProp) {
+    if (elem instanceof $ && elem.length) elem = elem[0];
+    return origExtract(elem, cssProp);
+};
+
+// Chainable jQuery plugin: $(el).plot(data, options)
+$.fn.plot = function(data, options) {
+    return this.each(function() {
+        plot(this, data, options);
+    });
+};
+
+if (typeof window !== 'undefined') {
+    if (!window.Flot) {
+        window.Flot = {};
+    }
+    window.Flot.Canvas = Canvas;
+}