stream-charts 1.2.0 → 2.0.0

package/dist/app/charts/axes/AxesState.js

@@ -1,12 +1,16 @@
 import { Optional } from "result-fn";
 /**
- * Holds the information to allow mapping axes names to the underlying axes objects.
- * These objects hold the axis ID, its location on the chart (i.e. left, right, bottom, upper)
- * and the underlying d3 selection objects for managing the axes. Axis objects that extend
- * the `BaseAxis` class may have additional properties.
+ * Holds the information to allow mapping axes IDs to the underlying axes objects (of either the
+ * x-axes or the y-axes). These objects hold the axis ID, its location on the chart (i.e. left,
+ * right, bottom, top), its type, and (for the axis types that extend `BaseAxis`) its scale and the
+ * functions for updating and drawing it.
  * @typeParam A The type of the axes (must extend `BaseAxis`)
  */
 export class AxesState {
+    /**
+     * Use {@link from} or {@link empty} to create an axes state
+     * @param axes Mapping of the axes IDs to the axes
+     */
     constructor(axes) {
         this.axes = axes;
     }
@@ -32,15 +36,8 @@ export class AxesState {
         return this.axes.size === 0;
     }
     /**
-     * Creates a deep copy of the current axes state.
-     * @return A deep copy of the current axes state.
-     */
-    copy() {
-        return new AxesState(new Map(Array.from(this.axes.entries())
-            .map(([id, axis]) => [id, Object.assign({}, axis)])));
-    }
-    /**
-     * Adds an axis to the current axis state and returns a new axis state. This is an internal state
+     * Adds an axis to this axes state's map of axes (in place), and returns a new axes state holding
+     * that same map (a new object, so that React sees the change). This is an internal state
      * management function. This should generally not be used. Instead, use the {@link UseAxesValues.addXAxis}
      * and {@link UseAxesValues.addYAxis} functions to add axes.
      * @param axis The axis to add
@@ -54,22 +51,26 @@ export class AxesState {
         return new AxesState(updatedAxes);
     }
     /**
-     * Attempts to retrieve the x-axis for the specified ID
-     * @param axisId The unique ID of the axis
-     * @return The axis, or undefined if no axis with the specified ID is found
+     * Attempts to retrieve the axis for the specified ID.
+     * @param axisId The unique ID of the axis, or `""` to request the default axis (the
+     * convention used throughout this library wherever a series has no explicit axis
+     * assignment -- see e.g. each plot component's own `axesFor` helper).
+     * @return The axis matching `axisId`; the default axis (see {@link defaultAxis}) if
+     * `axisId` is `""` and at least one axis exists; otherwise an empty `Optional`. A non-empty
+     * `axisId` that doesn't match any axis is deliberately treated as "not found" rather than
+     * silently substituting an unrelated axis -- that used to happen for *any* unmatched ID,
+     * which masked stale/mistyped axis IDs as if they'd resolved correctly.
      */
     axisFor(axisId) {
         const axis = this.axes.get(axisId);
-        // when there is no axis for the specified ID and there is at least
-        // one axis, then just use that...it is the default axis
-        if (axis === undefined && this.axes.size >= 1) {
-            return Optional.of(Array.from(this.axes.values())[0]);
+        if (axis === undefined && axisId === "" && this.axes.size >= 1) {
+            return this.defaultAxis();
         }
         return Optional.ofNullable(axis);
     }
     /**
-     * Returns the default axis
-     * @return The default axis
+     * Returns the default axis: the first axis added
+     * @return The default axis, or an empty `Optional` when there are no axes
      * @see axisDefaultId
      */
     defaultAxis() {
@@ -79,13 +80,14 @@ export class AxesState {
             Optional.empty();
     }
     /**
-     * @return An array holding all existing the x-axis IDs
+     * @return An array holding the IDs of all the axes
      */
     axisIds() {
         return Array.from(this.axes.keys());
     }
     /**
-     * @return The default name of the x-axis (in case only on default axis was added)
+     * @return The ID of the default axis (the first axis added), or an empty `Optional` when there
+     * are no axes
      */
     axisDefaultId() {
         const ids = Array.from(this.axes.keys());

package/dist/app/charts/axes/AxesState.js.map

@@ -1 +1 @@
-{"version":3,"file":"AxesState.js","sourceRoot":"","sources":["../../../../src/app/charts/axes/AxesState.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,QAAQ,EAAC,MAAM,WAAW,CAAC;AAEnC;;;;;;GAMG;AACH,MAAM,OAAO,SAAS;IAGlB,YAAoB,IAAoB;QACpC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IACpB,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,IAAI,CAAqB,IAAoB;QAChD,OAAO,IAAI,SAAS,CAAI,IAAI,CAAC,CAAA;IACjC,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK;QACR,OAAO,IAAI,SAAS,CAAI,IAAI,GAAG,EAAa,CAAC,CAAA;IACjD,CAAC;IAED;;OAEG;IACH,OAAO;QACH,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,CAAA;IAC/B,CAAC;IAED;;;OAGG;IACH,IAAI;QACA,OAAO,IAAI,SAAS,CAChB,IAAI,GAAG,CAAY,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;aAC7C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,oBAAM,IAAI,EAAE,CAAC,CACxC,CACJ,CAAA;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,OAAO,CAAC,IAAO,EAAE,EAAU;QACvB,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;QAC3C,OAAO,IAAI,SAAS,CAAI,WAAW,CAAC,CAAA;IACxC,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,MAAc;QAClB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QAClC,mEAAmE;QACnE,wDAAwD;QACxD,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC;YAC5C,OAAO,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QACzD,CAAC;QACD,OAAO,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;IACpC,CAAC;IAED;;;;OAIG;IACH,WAAW;QACP,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;QAC3C,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACpB,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACtB,QAAQ,CAAC,KAAK,EAAE,CAAA;IACxB,CAAC;IAED;;OAEG;IACH,OAAO;QACH,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;IACvC,CAAC;IAED;;OAEG;IACH,aAAa;QACT,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;QACxC,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACnB,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACrB,QAAQ,CAAC,KAAK,EAAE,CAAA;IACxB,CAAC;CACJ"}
+{"version":3,"file":"AxesState.js","sourceRoot":"","sources":["../../../../src/app/charts/axes/AxesState.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,QAAQ,EAAC,MAAM,WAAW,CAAC;AAEnC;;;;;;GAMG;AACH,MAAM,OAAO,SAAS;IAGlB;;;OAGG;IACH,YAAoB,IAAoB;QACpC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IACpB,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,IAAI,CAAqB,IAAoB;QAChD,OAAO,IAAI,SAAS,CAAI,IAAI,CAAC,CAAA;IACjC,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK;QACR,OAAO,IAAI,SAAS,CAAI,IAAI,GAAG,EAAa,CAAC,CAAA;IACjD,CAAC;IAED;;OAEG;IACH,OAAO;QACH,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,CAAA;IAC/B,CAAC;IAED;;;;;;;;;;OAUG;IACH,OAAO,CAAC,IAAO,EAAE,EAAU;QACvB,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;QAC3C,OAAO,IAAI,SAAS,CAAI,WAAW,CAAC,CAAA;IACxC,CAAC;IAED;;;;;;;;;;OAUG;IACH,OAAO,CAAC,MAAc;QAClB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QAClC,IAAI,IAAI,KAAK,SAAS,IAAI,MAAM,KAAK,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC;YAC7D,OAAO,IAAI,CAAC,WAAW,EAAE,CAAA;QAC7B,CAAC;QACD,OAAO,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;IACpC,CAAC;IAED;;;;OAIG;IACH,WAAW;QACP,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;QAC3C,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACpB,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACtB,QAAQ,CAAC,KAAK,EAAE,CAAA;IACxB,CAAC;IAED;;OAEG;IACH,OAAO;QACH,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;IACvC,CAAC;IAED;;;OAGG;IACH,aAAa;QACT,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;QACxC,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACnB,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACrB,QAAQ,CAAC,KAAK,EAAE,CAAA;IACxB,CAAC;CACJ"}

package/dist/app/charts/axes/AxisInterval.d.ts

@@ -1,14 +1,31 @@
 /**
- * The range of an axis is the physical (start, end) pixels on the screen for the axis.
- * This is the pixel-space of the axis (where as the domain is the data-space of the axis,
- * for example, the tick values).
+ * An immutable (start, end) interval, with `start <= end`, used both for an axis' domain (its
+ * data-space, for example, the range of the tick values) and for an axis' range (its pixel-space,
+ * the physical start and end pixels on the screen). An interval whose start or end is `NaN` is
+ * empty.
  */
 export declare class AxisInterval {
     readonly start: number;
     readonly end: number;
+    /**
+     * Use {@link from}, {@link as}, or {@link empty} to create an axis interval
+     * @param start The interval's start
+     * @param end The interval's end
+     */
     private constructor();
     /**
-     * Creates an axis interval from the specified start and end values
+     * Creates an axis interval from the specified start and end values. The values are normalized
+     * so that `start <= end` regardless of the order they're passed in -- callers never need to
+     * worry about which endpoint ended up larger (e.g. after a pan/zoom delta pushes one endpoint
+     * past the other).
+     *
+     * If exactly one of `start`/`end` is `NaN`, both endpoints of the result collapse to `NaN`
+     * (`Math.min`/`Math.max` propagate `NaN` unconditionally) -- the same representation as an
+     * intentionally-empty interval (see {@link empty}). That's indistinguishable from genuinely
+     * wanting an empty interval, and silently discards which of the two inputs was actually bad,
+     * so this logs a warning for that specific mixed case (one real number, one `NaN`) to surface
+     * what's almost always an upstream computation error -- `from(NaN, NaN)` (a deliberate empty
+     * interval) is not warned about.
      * @param start The axis-range start value
      * @param end The axis-range end value
      * @return The axis-interval
@@ -34,7 +51,11 @@ export declare class AxisInterval {
      */
     isNotEmpty(): boolean;
     /**
-     * @return `true` if the specified axis interval is equal to this one, `false` otherwise
+     * Determines whether this axis interval's start and end are the specified ones (two empty
+     * intervals are equal)
+     * @param start The start to compare to
+     * @param end The end to compare to
+     * @return `true` if this axis interval's start and end are the specified ones, `false` otherwise
      */
     equalsInterval(start: number, end: number): boolean;
     /**
@@ -44,8 +65,8 @@ export declare class AxisInterval {
      */
     equals(other: AxisInterval): boolean;
     /**
-     * Creates a copy of the specified axis interval
-     * @return A copy of the specified axis interval
+     * Creates a copy of this axis interval
+     * @return A copy of this axis interval
      */
     copy(): AxisInterval;
     /**
@@ -54,39 +75,36 @@ export declare class AxisInterval {
      */
     asTuple(): [start: number, end: number];
     /**
-     * Applies the specified function to the axis interval and returns the result
-     * @param fn The function to apply to the axis interval
-     * @return The result of the function application
+     * Applies the specified function to this axis interval's start and end, and returns the
+     * resulting interval
+     * @param fn The function to apply to the axis interval's start and end
+     * @return A new axis interval holding the function's result
      */
     map(fn: (start: number, end: number) => [start: number, end: number]): AxisInterval;
     /**
-     * Calculates the measure (end - start) of the specified axis interval.
+     * Calculates the measure (end - start) of this axis interval.
      * The measure of an empty axis interval is 0.
-     * @return The measure (end - start) of the specified axis interval
+     * @return The measure (end - start) of this axis interval
      */
     measure(): number;
     /**
-     * Updates the start value of the specified axis interval
-     * @param delta The amount by which to update the start value
-     * @return A new axis interval
+     * Creates an axis interval whose start is moved by the specified amount (and whose end isn't)
+     * @param delta The amount by which to move the start
+     * @return A new axis interval (empty when this one is)
      */
     translateStart(delta: number): AxisInterval;
     /**
-     * Updates the end value of the specified axis interval
-     * @param delta The amount by which to update the end value
-     * @return The new axis interval
+     * Creates an axis interval whose end is moved by the specified amount (and whose start isn't)
+     * @param delta The amount by which to move the end
+     * @return A new axis interval (empty when this one is)
      */
     translateEnd(delta: number): AxisInterval;
     /**
-     * Translates the specified axis interval by the specified delta.
+     * Creates an axis interval that's this one translated (both its start and its end moved) by the
+     * specified amount
      * @param delta The amount by which to translate the axis interval
-     * @return The new axis interval
+     * @return A new axis interval (empty when this one is)
      */
     translate(delta: number): AxisInterval;
 }
-/**
- * Creates a copy of the specified map(axis_id, (start, end))
- * @param ranges The ranges map to copy
- * @return A copy of the specified map(axis_id, (start, end))
- */
-export declare function copyRangeMap(ranges: Map<string, AxisInterval>): Map<string, AxisInterval>;
+//# sourceMappingURL=AxisInterval.d.ts.map

package/dist/app/charts/axes/AxisInterval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AxisInterval.d.ts","sourceRoot":"","sources":["../../../../src/app/charts/axes/AxisInterval.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,qBAAa,YAAY;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IAEpB;;;;OAIG;IACH,OAAO;IAKP;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY;IAWrD;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,YAAY;IAI5D;;;OAGG;IACH,MAAM,CAAC,KAAK,IAAI,YAAY;IAI5B;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;;;;;OAMG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAInD;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO;IAIpC;;;OAGG;IACH,IAAI,IAAI,YAAY;IAIpB;;;OAGG;IACH,OAAO,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC;IAIvC;;;;;OAKG;IACH,GAAG,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,YAAY;IAKnF;;;;OAIG;IACH,OAAO,IAAI,MAAM;IAIjB;;;;OAIG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY;IAI3C;;;;OAIG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY;IAIzC;;;;;OAKG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY;CAGzC"}

package/dist/app/charts/axes/AxisInterval.js

@@ -1,20 +1,42 @@
 /**
- * The range of an axis is the physical (start, end) pixels on the screen for the axis.
- * This is the pixel-space of the axis (where as the domain is the data-space of the axis,
- * for example, the tick values).
+ * An immutable (start, end) interval, with `start <= end`, used both for an axis' domain (its
+ * data-space, for example, the range of the tick values) and for an axis' range (its pixel-space,
+ * the physical start and end pixels on the screen). An interval whose start or end is `NaN` is
+ * empty.
  */
 export class AxisInterval {
+    /**
+     * Use {@link from}, {@link as}, or {@link empty} to create an axis interval
+     * @param start The interval's start
+     * @param end The interval's end
+     */
     constructor(start, end) {
         this.start = start;
         this.end = end;
     }
     /**
-     * Creates an axis interval from the specified start and end values
+     * Creates an axis interval from the specified start and end values. The values are normalized
+     * so that `start <= end` regardless of the order they're passed in -- callers never need to
+     * worry about which endpoint ended up larger (e.g. after a pan/zoom delta pushes one endpoint
+     * past the other).
+     *
+     * If exactly one of `start`/`end` is `NaN`, both endpoints of the result collapse to `NaN`
+     * (`Math.min`/`Math.max` propagate `NaN` unconditionally) -- the same representation as an
+     * intentionally-empty interval (see {@link empty}). That's indistinguishable from genuinely
+     * wanting an empty interval, and silently discards which of the two inputs was actually bad,
+     * so this logs a warning for that specific mixed case (one real number, one `NaN`) to surface
+     * what's almost always an upstream computation error -- `from(NaN, NaN)` (a deliberate empty
+     * interval) is not warned about.
      * @param start The axis-range start value
      * @param end The axis-range end value
      * @return The axis-interval
      */
     static from(start, end) {
+        if ((isNaN(start) || isNaN(end)) && !(isNaN(start) && isNaN(end))) {
+            console.warn(`AxisInterval.from received exactly one NaN endpoint -- this usually indicates an ` +
+                `upstream computation error, not an intentional empty interval (use AxisInterval.empty() ` +
+                `for that); start: ${start}, end: ${end}`);
+        }
         return new AxisInterval(Math.min(start, end), Math.max(start, end));
     }
     /**
@@ -45,7 +67,11 @@ export class AxisInterval {
         return !this.isEmpty();
     }
     /**
-     * @return `true` if the specified axis interval is equal to this one, `false` otherwise
+     * Determines whether this axis interval's start and end are the specified ones (two empty
+     * intervals are equal)
+     * @param start The start to compare to
+     * @param end The end to compare to
+     * @return `true` if this axis interval's start and end are the specified ones, `false` otherwise
      */
     equalsInterval(start, end) {
         return (this.start === start && this.end === end) || (this.isEmpty() && isNaN(start) && isNaN(end));
@@ -59,8 +85,8 @@ export class AxisInterval {
         return this.equalsInterval(other.start, other.end);
     }
     /**
-     * Creates a copy of the specified axis interval
-     * @return A copy of the specified axis interval
+     * Creates a copy of this axis interval
+     * @return A copy of this axis interval
      */
     copy() {
         return AxisInterval.from(this.start, this.end);
@@ -73,54 +99,47 @@ export class AxisInterval {
         return [this.start, this.end];
     }
     /**
-     * Applies the specified function to the axis interval and returns the result
-     * @param fn The function to apply to the axis interval
-     * @return The result of the function application
+     * Applies the specified function to this axis interval's start and end, and returns the
+     * resulting interval
+     * @param fn The function to apply to the axis interval's start and end
+     * @return A new axis interval holding the function's result
      */
     map(fn) {
         const [start, end] = fn(this.start, this.end);
         return AxisInterval.from(start, end);
     }
     /**
-     * Calculates the measure (end - start) of the specified axis interval.
+     * Calculates the measure (end - start) of this axis interval.
      * The measure of an empty axis interval is 0.
-     * @return The measure (end - start) of the specified axis interval
+     * @return The measure (end - start) of this axis interval
      */
     measure() {
         return this.isNotEmpty() ? this.end - this.start : 0;
     }
     /**
-     * Updates the start value of the specified axis interval
-     * @param delta The amount by which to update the start value
-     * @return A new axis interval
+     * Creates an axis interval whose start is moved by the specified amount (and whose end isn't)
+     * @param delta The amount by which to move the start
+     * @return A new axis interval (empty when this one is)
      */
     translateStart(delta) {
         return this.isNotEmpty() ? AxisInterval.from(this.start + delta, this.end) : AxisInterval.empty();
     }
     /**
-     * Updates the end value of the specified axis interval
-     * @param delta The amount by which to update the end value
-     * @return The new axis interval
+     * Creates an axis interval whose end is moved by the specified amount (and whose start isn't)
+     * @param delta The amount by which to move the end
+     * @return A new axis interval (empty when this one is)
      */
     translateEnd(delta) {
         return this.isNotEmpty() ? AxisInterval.from(this.start, this.end + delta) : AxisInterval.empty();
     }
     /**
-     * Translates the specified axis interval by the specified delta.
+     * Creates an axis interval that's this one translated (both its start and its end moved) by the
+     * specified amount
      * @param delta The amount by which to translate the axis interval
-     * @return The new axis interval
+     * @return A new axis interval (empty when this one is)
      */
     translate(delta) {
         return this.isNotEmpty() ? AxisInterval.from(this.start + delta, this.end + delta) : AxisInterval.empty();
     }
 }
-/**
- * Creates a copy of the specified map(axis_id, (start, end))
- * @param ranges The ranges map to copy
- * @return A copy of the specified map(axis_id, (start, end))
- */
-export function copyRangeMap(ranges) {
-    return new Map(Array.from(ranges.entries())
-        .map(([id, range]) => [id, range.copy()]));
-}
 //# sourceMappingURL=AxisInterval.js.map

package/dist/app/charts/axes/AxisInterval.js.map

@@ -1 +1 @@
-{"version":3,"file":"AxisInterval.js","sourceRoot":"","sources":["../../../../src/app/charts/axes/AxisInterval.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AxisInterval.js","sourceRoot":"","sources":["../../../../src/app/charts/axes/AxisInterval.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,OAAO,YAAY;IAIrB;;;;OAIG;IACH,YAAoB,KAAa,EAAE,GAAW;QAC1C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAClB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAA;IAClB,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,IAAI,CAAC,KAAa,EAAE,GAAW;QAClC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAChE,OAAO,CAAC,IAAI,CACR,mFAAmF;gBACnF,0FAA0F;gBAC1F,qBAAqB,KAAK,UAAU,GAAG,EAAE,CAC5C,CAAA;QACL,CAAC;QACD,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAA;IACvE,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,KAAmC;QACzC,OAAO,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IAChD,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK;QACR,OAAO,IAAI,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;IACrC,CAAC;IAED;;OAEG;IACH,OAAO;QACH,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC/C,CAAC;IAED;;OAEG;IACH,UAAU;QACN,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,CAAA;IAC1B,CAAC;IAED;;;;;;OAMG;IACH,cAAc,CAAC,KAAa,EAAE,GAAW;QACrC,OAAO,CAAC,IAAI,CAAC,KAAK,KAAK,KAAK,IAAI,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAA;IACvG,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,KAAmB;QACtB,OAAO,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAA;IACtD,CAAC;IAED;;;OAGG;IACH,IAAI;QACA,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAA;IAClD,CAAC;IAED;;;OAGG;IACH,OAAO;QACH,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAA;IACjC,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,EAAgE;QAChE,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAA;QAC7C,OAAO,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;IACxC,CAAC;IAED;;;;OAIG;IACH,OAAO;QACH,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IACxD,CAAC;IAED;;;;OAIG;IACH,cAAc,CAAC,KAAa;QACxB,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,EAAE,CAAA;IACrG,CAAC;IAED;;;;OAIG;IACH,YAAY,CAAC,KAAa;QACtB,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,EAAE,CAAA;IACrG,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,KAAa;QACnB,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,EAAE,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,EAAE,CAAA;IAC7G,CAAC;CACJ"}

package/dist/app/charts/axes/BaseAxisRange.d.ts

@@ -21,49 +21,72 @@ export declare abstract class BaseAxisRange {
      */
     matchesOriginal(start: number, end: number): boolean;
     /**
-     * Returns the current distance between the start and end of the range.
+     * The current distance between the start and end of the range
+     * @return The current range's measure (0 when it's empty)
      */
     get currentDistance(): number;
     /**
-     * Returns the original (e.g. before any zooming or panning) distance between the start and end of the range.
+     * The original (e.g. before any zooming or panning) distance between the start and end of the range
+     * @return The original range's measure (0 when it's empty)
      */
     get originalDistance(): number;
     /**
-     * The ratio between the current and original distance.
-     */
-    get scaleFactor(): number;
-    /**
-     * Scales the range using the current scale-factor (closure on `scaleFactor`)
-     * @param factor The factor used to update the range
+     * Scales the range by the specified *incremental* factor -- i.e. relative to `.current`, not
+     * relative to `.original`. d3-zoom's own `transform.k` is cumulative from wherever `__zoom` was
+     * last reset to identity, so callers must first convert it to an incremental factor (this
+     * event's `k` divided by the previously-applied `k`, tracked in a ref that survives across
+     * zoom events -- see `useCanvasZoomPan`) before calling this. Scaling relative
+     * to `.current` this way means `.original` no longer needs to be preserved/shifted for the
+     * zoom math to stay correct -- unlike the previous design, where `factor` was the *cumulative*
+     * `transform.k` applied against `.original`, which broke the moment anything (e.g. a fresh
+     * subscription on Run) rebuilt `.original` to match a since-zoomed `.current` mid-session.
+     * @param factor The incremental scale factor (this event's change in scale, not the cumulative
+     * scale since the axis was last at identity)
      * @param value The current value being scaled
      * @return The new range, represented by an array holding the start and end value
      */
     protected scaledRange(factor: number, value: number): AxisInterval;
     /**
-     *
-     * Scales the axis-range by the specified scale factor from the specified {@link value}. The equations
-     * are written so that the zooming (scaling) occurs at the specified {@link value}, and expands/contracts equally
-     * from that {@link value}.
-     * @param factor The scale factor
-     * @param value The time from which to scale the interval
-     * @return A new continuous-axis range with updated values
+     * Scales the axis-range by the specified factor from the specified `value` (see
+     * {@link scaledRange} for what "incremental" means for a continuous axis range). 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 -- incremental for a {@link ContinuousAxisRange}, but cumulative
+     * for an {@link OrdinalAxisRange} (see its {@link OrdinalAxisRange.scale})
+     * @param value The value from which to scale the interval
+     * @return A new axis range with updated values
      */
     abstract scale(factor: number, value: number): BaseAxisRange;
     /**
-     * Scales the axis-range by the specified scale factor, but constrains the range to the specified
-     * {@link constraint} min and max. The equations are written so that the zooming (scaling) occurs
-     * at the specified {@link value}, and expands/contracts equally from that {@link value}.
-     * @param factor The scale factor
+     * Scales the axis-range from the specified `value`, honoring the specified
+     * `constraint` min and max. The equations are written so that the zooming (scaling)
+     * occurs at the specified `value`, and expands/contracts equally from that
+     * `value`.
+     *
+     * IMPORTANT: the two concrete subclasses give `constraint` opposite meanings, and neither
+     * uses the same kind of `factor` -- this base signature is shared for convenience, not
+     * because the implementations are interchangeable:
+     * - {@link ContinuousAxisRange.constrainedScale} takes an *incremental* factor and *clamps*
+     *   the result to stay inside `constraint` -- `constraint` is a hard viewport edge the range
+     *   is not allowed to scroll/zoom past.
+     * - {@link OrdinalAxisRange.constrainedScale} takes a *cumulative* factor and *widens* the
+     *   result to guarantee it fully covers `constraint` -- `constraint` is the domain that must
+     *   be entirely visible once zoomed all the way out, and widening (rather than clamping) is
+     *   what fixes the pivot-drift bug documented on `OrdinalAxisRange.scaledCumulative`.
+     * Do not port logic between the two without re-reading both subclasses' own doc comments.
+     * @param factor The scale factor -- incremental or cumulative, depending on the concrete subclass
      * @param value The value at which the zoom is initiated
      * @param constraint The min and max range
-     * @return A new continuous-axis range with updated values
+     * @return A new axis range with updated values
      */
     abstract constrainedScale(factor: number, value: number, constraint: [min: number, max: number]): BaseAxisRange;
     /**
-     * Translates the axis-range by the specified amount
+     * Translates the axis-range by the specified amount, unless that would take it outside the
+     * constraint interval
      * @param amount The amount by which to translate the axis-range
      * @param [constraints] Optional constraint interval in which the axis range must be within
-     * @return An updated {@link ContinuousAxisRange} that has been translated by the specified amount
+     * @return An updated axis range that has been translated by the specified amount (or an
+     * unchanged copy, when the translation would leave the constraint interval)
      */
     abstract translate(amount: number, constraints?: [start: number, end: number]): BaseAxisRange;
     /**
@@ -81,3 +104,4 @@ export declare abstract class BaseAxisRange {
      */
     abstract updateOriginal(start: number, end: number): BaseAxisRange;
 }
+//# sourceMappingURL=BaseAxisRange.d.ts.map

package/dist/app/charts/axes/BaseAxisRange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseAxisRange.d.ts","sourceRoot":"","sources":["../../../../src/app/charts/axes/BaseAxisRange.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAE5C;;GAEG;AACH,8BAAsB,aAAa;IAC/B,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAA;IAE9B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAA;IAE/B;;;;;;OAMG;IACH,SAAS,aAAa,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,aAAa,GAAE,MAAc,EAAE,WAAW,GAAE,MAAY;IAK1G;;;;;OAKG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAIpD;;;OAGG;IACH,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED;;;OAGG;IACH,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED;;;;;;;;;;;;;;OAcG;IACH,SAAS,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY;IAQlE;;;;;;;;;OASG;IACH,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa;IAE5D;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,QAAQ,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,aAAa;IAE/G;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,aAAa;IAE7F;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,aAAa;IAE1D;;;;;OAKG;IACH,QAAQ,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,aAAa;CACrE"}

package/dist/app/charts/axes/BaseAxisRange.js

@@ -24,34 +24,39 @@ export class BaseAxisRange {
         return this.original.equalsInterval(start, end);
     }
     /**
-     * Returns the current distance between the start and end of the range.
+     * The current distance between the start and end of the range
+     * @return The current range's measure (0 when it's empty)
      */
     get currentDistance() {
         return this.current.measure();
     }
     /**
-     * Returns the original (e.g. before any zooming or panning) distance between the start and end of the range.
+     * The original (e.g. before any zooming or panning) distance between the start and end of the range
+     * @return The original range's measure (0 when it's empty)
      */
     get originalDistance() {
         return this.original.measure();
     }
     /**
-     * The ratio between the current and original distance.
-     */
-    get scaleFactor() {
-        return this.currentDistance / this.originalDistance;
-    }
-    /**
-     * Scales the range using the current scale-factor (closure on `scaleFactor`)
-     * @param factor The factor used to update the range
+     * Scales the range by the specified *incremental* factor -- i.e. relative to `.current`, not
+     * relative to `.original`. d3-zoom's own `transform.k` is cumulative from wherever `__zoom` was
+     * last reset to identity, so callers must first convert it to an incremental factor (this
+     * event's `k` divided by the previously-applied `k`, tracked in a ref that survives across
+     * zoom events -- see `useCanvasZoomPan`) before calling this. Scaling relative
+     * to `.current` this way means `.original` no longer needs to be preserved/shifted for the
+     * zoom math to stay correct -- unlike the previous design, where `factor` was the *cumulative*
+     * `transform.k` applied against `.original`, which broke the moment anything (e.g. a fresh
+     * subscription on Run) rebuilt `.original` to match a since-zoomed `.current` mid-session.
+     * @param factor The incremental scale factor (this event's change in scale, not the cumulative
+     * scale since the axis was last at identity)
      * @param value The current value being scaled
      * @return The new range, represented by an array holding the start and end value
      */
     scaledRange(factor, value) {
         const dtStart = value - this.current.start;
         const dtEnd = this.current.end - value;
-        const start = value - dtStart * factor / this.scaleFactor;
-        const end = value + dtEnd * factor / this.scaleFactor;
+        const start = value - dtStart * factor;
+        const end = value + dtEnd * factor;
         return AxisInterval.from(start, end);
     }
 }

package/dist/app/charts/axes/BaseAxisRange.js.map

@@ -1 +1 @@
-{"version":3,"file":"BaseAxisRange.js","sourceRoot":"","sources":["../../../../src/app/charts/axes/BaseAxisRange.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAE5C;;GAEG;AACH,MAAM,OAAgB,aAAa;IAK/B;;;;;;OAMG;IACH,YAAsB,KAAa,EAAE,GAAW,EAAE,gBAAwB,KAAK,EAAE,cAAsB,GAAG;QACtG,IAAI,CAAC,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;QAC5C,IAAI,CAAC,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,CAAA;IACjE,CAAC;IAED;;;;;OAKG;IACH,eAAe,CAAC,KAAa,EAAE,GAAW;QACtC,OAAO,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;IACnD,CAAC;IAED;;OAEG;IACH,IAAI,eAAe;QACf,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAA;IACjC,CAAC;IAED;;OAEG;IACH,IAAI,gBAAgB;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAA;IAClC,CAAC;IAED;;OAEG;IACH,IAAI,WAAW;QACX,OAAO,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,gBAAgB,CAAA;IACvD,CAAC;IAED;;;;;OAKG;IACO,WAAW,CAAC,MAAc,EAAE,KAAa;QAC/C,MAAM,OAAO,GAAG,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAA;QAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,GAAG,KAAK,CAAA;QACtC,MAAM,KAAK,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC,WAAW,CAAA;QACzD,MAAM,GAAG,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,IAAI,CAAC,WAAW,CAAA;QACrD,OAAO,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;IACxC,CAAC;CA+CJ"}
+{"version":3,"file":"BaseAxisRange.js","sourceRoot":"","sources":["../../../../src/app/charts/axes/BaseAxisRange.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAE5C;;GAEG;AACH,MAAM,OAAgB,aAAa;IAK/B;;;;;;OAMG;IACH,YAAsB,KAAa,EAAE,GAAW,EAAE,gBAAwB,KAAK,EAAE,cAAsB,GAAG;QACtG,IAAI,CAAC,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;QAC5C,IAAI,CAAC,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,CAAA;IACjE,CAAC;IAED;;;;;OAKG;IACH,eAAe,CAAC,KAAa,EAAE,GAAW;QACtC,OAAO,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;IACnD,CAAC;IAED;;;OAGG;IACH,IAAI,eAAe;QACf,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAA;IACjC,CAAC;IAED;;;OAGG;IACH,IAAI,gBAAgB;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAA;IAClC,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACO,WAAW,CAAC,MAAc,EAAE,KAAa;QAC/C,MAAM,OAAO,GAAG,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAA;QAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,GAAG,KAAK,CAAA;QACtC,MAAM,KAAK,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,CAAA;QACtC,MAAM,GAAG,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAA;QAClC,OAAO,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;IACxC,CAAC;CA+DJ"}

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

@@ -1,5 +1,5 @@
-import { AxesFont, AxisLocation } from "./axes";
-import { ScaleContinuousNumeric } from "d3";
+import { type AxesFont, AxisLocation } from "./axes";
+import type { ScaleContinuousNumeric } from "d3";
 export interface Props {
     axisId: string;
     location: AxisLocation;
@@ -8,13 +8,54 @@ export interface Props {
     font?: Partial<AxesFont>;
     label: string;
     updateAxisBasedOnDomainValues?: boolean;
+    /**
+     * When `true`, the axis' domain grows to fit the data plotted against it: when the data on
+     * screen goes above (or below) the domain, the domain grows to include it (plus the
+     * `autoScalePadding`), but never past `autoScaleMax` (or `autoScaleMin`). The axis starts out
+     * at the `domain` prop, clamped to those limits. The domain only ever grows -- it's restored
+     * to its start when the plot's data is replaced (e.g. on a reset), or when the `domain` prop
+     * or the limits change. When `false` (the default), the domain is exactly the `domain` prop.
+     *
+     * For y-axes only (an x-axis' domain follows time, and its zooming and panning), in the plots
+     * that support it (the scatter, bar, and outlier plots). Elsewhere, it's ignored, with a warning.
+     */
+    autoScale?: boolean;
+    /**
+     * The smallest value an auto-scaling axis' domain may reach. Defaults to `-Infinity` (no
+     * limit).
+     */
+    autoScaleMin?: number;
+    /**
+     * The largest value an auto-scaling axis' domain may reach. Defaults to `Infinity` (no limit).
+     */
+    autoScaleMax?: number;
+    /**
+     * The fraction of the axis' length left beyond the data's extreme when the axis grows, so the
+     * extreme point isn't drawn right on the edge (in the scale's own space, e.g. logarithmically
+     * for a log scale). From 0 to 0.45 (a larger value is treated as 0.45); defaults to 0.05.
+     */
+    autoScalePadding?: number;
+    /**
+     * The auto-scaled domain to start from when auto-scaling starts (e.g. when the axis is
+     * created), instead of the `domain` prop -- for keeping the axis' growth across remounts (e.g.
+     * navigating away from the chart and back), along with `onAutoScale`. Clamped to the limits.
+     */
+    autoScaledDomain?: [min: number, max: number];
+    /**
+     * Called with the axis' new domain whenever an auto-scaling axis grows, or is restored to its
+     * start (e.g. on a reset), so that it can be kept (see `autoScaledDomain`)
+     * @param domain The axis' new domain
+     */
+    onAutoScale?: (domain: [min: number, max: number]) => void;
 }
 /**
- * Represents a continuous numeric axis (x or y) that can be place on the top, bottom,
+ * Represents a continuous numeric axis (x or y) that can be placed 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.
+ * component or managed externally (i.e. deferred). This component returns null, meaning
+ * React won't render it because we are drawing directly onto the chart's shared canvas and
+ * don't want React involved, except to call this function if the props change.
  * @param props The properties for the axis
+ * @return `null` (the axis draws onto the chart's canvas)
  */
 export declare function ContinuousAxis(props: Props): null;
+//# sourceMappingURL=ContinuousAxis.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ContinuousAxis.d.ts","sourceRoot":"","sources":["../../../../src/app/charts/axes/ContinuousAxis.tsx"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,QAAQ,EACb,YAAY,EAQf,MAAM,QAAQ,CAAC;AAIhB,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,IAAI,CAAC;AAQ/C,MAAM,WAAW,KAAK;IAElB,MAAM,EAAE,MAAM,CAAA;IAGd,QAAQ,EAAE,YAAY,CAAA;IAEtB,KAAK,CAAC,EAAE,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAE9C,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAA;IAElC,IAAI,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;IAExB,KAAK,EAAE,MAAM,CAAA;IAiBb,6BAA6B,CAAC,EAAE,OAAO,CAAA;IACvC;;;;;;;;;;OAUG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAA;IAC7C;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,KAAK,IAAI,CAAA;CAC7D;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CA2RjD"}