@atlaskit/top-layer 1.4.0 → 1.6.0

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

@@ -2,6 +2,41 @@ import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
 import { useEffect, useLayoutEffect, useRef, useState } from 'react';
 import { bind, bindAll } from 'bind-event-listener';
 import { prefersReducedMotion } from './reduced-motion';
+
+/**
+ * A self-contained animation preset for top-layer elements.
+ *
+ * Contains a stable preset name used by the host component to select its
+ * component-local Compiled style entry, plus optional per-placement inline
+ * styles.
+ *
+ * The actual Compiled styles are kept static and component-local so the
+ * Compiled transform can extract them at build time.
+ */
+
+/**
+ * Using the recommended motion timings for safety net.
+ *
+ * Not setting these timings on the preset config because they're defined in the CSS,
+ * so configuring it in the preset doesn't achieve anything except introduce a potential
+ * source of drift.
+ *
+ * TODO: figure out a way to not need to redeclare these in the future,
+ * and keep CSS and JS timings in sync always.
+ */
+var safetyNetMsMap = {
+  dialog: {
+    enter: 250,
+    // Corresponds to `motion.duration.long`
+    exit: 200 // Corresponds to `motion.duration.medium`
+  },
+  popover: {
+    enter: 150,
+    // Corresponds to `motion.duration.short`
+    exit: 100 // Corresponds to `motion.duration.xshort`
+  }
+};
+
 /**
  * Fires `onSettled` once when `transitionend` fires on `element`, or after
  * `safetyNetMs` if the event is swallowed (mid-transition unmount, CSS
@@ -153,8 +188,7 @@ export function useAnimatedVisibility(_ref2) {
   // move to `open`. The fallback guarantees settle on swallowed events
   // (zero-duration, browser quirk, mid-transition unmount).
   useEffect(function () {
-    var _preset$enterDuration;
-    if (phase !== 'entering') {
+    if (phase !== 'entering' || !(preset !== null && preset !== void 0 && preset.kind)) {
       return;
     }
     var element = elementRef.current;
@@ -163,7 +197,7 @@ export function useAnimatedVisibility(_ref2) {
     }
     return runOnTransitionEndOrTimeout({
       element: element,
-      safetyNetMs: ((_preset$enterDuration = preset === null || preset === void 0 ? void 0 : preset.enterDurationMs) !== null && _preset$enterDuration !== void 0 ? _preset$enterDuration : 0) + 50,
+      safetyNetMs: safetyNetMsMap[preset.kind].enter + 50,
       onSettled: function onSettled() {
         var _onEnterFinishRef$cur;
         // Fire the consumer callback before transitioning phase so any
@@ -176,7 +210,7 @@ export function useAnimatedVisibility(_ref2) {
         });
       }
     });
-  }, [phase, preset === null || preset === void 0 ? void 0 : preset.enterDurationMs, elementRef]);
+  }, [phase, preset === null || preset === void 0 ? void 0 : preset.kind, elementRef]);
 
   // Non-animated entry callback. The lifecycle goes `closed → open`
   // directly with no `entering` phase; fire `onEnterFinish` on that jump.
@@ -197,8 +231,7 @@ export function useAnimatedVisibility(_ref2) {
   // Animated exit: wait for `transitionend` (or a safety-net timeout),
   // fire `onExitFinish`, then move to `closed` to unmount the host.
   useEffect(function () {
-    var _preset$exitDurationM;
-    if (phase !== 'exiting' || !willAnimate) {
+    if (phase !== 'exiting' || !willAnimate || !(preset !== null && preset !== void 0 && preset.kind)) {
       return;
     }
     var element = elementRef.current;
@@ -207,7 +240,7 @@ export function useAnimatedVisibility(_ref2) {
     }
     return runOnTransitionEndOrTimeout({
       element: element,
-      safetyNetMs: ((_preset$exitDurationM = preset === null || preset === void 0 ? void 0 : preset.exitDurationMs) !== null && _preset$exitDurationM !== void 0 ? _preset$exitDurationM : 0) + 50,
+      safetyNetMs: safetyNetMsMap[preset.kind].exit + 50,
       onSettled: function onSettled() {
         var _onExitFinishRef$curr;
         // Fire the consumer callback before transitioning phase to
@@ -222,7 +255,7 @@ export function useAnimatedVisibility(_ref2) {
         });
       }
     });
-  }, [phase, willAnimate, preset === null || preset === void 0 ? void 0 : preset.exitDurationMs, elementRef]);
+  }, [phase, willAnimate, preset === null || preset === void 0 ? void 0 : preset.kind, elementRef]);
 
   // Non-animated exit: wait for the browser's `toggle` (closed) or
   // `close` event before unmounting, so the consumer's listener (close

package/dist/esm/popover/animations.js

@@ -0,0 +1,187 @@
+import { getPlacement } from '../internal/resolve-placement';
+function getPopupMotionStyles(_ref) {
+  var placement = _ref.placement;
+  var _getPlacement = getPlacement({
+      placement: placement
+    }),
+    axis = _getPlacement.axis,
+    edge = _getPlacement.edge;
+  if (axis === 'block' && edge === 'start') {
+    return [{
+      property: '--ds-popover-motion-enter',
+      value: "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)"
+    }, {
+      property: '--ds-popover-motion-exit',
+      value: "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)"
+    }];
+  }
+  if (axis === 'inline' && edge === 'start') {
+    return [{
+      property: '--ds-popover-motion-enter',
+      value: "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)"
+    }, {
+      property: '--ds-popover-motion-exit',
+      value: "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)"
+    }];
+  }
+  if (axis === 'inline' && edge === 'end') {
+    return [{
+      property: '--ds-popover-motion-enter',
+      value: "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)"
+    }, {
+      property: '--ds-popover-motion-exit',
+      value: "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)"
+    }];
+  }
+  // Default: block/end (popover below trigger)
+  return [{
+    property: '--ds-popover-motion-enter',
+    value: "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)"
+  }, {
+    property: '--ds-popover-motion-exit',
+    value: "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)"
+  }];
+}
+
+// eslint-disable-next-line @atlaskit/volt-strict-mode/no-multiple-exports
+export function popupMotion() {
+  return {
+    kind: 'popover',
+    name: 'motion',
+    getStyles: getPopupMotionStyles
+  };
+}
+function getSlideAndFadeStyles(_ref2) {
+  var placement = _ref2.placement,
+    distance = _ref2.distance;
+  var pos = "".concat(distance, "px");
+  var neg = "-".concat(distance, "px");
+  var _getPlacement2 = getPlacement({
+      placement: placement
+    }),
+    axis = _getPlacement2.axis,
+    edge = _getPlacement2.edge;
+  if (axis === 'block' && edge === 'start') {
+    return [{
+      property: '--ds-popover-tx',
+      value: '0'
+    }, {
+      property: '--ds-popover-ty',
+      value: pos
+    }];
+  }
+  if (axis === 'block' && edge === 'end') {
+    return [{
+      property: '--ds-popover-tx',
+      value: '0'
+    }, {
+      property: '--ds-popover-ty',
+      value: neg
+    }];
+  }
+  if (axis === 'inline' && edge === 'start') {
+    return [{
+      property: '--ds-popover-tx',
+      value: pos
+    }, {
+      property: '--ds-popover-ty',
+      value: '0'
+    }];
+  }
+  if (axis === 'inline' && edge === 'end') {
+    return [{
+      property: '--ds-popover-tx',
+      value: neg
+    }, {
+      property: '--ds-popover-ty',
+      value: '0'
+    }];
+  }
+  return [{
+    property: '--ds-popover-tx',
+    value: '0'
+  }, {
+    property: '--ds-popover-ty',
+    value: neg
+  }];
+}
+
+/**
+ * Directional slide + opacity animation.
+ *
+ * The popover slides in from the direction opposite its placement edge
+ * (e.g. a `block-end` popover slides down from above).
+ *
+ * @param options.distance - Slide distance in pixels. Defaults to `4`.
+ *
+ * @example
+ * ```tsx
+ * import { slideAndFade } from '@atlaskit/top-layer/animations';
+ *
+ * // Default 4px slide (tooltip)
+ * <Popover animate={slideAndFade()} />
+ *
+ * // Custom 8px slide (popup / dropdown)
+ * <Popover animate={slideAndFade({ distance: 8 })} />
+ * ```
+ */
+// eslint-disable-next-line @atlaskit/volt-strict-mode/no-multiple-exports
+export function slideAndFade(options) {
+  var _options$distance;
+  var distance = (_options$distance = options === null || options === void 0 ? void 0 : options.distance) !== null && _options$distance !== void 0 ? _options$distance : 4;
+  return {
+    kind: 'popover',
+    name: 'slide-and-fade',
+    getStyles: function getStyles(_ref3) {
+      var placement = _ref3.placement;
+      return getSlideAndFadeStyles({
+        placement: placement,
+        distance: distance
+      });
+    }
+  };
+}
+
+// fade
+
+/**
+ * Simple opacity transition, no transform.
+ *
+ * Suitable for popup dialogs or content that does not need directional motion.
+ *
+ * @example
+ * ```tsx
+ * import { fade } from '@atlaskit/top-layer/animations';
+ *
+ * <Popover animate={fade()} />
+ * ```
+ */
+// eslint-disable-next-line @atlaskit/volt-strict-mode/no-multiple-exports
+export function fade() {
+  return {
+    kind: 'popover',
+    name: 'fade'
+  };
+}
+
+// scaleAndFade
+
+/**
+ * Scale from 0.95 + opacity transition.
+ *
+ * Suitable for menus, dropdowns, and select options.
+ *
+ * @example
+ * ```tsx
+ * import { scaleAndFade } from '@atlaskit/top-layer/animations';
+ *
+ * <Popover animate={scaleAndFade()} />
+ * ```
+ */
+// eslint-disable-next-line @atlaskit/volt-strict-mode/no-multiple-exports
+export function scaleAndFade() {
+  return {
+    kind: 'popover',
+    name: 'scale-and-fade'
+  };
+}

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

@@ -2,32 +2,35 @@
 ._15ns179n:popover-open{animation:var(--ds-popover-motion-enter)}
 ._19itglyw{border:none}
 ._1r041wug{inset:auto}
-._y44vof1f{animation:var(--ds-popover-motion-exit)}._12t71ttt:popover-open{transition-duration:.35s}
-._162xglyw:popover-open{transform:none}
+._y44vof1f{animation:var(--ds-popover-motion-exit)}._12t71ign:popover-open{transition-duration:var(--ds-duration-short,.15s)}
 ._18m9ewfl{overflow-y:visible}
 ._18u0idpf{margin-left:0}
 ._19bvidpf{padding-left:0}
 ._19pkidpf{margin-top:0}
-._1f6ykb7n:popover-open{opacity:1}
+._1a5xt94y{--dir:1px}
 ._1o51q7pw{animation-fill-mode:forwards}
-._1oec6ebc{transition-duration:.15s}
-._1oecluct{transition-duration:175ms}
+._1oecdn4k{transition-duration:var(--ds-duration-xshort,.1s)}
+._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}
-._6fl41a34{transition-timing-function:cubic-bezier(.15,1,.3,1)}
+._5sagdn4k{animation-duration:var(--ds-duration-xshort,.1s)}
+._71re1bym:popover-open{animation-name:var(--ds-keyframe-fade-in,FadeIn0to100)}
+._71re1v6b:popover-open{animation-name:var(--ds-keyframe-fade-in,FadeIn0to100),var(--ds-keyframe-scale-in-small,ScaleIn95to100)}
+._71rervlo:popover-open{animation-name:k1ut9kob,var(--ds-keyframe-fade-in,FadeIn0to100)}
 ._bfhk1j28{background-color:transparent}
 ._ca0qidpf{padding-top:0}
+._j7hq1a5s{animation-name:var(--ds-keyframe-fade-out,FadeOut100to0)}
+._j7hq1l2h{animation-name:k1e4c1ew,var(--ds-keyframe-fade-out,FadeOut100to0)}
+._j7hqneez{animation-name:var(--ds-keyframe-fade-out,FadeOut100to0),var(--ds-keyframe-scale-out-small,ScaleOut100to95)}
 ._k8m011k7{transition-property:overlay,display}
-._k8m01slm{transition-property:opacity,overlay,display}
-._k8m0rv36{transition-property:opacity,transform,overlay,display}
 ._n3tdidpf{padding-bottom:0}
 ._n70peoah:popover-open{animation-fill-mode:backwards}
+._o8i7indk:popover-open{animation-timing-function:var(--ds-easing-out-practical,cubic-bezier(.4,1,.6,1))}
 ._otyridpf{margin-bottom:0}
-._t9ecgt2x{transform:scale(.95)}
-._t9ecxauz{transform:translate(var(--ds-popover-tx,0),var(--ds-popover-ty,0))}
-._tzy4idpf{opacity:0}
 ._u5f3idpf{padding-right:0}
-[dir=rtl] ._1tz31oq6{transform:translate(calc(var(--ds-popover-tx, 0)*-1),var(--ds-popover-ty,0))}
-@media (prefers-reduced-motion:reduce){._156yru3m{transition-duration:0s}._2qm2ru3m:popover-open{transition-duration:0s}._bl8aglyw{animation-name:none}._8rmvglyw:popover-open{animation-name:none}}
-@starting-style{._1wuhidpf:popover-open{opacity:0}._1423gt2x:popover-open{transform:scale(.95)}._1423xauz:popover-open{transform:translate(var(--ds-popover-tx,0),var(--ds-popover-ty,0))}[dir=rtl] ._1dml1oq6:popover-open{transform:translate(calc(var(--ds-popover-tx, 0)*-1),var(--ds-popover-ty,0))}}
+[dir=rtl] ._34bx1n1a{--dir:-1px}
+@keyframes k1e4c1ew{0%{transform:none}to{transform:translate(calc(var(--dir)*var(--ds-popover-tx, 0)),var(--ds-popover-ty,0))}}
+@keyframes k1ut9kob{0%{transform:translate(calc(var(--dir)*var(--ds-popover-tx, 0)),var(--ds-popover-ty,0))}to{transform:none}}
+@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}}

package/dist/esm/popover/popover.js

@@ -1,7 +1,4 @@
 /* popover.tsx generated by @compiled/babel-plugin v0.39.1 */
-import _extends from "@babel/runtime/helpers/extends";
-import _defineProperty from "@babel/runtime/helpers/defineProperty";
-import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
 import "./popover.compiled.css";
 import { ax, ix } from "@compiled/react/runtime";
 import React, { forwardRef, useCallback, useId, useLayoutEffect, useRef } from 'react';
@@ -10,6 +7,7 @@ import mergeRefs from '@atlaskit/ds-lib/merge-refs';
 import once from '@atlaskit/ds-lib/once';
 import { useNotifyOpenLayerObserver } from '@atlaskit/layering/experimental/open-layer-observer';
 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';
@@ -25,16 +23,19 @@ var supportsPopoverHint = once(function () {
   element.setAttribute('popover', 'hint');
   return element.popover === 'hint';
 });
+var slideInKeyframes = null;
+var slideOutKeyframes = null;
 
 // 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 = {
-  popupMotion: "_y44vof1f _1o51q7pw _k8m011k7 _1oec6ebc _1s9z1a5r _15ns179n _n70peoah _bl8aglyw _156yru3m _8rmvglyw _2qm2ru3m",
-  slideAndFade: "_tzy4idpf _t9ecxauz _k8m0rv36 _1oecluct _6fl41a34 _1s9z1a5r _1tz31oq6 _1f6ykb7n _162xglyw _12t71ttt _1wuhidpf _1423xauz _156yru3m _2qm2ru3m _1dml1oq6",
-  fade: "_tzy4idpf _k8m01slm _1oecluct _6fl41a34 _1s9z1a5r _1f6ykb7n _12t71ttt _1wuhidpf _156yru3m _2qm2ru3m",
-  scaleAndFade: "_tzy4idpf _t9ecgt2x _k8m0rv36 _1oecluct _6fl41a34 _1s9z1a5r _1f6ykb7n _162xglyw _12t71ttt _1wuhidpf _1423gt2x _156yru3m _2qm2ru3m"
+  root: "_k8m011k7 _1oecdn4k _1s9z1a5r _1a5xt94y _12t71ign _34bx1n1a _bl8aglyw _156yru3m _8rmvglyw _2qm2ru3m",
+  motion: "_y44vof1f _1o51q7pw _15ns179n _n70peoah",
+  'slide-and-fade': "_j7hq1l2h _5sagdn4k _1pgl1lbj _71rervlo _1psg1ign _o8i7indk",
+  fade: "_j7hq1a5s _5sagdn4k _1pgl1lbj _71re1bym _1psg1ign _o8i7indk",
+  'scale-and-fade': "_j7hqneez _5sagdn4k _1pgl1lbj _71re1v6b _1psg1ign _o8i7indk"
 };
 var styles = {
   root: "_19itglyw _ca0qidpf _u5f3idpf _n3tdidpf _19bvidpf _19pkidpf _2hwxidpf _otyridpf _18u0idpf _1r041wug _1reoewfl _18m9ewfl _bfhk1j28"
@@ -89,7 +90,7 @@ export var Popover = /*#__PURE__*/forwardRef(function Popover(_ref, ref) {
     placement = _ref.placement,
     testId = _ref.testId,
     isOpen = _ref.isOpen,
-    xcssFromProps = _ref.xcss,
+    consumerXcss = _ref.xcss,
     role = _ref.role,
     label = _ref.label,
     labelledBy = _ref.labelledBy,
@@ -264,27 +265,19 @@ export var Popover = /*#__PURE__*/forwardRef(function Popover(_ref, ref) {
 
   // Placement-dependent animation CSS vars. Kept separate from show/hide
   // so preset reference changes do not re-trigger visibility. The cleanup
-  // removes the properties so a preset change does not leave stale custom
-  // properties on the element.
+  // 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 || !(preset !== null && preset !== void 0 && preset.getProperties) || !placement) {
+    if (!element || !(preset !== null && preset !== void 0 && preset.getStyles) || !placement) {
       return;
     }
-    var props = preset.getProperties({
-      placement: placement
+    return setStyle({
+      element: element,
+      styles: preset.getStyles({
+        placement: placement
+      })
     });
-    Object.entries(props).forEach(function (_ref2) {
-      var _ref3 = _slicedToArray(_ref2, 2),
-        key = _ref3[0],
-        value = _ref3[1];
-      element.style.setProperty(key, String(value));
-    });
-    return function () {
-      Object.keys(props).forEach(function (key) {
-        element.style.removeProperty(key);
-      });
-    };
   }, [preset, placement, isVisible]);
 
   // Show/hide based on isOpen. `showPopover`/`hidePopover` are no-ops when
@@ -323,7 +316,7 @@ export var Popover = /*#__PURE__*/forwardRef(function Popover(_ref, ref) {
   if (!isVisible) {
     return null;
   }
-  return /*#__PURE__*/React.createElement("div", _extends({
+  return /*#__PURE__*/React.createElement("div", {
     ref: combinedRef,
     id: popoverId
     // @ts-expect-error -- popover attribute not yet in React types
@@ -333,9 +326,7 @@ export var Popover = /*#__PURE__*/forwardRef(function Popover(_ref, ref) {
     role: role,
     "aria-label": label,
     "aria-labelledby": labelledBy,
-    "data-testid": testId
-  }, preset ? _defineProperty({}, "data-ds-popover-".concat(preset.name), '') : undefined, {
-    // eslint-disable-next-line @atlaskit/ui-styling-standard/no-classname-prop -- xcss prop passes compiled atomic class names
-    className: ax([styles.root, (preset === null || preset === void 0 ? void 0 : preset.name) === 'popup-motion' && popoverAnimationStyles.popupMotion, (preset === null || preset === void 0 ? void 0 : preset.name) === 'slide-and-fade' && popoverAnimationStyles.slideAndFade, (preset === null || preset === void 0 ? void 0 : preset.name) === 'fade' && popoverAnimationStyles.fade, (preset === null || preset === void 0 ? void 0 : preset.name) === 'scale-and-fade' && popoverAnimationStyles.scaleAndFade, xcssFromProps])
-  }), children);
+    "data-testid": testId,
+    className: ax([styles.root, preset && popoverAnimationStyles.root, preset && popoverAnimationStyles[preset.name], consumerXcss])
+  }, children);
 });

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

@@ -0,0 +1,57 @@
+import type { TAnimationPreset } from '../internal/use-animated-visibility';
+export type TDialogAnimationPresetName = 'motion' | 'slide-up-and-fade' | 'fade' | 'custom';
+export type TDialogAnimationPreset = TAnimationPreset<'dialog', TDialogAnimationPresetName>;
+/**
+ * Dialog motion animation.
+ *
+ * Includes backdrop fade animation.
+ *
+ * @example
+ * ```tsx
+ * import { dialogMotion } from '@atlaskit/top-layer/animations';
+ *
+ * <Dialog animate={dialogMotion()} isOpen={isOpen} onClose={handleClose} label="...">
+ *   ...
+ * </Dialog>
+ * ```
+ */
+export declare function dialogMotion(): TDialogAnimationPreset;
+/**
+ * Slide up + opacity animation for dialogs.
+ *
+ * Entry slides up from below; exit slides up and out (asymmetric).
+ * Includes backdrop fade animation.
+ *
+ * @param options.distance - Slide distance in pixels. Defaults to `12`.
+ *
+ * @example
+ * ```tsx
+ * import { dialogSlideUpAndFade } from '@atlaskit/top-layer/animations';
+ *
+ * const animation = dialogSlideUpAndFade();
+ * <Dialog animate={animation} isOpen={isOpen} onClose={handleClose} label="...">
+ *   ...
+ * </Dialog>
+ * ```
+ */
+export declare function dialogSlideUpAndFade(options?: {
+    /**
+     * Slide distance in pixels. Defaults to `12`.
+     */
+    distance?: number;
+}): TDialogAnimationPreset;
+/**
+ * Simple opacity transition for dialogs, no transform.
+ *
+ * Includes backdrop fade animation.
+ *
+ * @example
+ * ```tsx
+ * import { dialogFade } from '@atlaskit/top-layer/animations';
+ *
+ * <Dialog animate={dialogFade()} isOpen={isOpen} onClose={handleClose} label="...">
+ *   ...
+ * </Dialog>
+ * ```
+ */
+export declare function dialogFade(): TDialogAnimationPreset;

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 TAnimationPreset } from '../animations/types';
+import type { TDialogAnimationPreset } from './animations';
 /**
  * Close reasons produced by the Dialog primitive.
  *
@@ -53,7 +53,7 @@ type TDialogBaseProps = {
      * Pass a `TAnimationPreset` (e.g. `dialogSlideUpAndFade()`) to enable
      * CSS-based entry and exit animation. Pass `false` (or omit) to disable.
      */
-    animate?: TAnimationPreset | false;
+    animate?: TDialogAnimationPreset | false;
     /**
      * Additional Compiled styles applied to the `<dialog>` element.
      *

package/dist/types/entry-points/animations.d.ts

@@ -1,2 +1,2 @@
-export { dialogMotion, popupMotion, slideAndFade, fade, scaleAndFade, dialogSlideUpAndFade, dialogFade, } from '../animations/presets';
-export type { TAnimationPreset } from '../animations/types';
+export { dialogMotion, dialogSlideUpAndFade, dialogFade, type TDialogAnimationPreset, } from '../dialog/animations';
+export { popupMotion, slideAndFade, fade, scaleAndFade, type TPopoverAnimationPreset, } from '../popover/animations';

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

@@ -1,6 +1,35 @@
 import { type RefObject } from 'react';
-import { type TAnimationPreset } from '../animations/types';
-type TUseAnimatedVisibilityArgs = {
+import type { TPlacementOptions } from './resolve-placement';
+type TAnimationPresetKind = 'dialog' | 'popover';
+/**
+ * A self-contained animation preset for top-layer elements.
+ *
+ * Contains a stable preset name used by the host component to select its
+ * component-local Compiled style entry, plus optional per-placement inline
+ * styles.
+ *
+ * The actual Compiled styles are kept static and component-local so the
+ * Compiled transform can extract them at build time.
+ */
+export type TAnimationPreset<Kind extends TAnimationPresetKind, Name = string> = {
+    kind: Kind;
+    /**
+     * Stable preset name used to select a component-local Compiled style entry.
+     */
+    name: Name;
+    /**
+     * Per-placement inline styles (e.g. directional offset custom properties for
+     * `slideAndFade`). Only used by presets that vary by placement or by a
+     * configurable distance.
+     */
+    getStyles?: (args: {
+        placement: TPlacementOptions;
+    }) => Array<{
+        property: string;
+        value: string;
+    }>;
+};
+type TUseAnimatedVisibilityArgs<Kind extends TAnimationPresetKind, Name> = {
     /**
      * Whether the element is logically open.
      */
@@ -9,7 +38,7 @@ type TUseAnimatedVisibilityArgs = {
      * Animation preset for entry/exit transitions.
      * Pass `false` or `undefined` to disable animation.
      */
-    animate: TAnimationPreset | false | undefined;
+    animate: TAnimationPreset<Kind, Name> | false | undefined;
     /**
      * Ref to the DOM element that plays the entry/exit transitions.
      * Used to listen for `transitionend`.
@@ -27,7 +56,7 @@ type TUseAnimatedVisibilityArgs = {
      */
     onExitFinish?: () => void;
 };
-type TUseAnimatedVisibilityResult = {
+type TUseAnimatedVisibilityResult<Kind extends TAnimationPresetKind, Name> = {
     /**
      * Current visibility phase. See `TPhase` for the full lifecycle.
      *
@@ -42,7 +71,7 @@ type TUseAnimatedVisibilityResult = {
      * Resolved animation preset (styles applied via the host element's `css`
      * prop), or `null` if animation is disabled.
      */
-    preset: TAnimationPreset | null;
+    preset: TAnimationPreset<Kind, Name> | null;
 };
 /**
  * Visibility lifecycle phase shared between `useAnimatedVisibility`,
@@ -105,5 +134,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, animate, elementRef, onEnterFinish, onExitFinish, }: TUseAnimatedVisibilityArgs): TUseAnimatedVisibilityResult;
+export declare function useAnimatedVisibility<Kind extends TAnimationPresetKind, Name>({ isOpen, animate, elementRef, onEnterFinish, onExitFinish, }: TUseAnimatedVisibilityArgs<Kind, Name>): TUseAnimatedVisibilityResult<Kind, Name>;
 export {};

package/dist/types/popover/animations.d.ts

@@ -0,0 +1,52 @@
+import type { TAnimationPreset } from '../internal/use-animated-visibility';
+export type TPopoverAnimationPresetName = 'motion' | 'slide-and-fade' | 'scale-and-fade' | 'fade';
+export type TPopoverAnimationPreset = TAnimationPreset<'popover', TPopoverAnimationPresetName>;
+export declare function popupMotion(): TPopoverAnimationPreset;
+/**
+ * Directional slide + opacity animation.
+ *
+ * The popover slides in from the direction opposite its placement edge
+ * (e.g. a `block-end` popover slides down from above).
+ *
+ * @param options.distance - Slide distance in pixels. Defaults to `4`.
+ *
+ * @example
+ * ```tsx
+ * import { slideAndFade } from '@atlaskit/top-layer/animations';
+ *
+ * // Default 4px slide (tooltip)
+ * <Popover animate={slideAndFade()} />
+ *
+ * // Custom 8px slide (popup / dropdown)
+ * <Popover animate={slideAndFade({ distance: 8 })} />
+ * ```
+ */
+export declare function slideAndFade(options?: {
+    distance?: number;
+}): TPopoverAnimationPreset;
+/**
+ * Simple opacity transition, no transform.
+ *
+ * Suitable for popup dialogs or content that does not need directional motion.
+ *
+ * @example
+ * ```tsx
+ * import { fade } from '@atlaskit/top-layer/animations';
+ *
+ * <Popover animate={fade()} />
+ * ```
+ */
+export declare function fade(): TPopoverAnimationPreset;
+/**
+ * Scale from 0.95 + opacity transition.
+ *
+ * Suitable for menus, dropdowns, and select options.
+ *
+ * @example
+ * ```tsx
+ * import { scaleAndFade } from '@atlaskit/top-layer/animations';
+ *
+ * <Popover animate={scaleAndFade()} />
+ * ```
+ */
+export declare function scaleAndFade(): TPopoverAnimationPreset;

package/dist/types/popover/types.d.ts

@@ -1,8 +1,8 @@
 import { type ReactNode } from 'react';
 import { type StrictXCSSProp } from '@atlaskit/css';
-import { type TAnimationPreset } from '../animations/types';
 import { type TPlacementOptions } from '../internal/resolve-placement';
 import { type TAriaRoleRequired, type TRoleRequiringAccessibleName, type TRoleWithImplicitName } from '../internal/role-types';
+import { type TPopoverAnimationPreset } from './animations';
 /**
  * The reason a popover was closed.
  *
@@ -43,7 +43,7 @@ type TPopoverBaseProps = {
      * Animations use `@starting-style` and `allow-discrete` for progressive
      * enhancement: browsers without support show/hide instantly.
      */
-    animate?: false | TAnimationPreset;
+    animate?: false | TPopoverAnimationPreset;
     /**
      * Test ID applied to the popover element.
      */
@@ -109,7 +109,7 @@ type TPopoverBaseProps = {
     /**
      * Placement hint for directional animations (e.g. `slideAndFade`).
      *
-     * When `animate` is provided, the preset's `getProperties(placement)` is
+     * When `animate` is provided, the preset's `getStyles(placement)` is
      * called to set CSS custom properties (like `--ds-popover-tx`, `--ds-popover-ty`)
      * that control the slide direction. Has no effect without `animate`.
      *