@mui/x-charts 9.1.0 → 9.3.0

package/models/axis.d.mts

@@ -10,6 +10,7 @@ import type { ChartsTextProps } from "../ChartsText/index.mjs";
 import type { ContinuousColorConfig, OrdinalColorConfig, PiecewiseColorConfig } from "./colorMapping.mjs";
 import type { OrdinalTimeTicks } from "./timeTicks.mjs";
 import { type ChartsTypeFeatureFlags } from "./featureFlags.mjs";
+import { type ChartsRadialAxisClasses } from "../ChartsRadiusAxis/sharedRadialAxisClasses.mjs";
 export type AxisId = string | number;
 export type D3Scale<Domain extends {
   toString(): string;
@@ -139,7 +140,9 @@ export interface ChartsXAxisProps extends ChartsAxisProps {
    */
   tickLabelMinGap?: number;
 }
-type AxisSideConfig<AxisProps extends ChartsXAxisProps | ChartsYAxisProps> = {
+export type ChartsCartesianAxisProps = ChartsXAxisProps | ChartsYAxisProps;
+export type ChartsRadialAxisProps = ChartsRotationAxisProps | ChartsRadiusAxisProps;
+type AxisSideConfig<AxisProps extends ChartsCartesianAxisProps> = {
   /**
    * Position of the axis.
    *
@@ -177,6 +180,28 @@ export interface ChartsRotationAxisProps extends ChartsAxisProps {
    * The gap between the axis and the label.
    */
   labelGap?: number;
+  /**
+   * The position of the rotation axis.
+   * It can be 'inside' or 'outside'.
+   * @default 'outside'
+   */
+  position?: 'inside' | 'outside' | 'none';
+  /**
+   * Set the position of the tick labels relative to the axis line.
+   * `'after'` places them outside the arc, `'before'` inside.
+   * @default position === 'outside' ? 'after' : 'before'
+   */
+  tickLabelPosition?: 'after' | 'before';
+  /**
+   * Set the position of the tick relative to the axis line.
+   * `'after'` places them outside the arc, `'before'` inside.
+   * @default position === 'outside' ? 'after' : 'before'
+   */
+  tickPosition?: 'after' | 'before';
+  /**
+   * Override or extend the styles applied to the component.
+   */
+  classes?: Partial<ChartsRadialAxisClasses>;
 }
 export interface ChartsRadiusAxisProps extends ChartsAxisProps {
   axis?: 'radius';
@@ -188,6 +213,29 @@ export interface ChartsRadiusAxisProps extends ChartsAxisProps {
    * The maximal radius.
    */
   maxRadius?: number;
+  /**
+   * The position of the axis in polar coordinates.
+   * It can be 'start', 'end', or a specific angle in degrees.
+   * @default 'start'
+   */
+  position?: 'start' | 'end' | number | 'none';
+  /**
+   * Set the position of the tick labels relative to the axis line.
+   * The before/after is defined based on clockwise direction.
+   * Using `'auto'` sets it to `'before'` if position is `'start'` and `'after'` otherwise.
+   * @default 'auto'
+   */
+  tickLabelPosition?: 'center' | 'after' | 'before' | 'auto';
+  /**
+   * Set the position of the tick relative to the axis line.
+   * The before/after is defined based on clockwise direction.
+   * @default position === 'start' ? 'before' : 'after'
+   */
+  tickPosition?: 'after' | 'before';
+  /**
+   * Override or extend the styles applied to the component.
+   */
+  classes?: Partial<ChartsRadialAxisClasses>;
 }
 export type ScaleName = keyof AxisScaleConfig;
 export type ContinuousScaleName = 'linear' | 'log' | 'symlog' | 'pow' | 'sqrt' | 'time' | 'utc';
@@ -475,7 +523,7 @@ type CommonAxisConfig<S extends ScaleName = ScaleName, V = any> = {
 /**
  * Use this type for advanced typing. For basic usage, use `RotationAxis` or `RadiusAxis`.
  */
-export type PolarAxisConfig<S extends ScaleName = ScaleName, V = any, AxisProps extends ChartsRotationAxisProps | ChartsRadiusAxisProps = ChartsRotationAxisProps | ChartsRadiusAxisProps> = {
+export type PolarAxisConfig<S extends ScaleName = ScaleName, V = any, AxisProps extends ChartsRadialAxisProps = ChartsRadialAxisProps> = {
   /**
    * 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.
@@ -487,7 +535,7 @@ export type PolarAxisConfig<S extends ScaleName = ScaleName, V = any, AxisProps
 /**
  * Use this type for advanced typing. For basic usage, use `XAxis` or `YAxis`.
  */
-export type AxisConfig<S extends ScaleName = ScaleName, V = any, AxisProps extends ChartsXAxisProps | ChartsYAxisProps = ChartsXAxisProps | ChartsYAxisProps> = {
+export type AxisConfig<S extends ScaleName = ScaleName, V = any, AxisProps extends ChartsCartesianAxisProps = ChartsCartesianAxisProps> = {
   /**
    * 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.
@@ -497,13 +545,13 @@ export type AxisConfig<S extends ScaleName = ScaleName, V = any, AxisProps exten
   offset?: number;
 } & CommonAxisConfig<S, V> & MinMaxConfig<S> & Omit<Partial<AxisProps>, 'axisId'> & Partial<Omit<AxisScaleConfig[S], 'scale'>> & AxisSideConfig<AxisProps> & TickParams & AxisConfigExtension;
 export interface AxisConfigExtension {}
-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 PolarAxisDefaultized<S extends ScaleName = ScaleName, V = any, AxisProps extends ChartsAxisProps = ChartsRadialAxisProps> = Omit<PolarAxisConfig<S, V, AxisProps>, 'scaleType'> & AxisScaleConfig[S] & AxisScaleComputedConfig[S] & {
   /**
    * If true, the contents of the axis will be displayed by a tooltip with `trigger='axis'`.
    */
   triggerTooltip?: boolean;
 };
-export type ComputedAxis<S extends ScaleName = ScaleName, V = any, AxisProps extends ChartsAxisProps = ChartsXAxisProps | ChartsYAxisProps> = MakeRequired<Omit<DefaultedAxis<S, V, AxisProps>, 'scaleType'>, 'offset'> & AxisScaleConfig[S] & AxisScaleComputedConfig[S] & {
+export type ComputedAxis<S extends ScaleName = ScaleName, V = any, AxisProps extends ChartsAxisProps = ChartsCartesianAxisProps> = AxisProps extends any ? MakeRequired<Omit<DefaultedAxis<S, V, AxisProps>, 'scaleType'>, 'offset'> & AxisScaleConfig[S] & AxisScaleComputedConfig[S] & {
   /**
    * An indication of the expected number of ticks.
    */
@@ -518,7 +566,7 @@ export type ComputedAxis<S extends ScaleName = ScaleName, V = any, AxisProps ext
   height: number;
 } : {}) & (AxisProps extends ChartsYAxisProps ? AxisSideConfig<AxisProps> & {
   width: number;
-} : {});
+} : {}) : never;
 export type ComputedXAxis<S extends ScaleName = ScaleName, V = any> = ComputedAxis<S, V, ChartsXAxisProps>;
 export type ComputedYAxis<S extends ScaleName = ScaleName, V = any> = ComputedAxis<S, V, ChartsYAxisProps>;
 export declare function isBandScaleConfig(scaleConfig: PolarAxisConfig<ScaleName>): scaleConfig is PolarAxisConfig<'band'> & {
@@ -580,7 +628,7 @@ export type RadiusAxis<S extends ScaleName = ScaleName, V = any> = S extends Sca
 /**
  * The axis configuration with missing values filled with default values.
  */
-export type DefaultedAxis<S extends ScaleName = ScaleName, V = any, AxisProps extends ChartsAxisProps = ChartsXAxisProps | ChartsYAxisProps> = AxisConfig<S, V, AxisProps> & {
+export type DefaultedAxis<S extends ScaleName = ScaleName, V = any, AxisProps extends ChartsAxisProps = ChartsCartesianAxisProps> = AxisConfig<S, V, AxisProps> & {
   zoom: DefaultizedZoomOptions | undefined;
 };
 /**

package/models/axis.d.ts

@@ -10,6 +10,7 @@ import type { ChartsTextProps } from "../ChartsText/index.js";
 import type { ContinuousColorConfig, OrdinalColorConfig, PiecewiseColorConfig } from "./colorMapping.js";
 import type { OrdinalTimeTicks } from "./timeTicks.js";
 import { type ChartsTypeFeatureFlags } from "./featureFlags.js";
+import { type ChartsRadialAxisClasses } from "../ChartsRadiusAxis/sharedRadialAxisClasses.js";
 export type AxisId = string | number;
 export type D3Scale<Domain extends {
   toString(): string;
@@ -139,7 +140,9 @@ export interface ChartsXAxisProps extends ChartsAxisProps {
    */
   tickLabelMinGap?: number;
 }
-type AxisSideConfig<AxisProps extends ChartsXAxisProps | ChartsYAxisProps> = {
+export type ChartsCartesianAxisProps = ChartsXAxisProps | ChartsYAxisProps;
+export type ChartsRadialAxisProps = ChartsRotationAxisProps | ChartsRadiusAxisProps;
+type AxisSideConfig<AxisProps extends ChartsCartesianAxisProps> = {
   /**
    * Position of the axis.
    *
@@ -177,6 +180,28 @@ export interface ChartsRotationAxisProps extends ChartsAxisProps {
    * The gap between the axis and the label.
    */
   labelGap?: number;
+  /**
+   * The position of the rotation axis.
+   * It can be 'inside' or 'outside'.
+   * @default 'outside'
+   */
+  position?: 'inside' | 'outside' | 'none';
+  /**
+   * Set the position of the tick labels relative to the axis line.
+   * `'after'` places them outside the arc, `'before'` inside.
+   * @default position === 'outside' ? 'after' : 'before'
+   */
+  tickLabelPosition?: 'after' | 'before';
+  /**
+   * Set the position of the tick relative to the axis line.
+   * `'after'` places them outside the arc, `'before'` inside.
+   * @default position === 'outside' ? 'after' : 'before'
+   */
+  tickPosition?: 'after' | 'before';
+  /**
+   * Override or extend the styles applied to the component.
+   */
+  classes?: Partial<ChartsRadialAxisClasses>;
 }
 export interface ChartsRadiusAxisProps extends ChartsAxisProps {
   axis?: 'radius';
@@ -188,6 +213,29 @@ export interface ChartsRadiusAxisProps extends ChartsAxisProps {
    * The maximal radius.
    */
   maxRadius?: number;
+  /**
+   * The position of the axis in polar coordinates.
+   * It can be 'start', 'end', or a specific angle in degrees.
+   * @default 'start'
+   */
+  position?: 'start' | 'end' | number | 'none';
+  /**
+   * Set the position of the tick labels relative to the axis line.
+   * The before/after is defined based on clockwise direction.
+   * Using `'auto'` sets it to `'before'` if position is `'start'` and `'after'` otherwise.
+   * @default 'auto'
+   */
+  tickLabelPosition?: 'center' | 'after' | 'before' | 'auto';
+  /**
+   * Set the position of the tick relative to the axis line.
+   * The before/after is defined based on clockwise direction.
+   * @default position === 'start' ? 'before' : 'after'
+   */
+  tickPosition?: 'after' | 'before';
+  /**
+   * Override or extend the styles applied to the component.
+   */
+  classes?: Partial<ChartsRadialAxisClasses>;
 }
 export type ScaleName = keyof AxisScaleConfig;
 export type ContinuousScaleName = 'linear' | 'log' | 'symlog' | 'pow' | 'sqrt' | 'time' | 'utc';
@@ -475,7 +523,7 @@ type CommonAxisConfig<S extends ScaleName = ScaleName, V = any> = {
 /**
  * Use this type for advanced typing. For basic usage, use `RotationAxis` or `RadiusAxis`.
  */
-export type PolarAxisConfig<S extends ScaleName = ScaleName, V = any, AxisProps extends ChartsRotationAxisProps | ChartsRadiusAxisProps = ChartsRotationAxisProps | ChartsRadiusAxisProps> = {
+export type PolarAxisConfig<S extends ScaleName = ScaleName, V = any, AxisProps extends ChartsRadialAxisProps = ChartsRadialAxisProps> = {
   /**
    * 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.
@@ -487,7 +535,7 @@ export type PolarAxisConfig<S extends ScaleName = ScaleName, V = any, AxisProps
 /**
  * Use this type for advanced typing. For basic usage, use `XAxis` or `YAxis`.
  */
-export type AxisConfig<S extends ScaleName = ScaleName, V = any, AxisProps extends ChartsXAxisProps | ChartsYAxisProps = ChartsXAxisProps | ChartsYAxisProps> = {
+export type AxisConfig<S extends ScaleName = ScaleName, V = any, AxisProps extends ChartsCartesianAxisProps = ChartsCartesianAxisProps> = {
   /**
    * 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.
@@ -497,13 +545,13 @@ export type AxisConfig<S extends ScaleName = ScaleName, V = any, AxisProps exten
   offset?: number;
 } & CommonAxisConfig<S, V> & MinMaxConfig<S> & Omit<Partial<AxisProps>, 'axisId'> & Partial<Omit<AxisScaleConfig[S], 'scale'>> & AxisSideConfig<AxisProps> & TickParams & AxisConfigExtension;
 export interface AxisConfigExtension {}
-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 PolarAxisDefaultized<S extends ScaleName = ScaleName, V = any, AxisProps extends ChartsAxisProps = ChartsRadialAxisProps> = Omit<PolarAxisConfig<S, V, AxisProps>, 'scaleType'> & AxisScaleConfig[S] & AxisScaleComputedConfig[S] & {
   /**
    * If true, the contents of the axis will be displayed by a tooltip with `trigger='axis'`.
    */
   triggerTooltip?: boolean;
 };
-export type ComputedAxis<S extends ScaleName = ScaleName, V = any, AxisProps extends ChartsAxisProps = ChartsXAxisProps | ChartsYAxisProps> = MakeRequired<Omit<DefaultedAxis<S, V, AxisProps>, 'scaleType'>, 'offset'> & AxisScaleConfig[S] & AxisScaleComputedConfig[S] & {
+export type ComputedAxis<S extends ScaleName = ScaleName, V = any, AxisProps extends ChartsAxisProps = ChartsCartesianAxisProps> = AxisProps extends any ? MakeRequired<Omit<DefaultedAxis<S, V, AxisProps>, 'scaleType'>, 'offset'> & AxisScaleConfig[S] & AxisScaleComputedConfig[S] & {
   /**
    * An indication of the expected number of ticks.
    */
@@ -518,7 +566,7 @@ export type ComputedAxis<S extends ScaleName = ScaleName, V = any, AxisProps ext
   height: number;
 } : {}) & (AxisProps extends ChartsYAxisProps ? AxisSideConfig<AxisProps> & {
   width: number;
-} : {});
+} : {}) : never;
 export type ComputedXAxis<S extends ScaleName = ScaleName, V = any> = ComputedAxis<S, V, ChartsXAxisProps>;
 export type ComputedYAxis<S extends ScaleName = ScaleName, V = any> = ComputedAxis<S, V, ChartsYAxisProps>;
 export declare function isBandScaleConfig(scaleConfig: PolarAxisConfig<ScaleName>): scaleConfig is PolarAxisConfig<'band'> & {
@@ -580,7 +628,7 @@ export type RadiusAxis<S extends ScaleName = ScaleName, V = any> = S extends Sca
 /**
  * The axis configuration with missing values filled with default values.
  */
-export type DefaultedAxis<S extends ScaleName = ScaleName, V = any, AxisProps extends ChartsAxisProps = ChartsXAxisProps | ChartsYAxisProps> = AxisConfig<S, V, AxisProps> & {
+export type DefaultedAxis<S extends ScaleName = ScaleName, V = any, AxisProps extends ChartsAxisProps = ChartsCartesianAxisProps> = AxisConfig<S, V, AxisProps> & {
   zoom: DefaultizedZoomOptions | undefined;
 };
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mui/x-charts",
-  "version": "9.1.0",
+  "version": "9.3.0",
   "author": "MUI Team",
   "description": "The community edition of MUI X Charts components.",
   "license": "MIT",
@@ -28,13 +28,13 @@
   },
   "dependencies": {
     "@babel/runtime": "^7.29.2",
-    "@mui/utils": "9.0.0",
+    "@mui/utils": "9.0.1",
     "bezier-easing": "^2.1.0",
     "clsx": "^2.1.1",
     "prop-types": "^15.8.1",
     "reselect": "^5.1.1",
     "use-sync-external-store": "^1.6.0",
-    "@mui/x-internal-gestures": "^9.1.0",
+    "@mui/x-internal-gestures": "^9.3.0",
     "@mui/x-charts-vendor": "^9.0.0",
     "@mui/x-internals": "^9.1.0"
   },