[context menu] Correct generated API metadata

Author: aarongarciah

docs/src/app/(docs)/react/components/context-menu/types.md

@@ -578,7 +578,7 @@ A menu that appears at the pointer on right click or long press.
     - Separator
 - Exports:
   - Context Menu - Root
-    - Props: actionsRef, children, closeParentOnEsc, defaultOpen, disabled, highlightItemOnHover, loopFocus, onOpenChange, onOpenChangeComplete, open, orientation
+    - Props: actionsRef, children, defaultOpen, disabled, highlightItemOnHover, loopFocus, onOpenChange, onOpenChangeComplete, open, orientation
   - Context Menu - Trigger
     - Props: className, render, style
     - Data Attributes: data-popup-open, data-pressed

docs/src/app/(docs)/react/components/menu/types.md

@@ -3,7 +3,7 @@ export { ContextMenuTrigger as Trigger } from './trigger/ContextMenuTrigger';
 
 export { MenuBackdrop as Backdrop } from '../menu/backdrop/MenuBackdrop';
 export { MenuPortal as Portal } from '../menu/portal/MenuPortal';
-export { MenuPositioner as Positioner } from '../menu/positioner/MenuPositioner';
+export { ContextMenuPositioner as Positioner } from './positioner/ContextMenuPositioner';
 export { MenuPopup as Popup } from '../menu/popup/MenuPopup';
 export { MenuArrow as Arrow } from '../menu/arrow/MenuArrow';
 export { MenuGroup as Group } from '../menu/group/MenuGroup';

docs/src/app/(docs)/react/components/page.mdx

@@ -2,6 +2,7 @@ export * as ContextMenu from './index.parts';
 
 export type * from './root/ContextMenuRoot';
 export type * from './trigger/ContextMenuTrigger';
+export type * from './positioner/ContextMenuPositioner';
 
 export type {
   MenuBackdropProps as ContextMenuBackdropProps,
@@ -11,10 +12,6 @@ export type {
   MenuPortalProps as ContextMenuPortalProps,
   MenuPortalState as ContextMenuPortalState,
 } from '../menu/portal/MenuPortal';
-export type {
-  MenuPositionerProps as ContextMenuPositionerProps,
-  MenuPositionerState as ContextMenuPositionerState,
-} from '../menu/positioner/MenuPositioner';
 export type {
   MenuPopupProps as ContextMenuPopupProps,
   MenuPopupState as ContextMenuPopupState,

packages/react/src/context-menu/index.parts.ts

@@ -0,0 +1,111 @@
+'use client';
+import type * as React from 'react';
+import {
+  MenuPositioner,
+  type MenuPositionerProps,
+  type MenuPositionerState,
+} from '../../menu/positioner/MenuPositioner';
+import type { BaseUIComponentProps } from '../../internals/types';
+
+export interface ContextMenuPositionerState extends MenuPositionerState {}
+
+/**
+ * Positions the context menu popup against the pointer or a custom anchor.
+ * Renders a `<div>` element.
+ *
+ * Documentation: [Base UI Context Menu](https://base-ui.com/react/components/context-menu)
+ */
+export const ContextMenuPositioner: React.ForwardRefExoticComponent<
+  ContextMenuPositionerProps & React.RefAttributes<HTMLDivElement>
+> = MenuPositioner;
+
+export interface ContextMenuPositionerProps
+  extends
+    Omit<
+      MenuPositionerProps,
+      | keyof BaseUIComponentProps<'div', ContextMenuPositionerState>
+      | 'anchor'
+      | 'positionMethod'
+      | 'sideOffset'
+      | 'align'
+      | 'alignOffset'
+      | 'arrowPadding'
+    >,
+    BaseUIComponentProps<'div', ContextMenuPositionerState> {
+  /**
+   * An element to position the popup against.
+   * By default, root context menus are positioned at the pointer, and submenus are positioned
+   * against their trigger.
+   */
+  anchor?: MenuPositionerProps['anchor'] | undefined;
+  /**
+   * Determines which CSS `position` property to use.
+   * Context menus always use fixed positioning, so passing `'absolute'` has no effect.
+   * @default 'fixed'
+   */
+  positionMethod?: MenuPositionerProps['positionMethod'] | undefined;
+  /**
+   * Distance between the anchor and the popup in pixels.
+   * Also accepts a function that returns the distance to read the dimensions of the anchor
+   * and positioner elements, along with its side and alignment.
+   *
+   * The function takes a `data` object parameter with the following properties:
+   * - `data.anchor`: the dimensions of the anchor element with properties `width` and `height`.
+   * - `data.positioner`: the dimensions of the positioner element with properties `width` and `height`.
+   * - `data.side`: which side of the anchor element the positioner is aligned against.
+   * - `data.align`: how the positioner is aligned relative to the specified side.
+   *
+   * Defaults to `-5` for root context menus when `side` is not specified and `align` is not
+   * `'center'`. Otherwise, it defaults to `0`.
+   *
+   * @example
+   * ```jsx
+   * <ContextMenu.Positioner
+   *   sideOffset={({ side, anchor }) => {
+   *     return side === 'top' || side === 'bottom' ? anchor.height : anchor.width;
+   *   }}
+   * />
+   * ```
+   */
+  sideOffset?: MenuPositionerProps['sideOffset'] | undefined;
+  /**
+   * How to align the popup relative to the specified side.
+   * @default 'start'
+   */
+  align?: MenuPositionerProps['align'] | undefined;
+  /**
+   * Additional offset along the alignment axis in pixels.
+   * Also accepts a function that returns the offset to read the dimensions of the anchor
+   * and positioner elements, along with its side and alignment.
+   *
+   * The function takes a `data` object parameter with the following properties:
+   * - `data.anchor`: the dimensions of the anchor element with properties `width` and `height`.
+   * - `data.positioner`: the dimensions of the positioner element with properties `width` and `height`.
+   * - `data.side`: which side of the anchor element the positioner is aligned against.
+   * - `data.align`: how the positioner is aligned relative to the specified side.
+   *
+   * Defaults to `2` for root context menus when `side` is not specified and `align` is not
+   * `'center'`. Otherwise, it defaults to `0`.
+   *
+   * @example
+   * ```jsx
+   * <ContextMenu.Positioner
+   *   alignOffset={({ side, anchor }) => {
+   *     return side === 'top' || side === 'bottom' ? anchor.width : anchor.height;
+   *   }}
+   * />
+   * ```
+   */
+  alignOffset?: MenuPositionerProps['alignOffset'] | undefined;
+  /**
+   * Minimum distance to maintain between the arrow and the edges of the popup.
+   *
+   * Root context menus always use `0`. Submenus default to `5`.
+   */
+  arrowPadding?: MenuPositionerProps['arrowPadding'] | undefined;
+}
+
+export namespace ContextMenuPositioner {
+  export type Props = ContextMenuPositionerProps;
+  export type State = ContextMenuPositionerState;
+}

packages/react/src/context-menu/index.ts

@@ -0,0 +1 @@
+export { MenuPositionerCssVars as ContextMenuPositionerCssVars } from '../../menu/positioner/MenuPositionerCssVars';

packages/react/src/context-menu/positioner/ContextMenuPositioner.tsx

@@ -0,0 +1 @@
+export { MenuPositionerDataAttributes as ContextMenuPositionerDataAttributes } from '../../menu/positioner/MenuPositionerDataAttributes';

packages/react/src/context-menu/positioner/ContextMenuPositionerCssVars.ts

@@ -65,6 +65,7 @@ export interface ContextMenuRootProps extends Omit<
   | 'openOnHover'
   | 'delay'
   | 'closeDelay'
+  | 'closeParentOnEsc'
   | 'onOpenChange'
   // Context Menu opens from a pointer position rather than a registered trigger, so the
   // render-function form of `children` (which receives the active trigger's payload) is not applicable.
@@ -76,6 +77,14 @@ export interface ContextMenuRootProps extends Omit<
   onOpenChange?:
     | ((open: boolean, eventDetails: ContextMenuRoot.ChangeEventDetails) => void)
     | undefined;
+  /**
+   * @ignore
+   * @deprecated This prop has no effect on Context Menu.
+   */
+  closeParentOnEsc?: Menu.Root.Props['closeParentOnEsc'] | undefined;
+  /**
+   * The content of the context menu.
+   */
   children?: React.ReactNode | undefined;
 }
 

packages/react/src/context-menu/positioner/ContextMenuPositionerDataAttributes.ts

@@ -6,7 +6,7 @@ export enum ContextMenuTriggerDataAttributes {
    */
   popupOpen = CommonTriggerDataAttributes.popupOpen,
   /**
-   * Present when the trigger is pressed.
+   * Present when the corresponding context menu is open.
    */
   pressed = CommonTriggerDataAttributes.pressed,
 }