@mui/x-charts 8.8.0 → 8.9.2

package/internals/symlogScale.js

@@ -0,0 +1,100 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.scaleSymlog = scaleSymlog;
+var _d3Scale = require("@mui/x-charts-vendor/d3-scale");
+function scaleSymlog(_domain, _range) {
+  const scale = (0, _d3Scale.scaleSymlog)(_domain, _range);
+  const originalTicks = scale.ticks;
+  const {
+    negativeScale,
+    linearScale,
+    positiveScale
+  } = generateScales(scale);
+
+  // Workaround for https://github.com/d3/d3-scale/issues/162
+  scale.ticks = count => {
+    const ticks = originalTicks(count);
+    const constant = scale.constant();
+    let negativeLogTickCount = 0;
+    let linearTickCount = 0;
+    let positiveLogTickCount = 0;
+    ticks.forEach(tick => {
+      if (tick > -constant && tick < constant) {
+        linearTickCount += 1;
+      }
+      if (tick <= -constant) {
+        negativeLogTickCount += 1;
+      }
+      if (tick >= constant) {
+        positiveLogTickCount += 1;
+      }
+    });
+    const finalTicks = [];
+    if (negativeLogTickCount > 0) {
+      finalTicks.push(...negativeScale.ticks(negativeLogTickCount));
+    }
+    if (linearTickCount > 0) {
+      const linearTicks = linearScale.ticks(linearTickCount);
+      if (finalTicks.at(-1) === linearTicks[0]) {
+        finalTicks.push(...linearTicks.slice(1));
+      } else {
+        finalTicks.push(...linearTicks);
+      }
+    }
+    if (positiveLogTickCount > 0) {
+      const positiveTicks = positiveScale.ticks(positiveLogTickCount);
+      if (finalTicks.at(-1) === positiveTicks[0]) {
+        finalTicks.push(...positiveTicks.slice(1));
+      } else {
+        finalTicks.push(...positiveTicks);
+      }
+    }
+    return finalTicks;
+  };
+  scale.tickFormat = (count = 10, specifier) => {
+    // Calculates the proportion of the domain that each scale occupies, and use that ratio to determine the number of ticks for each scale.
+    const constant = scale.constant();
+    const [start, end] = scale.domain();
+    const extent = end - start;
+    const negativeScaleDomain = negativeScale.domain();
+    const negativeScaleExtent = negativeScaleDomain[1] - negativeScaleDomain[0];
+    const negativeScaleRatio = extent === 0 ? 0 : negativeScaleExtent / extent;
+    const negativeScaleTickCount = negativeScaleRatio * count;
+    const linearScaleDomain = linearScale.domain();
+    const linearScaleExtent = linearScaleDomain[1] - linearScaleDomain[0];
+    const linearScaleRatio = extent === 0 ? 0 : linearScaleExtent / extent;
+    const linearScaleTickCount = linearScaleRatio * count;
+    const positiveScaleDomain = positiveScale.domain();
+    const positiveScaleExtent = positiveScaleDomain[1] - positiveScaleDomain[0];
+    const positiveScaleRatio = extent === 0 ? 0 : positiveScaleExtent / extent;
+    const positiveScaleTickCount = positiveScaleRatio * count;
+    const negativeTickFormat = negativeScale.tickFormat(negativeScaleTickCount, specifier);
+    const linearTickFormat = linearScale.tickFormat(linearScaleTickCount, specifier);
+    const positiveTickFormat = positiveScale.tickFormat(positiveScaleTickCount, specifier);
+    return tick => {
+      const tickFormat =
+      // eslint-disable-next-line no-nested-ternary
+      tick.valueOf() <= -constant ? negativeTickFormat : tick.valueOf() >= constant ? positiveTickFormat : linearTickFormat;
+      return tickFormat(tick);
+    };
+  };
+  return scale;
+}
+function generateScales(scale) {
+  const constant = scale.constant();
+  const domain = scale.domain();
+  const negativeDomain = [domain[0], Math.min(domain[1], -constant)];
+  const negativeLogScale = (0, _d3Scale.scaleLog)(negativeDomain, scale.range());
+  const linearDomain = [Math.max(domain[0], -constant), Math.min(domain[1], constant)];
+  const linearScale = (0, _d3Scale.scaleLinear)(linearDomain, scale.range());
+  const positiveDomain = [Math.max(domain[0], constant), domain[1]];
+  const positiveLogScale = (0, _d3Scale.scaleLog)(positiveDomain, scale.range());
+  return {
+    negativeScale: negativeLogScale,
+    linearScale,
+    positiveScale: positiveLogScale
+  };
+}

package/models/axis.d.ts

@@ -1,4 +1,4 @@
-import type { ScaleBand, ScaleLinear, ScaleLogarithmic, ScaleOrdinal, ScalePoint, ScalePower, ScaleSequential, ScaleThreshold, ScaleTime } from '@mui/x-charts-vendor/d3-scale';
+import type { ScaleBand, ScaleLinear, ScaleLogarithmic, ScaleOrdinal, ScalePoint, ScalePower, ScaleSequential, ScaleThreshold, ScaleTime, ScaleSymLog } from '@mui/x-charts-vendor/d3-scale';
 import { SxProps } from '@mui/system/styleFunctionSx';
 import { type MakeOptional, MakeRequired } from '@mui/x-internals/types';
 import type { DefaultizedZoomOptions } from "../internals/plugins/featurePlugins/useChartCartesianAxis/index.js";
@@ -9,8 +9,8 @@ import { ContinuousColorConfig, OrdinalColorConfig, PiecewiseColorConfig } from
 export type AxisId = string | number;
 export type D3Scale<Domain extends {
   toString(): string;
-} = number | Date | string, Range = number, Output = number> = ScaleBand<Domain> | ScaleLogarithmic<Range, Output> | ScalePoint<Domain> | ScalePower<Range, Output> | ScaleTime<Range, Output> | ScaleLinear<Range, Output>;
-export type D3ContinuousScale<Range = number, Output = number> = ScaleLogarithmic<Range, Output> | ScalePower<Range, Output> | ScaleTime<Range, Output> | ScaleLinear<Range, Output>;
+} = number | Date | string, Range = number, Output = number> = ScaleBand<Domain> | ScaleSymLog<Range, Output> | ScaleLogarithmic<Range, Output> | ScalePoint<Domain> | ScalePower<Range, Output> | ScaleTime<Range, Output> | ScaleLinear<Range, Output>;
+export type D3ContinuousScale<Range = number, Output = number> = ScaleSymLog<Range, Output> | ScaleLogarithmic<Range, Output> | ScalePower<Range, Output> | ScaleTime<Range, Output> | ScaleLinear<Range, Output>;
 export interface ChartsAxisSlots {
   /**
    * Custom component for the axis main line.
@@ -179,7 +179,7 @@ export interface ChartsRadiusAxisProps extends ChartsAxisProps {
   maxRadius?: number;
 }
 export type ScaleName = keyof AxisScaleConfig;
-export type ContinuousScaleName = 'linear' | 'log' | 'pow' | 'sqrt' | 'time' | 'utc';
+export type ContinuousScaleName = 'linear' | 'log' | 'symlog' | 'pow' | 'sqrt' | 'time' | 'utc';
 export interface AxisScaleConfig {
   band: {
     scaleType: 'band';
@@ -208,6 +208,16 @@ export interface AxisScaleConfig {
     scale: ScaleLogarithmic<number, number>;
     colorMap?: ContinuousColorConfig | PiecewiseColorConfig;
   };
+  symlog: {
+    scaleType: 'symlog';
+    scale: ScaleSymLog<number, number>;
+    colorMap?: ContinuousColorConfig | PiecewiseColorConfig;
+    /**
+     * The constant used to define the zero point of the symlog scale.
+     * @default 1
+     */
+    constant?: number;
+  };
   pow: {
     scaleType: 'pow';
     scale: ScalePower<number, number>;
@@ -248,6 +258,9 @@ export interface AxisScaleComputedConfig {
   log: {
     colorScale?: ScaleSequential<string, string | null> | ScaleThreshold<number, string | null>;
   };
+  symlog: {
+    colorScale?: ScaleSequential<string, string | null> | ScaleThreshold<number, string | null>;
+  };
   pow: {
     colorScale?: ScaleSequential<string, string | null> | ScaleThreshold<number, string | null>;
   };
@@ -281,11 +294,37 @@ export type AxisValueFormatterContext<S extends ScaleName = ScaleName> = {
    * - `'legend'` The value is displayed in the legend when using color legend.
    * - `'zoom-slider-tooltip'` The value is displayed in the zoom slider tooltip.
    */
-  location: 'tick' | 'tooltip' | 'zoom-slider-tooltip';
+  location: 'tooltip' | 'zoom-slider-tooltip';
   /**
    * The d3-scale instance associated to the axis.
    */
   scale: AxisScaleConfig[S]['scale'];
+} | {
+  /**
+   * Location indicates where the value will be displayed.
+   * - `'tick'` The value is displayed on the axis ticks.
+   * - `'tooltip'` The value is displayed in the tooltip when hovering the chart.
+   * - `'legend'` The value is displayed in the legend when using color legend.
+   * - `'zoom-slider-tooltip'` The value is displayed in the zoom slider tooltip.
+   */
+  location: 'tick';
+  /**
+   * The d3-scale instance associated to the axis.
+   */
+  scale: AxisScaleConfig[S]['scale'];
+  /**
+   * The tick label shown by default if the value isn't formatted.
+   * This value might be an empty string if no tick label should be displayed, which is particularly useful in log
+   * scales where we want to show ticks to demonstrate it's a log scale, but not labels to avoid them overlapping.
+   * @see See {@link https://d3js.org/d3-scale/log#log_tickFormat D3 log scale docs} for more details.
+   */
+  defaultTickLabel: string;
+  /**
+   * A suggestion of the number of ticks to show.
+   * Can be provided to the scale's `ticks` method to compute the ticks, or to `tickFormat` to format the ticks.
+   * Can be `undefined` if the scale doesn't support it, e.g., band, point scales.
+   */
+  tickNumber?: number;
 };
 /**
  * Config that is shared between cartesian and polar axes.
@@ -391,6 +430,9 @@ export declare function isBandScaleConfig(scaleConfig: AxisConfig<ScaleName>): s
 export declare function isPointScaleConfig(scaleConfig: AxisConfig<ScaleName>): scaleConfig is AxisConfig<'point'> & {
   scaleType: 'point';
 };
+export declare function isSymlogScaleConfig(scaleConfig: AxisConfig<ScaleName>): scaleConfig is AxisConfig<'symlog'> & {
+  scaleType: 'symlog';
+};
 /**
  * The data format returned by onAxisClick.
  */

package/models/axis.js

@@ -5,6 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.isBandScaleConfig = isBandScaleConfig;
 exports.isPointScaleConfig = isPointScaleConfig;
+exports.isSymlogScaleConfig = isSymlogScaleConfig;
 /**
  * Use this type instead of `AxisScaleConfig` when the values
  * shouldn't be provided by the user.
@@ -24,6 +25,9 @@ function isBandScaleConfig(scaleConfig) {
 function isPointScaleConfig(scaleConfig) {
   return scaleConfig.scaleType === 'point';
 }
+function isSymlogScaleConfig(scaleConfig) {
+  return scaleConfig.scaleType === 'symlog';
+}
 
 /**
  * The data format returned by onAxisClick.

package/models/seriesType/bar.d.ts

@@ -25,6 +25,16 @@ export interface BarSeriesType extends CommonSeriesType<number | null>, Cartesia
    * @default 'diverging'
    */
   stackOffset?: StackOffsetType;
+  /**
+   * If provided, the value will be used as the minimum size of the bar in pixels.
+   * This is useful to avoid bars with a size of 0.
+   *
+   * The property is ignored if the series value is `null` or `0`.
+   * It also doesn't work with stacked series.
+   *
+   * @default 0px
+   */
+  minBarSize?: number;
 }
 /**
  * An object that allows to identify a single bar.
@@ -35,4 +45,4 @@ export type BarItemIdentifier = {
   seriesId: SeriesId;
   dataIndex: number;
 };
-export interface DefaultizedBarSeriesType extends DefaultizedProps<BarSeriesType, CommonDefaultizedProps | 'color' | 'layout'> {}
+export interface DefaultizedBarSeriesType extends DefaultizedProps<BarSeriesType, CommonDefaultizedProps | 'color' | 'layout' | 'minBarSize'> {}

package/models/seriesType/common.d.ts

@@ -1,6 +1,6 @@
-import type { ChartsLabelMarkProps } from "../../ChartsLabel/index.js";
 import { HighlightScope } from "../../internals/plugins/featurePlugins/useChartHighlight/highlightConfig.types.js";
 import type { StackOffsetType, StackOrderType } from "../stacking.js";
+import type { ChartsLabelMarkType } from "../../ChartsLabel/ChartsLabelMark.js";
 export type SeriesId = number | string;
 export type SeriesValueFormatterContext = {
   /**
@@ -10,7 +10,13 @@ export type SeriesValueFormatterContext = {
 };
 export type SeriesValueFormatter<TValue> = (value: TValue, context: SeriesValueFormatterContext) => string | null;
 export type CommonSeriesType<TValue> = {
+  /**
+   * The id of this series.
+   */
   id?: SeriesId;
+  /**
+   * Color to use when displaying the series.
+   */
   color?: string;
   /**
    * Formatter used to render values in tooltip or other data display.
@@ -22,13 +28,13 @@ export type CommonSeriesType<TValue> = {
   /**
    * The scope to apply when the series is highlighted.
    */
-  highlightScope?: Partial<HighlightScope>;
+  highlightScope?: HighlightScope;
   /**
    * Defines the mark type for the series.
    *
    * There is a default mark type for each series type.
    */
-  labelMarkType?: ChartsLabelMarkProps['type'];
+  labelMarkType?: ChartsLabelMarkType;
 };
 export type CommonDefaultizedProps = 'id' | 'valueFormatter' | 'data';
 export type CartesianSeriesType = {

package/models/seriesType/line.d.ts

@@ -34,7 +34,9 @@ export interface LineSeriesType extends CommonSeriesType<number | null>, Cartesi
    * The key used to retrieve data from the dataset.
    */
   dataKey?: string;
-  stack?: string;
+  /**
+   * If `true`, the series is rendered as an area instead of a line.
+   */
   area?: boolean;
   /**
    * The label to display on the tooltip or the legend. It can be a string or a function.

package/models/seriesType/scatter.d.ts

@@ -12,6 +12,9 @@ export type ScatterValueType = {
 export interface ScatterSeriesType extends CommonSeriesType<ScatterValueType | null>, CartesianSeriesType {
   type: 'scatter';
   data?: readonly ScatterValueType[];
+  /**
+   * Size of the markers in the scatter plot, in pixels.
+   */
   markerSize?: number;
   /**
    * The label to display on the tooltip or the legend. It can be a string or a function.
@@ -52,7 +55,7 @@ export interface ScatterSeriesType extends CommonSeriesType<ScatterValueType | n
   };
   preview?: {
     /**
-     * The size of the preview marker.
+     * The size of the preview marker in pixels.
      * @default 1
      */
     markerSize?: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mui/x-charts",
-  "version": "8.8.0",
+  "version": "8.9.2",
   "author": "MUI Team",
   "description": "The community edition of MUI X Charts components.",
   "main": "./index.js",
@@ -11,8 +11,7 @@
   "homepage": "https://mui.com/x/react-charts/",
   "sideEffects": false,
   "publishConfig": {
-    "access": "public",
-    "directory": "build"
+    "access": "public"
   },
   "keywords": [
     "react",
@@ -29,16 +28,16 @@
     "directory": "packages/x-charts"
   },
   "dependencies": {
-    "@babel/runtime": "^7.27.6",
+    "@babel/runtime": "^7.28.2",
     "@mui/utils": "^7.2.0",
     "bezier-easing": "^2.1.0",
     "clsx": "^2.1.1",
     "prop-types": "^15.8.1",
     "reselect": "^5.1.1",
     "use-sync-external-store": "^1.5.0",
-    "@mui/x-charts-vendor": "8.5.3",
-    "@mui/x-internals": "8.8.0",
-    "@mui/x-internal-gestures": "0.2.1"
+    "@mui/x-charts-vendor": "8.6.0",
+    "@mui/x-internal-gestures": "0.2.2",
+    "@mui/x-internals": "8.9.2"
   },
   "peerDependencies": {
     "@emotion/react": "^11.9.0",

package/tests/web-components.js

@@ -0,0 +1,55 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.reactToWebComponent = reactToWebComponent;
+const renderSymbol = Symbol.for('render');
+const connectedSymbol = Symbol.for('connected');
+const contextSymbol = Symbol.for('context');
+const propsSymbol = Symbol.for('props');
+
+// This function creates a custom web component that wraps a React component.
+// Adapted from https://github.com/bitovi/react-to-web-component/blob/b1372bfd7bc67fe49920db840f1ed9cf736b2724/packages/core/src/core.ts
+function reactToWebComponent(ReactComponent, options, renderer) {
+  class ReactWebComponent extends HTMLElement {
+    static get observedAttributes() {
+      return [];
+    }
+    constructor() {
+      super();
+      this[connectedSymbol] = true;
+      this[contextSymbol] = void 0;
+      this[propsSymbol] = {};
+      this.container = void 0;
+      if (options.shadow) {
+        this.container = this.attachShadow({
+          mode: options.shadow
+        });
+      } else {
+        this.container = this;
+      }
+      this[propsSymbol].container = this.container;
+    }
+    connectedCallback() {
+      this[connectedSymbol] = true;
+      this[renderSymbol]();
+    }
+    disconnectedCallback() {
+      this[connectedSymbol] = false;
+      if (this[contextSymbol]) {
+        renderer.unmount(this[contextSymbol]);
+      }
+      delete this[contextSymbol];
+    }
+    [renderSymbol]() {
+      if (!this[connectedSymbol]) {
+        return;
+      }
+      if (!this[contextSymbol]) {
+        this[contextSymbol] = renderer.mount(this.container, ReactComponent, this[propsSymbol]);
+      }
+    }
+  }
+  return ReactWebComponent;
+}

package/BarChart/getRadius.d.ts

@@ -1,20 +0,0 @@
-export type GetRadiusData = {
-  hasNegative: boolean;
-  hasPositive: boolean;
-  borderRadius?: number;
-  layout?: 'vertical' | 'horizontal';
-};
-type GetRadiusCorner = 'top-left' | 'top-right' | 'bottom-right' | 'bottom-left';
-/**
- * Returns if the corner should have a radius or not based on the layout and the data.
- * @param {GetRadiusCorner} corner The corner to check.
- * @param {GetRadiusData} cornerData The data for the corner.
- * @returns {number} The radius for the corner.
- */
-export declare const getRadius: (corner: GetRadiusCorner, {
-  hasNegative,
-  hasPositive,
-  borderRadius,
-  layout
-}: GetRadiusData) => number;
-export {};

package/BarChart/getRadius.js

@@ -1,37 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.getRadius = void 0;
-/**
- * Returns if the corner should have a radius or not based on the layout and the data.
- * @param {GetRadiusCorner} corner The corner to check.
- * @param {GetRadiusData} cornerData The data for the corner.
- * @returns {number} The radius for the corner.
- */
-const getRadius = (corner, {
-  hasNegative,
-  hasPositive,
-  borderRadius,
-  layout
-}) => {
-  if (!borderRadius) {
-    return 0;
-  }
-  const isVertical = layout === 'vertical';
-  if (corner === 'top-left' && (isVertical && hasPositive || !isVertical && hasNegative)) {
-    return borderRadius;
-  }
-  if (corner === 'top-right' && (isVertical && hasPositive || !isVertical && hasPositive)) {
-    return borderRadius;
-  }
-  if (corner === 'bottom-right' && (isVertical && hasNegative || !isVertical && hasPositive)) {
-    return borderRadius;
-  }
-  if (corner === 'bottom-left' && (isVertical && hasNegative || !isVertical && hasNegative)) {
-    return borderRadius;
-  }
-  return 0;
-};
-exports.getRadius = getRadius;

package/esm/BarChart/getRadius.d.ts

@@ -1,20 +0,0 @@
-export type GetRadiusData = {
-  hasNegative: boolean;
-  hasPositive: boolean;
-  borderRadius?: number;
-  layout?: 'vertical' | 'horizontal';
-};
-type GetRadiusCorner = 'top-left' | 'top-right' | 'bottom-right' | 'bottom-left';
-/**
- * Returns if the corner should have a radius or not based on the layout and the data.
- * @param {GetRadiusCorner} corner The corner to check.
- * @param {GetRadiusData} cornerData The data for the corner.
- * @returns {number} The radius for the corner.
- */
-export declare const getRadius: (corner: GetRadiusCorner, {
-  hasNegative,
-  hasPositive,
-  borderRadius,
-  layout
-}: GetRadiusData) => number;
-export {};

package/esm/BarChart/getRadius.js

@@ -1,30 +0,0 @@
-/**
- * Returns if the corner should have a radius or not based on the layout and the data.
- * @param {GetRadiusCorner} corner The corner to check.
- * @param {GetRadiusData} cornerData The data for the corner.
- * @returns {number} The radius for the corner.
- */
-export const getRadius = (corner, {
-  hasNegative,
-  hasPositive,
-  borderRadius,
-  layout
-}) => {
-  if (!borderRadius) {
-    return 0;
-  }
-  const isVertical = layout === 'vertical';
-  if (corner === 'top-left' && (isVertical && hasPositive || !isVertical && hasNegative)) {
-    return borderRadius;
-  }
-  if (corner === 'top-right' && (isVertical && hasPositive || !isVertical && hasPositive)) {
-    return borderRadius;
-  }
-  if (corner === 'bottom-right' && (isVertical && hasNegative || !isVertical && hasPositive)) {
-    return borderRadius;
-  }
-  if (corner === 'bottom-left' && (isVertical && hasNegative || !isVertical && hasNegative)) {
-    return borderRadius;
-  }
-  return 0;
-};