@mui/x-charts-premium 9.3.0 → 9.4.0

package/internals/plugins/useGeoProjection/useGeoProjection.d.mts

@@ -0,0 +1,3 @@
+import { type ChartPlugin } from '@mui/x-charts/internals';
+import { type UseGeoProjectionSignature } from "./useGeoProjection.types.mjs";
+export declare const useGeoProjection: ChartPlugin<UseGeoProjectionSignature>;

package/internals/plugins/useGeoProjection/useGeoProjection.d.ts

@@ -0,0 +1,3 @@
+import { type ChartPlugin } from '@mui/x-charts/internals';
+import { type UseGeoProjectionSignature } from "./useGeoProjection.types.js";
+export declare const useGeoProjection: ChartPlugin<UseGeoProjectionSignature>;

package/internals/plugins/useGeoProjection/useGeoProjection.js

@@ -0,0 +1,58 @@
+"use strict";
+'use client';
+
+var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard").default;
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useGeoProjection = void 0;
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+var React = _interopRequireWildcard(require("react"));
+const useGeoProjection = ({
+  params,
+  store
+}) => {
+  const {
+    geoData,
+    projection,
+    translate,
+    rotate,
+    scale
+  } = params;
+  const isFirstRender = React.useRef(true);
+  React.useEffect(() => {
+    if (isFirstRender.current) {
+      isFirstRender.current = false;
+      return;
+    }
+    store.set('geoProjection', {
+      geoData: geoData ?? null,
+      projection: projection ?? null,
+      translate: translate ?? null,
+      rotate: rotate ?? null,
+      scale: scale ?? null
+    });
+  }, [geoData, projection, translate, rotate, scale, store]);
+  return {};
+};
+exports.useGeoProjection = useGeoProjection;
+useGeoProjection.params = {
+  geoData: true,
+  projection: true,
+  translate: true,
+  rotate: true,
+  scale: true
+};
+useGeoProjection.getDefaultizedParams = ({
+  params
+}) => (0, _extends2.default)({}, params);
+useGeoProjection.getInitialState = params => ({
+  geoProjection: {
+    geoData: params.geoData ?? null,
+    projection: params.projection ?? null,
+    translate: params.translate ?? null,
+    rotate: params.rotate ?? null,
+    scale: params.scale ?? null
+  }
+});

package/internals/plugins/useGeoProjection/useGeoProjection.mjs

@@ -0,0 +1,50 @@
+'use client';
+
+import _extends from "@babel/runtime/helpers/esm/extends";
+import * as React from 'react';
+export const useGeoProjection = ({
+  params,
+  store
+}) => {
+  const {
+    geoData,
+    projection,
+    translate,
+    rotate,
+    scale
+  } = params;
+  const isFirstRender = React.useRef(true);
+  React.useEffect(() => {
+    if (isFirstRender.current) {
+      isFirstRender.current = false;
+      return;
+    }
+    store.set('geoProjection', {
+      geoData: geoData ?? null,
+      projection: projection ?? null,
+      translate: translate ?? null,
+      rotate: rotate ?? null,
+      scale: scale ?? null
+    });
+  }, [geoData, projection, translate, rotate, scale, store]);
+  return {};
+};
+useGeoProjection.params = {
+  geoData: true,
+  projection: true,
+  translate: true,
+  rotate: true,
+  scale: true
+};
+useGeoProjection.getDefaultizedParams = ({
+  params
+}) => _extends({}, params);
+useGeoProjection.getInitialState = params => ({
+  geoProjection: {
+    geoData: params.geoData ?? null,
+    projection: params.projection ?? null,
+    translate: params.translate ?? null,
+    rotate: params.rotate ?? null,
+    scale: params.scale ?? null
+  }
+});

package/internals/plugins/useGeoProjection/useGeoProjection.selectors.d.mts

@@ -0,0 +1,39 @@
+import { type ChartState } from '@mui/x-charts/internals';
+import { type ExtendedFeatureCollection, type GeoProjection, type GeoPath } from '@mui/x-charts-vendor/d3-geo';
+import type { GeoProjectionInput, UseGeoProjectionSignature, UseGeoProjectionState } from "./useGeoProjection.types.mjs";
+export declare const selectorChartGeoProjectionState: (state: ChartState<[], [UseGeoProjectionSignature]>) => UseGeoProjectionState["geoProjection"] | undefined;
+export declare const selectorChartRawGeoData: (state: ChartState<[], [UseGeoProjectionSignature]>) => ExtendedFeatureCollection | null;
+export declare const selectorChartRawProjection: (args_0: import("@mui/x-charts/internals/plugins/corePlugins/useChartId/useChartId.types").UseChartIdState & import("@mui/x-charts/internals/plugins/corePlugins/useChartSeriesConfig/useChartSeriesConfig.types").UseChartSeriesConfigState<keyof import("@mui/x-charts/internals").ChartsSeriesConfig> & import("@mui/x-charts/internals/plugins/corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types").UseChartExperimentalFeaturesState & import("@mui/x-charts/internals/plugins/corePlugins/useChartDimensions/useChartDimensions.types").UseChartDimensionsState & import("@mui/x-charts/internals/plugins/corePlugins/useChartSeries/useChartSeries.types").UseChartSeriesState<keyof import("@mui/x-charts/internals").ChartsSeriesConfig> & import("@mui/x-charts/internals/plugins/corePlugins/useChartAnimation/useChartAnimation.types").UseChartAnimationState & import("@mui/x-charts/internals").UseChartInteractionListenerState & Partial<UseGeoProjectionState> & {
+  cacheKey: import("@mui/x-charts/internals").ChartStateCacheKey;
+}) => GeoProjectionInput | null;
+export declare const selectorChartRawScale: (args_0: import("@mui/x-charts/internals/plugins/corePlugins/useChartId/useChartId.types").UseChartIdState & import("@mui/x-charts/internals/plugins/corePlugins/useChartSeriesConfig/useChartSeriesConfig.types").UseChartSeriesConfigState<keyof import("@mui/x-charts/internals").ChartsSeriesConfig> & import("@mui/x-charts/internals/plugins/corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types").UseChartExperimentalFeaturesState & import("@mui/x-charts/internals/plugins/corePlugins/useChartDimensions/useChartDimensions.types").UseChartDimensionsState & import("@mui/x-charts/internals/plugins/corePlugins/useChartSeries/useChartSeries.types").UseChartSeriesState<keyof import("@mui/x-charts/internals").ChartsSeriesConfig> & import("@mui/x-charts/internals/plugins/corePlugins/useChartAnimation/useChartAnimation.types").UseChartAnimationState & import("@mui/x-charts/internals").UseChartInteractionListenerState & Partial<UseGeoProjectionState> & {
+  cacheKey: import("@mui/x-charts/internals").ChartStateCacheKey;
+}) => number | null;
+/**
+ * Map a feature's `properties.name` to its index in `geoData.features`,
+ * for fast lookup by name when joining series rows to features.
+ *
+ * Features without a string `properties.name` are skipped; on duplicates,
+ * the first occurrence wins.
+ */
+export declare const selectorChartGeoFeatureIndexesByName: (args_0: import("@mui/x-charts/internals/plugins/corePlugins/useChartId/useChartId.types").UseChartIdState & import("@mui/x-charts/internals/plugins/corePlugins/useChartSeriesConfig/useChartSeriesConfig.types").UseChartSeriesConfigState<keyof import("@mui/x-charts/internals").ChartsSeriesConfig> & import("@mui/x-charts/internals/plugins/corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types").UseChartExperimentalFeaturesState & import("@mui/x-charts/internals/plugins/corePlugins/useChartDimensions/useChartDimensions.types").UseChartDimensionsState & import("@mui/x-charts/internals/plugins/corePlugins/useChartSeries/useChartSeries.types").UseChartSeriesState<keyof import("@mui/x-charts/internals").ChartsSeriesConfig> & import("@mui/x-charts/internals/plugins/corePlugins/useChartAnimation/useChartAnimation.types").UseChartAnimationState & import("@mui/x-charts/internals").UseChartInteractionListenerState & Partial<UseGeoProjectionState> & {
+  cacheKey: import("@mui/x-charts/internals").ChartStateCacheKey;
+}) => ReadonlyMap<string, number[]>;
+/**
+ * Resolves the raw `projection` input into a ready-to-use `GeoProjection` instance
+ * fitted to the chart's drawing area.
+ *
+ * - String inputs (e.g. `'mercator'`) are mapped to the matching d3-geo factory.
+ * - `GeoProjection` instances are used as-is, then fitted.
+ * - Returns `null` when no projection is registered or the name is unknown.
+ */
+export declare const selectorChartProjection: (args_0: import("@mui/x-charts/internals/plugins/corePlugins/useChartId/useChartId.types").UseChartIdState & import("@mui/x-charts/internals/plugins/corePlugins/useChartSeriesConfig/useChartSeriesConfig.types").UseChartSeriesConfigState<keyof import("@mui/x-charts/internals").ChartsSeriesConfig> & import("@mui/x-charts/internals/plugins/corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types").UseChartExperimentalFeaturesState & import("@mui/x-charts/internals/plugins/corePlugins/useChartDimensions/useChartDimensions.types").UseChartDimensionsState & import("@mui/x-charts/internals/plugins/corePlugins/useChartSeries/useChartSeries.types").UseChartSeriesState<keyof import("@mui/x-charts/internals").ChartsSeriesConfig> & import("@mui/x-charts/internals/plugins/corePlugins/useChartAnimation/useChartAnimation.types").UseChartAnimationState & import("@mui/x-charts/internals").UseChartInteractionListenerState & Partial<UseGeoProjectionState> & {
+  cacheKey: import("@mui/x-charts/internals").ChartStateCacheKey;
+}) => GeoProjection | null;
+/**
+ * Resolves the raw `projection` input into a ready-to-use `GeoPath` instance
+ * fitted to the chart's drawing area.
+ */
+export declare const selectorChartGeoPath: (args_0: import("@mui/x-charts/internals/plugins/corePlugins/useChartId/useChartId.types").UseChartIdState & import("@mui/x-charts/internals/plugins/corePlugins/useChartSeriesConfig/useChartSeriesConfig.types").UseChartSeriesConfigState<keyof import("@mui/x-charts/internals").ChartsSeriesConfig> & import("@mui/x-charts/internals/plugins/corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types").UseChartExperimentalFeaturesState & import("@mui/x-charts/internals/plugins/corePlugins/useChartDimensions/useChartDimensions.types").UseChartDimensionsState & import("@mui/x-charts/internals/plugins/corePlugins/useChartSeries/useChartSeries.types").UseChartSeriesState<keyof import("@mui/x-charts/internals").ChartsSeriesConfig> & import("@mui/x-charts/internals/plugins/corePlugins/useChartAnimation/useChartAnimation.types").UseChartAnimationState & import("@mui/x-charts/internals").UseChartInteractionListenerState & Partial<UseGeoProjectionState> & {
+  cacheKey: import("@mui/x-charts/internals").ChartStateCacheKey;
+}) => GeoPath<any, import("@mui/x-charts-vendor/d3-geo").GeoPermissibleObjects> | null;

package/internals/plugins/useGeoProjection/useGeoProjection.selectors.d.ts

@@ -0,0 +1,39 @@
+import { type ChartState } from '@mui/x-charts/internals';
+import { type ExtendedFeatureCollection, type GeoProjection, type GeoPath } from '@mui/x-charts-vendor/d3-geo';
+import type { GeoProjectionInput, UseGeoProjectionSignature, UseGeoProjectionState } from "./useGeoProjection.types.js";
+export declare const selectorChartGeoProjectionState: (state: ChartState<[], [UseGeoProjectionSignature]>) => UseGeoProjectionState["geoProjection"] | undefined;
+export declare const selectorChartRawGeoData: (state: ChartState<[], [UseGeoProjectionSignature]>) => ExtendedFeatureCollection | null;
+export declare const selectorChartRawProjection: (args_0: import("@mui/x-charts/internals/plugins/corePlugins/useChartId/useChartId.types").UseChartIdState & import("@mui/x-charts/internals/plugins/corePlugins/useChartSeriesConfig/useChartSeriesConfig.types").UseChartSeriesConfigState<keyof import("@mui/x-charts/internals").ChartsSeriesConfig> & import("@mui/x-charts/internals/plugins/corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types").UseChartExperimentalFeaturesState & import("@mui/x-charts/internals/plugins/corePlugins/useChartDimensions/useChartDimensions.types").UseChartDimensionsState & import("@mui/x-charts/internals/plugins/corePlugins/useChartSeries/useChartSeries.types").UseChartSeriesState<keyof import("@mui/x-charts/internals").ChartsSeriesConfig> & import("@mui/x-charts/internals/plugins/corePlugins/useChartAnimation/useChartAnimation.types").UseChartAnimationState & import("@mui/x-charts/internals").UseChartInteractionListenerState & Partial<UseGeoProjectionState> & {
+  cacheKey: import("@mui/x-charts/internals").ChartStateCacheKey;
+}) => GeoProjectionInput | null;
+export declare const selectorChartRawScale: (args_0: import("@mui/x-charts/internals/plugins/corePlugins/useChartId/useChartId.types").UseChartIdState & import("@mui/x-charts/internals/plugins/corePlugins/useChartSeriesConfig/useChartSeriesConfig.types").UseChartSeriesConfigState<keyof import("@mui/x-charts/internals").ChartsSeriesConfig> & import("@mui/x-charts/internals/plugins/corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types").UseChartExperimentalFeaturesState & import("@mui/x-charts/internals/plugins/corePlugins/useChartDimensions/useChartDimensions.types").UseChartDimensionsState & import("@mui/x-charts/internals/plugins/corePlugins/useChartSeries/useChartSeries.types").UseChartSeriesState<keyof import("@mui/x-charts/internals").ChartsSeriesConfig> & import("@mui/x-charts/internals/plugins/corePlugins/useChartAnimation/useChartAnimation.types").UseChartAnimationState & import("@mui/x-charts/internals").UseChartInteractionListenerState & Partial<UseGeoProjectionState> & {
+  cacheKey: import("@mui/x-charts/internals").ChartStateCacheKey;
+}) => number | null;
+/**
+ * Map a feature's `properties.name` to its index in `geoData.features`,
+ * for fast lookup by name when joining series rows to features.
+ *
+ * Features without a string `properties.name` are skipped; on duplicates,
+ * the first occurrence wins.
+ */
+export declare const selectorChartGeoFeatureIndexesByName: (args_0: import("@mui/x-charts/internals/plugins/corePlugins/useChartId/useChartId.types").UseChartIdState & import("@mui/x-charts/internals/plugins/corePlugins/useChartSeriesConfig/useChartSeriesConfig.types").UseChartSeriesConfigState<keyof import("@mui/x-charts/internals").ChartsSeriesConfig> & import("@mui/x-charts/internals/plugins/corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types").UseChartExperimentalFeaturesState & import("@mui/x-charts/internals/plugins/corePlugins/useChartDimensions/useChartDimensions.types").UseChartDimensionsState & import("@mui/x-charts/internals/plugins/corePlugins/useChartSeries/useChartSeries.types").UseChartSeriesState<keyof import("@mui/x-charts/internals").ChartsSeriesConfig> & import("@mui/x-charts/internals/plugins/corePlugins/useChartAnimation/useChartAnimation.types").UseChartAnimationState & import("@mui/x-charts/internals").UseChartInteractionListenerState & Partial<UseGeoProjectionState> & {
+  cacheKey: import("@mui/x-charts/internals").ChartStateCacheKey;
+}) => ReadonlyMap<string, number[]>;
+/**
+ * Resolves the raw `projection` input into a ready-to-use `GeoProjection` instance
+ * fitted to the chart's drawing area.
+ *
+ * - String inputs (e.g. `'mercator'`) are mapped to the matching d3-geo factory.
+ * - `GeoProjection` instances are used as-is, then fitted.
+ * - Returns `null` when no projection is registered or the name is unknown.
+ */
+export declare const selectorChartProjection: (args_0: import("@mui/x-charts/internals/plugins/corePlugins/useChartId/useChartId.types").UseChartIdState & import("@mui/x-charts/internals/plugins/corePlugins/useChartSeriesConfig/useChartSeriesConfig.types").UseChartSeriesConfigState<keyof import("@mui/x-charts/internals").ChartsSeriesConfig> & import("@mui/x-charts/internals/plugins/corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types").UseChartExperimentalFeaturesState & import("@mui/x-charts/internals/plugins/corePlugins/useChartDimensions/useChartDimensions.types").UseChartDimensionsState & import("@mui/x-charts/internals/plugins/corePlugins/useChartSeries/useChartSeries.types").UseChartSeriesState<keyof import("@mui/x-charts/internals").ChartsSeriesConfig> & import("@mui/x-charts/internals/plugins/corePlugins/useChartAnimation/useChartAnimation.types").UseChartAnimationState & import("@mui/x-charts/internals").UseChartInteractionListenerState & Partial<UseGeoProjectionState> & {
+  cacheKey: import("@mui/x-charts/internals").ChartStateCacheKey;
+}) => GeoProjection | null;
+/**
+ * Resolves the raw `projection` input into a ready-to-use `GeoPath` instance
+ * fitted to the chart's drawing area.
+ */
+export declare const selectorChartGeoPath: (args_0: import("@mui/x-charts/internals/plugins/corePlugins/useChartId/useChartId.types").UseChartIdState & import("@mui/x-charts/internals/plugins/corePlugins/useChartSeriesConfig/useChartSeriesConfig.types").UseChartSeriesConfigState<keyof import("@mui/x-charts/internals").ChartsSeriesConfig> & import("@mui/x-charts/internals/plugins/corePlugins/useChartExperimentalFeature/useChartExperimentalFeature.types").UseChartExperimentalFeaturesState & import("@mui/x-charts/internals/plugins/corePlugins/useChartDimensions/useChartDimensions.types").UseChartDimensionsState & import("@mui/x-charts/internals/plugins/corePlugins/useChartSeries/useChartSeries.types").UseChartSeriesState<keyof import("@mui/x-charts/internals").ChartsSeriesConfig> & import("@mui/x-charts/internals/plugins/corePlugins/useChartAnimation/useChartAnimation.types").UseChartAnimationState & import("@mui/x-charts/internals").UseChartInteractionListenerState & Partial<UseGeoProjectionState> & {
+  cacheKey: import("@mui/x-charts/internals").ChartStateCacheKey;
+}) => GeoPath<any, import("@mui/x-charts-vendor/d3-geo").GeoPermissibleObjects> | null;

package/internals/plugins/useGeoProjection/useGeoProjection.selectors.js

@@ -0,0 +1,135 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.selectorChartRawScale = exports.selectorChartRawProjection = exports.selectorChartRawGeoData = exports.selectorChartProjection = exports.selectorChartGeoProjectionState = exports.selectorChartGeoPath = exports.selectorChartGeoFeatureIndexesByName = void 0;
+var _store = require("@mui/x-internals/store");
+var _internals = require("@mui/x-charts/internals");
+var _d3Geo = require("@mui/x-charts-vendor/d3-geo");
+const PROJECTION_FACTORIES = {
+  // Azimuthal projections (https://d3js.org/d3-geo/azimuthal)
+  azimuthalEqualArea: _d3Geo.geoAzimuthalEqualArea,
+  azimuthalEquidistant: _d3Geo.geoAzimuthalEquidistant,
+  gnomonic: _d3Geo.geoGnomonic,
+  orthographic: _d3Geo.geoOrthographic,
+  stereographic: _d3Geo.geoStereographic,
+  // Conic projections (https://d3js.org/d3-geo/conic)
+  conicConformal: _d3Geo.geoConicConformal,
+  conicEqualArea: _d3Geo.geoConicEqualArea,
+  conicEquidistant: _d3Geo.geoConicEquidistant,
+  albers: _d3Geo.geoAlbers,
+  albersUsa: _d3Geo.geoAlbersUsa,
+  // Special composition for the USA with an edge case for Alaska and Hawaii.
+
+  // Cylindrical projections (https://d3js.org/d3-geo/cylindrical)
+  equirectangular: _d3Geo.geoEquirectangular,
+  mercator: _d3Geo.geoMercator,
+  transverseMercator: _d3Geo.geoTransverseMercator,
+  equalEarth: _d3Geo.geoEqualEarth,
+  naturalEarth1: _d3Geo.geoNaturalEarth1
+};
+const isConicProjection = projection => {
+  return 'parallels' in projection && typeof projection.parallels === 'function';
+};
+const selectorChartGeoProjectionState = state => state.geoProjection;
+exports.selectorChartGeoProjectionState = selectorChartGeoProjectionState;
+const selectorChartRawGeoData = exports.selectorChartRawGeoData = (0, _store.createSelector)(selectorChartGeoProjectionState, geoProjection => geoProjection?.geoData ?? null);
+const selectorChartRawProjection = exports.selectorChartRawProjection = (0, _store.createSelector)(selectorChartGeoProjectionState, geoProjection => geoProjection?.projection ?? null);
+const selectorChartRawScale = exports.selectorChartRawScale = (0, _store.createSelector)(selectorChartGeoProjectionState, geoProjection => geoProjection?.scale ?? null);
+const selectorChartRotate = (0, _store.createSelectorMemoized)(selectorChartGeoProjectionState, geoProjection => geoProjection?.rotate ?? null);
+const selectorChartTranslate = (0, _store.createSelectorMemoized)(selectorChartGeoProjectionState, geoProjection => geoProjection?.translate ?? null);
+const selectorChartParallels = (0, _store.createSelectorMemoized)(selectorChartGeoProjectionState, selectorChartRotate, (geoProjection, rotate) => geoProjection?.parallels ?? (rotate ? [rotate[1] - 15, rotate[1] + 15] : [30, 30]));
+/**
+ * Map a feature's `properties.name` to its index in `geoData.features`,
+ * for fast lookup by name when joining series rows to features.
+ *
+ * Features without a string `properties.name` are skipped; on duplicates,
+ * the first occurrence wins.
+ */
+const selectorChartGeoFeatureIndexesByName = exports.selectorChartGeoFeatureIndexesByName = (0, _store.createSelectorMemoized)(selectorChartRawGeoData, geoData => {
+  const map = new Map();
+  if (!geoData) {
+    return map;
+  }
+  geoData.features.forEach((feature, index) => {
+    const name = feature.properties?.name;
+    if (typeof name !== 'string') {
+      return;
+    }
+    if (map.has(name)) {
+      map.get(name).push(index);
+      return;
+    }
+    map.set(name, [index]);
+  });
+  return map;
+});
+
+/**
+ * Resolves the raw `projection` input into a ready-to-use `GeoProjection` instance
+ * fitted to the chart's drawing area.
+ *
+ * - String inputs (e.g. `'mercator'`) are mapped to the matching d3-geo factory.
+ * - `GeoProjection` instances are used as-is, then fitted.
+ * - Returns `null` when no projection is registered or the name is unknown.
+ */
+const selectorChartProjection = exports.selectorChartProjection = (0, _store.createSelectorMemoized)(selectorChartRawProjection, selectorChartRawGeoData, selectorChartParallels, selectorChartRotate, selectorChartTranslate, selectorChartRawScale, _internals.selectorChartDrawingArea, (projectionInput, geoData, parallels, rotate, translate, scale, drawingArea) => {
+  if (!projectionInput) {
+    return null;
+  }
+  let projection;
+  if (typeof projectionInput === 'string') {
+    const factory = PROJECTION_FACTORIES[projectionInput];
+    if (!factory) {
+      if (process.env.NODE_ENV !== 'production') {
+        console.error(`MUI X Charts: Unknown projection name '${projectionInput}'. ` + `Expected one of: ${Object.keys(PROJECTION_FACTORIES).join(', ')}.`);
+      }
+      return null;
+    }
+    projection = factory();
+    if (isConicProjection(projection)) {
+      projection.parallels(parallels);
+    }
+  } else {
+    projection = projectionInput;
+  }
+  if (geoData) {
+    if (isConicProjection(projection)) {
+      if (rotate) {
+        projection.rotate?.(rotate);
+      }
+      if (!scale) {
+        const [[x0, y0], [x1, y1]] = (0, _d3Geo.geoPath)(projection).bounds(geoData);
+        const currentScale = projection.scale();
+        const fitScale = Math.min(currentScale * (drawingArea.width / (x1 - x0)), currentScale * (drawingArea.height / (y1 - y0)));
+        projection.scale(fitScale);
+      } else {
+        projection.scale(scale);
+      }
+      return projection;
+    }
+    if (rotate) {
+      projection.rotate?.(rotate);
+    }
+    if (scale) {
+      projection.scale(scale);
+      projection.clipExtent?.([[drawingArea.left, drawingArea.top], [drawingArea.left + drawingArea.width, drawingArea.top + drawingArea.height]]);
+    } else {
+      projection.fitExtent?.([[drawingArea.left, drawingArea.top], [drawingArea.left + drawingArea.width, drawingArea.top + drawingArea.height]], geoData);
+    }
+    projection.translate(translate ?? [drawingArea.left + drawingArea.width / 2, drawingArea.top + drawingArea.height / 2]);
+  }
+  return projection;
+});
+
+/**
+ * Resolves the raw `projection` input into a ready-to-use `GeoPath` instance
+ * fitted to the chart's drawing area.
+ */
+const selectorChartGeoPath = exports.selectorChartGeoPath = (0, _store.createSelectorMemoized)(selectorChartProjection, projection => {
+  if (!projection) {
+    return null;
+  }
+  return (0, _d3Geo.geoPath)(projection);
+});

package/internals/plugins/useGeoProjection/useGeoProjection.selectors.mjs

@@ -0,0 +1,128 @@
+import { createSelector, createSelectorMemoized } from '@mui/x-internals/store';
+import { selectorChartDrawingArea } from '@mui/x-charts/internals';
+import { geoAlbers, geoAlbersUsa, geoAzimuthalEqualArea, geoAzimuthalEquidistant, geoConicConformal, geoConicEqualArea, geoConicEquidistant, geoEqualEarth, geoEquirectangular, geoGnomonic, geoMercator, geoNaturalEarth1, geoOrthographic, geoStereographic, geoTransverseMercator, geoPath } from '@mui/x-charts-vendor/d3-geo';
+const PROJECTION_FACTORIES = {
+  // Azimuthal projections (https://d3js.org/d3-geo/azimuthal)
+  azimuthalEqualArea: geoAzimuthalEqualArea,
+  azimuthalEquidistant: geoAzimuthalEquidistant,
+  gnomonic: geoGnomonic,
+  orthographic: geoOrthographic,
+  stereographic: geoStereographic,
+  // Conic projections (https://d3js.org/d3-geo/conic)
+  conicConformal: geoConicConformal,
+  conicEqualArea: geoConicEqualArea,
+  conicEquidistant: geoConicEquidistant,
+  albers: geoAlbers,
+  albersUsa: geoAlbersUsa,
+  // Special composition for the USA with an edge case for Alaska and Hawaii.
+
+  // Cylindrical projections (https://d3js.org/d3-geo/cylindrical)
+  equirectangular: geoEquirectangular,
+  mercator: geoMercator,
+  transverseMercator: geoTransverseMercator,
+  equalEarth: geoEqualEarth,
+  naturalEarth1: geoNaturalEarth1
+};
+const isConicProjection = projection => {
+  return 'parallels' in projection && typeof projection.parallels === 'function';
+};
+export const selectorChartGeoProjectionState = state => state.geoProjection;
+export const selectorChartRawGeoData = createSelector(selectorChartGeoProjectionState, geoProjection => geoProjection?.geoData ?? null);
+export const selectorChartRawProjection = createSelector(selectorChartGeoProjectionState, geoProjection => geoProjection?.projection ?? null);
+export const selectorChartRawScale = createSelector(selectorChartGeoProjectionState, geoProjection => geoProjection?.scale ?? null);
+const selectorChartRotate = createSelectorMemoized(selectorChartGeoProjectionState, geoProjection => geoProjection?.rotate ?? null);
+const selectorChartTranslate = createSelectorMemoized(selectorChartGeoProjectionState, geoProjection => geoProjection?.translate ?? null);
+const selectorChartParallels = createSelectorMemoized(selectorChartGeoProjectionState, selectorChartRotate, (geoProjection, rotate) => geoProjection?.parallels ?? (rotate ? [rotate[1] - 15, rotate[1] + 15] : [30, 30]));
+/**
+ * Map a feature's `properties.name` to its index in `geoData.features`,
+ * for fast lookup by name when joining series rows to features.
+ *
+ * Features without a string `properties.name` are skipped; on duplicates,
+ * the first occurrence wins.
+ */
+export const selectorChartGeoFeatureIndexesByName = createSelectorMemoized(selectorChartRawGeoData, geoData => {
+  const map = new Map();
+  if (!geoData) {
+    return map;
+  }
+  geoData.features.forEach((feature, index) => {
+    const name = feature.properties?.name;
+    if (typeof name !== 'string') {
+      return;
+    }
+    if (map.has(name)) {
+      map.get(name).push(index);
+      return;
+    }
+    map.set(name, [index]);
+  });
+  return map;
+});
+
+/**
+ * Resolves the raw `projection` input into a ready-to-use `GeoProjection` instance
+ * fitted to the chart's drawing area.
+ *
+ * - String inputs (e.g. `'mercator'`) are mapped to the matching d3-geo factory.
+ * - `GeoProjection` instances are used as-is, then fitted.
+ * - Returns `null` when no projection is registered or the name is unknown.
+ */
+export const selectorChartProjection = createSelectorMemoized(selectorChartRawProjection, selectorChartRawGeoData, selectorChartParallels, selectorChartRotate, selectorChartTranslate, selectorChartRawScale, selectorChartDrawingArea, (projectionInput, geoData, parallels, rotate, translate, scale, drawingArea) => {
+  if (!projectionInput) {
+    return null;
+  }
+  let projection;
+  if (typeof projectionInput === 'string') {
+    const factory = PROJECTION_FACTORIES[projectionInput];
+    if (!factory) {
+      if (process.env.NODE_ENV !== 'production') {
+        console.error(`MUI X Charts: Unknown projection name '${projectionInput}'. ` + `Expected one of: ${Object.keys(PROJECTION_FACTORIES).join(', ')}.`);
+      }
+      return null;
+    }
+    projection = factory();
+    if (isConicProjection(projection)) {
+      projection.parallels(parallels);
+    }
+  } else {
+    projection = projectionInput;
+  }
+  if (geoData) {
+    if (isConicProjection(projection)) {
+      if (rotate) {
+        projection.rotate?.(rotate);
+      }
+      if (!scale) {
+        const [[x0, y0], [x1, y1]] = geoPath(projection).bounds(geoData);
+        const currentScale = projection.scale();
+        const fitScale = Math.min(currentScale * (drawingArea.width / (x1 - x0)), currentScale * (drawingArea.height / (y1 - y0)));
+        projection.scale(fitScale);
+      } else {
+        projection.scale(scale);
+      }
+      return projection;
+    }
+    if (rotate) {
+      projection.rotate?.(rotate);
+    }
+    if (scale) {
+      projection.scale(scale);
+      projection.clipExtent?.([[drawingArea.left, drawingArea.top], [drawingArea.left + drawingArea.width, drawingArea.top + drawingArea.height]]);
+    } else {
+      projection.fitExtent?.([[drawingArea.left, drawingArea.top], [drawingArea.left + drawingArea.width, drawingArea.top + drawingArea.height]], geoData);
+    }
+    projection.translate(translate ?? [drawingArea.left + drawingArea.width / 2, drawingArea.top + drawingArea.height / 2]);
+  }
+  return projection;
+});
+
+/**
+ * Resolves the raw `projection` input into a ready-to-use `GeoPath` instance
+ * fitted to the chart's drawing area.
+ */
+export const selectorChartGeoPath = createSelectorMemoized(selectorChartProjection, projection => {
+  if (!projection) {
+    return null;
+  }
+  return geoPath(projection);
+});

package/internals/plugins/useGeoProjection/useGeoProjection.types.d.mts

@@ -0,0 +1,55 @@
+import { type ChartPluginSignature } from '@mui/x-charts/internals';
+import { type GeoProjection, type ExtendedFeatureCollection } from '@mui/x-charts-vendor/d3-geo';
+export type D3NamedProjection = 'azimuthalEqualArea' | 'azimuthalEquidistant' | 'gnomonic' | 'orthographic' | 'stereographic' | 'conicConformal' | 'conicEqualArea' | 'conicEquidistant' | 'albers' | 'albersUsa' | 'equirectangular' | 'mercator' | 'transverseMercator' | 'equalEarth' | 'naturalEarth1';
+/**
+ * A d3-geo projection accepted by `useGeoProjection`.
+ *
+ * Either a built-in projection name (e.g. `'mercator'`, `'naturalEarth1'`)
+ * or a `GeoProjection` instance returned by a d3-geo factory.
+ */
+export type GeoProjectionInput = D3NamedProjection | GeoProjection;
+export interface UseGeoProjectionParameters {
+  /**
+   * The GeoJSON `FeatureCollection` whose features will be rendered on the map.
+   */
+  geoData?: ExtendedFeatureCollection;
+  /**
+   * The d3-geo projection used to map geographic coordinates to SVG coordinates.
+   * Accepts a d3-geo projection name (e.g. `'mercator'`, `'naturalEarth1'`)
+   * or a custom `GeoProjection` instance.
+   */
+  projection?: GeoProjectionInput;
+  /**
+   * The center of the projection, specified as a `[longitude, latitude]` pair in degrees.
+   */
+  translate?: [number, number];
+  /**
+   * The rotation of the projection, specified as a `[longitude, latitude]` pair in degrees.
+   */
+  rotate?: [number, number];
+  /**
+   * The scale of the projection.
+   * Id not provided the scale will default to fit the entire geoData in the drawing area.
+   */
+  scale?: number;
+}
+export type UseGeoProjectionDefaultizedParameters = UseGeoProjectionParameters;
+export interface UseGeoProjectionState {
+  geoProjection: {
+    geoData: ExtendedFeatureCollection | null;
+    projection: GeoProjectionInput | null;
+    translate: [number, number] | null;
+    rotate: [number, number] | null;
+    scale: number | null;
+    /**
+     * The two standard parallels used by conic projections, if applicable.
+     * Used for projection 'conicConformal', 'conicEqualArea', 'conicEquidistant'.
+     */
+    parallels?: [number, number] | null;
+  };
+}
+export type UseGeoProjectionSignature = ChartPluginSignature<{
+  params: UseGeoProjectionParameters;
+  defaultizedParams: UseGeoProjectionDefaultizedParameters;
+  state: UseGeoProjectionState;
+}>;

package/internals/plugins/useGeoProjection/useGeoProjection.types.d.ts

@@ -0,0 +1,55 @@
+import { type ChartPluginSignature } from '@mui/x-charts/internals';
+import { type GeoProjection, type ExtendedFeatureCollection } from '@mui/x-charts-vendor/d3-geo';
+export type D3NamedProjection = 'azimuthalEqualArea' | 'azimuthalEquidistant' | 'gnomonic' | 'orthographic' | 'stereographic' | 'conicConformal' | 'conicEqualArea' | 'conicEquidistant' | 'albers' | 'albersUsa' | 'equirectangular' | 'mercator' | 'transverseMercator' | 'equalEarth' | 'naturalEarth1';
+/**
+ * A d3-geo projection accepted by `useGeoProjection`.
+ *
+ * Either a built-in projection name (e.g. `'mercator'`, `'naturalEarth1'`)
+ * or a `GeoProjection` instance returned by a d3-geo factory.
+ */
+export type GeoProjectionInput = D3NamedProjection | GeoProjection;
+export interface UseGeoProjectionParameters {
+  /**
+   * The GeoJSON `FeatureCollection` whose features will be rendered on the map.
+   */
+  geoData?: ExtendedFeatureCollection;
+  /**
+   * The d3-geo projection used to map geographic coordinates to SVG coordinates.
+   * Accepts a d3-geo projection name (e.g. `'mercator'`, `'naturalEarth1'`)
+   * or a custom `GeoProjection` instance.
+   */
+  projection?: GeoProjectionInput;
+  /**
+   * The center of the projection, specified as a `[longitude, latitude]` pair in degrees.
+   */
+  translate?: [number, number];
+  /**
+   * The rotation of the projection, specified as a `[longitude, latitude]` pair in degrees.
+   */
+  rotate?: [number, number];
+  /**
+   * The scale of the projection.
+   * Id not provided the scale will default to fit the entire geoData in the drawing area.
+   */
+  scale?: number;
+}
+export type UseGeoProjectionDefaultizedParameters = UseGeoProjectionParameters;
+export interface UseGeoProjectionState {
+  geoProjection: {
+    geoData: ExtendedFeatureCollection | null;
+    projection: GeoProjectionInput | null;
+    translate: [number, number] | null;
+    rotate: [number, number] | null;
+    scale: number | null;
+    /**
+     * The two standard parallels used by conic projections, if applicable.
+     * Used for projection 'conicConformal', 'conicEqualArea', 'conicEquidistant'.
+     */
+    parallels?: [number, number] | null;
+  };
+}
+export type UseGeoProjectionSignature = ChartPluginSignature<{
+  params: UseGeoProjectionParameters;
+  defaultizedParams: UseGeoProjectionDefaultizedParameters;
+  state: UseGeoProjectionState;
+}>;

package/internals/plugins/useGeoProjection/useGeoProjection.types.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/internals/plugins/useGeoProjection/useGeoProjection.types.mjs

@@ -0,0 +1 @@
+export {};

package/models/chartsSlotsComponentsPropsPremium.d.mts

@@ -0,0 +1 @@
+export interface RadialLineHighlightPropsOverrides {}

package/models/chartsSlotsComponentsPropsPremium.d.ts

@@ -0,0 +1 @@
+export interface RadialLineHighlightPropsOverrides {}

package/models/chartsSlotsComponentsPropsPremium.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/models/chartsSlotsComponentsPropsPremium.mjs

@@ -0,0 +1 @@
+export {};

package/models/index.d.mts

@@ -1,2 +1,3 @@
 export * from '@mui/x-charts-pro/models';
-export * from "./seriesType/index.mjs";
+export * from "./seriesType/index.mjs";
+export * from "./chartsSlotsComponentsPropsPremium.mjs";

package/models/index.d.ts

@@ -1,2 +1,3 @@
 export * from '@mui/x-charts-pro/models';
-export * from "./seriesType/index.js";
+export * from "./seriesType/index.js";
+export * from "./chartsSlotsComponentsPropsPremium.js";

package/models/index.js

@@ -24,4 +24,15 @@ Object.keys(_seriesType).forEach(function (key) {
       return _seriesType[key];
     }
   });
+});
+var _chartsSlotsComponentsPropsPremium = require("./chartsSlotsComponentsPropsPremium");
+Object.keys(_chartsSlotsComponentsPropsPremium).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _chartsSlotsComponentsPropsPremium[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _chartsSlotsComponentsPropsPremium[key];
+    }
+  });
 });