@atlaskit/top-layer 0.16.0 → 0.18.0

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

@@ -1,126 +0,0 @@
-import { type CSSProperties, type ReactNode } from 'react';
-import { type TAnimationPreset } from '../animations/types';
-/**
- * Close reasons produced by the Dialog primitive.
- *
- * - `'escape'`: user pressed Escape (native `cancel` event on `<dialog>`).
- * - `'overlay-click'`: user clicked the backdrop / overlay area.
- *
- * Consumer-initiated ("programmatic") close is not a reason the primitive
- * produces. The consumer simply sets `isOpen={false}`.
- */
-export type TDialogCloseReason = 'escape' | 'overlay-click';
-/**
- * Props shared across `TDialogProps` variants.
- *
- * The accessible-name requirement (one of `label` or `labelledBy`) is encoded
- * in the discriminated union below - WCAG 4.1.2 violations are caught at
- * compile time instead of in production audit reports.
- */
-type TDialogBaseProps = {
-    children: ReactNode;
-    /**
-     * 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.
-     *
-     * **Lifecycle observable to consumers:**
-     *
-     * - The `<dialog>` host element is in the DOM only while open or its exit
-     *   animation is playing. After exit completes the element is unmounted so
-     *   it does not leave an empty `role="dialog"` element in the accessibility
-     *   tree. The exact unmount timing is private and may change.
-     * - The `id` (supplied or generated) is stable across opens.
-     * - The `ref` is populated only while the host element is rendered. Consumers
-     *   that read from the ref should gate the read on `isOpen` being `true`.
-     */
-    isOpen: boolean;
-    /**
-     * Called when the user triggers close via Escape or backdrop click.
-     *
-     * The dialog does **not** close itself. The consumer decides whether to
-     * set `isOpen={false}` (e.g. gate by reason).
-     */
-    onClose: (args: {
-        reason: TDialogCloseReason;
-    }) => void;
-    /**
-     * Animation preset for entry/exit transitions.
-     *
-     * Pass an `TAnimationPreset` (e.g. `dialogSlideUpAndFade()`) to enable
-     * CSS-based entry and exit animation. Pass `false` (or omit) to disable.
-     */
-    animate?: TAnimationPreset | false;
-    /**
-     * Additional inline styles applied to the `<dialog>` element.
-     *
-     * Use for custom width, height, transform, or other overrides.
-     */
-    style?: CSSProperties;
-    /**
-     * Test ID applied to the `<dialog>` element.
-     */
-    testId?: string;
-    /**
-     * HTML `id` attribute for the `<dialog>` element.
-     */
-    id?: string;
-    /**
-     * When true, the `::backdrop` pseudo-element is rendered transparent.
-     *
-     * Useful for stacked dialogs where only the foreground dialog should
-     * show a visible backdrop, or when the consumer wants no overlay.
-     */
-    shouldHideBackdrop?: boolean;
-    /**
-     * Called after the exit animation completes (or immediately on close when
-     * there is no animation or reduced motion is active).
-     *
-     * Use this for external lifecycle coordination, e.g. firing an
-     * `onCloseComplete` callback or notifying ExitingPersistence.
-     */
-    onExitFinish?: () => void;
-};
-/**
- * Props for the `Dialog` primitive.
- *
- * Low-level wrapper around the native `<dialog>` element.
- * Manages visibility (`showModal()` / `close()`), animation, Escape handling,
- * and backdrop-click detection. Has no visual opinions - no width, height,
- * background, border-radius, or layout. Consumers (e.g. `@atlaskit/modal-dialog`)
- * provide their own visual styling.
- *
- * Discriminated on the accessible-name source: at least one of `label`
- * (aria-label) or `labelledBy` (aria-labelledby) must be provided. This
- * enforces WCAG 4.1.2 at the type level - an unlabelled dialog landmark
- * is not constructible. Mirrors the pattern used by `TPopupContentProps`.
- */
-export type TDialogProps = TDialogBaseProps & ({
-    /**
-     * Accessible label (`aria-label`).
-     *
-     * When provided, `aria-labelledby` is not set.
-     * Use when there is no visible title element to reference.
-     */
-    label: string;
-    /**
-     * ID of the element that labels the dialog (`aria-labelledby`).
-     *
-     * Ignored when `label` is provided.
-     */
-    labelledBy?: string;
-} | {
-    /**
-     * Accessible label (`aria-label`).
-     *
-     * Optional when `labelledBy` is provided.
-     */
-    label?: string;
-    /**
-     * ID of the element that labels the dialog (`aria-labelledby`).
-     */
-    labelledBy: string;
-});
-export {};

package/dist/types-ts4.5/dialog-scroll-lock/index.d.ts

@@ -1,40 +0,0 @@
-type TDialogScrollLockProps = {
-    /**
-     * Whether the parent dialog is open. The scroll lock is applied while
-     * `true` and released the moment this flips to `false`, regardless of
-     * when (or whether) React unmounts this component. Pass the same
-     * `isOpen` value you pass to the parent `Dialog`.
-     */
-    isOpen: boolean;
-};
-/**
- * __DialogScrollLock__
- *
- * Prevents background page scrolling while a dialog is open. Designed to be
- * rendered inside a `Dialog` and given the same `isOpen` value.
- *
- * Native `<dialog>.showModal()` makes background content _inert_ (not
- * focusable/clickable), but does **not** prevent scroll events from reaching
- * the document body. This component fills that gap by setting
- * `overflow: hidden` on `document.body` while `isOpen` is `true`.
- *
- * The lock is driven by `isOpen` rather than by mount/unmount so that release
- * happens synchronously in the same commit that flips `isOpen` to `false`.
- * Relying on unmount alone was racy: `Dialog` defers the unmount of its
- * children until the host element's close/toggle event fires, which can be
- * after a consumer or test observes the dialog as hidden, leading to a
- * stale `overflow: hidden` window.
- *
- * @example
- * ```tsx
- * import { Dialog } from '@atlaskit/top-layer/dialog';
- * import { DialogScrollLock } from '@atlaskit/top-layer/dialog-scroll-lock';
- *
- * <Dialog isOpen={isOpen} onClose={onClose}>
- *   <DialogScrollLock isOpen={isOpen} />
- *   {children}
- * </Dialog>
- * ```
- */
-export declare function DialogScrollLock({ isOpen }: TDialogScrollLockProps): null;
-export {};

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

@@ -1,2 +0,0 @@
-export { slideAndFade, fade, scaleAndFade, dialogSlideUpAndFade, dialogFade, } from '../animations/presets';
-export type { TAnimationPreset } from '../animations/types';

package/dist/types-ts4.5/entry-points/dialog-scroll-lock.d.ts

@@ -1 +0,0 @@
-export { DialogScrollLock } from '../dialog-scroll-lock';

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

@@ -1,2 +0,0 @@
-export { createCloseEvent, Dialog } from '../dialog';
-export type { TDialogCloseReason, TDialogProps } from '../dialog';

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

@@ -1,4 +0,0 @@
-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/get-aria-for-trigger.d.ts

@@ -1 +0,0 @@
-export { getAriaForTrigger } from '../internal/get-aria-for-trigger';

package/dist/types-ts4.5/entry-points/open-layer-observer.d.ts

@@ -1,5 +0,0 @@
-export { OpenLayerObserver } from '@atlaskit/layering/experimental/open-layer-observer/open-layer-observer';
-export { useNotifyOpenLayerObserver } from '@atlaskit/layering/experimental/use-notify-open-layer-observer';
-export { useOpenLayerObserver } from '@atlaskit/layering/experimental/use-open-layer-observer';
-export { OpenLayerObserverNamespaceProvider } from '@atlaskit/layering/experimental/open-layer-observer-namespace-provider';
-export type { LayerType } from '@atlaskit/layering/experimental/types';

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

@@ -1,3 +0,0 @@
-export { fromLegacyPlacement } from '../placement-map';
-export { LEGACY_PLACEMENTS } from '../placement-map/legacy-placements';
-export type { TLegacyPlacement, TPlacementOptions } from '../placement-map';

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

@@ -1,2 +0,0 @@
-export { PopoverSurface } from '../popover-surface';
-export type { TPopoverSurfaceProps } from '../popover-surface';

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

@@ -1,2 +0,0 @@
-export { createPopoverCloseEvent, Popover } from '../popover';
-export type { TPopoverProps, TPopoverCloseReason, TPlacementOptions } from '../popover';

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

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

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

@@ -1 +0,0 @@
-export { useAnchorPosition } from '../internal/use-anchor-position';

package/dist/types-ts4.5/entry-points/use-arrow-navigation.d.ts

@@ -1,3 +0,0 @@
-export { useArrowNavigation } from '../use-arrow-navigation';
-export type { TUseArrowNavigationArgs } from '../use-arrow-navigation';
-export { isAtCurrentMenuLevel } from '../use-arrow-navigation/is-at-current-menu-level';

package/dist/types-ts4.5/entry-points/use-popover-id.d.ts

@@ -1,11 +0,0 @@
-/**
- * Returns a stable HTML `id` used to wire a trigger element to its popover
- * via ARIA (`aria-controls`) and the Popover API (`popovertarget`).
- *
- * The returned value is intended for the `id` attribute on the popover and
- * for the matching `aria-controls` / `popovertarget` references on the
- * trigger. It is NOT a CSS `anchor-name` value: CSS anchor positioning is
- * handled internally by `useAnchorPosition`, which mints and applies its
- * own `anchor-name` on the trigger element.
- */
-export declare function usePopoverId(): string;

package/dist/types-ts4.5/entry-points/use-simple-light-dismiss.d.ts

@@ -1,2 +0,0 @@
-export { useSimpleLightDismiss } from '../use-simple-light-dismiss';
-export type { TUseSimpleLightDismissOptions } from '../use-simple-light-dismiss';

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

@@ -1 +0,0 @@
-export { useWidthFromAnchor } from '../internal/use-width-from-anchor';

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

@@ -1,8 +0,0 @@
-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

@@ -1,13 +0,0 @@
-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

@@ -1,8 +0,0 @@
-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

@@ -1,13 +0,0 @@
-/**
- * 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

@@ -1,8 +0,0 @@
-/**
- * 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

@@ -1,8 +0,0 @@
-/**
- * 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

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

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

@@ -1,5 +0,0 @@
-/**
- * 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/anchor-positioning-fallback.d.ts

@@ -1,26 +0,0 @@
-import { type TPlacement } from './resolve-placement';
-/**
- * Computes popover position from trigger rect and viewport, flipping to
- * the side with more space when needed. Re-runs on scroll/resize.
- *
- * `gap` and `crossAxisShift` are pre-resolved to pixels by the
- * caller (see `resolveCssLengthToPixels`), so this function stays purely
- * numeric.
- */
-export declare function computeFallbackPosition({ triggerRect, popoverEl, placement, viewport, gap, crossAxisShift, }: {
-    triggerRect: DOMRect;
-    popoverEl: HTMLElement;
-    placement: TPlacement;
-    viewport: {
-        width: number;
-        height: number;
-    };
-    gap: number;
-    crossAxisShift: {
-        value: number;
-        direction: 'forwards' | 'backwards';
-    };
-}): {
-    top: number;
-    left: number;
-};

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

@@ -1,14 +0,0 @@
-/**
- * Combine multiple cleanup functions into a single cleanup function.
- *
- * @example
- * ```ts
- * useEffect(() => {
- *   return combine(
- *     bind(window, { type: 'resize', listener: onResize }),
- *     bind(window, { type: 'scroll', listener: onScroll, options: { capture: true } }),
- *   );
- * }, []);
- * ```
- */
-export declare function combine(...cleanupFns: ((() => void) | undefined)[]): () => void;

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

@@ -1,6 +0,0 @@
-export declare function ensurePresetStyles({ preset }: {
-    preset: {
-        css: string;
-        name: string;
-    };
-}): void;

package/dist/types-ts4.5/internal/get-aria-for-trigger.d.ts

@@ -1,93 +0,0 @@
-import { type TAriaHasPopupValue, type TRoleRequiringAccessibleName } from './role-types';
-/**
- * Roles accepted by `getAriaForTrigger`.
- *
- * Excludes tooltip-family roles (`tooltip`, `note`, `status`, `alert`, `log`)
- * because the correct trigger wiring for those is `aria-describedby`, not
- * `aria-haspopup` / `aria-expanded` / `aria-controls`. Use `aria-describedby`
- * manually for tooltip triggers.
- */
-type TAriaForTriggerRole = TRoleRequiringAccessibleName | 'listbox' | 'tree' | 'grid';
-type TGetAriaForTriggerOptions = {
-    /**
-     * The `role` that will be set on the `<Popover>` element. Used to derive
-     * the correct `aria-haspopup` value for the trigger.
-     */
-    role: TAriaForTriggerRole;
-    /**
-     * Whether the popover is currently open. Drives `aria-expanded`.
-     */
-    isOpen: boolean;
-    /**
-     * The popover identifier - the value returned by `usePopoverId()`,
-     * passed as `id` to `<Popover>` and referenced here via `aria-controls`.
-     */
-    popoverId: string;
-};
-/**
- * Non-undefined subset of `TAriaHasPopupValue`. Every role accepted by
- * `getAriaForTrigger` maps to a concrete `aria-haspopup` string, so the
- * trigger always receives a defined attribute value.
- */
-type TAriaHasPopupForTrigger = Exclude<TAriaHasPopupValue, undefined>;
-type TAriaForTrigger = {
-    'aria-haspopup': TAriaHasPopupForTrigger;
-    'aria-expanded': boolean;
-    /**
-     * `aria-controls` is `undefined` while the popover is closed, because
-     * the popover host element is only rendered in the DOM while open. A
-     * dangling `aria-controls` reference (pointing at a missing ID) is
-     * tolerated by assistive tech but flagged by some a11y tooling, so
-     * we leave it unset until the target exists.
-     */
-    'aria-controls': string | undefined;
-};
-/**
- * Returns the ARIA attributes to spread onto a click-activated popover trigger.
- *
- * Centralises three attributes that are easy to forget or get wrong individually:
- *
- * - `aria-haspopup` - derived from the popover's role (e.g. `dialog → "dialog"`,
- *   `menu → "menu"`, `tooltip → undefined`). React omits the attribute when
- *   the value is `undefined`.
- * - `aria-expanded` - reflects the current open state.
- * - `aria-controls` - references the popover element by its id, even
- *   while the popover is closed. The relationship is stable; `aria-expanded`
- *   carries the current visibility state.
- *
- * **This function is for click/keyboard-activated popovers only.** For
- * hover-driven tooltips, the trigger should use `aria-describedby` instead.
- *
- * @example
- * ```tsx
- * import { getAriaForTrigger } from '@atlaskit/top-layer/get-aria-for-trigger';
- * import { usePopoverId } from '@atlaskit/top-layer/use-popover-id';
- *
- * const popoverId = usePopoverId();
- * const [isOpen, setIsOpen] = useState(false);
- *
- * return (
- *   <>
- *     <button
- *       ref={triggerRef}
- *       onClick={() => setIsOpen((previous) => !previous)}
- *       {...getAriaForTrigger({ role: 'dialog', isOpen, popoverId })}
- *     >
- *       Open
- *     </button>
- *     <Popover
- *       id={popoverId}
- *       role="dialog"
- *       label="My dialog"
- *       isOpen={isOpen}
- *       triggerRef={triggerRef}
- *       onClose={() => setIsOpen(false)}
- *     >
- *       …
- *     </Popover>
- *   </>
- * );
- * ```
- */
-export declare function getAriaForTrigger({ role, isOpen, popoverId, }: TGetAriaForTriggerOptions): TAriaForTrigger;
-export {};

package/dist/types-ts4.5/internal/placement-to-position-area.d.ts

@@ -1,21 +0,0 @@
-import { type TPlacementOptions } from '../internal/resolve-placement';
-/**
- * Resolves placement options to CSS `position-area` syntax.
- *
- * The `align` field represents the *visual* alignment:
- * - `align: 'start'` means "aligned to the trigger's start edge" (left in LTR for block axis)
- * - `align: 'end'` means "aligned to the trigger's end edge"
- * - `align: 'center'` means centered (single-axis position-area)
- *
- * CSS `position-area` uses `span-*` keywords which indicate the *expansion direction*.
- * Visual start-alignment requires `span-{cross-axis}-end` (expand toward end = start-aligned).
- * This function handles the inversion internally.
- *
- * @example
- * placementToPositionArea({ placement: { axis: 'block', edge: 'end', align: 'center' } }) // → 'block-end'
- * placementToPositionArea({ placement: { axis: 'block', edge: 'end', align: 'start' } }) // → 'block-end span-inline-end'
- * placementToPositionArea({ placement: { axis: 'block', edge: 'end', align: 'end' } })   // → 'block-end span-inline-start'
- */
-export declare function placementToPositionArea({ placement }: {
-    placement: TPlacementOptions;
-}): string;

package/dist/types-ts4.5/internal/placement-to-try-fallbacks.d.ts

@@ -1,36 +0,0 @@
-import { type TPlacementOptions } from '../internal/resolve-placement';
-/**
- * Returns `position-try-fallbacks` value based on placement.
- *
- * For centered placements, includes cross-axis aligned position-area
- * values so the browser can shift the popover along the cross-axis
- * when the centered position would overflow the viewport edge.
- *
- * Fallback order for centered placements (e.g. `block-end`):
- * 1. Same edge, start-aligned (shift for near-edge overflow)
- * 2. Same edge, end-aligned (shift for far-edge overflow)
- * 3. Flipped edge, centered
- * 4. Flipped edge, start-aligned
- * 5. Flipped edge, end-aligned
- *
- * For aligned placements (start/end), includes the same-edge centered
- * position as fallbacks so the browser can try centering when the aligned
- * position would overflow, before flipping to the opposite edge.
- *
- * **Why `flip-inline flip-block` (or `flip-block flip-inline`) is included:**
- *
- * When a popup is in a viewport corner (e.g. inline-end align-end at the
- * top-right), flipping only the primary axis (`flip-inline`) moves the popup
- * to the left but keeps the same cross-axis span direction (e.g. upward),
- * which is still off-screen. The combined keyword `flip-inline flip-block`
- * mirrors the popup diagonally. It flips BOTH the position-area AND both
- * inline and block margins simultaneously, placing the popup at the
- * diagonally opposite corner where there is always space.
- *
- * Named `position-area` entries (e.g. `inline-start span-block-end`) in
- * `position-try-fallbacks` do NOT update margins, so only the `flip-*`
- * tactic keywords correctly flip the gap margin along with the position.
- */
-export declare function placementToTryFallbacks({ placement }: {
-    placement: TPlacementOptions;
-}): string;

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

@@ -1,14 +0,0 @@
-/**
- * Returns `true` when the user prefers reduced motion.
- *
- * Safe for SSR (returns `false` when `window` is unavailable).
- *
- * 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 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
- * settings to take effect.
- */
-export declare const prefersReducedMotion: () => boolean;

package/dist/types-ts4.5/internal/resolve-css-length-to-pixels.d.ts

@@ -1,20 +0,0 @@
-/**
- * Resolves a CSS length value to a pixel number using a hidden DOM probe.
- *
- * Used by the JS positioning fallback: consumer offsets can be numbers,
- * `${n}px` strings, tokenised `var(--ds-space-100, 8px)` strings, `calc()`
- * expressions, viewport units, etc. Parsing arbitrary CSS in JS is fragile
- * (and impossible for `calc(var(...))` without a layout context), so we let
- * the browser do the math.
- *
- * The probe is appended to `container` so it inherits the same containing
- * block, font size, and custom-property scope as the popover.
- *
- * Cost: one synchronous reflow on first cacheable resolution per
- * (container, value) pair, then a `WeakMap` lookup. Resolutions involving
- * `var(` are intentionally not cached.
- */
-export declare function resolveCssLengthToPixels({ value, container, }: {
-    value: number | string;
-    container: HTMLElement;
-}): number;

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

@@ -1,8 +0,0 @@
-/**
- * Normalizes an offset to a CSS length string. Numbers become `${n}px`;
- * strings pass through. Apply at the API boundary so internal code only
- * deals with strings.
- */
-export declare function toCssLengthString({ value }: {
-    value: number | string;
-}): string;

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

@@ -1,58 +0,0 @@
-/**
- * Cross-axis shift. `value` is a CSS length string (consumer numbers are
- * normalized to `${n}px`). `direction` is `'forwards'` (toward end) or
- * `'backwards'` (toward start).
- */
-export type TCrossAxisShiftOffset = {
-    value: string;
-    direction: 'forwards' | 'backwards';
-};
-/**
- * Fully-resolved placement (internal). Use `getPlacement` for partial input.
- * `offset.gap` and `offset.crossAxisShift.value` are always CSS
- * length strings.
- */
-export type TPlacement = {
-    axis: 'block' | 'inline';
-    edge: 'start' | 'end';
-    align: 'start' | 'center' | 'end';
-    offset: {
-        gap: string;
-        crossAxisShift: {
-            value: string;
-            direction: 'forwards' | 'backwards';
-        };
-    };
-};
-/**
- * Partial placement options. `offset.gap` and
- * `offset.crossAxisShift.value` accept either a number (pixels) or a
- * 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)
- */
-export type TPlacementOptions = {
-    axis?: 'block' | 'inline';
-    edge?: 'start' | 'end';
-    align?: 'start' | 'center' | 'end';
-    offset?: {
-        gap?: number | string;
-        crossAxisShift?: {
-            value?: number | string;
-            direction?: 'forwards' | 'backwards';
-        };
-    };
-};
-/**
- * Resolves a partial placement to its fully-specified form. Number offsets
- * are normalized to `${n}px` strings.
- *
- * Defaults: `axis: 'block'`, `edge: 'end'`, `align: 'center'`,
- * `offset.gap: token('space.100', '8px')`,
- * `offset.crossAxisShift: { value: '0px', direction: 'forwards' }`.
- */
-export declare function getPlacement({ placement }: {
-    placement: TPlacementOptions;
-}): TPlacement;

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

@@ -1,13 +0,0 @@
-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;