@mui/x-charts 9.6.0 → 9.8.0

package/colorPalettes/sequential/green.d.mts

@@ -1,4 +1,4 @@
-import { type ChartsColorPaletteCallback } from "../types.mjs";
+import type { ChartsColorPaletteCallback } from "../types.mjs";
 export declare const greenPaletteLight: string[];
 export declare const greenPaletteDark: string[];
 export declare const greenPalette: ChartsColorPaletteCallback;

package/colorPalettes/sequential/green.d.ts

@@ -1,4 +1,4 @@
-import { type ChartsColorPaletteCallback } from "../types.js";
+import type { ChartsColorPaletteCallback } from "../types.js";
 export declare const greenPaletteLight: string[];
 export declare const greenPaletteDark: string[];
 export declare const greenPalette: ChartsColorPaletteCallback;

package/colorPalettes/sequential/orange.d.mts

@@ -1,4 +1,4 @@
-import { type ChartsColorPaletteCallback } from "../types.mjs";
+import type { ChartsColorPaletteCallback } from "../types.mjs";
 export declare const orangePaletteLight: string[];
 export declare const orangePaletteDark: string[];
 export declare const orangePalette: ChartsColorPaletteCallback;

package/colorPalettes/sequential/orange.d.ts

@@ -1,4 +1,4 @@
-import { type ChartsColorPaletteCallback } from "../types.js";
+import type { ChartsColorPaletteCallback } from "../types.js";
 export declare const orangePaletteLight: string[];
 export declare const orangePaletteDark: string[];
 export declare const orangePalette: ChartsColorPaletteCallback;

package/colorPalettes/sequential/pink.d.mts

@@ -1,4 +1,4 @@
-import { type ChartsColorPaletteCallback } from "../types.mjs";
+import type { ChartsColorPaletteCallback } from "../types.mjs";
 export declare const pinkPaletteLight: string[];
 export declare const pinkPaletteDark: string[];
 export declare const pinkPalette: ChartsColorPaletteCallback;

package/colorPalettes/sequential/pink.d.ts

@@ -1,4 +1,4 @@
-import { type ChartsColorPaletteCallback } from "../types.js";
+import type { ChartsColorPaletteCallback } from "../types.js";
 export declare const pinkPaletteLight: string[];
 export declare const pinkPaletteDark: string[];
 export declare const pinkPalette: ChartsColorPaletteCallback;

package/colorPalettes/sequential/purple.d.mts

@@ -1,4 +1,4 @@
-import { type ChartsColorPaletteCallback } from "../types.mjs";
+import type { ChartsColorPaletteCallback } from "../types.mjs";
 export declare const purplePaletteLight: string[];
 export declare const purplePaletteDark: string[];
 export declare const purplePalette: ChartsColorPaletteCallback;

package/colorPalettes/sequential/purple.d.ts

@@ -1,4 +1,4 @@
-import { type ChartsColorPaletteCallback } from "../types.js";
+import type { ChartsColorPaletteCallback } from "../types.js";
 export declare const purplePaletteLight: string[];
 export declare const purplePaletteDark: string[];
 export declare const purplePalette: ChartsColorPaletteCallback;

package/colorPalettes/sequential/red.d.mts

@@ -1,4 +1,4 @@
-import { type ChartsColorPaletteCallback } from "../types.mjs";
+import type { ChartsColorPaletteCallback } from "../types.mjs";
 export declare const redPaletteLight: string[];
 export declare const redPaletteDark: string[];
 export declare const redPalette: ChartsColorPaletteCallback;

package/colorPalettes/sequential/red.d.ts

@@ -1,4 +1,4 @@
-import { type ChartsColorPaletteCallback } from "../types.js";
+import type { ChartsColorPaletteCallback } from "../types.js";
 export declare const redPaletteLight: string[];
 export declare const redPaletteDark: string[];
 export declare const redPalette: ChartsColorPaletteCallback;

package/colorPalettes/sequential/strawberrySky.d.mts

@@ -1,4 +1,4 @@
-import { type ChartsColorPaletteCallback } from "../types.mjs";
+import type { ChartsColorPaletteCallback } from "../types.mjs";
 export declare const strawberrySkyPaletteLight: string[];
 export declare const strawberrySkyPaletteDark: string[];
 export declare const strawberrySkyPalette: ChartsColorPaletteCallback;

package/colorPalettes/sequential/strawberrySky.d.ts

@@ -1,4 +1,4 @@
-import { type ChartsColorPaletteCallback } from "../types.js";
+import type { ChartsColorPaletteCallback } from "../types.js";
 export declare const strawberrySkyPaletteLight: string[];
 export declare const strawberrySkyPaletteDark: string[];
 export declare const strawberrySkyPalette: ChartsColorPaletteCallback;

package/colorPalettes/sequential/yellow.d.mts

@@ -1,4 +1,4 @@
-import { type ChartsColorPaletteCallback } from "../types.mjs";
+import type { ChartsColorPaletteCallback } from "../types.mjs";
 export declare const yellowPaletteLight: string[];
 export declare const yellowPaletteDark: string[];
 export declare const yellowPalette: ChartsColorPaletteCallback;

package/colorPalettes/sequential/yellow.d.ts

@@ -1,4 +1,4 @@
-import { type ChartsColorPaletteCallback } from "../types.js";
+import type { ChartsColorPaletteCallback } from "../types.js";
 export declare const yellowPaletteLight: string[];
 export declare const yellowPaletteDark: string[];
 export declare const yellowPalette: ChartsColorPaletteCallback;

package/context/ChartsProvider/ChartsProvider.d.mts

@@ -1,6 +1,6 @@
 import * as React from 'react';
 import type { ChartsProviderProps } from "./ChartsProvider.types.mjs";
-import { type ChartAnyPluginSignature } from "../../internals/plugins/models/index.mjs";
+import type { ChartAnyPluginSignature } from "../../internals/plugins/models/index.mjs";
 import type { ChartSeriesType } from "../../models/seriesType/config.mjs";
 import type { ChartCorePluginSignatures } from "../../internals/plugins/corePlugins/index.mjs";
 declare function ChartsProvider<SeriesType extends ChartSeriesType, TSignatures extends readonly ChartAnyPluginSignature[] = ChartCorePluginSignatures<SeriesType>>(props: React.PropsWithChildren<ChartsProviderProps<SeriesType, TSignatures>>): import("react/jsx-runtime").JSX.Element;

package/context/ChartsProvider/ChartsProvider.d.ts

@@ -1,6 +1,6 @@
 import * as React from 'react';
 import type { ChartsProviderProps } from "./ChartsProvider.types.js";
-import { type ChartAnyPluginSignature } from "../../internals/plugins/models/index.js";
+import type { ChartAnyPluginSignature } from "../../internals/plugins/models/index.js";
 import type { ChartSeriesType } from "../../models/seriesType/config.js";
 import type { ChartCorePluginSignatures } from "../../internals/plugins/corePlugins/index.js";
 declare function ChartsProvider<SeriesType extends ChartSeriesType, TSignatures extends readonly ChartAnyPluginSignature[] = ChartCorePluginSignatures<SeriesType>>(props: React.PropsWithChildren<ChartsProviderProps<SeriesType, TSignatures>>): import("react/jsx-runtime").JSX.Element;

package/context/ChartsProvider/ChartsProvider.types.d.mts

@@ -1,4 +1,4 @@
-import { type Store } from '@mui/x-internals/store';
+import type { Store } from '@mui/x-internals/store';
 import type { ChartAnyPluginSignature, ChartInstance, ChartPublicAPI, ChartState, ConvertSignaturesIntoPlugins, MergeSignaturesProperty } from "../../internals/plugins/models/index.mjs";
 import type { ChartCorePluginSignatures } from "../../internals/plugins/corePlugins/index.mjs";
 import type { UseChartBaseProps } from "../../internals/store/useCharts.types.mjs";

package/context/ChartsProvider/ChartsProvider.types.d.ts

@@ -1,4 +1,4 @@
-import { type Store } from '@mui/x-internals/store';
+import type { Store } from '@mui/x-internals/store';
 import type { ChartAnyPluginSignature, ChartInstance, ChartPublicAPI, ChartState, ConvertSignaturesIntoPlugins, MergeSignaturesProperty } from "../../internals/plugins/models/index.js";
 import type { ChartCorePluginSignatures } from "../../internals/plugins/corePlugins/index.js";
 import type { UseChartBaseProps } from "../../internals/store/useCharts.types.js";

package/context/ChartsProvider/useChartsContext.d.mts

@@ -1,3 +1,3 @@
-import { type ChartAnyPluginSignature } from "../../internals/plugins/models/index.mjs";
-import { type ChartsContextValue } from "./ChartsProvider.types.mjs";
+import type { ChartAnyPluginSignature } from "../../internals/plugins/models/index.mjs";
+import type { ChartsContextValue } from "./ChartsProvider.types.mjs";
 export declare const useChartsContext: <TSignatures extends readonly ChartAnyPluginSignature[], TOptionalSignatures extends readonly ChartAnyPluginSignature[] = []>() => ChartsContextValue<TSignatures, TOptionalSignatures>;

package/context/ChartsProvider/useChartsContext.d.ts

@@ -1,3 +1,3 @@
-import { type ChartAnyPluginSignature } from "../../internals/plugins/models/index.js";
-import { type ChartsContextValue } from "./ChartsProvider.types.js";
+import type { ChartAnyPluginSignature } from "../../internals/plugins/models/index.js";
+import type { ChartsContextValue } from "./ChartsProvider.types.js";
 export declare const useChartsContext: <TSignatures extends readonly ChartAnyPluginSignature[], TOptionalSignatures extends readonly ChartAnyPluginSignature[] = []>() => ChartsContextValue<TSignatures, TOptionalSignatures>;

package/context/ChartsSlotsContext.d.mts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { type ChartsSlotProps, type ChartsSlots } from "../internals/material/index.mjs";
+import type { ChartsSlotProps, ChartsSlots } from "../internals/material/index.mjs";
 type SlotProps<T extends Record<keyof T, React.ComponentType<any>>> = { [key in keyof T]: React.ComponentProps<T[key]> };
 export interface ChartsSlotsContextValue<T extends ChartsSlots & Record<keyof T, React.ComponentType<any>> = ChartsSlots> {
   slots: T;

package/context/ChartsSlotsContext.d.ts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { type ChartsSlotProps, type ChartsSlots } from "../internals/material/index.js";
+import type { ChartsSlotProps, ChartsSlots } from "../internals/material/index.js";
 type SlotProps<T extends Record<keyof T, React.ComponentType<any>>> = { [key in keyof T]: React.ComponentProps<T[key]> };
 export interface ChartsSlotsContextValue<T extends ChartsSlots & Record<keyof T, React.ComponentType<any>> = ChartsSlots> {
   slots: T;

package/context/useChartApiContext.d.mts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { type ChartApi } from "./ChartApi.mjs";
+import type { ChartApi } from "./ChartApi.mjs";
 /**
  * The `useChartApiContext` hook provides access to the chart API.
  * This is only available when the chart is rendered within a chart or a `ChartsDataProvider` component.

package/context/useChartApiContext.d.ts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { type ChartApi } from "./ChartApi.js";
+import type { ChartApi } from "./ChartApi.js";
 /**
  * The `useChartApiContext` hook provides access to the chart API.
  * This is only available when the chart is rendered within a chart or a `ChartsDataProvider` component.

package/hooks/index.d.mts

@@ -24,4 +24,5 @@ export * from "./useFocusedItem.mjs";
 export { useXAxisCoordinates, useYAxisCoordinates, type AxisCoordinates } from "./useAxisCoordinates.mjs";
 export * from "./useAxisTicks.mjs";
 export { type TickItem } from "./useTicks.mjs";
-export * from "./getValueToPositionMapper.mjs";
+export * from "./getValueToPositionMapper.mjs";
+export { usePolarGeometry } from "./usePolarGeometry.mjs";

package/hooks/index.d.ts

@@ -24,4 +24,5 @@ export * from "./useFocusedItem.js";
 export { useXAxisCoordinates, useYAxisCoordinates, type AxisCoordinates } from "./useAxisCoordinates.js";
 export * from "./useAxisTicks.js";
 export { type TickItem } from "./useTicks.js";
-export * from "./getValueToPositionMapper.js";
+export * from "./getValueToPositionMapper.js";
+export { usePolarGeometry } from "./usePolarGeometry.js";

package/hooks/index.js

@@ -9,7 +9,8 @@ var _exportNames = {
   useChartGradientId: true,
   useChartGradientIdObjectBound: true,
   useXAxisCoordinates: true,
-  useYAxisCoordinates: true
+  useYAxisCoordinates: true,
+  usePolarGeometry: true
 };
 Object.defineProperty(exports, "useChartGradientId", {
   enumerable: true,
@@ -35,6 +36,12 @@ Object.defineProperty(exports, "usePieSeriesContext", {
     return _usePieSeries.usePieSeriesContext;
   }
 });
+Object.defineProperty(exports, "usePolarGeometry", {
+  enumerable: true,
+  get: function () {
+    return _usePolarGeometry.usePolarGeometry;
+  }
+});
 Object.defineProperty(exports, "useXAxisCoordinates", {
   enumerable: true,
   get: function () {
@@ -325,4 +332,5 @@ Object.keys(_getValueToPositionMapper).forEach(function (key) {
       return _getValueToPositionMapper[key];
     }
   });
-});
+});
+var _usePolarGeometry = require("./usePolarGeometry");

package/hooks/index.mjs

@@ -23,4 +23,5 @@ export * from "./useBrush.mjs";
 export * from "./useFocusedItem.mjs";
 export { useXAxisCoordinates, useYAxisCoordinates } from "./useAxisCoordinates.mjs";
 export * from "./useAxisTicks.mjs";
-export * from "./getValueToPositionMapper.mjs";
+export * from "./getValueToPositionMapper.mjs";
+export { usePolarGeometry } from "./usePolarGeometry.mjs";

package/hooks/useAxis.d.mts

@@ -1,4 +1,4 @@
-import { type AxisId, type ChartsRadiusAxisProps, type ChartsRotationAxisProps, type ScaleName, type AxisScaleConfig, type ChartsXAxisProps, type ChartsYAxisProps, type ComputedAxis } from "../models/axis.mjs";
+import type { AxisId, ChartsRadiusAxisProps, ChartsRotationAxisProps, ScaleName, AxisScaleConfig, ChartsXAxisProps, ChartsYAxisProps, ComputedAxis } from "../models/axis.mjs";
 /**
  * Get all the x-axes.
  *

package/hooks/useAxis.d.ts

@@ -1,4 +1,4 @@
-import { type AxisId, type ChartsRadiusAxisProps, type ChartsRotationAxisProps, type ScaleName, type AxisScaleConfig, type ChartsXAxisProps, type ChartsYAxisProps, type ComputedAxis } from "../models/axis.js";
+import type { AxisId, ChartsRadiusAxisProps, ChartsRotationAxisProps, ScaleName, AxisScaleConfig, ChartsXAxisProps, ChartsYAxisProps, ComputedAxis } from "../models/axis.js";
 /**
  * Get all the x-axes.
  *

package/hooks/useAxisCoordinates.d.mts

@@ -1,5 +1,5 @@
-import { type ChartDrawingArea } from "./useDrawingArea.mjs";
-import { type AxisId, type ComputedXAxis, type ComputedYAxis } from "../models/axis.mjs";
+import type { ChartDrawingArea } from "./useDrawingArea.mjs";
+import type { AxisId, ComputedXAxis, ComputedYAxis } from "../models/axis.mjs";
 export interface AxisCoordinates {
   left: number;
   top: number;

package/hooks/useAxisCoordinates.d.ts

@@ -1,5 +1,5 @@
-import { type ChartDrawingArea } from "./useDrawingArea.js";
-import { type AxisId, type ComputedXAxis, type ComputedYAxis } from "../models/axis.js";
+import type { ChartDrawingArea } from "./useDrawingArea.js";
+import type { AxisId, ComputedXAxis, ComputedYAxis } from "../models/axis.js";
 export interface AxisCoordinates {
   left: number;
   top: number;

package/hooks/useAxisTicks.d.mts

@@ -1,5 +1,5 @@
-import { type TickItem } from "./useTicks.mjs";
-import { type AxisId } from "../models/axis.mjs";
+import type { TickItem } from "./useTicks.mjs";
+import type { AxisId } from "../models/axis.mjs";
 /**
  * Returns the ticks for the given X axis. Ticks outside the drawing area are not included.
  * The ticks returned from this hook are not grouped, i.e., they don't follow the `groups` prop of the axis.

package/hooks/useAxisTicks.d.ts

@@ -1,5 +1,5 @@
-import { type TickItem } from "./useTicks.js";
-import { type AxisId } from "../models/axis.js";
+import type { TickItem } from "./useTicks.js";
+import type { AxisId } from "../models/axis.js";
 /**
  * Returns the ticks for the given X axis. Ticks outside the drawing area are not included.
  * The ticks returned from this hook are not grouped, i.e., they don't follow the `groups` prop of the axis.

package/hooks/useBarSeries.d.mts

@@ -1,6 +1,6 @@
-import { type ProcessedSeries } from "../internals/plugins/corePlugins/useChartSeries/useChartSeries.types.mjs";
-import { type SeriesId } from "../models/seriesType/common.mjs";
-import { type ChartSeriesDefaultized } from "../models/seriesType/config.mjs";
+import type { ProcessedSeries } from "../internals/plugins/corePlugins/useChartSeries/useChartSeries.types.mjs";
+import type { SeriesId } from "../models/seriesType/common.mjs";
+import type { ChartSeriesDefaultized } from "../models/seriesType/config.mjs";
 export type UseBarSeriesReturnValue = ChartSeriesDefaultized<'bar'>;
 export type UseBarSeriesContextReturnValue = ProcessedSeries['bar'];
 /**

package/hooks/useBarSeries.d.ts

@@ -1,6 +1,6 @@
-import { type ProcessedSeries } from "../internals/plugins/corePlugins/useChartSeries/useChartSeries.types.js";
-import { type SeriesId } from "../models/seriesType/common.js";
-import { type ChartSeriesDefaultized } from "../models/seriesType/config.js";
+import type { ProcessedSeries } from "../internals/plugins/corePlugins/useChartSeries/useChartSeries.types.js";
+import type { SeriesId } from "../models/seriesType/common.js";
+import type { ChartSeriesDefaultized } from "../models/seriesType/config.js";
 export type UseBarSeriesReturnValue = ChartSeriesDefaultized<'bar'>;
 export type UseBarSeriesContextReturnValue = ProcessedSeries['bar'];
 /**

package/hooks/useChartGradientId.d.mts

@@ -1,4 +1,4 @@
-import { type AxisId } from "../models/axis.mjs";
+import type { AxisId } from "../models/axis.mjs";
 /**
  * Returns a function that generates a gradient id for the given axis id.
  */

package/hooks/useChartGradientId.d.ts

@@ -1,4 +1,4 @@
-import { type AxisId } from "../models/axis.js";
+import type { AxisId } from "../models/axis.js";
 /**
  * Returns a function that generates a gradient id for the given axis id.
  */

package/hooks/useColorScale.d.mts

@@ -1,4 +1,4 @@
-import { type AxisId, type AxisScaleComputedConfig, type ScaleName } from "../models/axis.mjs";
+import type { AxisId, AxisScaleComputedConfig, ScaleName } from "../models/axis.mjs";
 /**
  * Get the X axis color scale.
  *

package/hooks/useColorScale.d.ts

@@ -1,4 +1,4 @@
-import { type AxisId, type AxisScaleComputedConfig, type ScaleName } from "../models/axis.js";
+import type { AxisId, AxisScaleComputedConfig, ScaleName } from "../models/axis.js";
 /**
  * Get the X axis color scale.
  *

package/hooks/useDataset.d.mts

@@ -1,4 +1,4 @@
-import { type DatasetType } from "../models/seriesType/config.mjs";
+import type { DatasetType } from "../models/seriesType/config.mjs";
 /**
  * Get access to the dataset used to populate series and axes data.
  * @returns {DatasetType | undefined} The dataset array if provided, otherwise undefined.

package/hooks/useDataset.d.ts

@@ -1,4 +1,4 @@
-import { type DatasetType } from "../models/seriesType/config.js";
+import type { DatasetType } from "../models/seriesType/config.js";
 /**
  * Get access to the dataset used to populate series and axes data.
  * @returns {DatasetType | undefined} The dataset array if provided, otherwise undefined.

package/hooks/useItemHighlightStateGetter.d.mts

@@ -1,4 +1,4 @@
-import { type ChartSeriesType } from "../models/seriesType/config.mjs";
+import type { ChartSeriesType } from "../models/seriesType/config.mjs";
 /**
  * A hook to get a callback that returns the highlight state of an item.
  *

package/hooks/useItemHighlightStateGetter.d.ts

@@ -1,4 +1,4 @@
-import { type ChartSeriesType } from "../models/seriesType/config.js";
+import type { ChartSeriesType } from "../models/seriesType/config.js";
 /**
  * A hook to get a callback that returns the highlight state of an item.
  *

package/hooks/useLineSeries.d.mts

@@ -1,6 +1,6 @@
-import { type ProcessedSeries } from "../internals/plugins/corePlugins/useChartSeries/useChartSeries.types.mjs";
-import { type SeriesId } from "../models/seriesType/common.mjs";
-import { type ChartSeriesDefaultized } from "../models/seriesType/config.mjs";
+import type { ProcessedSeries } from "../internals/plugins/corePlugins/useChartSeries/useChartSeries.types.mjs";
+import type { SeriesId } from "../models/seriesType/common.mjs";
+import type { ChartSeriesDefaultized } from "../models/seriesType/config.mjs";
 export type UseLineSeriesReturnValue = ChartSeriesDefaultized<'line'>;
 export type UseLineSeriesContextReturnValue = ProcessedSeries['line'];
 /**

package/hooks/useLineSeries.d.ts

@@ -1,6 +1,6 @@
-import { type ProcessedSeries } from "../internals/plugins/corePlugins/useChartSeries/useChartSeries.types.js";
-import { type SeriesId } from "../models/seriesType/common.js";
-import { type ChartSeriesDefaultized } from "../models/seriesType/config.js";
+import type { ProcessedSeries } from "../internals/plugins/corePlugins/useChartSeries/useChartSeries.types.js";
+import type { SeriesId } from "../models/seriesType/common.js";
+import type { ChartSeriesDefaultized } from "../models/seriesType/config.js";
 export type UseLineSeriesReturnValue = ChartSeriesDefaultized<'line'>;
 export type UseLineSeriesContextReturnValue = ProcessedSeries['line'];
 /**

package/hooks/usePolarGeometry.d.mts

@@ -0,0 +1,51 @@
+import type { AxisScaleConfig, ScaleName } from "../models/axis.mjs";
+/**
+ * Provides access to the geometry of a polar chart.
+ *
+ * It can be used to position custom elements and convert between polar and Cartesian coordinates.
+ *
+ * @example
+ * ```tsx
+ * const geo = usePolarGeometry();
+ *
+ * const [x, y] = geo.point(100, Math.PI / 2);
+ *
+ * return <circle cx={geo.cx + x} cy={geo.cy + y} r={4} />
+ * ```
+ *
+ * @returns The polar geometry helpers, or `null` if the chart scales are not ready.
+ */
+export declare function usePolarGeometry<AngleScale extends ScaleName = ScaleName, RadiusScale extends ScaleName = ScaleName>(): PolarGeometry<AngleScale, RadiusScale> | null;
+export interface PolarGeometry<AngleScale extends ScaleName = ScaleName, RadiusScale extends ScaleName = ScaleName> {
+  /**
+   * The X coordinate of the chart center within the SVG.
+   */
+  cx: number;
+  /**
+   * The Y coordinate of the chart center within the SVG.
+   */
+  cy: number;
+  /**
+   * The scale that maps rotation axis values to angles in radians.
+   */
+  angleScale: AxisScaleConfig[AngleScale]['scale'];
+  /**
+   * The scale that maps data values to radii (distance from the chart center).
+   */
+  radiusScale: AxisScaleConfig[RadiusScale]['scale'];
+  /**
+   * Converts polar coordinates to Cartesian offsets relative to the chart center.
+   * @param {number} radius - Distance from the center.
+   * @param {number} angle - Angle in radians, measured clockwise from the top (12 o'clock).
+   * @returns {[number, number]} `[x, y]` offset from `[cx, cy]`.
+   */
+  point: (radius: number, angle: number) => [number, number];
+  /**
+   * Converts Cartesian offsets (relative to the chart center) back to polar coordinates.
+   * The inverse of `point`.
+   * @param {number} x - Horizontal offset from `cx`.
+   * @param {number} y - Vertical offset from `cy`.
+   * @returns {[number, number]} `[radius, angle]` where angle is in radians within `[-π, π]`.
+   */
+  pointInverse: (x: number, y: number) => [number, number];
+}

package/hooks/usePolarGeometry.d.ts

@@ -0,0 +1,51 @@
+import type { AxisScaleConfig, ScaleName } from "../models/axis.js";
+/**
+ * Provides access to the geometry of a polar chart.
+ *
+ * It can be used to position custom elements and convert between polar and Cartesian coordinates.
+ *
+ * @example
+ * ```tsx
+ * const geo = usePolarGeometry();
+ *
+ * const [x, y] = geo.point(100, Math.PI / 2);
+ *
+ * return <circle cx={geo.cx + x} cy={geo.cy + y} r={4} />
+ * ```
+ *
+ * @returns The polar geometry helpers, or `null` if the chart scales are not ready.
+ */
+export declare function usePolarGeometry<AngleScale extends ScaleName = ScaleName, RadiusScale extends ScaleName = ScaleName>(): PolarGeometry<AngleScale, RadiusScale> | null;
+export interface PolarGeometry<AngleScale extends ScaleName = ScaleName, RadiusScale extends ScaleName = ScaleName> {
+  /**
+   * The X coordinate of the chart center within the SVG.
+   */
+  cx: number;
+  /**
+   * The Y coordinate of the chart center within the SVG.
+   */
+  cy: number;
+  /**
+   * The scale that maps rotation axis values to angles in radians.
+   */
+  angleScale: AxisScaleConfig[AngleScale]['scale'];
+  /**
+   * The scale that maps data values to radii (distance from the chart center).
+   */
+  radiusScale: AxisScaleConfig[RadiusScale]['scale'];
+  /**
+   * Converts polar coordinates to Cartesian offsets relative to the chart center.
+   * @param {number} radius - Distance from the center.
+   * @param {number} angle - Angle in radians, measured clockwise from the top (12 o'clock).
+   * @returns {[number, number]} `[x, y]` offset from `[cx, cy]`.
+   */
+  point: (radius: number, angle: number) => [number, number];
+  /**
+   * Converts Cartesian offsets (relative to the chart center) back to polar coordinates.
+   * The inverse of `point`.
+   * @param {number} x - Horizontal offset from `cx`.
+   * @param {number} y - Vertical offset from `cy`.
+   * @returns {[number, number]} `[radius, angle]` where angle is in radians within `[-π, π]`.
+   */
+  pointInverse: (x: number, y: number) => [number, number];
+}

package/hooks/usePolarGeometry.js

@@ -0,0 +1,47 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.usePolarGeometry = usePolarGeometry;
+var _useDrawingArea = require("./useDrawingArea");
+var _useAxis = require("./useAxis");
+/**
+ * Provides access to the geometry of a polar chart.
+ *
+ * It can be used to position custom elements and convert between polar and Cartesian coordinates.
+ *
+ * @example
+ * ```tsx
+ * const geo = usePolarGeometry();
+ *
+ * const [x, y] = geo.point(100, Math.PI / 2);
+ *
+ * return <circle cx={geo.cx + x} cy={geo.cy + y} r={4} />
+ * ```
+ *
+ * @returns The polar geometry helpers, or `null` if the chart scales are not ready.
+ */
+function usePolarGeometry() {
+  const {
+    left,
+    top,
+    width,
+    height
+  } = (0, _useDrawingArea.useDrawingArea)();
+  const rotationAxis = (0, _useAxis.useRotationAxis)();
+  const radiusAxis = (0, _useAxis.useRadiusAxis)();
+  if (!rotationAxis || !radiusAxis) {
+    return null;
+  }
+  const angleScale = rotationAxis.scale;
+  const radiusScale = radiusAxis.scale;
+  return {
+    cx: left + width / 2,
+    cy: top + height / 2,
+    angleScale,
+    radiusScale,
+    point: (radius, angle) => [radius * Math.sin(angle), -radius * Math.cos(angle)],
+    pointInverse: (x, y) => [Math.sqrt(x * x + y * y), Math.atan2(x, -y)]
+  };
+}

package/hooks/usePolarGeometry.mjs

@@ -0,0 +1,41 @@
+import { useDrawingArea } from "./useDrawingArea.mjs";
+import { useRotationAxis, useRadiusAxis } from "./useAxis.mjs";
+/**
+ * Provides access to the geometry of a polar chart.
+ *
+ * It can be used to position custom elements and convert between polar and Cartesian coordinates.
+ *
+ * @example
+ * ```tsx
+ * const geo = usePolarGeometry();
+ *
+ * const [x, y] = geo.point(100, Math.PI / 2);
+ *
+ * return <circle cx={geo.cx + x} cy={geo.cy + y} r={4} />
+ * ```
+ *
+ * @returns The polar geometry helpers, or `null` if the chart scales are not ready.
+ */
+export function usePolarGeometry() {
+  const {
+    left,
+    top,
+    width,
+    height
+  } = useDrawingArea();
+  const rotationAxis = useRotationAxis();
+  const radiusAxis = useRadiusAxis();
+  if (!rotationAxis || !radiusAxis) {
+    return null;
+  }
+  const angleScale = rotationAxis.scale;
+  const radiusScale = radiusAxis.scale;
+  return {
+    cx: left + width / 2,
+    cy: top + height / 2,
+    angleScale,
+    radiusScale,
+    point: (radius, angle) => [radius * Math.sin(angle), -radius * Math.cos(angle)],
+    pointInverse: (x, y) => [Math.sqrt(x * x + y * y), Math.atan2(x, -y)]
+  };
+}

package/hooks/useRadarSeries.d.mts

@@ -1,6 +1,6 @@
-import { type ProcessedSeries } from "../internals/plugins/corePlugins/useChartSeries/useChartSeries.types.mjs";
-import { type SeriesId } from "../models/seriesType/common.mjs";
-import { type ChartSeriesDefaultized } from "../models/seriesType/config.mjs";
+import type { ProcessedSeries } from "../internals/plugins/corePlugins/useChartSeries/useChartSeries.types.mjs";
+import type { SeriesId } from "../models/seriesType/common.mjs";
+import type { ChartSeriesDefaultized } from "../models/seriesType/config.mjs";
 export type UseRadarSeriesReturnValue = ChartSeriesDefaultized<'radar'>;
 export type UseRadarSeriesContextReturnValue = ProcessedSeries['radar'];
 /**

package/hooks/useRadarSeries.d.ts

@@ -1,6 +1,6 @@
-import { type ProcessedSeries } from "../internals/plugins/corePlugins/useChartSeries/useChartSeries.types.js";
-import { type SeriesId } from "../models/seriesType/common.js";
-import { type ChartSeriesDefaultized } from "../models/seriesType/config.js";
+import type { ProcessedSeries } from "../internals/plugins/corePlugins/useChartSeries/useChartSeries.types.js";
+import type { SeriesId } from "../models/seriesType/common.js";
+import type { ChartSeriesDefaultized } from "../models/seriesType/config.js";
 export type UseRadarSeriesReturnValue = ChartSeriesDefaultized<'radar'>;
 export type UseRadarSeriesContextReturnValue = ProcessedSeries['radar'];
 /**