// Copyright 2025 Signal Messenger, LLC
// SPDX-License-Identifier: AGPL-3.0-only
import React, { memo } from 'react';
import { ContextMenu } from 'radix-ui';
import type { FC } from 'react';
import { AxoSymbol } from './AxoSymbol.dom.js';
import { AxoBaseMenu } from './_internal/AxoBaseMenu.dom.js';
import { tw } from './tw.dom.js';
const Namespace = 'AxoContextMenu';
/**
* Displays a menu located at the pointer, triggered by a right click or a long press.
*
* Note: For menus that are triggered by a normal button press, you should use
* `AxoDropdownMenu`.
*
* @example Anatomy
* ```tsx
* import { AxoContextMenu } from "./axo/ContextMenu/AxoContentMenu.tsx";
*
* export default () => (
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
* )
* ```
*/
export namespace AxoContextMenu {
/**
* Component:
* --------------------------------
*/
export type RootProps = AxoBaseMenu.MenuRootProps;
export const Root: FC = memo(props => {
return {props.children};
});
Root.displayName = `${Namespace}.Root`;
/**
* Component:
* -----------------------------------
*/
export type TriggerProps = AxoBaseMenu.MenuTriggerProps;
export const Trigger: FC = memo(props => {
return {props.children};
});
Trigger.displayName = `${Namespace}.Trigger`;
/**
* Component:
* -----------------------------------
*/
export type ContentProps = AxoBaseMenu.MenuContentProps;
/**
* The component that pops out in an open context menu.
* Uses a portal to render the content part into the `body`.
*/
export const Content: FC = memo(props => {
return (
{props.children}
);
});
Content.displayName = `${Namespace}.Content`;
/**
* Component:
* --------------------------------
*/
export type ItemProps = AxoBaseMenu.MenuItemProps;
/**
* The component that contains the context menu items.
* @example
* ```tsx
* }>
* {i18n("myContextMenuText")}
*
* ````
*/
export const Item: FC = memo(props => {
return (
{props.symbol && (
)}
{props.children}
{props.keyboardShortcut && (
)}
);
});
Item.displayName = `${Namespace}.Item`;
/**
* Component:
* ---------------------------------
*/
export type GroupProps = AxoBaseMenu.MenuGroupProps;
/**
* Used to group multiple {@link AxoContextMenu.Item}'s.
*/
export const Group: FC = memo(props => {
return (
{props.children}
);
});
Group.displayName = `${Namespace}.Group`;
/**
* Component:
* ---------------------------------
*/
export type LabelProps = AxoBaseMenu.MenuLabelProps;
/**
* Used to render a label. It won't be focusable using arrow keys.
*/
export const Label: FC = memo(props => {
return (
{props.children}
);
});
Label.displayName = `${Namespace}.Label`;
/**
* Component:
* ----------------------------------------
*/
export type CheckboxItemProps = AxoBaseMenu.MenuCheckboxItemProps;
/**
* An item that can be controlled and rendered like a checkbox.
*/
export const CheckboxItem: FC = memo(props => {
return (
{props.symbol && (
)}
{props.children}
{props.keyboardShortcut && (
)}
);
});
CheckboxItem.displayName = `${Namespace}.CheckboxItem`;
/**
* Component:
* --------------------------------------
*/
export type RadioGroupProps = AxoBaseMenu.MenuRadioGroupProps;
/**
* Used to group multiple {@link AxoContextMenu.RadioItem}'s.
*/
export const RadioGroup: FC = memo(props => {
return (
{props.children}
);
});
RadioGroup.displayName = `${Namespace}.RadioGroup`;
/**
* Component:
* -------------------------------------
*/
export type RadioItemProps = AxoBaseMenu.MenuRadioItemProps;
/**
* An item that can be controlled and rendered like a radio.
*/
export const RadioItem: FC = memo(props => {
return (
{props.symbol && (
)}
{props.children}
{props.keyboardShortcut && (
)}
);
});
RadioItem.displayName = `${Namespace}.RadioItem`;
/**
* Component:
* -------------------------------------
*/
export type SeparatorProps = AxoBaseMenu.MenuSeparatorProps;
/**
* Used to visually separate items in the context menu.
*/
export const Separator: FC = memo(() => {
return (
);
});
Separator.displayName = `${Namespace}.Separator`;
/**
* Component:
* -------------------------------
*/
export type SubProps = AxoBaseMenu.MenuSubProps;
/**
* Contains all the parts of a submenu.
*/
export const Sub: FC = memo(props => {
return {props.children};
});
Sub.displayName = `${Namespace}.Sub`;
/**
* Component:
* --------------------------------------
*/
export type SubTriggerProps = AxoBaseMenu.MenuSubTriggerProps;
/**
* An item that opens a submenu. Must be rendered inside
* {@link ContextMenu.Sub}.
*/
export const SubTrigger: FC = memo(props => {
return (
{props.symbol && (
)}
{props.children}
);
});
SubTrigger.displayName = `${Namespace}.SubTrigger`;
/**
* Component:
* --------------------------------------
*/
export type SubContentProps = AxoBaseMenu.MenuSubContentProps;
/**
* The component that pops out when a submenu is open. Must be rendered
* inside {@link AxoContextMenu.Sub}.
*/
export const SubContent: FC = memo(props => {
return (
{props.children}
);
});
SubContent.displayName = `${Namespace}.SubContent`;
}