@ixfx/components 0.4.2 → 0.4.3

package/bundle/index.js

@@ -30795,6 +30795,8 @@ function applyAgeModification(base, ageFraction, ageStyle) {
 */
 var PlotDataSeries = class {
 	#rangeStream;
+	#rangeAuto;
+	#rangeManual;
 	#options;
 	/**
 	* Constructor.
@@ -30802,20 +30804,46 @@ var PlotDataSeries = class {
 	* Default options:
 	* - `capacityLimit`: 100
 	* - `persistentScaling`: true
+	* - `fixedRange`: null
 	* @param options
 	*/
 	constructor(options = {}) {
 		this.values = [];
 		this.#rangeStream = rangeStream();
-		this.range = {
+		this.#rangeAuto = {
 			min: 0,
 			max: 0
 		};
+		this.#rangeManual = null;
 		this.#options = {
 			capacityLimit: 100,
 			persistentScaling: true,
+			fixedRange: null,
 			...options
 		};
+		if (this.#options.fixedRange !== null) this.#rangeManual = this.#options.fixedRange;
+	}
+	/**
+	* Sets a manual range, this disabled auto-scaling.
+	* Use {@link unsetRange} to re-enable auto-scaling.
+	* @param min
+	* @param max
+	*/
+	setRange(min, max) {
+		this.#rangeManual = {
+			min,
+			max
+		};
+	}
+	/**
+	* Disable the manual range
+	*/
+	unsetRange() {
+		this.#rangeManual = null;
+		this.#recompute();
+	}
+	get isAutoRange() {
+		return this.#rangeManual === null;
 	}
 	/**
 	* Adds a single value
@@ -30824,19 +30852,19 @@ var PlotDataSeries = class {
 	add(valueOrValues) {
 		if (typeof valueOrValues === `number`) {
 			this.values.push(valueOrValues);
-			this.range = this.#rangeStream.seen(valueOrValues);
+			if (this.isAutoRange) this.#rangeAuto = this.#rangeStream.seen(valueOrValues);
 		} else {
 			this.values.push(...valueOrValues);
-			for (const v of valueOrValues) this.range = this.#rangeStream.seen(v);
+			if (this.isAutoRange) for (const v of valueOrValues) this.#rangeAuto = this.#rangeStream.seen(v);
 		}
 		if (this.values.length > this.#options.capacityLimit) {
 			this.values = this.values.slice(this.values.length - this.#options.capacityLimit);
-			if (!this.#options.persistentScaling) this.#recompute();
+			if (!this.#options.persistentScaling && this.isAutoRange) this.#recompute();
 		}
 	}
 	#recompute() {
 		if (!this.#options.persistentScaling) this.#rangeStream = rangeStream();
-		for (let i = 0; i < this.values.length; i++) this.range = this.#rangeStream.seen(this.values[i]);
+		for (let i = 0; i < this.values.length; i++) this.#rangeAuto = this.#rangeStream.seen(this.values[i]);
 	}
 	/**
 	* Sets the entire data series at once, replacing any existing data. If the number of values exceeds the `capacityLimit`, only the most recent values up to the limit are kept.
@@ -30848,6 +30876,13 @@ var PlotDataSeries = class {
 		this.#recompute();
 	}
 	/**
+	* Returns the manual range if this is in effect, or the automatic
+	*/
+	get range() {
+		if (this.#rangeManual) return this.#rangeManual;
+		return this.#rangeAuto;
+	}
+	/**
 	* Clear all data and reset range. If `persistentScaling` is _false_, also resets scaling to initial state.
 	* @returns _true_ if there was data to clear
 	*/
@@ -31465,6 +31500,8 @@ let PlotSingleAxis = class PlotSingleAxis extends i$4 {
 		this.precise = false;
 		this.tooltips = true;
 		this.capacity = 100;
+		this.rangeMin = NaN;
+		this.rangeMax = NaN;
 		this.persistentScale = true;
 		this.paused = false;
 		this.clickPauses = false;
@@ -31476,10 +31513,7 @@ let PlotSingleAxis = class PlotSingleAxis extends i$4 {
 		this.colorValueMap = null;
 		this._width = 100;
 		this._height = 40;
-		this.#series = new PlotDataSeries({
-			capacityLimit: 100,
-			persistentScaling: true
-		});
+		this.#series = new PlotDataSeries();
 		this.#hasProgrammaticData = false;
 		this.#lastClientX = null;
 		this.#lastClientY = null;
@@ -31531,32 +31565,6 @@ let PlotSingleAxis = class PlotSingleAxis extends i$4 {
 		return text.trim().split(/[,\s;]+/).map((t) => Number.parseFloat(t)).filter((n) => !Number.isNaN(n));
 	}
 	/**
-	* Get all values in the data series as a readonly array.
-	*/
-	get values() {
-		return this.#series.values;
-	}
-	/**
-	* Get length of data series
-	*/
-	get dataCount() {
-		return this.#series.values.length;
-	}
-	/**
-	* Get value at specific index of data series
-	* @param index
-	*/
-	getValueAt(index) {
-		return this.#series.values[index];
-	}
-	/**
-	* Get value index based on client X position
-	* @param clientX
-	*/
-	getIndexFromClientX(clientX) {
-		return this.#getIndexFromX(clientX, this.getBoundingClientRect());
-	}
-	/**
 	* Adds a value to the data series.
 	*
 	* Pass `withholdRedraw = true` to prevent automatic redraw after adding the value. In this case, call `redraw()` manually after adding all values to update the plot.
@@ -31618,11 +31626,16 @@ let PlotSingleAxis = class PlotSingleAxis extends i$4 {
 		}
 	}
 	updated(changed) {
-		if (changed.has(`capacity`) || changed.has(`persistentScale`)) {
+		if (changed.has(`capacity`) || changed.has(`persistentScale`) || changed.has(`rangeMin`) || changed.has(`rangeMax`)) {
 			const old = [...this.#series.values];
+			const fixedRange = !Number.isNaN(this.rangeMin) && !Number.isNaN(this.rangeMax) ? {
+				min: this.rangeMin,
+				max: this.rangeMax
+			} : null;
 			this.#series = new PlotDataSeries({
 				capacityLimit: this.capacity,
-				persistentScaling: this.persistentScale
+				persistentScaling: this.persistentScale,
+				fixedRange
 			});
 			if (old.length > 0) this.#series.set(old);
 		}
@@ -31659,7 +31672,7 @@ let PlotSingleAxis = class PlotSingleAxis extends i$4 {
 		const widthPerPoint = n > 0 ? plotW / n : plotW;
 		const scaleX = (i) => padding + (i + .5) * widthPerPoint;
 		return values.map((value, index) => {
-			const sv = scaleValue(value, min, max);
+			const sv = clamp$3(scaleValue(value, min, max));
 			const ageFraction = n > 1 ? index / (n - 1) : 1;
 			return {
 				x: scaleX(index),
@@ -31671,6 +31684,35 @@ let PlotSingleAxis = class PlotSingleAxis extends i$4 {
 			};
 		});
 	}
+	get series() {
+		return this.#series;
+	}
+	/**
+	* Get all values in the data series as a readonly array.
+	*/
+	get values() {
+		return this.#series.values;
+	}
+	/**
+	* Get length of data series
+	*/
+	get dataLength() {
+		return this.#series.values.length;
+	}
+	/**
+	* Get value at specific index of data series
+	* @param index
+	*/
+	getValueAt(index) {
+		return this.#series.values[index];
+	}
+	/**
+	* Get value index based on client X position
+	* @param clientX
+	*/
+	getIndexFromClientX(clientX) {
+		return this.#getIndexFromX(clientX, this.getBoundingClientRect());
+	}
 	#renderByStyle(points, crs, strokeW, radius, barW, bottom, top, mid) {
 		const lineCr = crs.at(-1) ?? {
 			fill: `currentColor`,
@@ -31781,6 +31823,8 @@ __decorate$1([n$2()], PlotSingleAxis.prototype, "title", void 0);
 __decorate$1([n$2({ type: Boolean })], PlotSingleAxis.prototype, "precise", void 0);
 __decorate$1([n$2({ type: Boolean })], PlotSingleAxis.prototype, "tooltips", void 0);
 __decorate$1([n$2({ type: Number })], PlotSingleAxis.prototype, "capacity", void 0);
+__decorate$1([n$2({ type: Number })], PlotSingleAxis.prototype, "rangeMin", void 0);
+__decorate$1([n$2({ type: Number })], PlotSingleAxis.prototype, "rangeMax", void 0);
 __decorate$1([n$2({
 	type: Boolean,
 	attribute: `persistent-scale`