@mui/x-charts 8.0.0-alpha.13 → 8.0.0-alpha.14

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

@@ -0,0 +1,26 @@
+import { selectorChartDrawingArea } from "../../corePlugins/useChartDimensions/index.js";
+import { selectorChartSeriesConfig, selectorChartSeriesProcessed } from "../../corePlugins/useChartSeries/index.js";
+import { createSelector } from "../../utils/selectors.js";
+import { computeAxisValue } from "./computeAxisValue.js";
+export const selectorChartPolarAxisState = state => state.polarAxis;
+export const selectorChartRawRotationAxis = createSelector(selectorChartPolarAxisState, axis => axis?.rotation);
+export const selectorChartRawRadiusAxis = createSelector(selectorChartPolarAxisState, axis => axis?.radius);
+
+/**
+ * The only interesting selectors that merge axis data and zoom if provided.
+ */
+
+export const selectorChartRotationAxis = createSelector([selectorChartRawRotationAxis, selectorChartDrawingArea, selectorChartSeriesProcessed, selectorChartSeriesConfig], (axis, drawingArea, formattedSeries, seriesConfig) => computeAxisValue({
+  drawingArea,
+  formattedSeries,
+  axis,
+  seriesConfig,
+  axisDirection: 'rotation'
+}));
+export const selectorChartRadiusAxis = createSelector([selectorChartRawRadiusAxis, selectorChartDrawingArea, selectorChartSeriesProcessed, selectorChartSeriesConfig], (axis, drawingArea, formattedSeries, seriesConfig) => computeAxisValue({
+  drawingArea,
+  formattedSeries,
+  axis,
+  seriesConfig,
+  axisDirection: 'radius'
+}));

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

@@ -0,0 +1,55 @@
+import { ChartPluginSignature } from "../../models/index.js";
+import { ChartSeriesType, DatasetType } from "../../../../models/seriesType/config.js";
+import { ScaleName, AxisId, AxisConfig, ChartsRotationAxisProps, ChartsRadiusAxisProps } from "../../../../models/axis.js";
+import { UseChartSeriesSignature } from "../../corePlugins/useChartSeries/index.js";
+import { DefaultizedAxisConfig } from "../useChartCartesianAxis/index.js";
+export type PolarAxisState = {
+  /**
+   * Mapping from rotation-axis key to scaling configuration.
+   */
+  rotationAxis: DefaultizedAxisConfig<ChartsRotationAxisProps>;
+  /**
+   * Mapping from radius-axis key to scaling configuration.
+   */
+  radiusAxis: DefaultizedAxisConfig<ChartsRadiusAxisProps>;
+  /**
+   * The rotation-axes IDs sorted by order they were provided.
+   */
+  rotationAxisIds: AxisId[];
+  /**
+   * The radius-axes IDs sorted by order they were provided.
+   */
+  radiusAxisIds: AxisId[];
+};
+export interface UseChartPolarAxisParameters {
+  /**
+   * The configuration of the rotation-axes.
+   * If not provided, a default axis config is used.
+   * An array of [[AxisConfig]] objects.
+   */
+  rotationAxis?: AxisConfig<ScaleName, any, ChartsRotationAxisProps>[];
+  /**
+   * The configuration of the radial-axes.
+   * If not provided, a default axis config is used.
+   * An array of [[AxisConfig]] objects.
+   */
+  radiusAxis?: AxisConfig<'linear', any, ChartsRadiusAxisProps>[];
+  /**
+   * An array of objects that can be used to populate series and axes data using their `dataKey` property.
+   */
+  dataset?: Readonly<DatasetType>;
+}
+export type UseChartPolarAxisDefaultizedParameters = UseChartPolarAxisParameters & {};
+export interface UseChartPolarAxisState {
+  polarAxis: {
+    rotation: AxisConfig<ScaleName, any, ChartsRotationAxisProps>[];
+    radius: AxisConfig<'linear', any, ChartsRadiusAxisProps>[];
+  };
+}
+export interface UseChartPolarAxisInstance {}
+export type UseChartPolarAxisSignature<SeriesType extends ChartSeriesType = ChartSeriesType> = ChartPluginSignature<{
+  params: UseChartPolarAxisParameters;
+  defaultizedParams: UseChartPolarAxisDefaultizedParameters;
+  state: UseChartPolarAxisState;
+  dependencies: [UseChartSeriesSignature<SeriesType>];
+}>;

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

@@ -0,0 +1,3 @@
+import type { ChartSeries, ChartSeriesType } from '../../../../models/seriesType/config';
+import type { AllSeriesType } from '../../../../models/seriesType';
+export type GetSeriesWithDefaultValues<T extends ChartSeriesType> = (series: AllSeriesType<T>, seriesIndex: number, colors: string[]) => ChartSeries<T>;

package/esm/internals/plugins/models/seriesConfig/getSeriesWithDefaultValues.types.js

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

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

@@ -1,6 +1,8 @@
 export * from "./colorProcessor.types.js";
-export * from "./extremumGetter.types.js";
+export * from "./cartesianExtremumGetter.types.js";
+export * from "./polarExtremumGetter.types.js";
 export * from "./seriesConfig.types.js";
 export * from "./seriesProcessor.types.js";
 export * from "./tooltipGetter.types.js";
-export * from "./legendGetter.types.js";
+export * from "./legendGetter.types.js";
+export * from "./getSeriesWithDefaultValues.types.js";

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

@@ -1,6 +1,8 @@
 export * from "./colorProcessor.types.js";
-export * from "./extremumGetter.types.js";
+export * from "./cartesianExtremumGetter.types.js";
+export * from "./polarExtremumGetter.types.js";
 export * from "./seriesConfig.types.js";
 export * from "./seriesProcessor.types.js";
 export * from "./tooltipGetter.types.js";
-export * from "./legendGetter.types.js";
+export * from "./legendGetter.types.js";
+export * from "./getSeriesWithDefaultValues.types.js";

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

@@ -0,0 +1,16 @@
+import type { PolarChartSeriesType, ChartSeriesDefaultized } from '../../../../models/seriesType/config';
+import type { AxisConfig } from '../../../../models/axis';
+import type { SeriesId } from '../../../../models/seriesType/common';
+type PolarExtremumGetterParams<TSeriesType extends PolarChartSeriesType> = {
+  series: Record<SeriesId, ChartSeriesDefaultized<TSeriesType>>;
+  axis: AxisConfig;
+  axisIndex: number;
+  isDefaultAxis: boolean;
+};
+export type PolarExtremumGetterResult = [number, number];
+export type PolarExtremumGetter<TSeriesType extends PolarChartSeriesType> = (params: PolarExtremumGetterParams<TSeriesType>) => PolarExtremumGetterResult;
+export type PolarExtremumFilter = (value: {
+  x: number | Date | string | null;
+  y: number | Date | string | null;
+}, dataIndex: number) => boolean;
+export {};

package/esm/internals/plugins/models/seriesConfig/polarExtremumGetter.types.js

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

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

@@ -1,16 +1,22 @@
 import type { SeriesProcessor } from './seriesProcessor.types';
-import type { CartesianChartSeriesType, ChartSeriesType } from '../../../../models/seriesType/config';
+import type { CartesianChartSeriesType, ChartSeriesType, PolarChartSeriesType } from '../../../../models/seriesType/config';
 import type { ColorProcessor } from './colorProcessor.types';
-import type { CartesianExtremumGetter } from './extremumGetter.types';
+import type { CartesianExtremumGetter } from './cartesianExtremumGetter.types';
 import type { LegendGetter } from './legendGetter.types';
 import type { TooltipGetter } from './tooltipGetter.types';
+import { PolarExtremumGetter } from "./polarExtremumGetter.types.js";
+import { GetSeriesWithDefaultValues } from "./getSeriesWithDefaultValues.types.js";
 export type ChartSeriesTypeConfig<TSeriesType extends ChartSeriesType> = {
   seriesProcessor: SeriesProcessor<TSeriesType>;
   colorProcessor: ColorProcessor<TSeriesType>;
   legendGetter: LegendGetter<TSeriesType>;
   tooltipGetter: TooltipGetter<TSeriesType>;
+  getSeriesWithDefaultValues: GetSeriesWithDefaultValues<TSeriesType>;
 } & (TSeriesType extends CartesianChartSeriesType ? {
   xExtremumGetter: CartesianExtremumGetter<TSeriesType>;
   yExtremumGetter: CartesianExtremumGetter<TSeriesType>;
+} : {}) & (TSeriesType extends PolarChartSeriesType ? {
+  rotationExtremumGetter: PolarExtremumGetter<TSeriesType>;
+  radiusExtremumGetter: PolarExtremumGetter<TSeriesType>;
 } : {});
 export type ChartSeriesConfig<TSeriesType extends ChartSeriesType> = { [Key in TSeriesType]: ChartSeriesTypeConfig<Key> };

package/esm/internals/stackSeries.d.ts

@@ -1,10 +1,8 @@
 import { Series } from '@mui/x-charts-vendor/d3-shape';
-import type { BarSeriesType, LineSeriesType } from '../models/seriesType';
 import type { StackOffsetType, StackOrderType } from '../models/stacking';
-import { SeriesId } from "../models/seriesType/common.js";
-type StackableSeries = Record<SeriesId, BarSeriesType> | Record<SeriesId, LineSeriesType>;
-type FormatterParams = {
-  series: StackableSeries;
+import { SeriesId, StackableSeriesType } from "../models/seriesType/common.js";
+type FormatterParams<T> = {
+  series: Record<SeriesId, T>;
   seriesOrder: SeriesId[];
   defaultStrategy?: {
     stackOrder?: StackOrderType;
@@ -23,5 +21,5 @@ export declare const StackOffset: { [key in StackOffsetType]: (series: Series<an
  * @param series the object of all bars series
  * @returns an array of groups, including the ids, the stacking order, and the stacking offset.
  */
-export declare const getStackingGroups: (params: FormatterParams) => StackingGroupsType;
+export declare const getStackingGroups: <T extends StackableSeriesType>(params: FormatterParams<T>) => StackingGroupsType;
 export {};

package/esm/models/axis.d.ts

@@ -280,7 +280,10 @@ export type AxisValueFormatterContext<S extends ScaleName = ScaleName> = {
    */
   scale: AxisScaleConfig[S]['scale'];
 };
-export type AxisConfig<S extends ScaleName = ScaleName, V = any, AxisProps extends ChartsAxisProps = ChartsXAxisProps | ChartsYAxisProps> = {
+/**
+ * Config that is shared between cartesian and polar axes.
+ */
+type CommonAxisConfig<S extends ScaleName = ScaleName, V = any> = {
   /**
    * Id used to identify the axis.
    */
@@ -318,31 +321,43 @@ export type AxisConfig<S extends ScaleName = ScaleName, V = any, AxisProps exten
    * If `true`, Reverse the axis scaleBand.
    */
   reverse?: boolean;
-  /**
-   * The offset of the axis in pixels. It can be used to move the axis from its default position.
-   * X-axis: A top axis will move up, and a bottom axis will move down.
-   * Y-axis: A left axis will move left, and a right axis will move right.
-   * @default 0
-   */
-  offset?: number;
   /**
    * Defines the axis scale domain based on the min/max values of series linked to it.
    * - 'nice': Rounds the domain at human friendly values.
-   * - 'strict': Set the domain to the min/max value provided. No extras space is added.
+   * - 'strict': Set the domain to the min/max value provided. No extra space is added.
    * - function: Receives the calculated extremums as parameters, and should return the axis domain.
    */
   domainLimit?: 'nice' | 'strict' | ((min: number, max: number) => {
     min: number;
     max: number;
   });
-} & Omit<Partial<AxisProps>, 'axisId'> & Partial<Omit<AxisScaleConfig[S], 'scale'>> & AxisSideConfig<AxisProps> & TickParams & AxisConfigExtension;
+};
+export type PolarAxisConfig<S extends ScaleName = ScaleName, V = any, AxisProps extends ChartsAxisProps = ChartsRotationAxisProps | ChartsRadiusAxisProps> = {
+  /**
+   * The offset of the axis in pixels. It can be used to move the axis from its default position.
+   * X-axis: A top axis will move up, and a bottom axis will move down.
+   * Y-axis: A left axis will move left, and a right axis will move right.
+   * @default 0
+   */
+  offset?: number;
+} & CommonAxisConfig<S, V> & Omit<Partial<AxisProps>, 'axisId'> & Partial<Omit<AxisScaleConfig[S], 'scale'>> & AxisConfigExtension;
+export type AxisConfig<S extends ScaleName = ScaleName, V = any, AxisProps extends ChartsAxisProps = ChartsXAxisProps | ChartsYAxisProps> = {
+  /**
+   * The offset of the axis in pixels. It can be used to move the axis from its default position.
+   * X-axis: A top axis will move up, and a bottom axis will move down.
+   * Y-axis: A left axis will move left, and a right axis will move right.
+   * @default 0
+   */
+  offset?: number;
+} & CommonAxisConfig<S, V> & Omit<Partial<AxisProps>, 'axisId'> & Partial<Omit<AxisScaleConfig[S], 'scale'>> & AxisSideConfig<AxisProps> & TickParams & AxisConfigExtension;
 export interface AxisConfigExtension {}
-export type AxisDefaultized<S extends ScaleName = ScaleName, V = any, AxisProps extends ChartsAxisProps = ChartsXAxisProps | ChartsYAxisProps> = MakeRequired<Omit<AxisConfig<S, V, AxisProps>, 'scaleType'>, 'offset'> & AxisScaleConfig[S] & AxisSideConfig<AxisProps> & AxisScaleComputedConfig[S] & {
+export type PolarAxisDefaultized<S extends ScaleName = ScaleName, V = any, AxisProps extends ChartsAxisProps = ChartsRotationAxisProps | ChartsRadiusAxisProps> = Omit<PolarAxisConfig<S, V, AxisProps>, 'scaleType'> & AxisScaleConfig[S] & AxisScaleComputedConfig[S];
+export type AxisDefaultized<S extends ScaleName = ScaleName, V = any, AxisProps extends ChartsAxisProps = ChartsXAxisProps | ChartsYAxisProps> = MakeRequired<Omit<AxisConfig<S, V, AxisProps>, 'scaleType'>, 'offset'> & AxisScaleConfig[S] & AxisScaleComputedConfig[S] & {
   /**
    * An indication of the expected number of ticks.
    */
   tickNumber: number;
-};
+} & (AxisProps extends ChartsXAxisProps ? MakeRequired<AxisSideConfig<AxisProps>, 'height'> : AxisProps extends ChartsYAxisProps ? MakeRequired<AxisSideConfig<AxisProps>, 'width'> : AxisSideConfig<AxisProps>);
 export declare function isBandScaleConfig(scaleConfig: AxisConfig<ScaleName>): scaleConfig is AxisConfig<'band'> & {
   scaleType: 'band';
 };

package/esm/models/axis.js

@@ -3,6 +3,10 @@
  * shouldn't be provided by the user.
  */
 
+/**
+ * Config that is shared between cartesian and polar axes.
+ */
+
 export function isBandScaleConfig(scaleConfig) {
   return scaleConfig.scaleType === 'band';
 }

package/esm/models/seriesType/config.d.ts

@@ -3,6 +3,7 @@ import { ScatterSeriesType, DefaultizedScatterSeriesType, ScatterItemIdentifier,
 import { LineSeriesType, DefaultizedLineSeriesType, LineItemIdentifier } from "./line.js";
 import { BarItemIdentifier, BarSeriesType, DefaultizedBarSeriesType } from "./bar.js";
 import { PieSeriesType, DefaultizedPieSeriesType, PieItemIdentifier, PieValueType, DefaultizedPieValueType } from "./pie.js";
+import { DefaultizedRadarSeriesType, RadarItemIdentifier, RadarSeriesType } from "./radar.js";
 export interface ChartsSeriesConfig {
   bar: {
     /**
@@ -22,7 +23,7 @@ export interface ChartsSeriesConfig {
     itemIdentifier: BarItemIdentifier;
     valueType: number | null;
     canBeStacked: true;
-    cartesian: true;
+    axisType: 'cartesian';
   };
   line: {
     seriesInput: DefaultizedProps<LineSeriesType, 'id'> & {
@@ -33,7 +34,7 @@ export interface ChartsSeriesConfig {
     itemIdentifier: LineItemIdentifier;
     valueType: number | null;
     canBeStacked: true;
-    cartesian: true;
+    axisType: 'cartesian';
   };
   scatter: {
     seriesInput: DefaultizedProps<ScatterSeriesType, 'id'> & {
@@ -43,7 +44,7 @@ export interface ChartsSeriesConfig {
     seriesProp: ScatterSeriesType;
     valueType: ScatterValueType;
     itemIdentifier: ScatterItemIdentifier;
-    cartesian: true;
+    axisType: 'cartesian';
   };
   pie: {
     seriesInput: Omit<DefaultizedProps<PieSeriesType, 'id'>, 'data'> & {
@@ -56,19 +57,28 @@ export interface ChartsSeriesConfig {
     itemIdentifier: PieItemIdentifier;
     valueType: DefaultizedPieValueType;
   };
+  radar: {
+    seriesInput: DefaultizedProps<RadarSeriesType, 'id'> & {
+      color: string;
+    };
+    series: DefaultizedRadarSeriesType;
+    seriesProp: RadarSeriesType;
+    itemIdentifier: RadarItemIdentifier;
+    valueType: number;
+    axisType: 'polar';
+  };
 }
 export type ChartSeriesType = keyof ChartsSeriesConfig;
 export type CartesianChartSeriesType = keyof Pick<ChartsSeriesConfig, { [Key in ChartSeriesType]: ChartsSeriesConfig[Key] extends {
-  cartesian: true;
+  axisType: 'cartesian';
+} ? Key : never }[ChartSeriesType]>;
+export type PolarChartSeriesType = keyof Pick<ChartsSeriesConfig, { [Key in ChartSeriesType]: ChartsSeriesConfig[Key] extends {
+  axisType: 'polar';
 } ? Key : never }[ChartSeriesType]>;
 export type StackableChartSeriesType = keyof Pick<ChartsSeriesConfig, { [Key in ChartSeriesType]: ChartsSeriesConfig[Key] extends {
   canBeStacked: true;
 } ? Key : never }[ChartSeriesType]>;
-export type ChartSeries<T extends ChartSeriesType> = ChartsSeriesConfig[T] extends {
-  canBeStacked: true;
-} ? ChartsSeriesConfig[T]['seriesInput'] & {
-  stackedData: [number, number][];
-} : ChartsSeriesConfig[T]['seriesInput'];
+export type ChartSeries<T extends ChartSeriesType> = ChartsSeriesConfig[T]['seriesInput'];
 export type ChartSeriesDefaultized<T extends ChartSeriesType> = ChartsSeriesConfig[T] extends {
   canBeStacked: true;
 } ? ChartsSeriesConfig[T]['series'] & {

package/esm/models/seriesType/index.d.ts

@@ -10,6 +10,7 @@ export * from "./line.js";
 export * from "./bar.js";
 export * from "./scatter.js";
 export * from "./pie.js";
+export * from "./radar.js";
 export type { AllSeriesType, CartesianSeriesType, DefaultizedSeriesType, DefaultizedCartesianSeriesType, StackableSeriesType };
 export declare function isDefaultizedBarSeries(series: DefaultizedSeriesType): series is DefaultizedBarSeriesType;
 export declare function isBarSeries(series: AllSeriesType): series is BarSeriesType;

package/esm/models/seriesType/index.js

@@ -6,6 +6,7 @@ export * from "./line.js";
 export * from "./bar.js";
 export * from "./scatter.js";
 export * from "./pie.js";
+export * from "./radar.js";
 // Helpers
 
 export function isDefaultizedBarSeries(series) {

package/esm/models/seriesType/radar.d.ts

@@ -0,0 +1,24 @@
+import { DefaultizedProps } from '@mui/x-internals/types';
+import { CommonDefaultizedProps, CommonSeriesType, SeriesId } from "./common.js";
+export interface RadarSeriesType extends CommonSeriesType<number> {
+  type: 'radar';
+  data: number[];
+  /**
+   * The label to display on the tooltip or the legend. It can be a string or a function.
+   */
+  label?: string | ((location: 'tooltip' | 'legend') => string);
+  /**
+   * If `true` show marks at value position.
+   */
+  showMark?: boolean;
+}
+/**
+ * An object that allows to identify either a radar series or a radar point (if dataIndex is defined).
+ * Used for item interaction
+ */
+export type RadarItemIdentifier = {
+  type: 'radar';
+  seriesId: SeriesId;
+  dataIndex?: number;
+};
+export interface DefaultizedRadarSeriesType extends DefaultizedProps<RadarSeriesType, CommonDefaultizedProps | 'color'> {}

package/esm/models/seriesType/radar.js

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

package/hooks/useAxis.d.ts

@@ -38,4 +38,14 @@ export declare function useXAxis(axisId?: AxisId): import("../internals").AxisDe
  * @param {AxisId | undefined} axisId - If provided returns the y axis with axisId, else returns the values for the default y axis.
  * @returns The Y axis.
  */
-export declare function useYAxis(axisId?: AxisId): import("../internals").AxisDefaultized<keyof import("../internals").AxisScaleConfig, any, import("..").ChartsYAxisProps>;
+export declare function useYAxis(axisId?: AxisId): import("../internals").AxisDefaultized<keyof import("../internals").AxisScaleConfig, any, import("..").ChartsYAxisProps>;
+export declare function useRotationAxes(): {
+  rotationAxis: import("../internals/plugins/featurePlugins/useChartPolarAxis/computeAxisValue").DefaultizedAxisConfig<import("../internals").ChartsAxisProps>;
+  rotationAxisIds: string[];
+};
+export declare function useRadiusAxes(): {
+  radiusAxis: import("../internals/plugins/featurePlugins/useChartPolarAxis/computeAxisValue").DefaultizedAxisConfig<import("..").ChartsYAxisProps>;
+  radiusAxisIds: string[];
+};
+export declare function useRotationAxis(identifier?: number | string): import("../internals").PolarAxisDefaultized<keyof import("../internals").AxisScaleConfig, any, import("../internals").ChartsAxisProps>;
+export declare function useRadiusAxis(identifier?: number | string): import("../internals").PolarAxisDefaultized<keyof import("../internals").AxisScaleConfig, any, import("..").ChartsYAxisProps>;

package/hooks/useAxis.js

@@ -4,11 +4,16 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+exports.useRadiusAxes = useRadiusAxes;
+exports.useRadiusAxis = useRadiusAxis;
+exports.useRotationAxes = useRotationAxes;
+exports.useRotationAxis = useRotationAxis;
 exports.useXAxes = useXAxes;
 exports.useXAxis = useXAxis;
 exports.useYAxes = useYAxes;
 exports.useYAxis = useYAxis;
 var _useChartCartesianAxisRendering = require("../internals/plugins/featurePlugins/useChartCartesianAxis/useChartCartesianAxisRendering.selectors");
+var _useChartPolarAxis = require("../internals/plugins/featurePlugins/useChartPolarAxis");
 var _useSelector = require("../internals/store/useSelector");
 var _useStore = require("../internals/store/useStore");
 /**
@@ -83,4 +88,44 @@ function useYAxis(axisId) {
   } = (0, _useSelector.useSelector)(store, _useChartCartesianAxisRendering.selectorChartYAxis);
   const id = axisId ?? yAxisIds[0];
   return yAxis[id];
+}
+function useRotationAxes() {
+  const store = (0, _useStore.useStore)();
+  const {
+    axis: rotationAxis,
+    axisIds: rotationAxisIds
+  } = (0, _useSelector.useSelector)(store, _useChartPolarAxis.selectorChartRotationAxis);
+  return {
+    rotationAxis,
+    rotationAxisIds
+  };
+}
+function useRadiusAxes() {
+  const store = (0, _useStore.useStore)();
+  const {
+    axis: radiusAxis,
+    axisIds: radiusAxisIds
+  } = (0, _useSelector.useSelector)(store, _useChartPolarAxis.selectorChartRadiusAxis);
+  return {
+    radiusAxis,
+    radiusAxisIds
+  };
+}
+function useRotationAxis(identifier) {
+  const store = (0, _useStore.useStore)();
+  const {
+    axis: rotationAxis,
+    axisIds: rotationAxisIds
+  } = (0, _useSelector.useSelector)(store, _useChartPolarAxis.selectorChartRotationAxis);
+  const id = typeof identifier === 'string' ? identifier : rotationAxisIds[identifier ?? 0];
+  return rotationAxis[id];
+}
+function useRadiusAxis(identifier) {
+  const store = (0, _useStore.useStore)();
+  const {
+    axis: radiusAxis,
+    axisIds: radiusAxisIds
+  } = (0, _useSelector.useSelector)(store, _useChartPolarAxis.selectorChartRadiusAxis);
+  const id = typeof identifier === 'string' ? identifier : radiusAxisIds[identifier ?? 0];
+  return radiusAxis[id];
 }

package/hooks/useRadarSeries.d.ts

@@ -0,0 +1,35 @@
+import { ProcessedSeries } from "../internals/plugins/corePlugins/useChartSeries/useChartSeries.types.js";
+import { SeriesId } from "../models/seriesType/common.js";
+import { ChartSeriesDefaultized } from "../models/seriesType/config.js";
+export type UseRadarSeriesReturnValue = ChartSeriesDefaultized<'radar'>;
+export type UseRadarSeriesContextReturnValue = ProcessedSeries['radar'];
+/**
+ * Get access to the internal state of radar series.
+ *
+ * @param {SeriesId} seriesId The id of the series to get.
+ * @returns {UseRadarSeriesReturnValue} the radar series
+ */
+export declare function useRadarSeries(seriesId: SeriesId): UseRadarSeriesReturnValue | undefined;
+/**
+ * Get access to the internal state of radar series.
+ *
+ * When called without arguments, it returns all radar series.
+ *
+ * @returns {UseRadarSeriesReturnValue[]} the radar series
+ */
+export declare function useRadarSeries(): UseRadarSeriesReturnValue[];
+/**
+ * Get access to the internal state of radar series.
+ *
+ * @param {SeriesId[]} seriesIds The ids of the series to get. Order is preserved.
+ * @returns {UseRadarSeriesReturnValue[]} the radar series
+ */
+export declare function useRadarSeries(seriesIds?: SeriesId[]): UseRadarSeriesReturnValue[];
+/**
+ * Get access to the internal state of radar series.
+ * The returned object contains:
+ * - series: a mapping from ids to series attributes.
+ * - seriesOrder: the array of series ids.
+ * @returns the radar series
+ */
+export declare function useRadarSeriesContext(): UseRadarSeriesContextReturnValue;

package/hooks/useRadarSeries.js

@@ -0,0 +1,48 @@
+"use strict";
+'use client';
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useRadarSeries = useRadarSeries;
+exports.useRadarSeriesContext = useRadarSeriesContext;
+var _createSeriesSelectorOfType = require("../internals/createSeriesSelectorOfType");
+const useSelectorSeries = (0, _createSeriesSelectorOfType.createSeriesSelectorsOfType)('radar');
+const useSelectorSeriesContext = (0, _createSeriesSelectorOfType.createAllSeriesSelectorOfType)('radar');
+
+/**
+ * Get access to the internal state of radar series.
+ *
+ * @param {SeriesId} seriesId The id of the series to get.
+ * @returns {UseRadarSeriesReturnValue} the radar series
+ */
+
+/**
+ * Get access to the internal state of radar series.
+ *
+ * When called without arguments, it returns all radar series.
+ *
+ * @returns {UseRadarSeriesReturnValue[]} the radar series
+ */
+
+/**
+ * Get access to the internal state of radar series.
+ *
+ * @param {SeriesId[]} seriesIds The ids of the series to get. Order is preserved.
+ * @returns {UseRadarSeriesReturnValue[]} the radar series
+ */
+
+function useRadarSeries(seriesIds) {
+  return useSelectorSeries(seriesIds);
+}
+
+/**
+ * Get access to the internal state of radar series.
+ * The returned object contains:
+ * - series: a mapping from ids to series attributes.
+ * - seriesOrder: the array of series ids.
+ * @returns the radar series
+ */
+function useRadarSeriesContext() {
+  return useSelectorSeriesContext();
+}

package/hooks/useScale.d.ts

@@ -19,4 +19,6 @@ export declare function useXScale<S extends ScaleName>(axisId?: AxisId): AxisSca
  * @param {AxisId | undefined} axisId - If provided returns the scale for the y axis with axisId, else returns the values for the default y axis.
  * @returns {AxisScaleConfig[S]['scale']} The scale for the specified Y axis.
  */
-export declare function useYScale<S extends ScaleName>(axisId?: AxisId): AxisScaleConfig[S]['scale'];
+export declare function useYScale<S extends ScaleName>(axisId?: AxisId): AxisScaleConfig[S]['scale'];
+export declare function useRotationScale<S extends ScaleName>(identifier?: number | string): AxisScaleConfig[S]['scale'];
+export declare function useRadiusScale<S extends ScaleName>(identifier?: number | string): AxisScaleConfig[S]['scale'];

package/hooks/useScale.js

@@ -5,6 +5,8 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.getValueToPositionMapper = getValueToPositionMapper;
+exports.useRadiusScale = useRadiusScale;
+exports.useRotationScale = useRotationScale;
 exports.useXScale = useXScale;
 exports.useYScale = useYScale;
 var _isBandScale = require("../internals/isBandScale");
@@ -42,4 +44,12 @@ function useXScale(axisId) {
 function useYScale(axisId) {
   const axis = (0, _useAxis.useYAxis)(axisId);
   return axis.scale;
+}
+function useRotationScale(identifier) {
+  const axis = (0, _useAxis.useRotationAxis)(identifier);
+  return axis.scale;
+}
+function useRadiusScale(identifier) {
+  const axis = (0, _useAxis.useRadiusAxis)(identifier);
+  return axis.scale;
 }

package/hooks/useTicks.js

@@ -36,12 +36,13 @@ function useTicks(options) {
     valueFormatter,
     tickInterval,
     tickPlacement = 'extremities',
-    tickLabelPlacement = 'middle'
+    tickLabelPlacement: tickLabelPlacementProp
   } = options;
   return React.useMemo(() => {
     // band scale
     if ((0, _isBandScale.isBandScale)(scale)) {
       const domain = scale.domain();
+      const tickLabelPlacement = tickLabelPlacementProp ?? 'middle';
       if (scale.bandwidth() > 0) {
         // scale type = 'band'
         const filteredDomain = typeof tickInterval === 'function' && domain.filter(tickInterval) || typeof tickInterval === 'object' && tickInterval || domain;
@@ -78,15 +79,20 @@ function useTicks(options) {
     if (domain.some(_isInfinity.isInfinity)) {
       return [];
     }
+    const tickLabelPlacement = tickLabelPlacementProp;
     const ticks = typeof tickInterval === 'object' ? tickInterval : scale.ticks(tickNumber);
-    return ticks.map(value => ({
-      value,
-      formattedValue: valueFormatter?.(value, {
-        location: 'tick',
-        scale
-      }) ?? scale.tickFormat(tickNumber)(value),
-      offset: scale(value),
-      labelOffset: 0
-    }));
-  }, [scale, tickInterval, tickNumber, valueFormatter, tickPlacement, tickLabelPlacement]);
+    return ticks.map((value, i) => {
+      return {
+        value,
+        formattedValue: valueFormatter?.(value, {
+          location: 'tick',
+          scale
+        }) ?? scale.tickFormat(tickNumber)(value),
+        offset: scale(value),
+        // Allowing the label to be placed in the middle of a continuous scale is weird.
+        // But it is useful in some cases, like funnel categories with a linear scale.
+        labelOffset: tickLabelPlacement === 'middle' ? scale(ticks[i - 1] ?? 0) - (scale(value) + scale(ticks[i - 1] ?? 0)) / 2 : 0
+      };
+    });
+  }, [scale, tickInterval, tickNumber, valueFormatter, tickPlacement, tickLabelPlacementProp]);
 }

package/index.d.ts

@@ -20,6 +20,7 @@ export * from "./PieChart/index.js";
 export * from "./ScatterChart/index.js";
 export * from "./SparkLineChart/index.js";
 export * from "./Gauge/index.js";
+export * from "./RadarChart/index.js";
 export * from "./ChartsSurface/index.js";
 export * from "./ChartContainer/index.js";
 export * from "./ChartDataProvider/index.js";