@atlaskit/top-layer 4.4.5 → 5.0.1

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

@@ -1,67 +0,0 @@
-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, isOpen, }: {
-    /**
-     * 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;
-    /**
-     * Whether the popover is currently open. Forwarded to the inner
-     * `useAnchorPosition` so it re-runs across host remount cycles.
-     */
-    isOpen: boolean;
-}): void;

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

@@ -1,87 +0,0 @@
-/**
- * Anchor positioning for top-layer popovers. See
- * `notes/architecture/positioning.md` for the full model.
- *
- * Two runtime paths: CSS Anchor Positioning (modern browsers) and a JS
- * fallback that measures the trigger and writes `top`/`left`.
- *
- * Both paths honour `offset.gap` and `offset.crossAxisShift`. The
- * CSS path passes the values through as strings; the JS fallback resolves
- * them to pixels via a hidden DOM probe (see `resolveCssLengthToPixels`)
- * so tokens, `calc()`, `var()`, etc all work. The JS fallback hides the
- * popover with `opacity: 0` until the first measurement completes, so it
- * is never painted at the wrong location.
- */
-import { type RefObject } from 'react';
-import { type TPlacementOptions } from '../internal/resolve-placement';
-/**
- * Hook that positions an element relative to an anchor element using
- * CSS Anchor Positioning (with a JS fallback for older browsers).
- *
- * This hook is the positioning primitive. It has no knowledge of popovers,
- * visibility, or animation. Compose it with `Popover` for anchor-positioned
- * top-layer content.
- *
- * When CSS Anchor Positioning is supported, it sets CSS properties
- * (`anchor-name`, `position-anchor`, `position-area`, `position-try-fallbacks`)
- * directly on the elements via `el.style.setProperty()`.
- *
- * When not supported, it falls back to JavaScript-based positioning using
- * `position: fixed` with measured coordinates, re-running on scroll (capture)
- * and resize events.
- */
-export declare function useAnchorPosition({ anchorRef, popoverRef, placement, forceFallbackPositioning, isEnabled, isOpen, }: {
-    /**
-     * Element to position relative to.
-     */
-    anchorRef: RefObject<HTMLElement | null>;
-    /**
-     * Element being positioned (typically a popover).
-     *
-     * The popover host may be unmounted between opens (the `Popover`
-     * primitive unmounts after its exit animation). Pass `isOpen` so the
-     * positioning effect re-runs against the freshly mounted element on
-     * the next open. Without it, the effect's bound listeners and styles
-     * would target the previous (detached) element.
-     */
-    popoverRef: RefObject<HTMLElement | null>;
-    /**
-     * Where to place the element relative to the anchor.
-     * `offset.gap` and `offset.crossAxisShift` are part of the
-     * placement object.
-     *
-     * All fields are optional. Omitted fields fall back to:
-     *   - `axis`: `'block'`
-     *   - `edge`: `'end'`
-     *   - `align`: `'center'`
-     *   - `offset.gap`: `token('space.100', '8px')`
-     *   - `offset.crossAxisShift.value`: `'0px'`
-     *   - `offset.crossAxisShift.direction`: `'forwards'`
-     *
-     * The full default placement (`{}`) renders the popover centered
-     * below the trigger with one `space.100` of gap and no cross-axis
-     * shift.
-     *
-     * `offset.gap` and `offset.crossAxisShift.value` accept either a
-     * number (pixels) or a CSS length string (eg `token('space.200')`).
-     */
-    placement?: TPlacementOptions;
-    /**
-     * 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;
-    /**
-     * When `false`, the hook is a no-op and applies no positioning.
-     * Defaults to `true`.
-     */
-    isEnabled?: boolean;
-    /**
-     * Whether the popover is currently open. Drives a re-run of the
-     * positioning effect when the popover host element is unmounted
-     * and remounted across open cycles, so listeners and styles are
-     * always wired to the live host element.
-     */
-    isOpen: boolean;
-}): void;

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

@@ -1,19 +0,0 @@
-import { type RefObject } from 'react';
-import type { TWidthFromAnchorMode } from '../popover/types';
-/**
- * Sets the width of a popover element relative to its anchor element.
- *
- * - `'match-anchor'` → `inline-size: anchor-size(self-inline)`, exact
- * - `'min-anchor'`   → `min-inline-size: anchor-size(self-inline)`, floor only
- * - `'none'`         → `min-inline-size: max-content`, content floor (default)
- *
- * `self-inline` is the inline axis of the element USING the function (the popover), never the
- * anchor, so it matches the axis `inline-size` constrains. See
- * `notes/decisions/width-from-anchor-floors.md`.
- */
-export declare function useWidthFromAnchor({ mode, popoverRef, anchorRef, isOpen, }: {
-    mode: TWidthFromAnchorMode;
-    popoverRef: RefObject<HTMLElement | null>;
-    anchorRef: RefObject<HTMLElement | null>;
-    isOpen: boolean;
-}): void;

package/use-anchor-position/package.json

@@ -1,10 +0,0 @@
-{
-  "name": "@atlaskit/top-layer/use-anchor-position",
-  "main": "../dist/cjs/internal/use-anchor-position.js",
-  "module": "../dist/esm/internal/use-anchor-position.js",
-  "module:es2019": "../dist/es2019/internal/use-anchor-position.js",
-  "sideEffects": [
-    "*.compiled.css"
-  ],
-  "types": "../dist/types/internal/use-anchor-position.d.ts"
-}

package/use-anchor-position-at-point/package.json

@@ -1,10 +0,0 @@
-{
-  "name": "@atlaskit/top-layer/use-anchor-position-at-point",
-  "main": "../dist/cjs/internal/use-anchor-position-at-point.js",
-  "module": "../dist/esm/internal/use-anchor-position-at-point.js",
-  "module:es2019": "../dist/es2019/internal/use-anchor-position-at-point.js",
-  "sideEffects": [
-    "*.compiled.css"
-  ],
-  "types": "../dist/types/internal/use-anchor-position-at-point.d.ts"
-}

package/use-width-from-anchor/package.json

@@ -1,10 +0,0 @@
-{
-  "name": "@atlaskit/top-layer/use-width-from-anchor",
-  "main": "../dist/cjs/internal/use-width-from-anchor.js",
-  "module": "../dist/esm/internal/use-width-from-anchor.js",
-  "module:es2019": "../dist/es2019/internal/use-width-from-anchor.js",
-  "sideEffects": [
-    "*.compiled.css"
-  ],
-  "types": "../dist/types/internal/use-width-from-anchor.d.ts"
-}