@atlaskit/top-layer 1.10.1 → 3.0.0

package/dist/esm/dialog/dialog-content.js

@@ -1,7 +1,8 @@
-/* dialog-content.tsx generated by @compiled/babel-plugin v0.40.0 */
+/* dialog-content.tsx generated by @compiled/babel-plugin v2.0.0 */
 import "./dialog-content.compiled.css";
 import { ax, ix } from "@compiled/react/runtime";
 import React, { forwardRef, useCallback, useEffect, useId, useLayoutEffect, useRef } from 'react';
+import { cx } from '@compiled/react';
 import { bind } from 'bind-event-listener';
 import mergeRefs from '@atlaskit/ds-lib/merge-refs';
 import noop from '@atlaskit/ds-lib/noop';
@@ -9,15 +10,6 @@ import { useNotifyOpenLayerObserver } from '@atlaskit/layering/use-notify-open-l
 import { useAnimatedVisibility } from '../internal/use-animated-visibility';
 import { useFocusWrap } from '../internal/use-focus-wrap';
 import { useSafariEscapeFix } from '../internal/use-safari-escape-fix';
-// These animation styles use the non-strict Compiled cssMap because they rely
-// on `@starting-style`, `[open]`, and `allow-discrete`. Keep them in this
-// component so the Compiled transform can statically extract every referenced
-// style.
-var dialogAnimationStyles = {
-  root: "_k8m011k7 _1oeci9qs _1s9z1a5r _1fsl1mzy _1oil1d08",
-  motion: "_y44vgeqi _1o51q7pw _1iu47kvq _1i0neoah"
-};
-
 // Surface reset — see the rationale on `surfaceResetStyles` in `popover/popover.tsx`.
 // Neutralises inherited text-layout properties (e.g. `white-space: nowrap`) that leak
 // into the top-layer surface. Excludes `color`/`font` (theming) and
@@ -30,13 +22,17 @@ var dialogAnimationStyles = {
 var surfaceResetStyles = {
   root: "_o5724jg8 _1nmz4jg8 _1i4q4jg8 _y3gnv2br _azhwidpf _1p1dglyw"
 };
-var styles = {
-  dialog: "_19itglyw _19pk1wug _2hwx1wug _otyr1wug _18u01wug _1q51ze3t _y4tize3t _85i5ze3t _bozgze3t _p12fglyw _c71lglyw _bfhk1j28 _bl8aglyw _156y147i _10aiglyw _aeld147i"
+var dialogStyles = {
+  root: "_19itglyw _19pk1wug _2hwx1wug _otyr1wug _18u01wug _1q51ze3t _y4tize3t _85i5ze3t _bozgze3t _p12fglyw _c71lglyw _bfhk1j28",
+  motion: "_k8m011k7 _1oeci9qs _1s9z1a5r _1o511hrf _bl8aglyw _156y147i",
+  enter: "_y44v7kvq",
+  exit: "_y44vgeqi"
 };
 var backdropStyles = {
   root: "_1ltk1i5c",
   hidden: "_1ltk1j28",
-  motion: "_1m5e1op4 _1jhdq7pw _njwk11k7 _yhpqi9qs _1fyf1a5r _vhgsxbuz _1rsueoah _l57nglyw _1sbq147i _19awglyw _1i6z147i"
+  enter: "_1m5exbuz",
+  exit: "_1m5e1op4"
 };
 
 /**
@@ -62,9 +58,11 @@ export var Dialog = /*#__PURE__*/forwardRef(function Dialog(_ref, ref) {
     onClose = _ref.onClose,
     onEnterFinish = _ref.onEnterFinish,
     onExitFinish = _ref.onExitFinish,
-    _ref$animate = _ref.animate,
-    animate = _ref$animate === void 0 ? false : _ref$animate,
+    _ref$shouldAnimate = _ref.shouldAnimate,
+    shouldAnimate = _ref$shouldAnimate === void 0 ? false : _ref$shouldAnimate,
     consumerXcss = _ref.xcss,
+    enteringAnimationXcss = _ref.enteringAnimationXcss,
+    exitingAnimationXcss = _ref.exitingAnimationXcss,
     style = _ref.style,
     testId = _ref.testId,
     providedId = _ref.id,
@@ -78,13 +76,12 @@ export var Dialog = /*#__PURE__*/forwardRef(function Dialog(_ref, ref) {
   var _useAnimatedVisibilit = useAnimatedVisibility({
       isOpen: isOpen,
       animationKind: 'dialog',
-      animate: animate,
+      shouldAnimate: shouldAnimate,
       elementRef: ownRef,
       onEnterFinish: onEnterFinish,
       onExitFinish: onExitFinish
     }),
-    phase = _useAnimatedVisibilit.phase,
-    preset = _useAnimatedVisibilit.preset;
+    phase = _useAnimatedVisibilit.phase;
 
   // True while the host element is mounted (any phase except `closed`).
   // Used as a dep so listener-rebind effects re-attach after a remount.
@@ -189,6 +186,7 @@ export var Dialog = /*#__PURE__*/forwardRef(function Dialog(_ref, ref) {
   if (!isVisible) {
     return null;
   }
+  var shouldAnimateBackdrop = !shouldHideBackdrop && shouldAnimate;
   return /*#__PURE__*/React.createElement("dialog", {
     ref: combinedRef,
     id: dialogId
@@ -202,7 +200,11 @@ export var Dialog = /*#__PURE__*/forwardRef(function Dialog(_ref, ref) {
     "aria-labelledby": label ? undefined : labelledBy,
     style: style,
     onCancel: handleCancel,
-    "data-testid": testId,
-    className: ax([styles.dialog, surfaceResetStyles.root, shouldHideBackdrop ? backdropStyles.hidden : backdropStyles.root, preset && backdropStyles.motion, preset && dialogAnimationStyles.root, preset && dialogAnimationStyles.motion, consumerXcss])
+    "data-testid": testId
+    // eslint-disable-next-line @atlaskit/ui-styling-standard/no-classname-prop, @atlaskit/ui-styling-standard/local-cx-xcss, @compiled/local-cx-xcss
+    ,
+    className: ax([
+    // Dialog styles
+    dialogStyles.root, surfaceResetStyles.root, shouldAnimate && phase === 'entering' && dialogStyles.enter, shouldAnimate && phase === 'exiting' && dialogStyles.exit, shouldAnimate && dialogStyles.motion, shouldHideBackdrop ? backdropStyles.hidden : backdropStyles.root, shouldAnimateBackdrop && phase === 'entering' && backdropStyles.enter, shouldAnimateBackdrop && phase === 'exiting' && backdropStyles.exit, cx(consumerXcss, shouldAnimate && phase === 'entering' && enteringAnimationXcss, shouldAnimate && phase === 'exiting' && exitingAnimationXcss)])
   }, children);
 });

package/dist/esm/internal/placement-to-position-area.js

@@ -1,4 +1,4 @@
-import { getPlacement } from './resolve-placement';
+import { resolvePlacement } from './resolve-placement';
 
 /**
  * Resolves placement options to CSS `position-area` syntax.
@@ -19,12 +19,12 @@ import { getPlacement } from './resolve-placement';
  */
 export function placementToPositionArea(_ref) {
   var placement = _ref.placement;
-  var _getPlacement = getPlacement({
+  var _resolvePlacement = resolvePlacement({
       placement: placement
     }),
-    axis = _getPlacement.axis,
-    edge = _getPlacement.edge,
-    align = _getPlacement.align;
+    axis = _resolvePlacement.axis,
+    edge = _resolvePlacement.edge,
+    align = _resolvePlacement.align;
   var edgeValue = "".concat(axis, "-").concat(edge);
   if (align === 'center') {
     return edgeValue;

package/dist/esm/internal/placement-to-try-fallbacks.js

@@ -1,4 +1,4 @@
-import { getPlacement } from './resolve-placement';
+import { resolvePlacement } from './resolve-placement';
 
 /**
  * A `position-area` primary edge — the placement axis joined to its edge, e.g.
@@ -44,7 +44,7 @@ export function placementToTryFallbacks(_ref3) {
    * The browser tries them _in order_ and uses the _first_ one that fits.
    */
 
-  var resolved = getPlacement({
+  var resolved = resolvePlacement({
     placement: placement
   });
   var axis = resolved.axis,

package/dist/esm/internal/resolve-css-length-to-pixels.js

@@ -58,7 +58,7 @@ export function resolveCssLengthToPixels(_ref3) {
   }
 
   // Fast path: bare `${n}px` strings come from the consumer normalisation
-  // in `getPlacement`. Avoid a reflow when we can.
+  // in `resolvePlacement`. Avoid a reflow when we can.
   var pxMatch = value.match(/^(-?\d+(?:\.\d+)?)px$/);
   if (pxMatch) {
     return Number(pxMatch[1]);

package/dist/esm/internal/resolve-placement.js

@@ -14,7 +14,7 @@ var DEFAULT_GAP = "var(--ds-space-100, 8px)";
  */
 
 /**
- * Fully-resolved placement (internal). Use `getPlacement` for partial input.
+ * Fully-resolved placement (internal). Use `resolvePlacement` for partial input.
  * `offset.gap` and `offset.crossAxisShift.value` are always CSS
  * length strings.
  */
@@ -37,7 +37,7 @@ var DEFAULT_GAP = "var(--ds-space-100, 8px)";
  * `offset.gap: token('space.100', '8px')`,
  * `offset.crossAxisShift: { value: '0px', direction: 'forwards' }`.
  */
-export function getPlacement(_ref) {
+export function resolvePlacement(_ref) {
   var _placement$offset, _placement$axis, _placement$edge, _placement$align, _placement$offset$cro, _placement$offset2, _placement$offset$cro2, _placement$offset3;
   var placement = _ref.placement;
   var consumerGap = (_placement$offset = placement.offset) === null || _placement$offset === void 0 ? void 0 : _placement$offset.gap;

package/dist/esm/internal/use-anchor-position.js

@@ -23,10 +23,10 @@ import { combine } from './combine';
 import { placementToPositionArea } from './placement-to-position-area';
 import { placementToTryFallbacks } from './placement-to-try-fallbacks';
 import { resolveCssLengthToPixels } from './resolve-css-length-to-pixels';
-import { getPlacement } from './resolve-placement';
+import { resolvePlacement } from './resolve-placement';
 import { setStyle } from './set-style';
 
-// `getPlacement` is intentionally NOT re-exported here - import it directly
+// `resolvePlacement` is intentionally NOT re-exported here - import it directly
 // from `./resolve-placement` so search-and-jump lands at the source of truth.
 
 /**
@@ -150,7 +150,7 @@ function crossAxisShiftMargin(_ref2) {
  * (or undefined fields vs explicit defaults) does not produce a fresh result.
  */
 function useStablePlacement(placement) {
-  var resolved = getPlacement({
+  var resolved = resolvePlacement({
     placement: placement
   });
   var axis = resolved.axis;

package/dist/esm/internal/use-animated-visibility.js

@@ -60,13 +60,6 @@ function runOnTransitionEndOrTimeout(_ref) {
   return teardown;
 }
 
-/**
- * Animation config for entry/exit transitions.
- *
- * Currently no configuration is supported via this prop,
- * and this is just a placeholder.
- */
-
 /**
  * Visibility lifecycle phase shared between `useAnimatedVisibility`,
  * `useFocusWrap`, `useInitialFocus`, and the `Popover` / `Dialog`
@@ -131,17 +124,11 @@ function runOnTransitionEndOrTimeout(_ref) {
 export function useAnimatedVisibility(_ref2) {
   var isOpen = _ref2.isOpen,
     animationKind = _ref2.animationKind,
-    animate = _ref2.animate,
+    shouldAnimate = _ref2.shouldAnimate,
     elementRef = _ref2.elementRef,
     onEnterFinish = _ref2.onEnterFinish,
     onExitFinish = _ref2.onExitFinish;
-  // Styles are applied via the `css` prop on the host element (see `Popover`
-  // and `Dialog`), so there is no longer any CSS injection step. Normalize a
-  // falsy `animate` to `null`.
-  var preset = animate || null;
-
-  // False when there is no preset or `prefers-reduced-motion` is set.
-  var willAnimate = Boolean(animate) && !prefersReducedMotion();
+  var willAnimate = shouldAnimate && !prefersReducedMotion();
 
   // Promote `closed → entering`/`closed → open` synchronously during
   // render so the host element mounts in the same commit as the open
@@ -310,7 +297,6 @@ export function useAnimatedVisibility(_ref2) {
     }
   }, [phase, willAnimate]);
   return {
-    phase: phase,
-    preset: preset
+    phase: phase
   };
 }

package/dist/esm/popover/popover.compiled.css

@@ -1,32 +1,26 @@
-._15ns179n:popover-open{animation:var(--ds-popover-motion-enter)}
 ._19itglyw{border:none}
 ._1r041wug{inset:auto}
-._y44vof1f{animation:var(--ds-popover-motion-exit)}._12t71ign:popover-open{transition-duration:var(--ds-duration-short,.15s)}
-._18m9ewfl{overflow-y:visible}
+._y44v179n{animation:var(--ds-popover-motion-enter)}
+._y44vof1f{animation:var(--ds-popover-motion-exit)}._18m9ewfl{overflow-y:visible}
 ._18u0idpf{margin-left:0}
 ._19bvidpf{padding-left:0}
 ._19pkidpf{margin-top:0}
 ._1i4q4jg8{overflow-wrap:normal}
 ._1nmz4jg8{word-break:normal}
-._1o51q7pw{animation-fill-mode:forwards}
+._1o511hrf{animation-fill-mode:both}
 ._1oecdn4k{transition-duration:var(--ds-duration-xshort,.1s)}
 ._1p1dglyw{text-transform:none}
-._1pgl1lbj{animation-timing-function:var(--ds-easing-in-practical,cubic-bezier(.6,0,.8,.6))}
-._1psg1ign:popover-open{animation-duration:var(--ds-duration-short,.15s)}
 ._1reoewfl{overflow-x:visible}
 ._1s9z1a5r{transition-behavior:allow-discrete}
 ._2hwxidpf{margin-right:0}
 ._4t3i1wug{height:auto}
-._5sagdn4k{animation-duration:var(--ds-duration-xshort,.1s)}
 ._azhwidpf{text-indent:0}
 ._bfhk1j28{background-color:transparent}
 ._ca0qidpf{padding-top:0}
 ._k8m011k7{transition-property:overlay,display}
 ._n3tdidpf{padding-bottom:0}
-._n70peoah:popover-open{animation-fill-mode:backwards}
 ._o5724jg8{white-space:normal}
-._o8i7indk:popover-open{animation-timing-function:var(--ds-easing-out-practical,cubic-bezier(.4,1,.6,1))}
 ._otyridpf{margin-bottom:0}
 ._u5f3idpf{padding-right:0}
 ._y3gnv2br{text-align:start}
-@media (prefers-reduced-motion:reduce){._bl8aglyw{animation-name:none}._156yru3m{transition-duration:0s}._8rmvglyw:popover-open{animation-name:none}._2qm2ru3m:popover-open{transition-duration:0s}}
+@media (prefers-reduced-motion:reduce){._bl8aglyw{animation-name:none}._156y147i{transition-duration:var(--ds-duration-instant,0ms)}}

package/dist/esm/popover/popover.js

@@ -1,17 +1,17 @@
-/* popover.tsx generated by @compiled/babel-plugin v0.40.0 */
+/* popover.tsx generated by @compiled/babel-plugin v2.0.0 */
 import "./popover.compiled.css";
 import { ax, ix } from "@compiled/react/runtime";
-import React, { forwardRef, useCallback, useId, useLayoutEffect, useRef } from 'react';
+import React, { forwardRef, useCallback, useId, useLayoutEffect, useMemo, useRef } from 'react';
+import { cx } from '@compiled/react';
 import { bind } from 'bind-event-listener';
 import mergeRefs from '@atlaskit/ds-lib/merge-refs';
 import once from '@atlaskit/ds-lib/once';
 import { useNotifyOpenLayerObserver } from '@atlaskit/layering/use-notify-open-layer-observer';
+import { resolvePlacement } from '../internal/resolve-placement';
 import { shouldFocusIntoPopover } from '../internal/role-types';
-import { setStyle } from '../internal/set-style';
 import { useAnimatedVisibility } from '../internal/use-animated-visibility';
 import { useFocusWrap } from '../internal/use-focus-wrap';
 import { useInitialFocus } from '../internal/use-initial-focus';
-import { getPopupMotionStyles } from './animations';
 /**
  * Detects `popover="hint"` support via DOM reflection. SSR-safe, cached.
  */
@@ -25,14 +25,6 @@ var supportsPopoverHint = once(function () {
   return element.popover === 'hint';
 });
 
-// These animation styles use the non-strict Compiled cssMap because they rely
-// on `@starting-style`, `:popover-open`, `[dir='rtl']`, and `allow-discrete`.
-// Keep them in this component so the Compiled transform can statically extract
-// every referenced style.
-var popoverAnimationStyles = {
-  root: "_y44vof1f _k8m011k7 _1oecdn4k _1s9z1a5r _1o51q7pw _5sagdn4k _1pgl1lbj _15ns179n _12t71ign _n70peoah _1psg1ign _o8i7indk _bl8aglyw _156yru3m _8rmvglyw _2qm2ru3m"
-};
-
 // Surface reset — neutralises inherited text-layout properties (e.g.
 // `white-space: nowrap` from an `@atlaskit/select` option) that leak into a
 // top-layer element because, for CSS inheritance, it is still a DOM child of its
@@ -48,7 +40,35 @@ var surfaceResetStyles = {
   root: "_o5724jg8 _1nmz4jg8 _1i4q4jg8 _y3gnv2br _azhwidpf _1p1dglyw"
 };
 var styles = {
-  root: "_19itglyw _ca0qidpf _u5f3idpf _n3tdidpf _19bvidpf _19pkidpf _2hwxidpf _otyridpf _18u0idpf _1r041wug _1reoewfl _18m9ewfl _bfhk1j28 _4t3i1wug"
+  root: "_19itglyw _ca0qidpf _u5f3idpf _n3tdidpf _19bvidpf _19pkidpf _2hwxidpf _otyridpf _18u0idpf _1r041wug _1reoewfl _18m9ewfl _bfhk1j28 _4t3i1wug",
+  motion: "_k8m011k7 _1oecdn4k _1s9z1a5r _1o511hrf _bl8aglyw _156y147i",
+  enter: "_y44v179n",
+  exit: "_y44vof1f"
+};
+
+// Intentionally using `Record<string, string>` instead of `React.CSSProperties`
+// to avoid type errors about the CSS variables not being valid property names
+var popupMotionStyles = {
+  block: {
+    start: {
+      '--ds-popover-motion-enter': "var(--ds-popup-enter-top, 150ms cubic-bezier(0.4, 1, 0.6, 1) SlideInTop8px, 150ms cubic-bezier(0.4, 1, 0.6, 1) FadeIn0to100)",
+      '--ds-popover-motion-exit': "var(--ds-popup-exit-top, 100ms cubic-bezier(0.6, 0, 0.8, 0.6) SlideOutTop8px, 100ms cubic-bezier(0.6, 0, 0.8, 0.6) FadeOut100to0)"
+    },
+    end: {
+      '--ds-popover-motion-enter': "var(--ds-popup-enter-bottom, 150ms cubic-bezier(0.4, 1, 0.6, 1) SlideInBottom8px, 150ms cubic-bezier(0.4, 1, 0.6, 1) FadeIn0to100)",
+      '--ds-popover-motion-exit': "var(--ds-popup-exit-bottom, 100ms cubic-bezier(0.6, 0, 0.8, 0.6) SlideOutBottom8px, 100ms cubic-bezier(0.6, 0, 0.8, 0.6) FadeOut100to0)"
+    }
+  },
+  inline: {
+    start: {
+      '--ds-popover-motion-enter': "var(--ds-popup-enter-left, 150ms cubic-bezier(0.4, 1, 0.6, 1) SlideInLeft8px, 150ms cubic-bezier(0.4, 1, 0.6, 1) FadeIn0to100)",
+      '--ds-popover-motion-exit': "var(--ds-popup-exit-left, 100ms cubic-bezier(0.6, 0, 0.8, 0.6) SlideOutLeft8px, 100ms cubic-bezier(0.6, 0, 0.8, 0.6) FadeOut100to0)"
+    },
+    end: {
+      '--ds-popover-motion-enter': "var(--ds-popup-enter-right, 150ms cubic-bezier(0.4, 1, 0.6, 1) SlideInRight8px, 150ms cubic-bezier(0.4, 1, 0.6, 1) FadeIn0to100)",
+      '--ds-popover-motion-exit': "var(--ds-popup-exit-right, 100ms cubic-bezier(0.6, 0, 0.8, 0.6) SlideOutRight8px, 100ms cubic-bezier(0.6, 0, 0.8, 0.6) FadeOut100to0)"
+    }
+  }
 };
 /**
  * Roles registered with the open layer observer as `popup`, so `closeLayers()`
@@ -93,15 +113,15 @@ export var Popover = /*#__PURE__*/forwardRef(function Popover(_ref, ref) {
     _ref$mode = _ref.mode,
     modeProp = _ref$mode === void 0 ? 'auto' : _ref$mode,
     onClose = _ref.onClose,
-    onOpenChange = _ref.onOpenChange,
     onEnterFinish = _ref.onEnterFinish,
     onExitFinish = _ref.onExitFinish,
-    _ref$animate = _ref.animate,
-    animate = _ref$animate === void 0 ? false : _ref$animate,
+    _ref$shouldAnimate = _ref.shouldAnimate,
+    shouldAnimate = _ref$shouldAnimate === void 0 ? false : _ref$shouldAnimate,
     placement = _ref.placement,
     testId = _ref.testId,
     isOpen = _ref.isOpen,
-    consumerXcss = _ref.xcss,
+    enteringAnimationXcss = _ref.enteringAnimationXcss,
+    exitingAnimationXcss = _ref.exitingAnimationXcss,
     role = _ref.role,
     label = _ref.label,
     labelledBy = _ref.labelledBy,
@@ -114,13 +134,12 @@ export var Popover = /*#__PURE__*/forwardRef(function Popover(_ref, ref) {
   var _useAnimatedVisibilit = useAnimatedVisibility({
       isOpen: isOpen,
       animationKind: 'popover',
-      animate: animate,
+      shouldAnimate: shouldAnimate,
       elementRef: ownRef,
       onEnterFinish: onEnterFinish,
       onExitFinish: onExitFinish
     }),
-    phase = _useAnimatedVisibilit.phase,
-    preset = _useAnimatedVisibilit.preset;
+    phase = _useAnimatedVisibilit.phase;
 
   // True while the host element is mounted (any phase except `closed`).
   // Used as a dep so listener-rebind effects re-attach after a remount.
@@ -161,6 +180,17 @@ export var Popover = /*#__PURE__*/forwardRef(function Popover(_ref, ref) {
   // will close other `auto` popovers when opened. Acceptable trade-off given
   // shrinking browser set without `hint` support.
   var mode = modeProp === 'hint' && !supportsPopoverHint() ? 'auto' : modeProp;
+  var popupMotionStyle = useMemo(function () {
+    if (!placement || !shouldAnimate) {
+      return undefined;
+    }
+    var _resolvePlacement = resolvePlacement({
+        placement: placement
+      }),
+      axis = _resolvePlacement.axis,
+      edge = _resolvePlacement.edge;
+    return popupMotionStyles[axis][edge];
+  }, [placement, shouldAnimate]);
 
   // Prevents toggle handler from calling onClose for our own hidePopover() calls.
   var programmaticCloseRef = useRef(false);
@@ -182,21 +212,10 @@ export var Popover = /*#__PURE__*/forwardRef(function Popover(_ref, ref) {
   var handleToggle = useCallback(function (event) {
     var element = ownRef.current;
     if (event.newState === 'open') {
-      if (element) {
-        onOpenChange === null || onOpenChange === void 0 || onOpenChange({
-          isOpen: true,
-          element: element
-        });
-      }
       return;
     }
     if (event.newState === 'closed') {
       if (element) {
-        onOpenChange === null || onOpenChange === void 0 || onOpenChange({
-          isOpen: false,
-          element: element
-        });
-
         // Nested-popover focus restoration fallback (browser only
         // restores outermost; Firefox skips nested entirely).
         // Restore only when the role moved focus in on open AND the
@@ -233,7 +252,7 @@ export var Popover = /*#__PURE__*/forwardRef(function Popover(_ref, ref) {
         reason: reason
       });
     }
-  }, [onClose, onOpenChange, role]);
+  }, [onClose, role]);
 
   // Bind via `useLayoutEffect`, and BEFORE the show/hide layout effect
   // below, so listeners are attached when `showPopover()` synchronously
@@ -275,23 +294,6 @@ export var Popover = /*#__PURE__*/forwardRef(function Popover(_ref, ref) {
     };
   }, [handleToggle, handleBeforeToggle, isVisible]);
 
-  // Placement-dependent animation CSS vars. Kept separate from show/hide
-  // so preset reference changes do not re-trigger visibility. The cleanup
-  // restores the previous inline values so a preset change does not leave
-  // stale custom properties on the element.
-  useLayoutEffect(function () {
-    var element = ownRef.current;
-    if (!element || !placement) {
-      return;
-    }
-    return setStyle({
-      element: element,
-      styles: getPopupMotionStyles({
-        placement: placement
-      })
-    });
-  }, [preset, placement, isVisible]);
-
   // Show/hide based on isOpen. `showPopover`/`hidePopover` are no-ops when
   // already in the target state. Try/catch guards `InvalidStateError` on
   // disconnected elements (StrictMode/concurrent/unmount edge cases).
@@ -338,7 +340,11 @@ export var Popover = /*#__PURE__*/forwardRef(function Popover(_ref, ref) {
     role: role,
     "aria-label": label,
     "aria-labelledby": labelledBy,
-    "data-testid": testId,
-    className: ax([styles.root, surfaceResetStyles.root, preset && popoverAnimationStyles.root, consumerXcss])
+    "data-testid": testId
+    // eslint-disable-next-line @atlaskit/ui-styling-standard/enforce-style-prop -- Motion styles are selected at runtime from the placement.
+    ,
+    style: popupMotionStyle,
+    // eslint-disable-next-line @atlaskit/ui-styling-standard/no-classname-prop, @atlaskit/ui-styling-standard/local-cx-xcss, @compiled/local-cx-xcss
+    className: ax([styles.root, surfaceResetStyles.root, shouldAnimate && phase === 'entering' && styles.enter, shouldAnimate && phase === 'exiting' && styles.exit, shouldAnimate && styles.motion, cx(shouldAnimate && phase === 'entering' && enteringAnimationXcss, shouldAnimate && phase === 'exiting' && exitingAnimationXcss)])
   }, children);
 });

package/dist/esm/popover-surface/popover-surface.js

@@ -1,4 +1,4 @@
-/* popover-surface.tsx generated by @compiled/babel-plugin v0.40.0 */
+/* popover-surface.tsx generated by @compiled/babel-plugin v2.0.0 */
 import "./popover-surface.compiled.css";
 import * as React from 'react';
 import { ax, ix } from "@compiled/react/runtime";

package/dist/types/dialog/types.d.ts

@@ -1,6 +1,6 @@
-import { type CSSProperties, type ReactNode } from 'react';
-import { type CompiledStyles } from '@compiled/react';
-import type { TAnimationConfig } from '../internal/use-animated-visibility';
+import type { CSSProperties, ReactNode } from 'react';
+import type { XCSSProp } from '@compiled/react';
+import type { StrictXCSSProp } from '@atlaskit/css';
 /**
  * Close reasons produced by the Dialog primitive.
  *
@@ -23,9 +23,10 @@ type TDialogBaseProps = {
     /**
      * Whether the dialog is open.
      *
-     * - `true`: calls `showModal()`, entry animation plays via `@starting-style`.
-     * - `false`: calls `close()`. When an `animate` preset is provided, the exit
-     *   animation plays (via `allow-discrete`) before the dialog becomes logically closed.
+     * - `true`: calls `showModal()`. When `shouldAnimate` is `true`, the entry
+     *   animation plays via `@starting-style`.
+     * - `false`: calls `close()`. When `shouldAnimate` is `true`, the exit
+     *   animation plays via `allow-discrete` before the dialog becomes logically closed.
      *
      * **Lifecycle observable to consumers:**
      *
@@ -48,19 +49,31 @@ type TDialogBaseProps = {
         reason: TDialogCloseReason;
     }) => void;
     /**
-     * Animation config for entry/exit transitions.
+     * Whether the dialog should animate in and out.
      *
-     * Pass `true` to use the default dialog animation. Pass a config object to
-     * customize supported animation settings. Pass `false` or omit to disable.
+     * When `true`, default dialog animation styles are applied. Use `enteringAnimationXcss`
+     * and `exitingAnimationXcss` to override the animation used for each phase.
      */
-    animate?: boolean | TAnimationConfig;
+    shouldAnimate?: boolean;
     /**
      * Additional Compiled styles applied to the `<dialog>` element.
      *
      * Applied after built-in dialog and animation styles so consumers can own
      * static styling that must live in their package.
      */
-    xcss?: CompiledStyles<Record<string, unknown>> | false | null | undefined;
+    xcss?: XCSSProp<'margin' | 'height' | 'width' | 'maxWidth' | 'insetBlockStart' | 'insetInlineStart' | 'insetInlineEnd', never>;
+    /**
+     * Animation styles applied while the dialog is entering.
+     *
+     * Only applied when `shouldAnimate` is `true`.
+     */
+    enteringAnimationXcss?: StrictXCSSProp<'animationName' | 'animationDuration' | 'animationTimingFunction' | 'animationDelay', never>;
+    /**
+     * Animation styles applied while the dialog is exiting.
+     *
+     * Only applied when `shouldAnimate` is `true`.
+     */
+    exitingAnimationXcss?: StrictXCSSProp<'animationName' | 'animationDuration' | 'animationTimingFunction' | 'animationDelay', never>;
     /**
      * Additional inline styles applied to the `<dialog>` element.
      *

package/dist/types/internal/resolve-placement.d.ts

@@ -7,14 +7,16 @@ export type TCrossAxisShiftOffset = {
     value: string;
     direction: 'forwards' | 'backwards';
 };
+export type TPlacementAxis = 'block' | 'inline';
+export type TPlacementEdge = 'start' | 'end';
 /**
- * Fully-resolved placement (internal). Use `getPlacement` for partial input.
+ * Fully-resolved placement (internal). Use `resolvePlacement` for partial input.
  * `offset.gap` and `offset.crossAxisShift.value` are always CSS
  * length strings.
  */
 export type TPlacement = {
-    axis: 'block' | 'inline';
-    edge: 'start' | 'end';
+    axis: TPlacementAxis;
+    edge: TPlacementEdge;
     align: 'start' | 'center' | 'end';
     offset: {
         gap: string;
@@ -53,6 +55,6 @@ export type TPlacementOptions = {
  * `offset.gap: token('space.100', '8px')`,
  * `offset.crossAxisShift: { value: '0px', direction: 'forwards' }`.
  */
-export declare function getPlacement({ placement }: {
+export declare function resolvePlacement({ placement }: {
     placement: TPlacementOptions;
 }): TPlacement;

package/dist/types/internal/use-animated-visibility.d.ts

@@ -1,12 +1,5 @@
 import { type RefObject } from 'react';
 type TAnimationKind = 'dialog' | 'popover';
-/**
- * Animation config for entry/exit transitions.
- *
- * Currently no configuration is supported via this prop,
- * and this is just a placeholder.
- */
-export type TAnimationConfig = never;
 type TUseAnimatedVisibilityArgs = {
     /**
      * Whether the element is logically open.
@@ -20,7 +13,7 @@ type TUseAnimatedVisibilityArgs = {
      * Animation config for entry/exit transitions.
      * Pass `false` or `undefined` to disable animation.
      */
-    animate: boolean | TAnimationConfig;
+    shouldAnimate: boolean;
     /**
      * Ref to the DOM element that plays the entry/exit transitions.
      * Used to listen for `transitionend`.
@@ -49,11 +42,6 @@ type TUseAnimatedVisibilityResult = {
      * trapping, listeners that must outlive the exit).
      */
     phase: TPhase;
-    /**
-     * Resolved animation preset (styles applied via the host element's `css`
-     * prop), or `null` if animation is disabled.
-     */
-    preset: boolean | TAnimationConfig | null;
 };
 /**
  * Visibility lifecycle phase shared between `useAnimatedVisibility`,
@@ -116,5 +104,5 @@ export type TPhase = 'closed' | 'entering' | 'open' | 'exiting';
  * Every effect dispatches on the single `phase` value instead of a
  * cross-product of booleans.
  */
-export declare function useAnimatedVisibility({ isOpen, animationKind, animate, elementRef, onEnterFinish, onExitFinish, }: TUseAnimatedVisibilityArgs): TUseAnimatedVisibilityResult;
+export declare function useAnimatedVisibility({ isOpen, animationKind, shouldAnimate, elementRef, onEnterFinish, onExitFinish, }: TUseAnimatedVisibilityArgs): TUseAnimatedVisibilityResult;
 export {};

package/dist/types/placement-map/legacy-placements.d.ts

@@ -5,5 +5,5 @@
  * to enumerate every placement (e.g. for a settings dropdown). New code
  * should use the object-based `TPlacementOptions` directly.
  */
-export declare const LEGACY_PLACEMENTS: readonly ["auto", "auto-start", "auto-end", "top", "top-start", "top-center", "top-end", "bottom", "bottom-start", "bottom-center", "bottom-end", "right", "right-start", "right-end", "left", "left-start", "left-end"];
+export declare const LEGACY_PLACEMENTS: readonly ['auto', 'auto-start', 'auto-end', 'top', 'top-start', 'top-center', 'top-end', 'bottom', 'bottom-start', 'bottom-center', 'bottom-end', 'right', 'right-start', 'right-end', 'left', 'left-start', 'left-end'];
 export type TLegacyPlacement = (typeof LEGACY_PLACEMENTS)[number];