@mui/x-charts 9.7.0 → 9.9.0

package/internals/plugins/featurePlugins/useChartCartesianAxis/sampling.selectors.js

@@ -0,0 +1,89 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getFullRangeZoom = getFullRangeZoom;
+exports.selectorChartSamplingState = exports.selectorChartSamplingPyramids = exports.selectorChartHighlightBucketSize = void 0;
+var _store = require("@mui/x-internals/store");
+var _useChartSeries = require("../../corePlugins/useChartSeries");
+var _useChartSeriesConfig = require("../../corePlugins/useChartSeriesConfig");
+var _useChartDimensions = require("../../corePlugins/useChartDimensions");
+var _useChartCartesianAxisRendering = require("./useChartCartesianAxisRendering.selectors");
+const EMPTY_PYRAMIDS = {};
+const EMPTY_BUCKET_SIZES = new Map();
+
+/**
+ * Full-range zoom (span 100%) for a non-zoomable axis. Sampling gates on a zoom entry; a static axis
+ * has none, so we sample it at full range — the `MAX_RENDERED_POINTS` cap still applies. Mirrors the
+ * full-range zoom the zoom-slider preview uses to keep its density stable.
+ */
+function getFullRangeZoom(axisId) {
+  return {
+    axisId,
+    start: 0,
+    end: 100
+  };
+}
+const selectorChartSamplingState = state => state.sampling;
+
+/**
+ * Built sampling structures keyed by series id. Memoized, so rebuilt only on data change. Builds
+ * only for series types that are enabled and register a `sampler`; the plot hook reads them back.
+ */
+exports.selectorChartSamplingState = selectorChartSamplingState;
+const selectorChartSamplingPyramids = exports.selectorChartSamplingPyramids = (0, _store.createSelectorMemoized)(selectorChartSamplingState, _useChartSeries.selectorChartSeriesProcessed, _useChartSeriesConfig.selectorChartSeriesConfig, function selectorChartSamplingPyramids(samplingState, processedSeries, seriesConfig) {
+  if (!samplingState?.enabled) {
+    return EMPTY_PYRAMIDS;
+  }
+  let sampled;
+  Object.keys(processedSeries).forEach(seriesType => {
+    const method = samplingState.methods[seriesType];
+    if (!method || method === 'none') {
+      return;
+    }
+    const sampler = seriesConfig[seriesType]?.sampler;
+    const typeData = processedSeries[seriesType];
+    if (!sampler || !typeData) {
+      return;
+    }
+    for (const seriesId of typeData.seriesOrder) {
+      const built = sampler.build(typeData.series[seriesId]);
+      if (built) {
+        sampled ?? (sampled = {});
+        sampled[seriesId] = built;
+      }
+    }
+  });
+  return sampled ?? EMPTY_PYRAMIDS;
+});
+
+/**
+ * Merged bucket size per band axis, to widen the axis highlight over a sampled bucket. Empty when
+ * sampling is off or no sampler is registered. The math lives in pro; community reads the integers.
+ */
+const selectorChartHighlightBucketSize = exports.selectorChartHighlightBucketSize = (0, _store.createSelectorMemoized)(selectorChartSamplingState, _useChartCartesianAxisRendering.selectorChartZoomMap, _useChartCartesianAxisRendering.selectorChartXAxis, _useChartCartesianAxisRendering.selectorChartYAxis, _useChartDimensions.selectorChartDrawingArea, _useChartCartesianAxisRendering.selectorChartZoomOptionsLookup, _useChartSeriesConfig.selectorChartSeriesConfig, function selectorChartHighlightBucketSize(samplingState, zoomMap, xAxis, yAxis, drawingArea, zoomOptions, seriesConfig) {
+  if (!samplingState?.enabled) {
+    return EMPTY_BUCKET_SIZES;
+  }
+  const bucketSizeAt = seriesConfig.bar?.sampler?.bucketSizeAt ?? seriesConfig.line?.sampler?.bucketSizeAt;
+  if (!bucketSizeAt) {
+    return EMPTY_BUCKET_SIZES;
+  }
+  const bucketSizes = new Map();
+  [[xAxis, drawingArea.width], [yAxis, drawingArea.height]].forEach(([axes, availableSize]) => {
+    axes.axisIds.forEach(axisId => {
+      const data = axes.axis[axisId].data;
+      const zoom = zoomMap?.get(axisId) ?? getFullRangeZoom(axisId);
+      const minSpan = zoomOptions[axisId]?.minSpan ?? 0;
+      if (data) {
+        bucketSizes.set(axisId, bucketSizeAt(zoom.end - zoom.start, {
+          dataLength: data.length,
+          availableSize,
+          minSpan
+        }));
+      }
+    });
+  });
+  return bucketSizes;
+});

package/internals/plugins/featurePlugins/useChartCartesianAxis/sampling.selectors.mjs

@@ -0,0 +1,81 @@
+import { createSelectorMemoized } from '@mui/x-internals/store';
+import { selectorChartSeriesProcessed } from "../../corePlugins/useChartSeries/index.mjs";
+import { selectorChartSeriesConfig } from "../../corePlugins/useChartSeriesConfig/index.mjs";
+import { selectorChartDrawingArea } from "../../corePlugins/useChartDimensions/index.mjs";
+import { selectorChartXAxis, selectorChartYAxis, selectorChartZoomMap, selectorChartZoomOptionsLookup } from "./useChartCartesianAxisRendering.selectors.mjs";
+const EMPTY_PYRAMIDS = {};
+const EMPTY_BUCKET_SIZES = new Map();
+
+/**
+ * Full-range zoom (span 100%) for a non-zoomable axis. Sampling gates on a zoom entry; a static axis
+ * has none, so we sample it at full range — the `MAX_RENDERED_POINTS` cap still applies. Mirrors the
+ * full-range zoom the zoom-slider preview uses to keep its density stable.
+ */
+export function getFullRangeZoom(axisId) {
+  return {
+    axisId,
+    start: 0,
+    end: 100
+  };
+}
+export const selectorChartSamplingState = state => state.sampling;
+
+/**
+ * Built sampling structures keyed by series id. Memoized, so rebuilt only on data change. Builds
+ * only for series types that are enabled and register a `sampler`; the plot hook reads them back.
+ */
+export const selectorChartSamplingPyramids = createSelectorMemoized(selectorChartSamplingState, selectorChartSeriesProcessed, selectorChartSeriesConfig, function selectorChartSamplingPyramids(samplingState, processedSeries, seriesConfig) {
+  if (!samplingState?.enabled) {
+    return EMPTY_PYRAMIDS;
+  }
+  let sampled;
+  Object.keys(processedSeries).forEach(seriesType => {
+    const method = samplingState.methods[seriesType];
+    if (!method || method === 'none') {
+      return;
+    }
+    const sampler = seriesConfig[seriesType]?.sampler;
+    const typeData = processedSeries[seriesType];
+    if (!sampler || !typeData) {
+      return;
+    }
+    for (const seriesId of typeData.seriesOrder) {
+      const built = sampler.build(typeData.series[seriesId]);
+      if (built) {
+        sampled ??= {};
+        sampled[seriesId] = built;
+      }
+    }
+  });
+  return sampled ?? EMPTY_PYRAMIDS;
+});
+
+/**
+ * Merged bucket size per band axis, to widen the axis highlight over a sampled bucket. Empty when
+ * sampling is off or no sampler is registered. The math lives in pro; community reads the integers.
+ */
+export const selectorChartHighlightBucketSize = createSelectorMemoized(selectorChartSamplingState, selectorChartZoomMap, selectorChartXAxis, selectorChartYAxis, selectorChartDrawingArea, selectorChartZoomOptionsLookup, selectorChartSeriesConfig, function selectorChartHighlightBucketSize(samplingState, zoomMap, xAxis, yAxis, drawingArea, zoomOptions, seriesConfig) {
+  if (!samplingState?.enabled) {
+    return EMPTY_BUCKET_SIZES;
+  }
+  const bucketSizeAt = seriesConfig.bar?.sampler?.bucketSizeAt ?? seriesConfig.line?.sampler?.bucketSizeAt;
+  if (!bucketSizeAt) {
+    return EMPTY_BUCKET_SIZES;
+  }
+  const bucketSizes = new Map();
+  [[xAxis, drawingArea.width], [yAxis, drawingArea.height]].forEach(([axes, availableSize]) => {
+    axes.axisIds.forEach(axisId => {
+      const data = axes.axis[axisId].data;
+      const zoom = zoomMap?.get(axisId) ?? getFullRangeZoom(axisId);
+      const minSpan = zoomOptions[axisId]?.minSpan ?? 0;
+      if (data) {
+        bucketSizes.set(axisId, bucketSizeAt(zoom.end - zoom.start, {
+          dataLength: data.length,
+          availableSize,
+          minSpan
+        }));
+      }
+    });
+  });
+  return bucketSizes;
+});

package/internals/plugins/featurePlugins/useChartCartesianAxis/sampling.types.d.mts

@@ -0,0 +1,93 @@
+import type { SeriesId } from "../../../../models/seriesType/common.mjs";
+import type { ChartSeriesType, ChartSeriesDefaultized, ChartsSeriesConfig } from "../../../../models/seriesType/config.mjs";
+import type { ZoomData } from "./zoom.types.mjs";
+/** Line sampling algorithms. `m4` pixel-accurate; `minmax` its 2-point subset; `lttb` keeps shape. */
+export type LineSamplingAlgorithm = 'm4' | 'minmax' | 'lttb';
+/** `sampling` prop method. `'none'` (default) disables; for lines it also picks the algorithm. */
+export type SamplingMethod = 'none' | LineSamplingAlgorithm;
+/** Bar `sampling` method. Bars always use a min/max envelope, so line-only algorithms are excluded. */
+export type BarSamplingMethod = 'none' | 'minmax';
+/**
+ * Per-series-type `sampling` prop on `ChartsDataProviderPro`. Derived from each type's
+ * `samplingMethod`, contributed by pro via the per-type series-config extensions (e.g.
+ * `BarSeriesExtension`). Empty in community-only builds.
+ */
+export type SamplingConfig = { [K in keyof ChartsSeriesConfig as ChartsSeriesConfig[K] extends {
+  samplingMethod: any;
+} ? K : never]?: ChartsSeriesConfig[K] extends {
+  samplingMethod: infer M;
+} ? M : never };
+/** State set by the pro `useChartProSampling` plugin; absent in community. */
+export interface SamplingState {
+  /** True when at least one series type is sampled. */
+  enabled: boolean;
+  /** Method per series type; absent/`'none'` = not sampled. */
+  methods: Partial<Record<ChartSeriesType, SamplingMethod>>;
+}
+/** Built sampling structures keyed by series id (type depends on the strategy). */
+export type SampledSeriesLookup = Record<SeriesId, unknown>;
+/**
+ * One bucket of the active level of detail: the index range it covers plus the indices to render.
+ * Lines flatten `indices` into a polyline; bars draw one merged rect over `[startIndex, endIndex]`.
+ */
+export interface SampledBucket {
+  /** First original index covered. */
+  startIndex: number;
+  /** Last original index covered (inclusive). */
+  endIndex: number;
+  /** Ascending original indices to render. */
+  indices: Int32Array;
+}
+/** Sampler inputs for one series. Bars omit `algorithm`/`getValues` (min/max envelope). */
+export interface SampleContext {
+  /** Opaque built structure (the strategy's `TBuilt`; the pyramid lives in pro). */
+  built: unknown;
+  /** Zoom of the sampled axis; `undefined` => sampler returns `null`. */
+  zoom: ZoomData | undefined;
+  /** Pixel extent along the sampled axis (band axis for bars, x-axis for lines). */
+  availableSize: number;
+  /** Axis zoom `minSpan`; level 0 (`span ≈ minSpan`) renders raw. */
+  minSpan: number;
+  /** Line algorithm. Omitted for bars, which always use the default min/max envelope. */
+  algorithm?: LineSamplingAlgorithm;
+  /**
+   * Lazy raw values, read only for `lttb`.
+   * @returns {ArrayLike<number>} The raw values.
+   */
+  getValues?: () => ArrayLike<number>;
+}
+/** Axis-level math inputs (no per-series built struct). */
+export interface AxisSamplingContext {
+  /** `axis.data.length`. */
+  dataLength: number;
+  /** Pixel extent along the band axis: width (x) / height (y). */
+  availableSize: number;
+  /** Axis zoom `minSpan`. */
+  minSpan: number;
+}
+/**
+ * Per-series-type sampling strategy, registered on `seriesConfig.sampler`. Owns both building the
+ * LOD structure and consuming it, so all algorithm code lives in pro; community calls through the
+ * pro-injected reference. `TBuilt` is opaque to community; pro narrows it per method.
+ */
+export interface SamplingStrategy<SeriesType extends ChartSeriesType = ChartSeriesType, TBuilt = unknown> {
+  /**
+   * Build the sampled structure for one series.
+   * @param {ChartSeriesDefaultized<SeriesType>} series The processed series.
+   * @returns {TBuilt | null} The built structure, or `null` if it can't be sampled.
+   */
+  build: (series: ChartSeriesDefaultized<SeriesType>) => TBuilt | null;
+  /**
+   * Active level of detail as buckets for the current zoom.
+   * @param {SampleContext} context The sampling inputs.
+   * @returns {SampledBucket[] | null} The buckets, or `null` to render raw.
+   */
+  sample?: (context: SampleContext) => SampledBucket[] | null;
+  /**
+   * Merged bucket size at a zoom span (`>= 1`; `1` = no merge), for axis-highlight widening.
+   * @param {number} span The zoom span (`end - start`).
+   * @param {AxisSamplingContext} context The axis inputs.
+   * @returns {number} The bucket size.
+   */
+  bucketSizeAt?: (span: number, context: AxisSamplingContext) => number;
+}

package/internals/plugins/featurePlugins/useChartCartesianAxis/sampling.types.d.ts

@@ -0,0 +1,93 @@
+import type { SeriesId } from "../../../../models/seriesType/common.js";
+import type { ChartSeriesType, ChartSeriesDefaultized, ChartsSeriesConfig } from "../../../../models/seriesType/config.js";
+import type { ZoomData } from "./zoom.types.js";
+/** Line sampling algorithms. `m4` pixel-accurate; `minmax` its 2-point subset; `lttb` keeps shape. */
+export type LineSamplingAlgorithm = 'm4' | 'minmax' | 'lttb';
+/** `sampling` prop method. `'none'` (default) disables; for lines it also picks the algorithm. */
+export type SamplingMethod = 'none' | LineSamplingAlgorithm;
+/** Bar `sampling` method. Bars always use a min/max envelope, so line-only algorithms are excluded. */
+export type BarSamplingMethod = 'none' | 'minmax';
+/**
+ * Per-series-type `sampling` prop on `ChartsDataProviderPro`. Derived from each type's
+ * `samplingMethod`, contributed by pro via the per-type series-config extensions (e.g.
+ * `BarSeriesExtension`). Empty in community-only builds.
+ */
+export type SamplingConfig = { [K in keyof ChartsSeriesConfig as ChartsSeriesConfig[K] extends {
+  samplingMethod: any;
+} ? K : never]?: ChartsSeriesConfig[K] extends {
+  samplingMethod: infer M;
+} ? M : never };
+/** State set by the pro `useChartProSampling` plugin; absent in community. */
+export interface SamplingState {
+  /** True when at least one series type is sampled. */
+  enabled: boolean;
+  /** Method per series type; absent/`'none'` = not sampled. */
+  methods: Partial<Record<ChartSeriesType, SamplingMethod>>;
+}
+/** Built sampling structures keyed by series id (type depends on the strategy). */
+export type SampledSeriesLookup = Record<SeriesId, unknown>;
+/**
+ * One bucket of the active level of detail: the index range it covers plus the indices to render.
+ * Lines flatten `indices` into a polyline; bars draw one merged rect over `[startIndex, endIndex]`.
+ */
+export interface SampledBucket {
+  /** First original index covered. */
+  startIndex: number;
+  /** Last original index covered (inclusive). */
+  endIndex: number;
+  /** Ascending original indices to render. */
+  indices: Int32Array;
+}
+/** Sampler inputs for one series. Bars omit `algorithm`/`getValues` (min/max envelope). */
+export interface SampleContext {
+  /** Opaque built structure (the strategy's `TBuilt`; the pyramid lives in pro). */
+  built: unknown;
+  /** Zoom of the sampled axis; `undefined` => sampler returns `null`. */
+  zoom: ZoomData | undefined;
+  /** Pixel extent along the sampled axis (band axis for bars, x-axis for lines). */
+  availableSize: number;
+  /** Axis zoom `minSpan`; level 0 (`span ≈ minSpan`) renders raw. */
+  minSpan: number;
+  /** Line algorithm. Omitted for bars, which always use the default min/max envelope. */
+  algorithm?: LineSamplingAlgorithm;
+  /**
+   * Lazy raw values, read only for `lttb`.
+   * @returns {ArrayLike<number>} The raw values.
+   */
+  getValues?: () => ArrayLike<number>;
+}
+/** Axis-level math inputs (no per-series built struct). */
+export interface AxisSamplingContext {
+  /** `axis.data.length`. */
+  dataLength: number;
+  /** Pixel extent along the band axis: width (x) / height (y). */
+  availableSize: number;
+  /** Axis zoom `minSpan`. */
+  minSpan: number;
+}
+/**
+ * Per-series-type sampling strategy, registered on `seriesConfig.sampler`. Owns both building the
+ * LOD structure and consuming it, so all algorithm code lives in pro; community calls through the
+ * pro-injected reference. `TBuilt` is opaque to community; pro narrows it per method.
+ */
+export interface SamplingStrategy<SeriesType extends ChartSeriesType = ChartSeriesType, TBuilt = unknown> {
+  /**
+   * Build the sampled structure for one series.
+   * @param {ChartSeriesDefaultized<SeriesType>} series The processed series.
+   * @returns {TBuilt | null} The built structure, or `null` if it can't be sampled.
+   */
+  build: (series: ChartSeriesDefaultized<SeriesType>) => TBuilt | null;
+  /**
+   * Active level of detail as buckets for the current zoom.
+   * @param {SampleContext} context The sampling inputs.
+   * @returns {SampledBucket[] | null} The buckets, or `null` to render raw.
+   */
+  sample?: (context: SampleContext) => SampledBucket[] | null;
+  /**
+   * Merged bucket size at a zoom span (`>= 1`; `1` = no merge), for axis-highlight widening.
+   * @param {number} span The zoom span (`end - start`).
+   * @param {AxisSamplingContext} context The axis inputs.
+   * @returns {number} The bucket size.
+   */
+  bucketSizeAt?: (span: number, context: AxisSamplingContext) => number;
+}

package/internals/plugins/featurePlugins/useChartCartesianAxis/useChartCartesianAxis.types.d.mts

@@ -6,6 +6,7 @@ import type { ZoomData, ZoomOptions, ZoomSliderPreviewOptions, ZoomSliderShowToo
 import type { UseChartInteractionSignature } from "../useChartInteraction/index.mjs";
 import type { ChartsAxisProps } from "../../../../ChartsAxis/index.mjs";
 import type { UseChartBrushSignature } from "../useChartBrush/index.mjs";
+import type { SamplingState } from "./sampling.types.mjs";
 /**
  * The axes' configuration after computing.
  * An axis in this state already contains a scale function and all the necessary properties to be rendered.
@@ -97,6 +98,10 @@ export interface UseChartCartesianAxisState {
     isInteracting: boolean;
     zoomData: readonly ZoomData[];
   };
+  /**
+   * @ignore - state populated by the useChartProSampling plugin
+   */
+  sampling?: SamplingState;
   cartesianAxis: {
     axesGap: number;
     x: DefaultedXAxis[];

package/internals/plugins/featurePlugins/useChartCartesianAxis/useChartCartesianAxis.types.d.ts

@@ -6,6 +6,7 @@ import type { ZoomData, ZoomOptions, ZoomSliderPreviewOptions, ZoomSliderShowToo
 import type { UseChartInteractionSignature } from "../useChartInteraction/index.js";
 import type { ChartsAxisProps } from "../../../../ChartsAxis/index.js";
 import type { UseChartBrushSignature } from "../useChartBrush/index.js";
+import type { SamplingState } from "./sampling.types.js";
 /**
  * The axes' configuration after computing.
  * An axis in this state already contains a scale function and all the necessary properties to be rendered.
@@ -97,6 +98,10 @@ export interface UseChartCartesianAxisState {
     isInteracting: boolean;
     zoomData: readonly ZoomData[];
   };
+  /**
+   * @ignore - state populated by the useChartProSampling plugin
+   */
+  sampling?: SamplingState;
   cartesianAxis: {
     axesGap: number;
     x: DefaultedXAxis[];

package/internals/plugins/featurePlugins/useChartHighlight/createIsFaded.d.mts

@@ -4,4 +4,4 @@ import type { ChartSeriesType, HighlightScope } from "../../../../models/seriesT
 /**
  * The isFade logic for main charts (those that are identified by an id and a dataIndex)
  */
-export declare function createIsFaded<SeriesType extends Exclude<ChartSeriesType, 'sankey' | 'heatmap'>>(highlightScope: HighlightScope<SeriesType> | null | undefined, highlightedItem: HighlightItemIdentifier<SeriesType> | null): <TestedSeriesType extends ComposableChartSeriesType<SeriesType>>(item: HighlightItemIdentifierWithType<TestedSeriesType> | null) => boolean;
+export declare function createIsFaded<SeriesType extends Exclude<ChartSeriesType, 'sankey' | 'heatmap' | 'mapShape'>>(highlightScope: HighlightScope<SeriesType> | null | undefined, highlightedItem: HighlightItemIdentifier<SeriesType> | null): <TestedSeriesType extends ComposableChartSeriesType<SeriesType>>(item: HighlightItemIdentifierWithType<TestedSeriesType> | null) => boolean;

package/internals/plugins/featurePlugins/useChartHighlight/createIsFaded.d.ts

@@ -4,4 +4,4 @@ import type { ChartSeriesType, HighlightScope } from "../../../../models/seriesT
 /**
  * The isFade logic for main charts (those that are identified by an id and a dataIndex)
  */
-export declare function createIsFaded<SeriesType extends Exclude<ChartSeriesType, 'sankey' | 'heatmap'>>(highlightScope: HighlightScope<SeriesType> | null | undefined, highlightedItem: HighlightItemIdentifier<SeriesType> | null): <TestedSeriesType extends ComposableChartSeriesType<SeriesType>>(item: HighlightItemIdentifierWithType<TestedSeriesType> | null) => boolean;
+export declare function createIsFaded<SeriesType extends Exclude<ChartSeriesType, 'sankey' | 'heatmap' | 'mapShape'>>(highlightScope: HighlightScope<SeriesType> | null | undefined, highlightedItem: HighlightItemIdentifier<SeriesType> | null): <TestedSeriesType extends ComposableChartSeriesType<SeriesType>>(item: HighlightItemIdentifierWithType<TestedSeriesType> | null) => boolean;

package/internals/plugins/featurePlugins/useChartHighlight/createIsHighlighted.d.mts

@@ -4,4 +4,4 @@ import type { ChartSeriesType, HighlightScope } from "../../../../models/seriesT
 /**
  * The isHighlighted logic for main charts (those that are identified by an id and a dataIndex)
  */
-export declare function createIsHighlighted<SeriesType extends Exclude<ChartSeriesType, 'sankey' | 'heatmap'>>(highlightScope: HighlightScope<SeriesType> | null | undefined, highlightedItem: HighlightItemIdentifierWithType<SeriesType> | null): <TestedSeriesType extends ComposableChartSeriesType<SeriesType>>(item: HighlightItemIdentifierWithType<TestedSeriesType> | null) => boolean;
+export declare function createIsHighlighted<SeriesType extends Exclude<ChartSeriesType, 'sankey' | 'heatmap' | 'mapShape'>>(highlightScope: HighlightScope<SeriesType> | null | undefined, highlightedItem: HighlightItemIdentifierWithType<SeriesType> | null): <TestedSeriesType extends ComposableChartSeriesType<SeriesType>>(item: HighlightItemIdentifierWithType<TestedSeriesType> | null) => boolean;

package/internals/plugins/featurePlugins/useChartHighlight/createIsHighlighted.d.ts

@@ -4,4 +4,4 @@ import type { ChartSeriesType, HighlightScope } from "../../../../models/seriesT
 /**
  * The isHighlighted logic for main charts (those that are identified by an id and a dataIndex)
  */
-export declare function createIsHighlighted<SeriesType extends Exclude<ChartSeriesType, 'sankey' | 'heatmap'>>(highlightScope: HighlightScope<SeriesType> | null | undefined, highlightedItem: HighlightItemIdentifierWithType<SeriesType> | null): <TestedSeriesType extends ComposableChartSeriesType<SeriesType>>(item: HighlightItemIdentifierWithType<TestedSeriesType> | null) => boolean;
+export declare function createIsHighlighted<SeriesType extends Exclude<ChartSeriesType, 'sankey' | 'heatmap' | 'mapShape'>>(highlightScope: HighlightScope<SeriesType> | null | undefined, highlightedItem: HighlightItemIdentifierWithType<SeriesType> | null): <TestedSeriesType extends ComposableChartSeriesType<SeriesType>>(item: HighlightItemIdentifierWithType<TestedSeriesType> | null) => boolean;

package/internals/plugins/featurePlugins/useChartTooltip/useChartTooltip.selectors.d.mts

@@ -1,3 +1,4 @@
+import type { SeriesItemIdentifierWithType } from "../../../../models/index.mjs";
 export declare const selectorChartsTooltipPointerItem: (args_0: import("../../corePlugins/useChartId/useChartId.types.mjs").UseChartIdState & import("../../corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.mjs").UseChartSeriesConfigState<keyof import("../../../index.mjs").ChartsSeriesConfig> & import("../../corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.mjs").UseChartExperimentalFeaturesState & import("../../corePlugins/useChartDimensions/useChartDimensions.types.mjs").UseChartDimensionsState & import("../../corePlugins/useChartSeries/useChartSeries.types.mjs").UseChartSeriesState<keyof import("../../../index.mjs").ChartsSeriesConfig> & import("../../corePlugins/useChartAnimation/useChartAnimation.types.mjs").UseChartAnimationState & import("../../../index.mjs").UseChartInteractionListenerState & Partial<import("./useChartTooltip.types.mjs").UseChartTooltipState<keyof import("../../../index.mjs").ChartsSeriesConfig>> & {
   cacheKey: import("../../models/index.mjs").ChartStateCacheKey;
 }) => import("../../../index.mjs").LineItemIdentifier | import("../../../index.mjs").BarItemIdentifier | import("../../../../index.mjs").ScatterItemIdentifier | import("../../../../index.mjs").PieItemIdentifier | import("../../../../index.mjs").RadarItemIdentifier | null;
@@ -6,13 +7,7 @@ export declare const selectorChartsTooltipPointerItemIsDefined: (args_0: import(
 }) => boolean;
 export declare const selectorChartsTooltipItem: (args_0: import("../../corePlugins/useChartId/useChartId.types.mjs").UseChartIdState & import("../../corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.mjs").UseChartSeriesConfigState<keyof import("../../../index.mjs").ChartsSeriesConfig> & import("../../corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.mjs").UseChartExperimentalFeaturesState & import("../../corePlugins/useChartDimensions/useChartDimensions.types.mjs").UseChartDimensionsState & import("../../corePlugins/useChartSeries/useChartSeries.types.mjs").UseChartSeriesState<keyof import("../../../index.mjs").ChartsSeriesConfig> & import("../../corePlugins/useChartAnimation/useChartAnimation.types.mjs").UseChartAnimationState & import("../../../index.mjs").UseChartInteractionListenerState & Partial<import("../useChartInteraction/useChartInteraction.types.mjs").UseChartInteractionState> & {
   cacheKey: import("../../models/index.mjs").ChartStateCacheKey;
-}) => import("../../../index.mjs").LineItemIdentifier | import("../../../index.mjs").BarItemIdentifier | import("../../../../index.mjs").ScatterItemIdentifier | import("../../../../index.mjs").PieItemIdentifier | import("../../../../index.mjs").RadarItemIdentifier | null;
+}) => SeriesItemIdentifierWithType<keyof import("../../../index.mjs").ChartsSeriesConfig> | null;
 export declare const selectorChartsTooltipItemIsDefined: (args_0: import("../../corePlugins/useChartId/useChartId.types.mjs").UseChartIdState & import("../../corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.mjs").UseChartSeriesConfigState<keyof import("../../../index.mjs").ChartsSeriesConfig> & import("../../corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.mjs").UseChartExperimentalFeaturesState & import("../../corePlugins/useChartDimensions/useChartDimensions.types.mjs").UseChartDimensionsState & import("../../corePlugins/useChartSeries/useChartSeries.types.mjs").UseChartSeriesState<keyof import("../../../index.mjs").ChartsSeriesConfig> & import("../../corePlugins/useChartAnimation/useChartAnimation.types.mjs").UseChartAnimationState & import("../../../index.mjs").UseChartInteractionListenerState & Partial<import("../useChartInteraction/useChartInteraction.types.mjs").UseChartInteractionState> & {
   cacheKey: import("../../models/index.mjs").ChartStateCacheKey;
-}) => boolean;
-export declare const selectorChartsTooltipItemPosition: (args_0: import("../../corePlugins/useChartId/useChartId.types.mjs").UseChartIdState & import("../../corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.mjs").UseChartSeriesConfigState<keyof import("../../../index.mjs").ChartsSeriesConfig> & import("../../corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types.mjs").UseChartExperimentalFeaturesState & import("../../corePlugins/useChartDimensions/useChartDimensions.types.mjs").UseChartDimensionsState & import("../../corePlugins/useChartSeries/useChartSeries.types.mjs").UseChartSeriesState<keyof import("../../../index.mjs").ChartsSeriesConfig> & import("../../corePlugins/useChartAnimation/useChartAnimation.types.mjs").UseChartAnimationState & import("../../../index.mjs").UseChartInteractionListenerState & Partial<import("../useChartInteraction/useChartInteraction.types.mjs").UseChartInteractionState> & {
-  cacheKey: import("../../models/index.mjs").ChartStateCacheKey;
-}, placement: "bottom" | "left" | "right" | "top") => {
-  x: number;
-  y: number;
-} | null;
+}) => boolean;

package/internals/plugins/featurePlugins/useChartTooltip/useChartTooltip.selectors.d.ts

@@ -1,3 +1,4 @@
+import type { SeriesItemIdentifierWithType } from "../../../../models/index.js";
 export declare const selectorChartsTooltipPointerItem: (args_0: import("../../corePlugins/useChartId/useChartId.types.js").UseChartIdState & import("../../corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.js").UseChartSeriesConfigState<keyof import("../../../index.js").ChartsSeriesConfig> & 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("./useChartTooltip.types.js").UseChartTooltipState<keyof import("../../../index.js").ChartsSeriesConfig>> & {
   cacheKey: import("../../models/index.js").ChartStateCacheKey;
 }) => import("../../../index.js").LineItemIdentifier | import("../../../index.js").BarItemIdentifier | import("../../../../index.js").ScatterItemIdentifier | import("../../../../index.js").PieItemIdentifier | import("../../../../index.js").RadarItemIdentifier | null;
@@ -6,13 +7,7 @@ export declare const selectorChartsTooltipPointerItemIsDefined: (args_0: import(
 }) => boolean;
 export declare const selectorChartsTooltipItem: (args_0: import("../../corePlugins/useChartId/useChartId.types.js").UseChartIdState & import("../../corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.js").UseChartSeriesConfigState<keyof import("../../../index.js").ChartsSeriesConfig> & 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("../useChartInteraction/useChartInteraction.types.js").UseChartInteractionState> & {
   cacheKey: import("../../models/index.js").ChartStateCacheKey;
-}) => import("../../../index.js").LineItemIdentifier | import("../../../index.js").BarItemIdentifier | import("../../../../index.js").ScatterItemIdentifier | import("../../../../index.js").PieItemIdentifier | import("../../../../index.js").RadarItemIdentifier | null;
+}) => SeriesItemIdentifierWithType<keyof import("../../../index.js").ChartsSeriesConfig> | null;
 export declare const selectorChartsTooltipItemIsDefined: (args_0: import("../../corePlugins/useChartId/useChartId.types.js").UseChartIdState & import("../../corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.js").UseChartSeriesConfigState<keyof import("../../../index.js").ChartsSeriesConfig> & 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("../useChartInteraction/useChartInteraction.types.js").UseChartInteractionState> & {
   cacheKey: import("../../models/index.js").ChartStateCacheKey;
-}) => boolean;
-export declare const selectorChartsTooltipItemPosition: (args_0: import("../../corePlugins/useChartId/useChartId.types.js").UseChartIdState & import("../../corePlugins/useChartSeriesConfig/useChartSeriesConfig.types.js").UseChartSeriesConfigState<keyof import("../../../index.js").ChartsSeriesConfig> & 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("../useChartInteraction/useChartInteraction.types.js").UseChartInteractionState> & {
-  cacheKey: import("../../models/index.js").ChartStateCacheKey;
-}, placement: "bottom" | "left" | "right" | "top") => {
-  x: number;
-  y: number;
-} | null;
+}) => boolean;

package/internals/plugins/featurePlugins/useChartTooltip/useChartTooltip.selectors.js

@@ -3,67 +3,12 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.selectorChartsTooltipPointerItemIsDefined = exports.selectorChartsTooltipPointerItem = exports.selectorChartsTooltipItemPosition = exports.selectorChartsTooltipItemIsDefined = exports.selectorChartsTooltipItem = void 0;
+exports.selectorChartsTooltipPointerItemIsDefined = exports.selectorChartsTooltipPointerItem = exports.selectorChartsTooltipItemIsDefined = exports.selectorChartsTooltipItem = void 0;
 var _store = require("@mui/x-internals/store");
-var _useChartSeries = require("../../corePlugins/useChartSeries");
-var _useChartSeriesConfig = require("../../corePlugins/useChartSeriesConfig");
-var _useChartCartesianAxisRendering = require("../useChartCartesianAxis/useChartCartesianAxisRendering.selectors");
 var _useChartKeyboardNavigation = require("../useChartKeyboardNavigation");
 var _useChartInteraction = require("../useChartInteraction/useChartInteraction.selectors");
-var _useChartDimensions = require("../../corePlugins/useChartDimensions/useChartDimensions.selectors");
-var _isCartesian = require("../../../isCartesian");
-var _useChartPolarAxis = require("../useChartPolarAxis/useChartPolarAxis.selectors");
-var _useGeoProjection = require("../useGeoProjection/useGeoProjection.selectors");
 const selectTooltip = state => state.tooltip;
 const selectorChartsTooltipPointerItem = exports.selectorChartsTooltipPointerItem = (0, _store.createSelector)(selectTooltip, tooltip => tooltip?.item ?? null);
 const selectorChartsTooltipPointerItemIsDefined = exports.selectorChartsTooltipPointerItemIsDefined = (0, _store.createSelector)(selectorChartsTooltipPointerItem, item => item !== null);
 const selectorChartsTooltipItem = exports.selectorChartsTooltipItem = (0, _store.createSelector)(_useChartInteraction.selectorChartsLastInteraction, selectorChartsTooltipPointerItem, _useChartKeyboardNavigation.selectorChartsKeyboardItem, (lastInteraction, pointerItem, keyboardItem) => lastInteraction === 'keyboard' ? keyboardItem : pointerItem ?? null);
-const selectorChartsTooltipItemIsDefined = exports.selectorChartsTooltipItemIsDefined = (0, _store.createSelector)(_useChartInteraction.selectorChartsLastInteraction, selectorChartsTooltipPointerItemIsDefined, _useChartKeyboardNavigation.selectorChartsHasFocusedItem, (lastInteraction, pointerItemIsDefined, keyboardItemIsDefined) => lastInteraction === 'keyboard' ? keyboardItemIsDefined : pointerItemIsDefined);
-const selectorChartsTooltipAxisConfig = (0, _store.createSelectorMemoized)(selectorChartsTooltipItem, _useChartCartesianAxisRendering.selectorChartXAxis, _useChartCartesianAxisRendering.selectorChartYAxis, _useChartPolarAxis.selectorChartRotationAxis, _useChartPolarAxis.selectorChartRadiusAxis, _useChartSeries.selectorChartSeriesProcessed, _useGeoProjection.selectorGeoTooltipPosition, function selectorChartsTooltipAxisConfig(identifier, {
-  axis: xAxis,
-  axisIds: xAxisIds
-}, {
-  axis: yAxis,
-  axisIds: yAxisIds
-}, rotationAxes, radiusAxes, series, geo) {
-  if (!identifier) {
-    return {};
-  }
-  const itemSeries = series[identifier.type]?.series[identifier.seriesId];
-  if (!itemSeries) {
-    return {};
-  }
-  const axesConfig = {
-    rotationAxes,
-    radiusAxes
-  };
-  const xAxisId = (0, _isCartesian.isCartesianSeries)(itemSeries) ? itemSeries.xAxisId ?? xAxisIds[0] : undefined;
-  const yAxisId = (0, _isCartesian.isCartesianSeries)(itemSeries) ? itemSeries.yAxisId ?? yAxisIds[0] : undefined;
-  if (xAxisId !== undefined) {
-    axesConfig.x = xAxis[xAxisId];
-  }
-  if (yAxisId !== undefined) {
-    axesConfig.y = yAxis[yAxisId];
-  }
-  if (geo) {
-    axesConfig.geo = geo;
-  }
-  return axesConfig;
-});
-const selectorChartsTooltipItemPosition = exports.selectorChartsTooltipItemPosition = (0, _store.createSelectorMemoized)(selectorChartsTooltipItem, _useChartDimensions.selectorChartDrawingArea, _useChartSeriesConfig.selectorChartSeriesConfig, _useChartSeries.selectorChartSeriesProcessed, _useChartSeries.selectorChartSeriesLayout, selectorChartsTooltipAxisConfig, function selectorChartsTooltipItemPosition(identifier, drawingArea, seriesConfig, series, seriesLayout, axesConfig, placement) {
-  if (!identifier) {
-    return null;
-  }
-  const itemSeries = series[identifier.type]?.series[identifier.seriesId];
-  if (!itemSeries) {
-    return null;
-  }
-  return seriesConfig[itemSeries.type].tooltipItemPositionGetter?.({
-    series,
-    seriesLayout,
-    drawingArea,
-    axesConfig,
-    identifier,
-    placement
-  }) ?? null;
-});
+const selectorChartsTooltipItemIsDefined = exports.selectorChartsTooltipItemIsDefined = (0, _store.createSelector)(_useChartInteraction.selectorChartsLastInteraction, selectorChartsTooltipPointerItemIsDefined, _useChartKeyboardNavigation.selectorChartsHasFocusedItem, (lastInteraction, pointerItemIsDefined, keyboardItemIsDefined) => lastInteraction === 'keyboard' ? keyboardItemIsDefined : pointerItemIsDefined);

package/internals/plugins/featurePlugins/useChartTooltip/useChartTooltip.selectors.mjs

@@ -1,63 +1,8 @@
-import { createSelector, createSelectorMemoized } from '@mui/x-internals/store';
-import { selectorChartSeriesProcessed, selectorChartSeriesLayout } from "../../corePlugins/useChartSeries/index.mjs";
-import { selectorChartSeriesConfig } from "../../corePlugins/useChartSeriesConfig/index.mjs";
-import { selectorChartXAxis, selectorChartYAxis } from "../useChartCartesianAxis/useChartCartesianAxisRendering.selectors.mjs";
+import { createSelector } from '@mui/x-internals/store';
 import { selectorChartsKeyboardItem, selectorChartsHasFocusedItem } from "../useChartKeyboardNavigation/index.mjs";
 import { selectorChartsLastInteraction } from "../useChartInteraction/useChartInteraction.selectors.mjs";
-import { selectorChartDrawingArea } from "../../corePlugins/useChartDimensions/useChartDimensions.selectors.mjs";
-import { isCartesianSeries } from "../../../isCartesian.mjs";
-import { selectorChartRadiusAxis, selectorChartRotationAxis } from "../useChartPolarAxis/useChartPolarAxis.selectors.mjs";
-import { selectorGeoTooltipPosition } from "../useGeoProjection/useGeoProjection.selectors.mjs";
 const selectTooltip = state => state.tooltip;
 export const selectorChartsTooltipPointerItem = createSelector(selectTooltip, tooltip => tooltip?.item ?? null);
 export const selectorChartsTooltipPointerItemIsDefined = createSelector(selectorChartsTooltipPointerItem, item => item !== null);
 export const selectorChartsTooltipItem = createSelector(selectorChartsLastInteraction, selectorChartsTooltipPointerItem, selectorChartsKeyboardItem, (lastInteraction, pointerItem, keyboardItem) => lastInteraction === 'keyboard' ? keyboardItem : pointerItem ?? null);
-export const selectorChartsTooltipItemIsDefined = createSelector(selectorChartsLastInteraction, selectorChartsTooltipPointerItemIsDefined, selectorChartsHasFocusedItem, (lastInteraction, pointerItemIsDefined, keyboardItemIsDefined) => lastInteraction === 'keyboard' ? keyboardItemIsDefined : pointerItemIsDefined);
-const selectorChartsTooltipAxisConfig = createSelectorMemoized(selectorChartsTooltipItem, selectorChartXAxis, selectorChartYAxis, selectorChartRotationAxis, selectorChartRadiusAxis, selectorChartSeriesProcessed, selectorGeoTooltipPosition, function selectorChartsTooltipAxisConfig(identifier, {
-  axis: xAxis,
-  axisIds: xAxisIds
-}, {
-  axis: yAxis,
-  axisIds: yAxisIds
-}, rotationAxes, radiusAxes, series, geo) {
-  if (!identifier) {
-    return {};
-  }
-  const itemSeries = series[identifier.type]?.series[identifier.seriesId];
-  if (!itemSeries) {
-    return {};
-  }
-  const axesConfig = {
-    rotationAxes,
-    radiusAxes
-  };
-  const xAxisId = isCartesianSeries(itemSeries) ? itemSeries.xAxisId ?? xAxisIds[0] : undefined;
-  const yAxisId = isCartesianSeries(itemSeries) ? itemSeries.yAxisId ?? yAxisIds[0] : undefined;
-  if (xAxisId !== undefined) {
-    axesConfig.x = xAxis[xAxisId];
-  }
-  if (yAxisId !== undefined) {
-    axesConfig.y = yAxis[yAxisId];
-  }
-  if (geo) {
-    axesConfig.geo = geo;
-  }
-  return axesConfig;
-});
-export const selectorChartsTooltipItemPosition = createSelectorMemoized(selectorChartsTooltipItem, selectorChartDrawingArea, selectorChartSeriesConfig, selectorChartSeriesProcessed, selectorChartSeriesLayout, selectorChartsTooltipAxisConfig, function selectorChartsTooltipItemPosition(identifier, drawingArea, seriesConfig, series, seriesLayout, axesConfig, placement) {
-  if (!identifier) {
-    return null;
-  }
-  const itemSeries = series[identifier.type]?.series[identifier.seriesId];
-  if (!itemSeries) {
-    return null;
-  }
-  return seriesConfig[itemSeries.type].tooltipItemPositionGetter?.({
-    series,
-    seriesLayout,
-    drawingArea,
-    axesConfig,
-    identifier,
-    placement
-  }) ?? null;
-});
+export const selectorChartsTooltipItemIsDefined = createSelector(selectorChartsLastInteraction, selectorChartsTooltipPointerItemIsDefined, selectorChartsHasFocusedItem, (lastInteraction, pointerItemIsDefined, keyboardItemIsDefined) => lastInteraction === 'keyboard' ? keyboardItemIsDefined : pointerItemIsDefined);

package/internals/shallowEqual.d.mts

@@ -3,6 +3,6 @@
  * when any key has values which are not strictly equal between the arguments.
  * Returns true when the values of all keys are strictly equal.
  *
- * Source: https://github.com/facebook/react/blob/c2a196174763e0b4f16ed1c512ed4442b062395e/packages/shared/shallowEqual.js#L18
+ * Source: https://github.com/react/react/blob/c2a196174763e0b4f16ed1c512ed4442b062395e/packages/shared/shallowEqual.js#L18
  */
 export declare function shallowEqual(objA: unknown, objB: unknown): boolean;