@mui/x-charts 8.14.1 → 8.16.0

package/esm/internals/plugins/featurePlugins/useChartKeyboardNavigation/useChartKeyboardNavigation.helpers.js

@@ -1,11 +1,14 @@
+import { isFocusableSeriesType } from "./isFocusableSeriesType.js";
+
 /**
  * Returns the next series type and id that contains some data.
  * Returns `null` if no other series have data.
  */
 export function getNextSeriesWithData(series, type, seriesId) {
-  const startingTypeIndex = type !== undefined && series[type] ? Object.keys(series).indexOf(type) : 0;
+  const seriesType = Object.keys(series);
+  const startingTypeIndex = type !== undefined && series[type] ? seriesType.indexOf(type) : 0;
   const currentSeriesIndex = type !== undefined && seriesId !== undefined && series[type] && series[type].series[seriesId] ? series[type].seriesOrder.indexOf(seriesId) : -1;
-  const typesAvailable = Object.keys(series).filter(t => t !== 'sankey');
+  const typesAvailable = seriesType.filter(isFocusableSeriesType);
 
   // Loop over all series types starting with the current seriesType
   for (let typeGap = 0; typeGap < typesAvailable.length; typeGap += 1) {
@@ -44,9 +47,10 @@ export function getNextSeriesWithData(series, type, seriesId) {
  * Returns `null` if no other series have data.
  */
 export function getPreviousSeriesWithData(series, type, seriesId) {
-  const startingTypeIndex = type !== undefined && series[type] ? Object.keys(series).indexOf(type) : 0;
+  const seriesType = Object.keys(series);
+  const startingTypeIndex = type !== undefined && series[type] ? seriesType.indexOf(type) : 0;
   const startingSeriesIndex = type !== undefined && seriesId !== undefined && series[type] && series[type].series[seriesId] ? series[type].seriesOrder.indexOf(seriesId) : 1;
-  const typesAvailable = Object.keys(series).filter(t => t !== 'sankey');
+  const typesAvailable = seriesType.filter(isFocusableSeriesType);
 
   // Loop over all series types starting with the current seriesType
   for (let typeGap = 0; typeGap < typesAvailable.length; typeGap += 1) {

package/esm/internals/plugins/featurePlugins/useChartKeyboardNavigation/useChartKeyboardNavigation.selectors.d.ts

@@ -9,7 +9,7 @@ export declare const selectorChartsFocusedSeriesType: import("reselect").Selecto
   cacheKey: import("../../models/index.js").ChartStateCacheKey;
 } & {
   cacheKey: import("../../models/index.js").ChartStateCacheKey;
-}, keyof import("../../../index.js").ChartsSeriesConfig | undefined, any[]>;
+}, "line" | "bar" | "scatter" | "pie" | undefined, any[]>;
 export declare const selectorChartsFocusedSeriesId: import("reselect").Selector<import("../../corePlugins/useChartId/useChartId.types.js").UseChartIdState & import("../../corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.js").UseChartExperimentalFeaturesState & import("../../corePlugins/useChartDimensions/useChartDimensions.types.js").UseChartDimensionsState & import("../../corePlugins/useChartSeries/useChartSeries.types.js").UseChartSeriesState<keyof import("../../../index.js").ChartsSeriesConfig> & import("../../corePlugins/useChartAnimation/useChartAnimation.types.js").UseChartAnimationState & import("../../../index.js").UseChartInteractionListenerState & Partial<import("./useChartKeyboardNavigation.types.js").UseChartKeyboardNavigationState> & {
   cacheKey: import("../../models/index.js").ChartStateCacheKey;
 } & {
@@ -40,6 +40,24 @@ export declare const selectorChartsKeyboardItem: import("reselect").Selector<imp
 } & {
   cacheKey: import("../../models/index.js").ChartStateCacheKey;
 }, {
+  type: "line";
   seriesId: SeriesId;
-  dataIndex: number | undefined;
-} | null, any[]>;
+  dataIndex: number;
+} | {
+  type: "bar";
+  seriesId: SeriesId;
+  dataIndex: number;
+} | {
+  type: "scatter";
+  seriesId: SeriesId;
+  dataIndex: number;
+} | {
+  type: "pie";
+  seriesId: SeriesId;
+  dataIndex: number;
+} | null, any[]>;
+export declare const selectorChartsKeyboardItemIsDefined: import("reselect").Selector<import("../../corePlugins/useChartId/useChartId.types.js").UseChartIdState & import("../../corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.js").UseChartExperimentalFeaturesState & import("../../corePlugins/useChartDimensions/useChartDimensions.types.js").UseChartDimensionsState & import("../../corePlugins/useChartSeries/useChartSeries.types.js").UseChartSeriesState<keyof import("../../../index.js").ChartsSeriesConfig> & import("../../corePlugins/useChartAnimation/useChartAnimation.types.js").UseChartAnimationState & import("../../../index.js").UseChartInteractionListenerState & Partial<import("./useChartKeyboardNavigation.types.js").UseChartKeyboardNavigationState> & {
+  cacheKey: import("../../models/index.js").ChartStateCacheKey;
+} & {
+  cacheKey: import("../../models/index.js").ChartStateCacheKey;
+}, boolean, any[]>;

package/esm/internals/plugins/featurePlugins/useChartKeyboardNavigation/useChartKeyboardNavigation.selectors.js

@@ -31,12 +31,19 @@ const createSelectAxisHighlight = direction => (type, seriesId, dataIndex, axis,
 };
 export const selectorChartsKeyboardXAxisIndex = createSelector([selectorChartsFocusedSeriesType, selectorChartsFocusedSeriesId, selectorChartsFocusedDataIndex, selectorChartXAxis, selectorChartSeriesProcessed], createSelectAxisHighlight('x'));
 export const selectorChartsKeyboardYAxisIndex = createSelector([selectorChartsFocusedSeriesType, selectorChartsFocusedSeriesId, selectorChartsFocusedDataIndex, selectorChartYAxis, selectorChartSeriesProcessed], createSelectAxisHighlight('y'));
-export const selectorChartsKeyboardItem = createSelector([selectorChartsFocusedSeriesType, selectorChartsFocusedSeriesId, selectorChartsFocusedDataIndex], function selectorChartsKeyboardItem(seriesType, seriesId, dataIndex) {
-  if (seriesId === undefined) {
+export const selectorChartsKeyboardItem = createSelector([selectKeyboardNavigation], function selectorChartsKeyboardItem(keyboardState) {
+  if (keyboardState?.item == null) {
     return null;
   }
-  return {
-    seriesId,
-    dataIndex: seriesType === 'line' ? undefined : dataIndex
-  };
+  const {
+    type,
+    seriesId
+  } = keyboardState.item;
+  if (type === undefined || seriesId === undefined) {
+    return null;
+  }
+  return keyboardState.item;
+});
+export const selectorChartsKeyboardItemIsDefined = createSelector([selectorChartsFocusedSeriesType, selectorChartsFocusedSeriesId, selectorChartsFocusedDataIndex], function selectorChartsKeyboardItemIsDefined(seriesType, seriesId, dataIndex) {
+  return seriesId !== undefined && dataIndex !== undefined;
 });

package/esm/internals/plugins/featurePlugins/useChartKeyboardNavigation/useChartKeyboardNavigation.types.d.ts

@@ -4,11 +4,11 @@ import { SeriesId } from "../../../../models/seriesType/common.js";
 import { UseChartInteractionSignature } from "../useChartInteraction/index.js";
 import { UseChartHighlightSignature } from "../useChartHighlight/index.js";
 export interface UseChartKeyboardNavigationInstance {}
-type SeriesItemIdentifier = {
+type SeriesItemIdentifier<SeriesType extends ChartSeriesType = FocusableSeriesTypes> = SeriesType extends FocusableSeriesTypes ? {
   /**
    * The type of the series
    */
-  type: ChartSeriesType;
+  type: SeriesType;
   /**
    * The id of the series with focus.
    */
@@ -17,7 +17,8 @@ type SeriesItemIdentifier = {
    * The index of the data point with focus.
    */
   dataIndex: number;
-};
+} : never;
+export type FocusableSeriesTypes = 'bar' | 'line' | 'scatter' | 'pie';
 export interface UseChartKeyboardNavigationState {
   keyboardNavigation: {
     item: null | SeriesItemIdentifier;

package/esm/internals/plugins/featurePlugins/useChartPolarAxis/computeAxisValue.js

@@ -1,5 +1,4 @@
 import _extends from "@babel/runtime/helpers/esm/extends";
-import { scaleBand, scalePoint } from '@mui/x-charts-vendor/d3-scale';
 import { isBandScaleConfig, isPointScaleConfig, isContinuousScaleConfig } from "../../../../models/axis.js";
 import { getColorScale, getOrdinalColorScale } from "../../../colorScale.js";
 import { getDefaultTickNumber, getTickNumber, scaleTickNumberByRange } from "../../../ticks.js";
@@ -8,6 +7,7 @@ import { isDateData, createDateFormatter } from "../../../dateHelpers.js";
 import { getAxisExtremum } from "./getAxisExtremum.js";
 import { deg2rad } from "../../../angleConversion.js";
 import { getAxisTriggerTooltip } from "./getAxisTriggerTooltip.js";
+import { scaleBand, scalePoint } from "../../../scales/index.js";
 function getRange(drawingArea, axisDirection, axis) {
   if (axisDirection === 'rotation') {
     if (axis.scaleType === 'point') {

package/esm/internals/plugins/models/seriesConfig/index.d.ts

@@ -4,5 +4,6 @@ export * from "./polarExtremumGetter.types.js";
 export * from "./seriesConfig.types.js";
 export * from "./seriesProcessor.types.js";
 export * from "./tooltipGetter.types.js";
+export * from "./tooltipItemPositionGetter.types.js";
 export * from "./legendGetter.types.js";
 export * from "./getSeriesWithDefaultValues.types.js";

package/esm/internals/plugins/models/seriesConfig/index.js

@@ -4,5 +4,6 @@ export * from "./polarExtremumGetter.types.js";
 export * from "./seriesConfig.types.js";
 export * from "./seriesProcessor.types.js";
 export * from "./tooltipGetter.types.js";
+export * from "./tooltipItemPositionGetter.types.js";
 export * from "./legendGetter.types.js";
 export * from "./getSeriesWithDefaultValues.types.js";

package/esm/internals/plugins/models/seriesConfig/seriesConfig.types.d.ts

@@ -6,11 +6,13 @@ import type { LegendGetter } from "./legendGetter.types.js";
 import type { AxisTooltipGetter, TooltipGetter } from "./tooltipGetter.types.js";
 import { PolarExtremumGetter } from "./polarExtremumGetter.types.js";
 import { GetSeriesWithDefaultValues } from "./getSeriesWithDefaultValues.types.js";
+import { TooltipItemPositionGetter } from "./tooltipItemPositionGetter.types.js";
 export type ChartSeriesTypeConfig<TSeriesType extends ChartSeriesType> = {
   seriesProcessor: SeriesProcessor<TSeriesType>;
   colorProcessor: ColorProcessor<TSeriesType>;
   legendGetter: LegendGetter<TSeriesType>;
   tooltipGetter: TooltipGetter<TSeriesType>;
+  tooltipItemPositionGetter?: TooltipItemPositionGetter<TSeriesType>;
   getSeriesWithDefaultValues: GetSeriesWithDefaultValues<TSeriesType>;
 } & (TSeriesType extends CartesianChartSeriesType ? {
   xExtremumGetter: CartesianExtremumGetter<TSeriesType>;

package/esm/internals/plugins/models/seriesConfig/tooltipItemPositionGetter.types.d.ts

@@ -0,0 +1,24 @@
+import type { ChartItemIdentifierWithData, ChartSeriesType } from "../../../../models/seriesType/config.js";
+import { ChartsRotationAxisProps, ChartsRadiusAxisProps, PolarAxisDefaultized, ComputedXAxis, ComputedYAxis } from "../../../../models/axis.js";
+import { ChartDrawingArea } from "../../../../hooks/useDrawingArea.js";
+import { ProcessedSeries } from "../../corePlugins/useChartSeries/index.js";
+export interface TooltipPositionGetterAxesConfig {
+  x?: ComputedXAxis;
+  y?: ComputedYAxis;
+  rotation?: PolarAxisDefaultized<any, any, ChartsRotationAxisProps>;
+  radius?: PolarAxisDefaultized<any, any, ChartsRadiusAxisProps>;
+}
+export type TooltipItemPositionGetter<TSeriesType extends ChartSeriesType> = (params: {
+  series: ProcessedSeries<TSeriesType>;
+  axesConfig: TooltipPositionGetterAxesConfig;
+  drawingArea: ChartDrawingArea;
+  identifier: ChartItemIdentifierWithData<TSeriesType> | null;
+  /**
+   * The preferred placement of the tooltip related to the element.
+   * @default 'top'
+   */
+  placement: 'top' | 'bottom' | 'left' | 'right';
+}) => {
+  x: number;
+  y: number;
+} | null;

package/esm/internals/plugins/utils/selectors.d.ts

@@ -1,6 +1,6 @@
 import { SelectorArray, Combiner, Selector, GetStateFromSelectors, GetParamsFromSelectors, CreateSelectorOptions } from 'reselect';
 import { ChartAnyPluginSignature, ChartState, ChartStateCacheKey } from "../models/index.js";
-export type ChartRootSelector<TSignature extends ChartAnyPluginSignature> = Selector<ChartState<[TSignature]>, TSignature['state'][keyof TSignature['state']]>;
+export type ChartRootSelector<TSignature extends ChartAnyPluginSignature, T extends keyof TSignature['state'] = keyof TSignature['state']> = Selector<ChartState<[TSignature]>, TSignature['state'][T]>;
 export type ChartOptionalRootSelector<TSignature extends ChartAnyPluginSignature> = Selector<ChartState<[], [TSignature]>, TSignature['state'][keyof TSignature['state']] | undefined>;
 export type ChartsSelector<Signatures extends readonly ChartAnyPluginSignature[] = [], OptionalSignatures extends readonly ChartAnyPluginSignature[] = [], Result = unknown, Args extends readonly any[] = []> = Selector<ChartState<Signatures, OptionalSignatures>, Result, Args>;
 type InterruptRecursion = NonNullable<unknown>;

package/esm/internals/scales/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./scaleBand.js";
+export * from "./scalePoint.js";
+export * from "./scaleSymlog.js";

package/esm/internals/scales/index.js

@@ -0,0 +1,3 @@
+export * from "./scaleBand.js";
+export * from "./scalePoint.js";
+export * from "./scaleSymlog.js";

package/esm/internals/scales/scaleBand.d.ts

@@ -0,0 +1,25 @@
+import type { NumberValue, ScaleBand } from '@mui/x-charts-vendor/d3-scale';
+export declare function keyof(value: any): string | number;
+/**
+ * Constructs a new band scale with the specified range, no padding, no rounding and center alignment.
+ * The domain defaults to the empty domain.
+ * If range is not specified, it defaults to the unit range [0, 1].
+ *
+ * The generic corresponds to the data type of domain elements.
+ *
+ * @param range A two-element array of numeric values.
+ */
+export declare function scaleBand<Domain extends {
+  toString(): string;
+} = string>(range?: Iterable<NumberValue>): ScaleBand<Domain>;
+/**
+ * Constructs a new band scale with the specified domain and range, no padding, no rounding and center alignment.
+ *
+ * The generic corresponds to the data type of domain elements.
+ *
+ * @param domain Array of domain values.
+ * @param range A two-element array of numeric values.
+ */
+export declare function scaleBand<Domain extends {
+  toString(): string;
+}>(domain: Iterable<Domain>, range: Iterable<NumberValue>): ScaleBand<Domain>;

package/esm/internals/scales/scaleBand.js

@@ -0,0 +1,159 @@
+/* eslint-disable func-names */
+// Adapted from d3-scale v4.0.2
+// https://github.com/d3/d3-scale/blob/d6904a4bde09e16005e0ad8ca3e25b10ce54fa0d/src/band.js
+import { InternMap, range as sequence } from '@mui/x-charts-vendor/d3-array';
+export function keyof(value) {
+  if (Array.isArray(value)) {
+    return JSON.stringify(value);
+  }
+  if (typeof value === 'object' && value !== null) {
+    return value.valueOf();
+  }
+  return value;
+}
+
+/**
+ * Constructs a new band scale with the specified range, no padding, no rounding and center alignment.
+ * The domain defaults to the empty domain.
+ * If range is not specified, it defaults to the unit range [0, 1].
+ *
+ * The generic corresponds to the data type of domain elements.
+ *
+ * @param range A two-element array of numeric values.
+ */
+
+/**
+ * Constructs a new band scale with the specified domain and range, no padding, no rounding and center alignment.
+ *
+ * The generic corresponds to the data type of domain elements.
+ *
+ * @param domain Array of domain values.
+ * @param range A two-element array of numeric values.
+ */
+
+export function scaleBand(...args) {
+  // @ts-expect-error, InternMap accepts two arguments, but its types are set as Map, which doesn't.
+  let index = new InternMap(undefined, keyof);
+  let domain = [];
+  let ordinalRange = [];
+  let r0 = 0;
+  let r1 = 1;
+  let step;
+  let bandwidth;
+  let isRound = false;
+  let paddingInner = 0;
+  let paddingOuter = 0;
+  let align = 0.5;
+  const scale = d => {
+    const i = index.get(d);
+    if (i === undefined) {
+      return undefined;
+    }
+    return ordinalRange[i % ordinalRange.length];
+  };
+  const rescale = () => {
+    const n = domain.length;
+    const reverse = r1 < r0;
+    const start = reverse ? r1 : r0;
+    const stop = reverse ? r0 : r1;
+    step = (stop - start) / Math.max(1, n - paddingInner + paddingOuter * 2);
+    if (isRound) {
+      step = Math.floor(step);
+    }
+    const adjustedStart = start + (stop - start - step * (n - paddingInner)) * align;
+    bandwidth = step * (1 - paddingInner);
+    const finalStart = isRound ? Math.round(adjustedStart) : adjustedStart;
+    const finalBandwidth = isRound ? Math.round(bandwidth) : bandwidth;
+    bandwidth = finalBandwidth;
+    const values = sequence(n).map(i => finalStart + step * i);
+    ordinalRange = reverse ? values.reverse() : values;
+    return scale;
+  };
+  scale.domain = function (_) {
+    if (!arguments.length) {
+      return domain.slice();
+    }
+    domain = [];
+    // @ts-expect-error, InternMap accepts two arguments.
+    index = new InternMap(undefined, keyof);
+    for (const value of _) {
+      if (index.has(value)) {
+        continue;
+      }
+      index.set(value, domain.push(value) - 1);
+    }
+    return rescale();
+  };
+  scale.range = function (_) {
+    if (!arguments.length) {
+      return [r0, r1];
+    }
+    const [v0, v1] = _;
+    r0 = +v0;
+    r1 = +v1;
+    return rescale();
+  };
+  scale.rangeRound = function (_) {
+    const [v0, v1] = _;
+    r0 = +v0;
+    r1 = +v1;
+    isRound = true;
+    return rescale();
+  };
+  scale.bandwidth = function () {
+    return bandwidth;
+  };
+  scale.step = function () {
+    return step;
+  };
+  scale.round = function (_) {
+    if (!arguments.length) {
+      return isRound;
+    }
+    isRound = !!_;
+    return rescale();
+  };
+  scale.padding = function (_) {
+    if (!arguments.length) {
+      return paddingInner;
+    }
+    paddingInner = Math.min(1, paddingOuter = +_);
+    return rescale();
+  };
+  scale.paddingInner = function (_) {
+    if (!arguments.length) {
+      return paddingInner;
+    }
+    paddingInner = Math.min(1, _);
+    return rescale();
+  };
+  scale.paddingOuter = function (_) {
+    if (!arguments.length) {
+      return paddingOuter;
+    }
+    paddingOuter = +_;
+    return rescale();
+  };
+  scale.align = function (_) {
+    if (!arguments.length) {
+      return align;
+    }
+    align = Math.max(0, Math.min(1, _));
+    return rescale();
+  };
+  scale.copy = () => {
+    return scaleBand(domain, [r0, r1]).round(isRound).paddingInner(paddingInner).paddingOuter(paddingOuter).align(align);
+  };
+
+  // Initialize from arguments
+  const [arg0, arg1] = args;
+  if (args.length > 1) {
+    scale.domain(arg0);
+    scale.range(arg1);
+  } else if (arg0) {
+    scale.range(arg0);
+  } else {
+    rescale();
+  }
+  return scale;
+}

package/esm/internals/scales/scalePoint.d.ts

@@ -0,0 +1,25 @@
+import type { NumberValue, ScalePoint } from '@mui/x-charts-vendor/d3-scale';
+/**
+ * Constructs a new point scale with the specified range, no padding, no rounding and center alignment.
+ * The domain defaults to the empty domain.
+ * If range is not specified, it defaults to the unit range [0, 1].
+ *
+ * The generic corresponds to the data type of domain elements.
+ *
+ * @param range A two-element array of numeric values.
+ */
+export declare function scalePoint<Domain extends {
+  toString(): string;
+} = string>(range?: Iterable<NumberValue>): ScalePoint<Domain>;
+/**
+ * Constructs a new point scale with the specified domain and range, no padding, no rounding and center alignment.
+ * The domain defaults to the empty domain.
+ *
+ * The generic corresponds to the data type of domain elements.
+ *
+ * @param domain Array of domain values.
+ * @param range A two-element array of numeric values.
+ */
+export declare function scalePoint<Domain extends {
+  toString(): string;
+}>(domain: Iterable<Domain>, range: Iterable<NumberValue>): ScalePoint<Domain>;

package/esm/internals/scales/scalePoint.js

@@ -0,0 +1,41 @@
+import { scaleBand } from "./scaleBand.js";
+
+/**
+ * Constructs a new point scale with the specified range, no padding, no rounding and center alignment.
+ * The domain defaults to the empty domain.
+ * If range is not specified, it defaults to the unit range [0, 1].
+ *
+ * The generic corresponds to the data type of domain elements.
+ *
+ * @param range A two-element array of numeric values.
+ */
+
+/**
+ * Constructs a new point scale with the specified domain and range, no padding, no rounding and center alignment.
+ * The domain defaults to the empty domain.
+ *
+ * The generic corresponds to the data type of domain elements.
+ *
+ * @param domain Array of domain values.
+ * @param range A two-element array of numeric values.
+ */
+
+export function scalePoint(...args) {
+  // ScalePoint is essentially ScaleBand with paddingInner(1)
+  const scale = scaleBand(...args).paddingInner(1);
+
+  // Remove paddingInner method and make padding alias to paddingOuter
+  const originalCopy = scale.copy;
+  scale.padding = scale.paddingOuter;
+  delete scale.paddingInner;
+  delete scale.paddingOuter;
+  scale.copy = () => {
+    const copied = originalCopy();
+    copied.padding = copied.paddingOuter;
+    delete copied.paddingInner;
+    delete copied.paddingOuter;
+    copied.copy = scale.copy;
+    return copied;
+  };
+  return scale;
+}

package/esm/internals/scales/scaleSymlog.d.ts

@@ -0,0 +1,38 @@
+import { NumberValue, ScaleSymLog } from '@mui/x-charts-vendor/d3-scale';
+/**
+ * Constructs a new continuous scale with the specified range, the constant 1, the default interpolator and clamping disabled.
+ * The domain defaults to [0, 1].
+ * If range is not specified, it defaults to [0, 1].
+ *
+ * The first generic corresponds to the data type of the range elements.
+ * The second generic corresponds to the data type of the output elements generated by the scale.
+ * The third generic corresponds to the data type of the unknown value.
+ *
+ * If range element and output element type differ, the interpolator factory used with the scale must match this behavior and
+ * convert the interpolated range element to a corresponding output element.
+ *
+ * The range must be set in accordance with the range element type.
+ *
+ * The interpolator factory may be set using the interpolate(...) method of the scale.
+ *
+ * @param range Array of range values.
+ */
+export declare function scaleSymlog<Range = number, Output = Range, Unknown = never>(range?: Iterable<Range>): ScaleSymLog<Range, Output, Unknown>;
+/**
+ * Constructs a new continuous scale with the specified domain and range, the constant 1, the default interpolator and clamping disabled.
+ *
+ * The first generic corresponds to the data type of the range elements.
+ * The second generic corresponds to the data type of the output elements generated by the scale.
+ * The third generic corresponds to the data type of the unknown value.
+ *
+ * If range element and output element type differ, the interpolator factory used with the scale must match this behavior and
+ * convert the interpolated range element to a corresponding output element.
+ *
+ * The range must be set in accordance with the range element type.
+ *
+ * The interpolator factory may be set using the interpolate(...) method of the scale.
+ *
+ * @param domain Array of numeric domain values.
+ * @param range Array of range values.
+ */
+export declare function scaleSymlog<Range, Output = Range, Unknown = never>(domain: Iterable<NumberValue>, range: Iterable<Range>): ScaleSymLog<Range, Output, Unknown>;

package/esm/internals/{symlogScale.js → scales/scaleSymlog.js}

@@ -1,6 +1,44 @@
 import { scaleSymlog as originalScaleSymlog, scaleLog, scaleLinear } from '@mui/x-charts-vendor/d3-scale';
-export function scaleSymlog(_domain, _range) {
-  const scale = originalScaleSymlog(_domain, _range);
+
+/**
+ * Constructs a new continuous scale with the specified range, the constant 1, the default interpolator and clamping disabled.
+ * The domain defaults to [0, 1].
+ * If range is not specified, it defaults to [0, 1].
+ *
+ * The first generic corresponds to the data type of the range elements.
+ * The second generic corresponds to the data type of the output elements generated by the scale.
+ * The third generic corresponds to the data type of the unknown value.
+ *
+ * If range element and output element type differ, the interpolator factory used with the scale must match this behavior and
+ * convert the interpolated range element to a corresponding output element.
+ *
+ * The range must be set in accordance with the range element type.
+ *
+ * The interpolator factory may be set using the interpolate(...) method of the scale.
+ *
+ * @param range Array of range values.
+ */
+
+/**
+ * Constructs a new continuous scale with the specified domain and range, the constant 1, the default interpolator and clamping disabled.
+ *
+ * The first generic corresponds to the data type of the range elements.
+ * The second generic corresponds to the data type of the output elements generated by the scale.
+ * The third generic corresponds to the data type of the unknown value.
+ *
+ * If range element and output element type differ, the interpolator factory used with the scale must match this behavior and
+ * convert the interpolated range element to a corresponding output element.
+ *
+ * The range must be set in accordance with the range element type.
+ *
+ * The interpolator factory may be set using the interpolate(...) method of the scale.
+ *
+ * @param domain Array of numeric domain values.
+ * @param range Array of range values.
+ */
+
+export function scaleSymlog(...args) {
+  const scale = originalScaleSymlog(...args);
   const originalTicks = scale.ticks;
   const {
     negativeScale,