@atlaskit/top-layer 0.12.1 → 0.13.0

package/dist/types/internal/use-anchor-position.d.ts

@@ -34,7 +34,7 @@ import { type TPlacementOptions } from '../internal/resolve-placement';
  * comparison is used internally so re-runs are skipped when the resolved
  * placement shape is unchanged.
  */
-export declare function useAnchorPosition({ anchorRef, popoverRef, placement, forceFallbackPositioning, }: {
+export declare function useAnchorPosition({ anchorRef, popoverRef, placement, forceFallbackPositioning, isEnabled, }: {
     /**
      * Element to position relative to.
      */
@@ -70,4 +70,9 @@ export declare function useAnchorPosition({ anchorRef, popoverRef, placement, fo
      * behavior in any environment, including production.
      */
     forceFallbackPositioning?: boolean;
+    /**
+     * When `false`, the hook is a no-op and applies no positioning.
+     * Defaults to `true`.
+     */
+    isEnabled?: boolean;
 }): void;

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

@@ -44,19 +44,19 @@ type TUseAnimatedVisibilityResult = {
  *
  * Used by both `Popover` and `Dialog` to share the same animation lifecycle
  * logic. Those components own their own show/hide mechanisms (showPopover /
- * hidePopover vs showModal / close) and event handling — this hook only
+ * hidePopover vs showModal / close) and event handling - this hook only
  * manages the relationship between `isOpen` and when children are rendered.
  *
  * ## Problem
  *
  * We want to delay the unmount of children until a CSS exit transition has
  * finished playing. If we unmount children the moment `isOpen` becomes
- * `false`, the exit animation is never visible — the content just disappears.
+ * `false`, the exit animation is never visible - the content just disappears.
  *
  * ## How it works
  *
  * `showChildren` tracks whether the consumer's children should be in the DOM.
- * It does not mirror `isOpen` exactly — it intentionally lags behind during
+ * It does not mirror `isOpen` exactly - it intentionally lags behind during
  * exit animations:
  *
  * ```

package/dist/types/internal/use-animation-preset.d.ts

@@ -5,7 +5,7 @@ type TPresetWithCssAndName = {
 /**
  * Normalizes the `animate` prop to a preset (or null) and ensures its CSS
  * is injected once into document.head. Used by PopupContent, Popover, and
- * DialogContent so they don't duplicate this logic.
+ * DialogContent so they do not duplicate this logic.
  */
 export declare function useAnimationPreset<T extends TPresetWithCssAndName>(animate: T | false | null | undefined): T | null;
 export {};

package/dist/types/internal/use-preset-styles.d.ts

@@ -6,7 +6,7 @@ type TPresetWithCssAndName = {
  * Normalizes a preset prop to a value (or null) and ensures its CSS
  * is injected once into `document.head`.
  *
- * Works with any preset that has `{ css, name }` — animation presets
+ * Works with any preset that has `{ css, name }` - animation presets
  * (TAnimationPreset) satisfies this shape.
  */
 export declare function usePresetStyles<T extends TPresetWithCssAndName>({ preset, }: {

package/dist/types/internal/use-width-from-anchor.d.ts

@@ -3,8 +3,8 @@ import type { TWidthFromAnchorMode } from '../popover/types';
 /**
  * Sets the width of a popover element relative to its anchor element.
  *
- * - `'match-anchor'` → `width: anchor-size(width)` — popover matches anchor width exactly.
- * - `'min-anchor'`   → `min-width: anchor-size(width)` — popover is at least as wide as anchor,
+ * - `'match-anchor'` → `width: anchor-size(width)` - popover matches anchor width exactly.
+ * - `'min-anchor'`   → `min-width: anchor-size(width)` - popover is at least as wide as anchor,
  *   but can grow wider.
  * - `'none'`         → no explicit width is set (default behaviour)
  *

package/dist/types/placement-map/index.d.ts

@@ -1,5 +1,5 @@
 import { type TPlacementOptions } from '../internal/resolve-placement';
-import { type TLegacyPlacement } from './legacy-placements';
+import type { TLegacyPlacement } from './legacy-placements';
 /**
  * Maps legacy Popper.js placement values to the new object-based
  * `Placement` values used by `@atlaskit/top-layer/popover`.

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

@@ -1,4 +1,3 @@
-import { type TPlacementOptions } from '../internal/resolve-placement';
 /**
  * Legacy Popper.js placement values (used by `@atlaskit/popper`,
  * `@atlaskit/popup`, `@atlaskit/tooltip`, etc.). Re-exported from
@@ -8,14 +7,3 @@ import { type TPlacementOptions } from '../internal/resolve-placement';
  */
 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];
-/**
- * The full mapping record. Internal - use `fromLegacyPlacement` from the
- * public entry-point so the offset-tuple translation is applied consistently.
- *
- * Note: `auto`, `auto-start`, `auto-end` map to `block-end` placements. This
- * is a reduction in expressiveness vs Popper.js (which picked the best
- * placement at runtime). CSS `position-try-fallbacks` flips at the edge but
- * the initial placement is fixed. Migration consumers who relied on Popper's
- * dynamic auto-flip should pick an explicit placement instead.
- */
-export declare const placementMapping: Record<TLegacyPlacement, TPlacementOptions>;

package/dist/types/placement-map/placement-mapping.d.ts

@@ -0,0 +1,13 @@
+import { type TPlacementOptions } from '../internal/resolve-placement';
+import type { TLegacyPlacement } from './legacy-placements';
+/**
+ * The full mapping record. Internal - use `fromLegacyPlacement` from the
+ * public entry-point so the offset-tuple translation is applied consistently.
+ *
+ * Note: `auto`, `auto-start`, `auto-end` map to `block-end` placements. This
+ * is a reduction in expressiveness vs Popper.js (which picked the best
+ * placement at runtime). CSS `position-try-fallbacks` flips at the edge but
+ * the initial placement is fixed. Migration consumers who relied on Popper's
+ * dynamic auto-flip should pick an explicit placement instead.
+ */
+export declare const placementMapping: Record<TLegacyPlacement, TPlacementOptions>;

package/dist/types/popover/create-close-event.d.ts

@@ -3,7 +3,7 @@ import type { TPopoverCloseReason } from './types';
  * Creates a synthetic DOM event from a `TPopoverCloseReason`.
  *
  * Useful when bridging the Popover primitive's `onClose({ reason })` callback
- * to a legacy API that expects a native DOM event — for example,
+ * to a legacy API that expects a native DOM event - for example,
  * `@atlaskit/inline-dialog`'s `onClose(event)` contract.
  *
  * - `'escape'` → `KeyboardEvent('keydown', { key: 'Escape' })`

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

@@ -8,7 +8,7 @@ import { type TPopoverForwardedProps } from './types';
  * Unopinionated top-layer primitive.
  *
  * Manages only visibility (isOpen) and animation (animate). Has no knowledge
- * of positioning — compose with `useAnchorPosition` for anchor positioning
+ * of positioning - compose with `useAnchorPosition` for anchor positioning
  * and optionally `useWidthFromAnchor` for setting the width of a popover element
  * relative to its anchor trigger.
  *

package/dist/types/popup/popup-context.d.ts

@@ -79,7 +79,7 @@ export type TPopupContextValue = {
      */
     ariaHasPopup: TAriaHasPopupValue;
     /**
-     * Updates `ariaHasPopup` — called by Content on mount/role change.
+     * Updates `ariaHasPopup` - called by Content on mount/role change.
      */
     setAriaHasPopup: (value: TAriaHasPopupValue) => void;
     /**

package/dist/types/testing/to-be-visible.d.ts

@@ -3,13 +3,13 @@
  *
  * jest-dom's `toBeVisible()` does not know about the Popover API. In real
  * browsers the UA stylesheet hides `[popover]` with `display: none`, but
- * jsdom has no such stylesheet — so closed popovers incorrectly appear visible.
+ * jsdom has no such stylesheet - so closed popovers incorrectly appear visible.
  *
  * Raw jest-dom results in jsdom:
  *
- *   closed popover / child  → true  (WRONG — should be false)
+ *   closed popover / child  → true  (WRONG - should be false)
  *   open popover / child    → true  (correct)
- *   closed dialog / child   → false (correct — jsdom natively hides <dialog>)
+ *   closed dialog / child   → false (correct - jsdom natively hides <dialog>)
  *   open dialog / child     → true  (correct)
  *
  * We correct both false positives and false negatives:

package/dist/types/use-arrow-navigation/use-arrow-navigation.d.ts

@@ -1,5 +1,5 @@
 import { type RefObject } from 'react';
-import { type TFocusableFilter } from '../focus';
+import { type TFocusableFilter } from '../focus/types';
 /**
  * Args for `useArrowNavigation`.
  *

package/dist/types/use-simple-light-dismiss/index.d.ts

@@ -34,7 +34,7 @@ type TUseSimpleLightDismissOptions = {
  * **No stacking awareness:** This hook does not track a popover stack.
  * If multiple manual popovers are open and all use this hook, a single
  * Escape press or outside click will dismiss **all of them simultaneously**.
- * This is by design — the hook is intentionally simple for cases where
+ * This is by design - the hook is intentionally simple for cases where
  * only one manual popover is open at a time.
  *
  * For stacked/nested popovers that should dismiss one-at-a-time, use

package/dist/types-ts4.5/dialog/create-close-event.d.ts

@@ -3,7 +3,7 @@ import type { TDialogCloseReason } from './types';
  * Creates a synthetic DOM event from a `TDialogCloseReason`.
  *
  * Useful when bridging the Dialog primitive's `onClose({ reason })` callback
- * to a legacy API that expects a `KeyboardEvent` or `MouseEvent` — for example,
+ * to a legacy API that expects a `KeyboardEvent` or `MouseEvent` - for example,
  * `@atlaskit/modal-dialog`'s `onClose(event, analyticsEvent)` contract.
  *
  * - `'escape'` → `KeyboardEvent('keydown', { key: 'Escape' })`

package/dist/types-ts4.5/dialog/types.d.ts

@@ -49,6 +49,14 @@ type TDialogBaseProps = {
      * Additional inline styles applied to the `<dialog>` element.
      *
      * Use for custom width, height, transform, or other overrides.
+     *
+     * Rule deviation: the house rules ban unbounded `style` props on
+     * components. `Dialog` is a low-level primitive that intentionally has
+     * no visual opinions of its own; consumers such as `@atlaskit/modal-dialog`
+     * must be able to set width, height, and transforms on the native
+     * `<dialog>` element. Removing this prop would be a breaking change
+     * and is tracked separately. Keep until an xcss-based replacement
+     * exists on the primitive.
      */
     style?: CSSProperties;
     /**

package/dist/types-ts4.5/entry-points/focus.d.ts

@@ -1,2 +1,4 @@
-export { getFirstFocusable, getLastFocusable, getNextFocusable } from '../focus';
-export type { TFocusableFilter } from '../focus';
+export type { TFocusableFilter } from '../focus/types';
+export { getFirstFocusable } from '../focus/get-first-focusable';
+export { getLastFocusable } from '../focus/get-last-focusable';
+export { getNextFocusable } from '../focus/get-next-focusable';

package/dist/types-ts4.5/entry-points/use-anchor-position-at-point.d.ts

@@ -0,0 +1 @@
+export { useAnchorPositionAtPoint, type TAnchorPoint, } from '../internal/use-anchor-position-at-point';

package/dist/types-ts4.5/focus/get-first-focusable.d.ts

@@ -0,0 +1,8 @@
+import type { TFocusableFilter } from './types';
+/**
+ * Returns the first focusable element within the container.
+ */
+export declare function getFirstFocusable({ container, filter, }: {
+    container: HTMLElement;
+    filter?: TFocusableFilter;
+}): HTMLElement | null;

package/dist/types-ts4.5/focus/get-focusables.d.ts

@@ -0,0 +1,13 @@
+import type { TFocusableFilter } from './types';
+/**
+ * Returns all focusable HTMLElements within the container, optionally filtered.
+ *
+ * Focusables that belong to a nested top-layer scope (a `[popover]` or
+ * `<dialog>` descendant of the container) are excluded - those elements
+ * are owned by the inner layer's focus management. The container itself
+ * is allowed to be a popover/dialog; only nested ones are filtered.
+ */
+export declare function getFocusables({ container, filter, }: {
+    container: HTMLElement;
+    filter?: TFocusableFilter;
+}): HTMLElement[];

package/dist/types-ts4.5/focus/get-last-focusable.d.ts

@@ -0,0 +1,8 @@
+import type { TFocusableFilter } from './types';
+/**
+ * Returns the last focusable element within the container.
+ */
+export declare function getLastFocusable({ container, filter, }: {
+    container: HTMLElement;
+    filter?: TFocusableFilter;
+}): HTMLElement | null;

package/dist/types-ts4.5/focus/get-next-focusable.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Returns the next focusable element in the given direction relative to the
+ * currently focused element within the container. Wraps around at both ends.
+ *
+ * Returns `null` if there is no focused element within the container or if
+ * the focused element is not in the list of focusable elements.
+ */
+import type { TFocusableFilter } from './types';
+export declare function getNextFocusable({ container, direction, filter, }: {
+    container: HTMLElement;
+    direction: 'forwards' | 'backwards';
+    filter?: TFocusableFilter;
+}): HTMLElement | null;

package/dist/types-ts4.5/focus/is-in-same-layer.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Returns true when `element` and `container` resolve to the same nearest
+ * top-layer host (or both resolve to `null`, meaning the document layer).
+ */
+export declare function isInSameLayer({ element, container, }: {
+    element: HTMLElement;
+    container: HTMLElement;
+}): boolean;

package/dist/types-ts4.5/focus/is-nested-layer-focused.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Returns `true` when `document.activeElement` is inside a nested top-layer
+ * descendant of `container` (a `[popover]`, `<dialog>`, `[role="dialog"]` or
+ * `[role="alertdialog"]` that is itself a descendant of `container`).
+ */
+export declare function isNestedLayerFocused({ container }: {
+    container: HTMLElement;
+}): boolean;

package/dist/types-ts4.5/focus/selectors.d.ts

@@ -0,0 +1,4 @@
+export declare const selectors: {
+    focusable: string;
+    focused: string;
+};

package/dist/types-ts4.5/focus/types.d.ts

@@ -0,0 +1,5 @@
+/**
+ * An optional callback to restrict which focusable elements are included.
+ * Return `true` to include the element, `false` to skip it.
+ */
+export type TFocusableFilter = (element: HTMLElement, container: HTMLElement) => boolean;

package/dist/types-ts4.5/internal/reduced-motion.d.ts

@@ -5,7 +5,7 @@
  *
  * The result is cached after the first call via `once`. This avoids
  * calling `matchMedia` on every render. The trade-off is that if a user
- * toggles the OS reduced-motion setting mid-session, the change won't
+ * toggles the OS reduced-motion setting mid-session, the change will not
  * take effect until the next page load. This is acceptable because
  * toggling this system-level preference mid-session is extremely rare,
  * and a page refresh is a reasonable expectation for system accessibility

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

@@ -30,8 +30,8 @@ export type TPlacement = {
  * CSS length string (e.g. `token('space.100')`).
  *
  * The two offset axes are named for clarity at the call site:
- *   - `gap`     — distance away from the trigger along the placement axis
- *   - `crossAxisShift`  — nudge along the trigger edge (perpendicular to the placement axis)
+ *   - `gap`     - distance away from the trigger along the placement axis
+ *   - `crossAxisShift`  - nudge along the trigger edge (perpendicular to the placement axis)
  */
 export type TPlacementOptions = {
     axis?: 'block' | 'inline';

package/dist/types-ts4.5/internal/role-to-aria-has-popup.d.ts

@@ -0,0 +1,13 @@
+import type { TAriaHasPopupValue, TRoleRequiringAccessibleName, TRoleWithImplicitName } from './role-types';
+/**
+ * Maps a popover content role to the correct `aria-haspopup` value
+ * for its trigger element.
+ *
+ * Returns `undefined` for roles that are not popups in the ARIA sense
+ * (`tooltip`, `note`, `status`, `alert`, `log`). Triggers for those roles
+ * should not announce a popup at all - emitting `aria-haspopup="dialog"`
+ * on a tooltip trigger would mislead assistive technology.
+ */
+export declare function roleToAriaHasPopup({ role, }: {
+    role: TRoleRequiringAccessibleName | TRoleWithImplicitName | undefined;
+}): TAriaHasPopupValue;

package/dist/types-ts4.5/internal/role-types.d.ts

@@ -61,23 +61,4 @@ export type TAriaRoleOptional = ({
 } & TAccessibleNameRequired) | ({
     role?: TRoleWithImplicitName;
 } & TAccessibleNameOptional);
-/**
- * Maps a popover content role to the correct `aria-haspopup` value
- * for its trigger element.
- *
- * Returns `undefined` for roles that are not popups in the ARIA sense
- * (`tooltip`, `note`, `status`, `alert`, `log`). Triggers for those roles
- * should not announce a popup at all - emitting `aria-haspopup="dialog"`
- * on a tooltip trigger would mislead assistive technology.
- */
-export declare function roleToAriaHasPopup({ role, }: {
-    role: TRoleRequiringAccessibleName | TRoleWithImplicitName | undefined;
-}): TAriaHasPopupValue;
-/**
- * Returns `true` when the given popover role moves focus into the popover
- * on open, and `false` otherwise (including when `role` is `undefined`).
- */
-export declare function shouldFocusIntoPopover({ role, }: {
-    role: TRoleRequiringAccessibleName | TRoleWithImplicitName | undefined;
-}): boolean;
 export {};

package/dist/types-ts4.5/internal/should-focus-into-popover.d.ts

@@ -0,0 +1,8 @@
+import type { TRoleRequiringAccessibleName, TRoleWithImplicitName } from './role-types';
+/**
+ * Returns `true` when the given popover role moves focus into the popover
+ * on open, and `false` otherwise (including when `role` is `undefined`).
+ */
+export declare function shouldFocusIntoPopover({ role, }: {
+    role: TRoleRequiringAccessibleName | TRoleWithImplicitName | undefined;
+}): boolean;

package/dist/types-ts4.5/internal/slot.d.ts

@@ -2,21 +2,21 @@ import { type ForwardRefExoticComponent, type ReactNode, type RefAttributes } fr
 /**
  * Extra DOM/event props are passed through to the cloned child.
  */
-export type SlotProps = {
+export type TSlotProps = {
     children: ReactNode;
 } & Record<string, unknown>;
 /**
  * Merges props (including ref) onto a single React element child.
  *
  * A safer alternative to raw `cloneElement` that:
- * 1. Guards with `isValidElement` — non-element children (strings,
+ * 1. Guards with `isValidElement` - non-element children (strings,
  *    fragments, null) are returned as-is instead of crashing.
  * 2. Merges refs via `mergeRefs` so both the caller's ref and the
  *    child's existing ref are honoured.
  * 3. Spreads any additional props (ARIA attributes, event handlers, etc.)
  *    onto the child element.
  *
- * Event handlers (e.g. `onClick`) are **not** auto-merged — the caller's
+ * Event handlers (e.g. `onClick`) are **not** auto-merged - the caller's
  * handler replaces the child's. Compose handlers before passing them in.
  *
  * @example
@@ -26,4 +26,4 @@ export type SlotProps = {
  * </Slot>
  * ```
  */
-export declare const Slot: ForwardRefExoticComponent<SlotProps & RefAttributes<HTMLElement>>;
+export declare const Slot: ForwardRefExoticComponent<TSlotProps & RefAttributes<HTMLElement>>;

package/dist/types-ts4.5/internal/use-anchor-position-at-point.d.ts

@@ -0,0 +1,62 @@
+import { type RefObject } from 'react';
+import { type TPlacementOptions } from './resolve-placement';
+/**
+ * A point in viewport coordinates (CSS pixels) at which the synthetic
+ * anchor should be placed.
+ *
+ * Axis-named (`x`/`y`) rather than edge-named (`left`/`top`) so the
+ * shape is unambiguous in RTL writing modes — there is no ambiguity
+ * about whether a coordinate is logical (`inline-start`/`block-start`)
+ * or physical (`left`/`top`). Viewport coordinates are always
+ * physical, so we name them with the physical axis labels.
+ */
+export type TAnchorPoint = {
+    x: number;
+    y: number;
+};
+/**
+ * Positions a popover at a consumer-supplied viewport coordinate using a
+ * hidden synthetic anchor.
+ *
+ * @example
+ * ```tsx
+ * function PointPositionedPopover({ popoverRef, placement, mousePos }) {
+ *   useAnchorPositionAtPoint({
+ *     popoverRef,
+ *     placement,
+ *     isEnabled: Boolean(mousePos),
+ *     getPoint: () => {
+ *       if (!mousePos) return null;
+ *       return { x: mousePos.clientX, y: mousePos.clientY };
+ *     },
+ *   });
+ *   return <Popover ref={popoverRef}>...</Popover>;
+ * }
+ * ```
+ */
+export declare function useAnchorPositionAtPoint({ popoverRef, placement, getPoint, isEnabled, }: {
+    /**
+     * Element being positioned. Passed to `useAnchorPosition`.
+     */
+    popoverRef: RefObject<HTMLElement | null>;
+    /**
+     * Where the popover sits relative to the anchor.
+     */
+    placement: TPlacementOptions;
+    /**
+     * Lazy callback returning the viewport coordinate to anchor at.
+     * Called once per activation (every `isEnabled: false → true`
+     * transition); the result is latched and not re-read.
+     *
+     * Return `null` to signal "no point yet" — the hook stays in a
+     * no-DOM state so another positioning strategy can own the popover.
+     *
+     * Read from a ref, so it does not need to be memoized.
+     */
+    getPoint: () => TAnchorPoint | null;
+    /**
+     * When `false`, the hook is a no-op: no synthetic anchor is created
+     * and no positioning is applied. Defaults to `true`.
+     */
+    isEnabled?: boolean;
+}): void;

package/dist/types-ts4.5/internal/use-anchor-position.d.ts

@@ -34,7 +34,7 @@ import { type TPlacementOptions } from '../internal/resolve-placement';
  * comparison is used internally so re-runs are skipped when the resolved
  * placement shape is unchanged.
  */
-export declare function useAnchorPosition({ anchorRef, popoverRef, placement, forceFallbackPositioning, }: {
+export declare function useAnchorPosition({ anchorRef, popoverRef, placement, forceFallbackPositioning, isEnabled, }: {
     /**
      * Element to position relative to.
      */
@@ -70,4 +70,9 @@ export declare function useAnchorPosition({ anchorRef, popoverRef, placement, fo
      * behavior in any environment, including production.
      */
     forceFallbackPositioning?: boolean;
+    /**
+     * When `false`, the hook is a no-op and applies no positioning.
+     * Defaults to `true`.
+     */
+    isEnabled?: boolean;
 }): void;

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

@@ -44,19 +44,19 @@ type TUseAnimatedVisibilityResult = {
  *
  * Used by both `Popover` and `Dialog` to share the same animation lifecycle
  * logic. Those components own their own show/hide mechanisms (showPopover /
- * hidePopover vs showModal / close) and event handling — this hook only
+ * hidePopover vs showModal / close) and event handling - this hook only
  * manages the relationship between `isOpen` and when children are rendered.
  *
  * ## Problem
  *
  * We want to delay the unmount of children until a CSS exit transition has
  * finished playing. If we unmount children the moment `isOpen` becomes
- * `false`, the exit animation is never visible — the content just disappears.
+ * `false`, the exit animation is never visible - the content just disappears.
  *
  * ## How it works
  *
  * `showChildren` tracks whether the consumer's children should be in the DOM.
- * It does not mirror `isOpen` exactly — it intentionally lags behind during
+ * It does not mirror `isOpen` exactly - it intentionally lags behind during
  * exit animations:
  *
  * ```

package/dist/types-ts4.5/internal/use-animation-preset.d.ts

@@ -5,7 +5,7 @@ type TPresetWithCssAndName = {
 /**
  * Normalizes the `animate` prop to a preset (or null) and ensures its CSS
  * is injected once into document.head. Used by PopupContent, Popover, and
- * DialogContent so they don't duplicate this logic.
+ * DialogContent so they do not duplicate this logic.
  */
 export declare function useAnimationPreset<T extends TPresetWithCssAndName>(animate: T | false | null | undefined): T | null;
 export {};

package/dist/types-ts4.5/internal/use-preset-styles.d.ts

@@ -6,7 +6,7 @@ type TPresetWithCssAndName = {
  * Normalizes a preset prop to a value (or null) and ensures its CSS
  * is injected once into `document.head`.
  *
- * Works with any preset that has `{ css, name }` — animation presets
+ * Works with any preset that has `{ css, name }` - animation presets
  * (TAnimationPreset) satisfies this shape.
  */
 export declare function usePresetStyles<T extends TPresetWithCssAndName>({ preset, }: {

package/dist/types-ts4.5/internal/use-width-from-anchor.d.ts

@@ -3,8 +3,8 @@ import type { TWidthFromAnchorMode } from '../popover/types';
 /**
  * Sets the width of a popover element relative to its anchor element.
  *
- * - `'match-anchor'` → `width: anchor-size(width)` — popover matches anchor width exactly.
- * - `'min-anchor'`   → `min-width: anchor-size(width)` — popover is at least as wide as anchor,
+ * - `'match-anchor'` → `width: anchor-size(width)` - popover matches anchor width exactly.
+ * - `'min-anchor'`   → `min-width: anchor-size(width)` - popover is at least as wide as anchor,
  *   but can grow wider.
  * - `'none'`         → no explicit width is set (default behaviour)
  *

package/dist/types-ts4.5/placement-map/index.d.ts

@@ -1,5 +1,5 @@
 import { type TPlacementOptions } from '../internal/resolve-placement';
-import { type TLegacyPlacement } from './legacy-placements';
+import type { TLegacyPlacement } from './legacy-placements';
 /**
  * Maps legacy Popper.js placement values to the new object-based
  * `Placement` values used by `@atlaskit/top-layer/popover`.

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

@@ -1,4 +1,3 @@
-import { type TPlacementOptions } from '../internal/resolve-placement';
 /**
  * Legacy Popper.js placement values (used by `@atlaskit/popper`,
  * `@atlaskit/popup`, `@atlaskit/tooltip`, etc.). Re-exported from
@@ -26,14 +25,3 @@ export declare const LEGACY_PLACEMENTS: readonly [
     "left-end"
 ];
 export type TLegacyPlacement = (typeof LEGACY_PLACEMENTS)[number];
-/**
- * The full mapping record. Internal - use `fromLegacyPlacement` from the
- * public entry-point so the offset-tuple translation is applied consistently.
- *
- * Note: `auto`, `auto-start`, `auto-end` map to `block-end` placements. This
- * is a reduction in expressiveness vs Popper.js (which picked the best
- * placement at runtime). CSS `position-try-fallbacks` flips at the edge but
- * the initial placement is fixed. Migration consumers who relied on Popper's
- * dynamic auto-flip should pick an explicit placement instead.
- */
-export declare const placementMapping: Record<TLegacyPlacement, TPlacementOptions>;

package/dist/types-ts4.5/placement-map/placement-mapping.d.ts

@@ -0,0 +1,13 @@
+import { type TPlacementOptions } from '../internal/resolve-placement';
+import type { TLegacyPlacement } from './legacy-placements';
+/**
+ * The full mapping record. Internal - use `fromLegacyPlacement` from the
+ * public entry-point so the offset-tuple translation is applied consistently.
+ *
+ * Note: `auto`, `auto-start`, `auto-end` map to `block-end` placements. This
+ * is a reduction in expressiveness vs Popper.js (which picked the best
+ * placement at runtime). CSS `position-try-fallbacks` flips at the edge but
+ * the initial placement is fixed. Migration consumers who relied on Popper's
+ * dynamic auto-flip should pick an explicit placement instead.
+ */
+export declare const placementMapping: Record<TLegacyPlacement, TPlacementOptions>;

package/dist/types-ts4.5/popover/create-close-event.d.ts

@@ -3,7 +3,7 @@ import type { TPopoverCloseReason } from './types';
  * Creates a synthetic DOM event from a `TPopoverCloseReason`.
  *
  * Useful when bridging the Popover primitive's `onClose({ reason })` callback
- * to a legacy API that expects a native DOM event — for example,
+ * to a legacy API that expects a native DOM event - for example,
  * `@atlaskit/inline-dialog`'s `onClose(event)` contract.
  *
  * - `'escape'` → `KeyboardEvent('keydown', { key: 'Escape' })`

package/dist/types-ts4.5/popover/popover.d.ts

@@ -8,7 +8,7 @@ import { type TPopoverForwardedProps } from './types';
  * Unopinionated top-layer primitive.
  *
  * Manages only visibility (isOpen) and animation (animate). Has no knowledge
- * of positioning — compose with `useAnchorPosition` for anchor positioning
+ * of positioning - compose with `useAnchorPosition` for anchor positioning
  * and optionally `useWidthFromAnchor` for setting the width of a popover element
  * relative to its anchor trigger.
  *

package/dist/types-ts4.5/popup/popup-context.d.ts

@@ -79,7 +79,7 @@ export type TPopupContextValue = {
      */
     ariaHasPopup: TAriaHasPopupValue;
     /**
-     * Updates `ariaHasPopup` — called by Content on mount/role change.
+     * Updates `ariaHasPopup` - called by Content on mount/role change.
      */
     setAriaHasPopup: (value: TAriaHasPopupValue) => void;
     /**