add options.cache flag

Author: leeoniya

dist/uPlot.cjs.js

@@ -3282,6 +3282,8 @@ function uPlot(opts, data, then) {
 
 	opts = copy(opts);
 
+	const usePathCache = opts.cache ?? true;
+
 	const pxAlign = +ifNull(opts.pxAlign, 1);
 
 	const pxRound = pxRoundGen(pxAlign);
@@ -5233,14 +5235,19 @@ function uPlot(opts, data, then) {
 		viaAutoScaleX = false;
 
 		queuedCommit = false;
+
+		if (!usePathCache)
+			clearPathCache();
 	}
 
-	self.clearCache = () => {
+	function clearPathCache() {
 		series.forEach((s, i) => {
 			if (i > 0)
 				s._paths = null;
 		});
-	};
+	}
+
+	self.clearCache = clearPathCache;
 
 	self.redraw = (rebuildPaths, recalcAxes) => {
 		shouldConvergeSize = recalcAxes || false;

dist/uPlot.d.ts

@@ -414,6 +414,9 @@ declare namespace uPlot {
 		hooks?: Hooks.Arrays;
 
 		plugins?: Plugin[];
+
+		// controls whether canvas path cache is auto-cleared after every draw call (see caveats of clearCache() above)
+		cache?: boolean; // true
 	}
 
 	export interface Focus {

dist/uPlot.esm.js

@@ -3280,6 +3280,8 @@ function uPlot(opts, data, then) {
 
 	opts = copy(opts);
 
+	const usePathCache = opts.cache ?? true;
+
 	const pxAlign = +ifNull(opts.pxAlign, 1);
 
 	const pxRound = pxRoundGen(pxAlign);
@@ -5231,14 +5233,19 @@ function uPlot(opts, data, then) {
 		viaAutoScaleX = false;
 
 		queuedCommit = false;
+
+		if (!usePathCache)
+			clearPathCache();
 	}
 
-	self.clearCache = () => {
+	function clearPathCache() {
 		series.forEach((s, i) => {
 			if (i > 0)
 				s._paths = null;
 		});
-	};
+	}
+
+	self.clearCache = clearPathCache;
 
 	self.redraw = (rebuildPaths, recalcAxes) => {
 		shouldConvergeSize = recalcAxes || false;

dist/uPlot.iife.js

@@ -3283,6 +3283,8 @@ var uPlot = (function () {
 
 		opts = copy(opts);
 
+		const usePathCache = opts.cache ?? true;
+
 		const pxAlign = +ifNull(opts.pxAlign, 1);
 
 		const pxRound = pxRoundGen(pxAlign);
@@ -5234,14 +5236,19 @@ var uPlot = (function () {
 			viaAutoScaleX = false;
 
 			queuedCommit = false;
+
+			if (!usePathCache)
+				clearPathCache();
 		}
 
-		self.clearCache = () => {
+		function clearPathCache() {
 			series.forEach((s, i) => {
 				if (i > 0)
 					s._paths = null;
 			});
-		};
+		}
+
+		self.clearCache = clearPathCache;
 
 		self.redraw = (rebuildPaths, recalcAxes) => {
 			shouldConvergeSize = recalcAxes || false;

dist/uPlot.iife.min.js

@@ -355,6 +355,8 @@ export default function uPlot(opts, data, then) {
 
 	opts = copy(opts);
 
+	const usePathCache = opts.cache ?? true;
+
 	const pxAlign = +ifNull(opts.pxAlign, 1);
 
 	const pxRound = pxRoundGen(pxAlign);
@@ -2310,14 +2312,19 @@ export default function uPlot(opts, data, then) {
 		viaAutoScaleX = false;
 
 		queuedCommit = false;
+
+		if (!usePathCache)
+			clearPathCache();
 	}
 
-	self.clearCache = () => {
+	function clearPathCache() {
 		series.forEach((s, i) => {
 			if (i > 0)
 				s._paths = null;
 		});
-	};
+	}
+
+	self.clearCache = clearPathCache;
 
 	self.redraw = (rebuildPaths, recalcAxes) => {
 		shouldConvergeSize = recalcAxes || false;