@atlaskit/top-layer 0.13.0 → 0.14.0

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

@@ -1,207 +0,0 @@
-/* popup-content.tsx generated by @compiled/babel-plugin v0.39.1 */
-import _extends from "@babel/runtime/helpers/extends";
-import { ax, ix } from "@compiled/react/runtime";
-import React, { forwardRef, useCallback, useLayoutEffect, useRef } from 'react';
-import mergeRefs from '@atlaskit/ds-lib/merge-refs';
-import { prefersReducedMotion } from '../internal/reduced-motion';
-import { roleToAriaHasPopup } from '../internal/role-to-aria-has-popup';
-import { shouldFocusIntoPopover } from '../internal/should-focus-into-popover';
-import { useAnchorPosition } from '../internal/use-anchor-position';
-import { useWidthFromAnchor } from '../internal/use-width-from-anchor';
-import { Popover } from '../popover/popover';
-import { useMaybePopupContext } from './use-maybe-popup-context';
-
-/**
- * Thin context wrapper that composes `Popover` + `useAnchorPosition`.
- *
- * Used inside the `<Popup>` compound - reads triggerRef, placement, isOpen,
- * and onClose from context. For standalone usage (tooltip, spotlight, flag),
- * use `Popover` + `useAnchorPosition` directly.
- */
-export var PopupContent = /*#__PURE__*/forwardRef(function PopupContent(_ref, ref) {
-  var _ref2, _ctx$popoverRef;
-  var children = _ref.children,
-    role = _ref.role,
-    label = _ref.label,
-    labelledBy = _ref.labelledBy,
-    animate = _ref.animate,
-    mode = _ref.mode,
-    _ref$widthFromAnchor = _ref.widthFromAnchor,
-    widthFromAnchor = _ref$widthFromAnchor === void 0 ? 'none' : _ref$widthFromAnchor,
-    xcss = _ref.xcss,
-    isOpenProp = _ref.isOpen,
-    triggerRefProp = _ref.triggerRef,
-    placementProp = _ref.placement,
-    onCloseProp = _ref.onClose,
-    testIdProp = _ref.testId,
-    forceFallbackPositioningProp = _ref.forceFallbackPositioning,
-    idProp = _ref.id,
-    onEnterFinish = _ref.onEnterFinish,
-    onExitFinish = _ref.onExitFinish;
-  // When inside <Popup>, context provides defaults. Props always win.
-  var ctx = useMaybePopupContext();
-  var triggerRef = triggerRefProp !== null && triggerRefProp !== void 0 ? triggerRefProp : ctx === null || ctx === void 0 ? void 0 : ctx.triggerRef;
-  var placement = (_ref2 = placementProp !== null && placementProp !== void 0 ? placementProp : ctx === null || ctx === void 0 ? void 0 : ctx.placement) !== null && _ref2 !== void 0 ? _ref2 : {};
-  var onClose = onCloseProp !== null && onCloseProp !== void 0 ? onCloseProp : ctx === null || ctx === void 0 ? void 0 : ctx.onClose;
-  var testId = testIdProp !== null && testIdProp !== void 0 ? testIdProp : ctx === null || ctx === void 0 ? void 0 : ctx.testId;
-  var forceFallbackPositioning = forceFallbackPositioningProp !== null && forceFallbackPositioningProp !== void 0 ? forceFallbackPositioningProp : ctx === null || ctx === void 0 ? void 0 : ctx.forceFallbackPositioning;
-
-  // isOpen: prop wins, otherwise derive from context popupState.
-  // 'animating-open' counts as open so <Popover> stays visible during entry animation.
-  var isOpen = isOpenProp !== null && isOpenProp !== void 0 ? isOpenProp : ctx !== null ? ctx.popupState === 'open' || ctx.popupState === 'animating-open' : false;
-  var setPopupState = ctx === null || ctx === void 0 ? void 0 : ctx.setPopupState;
-  var consumerOnOpenChange = ctx === null || ctx === void 0 ? void 0 : ctx.onOpenChange;
-
-  // ── TPopupState ──
-  //
-  // popupState is driven by handleOpenChange (below), which fires on every browser
-  // toggle event (showPopover / hidePopover / light-dismiss).
-  //
-  // Exception — initial mount with isOpen=true (prop-controlled usage):
-  //   handleOpenChange only fires from the Popover's toggle event listener, which
-  //   is registered in a useEffect. On the first render, useEffect hasn't run yet,
-  //   so handleOpenChange never fires. We sync popupState here instead.
-  //
-  // Transitions when animations are active:
-  //   closed → animating-open  → open     (enter)
-  //   open   → animating-closed → closed  (exit, via onExitFinish)
-  //
-  // Without animation: closed ↔ open directly.
-  var willAnimate = Boolean(animate) && !prefersReducedMotion();
-  var hasMountedRef = useRef(false);
-  useLayoutEffect(function () {
-    if (hasMountedRef.current) {
-      return;
-    }
-    hasMountedRef.current = true;
-    if (isOpen) {
-      setPopupState === null || setPopupState === void 0 || setPopupState(willAnimate ? 'animating-open' : 'open');
-    }
-  }, [isOpen, setPopupState, willAnimate]);
-  var handleEnterFinish = useCallback(function () {
-    setPopupState === null || setPopupState === void 0 || setPopupState('open');
-    onEnterFinish === null || onEnterFinish === void 0 || onEnterFinish();
-  }, [setPopupState, onEnterFinish]);
-  var handleExitFinish = useCallback(function () {
-    setPopupState === null || setPopupState === void 0 || setPopupState('closed');
-    onExitFinish === null || onExitFinish === void 0 || onExitFinish();
-  }, [setPopupState, onExitFinish]);
-
-  // Note: onOpenChange composition is handled by handleOpenChange below,
-  // which also adds nested-popover focus restoration.
-
-  // Sync aria-haspopup on the trigger with the content's role
-  var setAriaHasPopup = ctx === null || ctx === void 0 ? void 0 : ctx.setAriaHasPopup;
-  useLayoutEffect(function () {
-    setAriaHasPopup === null || setAriaHasPopup === void 0 || setAriaHasPopup(roleToAriaHasPopup({
-      role: role
-    }));
-  }, [role, setAriaHasPopup]);
-
-  // Focus restoration
-  // The native Popover API handles focus restoration automatically for
-  // popover="auto" and popover="hint":
-  //   - Escape → restores focus to the previously focused element (the trigger)
-  //   - Click-outside → does NOT restore (correct: the user clicked deliberately)
-  //   - hidePopover() → restores focus to the previously focused element
-  //
-  // However, for **nested** popover="auto" popovers, the browser only captures
-  // `previouslyFocusedElement` for the outermost popover in the auto stack.
-  // Inner popovers have `shouldRestoreFocus=false` per the spec, so the browser
-  // does not restore focus when they close.
-  //
-  // To handle this, we listen for the close transition via `onOpenChange` and
-  // restore focus to the trigger if the browser did not. This runs after the
-  // browser's native restoration (which happens synchronously during hidePopover),
-  // so it only takes effect when the browser skipped restoration (nested case).
-  //
-  // See: notes/architecture/focus-restoration.md
-  var handleOpenChange = useCallback(function (args) {
-    // Sync compound state
-    if (args.isOpen) {
-      setPopupState === null || setPopupState === void 0 || setPopupState(willAnimate ? 'animating-open' : 'open');
-    } else {
-      setPopupState === null || setPopupState === void 0 || setPopupState(willAnimate ? 'animating-closed' : 'closed');
-    }
-    consumerOnOpenChange === null || consumerOnOpenChange === void 0 || consumerOnOpenChange(args);
-
-    // Nested popover focus restoration fallback
-    // The browser only captures `previouslyFocusedElement` for the
-    // outermost popover="auto" in the stack. Inner (nested) popovers
-    // have shouldRestoreFocus=false, so the browser will not restore
-    // focus when they close.
-    //
-    // We detect this case by checking if focus is still inside the
-    // closing popover element. If it is, the browser did not restore,
-    // and we need to move focus to the trigger ourselves.
-    //
-    // This does NOT fire for:
-    //   - Outermost popovers (browser already restored to trigger)
-    //   - Click-outside (focus is on the clicked element, not in popover)
-    if (!args.isOpen) {
-      var trigger = triggerRef === null || triggerRef === void 0 ? void 0 : triggerRef.current;
-      var focusStillInPopover = trigger && args.element.contains(document.activeElement);
-      // Single source of truth for "this role moves focus on open
-      // and therefore needs to be restored on close" - see
-      // `shouldFocusIntoPopover` in `internal/role-types.tsx`.
-      if (focusStillInPopover && shouldFocusIntoPopover({
-        role: role
-      })) {
-        trigger.focus({
-          preventScroll: true
-        });
-      }
-    }
-  }, [consumerOnOpenChange, triggerRef, role, setPopupState, willAnimate]);
-
-  // Anchor positioning
-  // Compose useAnchorPosition with Popover. The hook positions the popover
-  // relative to the trigger element via CSS Anchor Positioning (with JS fallback).
-  // Use ctx.popoverRef when inside the compound (so the trigger can also
-  // reach the same DOM element for togglePopover). Otherwise use a local ref.
-  var localRef = useRef(null);
-  var popoverRef = (_ctx$popoverRef = ctx === null || ctx === void 0 ? void 0 : ctx.popoverRef) !== null && _ctx$popoverRef !== void 0 ? _ctx$popoverRef : localRef;
-  useAnchorPosition({
-    anchorRef: triggerRef !== null && triggerRef !== void 0 ? triggerRef : {
-      current: null
-    },
-    popoverRef: popoverRef,
-    placement: placement,
-    forceFallbackPositioning: forceFallbackPositioning
-  });
-  useWidthFromAnchor({
-    mode: widthFromAnchor,
-    popoverRef: popoverRef,
-    anchorRef: triggerRef
-  });
-
-  // Merge: the popoverRef (shared with trigger + positioning) and the forwarded ref.
-  var combinedRef = mergeRefs([popoverRef, ref]);
-
-  // TPopupContentProps already validates the discriminated union (role + label,
-  // mode + onClose) at its API boundary. Popover accepts TPopoverForwardedProps
-  // internally so individual prop forwarding does not need to re-prove the union.
-  var popoverProps = {
-    isOpen: isOpen,
-    animate: animate,
-    placement: placement,
-    mode: mode,
-    role: role,
-    label: label,
-    labelledBy: labelledBy,
-    onClose: onClose !== null && onClose !== void 0 ? onClose : undefined,
-    onOpenChange: handleOpenChange,
-    onEnterFinish: handleEnterFinish,
-    onExitFinish: handleExitFinish,
-    testId: testId,
-    children: children,
-    // Standalone consumers can pass an explicit `id` - used by their own
-    // trigger to wire `aria-controls`. Inside the `<Popup>` compound, the
-    // id flows from context (`ctx.popoverId`).
-    id: idProp !== null && idProp !== void 0 ? idProp : ctx === null || ctx === void 0 ? void 0 : ctx.popoverId,
-    xcss: xcss
-  };
-  return /*#__PURE__*/React.createElement(Popover, _extends({
-    ref: combinedRef
-  }, popoverProps));
-});

package/dist/esm/popup/popup-context.js

@@ -1,20 +0,0 @@
-import { createContext } from 'react';
-
-/**
- * Represents the lifecycle state of the popup.
- *
- * - `'closed'`: fully closed, not visible, no animation playing.
- * - `'animating-open'`: entry animation is playing (popup is opening but not yet settled).
- * - `'open'`: fully open, browser popover is showing, entry animation complete.
- * - `'animating-closed'`: exit animation is playing (popup is closing but still visible).
- *
- * Used to derive `aria-expanded` on the trigger:
- * - `aria-expanded` is `true` in `'animating-open'`, `'open'`, and `'animating-closed'`.
- *
- * This avoids screen readers announcing the popup as closed while it is
- * still visually present on screen during animations, and prevents consumers
- * that conditionally show/hide trigger UI based on `aria-expanded` from hiding
- * the trigger (and thus the popup anchor) mid-animation.
- */
-
-export var PopupContext = /*#__PURE__*/createContext(null);

package/dist/esm/popup/popup-provider.js

@@ -1,10 +0,0 @@
-import { PopupContext } from './popup-context';
-
-/**
- * __Popup provider__
- *
- * Provides shared popup state (placement, popoverId, triggerRef,
- * isOpen, onClose) to compound child components such as `Popup.Trigger` and
- * `Popup.Content`.
- */
-export var PopupProvider = PopupContext.Provider;

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

@@ -1,29 +0,0 @@
-/* popup-surface.tsx generated by @compiled/babel-plugin v0.39.1 */
-import "./popup-surface.compiled.css";
-import { ax, ix } from "@compiled/react/runtime";
-import React from 'react';
-var styles = {
-  root: "_2rkofajl _1reo1wug _18m91wug _bfhk1bhr _16qs130s"
-};
-
-/**
- * Optional styled wrapper for popup content.
- *
- * Adds default visual styling (background, border-radius, box-shadow)
- * using design tokens. Consumers who want fully custom styling
- * should use `Popup.Content` without wrapping in `PopupSurface`.
- *
- * Exposed as `Popup.Surface` on the compound component.
- *
- * **Presentational primitive - `children`-only by design.** This component
- * intentionally exposes no `style`, `className`, `xcss`, `id`, or `ref`
- * props. If you need any of those, render your own wrapper element inside
- * `Popup.Content` instead - `PopupSurface` is the no-config "give me the
- * default ADS overlay look" surface, nothing more.
- */
-export function PopupSurface(_ref) {
-  var children = _ref.children;
-  return /*#__PURE__*/React.createElement("div", {
-    className: ax([styles.root])
-  }, children);
-}

package/dist/esm/popup/popup-trigger-function.js

@@ -1,75 +0,0 @@
-import { useCallback, useMemo } from 'react';
-import { usePopupContext } from './use-popup-context';
-
-/**
- * Props passed to the `TriggerFunction` render-prop child.
- */
-
-/**
- * Render-prop alternative to `Popup.Trigger`.
- *
- * Use when you need full control over the trigger element. For example,
- * to compose your own trigger with custom event handlers, wrap a third-party
- * component, or build a trigger from multiple elements.
- *
- * `Popup.Trigger` uses `cloneElement` internally, which limits composability.
- * `Popup.TriggerFunction` hands you the raw props and lets you wire them up.
- *
- * **Note:** This sub-component uses a render-prop pattern and is not
- * compatible with React Server Components (RSC). It must be used inside
- * a client component boundary (`'use client'`).
- *
- * @example
- * ```tsx
- * <Popup placement={{ edge: 'end' }} onClose={handleClose}>
- *   <Popup.TriggerFunction>
- *     {({ ref, toggle, ariaAttributes }) => (
- *       <button ref={ref} onClick={toggle} {...ariaAttributes}>
- *         Open
- *       </button>
- *     )}
- *   </Popup.TriggerFunction>
- *   <Popup.Content role="dialog" label="My popup">
- *     Content
- *   </Popup.Content>
- * </Popup>
- * ```
- */
-export function PopupTriggerFunction(_ref) {
-  var children = _ref.children;
-  var _usePopupContext = usePopupContext(),
-    triggerRef = _usePopupContext.triggerRef,
-    popoverRef = _usePopupContext.popoverRef,
-    popoverId = _usePopupContext.popoverId,
-    popupState = _usePopupContext.popupState,
-    ariaHasPopup = _usePopupContext.ariaHasPopup;
-  var ref = useCallback(function (node) {
-    triggerRef.current = node;
-  }, [triggerRef]);
-  var toggle = useCallback(function () {
-    var popoverEl = popoverRef.current;
-    if (popoverEl) {
-      // Defensive: element may be disconnected or in an unexpected state.
-      try {
-        popoverEl.togglePopover();
-      } catch (_unused) {}
-    }
-  }, [popoverRef]);
-  var ariaAttributes = useMemo(function () {
-    return {
-      // aria-expanded stays true throughout entry and exit animations so screen readers
-      // don't announce the popup as closed while it's still visible, and consumers
-      // relying on aria-expanded to show/hide trigger UI don't lose the anchor mid-animation.
-      'aria-expanded': popupState === 'open' || popupState === 'animating-open' || popupState === 'animating-closed',
-      'aria-controls': popoverId,
-      'aria-haspopup': ariaHasPopup
-    };
-  }, [popupState, popoverId, ariaHasPopup]);
-  return children({
-    ref: ref,
-    isOpen: popupState === 'open' || popupState === 'animating-open',
-    popoverId: popoverId,
-    toggle: toggle,
-    ariaAttributes: ariaAttributes
-  });
-}

package/dist/esm/popup/popup-trigger.js

@@ -1,59 +0,0 @@
-import React, { isValidElement, useCallback } from 'react';
-import { Slot } from '../internal/slot';
-import { usePopupContext } from './use-popup-context';
-
-/**
- * Wraps a single trigger element via `cloneElement`. Attaches aria
- * attributes, the toggle handler, and the anchor-name. `aria-haspopup`
- * is derived from `Popup.Content`'s role via context.
- *
- * Child constraints: must be a single ref-forwarding element. The child's
- * `onClick` is composed (runs after); other event handlers are NOT.
- * Children using Compiled's `css` prop swallow injected props - use
- * `Popup.TriggerFunction` for these cases or any time you need handler
- * composition.
- */
-export function PopupTrigger(_ref) {
-  var children = _ref.children;
-  var _usePopupContext = usePopupContext(),
-    triggerRef = _usePopupContext.triggerRef,
-    popoverRef = _usePopupContext.popoverRef,
-    popoverId = _usePopupContext.popoverId,
-    popupState = _usePopupContext.popupState,
-    ariaHasPopup = _usePopupContext.ariaHasPopup;
-  var childOnClick = /*#__PURE__*/isValidElement(children) ? children.props.onClick : undefined;
-
-  // Use a ref to track the latest isOpen value so the click handler
-  // does not need isOpen in its dependency array (which would recreate
-  // the handler on every open/close, breaking cloneElement identity).
-  var isOpenRef = React.useRef(popupState === 'open' || popupState === 'animating-open');
-  isOpenRef.current = popupState === 'open' || popupState === 'animating-open';
-  var handleClick = useCallback(function (event) {
-    var popoverEl = popoverRef.current;
-    if (popoverEl) {
-      // `popover="auto"` light-dismiss can close the popover BEFORE
-      // our click handler runs, so trust React's isOpen rather than
-      // DOM state. If React still thinks it is closed, open it; if
-      // it was open, the browser already closed it.
-      if (!isOpenRef.current) {
-        try {
-          popoverEl.showPopover();
-        } catch (_unused) {
-          // Element may be disconnected; ignore.
-        }
-      }
-    }
-    childOnClick === null || childOnClick === void 0 || childOnClick(event);
-  }, [popoverRef, childOnClick]);
-  return /*#__PURE__*/React.createElement(Slot, {
-    ref: triggerRef,
-    onClick: handleClick
-    // aria-expanded stays true throughout entry and exit animations so screen readers
-    // don't announce the popup as closed while it's still visible, and consumers
-    // relying on aria-expanded to show/hide trigger UI don't lose the anchor mid-animation.
-    ,
-    "aria-expanded": popupState === 'open' || popupState === 'animating-open' || popupState === 'animating-closed',
-    "aria-controls": popoverId,
-    "aria-haspopup": ariaHasPopup
-  }, children);
-}

package/dist/esm/popup/popup.js

@@ -1,72 +0,0 @@
-import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
-import React, { useCallback, useId, useRef, useState } from 'react';
-import { PopupProvider } from './popup-provider';
-/**
- * Popup compound: trigger + popover content.
- *
- * Use when a button opens anchored content (dropdown, menu, dialog).
- * The browser manages visibility via `togglePopover()`; the consumer
- * never manages `isOpen`. For custom trigger lifecycles (hover, timers,
- * external state), use `Popover` directly instead.
- *
- * Provides context (triggerRef, placement, isOpen, onClose, mode) that
- * `Popup.Content` reads and forwards to the underlying `Popover`.
- */
-export function PopupRoot(props) {
-  var _props$placement, _props$mode;
-  var children = props.children,
-    testId = props.testId,
-    forceFallbackPositioning = props.forceFallbackPositioning,
-    onOpenChange = props.onOpenChange;
-  // `{}` resolves to "below the trigger, centered, with `space.100` gap"
-  // inside `useAnchorPosition`, which is the common case.
-  var placement = (_props$placement = props.placement) !== null && _props$placement !== void 0 ? _props$placement : {};
-  var mode = (_props$mode = props.mode) !== null && _props$mode !== void 0 ? _props$mode : 'auto';
-
-  // `TPopupProps` discriminates on `mode`: `manual` types `onClose` as
-  // `never`, so for manual consumers `props.onClose` is always `undefined`
-  // here. No runtime guard needed; the type contract carries the rule.
-  var onClose = props.onClose;
-  var id = useId();
-  // `useId()` returns IDs containing colons (`:r1:`), which are invalid
-  // in CSS selectors and `popover` target attributes. `replaceAll` is
-  // not in our browser matrix.
-  var sanitizedId = id.replace(/:/g, '');
-  var popoverId = "popover-".concat(sanitizedId);
-  var triggerRef = useRef(null);
-  var popoverRef = useRef(null);
-  var _useState = useState('closed'),
-    _useState2 = _slicedToArray(_useState, 2),
-    popupState = _useState2[0],
-    setPopupState = _useState2[1];
-  // Initial seed before `Popup.Content`'s layout effect resolves the
-  // real role on first paint.
-  var _useState3 = useState('dialog'),
-    _useState4 = _slicedToArray(_useState3, 2),
-    ariaHasPopup = _useState4[0],
-    setAriaHasPopup = _useState4[1];
-  var handleClose = useCallback(function (args) {
-    onClose === null || onClose === void 0 || onClose(args);
-  }, [onClose]);
-  var contextValue = {
-    popoverId: popoverId,
-    placement: placement,
-    // `null` when the consumer did not supply a handler (manual mode, or
-    // auto/hint without a light-dismiss handler). `Popup.Content` reads
-    // this to decide whether to forward an `onClose` to `Popover`.
-    onClose: onClose ? handleClose : null,
-    triggerRef: triggerRef,
-    popoverRef: popoverRef,
-    popupState: popupState,
-    setPopupState: setPopupState,
-    onOpenChange: onOpenChange,
-    mode: mode,
-    ariaHasPopup: ariaHasPopup,
-    setAriaHasPopup: setAriaHasPopup,
-    testId: testId,
-    forceFallbackPositioning: forceFallbackPositioning
-  };
-  return /*#__PURE__*/React.createElement(PopupProvider, {
-    value: contextValue
-  }, children);
-}

package/dist/esm/popup/types.js

@@ -1 +0,0 @@
-export {};

package/dist/esm/popup/use-maybe-popup-context.js

@@ -1,12 +0,0 @@
-import { useContext } from 'react';
-import { PopupContext } from './popup-context';
-
-/**
- * Returns the popup context if available, or `null` when used outside `<Popup>`.
- *
- * Used by `PopupContent` to support standalone usage (e.g. tooltip)
- * where values are passed as props instead of coming from a compound component.
- */
-export function useMaybePopupContext() {
-  return useContext(PopupContext);
-}

package/dist/esm/popup/use-popup-context.js

@@ -1,15 +0,0 @@
-import { useContext } from 'react';
-import { PopupContext } from './popup-context';
-
-/**
- * Returns the nearest `Popup` context value.
- *
- * Throws if called outside of a `<Popup>` compound component.
- */
-export function usePopupContext() {
-  var ctx = useContext(PopupContext);
-  if (ctx === null) {
-    throw new Error('@atlaskit/top-layer: Popup compound components must be used within <Popup>.');
-  }
-  return ctx;
-}

package/dist/types/entry-points/popup-surface.d.ts

@@ -1,2 +0,0 @@
-export { PopupSurface } from '../popup/popup-surface';
-export type { TPopupSurfaceProps } from '../popup/types';

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

@@ -1,2 +0,0 @@
-export { Popup } from '../popup';
-export type { TPlacementOptions, TPopupProps, TPopupContentProps, TPopupRole, TPopupTriggerProps, TTriggerFunctionRenderProps, } from '../popup';

package/dist/types/popup/index.d.ts

@@ -1,34 +0,0 @@
-import { PopupRoot } from './popup';
-import { PopupContent } from './popup-content';
-import { PopupSurface } from './popup-surface';
-import { PopupTrigger } from './popup-trigger';
-import { PopupTriggerFunction } from './popup-trigger-function';
-/**
- * Compound component for rendering content in the browser's top layer
- * using the native Popover API (`popover="auto"`).
- * Placement is owned by this compound: root provides it via context, Content applies it
- * (CSS Anchor Positioning or JS fallback).
- *
- * For default overlay styling (background, shadow, border-radius), see `PopupSurface` in the package examples.
- *
- * @example
- * ```tsx
- * <Popup placement={{ edge: 'end' }} onClose={handleClose}>
- *   <Popup.Trigger>
- *     <button>Open</button>
- *   </Popup.Trigger>
- *   <Popup.Content role="dialog" label="My popup">
- *     Content goes here
- *   </Popup.Content>
- * </Popup>
- * ```
- */
-declare const Popup: typeof PopupRoot & {
-    Trigger: typeof PopupTrigger;
-    TriggerFunction: typeof PopupTriggerFunction;
-    Content: typeof PopupContent;
-    Surface: typeof PopupSurface;
-};
-export { Popup };
-export type { TPlacementOptions, TPopupProps, TPopupContentProps, TPopupRole, TPopupSurfaceProps, TPopupTriggerProps, } from './types';
-export type { TTriggerFunctionRenderProps } from './popup-trigger-function';

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

@@ -1,14 +0,0 @@
-/**
- * @jsxRuntime classic
- * @jsx jsx
- */
-import React from 'react';
-import { type TPopupContentProps } from './types';
-/**
- * Thin context wrapper that composes `Popover` + `useAnchorPosition`.
- *
- * Used inside the `<Popup>` compound - reads triggerRef, placement, isOpen,
- * and onClose from context. For standalone usage (tooltip, spotlight, flag),
- * use `Popover` + `useAnchorPosition` directly.
- */
-export declare const PopupContent: React.ForwardRefExoticComponent<TPopupContentProps & React.RefAttributes<HTMLDivElement>>;

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

@@ -1,96 +0,0 @@
-import React, { type MutableRefObject, type RefObject } from 'react';
-import { type TAriaHasPopupValue } from '../internal/role-types';
-import { type TPopoverCloseReason } from '../popover/types';
-import { type TPlacementOptions } from './types';
-/**
- * Represents the lifecycle state of the popup.
- *
- * - `'closed'`: fully closed, not visible, no animation playing.
- * - `'animating-open'`: entry animation is playing (popup is opening but not yet settled).
- * - `'open'`: fully open, browser popover is showing, entry animation complete.
- * - `'animating-closed'`: exit animation is playing (popup is closing but still visible).
- *
- * Used to derive `aria-expanded` on the trigger:
- * - `aria-expanded` is `true` in `'animating-open'`, `'open'`, and `'animating-closed'`.
- *
- * This avoids screen readers announcing the popup as closed while it is
- * still visually present on screen during animations, and prevents consumers
- * that conditionally show/hide trigger UI based on `aria-expanded` from hiding
- * the trigger (and thus the popup anchor) mid-animation.
- */
-export type TPopupState = 'closed' | 'animating-open' | 'open' | 'animating-closed';
-export type TPopupContextValue = {
-    /**
-     * Auto-generated ID for the popover content element (used for aria-controls).
-     */
-    popoverId: string;
-    /**
-     * Requested placement.
-     */
-    placement: TPlacementOptions;
-    /**
-     * Called when the popover is dismissed via light dismiss.
-     * `null` when mode is 'manual' (no light dismiss).
-     */
-    onClose: ((args: {
-        reason: TPopoverCloseReason;
-    }) => void) | null;
-    /**
-     * Mutable ref to the trigger element (set by Popup.Trigger / Popup.TriggerFunction).
-     */
-    triggerRef: MutableRefObject<HTMLElement | null>;
-    /**
-     * Ref to the popover content element (set by Popup.Content).
-     */
-    popoverRef: RefObject<HTMLDivElement | null>;
-    /**
-     * The full lifecycle state of the popup.
-     *
-     * See `TPopupState` for the full state machine description.
-     */
-    popupState: TPopupState;
-    /**
-     * Updates the popup lifecycle state. Called by `PopupContent` as animations
-     * begin and complete.
-     */
-    setPopupState: (state: TPopupState) => void;
-    /**
-     * Consumer's onOpenChange callback, forwarded to the Popover.
-     */
-    onOpenChange?: (args: {
-        isOpen: boolean;
-        element: HTMLDivElement;
-    }) => void;
-    /**
-     * Native popover mode. Flows from the Popup root to Content via context.
-     */
-    mode: 'auto' | 'hint' | 'manual';
-    /**
-     * The `aria-haspopup` value derived from the content's role.
-     *
-     * Set by `Popup.Content` via `setAriaHasPopup` when it renders.
-     * Read by `Popup.Trigger` / `Popup.TriggerFunction` to set
-     * the correct `aria-haspopup` on the trigger element.
-     *
-     * This flows the content's role to the trigger without requiring
-     * the consumer to specify the role in two places. The trigger
-     * renders with the default ('dialog') on first paint; Content's
-     * layout effect updates it before the browser paints.
-     */
-    ariaHasPopup: TAriaHasPopupValue;
-    /**
-     * Updates `ariaHasPopup` - called by Content on mount/role change.
-     */
-    setAriaHasPopup: (value: TAriaHasPopupValue) => void;
-    /**
-     * Test ID prefix.
-     */
-    testId?: string;
-    /**
-     * Forces the JavaScript positioning fallback even when the browser
-     * supports CSS Anchor Positioning. Useful for testing fallback
-     * behavior in any environment, including production.
-     */
-    forceFallbackPositioning?: boolean;
-};
-export declare const PopupContext: React.Context<TPopupContextValue | null>;