@mui/x-charts 8.17.0 → 8.18.0

package/BarChart/BarLabel/BarLabel.d.ts

@@ -26,8 +26,14 @@ export type BarLabelProps = Omit<React.SVGProps<SVGTextElement>, 'ref' | 'id' |
    * Height of the bar this label belongs to.
    */
   height: number;
+  /**
+   * The placement of the bar label.
+   * It controls whether the label is rendered in the center or outside the bar.
+   * @default 'center'
+   */
+  placement?: 'center' | 'outside';
 };
-declare function BarLabel(inProps: BarLabelProps): import("react/jsx-runtime").JSX.Element;
+declare function BarLabel(inProps: BarLabelProps): React.JSX.Element;
 declare namespace BarLabel {
   var propTypes: any;
 }

package/BarChart/BarLabel/BarLabel.js

@@ -16,7 +16,7 @@ var _propTypes = _interopRequireDefault(require("prop-types"));
 var _useAnimateBarLabel = require("../../hooks/animation/useAnimateBarLabel");
 var _barLabelClasses = require("./barLabelClasses");
 var _jsxRuntime = require("react/jsx-runtime");
-const _excluded = ["seriesId", "dataIndex", "color", "isFaded", "isHighlighted", "classes", "skipAnimation", "layout", "xOrigin", "yOrigin"];
+const _excluded = ["seriesId", "dataIndex", "color", "isFaded", "isHighlighted", "classes", "skipAnimation", "layout", "xOrigin", "yOrigin", "placement"];
 const BarLabelComponent = exports.BarLabelComponent = (0, _styles.styled)('text', {
   name: 'MuiBarLabel',
   slot: 'Root',
@@ -31,8 +31,6 @@ const BarLabelComponent = exports.BarLabelComponent = (0, _styles.styled)('text'
   stroke: 'none',
   fill: (theme.vars || theme)?.palette?.text?.primary,
   transition: 'opacity 0.2s ease-in, fill 0.2s ease-in',
-  textAnchor: 'middle',
-  dominantBaseline: 'central',
   pointerEvents: 'none',
   opacity: 1,
   [`&.${_barLabelClasses.barLabelClasses.faded}`]: {
@@ -46,7 +44,40 @@ function BarLabel(inProps) {
   });
   const otherProps = (0, _objectWithoutPropertiesLoose2.default)(props, _excluded);
   const animatedProps = (0, _useAnimateBarLabel.useAnimateBarLabel)(props);
-  return /*#__PURE__*/(0, _jsxRuntime.jsx)(BarLabelComponent, (0, _extends2.default)({}, otherProps, animatedProps));
+  const textAnchor = getTextAnchor(props);
+  const dominantBaseline = getDominantBaseline(props);
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(BarLabelComponent, (0, _extends2.default)({
+    textAnchor: textAnchor,
+    dominantBaseline: dominantBaseline
+  }, otherProps, animatedProps));
+}
+function getTextAnchor({
+  placement,
+  layout,
+  xOrigin,
+  x
+}) {
+  if (placement === 'outside') {
+    if (layout === 'horizontal') {
+      return x < xOrigin ? 'end' : 'start';
+    }
+    return 'middle';
+  }
+  return 'middle';
+}
+function getDominantBaseline({
+  placement,
+  layout,
+  yOrigin,
+  y
+}) {
+  if (placement === 'outside') {
+    if (layout === 'horizontal') {
+      return 'central';
+    }
+    return y < yOrigin ? 'auto' : 'hanging';
+  }
+  return 'central';
 }
 process.env.NODE_ENV !== "production" ? BarLabel.propTypes = {
   // ----------------------------- Warning --------------------------------
@@ -62,6 +93,12 @@ process.env.NODE_ENV !== "production" ? BarLabel.propTypes = {
   isFaded: _propTypes.default.bool.isRequired,
   isHighlighted: _propTypes.default.bool.isRequired,
   layout: _propTypes.default.oneOf(['horizontal', 'vertical']).isRequired,
+  /**
+   * The placement of the bar label.
+   * It controls whether the label is rendered in the center or outside the bar.
+   * @default 'center'
+   */
+  placement: _propTypes.default.oneOf(['center', 'outside']),
   seriesId: _propTypes.default.oneOfType([_propTypes.default.number, _propTypes.default.string]).isRequired,
   skipAnimation: _propTypes.default.bool.isRequired,
   /**

package/BarChart/BarLabel/BarLabelItem.d.ts

@@ -67,6 +67,12 @@ export type BarLabelItemProps = Omit<BarLabelOwnerState, 'isFaded' | 'isHighligh
    * @returns {string} The formatted label.
    */
   barLabel?: 'value' | ((item: BarItem, context: BarLabelContext) => string | null | undefined);
+  /**
+   * The placement of the bar label.
+   * It controls whether the label is rendered in the center or outside the bar.
+   * @default 'center'
+   */
+  barLabelPlacement?: BarLabelProps['placement'];
 };
 /**
  * @ignore - internal component.

package/BarChart/BarLabel/BarLabelItem.js

@@ -16,7 +16,7 @@ var _getBarLabel = require("./getBarLabel");
 var _BarLabel = require("./BarLabel");
 var _useItemHighlighted = require("../../hooks/useItemHighlighted");
 var _jsxRuntime = require("react/jsx-runtime");
-const _excluded = ["seriesId", "classes", "color", "dataIndex", "barLabel", "slots", "slotProps", "xOrigin", "yOrigin", "x", "y", "width", "height", "value", "skipAnimation", "layout"],
+const _excluded = ["seriesId", "classes", "color", "dataIndex", "barLabel", "slots", "slotProps", "xOrigin", "yOrigin", "x", "y", "width", "height", "value", "skipAnimation", "layout", "barLabelPlacement"],
   _excluded2 = ["ownerState"];
 /**
  * @ignore - internal component.
@@ -38,7 +38,8 @@ function BarLabelItem(props) {
       height,
       value,
       skipAnimation,
-      layout
+      layout,
+      barLabelPlacement
     } = props,
     other = (0, _objectWithoutPropertiesLoose2.default)(props, _excluded);
   const {
@@ -70,6 +71,7 @@ function BarLabelItem(props) {
         y,
         width,
         height,
+        placement: barLabelPlacement,
         className: classes.root
       }),
       ownerState

package/BarChart/BarLabel/BarLabelPlot.js

@@ -1,14 +1,12 @@
 "use strict";
 
 var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
-var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWildcard").default;
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.BarLabelPlot = BarLabelPlot;
 var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
 var _objectWithoutPropertiesLoose2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutPropertiesLoose"));
-var React = _interopRequireWildcard(require("react"));
 var _BarLabelItem = require("./BarLabelItem");
 var _barClasses = require("../barClasses");
 var _jsxRuntime = require("react/jsx-runtime");
@@ -59,7 +57,8 @@ function BarLabelPlot(props) {
       skipAnimation: skipAnimation ?? false,
       layout: layout ?? 'vertical'
     }, other, {
-      barLabel: barLabel
+      barLabel: barLabel,
+      barLabelPlacement: processedSeries.barLabelPlacement || 'center'
     }), dataIndex))
   }, seriesId);
 }

package/BarChart/BarPlot.js

@@ -162,6 +162,11 @@ process.env.NODE_ENV !== "production" ? BarPlot.propTypes = {
    * @returns {string} The formatted label.
    */
   barLabel: _propTypes.default.oneOfType([_propTypes.default.oneOf(['value']), _propTypes.default.func]),
+  /**
+   * The placement of the bar label.
+   * It controls whether the label is rendered inside or outside the bar.
+   */
+  barLabelPlacement: _propTypes.default.oneOf(['outside', 'inside']),
   /**
    * Defines the border radius of the bar element.
    */

package/BarChart/types.d.ts

@@ -13,6 +13,7 @@ export interface ProcessedBarSeriesData {
   seriesId: SeriesId;
   data: ProcessedBarData[];
   barLabel?: BarSeriesType['barLabel'];
+  barLabelPlacement?: BarSeriesType['barLabelPlacement'];
 }
 export interface ProcessedBarData extends AnimationData {
   seriesId: SeriesId;

package/BarChart/useBarPlotData.js

@@ -63,8 +63,8 @@ function useBarPlotData(drawingArea, xAxes, yAxes) {
           seriesId,
           dataIndex,
           layout: series[seriesId].layout,
-          xOrigin: xScale(0) ?? 0,
-          yOrigin: yScale(0) ?? 0
+          xOrigin: Math.round(xScale(0) ?? 0),
+          yOrigin: Math.round(yScale(0) ?? 0)
         }, barDimensions, {
           color: colorGetter(dataIndex),
           value: series[seriesId].data[dataIndex],
@@ -100,6 +100,7 @@ function useBarPlotData(drawingArea, xAxes, yAxes) {
       return {
         seriesId,
         barLabel: series[seriesId].barLabel,
+        barLabelPlacement: series[seriesId].barLabelPlacement,
         data: seriesDataPoints
       };
     });

package/CHANGELOG.md

@@ -5,6 +5,106 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## 8.18.0
+
+<!-- generated comparing v8.17.0..master -->
+
+_Nov 13, 2025_
+
+We'd like to extend a big thank you to the 14 contributors who made this release possible. Here are some highlights ✨:
+
+- Add `barLabelPlacement` property to customize the bar label position in bar charts, enabling labels to be placed above bars.
+
+  ![image](https://github.com/user-attachments/assets/4bc3a75b-74b8-4c6d-896b-5f5bf837bcda)
+
+- Add `source` property to the date/time picker lifecycle and event handler context, enabling clearer differentiation between changes initiated by the picker UI and those from direct field input.
+- 🐞 Bugfixes
+- 📚 Documentation improvements
+
+Special thanks go out to these community members for their valuable contributions:
+@htollefsen, @sai6855, @Sigdriv
+
+The following team members contributed to this release:
+@arminmeh, @bernardobelchior, @brijeshb42, @cherniavskii, @flaviendelangle, @JCQuintas, @michelengelen, @noraleonte, @prakhargupta1, @rita-codes, @siriwatknp
+
+### Data Grid
+
+#### `@mui/x-data-grid@8.18.0`
+
+- [DataGrid] Allow default event in the column action cell item click event handler (#20272) @arminmeh
+- [DataGrid] Remove unnecessary generic from `useGridApiRef` (#20277) @cherniavskii
+
+#### `@mui/x-data-grid-pro@8.18.0` [![pro](https://mui.com/r/x-pro-svg)](https://mui.com/r/x-pro-svg-link 'Pro plan')
+
+Same changes as in `@mui/x-data-grid@8.18.0`.
+
+#### `@mui/x-data-grid-premium@8.18.0` [![premium](https://mui.com/r/x-premium-svg)](https://mui.com/r/x-premium-svg-link 'Premium plan')
+
+Same changes as in `@mui/x-data-grid-pro@8.18.0`, plus:
+
+- [DataGridPremium] Return the correct `cellParams` value from the aggregation cells (#20224) @arminmeh
+
+### Date and Time Pickers
+
+#### `@mui/x-date-pickers@8.18.0`
+
+- [pickers] Keep invalid date state consistent (#20040) @michelengelen
+- [pickers] Adds new `source` property to `onChange` and `onAccept` context object (#20234) @michelengelen
+
+#### `@mui/x-date-pickers-pro@8.18.0` [![pro](https://mui.com/r/x-pro-svg)](https://mui.com/r/x-pro-svg-link 'Pro plan')
+
+Same changes as in `@mui/x-date-pickers@8.18.0`.
+
+### Charts
+
+#### `@mui/x-charts@8.18.0`
+
+- [charts] Add prop for positioning a bar label (#20194) @Sigdriv
+- [charts] Fix applying dark mode styles in `ChartAxisZoomSliderThumb` (#20232) @sai6855
+
+#### `@mui/x-charts-pro@8.18.0` [![pro](https://mui.com/r/x-pro-svg)](https://mui.com/r/x-pro-svg-link 'Pro plan')
+
+Same changes as in `@mui/x-charts@8.18.0`, plus:
+
+- [charts-pro] Allow specifying Content Security Policy nonce on export (#20053) @bernardobelchior
+- [charts-pro] Fix applying dark mode styles to slider (#20220) @sai6855
+- [charts-pro] Sankey should respect node order (#20065) @JCQuintas
+
+#### `@mui/x-charts-premium@8.18.0` [![premium](https://mui.com/r/x-premium-svg)](https://mui.com/r/x-premium-svg-link 'Premium plan')
+
+Same changes as in `@mui/x-charts-pro@8.18.0`.
+
+### Tree View
+
+#### `@mui/x-tree-view@8.18.0`
+
+- [tree view] Prepare tests for the new store structure (#20225) @flaviendelangle
+- [tree view] Prepare the item plugin files for the store migration (#20240) @flaviendelangle
+- [tree view] Use `TreeItemId` type instead of raw string (#20233) @flaviendelangle
+
+#### `@mui/x-tree-view-pro@8.18.0` [![pro](https://mui.com/r/x-pro-svg)](https://mui.com/r/x-pro-svg-link 'Pro plan')
+
+Same changes as in `@mui/x-tree-view@8.18.0`.
+
+### Codemod
+
+#### `@mui/x-codemod@8.18.0`
+
+Internal changes.
+
+### Docs
+
+- [charts] Add a demo for a custom tick label (#20073) @prakhargupta1
+- [charts] Create `useAxes()` hook documentation page (#20229) @JCQuintas
+- [charts] Fix logo alignment (#20228) @JCQuintas
+- [charts] Fixes typo in import example (#20236) @htollefsen
+- [Data Grid] Add recipe for cursor pagination with data source (#19700) @siriwatknp
+- [Data Grid] Add a demo for pinned rows aggregation (#20198) @cherniavskii
+
+### Core
+
+- [docs-infra] Use deployment config from docs-infra package (#20243) @brijeshb42
+
 ## 8.17.0
 
 _Nov 5, 2025_

package/esm/BarChart/BarLabel/BarLabel.d.ts

@@ -26,8 +26,14 @@ export type BarLabelProps = Omit<React.SVGProps<SVGTextElement>, 'ref' | 'id' |
    * Height of the bar this label belongs to.
    */
   height: number;
+  /**
+   * The placement of the bar label.
+   * It controls whether the label is rendered in the center or outside the bar.
+   * @default 'center'
+   */
+  placement?: 'center' | 'outside';
 };
-declare function BarLabel(inProps: BarLabelProps): import("react/jsx-runtime").JSX.Element;
+declare function BarLabel(inProps: BarLabelProps): React.JSX.Element;
 declare namespace BarLabel {
   var propTypes: any;
 }

package/esm/BarChart/BarLabel/BarLabel.js

@@ -2,7 +2,7 @@
 
 import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
 import _extends from "@babel/runtime/helpers/esm/extends";
-const _excluded = ["seriesId", "dataIndex", "color", "isFaded", "isHighlighted", "classes", "skipAnimation", "layout", "xOrigin", "yOrigin"];
+const _excluded = ["seriesId", "dataIndex", "color", "isFaded", "isHighlighted", "classes", "skipAnimation", "layout", "xOrigin", "yOrigin", "placement"];
 import * as React from 'react';
 import { styled, useThemeProps } from '@mui/material/styles';
 import PropTypes from 'prop-types';
@@ -23,8 +23,6 @@ export const BarLabelComponent = styled('text', {
   stroke: 'none',
   fill: (theme.vars || theme)?.palette?.text?.primary,
   transition: 'opacity 0.2s ease-in, fill 0.2s ease-in',
-  textAnchor: 'middle',
-  dominantBaseline: 'central',
   pointerEvents: 'none',
   opacity: 1,
   [`&.${barLabelClasses.faded}`]: {
@@ -38,7 +36,40 @@ function BarLabel(inProps) {
   });
   const otherProps = _objectWithoutPropertiesLoose(props, _excluded);
   const animatedProps = useAnimateBarLabel(props);
-  return /*#__PURE__*/_jsx(BarLabelComponent, _extends({}, otherProps, animatedProps));
+  const textAnchor = getTextAnchor(props);
+  const dominantBaseline = getDominantBaseline(props);
+  return /*#__PURE__*/_jsx(BarLabelComponent, _extends({
+    textAnchor: textAnchor,
+    dominantBaseline: dominantBaseline
+  }, otherProps, animatedProps));
+}
+function getTextAnchor({
+  placement,
+  layout,
+  xOrigin,
+  x
+}) {
+  if (placement === 'outside') {
+    if (layout === 'horizontal') {
+      return x < xOrigin ? 'end' : 'start';
+    }
+    return 'middle';
+  }
+  return 'middle';
+}
+function getDominantBaseline({
+  placement,
+  layout,
+  yOrigin,
+  y
+}) {
+  if (placement === 'outside') {
+    if (layout === 'horizontal') {
+      return 'central';
+    }
+    return y < yOrigin ? 'auto' : 'hanging';
+  }
+  return 'central';
 }
 process.env.NODE_ENV !== "production" ? BarLabel.propTypes = {
   // ----------------------------- Warning --------------------------------
@@ -54,6 +85,12 @@ process.env.NODE_ENV !== "production" ? BarLabel.propTypes = {
   isFaded: PropTypes.bool.isRequired,
   isHighlighted: PropTypes.bool.isRequired,
   layout: PropTypes.oneOf(['horizontal', 'vertical']).isRequired,
+  /**
+   * The placement of the bar label.
+   * It controls whether the label is rendered in the center or outside the bar.
+   * @default 'center'
+   */
+  placement: PropTypes.oneOf(['center', 'outside']),
   seriesId: PropTypes.oneOfType([PropTypes.number, PropTypes.string]).isRequired,
   skipAnimation: PropTypes.bool.isRequired,
   /**

package/esm/BarChart/BarLabel/BarLabelItem.d.ts

@@ -67,6 +67,12 @@ export type BarLabelItemProps = Omit<BarLabelOwnerState, 'isFaded' | 'isHighligh
    * @returns {string} The formatted label.
    */
   barLabel?: 'value' | ((item: BarItem, context: BarLabelContext) => string | null | undefined);
+  /**
+   * The placement of the bar label.
+   * It controls whether the label is rendered in the center or outside the bar.
+   * @default 'center'
+   */
+  barLabelPlacement?: BarLabelProps['placement'];
 };
 /**
  * @ignore - internal component.

package/esm/BarChart/BarLabel/BarLabelItem.js

@@ -1,6 +1,6 @@
 import _extends from "@babel/runtime/helpers/esm/extends";
 import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
-const _excluded = ["seriesId", "classes", "color", "dataIndex", "barLabel", "slots", "slotProps", "xOrigin", "yOrigin", "x", "y", "width", "height", "value", "skipAnimation", "layout"],
+const _excluded = ["seriesId", "classes", "color", "dataIndex", "barLabel", "slots", "slotProps", "xOrigin", "yOrigin", "x", "y", "width", "height", "value", "skipAnimation", "layout", "barLabelPlacement"],
   _excluded2 = ["ownerState"];
 import * as React from 'react';
 import useSlotProps from '@mui/utils/useSlotProps';
@@ -30,7 +30,8 @@ function BarLabelItem(props) {
       height,
       value,
       skipAnimation,
-      layout
+      layout,
+      barLabelPlacement
     } = props,
     other = _objectWithoutPropertiesLoose(props, _excluded);
   const {
@@ -62,6 +63,7 @@ function BarLabelItem(props) {
         y,
         width,
         height,
+        placement: barLabelPlacement,
         className: classes.root
       }),
       ownerState

package/esm/BarChart/BarLabel/BarLabelPlot.js

@@ -1,7 +1,6 @@
 import _extends from "@babel/runtime/helpers/esm/extends";
 import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
 const _excluded = ["processedSeries", "skipAnimation"];
-import * as React from 'react';
 import { BarLabelItem } from "./BarLabelItem.js";
 import { useUtilityClasses } from "../barClasses.js";
 import { jsx as _jsx } from "react/jsx-runtime";
@@ -51,7 +50,8 @@ function BarLabelPlot(props) {
       skipAnimation: skipAnimation ?? false,
       layout: layout ?? 'vertical'
     }, other, {
-      barLabel: barLabel
+      barLabel: barLabel,
+      barLabelPlacement: processedSeries.barLabelPlacement || 'center'
     }), dataIndex))
   }, seriesId);
 }

package/esm/BarChart/BarPlot.js

@@ -155,6 +155,11 @@ process.env.NODE_ENV !== "production" ? BarPlot.propTypes = {
    * @returns {string} The formatted label.
    */
   barLabel: PropTypes.oneOfType([PropTypes.oneOf(['value']), PropTypes.func]),
+  /**
+   * The placement of the bar label.
+   * It controls whether the label is rendered inside or outside the bar.
+   */
+  barLabelPlacement: PropTypes.oneOf(['outside', 'inside']),
   /**
    * Defines the border radius of the bar element.
    */

package/esm/BarChart/types.d.ts

@@ -13,6 +13,7 @@ export interface ProcessedBarSeriesData {
   seriesId: SeriesId;
   data: ProcessedBarData[];
   barLabel?: BarSeriesType['barLabel'];
+  barLabelPlacement?: BarSeriesType['barLabelPlacement'];
 }
 export interface ProcessedBarData extends AnimationData {
   seriesId: SeriesId;

package/esm/BarChart/useBarPlotData.js

@@ -55,8 +55,8 @@ export function useBarPlotData(drawingArea, xAxes, yAxes) {
           seriesId,
           dataIndex,
           layout: series[seriesId].layout,
-          xOrigin: xScale(0) ?? 0,
-          yOrigin: yScale(0) ?? 0
+          xOrigin: Math.round(xScale(0) ?? 0),
+          yOrigin: Math.round(yScale(0) ?? 0)
         }, barDimensions, {
           color: colorGetter(dataIndex),
           value: series[seriesId].data[dataIndex],
@@ -92,6 +92,7 @@ export function useBarPlotData(drawingArea, xAxes, yAxes) {
       return {
         seriesId,
         barLabel: series[seriesId].barLabel,
+        barLabelPlacement: series[seriesId].barLabelPlacement,
         data: seriesDataPoints
       };
     });

package/esm/hooks/animation/useAnimateBarLabel.d.ts

@@ -1,6 +1,6 @@
 import * as React from 'react';
 import type { BarLabelProps } from "../../BarChart/index.js";
-type UseAnimateBarLabelParams = Pick<BarLabelProps, 'xOrigin' | 'yOrigin' | 'x' | 'y' | 'width' | 'height' | 'layout' | 'skipAnimation'> & {
+type UseAnimateBarLabelParams = Pick<BarLabelProps, 'xOrigin' | 'yOrigin' | 'x' | 'y' | 'width' | 'height' | 'layout' | 'skipAnimation' | 'placement'> & {
   ref?: React.Ref<SVGTextElement>;
 };
 type UseAnimateBarLabelReturn = {

package/esm/hooks/animation/useAnimateBarLabel.js

@@ -5,14 +5,12 @@ function barLabelPropsInterpolator(from, to) {
   const interpolateY = interpolateNumber(from.y, to.y);
   const interpolateWidth = interpolateNumber(from.width, to.width);
   const interpolateHeight = interpolateNumber(from.height, to.height);
-  return t => {
-    return {
-      x: interpolateX(t),
-      y: interpolateY(t),
-      width: interpolateWidth(t),
-      height: interpolateHeight(t)
-    };
-  };
+  return t => ({
+    x: interpolateX(t),
+    y: interpolateY(t),
+    width: interpolateWidth(t),
+    height: interpolateHeight(t)
+  });
 }
 
 /**
@@ -25,15 +23,21 @@ function barLabelPropsInterpolator(from, to) {
  * pass the ref returned by this hook to the `path` element and the `ref` provided as argument will also be called.
  */
 export function useAnimateBarLabel(props) {
+  const {
+    initialX,
+    currentX,
+    initialY,
+    currentY
+  } = props.placement === 'outside' ? getOutsidePlacement(props) : getCenterPlacement(props);
   const initialProps = {
-    x: props.layout === 'vertical' ? props.x + props.width / 2 : props.xOrigin,
-    y: props.layout === 'vertical' ? props.yOrigin : props.y + props.height / 2,
+    x: initialX,
+    y: initialY,
     width: props.width,
     height: props.height
   };
   const currentProps = {
-    x: props.x + props.width / 2,
-    y: props.y + props.height / 2,
+    x: currentX,
+    y: currentY,
     width: props.width,
     height: props.height
   };
@@ -50,4 +54,49 @@ export function useAnimateBarLabel(props) {
     skip: props.skipAnimation,
     ref: props.ref
   });
+}
+const LABEL_OFFSET = 4;
+function getCenterPlacement(props) {
+  return {
+    initialX: props.layout === 'vertical' ? props.x + props.width / 2 : props.xOrigin,
+    initialY: props.layout === 'vertical' ? props.yOrigin : props.y + props.height / 2,
+    currentX: props.x + props.width / 2,
+    currentY: props.y + props.height / 2
+  };
+}
+function getOutsidePlacement(props) {
+  let initialY = 0;
+  let currentY = 0;
+  let initialX = 0;
+  let currentX = 0;
+  if (props.layout === 'vertical') {
+    const shouldPlaceAbove = props.y < props.yOrigin;
+    if (shouldPlaceAbove) {
+      initialY = props.yOrigin - LABEL_OFFSET;
+      currentY = props.y - LABEL_OFFSET;
+    } else {
+      initialY = props.yOrigin + LABEL_OFFSET;
+      currentY = props.y + props.height + LABEL_OFFSET;
+    }
+    return {
+      initialX: props.x + props.width / 2,
+      currentX: props.x + props.width / 2,
+      initialY,
+      currentY
+    };
+  }
+  const shouldPlaceToTheLeft = props.x < props.xOrigin;
+  if (shouldPlaceToTheLeft) {
+    initialX = props.xOrigin;
+    currentX = props.x - LABEL_OFFSET;
+  } else {
+    initialX = props.xOrigin;
+    currentX = props.x + props.width + LABEL_OFFSET;
+  }
+  return {
+    initialX,
+    currentX,
+    initialY: props.y + props.height / 2,
+    currentY: props.y + props.height / 2
+  };
 }