stream-charts 1.0.0 → 1.1.0

package/dist/src/app/charts/axes/ContinuousAxis.d.ts

@@ -0,0 +1,22 @@
+import { AxesFont, AxisLocation } from "./axes";
+import { ScaleContinuousNumeric } from "d3";
+interface Props {
+    axisId: string;
+    location: AxisLocation;
+    scale?: ScaleContinuousNumeric<number, number>;
+    domain: [min: number, max: number];
+    font?: Partial<AxesFont>;
+    label: string;
+    updateAxisBasedOnDomainValues?: boolean;
+}
+/**
+ * Represents a continuous numeric axis (x or y) that can be place on the top, bottom,
+ * left, or right of the chart. The domain (axis range) can be managed by this axis
+ *  component or managed externally (i.e. deferred). This component returns null, meaning
+ * React won't render it because we are updating the SVG element and don't want React
+ * involved, except to call this function if the props change.
+ * @param props The properties for the axis
+ * @constructor
+ */
+export declare function ContinuousAxis(props: Props): null;
+export {};

package/dist/src/app/charts/axes/ContinuousAxis.js

@@ -0,0 +1,96 @@
+import { addContinuousNumericXAxis, addContinuousNumericYAxis, AxisLocation, defaultAxesFont, labelIdFor } from "./axes";
+import { useChart } from "../hooks/useChart";
+import { useEffect, useRef } from "react";
+import * as d3 from "d3";
+import { usePlotDimensions } from "../hooks/usePlotDimensions";
+import { AxisInterval } from "./AxisInterval";
+import { ContinuousAxisRange } from "./ContinuousAxisRange";
+/**
+ * Represents a continuous numeric axis (x or y) that can be place on the top, bottom,
+ * left, or right of the chart. The domain (axis range) can be managed by this axis
+ *  component or managed externally (i.e. deferred). This component returns null, meaning
+ * React won't render it because we are updating the SVG element and don't want React
+ * involved, except to call this function if the props change.
+ * @param props The properties for the axis
+ * @constructor
+ */
+export function ContinuousAxis(props) {
+    const { chartId, container, axes, color } = useChart();
+    const { xAxesState, yAxesState, addXAxis, addYAxis, axisRangeFor, setAxisIntervalFor, setAxisRangeFor, addAxesRangesUpdateHandler, } = axes;
+    const { plotDimensions, margin } = usePlotDimensions();
+    const { axisId, location, scale = d3.scaleLinear(), domain, updateAxisBasedOnDomainValues = true, label, } = props;
+    const axisRef = useRef(undefined);
+    const rangeUpdateHandlerIdRef = useRef(undefined);
+    const axisIdRef = useRef(axisId);
+    const marginRef = useRef(margin);
+    const domainRef = useRef(AxisInterval.as(domain));
+    useEffect(() => {
+        axisIdRef.current = axisId;
+        marginRef.current = margin;
+    }, [axisId, plotDimensions, margin]);
+    useEffect(() => {
+        if (container) {
+            const svg = d3.select(container);
+            const font = Object.assign(Object.assign(Object.assign({}, defaultAxesFont()), { color }), props.font);
+            const handleRangeUpdates = (updates, plotDim) => {
+                if (rangeUpdateHandlerIdRef.current && axisRef.current) {
+                    const range = updates.get(axisId);
+                    if (range) {
+                        axisRef.current.update(range.current, plotDim, marginRef.current);
+                    }
+                }
+            };
+            if (axisRef.current === undefined) {
+                switch (location) {
+                    case AxisLocation.Bottom:
+                    case AxisLocation.Top: {
+                        axisRef.current = addContinuousNumericXAxis(chartId, axisId, svg, plotDimensions, location, scale, domain, font, margin, label, setAxisIntervalFor);
+                        // add the x-axis to the chart context
+                        const [start, end] = AxisInterval.as(domain).asTuple();
+                        addXAxis(axisRef.current, axisId, ContinuousAxisRange.from(start, end));
+                        // addXAxis(axisRef.current, axisId, AxisInterval.as(domain))
+                        // add an update handler
+                        rangeUpdateHandlerIdRef.current = `x-axis-${chartId}-${location.valueOf()}`;
+                        addAxesRangesUpdateHandler(rangeUpdateHandlerIdRef.current, handleRangeUpdates);
+                        break;
+                    }
+                    case AxisLocation.Left:
+                    case AxisLocation.Right: {
+                        axisRef.current = addContinuousNumericYAxis(chartId, axisId, svg, plotDimensions, location, scale, domain, font, margin, label, setAxisIntervalFor);
+                        // add the y-axis to the chart context
+                        const [start, end] = AxisInterval.as(domain).asTuple();
+                        addYAxis(axisRef.current, axisId, ContinuousAxisRange.from(start, end));
+                        // addYAxis(axisRef.current, axisId, AxisInterval.as(domain))
+                        // add an update handler
+                        rangeUpdateHandlerIdRef.current = `y-axis-${chartId}-${location.valueOf()}`;
+                        addAxesRangesUpdateHandler(rangeUpdateHandlerIdRef.current, handleRangeUpdates);
+                    }
+                }
+            }
+            else {
+                const axisRange = axisRangeFor(axisId);
+                const domain = axisRange
+                    .map(range => range.current)
+                    .getOrElse(AxisInterval.empty());
+                if (domain.isNotEmpty()) {
+                    axisRef.current.update(domain, plotDimensions, margin);
+                }
+                if ((updateAxisBasedOnDomainValues && (domainRef.current.start !== domain.start || domainRef.current.end !== domain.end)) ||
+                    (!updateAxisBasedOnDomainValues && domainRef.current !== domain)) {
+                    domainRef.current = domain;
+                    axisRange.ifPresent(range => setAxisRangeFor(axisId, range.updateOriginal(domain.start, domain.end)));
+                }
+                svg.select(`#${labelIdFor(chartId, location)}`).attr('fill', color);
+            }
+        }
+    }, [
+        chartId, axisId, label, location, props.font, xAxesState, yAxesState, addXAxis, addYAxis, domain,
+        scale, container, margin, plotDimensions, setAxisIntervalFor,
+        axisRangeFor,
+        addAxesRangesUpdateHandler,
+        setAxisRangeFor,
+        color, updateAxisBasedOnDomainValues
+    ]);
+    return null;
+}
+//# sourceMappingURL=ContinuousAxis.js.map

package/dist/src/app/charts/axes/ContinuousAxis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContinuousAxis.js","sourceRoot":"","sources":["../../../../../src/app/charts/axes/ContinuousAxis.tsx"],"names":[],"mappings":"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"}

package/dist/src/app/charts/axes/ContinuousAxisRange.d.ts

@@ -0,0 +1,59 @@
+import { BaseAxisRange } from "./BaseAxisRange";
+/**
+ * An immutable continuous-axis range that holds the current range and the original (no zoom) range.
+ * Create an instance using the {@link ContinuousAxisRange.from} factory method.
+ */
+export declare class ContinuousAxisRange extends BaseAxisRange {
+    private constructor();
+    /**
+     * Factory function for creating a new continuous-axis range instance.
+     * @param start The start of the axis-range.
+     * @param end The end of the axis-range.
+     * @param [originalStart=start] The optional original start of the axis-range (e.g. before any zooming or panning.
+     * Defaults to the start value if not specified.)
+     * @param [originalEnd=end] The optional original end of the axis-range (e.g. before any zooming or panning.
+     * Defaults to the end value if not specified.)
+     * @return A new continuous-axis range instance.
+     */
+    static from(start: number, end: number, originalStart?: number, originalEnd?: number): ContinuousAxisRange;
+    /**
+     * Scales the axis-range by the specified scale factor from the specified value. The equations
+     * are written so that the zooming (scaling) occurs at the specified value and expands/contracts equally
+     * from that value.
+     * @param factor The scale factor
+     * @param value The value from which to scale the interval
+     * @return A new continuous-axis range with updated values
+     */
+    scale(factor: number, value: number): ContinuousAxisRange;
+    /**
+     * Scales the axis-range by the specified scale factor from the specified value, while keeping
+     * the range within the constraints (start, end). The equations are written so that the zooming
+     * (scaling) occurs at the specified value, and expands/contracts equally from that value.
+     * @param factor The scale factor
+     * @param value The value from which to scale the interval
+     * @param constraint The minimum and maximum values that range bounds can be
+     * @return A new continuous-axis range with updated values
+     */
+    constrainedScale(factor: number, value: number, constraint: [min: number, max: number]): BaseAxisRange;
+    /**
+     * Translates the axis-range by the specified amount
+     * @param amount The amount by which to translate the axis-range
+     * @param [constraint=[-Infinity, Infinity]] Optional constraint interval in which the axis range must be within
+     * @return An updated {@link ContinuousAxisRange} that has been translated by the specified amount
+     */
+    translate(amount: number, constraint?: [start: number, end: number]): ContinuousAxisRange;
+    /**
+     * Updates the axis-range with the new start and end values, leaving the original range unchanged.
+     * @param start The new start of the axis-range
+     * @param end The new end of the axis range
+     * @return The updated axis-range type, with all other values unchanged.
+     */
+    update(start: number, end: number): ContinuousAxisRange;
+    /**
+     * Updates the original range with the new start and end values.
+     * @param start The new value for the start of the original range
+     * @param end The new value for the end of the original range
+     * @return The updated original range.
+     */
+    updateOriginal(start: number, end: number): BaseAxisRange;
+}

package/dist/src/app/charts/axes/ContinuousAxisRange.js

@@ -0,0 +1,84 @@
+import { BaseAxisRange } from "./BaseAxisRange";
+/**
+ * An immutable continuous-axis range that holds the current range and the original (no zoom) range.
+ * Create an instance using the {@link ContinuousAxisRange.from} factory method.
+ */
+export class ContinuousAxisRange extends BaseAxisRange {
+    constructor(start, end, originalStart = start, originalEnd = end) {
+        super(start, end, originalStart, originalEnd);
+    }
+    /**
+     * Factory function for creating a new continuous-axis range instance.
+     * @param start The start of the axis-range.
+     * @param end The end of the axis-range.
+     * @param [originalStart=start] The optional original start of the axis-range (e.g. before any zooming or panning.
+     * Defaults to the start value if not specified.)
+     * @param [originalEnd=end] The optional original end of the axis-range (e.g. before any zooming or panning.
+     * Defaults to the end value if not specified.)
+     * @return A new continuous-axis range instance.
+     */
+    static from(start, end, originalStart = start, originalEnd = end) {
+        return new ContinuousAxisRange(start, end, originalStart, originalEnd);
+    }
+    /**
+     * Scales the axis-range by the specified scale factor from the specified value. The equations
+     * are written so that the zooming (scaling) occurs at the specified value and expands/contracts equally
+     * from that value.
+     * @param factor The scale factor
+     * @param value The value from which to scale the interval
+     * @return A new continuous-axis range with updated values
+     */
+    scale(factor, value) {
+        const scaledInterval = this.scaledRange(factor, value);
+        return new ContinuousAxisRange(scaledInterval.start, scaledInterval.end, this.original.start, this.original.end);
+    }
+    /**
+     * Scales the axis-range by the specified scale factor from the specified value, while keeping
+     * the range within the constraints (start, end). The equations are written so that the zooming
+     * (scaling) occurs at the specified value, and expands/contracts equally from that value.
+     * @param factor The scale factor
+     * @param value The value from which to scale the interval
+     * @param constraint The minimum and maximum values that range bounds can be
+     * @return A new continuous-axis range with updated values
+     */
+    constrainedScale(factor, value, constraint) {
+        const scaledInterval = this.scaledRange(factor, value);
+        const [min, max] = constraint;
+        return new ContinuousAxisRange(Math.max(min, scaledInterval.start), Math.min(max, scaledInterval.end), this.original.start, this.original.end);
+    }
+    /**
+     * Translates the axis-range by the specified amount
+     * @param amount The amount by which to translate the axis-range
+     * @param [constraint=[-Infinity, Infinity]] Optional constraint interval in which the axis range must be within
+     * @return An updated {@link ContinuousAxisRange} that has been translated by the specified amount
+     */
+    translate(amount, constraint = [-Infinity, Infinity]) {
+        const [cs, ce] = constraint;
+        // when either of the constraints is infinite, or the pan keeps the new axis range
+        // within the origin axis range (i.e. zoomed in and the panned), then allow the pan,
+        // otherwise don't update
+        if ((!isFinite(cs) && !isFinite(ce)) || (this.current.start + amount >= cs && this.current.end + amount <= ce)) {
+            return new ContinuousAxisRange(this.current.start + amount, this.current.end + amount, this.original.start, this.original.end);
+        }
+        return new ContinuousAxisRange(this.current.start, this.current.end, this.original.start, this.original.end);
+    }
+    /**
+     * Updates the axis-range with the new start and end values, leaving the original range unchanged.
+     * @param start The new start of the axis-range
+     * @param end The new end of the axis range
+     * @return The updated axis-range type, with all other values unchanged.
+     */
+    update(start, end) {
+        return new ContinuousAxisRange(start, end, this.original.start, this.original.end);
+    }
+    /**
+     * Updates the original range with the new start and end values.
+     * @param start The new value for the start of the original range
+     * @param end The new value for the end of the original range
+     * @return The updated original range.
+     */
+    updateOriginal(start, end) {
+        return new ContinuousAxisRange(this.current.start, this.current.end, start, end);
+    }
+}
+//# sourceMappingURL=ContinuousAxisRange.js.map

package/dist/src/app/charts/axes/ContinuousAxisRange.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContinuousAxisRange.js","sourceRoot":"","sources":["../../../../../src/app/charts/axes/ContinuousAxisRange.ts"],"names":[],"mappings":"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"}

package/dist/src/app/charts/axes/ContinuousAxisRange.test.js

@@ -0,0 +1,47 @@
+import { ContinuousAxisRange } from "./ContinuousAxisRange";
+test('creates a time-range', () => {
+    const timeRange = ContinuousAxisRange.from(10, 100);
+    expect(timeRange.current).toEqual({ start: 10, end: 100 });
+    expect(timeRange.scaleFactor).toBe(1);
+});
+test('scaling a time-range', () => {
+    const timeRange = ContinuousAxisRange.from(0, 100).scale(2, 50);
+    // the midpoint must remain at 50, so the new range will be 50 - 2 * (50 - 0) to
+    // 50 + 2 * (100 - 50) => (-50, 150)
+    expect(timeRange.current).toEqual({ start: -50, end: 150 });
+    expect(timeRange.scaleFactor).toBe(2);
+    // setting the scale factor back to 1, from its current value of 2 should
+    // return the original time-range (this may be a bit unintuitive, because it
+    // may seem like we should pass in a factor of 0.5 to shrink the scale back, but
+    // that would mean the new interval has a scale factor 4 times smaller.)
+    // this behavior is implemented so that zooming in at out from a point seems
+    // natural to the user.
+    const original = timeRange.scale(1, 50);
+    expect(original.current).toEqual({ start: 0, end: 100 });
+    expect(original.scaleFactor).toBe(1);
+    // the original shouldn't be changed
+    expect(timeRange.current).toEqual({ start: -50, end: 150 });
+    expect(timeRange.scaleFactor).toBe(2);
+});
+test('translating a time-range', () => {
+    const timeRange = ContinuousAxisRange.from(0, 100).translate(50);
+    expect(timeRange.current).toEqual({ start: 50, end: 150 });
+    expect(timeRange.scaleFactor).toBe(1);
+});
+test('scaling and translating', () => {
+    const original = ContinuousAxisRange.from(0, 100);
+    const scaled = original.scale(2, 50);
+    const translated = scaled.translate(50);
+    expect(translated.current).toEqual({ start: 0, end: 200 });
+    expect(translated.scaleFactor).toBe(2);
+    // after the translation, the time-range should shrink around the new time
+    const rescaled = translated.scale(1, 100);
+    expect(rescaled.current).toEqual({ start: 50, end: 150 });
+    expect(rescaled.scaleFactor).toBe(1);
+    // the original interval, maintained by each new time-range, should not change
+    expect(original.matchesOriginal(0, 100)).toEqual(true);
+    expect(scaled.matchesOriginal(0, 100)).toEqual(true);
+    expect(translated.matchesOriginal(0, 100)).toEqual(true);
+    expect(rescaled.matchesOriginal(0, 100)).toEqual(true);
+});
+//# sourceMappingURL=ContinuousAxisRange.test.js.map

package/dist/src/app/charts/axes/ContinuousAxisRange.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContinuousAxisRange.test.js","sourceRoot":"","sources":["../../../../../src/app/charts/axes/ContinuousAxisRange.test.ts"],"names":[],"mappings":"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"}

package/dist/src/app/charts/axes/OrdinalAxis.d.ts

@@ -0,0 +1,23 @@
+import { AxesFont, AxisLocation, AxisTickStyle } from "./axes";
+import { ScaleBand } from "d3";
+interface Props {
+    axisId: string;
+    location: AxisLocation;
+    scale?: ScaleBand<string>;
+    categories: Array<string>;
+    font?: Partial<AxesFont>;
+    axisTickStyle?: Partial<AxisTickStyle>;
+    label: string;
+    updateAxisBasedOnDomainValues?: boolean;
+}
+/**
+ * Category axis that represents the x-axis when its location is either on the bottom or the top.
+ * When the axis location is left or right, then the category axis represents the y-axis. The category
+ * axis requires a set of categories that will form the axis. Generally, these categories should
+ * be the name of the series used to represent each category.
+ * @param props The properties for the component
+ * @return null
+ * @constructor
+ */
+export declare function OrdinalAxis(props: Props): null;
+export {};

package/dist/src/app/charts/axes/OrdinalAxis.js

@@ -0,0 +1,124 @@
+import { addOrdinalStringAxis, AxisLocation, defaultAxesFont, defaultAxisTickStyle, labelIdFor } from "./axes";
+import * as d3 from "d3";
+import { useChart } from "../hooks/useChart";
+import { useEffect, useRef } from "react";
+import { usePlotDimensions } from "../hooks/usePlotDimensions";
+import { OrdinalAxisRange } from "./OrdinalAxisRange";
+import { AxisInterval } from "./AxisInterval";
+/**
+ * Category axis that represents the x-axis when its location is either on the bottom or the top.
+ * When the axis location is left or right, then the category axis represents the y-axis. The category
+ * axis requires a set of categories that will form the axis. Generally, these categories should
+ * be the name of the series used to represent each category.
+ * @param props The properties for the component
+ * @return null
+ * @constructor
+ */
+export function OrdinalAxis(props) {
+    const { chartId, container, axes, color, } = useChart();
+    const { xAxesState, yAxesState, addXAxis, addYAxis, setAxisIntervalFor, axisRangeFor, addAxesRangesUpdateHandler, setOriginalAxisIntervalFor, } = axes;
+    const { plotDimensions, margin, registerPlotDimensionChangeHandler, unregisterPlotDimensionChangeHandler } = usePlotDimensions();
+    const { axisId, location, categories, updateAxisBasedOnDomainValues = true, label, } = props;
+    const rangeUpdateHandlerIdRef = useRef(undefined);
+    const axis = location === AxisLocation.Top || location === AxisLocation.Bottom ?
+        xAxesState.axisFor(axisId).getOrUndefined() :
+        yAxesState.axisFor(axisId).getOrUndefined();
+    // handles plot size changes by updating the range of the axis and the original range of the axis
+    useEffect(() => {
+        if (container) {
+            const svg = d3.select(container);
+            const font = Object.assign(Object.assign(Object.assign({}, defaultAxesFont()), { color }), props.font);
+            const axisTickStyle = Object.assign(Object.assign({}, defaultAxisTickStyle()), props.axisTickStyle);
+            // lambda that gets called when the axes need to be updated
+            const handleRangeUpdates = (updates, plotDim) => {
+                if (rangeUpdateHandlerIdRef.current && axis) {
+                    const range = updates.get(axisId);
+                    if (range) {
+                        axis.update(range.current, range.original, plotDim, margin);
+                    }
+                }
+            };
+            if (axis === undefined) {
+                // add the x-axis or y-axis to the chart context depending on its
+                // location
+                switch (location) {
+                    case AxisLocation.Top:
+                    case AxisLocation.Bottom: {
+                        const xAxis = addOrdinalStringAxis(chartId, axisId, svg, location, categories, label, font, axisTickStyle, plotDimensions, margin, setAxisIntervalFor, setOriginalAxisIntervalFor);
+                        // add the x-axis to the chart context
+                        const [start, end] = AxisInterval.as(xAxis.scale.range()).asTuple();
+                        addXAxis(xAxis, axisId, OrdinalAxisRange.from(start, end));
+                        // add an update handler
+                        rangeUpdateHandlerIdRef.current = `x-axis-${chartId}-${location.valueOf()}`;
+                        addAxesRangesUpdateHandler(rangeUpdateHandlerIdRef.current, handleRangeUpdates);
+                        break;
+                    }
+                    case AxisLocation.Left:
+                    case AxisLocation.Right: {
+                        const yAxis = addOrdinalStringAxis(chartId, axisId, svg, location, categories, label, font, axisTickStyle, plotDimensions, margin, setAxisIntervalFor, setOriginalAxisIntervalFor);
+                        // add the y-axis to the chart context
+                        const [start, end] = AxisInterval.as(yAxis.scale.range()).asTuple();
+                        addYAxis(yAxis, axisId, OrdinalAxisRange.from(start, end));
+                        // add an update handler
+                        rangeUpdateHandlerIdRef.current = `y-axis-${chartId}-${location.valueOf()}`;
+                        addAxesRangesUpdateHandler(rangeUpdateHandlerIdRef.current, handleRangeUpdates);
+                    }
+                }
+            }
+            else {
+                const [range, originalRange] = axisRangeFor(axisId)
+                    .map(range => ([range.current, range.original]))
+                    .getOrElse([AxisInterval.empty(), AxisInterval.empty()]);
+                if (range && originalRange) {
+                    axis.update(range, originalRange, plotDimensions, margin);
+                }
+                svg.select(`#${labelIdFor(chartId, location)}`).attr('fill', color);
+            }
+        }
+    }, [
+        container,
+        axis,
+        addXAxis, addYAxis,
+        addAxesRangesUpdateHandler,
+        setAxisIntervalFor, setOriginalAxisIntervalFor, axisRangeFor,
+        xAxesState, yAxesState,
+        updateAxisBasedOnDomainValues,
+        chartId, axisId,
+        categories,
+        color, label, location, margin, plotDimensions, props.axisTickStyle, props.font,
+    ]);
+    useEffect(() => {
+        const handlerId = registerPlotDimensionChangeHandler((oldDimension, newDimension) => {
+            if (axis !== undefined) {
+                if (location === AxisLocation.Top || location === AxisLocation.Bottom) {
+                    const [start, end] = axisRangeFor(axisId)
+                        .map(range => range.current.asTuple())
+                        .getOrElse(AxisInterval.empty().asTuple());
+                    const { current, original } = OrdinalAxisRange
+                        .from(start, end, 0, oldDimension.width)
+                        .zoom(oldDimension.width, newDimension.width);
+                    axis.update(current, original, plotDimensions, margin);
+                }
+                if (location === AxisLocation.Left || location === AxisLocation.Right) {
+                    const [start, end] = axisRangeFor(axisId)
+                        .map(range => range.current.asTuple())
+                        .getOrElse(AxisInterval.empty().asTuple());
+                    const { current, original } = OrdinalAxisRange
+                        .from(start, end, 0, oldDimension.height)
+                        .zoom(oldDimension.height, newDimension.height);
+                    axis.update(current, original, plotDimensions, margin);
+                }
+            }
+        });
+        return () => {
+            unregisterPlotDimensionChangeHandler(handlerId);
+        };
+    }, [
+        axis,
+        axisRangeFor, setAxisIntervalFor, setOriginalAxisIntervalFor,
+        axisId, location, margin,
+        plotDimensions, registerPlotDimensionChangeHandler, unregisterPlotDimensionChangeHandler,
+    ]);
+    return null;
+}
+//# sourceMappingURL=OrdinalAxis.js.map

package/dist/src/app/charts/axes/OrdinalAxis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrdinalAxis.js","sourceRoot":"","sources":["../../../../../src/app/charts/axes/OrdinalAxis.tsx"],"names":[],"mappings":"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"}

package/dist/src/app/charts/axes/OrdinalAxisRange.d.ts

@@ -0,0 +1,69 @@
+import { BaseAxisRange } from "./BaseAxisRange";
+/**
+ * An immutable ordinal-axis range that holds the current range and the original (no zoom) range.
+ * Create an instance using the {@link OrdinalAxisRange.from} factory method.
+ */
+export declare class OrdinalAxisRange extends BaseAxisRange {
+    private constructor();
+    /**
+     * Factory function for creating a new ordinal-axis range instance.
+     * @param start The start of the axis-range.
+     * @param end The end of the axis-range.
+     * @param [originalStart=start] The optional original start of the axis-range (e.g. before any zooming or panning.
+     * Defaults to the start value if not specified.)
+     * @param [originalEnd=end] The optional original end of the axis-range (e.g. before any zooming or panning.
+     * Defaults to the end value if not specified.)
+     * @return A new continuous-axis range instance.
+     */
+    static from(start: number, end: number, originalStart?: number, originalEnd?: number): OrdinalAxisRange;
+    /**
+     * Scales the axis-range by the specified scale factor from the specified value. The equations
+     * are written so that the zooming (scaling) occurs at the specified value, and expands/contracts equally
+     * from that value. This operation does not modify the original range.
+     * @param factor The scale factor
+     * @param value The value from which to scale the interval
+     * @return A new continuous-axis range with updated values
+     */
+    scale(factor: number, value: number): OrdinalAxisRange;
+    /**
+     * Scales the axis-range by the specified scale factor from the specified value, while keeping
+     * the range within the constraints (start, end). The equations are written so that the zooming
+     * (scaling) occurs at the specified value, and expands/contracts equally from that value.
+     * @param factor The scale factor
+     * @param value The value from which to scale the interval
+     * @param constraint The minimum and maximum values that range bounds can be
+     * @return A new continuous-axis range with updated values
+     */
+    constrainedScale(factor: number, value: number, constraint: [min: number, max: number]): OrdinalAxisRange;
+    /**
+     * Translates the axis-range by the specified amount
+     * @param amount The amount by which to translate the axis-range
+     * @param [constraint=[-Infinity, Infinity]] Optional constraint interval in which the axis range must be within
+     * @return An updated {@link OrdinalAxisRange} that has been translated by the specified amount
+     */
+    translate(amount: number, constraint?: [start: number, end: number]): OrdinalAxisRange;
+    /**
+     * Assumes that the original ranges start at 0 and end at the width or height of the plot. Calculates the
+     * new range based on the change in dimensions and the previous range. And calculates the new original range
+     * based on the change in the dimensions.
+     * @param beforeDimension The width or height before the change in dimensions
+     * @param afterDimension The width or height after the change in dimensions
+     * @return An updated {@link OrdinalAxisRange} that has been zoomed based on the change in
+     * the dimensions.
+     */
+    zoom(beforeDimension: number, afterDimension: number): OrdinalAxisRange;
+    /**
+     * Updates the axis-range with the new start and end values, leaving the original range unchanged.
+     * @param start The new start of the axis-range
+     * @param end The new end of the axis range
+     * @return The updated axis-range type, with all other values unchanged.
+     */
+    update(start: number, end: number): OrdinalAxisRange;
+    /**
+     * Updates the original range with the new start and end values.
+     * @param start The new value for the start of the original range
+     * @param end The new value for the end of the original range
+     * @return The updated original range.
+     */
+    updateOriginal(start: number, end: number): BaseAxisRange;
+}