@mui/x-charts-premium 9.2.0 → 9.4.0

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];
+    }
+  });
 });

package/models/index.mjs

@@ -2,4 +2,5 @@
 export * from '@mui/x-charts-pro/models';
 // End of re-export-block
 
-export * from "./seriesType/index.mjs";
+export * from "./seriesType/index.mjs";
+export * from "./chartsSlotsComponentsPropsPremium.mjs";

package/models/seriesType/index.d.mts

@@ -1,4 +1,5 @@
 export * from "./rangeBar.mjs";
 export * from "./ohlc.mjs";
 export * from "./radialLine.mjs";
-export * from "./radialBar.mjs";
+export * from "./radialBar.mjs";
+export * from "./mapShape.mjs";

package/models/seriesType/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./rangeBar.js";
 export * from "./ohlc.js";
 export * from "./radialLine.js";
-export * from "./radialBar.js";
+export * from "./radialBar.js";
+export * from "./mapShape.js";

package/models/seriesType/index.js

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

package/models/seriesType/index.mjs

@@ -1,4 +1,5 @@
 export * from "./rangeBar.mjs";
 export * from "./ohlc.mjs";
 export * from "./radialLine.mjs";
-export * from "./radialBar.mjs";
+export * from "./radialBar.mjs";
+export * from "./mapShape.mjs";

package/models/seriesType/mapShape.d.mts

@@ -0,0 +1,105 @@
+import type { CommonSeriesType, CommonDefaultizedProps, SeriesId, DatasetElementType } from '@mui/x-charts/internals';
+import type { DefaultizedProps } from '@mui/x-internals/types';
+/**
+ * A single entry of a `mapShape` series.
+ *
+ * The `name` is used to join the entry to a feature in the chart's `geoData`
+ * (matching `feature.properties.name`).
+ */
+export interface MapShapeValueType {
+  /**
+   * Identifies the GeoJSON feature this entry maps to, via `feature.properties.name`.
+   */
+  name: string;
+  /**
+   * Numeric value associated with the feature.
+   */
+  value?: number;
+  /**
+   * The value used to compute the color of the item through a color axis.
+   * Falls back to `value` when no `colorValue` is provided.
+   */
+  colorValue?: any;
+  /**
+   * Label used in legends and tooltips.
+   */
+  label?: string;
+  /**
+   * Color used for the item. Fallback on the series color if not defined.
+   */
+  color?: string;
+}
+export interface MapShapeSeriesType extends Omit<CommonSeriesType<MapShapeValueType, 'mapShape'>, 'valueFormatter'> {
+  type: 'mapShape';
+  /**
+   * The data points to render. Each entry is joined to a feature in `geoData`
+   * through its `name` property.
+   */
+  data?: ReadonlyArray<MapShapeValueType>;
+  /**
+   * The label to display on the tooltip or the legend. It can be a string or a function.
+   */
+  label?: string | ((location: 'tooltip' | 'legend') => string);
+  /**
+   * The id of the color axis used to compute the color of the shapes.
+   * It points to the id of an axis defined with the `zAxis` prop.
+   */
+  colorAxisId?: string;
+  /**
+   * A function to extract and transform the value from the `dataset` item.
+   * It receives the full dataset item and should return a map shape value.
+   * Can be used as an alternative to `datasetKeys`.
+   * @param {DatasetElementType<unknown>} item The full dataset item.
+   * @returns {MapShapeValueType} The transformed value.
+   */
+  valueGetter?: (item: DatasetElementType<unknown>) => MapShapeValueType;
+  /**
+   * The keys used to retrieve data from the dataset.
+   *
+   * When this prop is provided, `name` is required to match each entry with a
+   * GeoJSON feature. `label`, `value`, and `colorValue` are optional.
+   */
+  datasetKeys?: {
+    /**
+     * The key used to retrieve the feature name from the dataset.
+     */
+    name: string;
+    /**
+     * The key used to retrieve the item label from the dataset.
+     */
+    label?: string;
+    /**
+     * The key used to retrieve the item numeric value from the dataset.
+     */
+    value?: string;
+    /**
+     * The key used to retrieve the color value from the dataset.
+     */
+    colorValue?: string;
+  };
+  /**
+   * Formatter used to render values in tooltips or other data displays.
+   * @param {MapShapeValueType} value The data entry to format.
+   * @param {object} context The rendering context.
+   * @param {number} context.dataIndex The index of the data point in the series.
+   * @returns {string | null} The string to display, or `null` if the value should not be shown.
+   */
+  valueFormatter?: (value: MapShapeValueType, context: {
+    dataIndex: number;
+  }) => string | null;
+}
+/**
+ * Identifies a single item in a `mapShape` series.
+ */
+export type MapShapeItemIdentifier = {
+  type: 'mapShape';
+  seriesId: SeriesId;
+  dataIndex: number;
+};
+export type DefaultizedMapShapeValueType = MapShapeValueType & {
+  hidden: boolean;
+};
+export interface DefaultizedMapShapeSeriesType extends Omit<DefaultizedProps<MapShapeSeriesType, CommonDefaultizedProps | 'color'>, 'data'> {
+  hidden: boolean;
+  data: ReadonlyArray<DefaultizedMapShapeValueType>;
+}