@remix-run/ui 0.2.0 → 0.4.0

package/src/{components/combobox/combobox.tsx → combobox/primitives.tsx}

@@ -1,11 +1,8 @@
 import {
   attrs,
-  css,
-  createElement,
   createMixin,
   on,
   ref,
-  type CSSMixinDescriptor,
   type Dispatched,
   type ElementProps,
   type Handle,
@@ -15,13 +12,11 @@ import {
   type RemixNode,
 } from '@remix-run/ui'
 
-import { Glyph } from '../glyph/glyph.tsx'
-import * as listbox from '../listbox/listbox.ts'
-import * as popover from '../popover/popover.ts'
-import { theme } from '../../theme/theme.ts'
-import { type SearchValue } from '../../interactions/typeahead/typeahead-mixin.ts'
-import { waitForCssTransition } from '../../utils/wait-for-css-transition.ts'
-import { wait } from '../../utils/wait.ts'
+import * as listbox from '../listbox/index.ts'
+import * as popover from '../popover/index.ts'
+import { type SearchValue } from '../shared/typeahead.ts'
+import { waitForCssTransition } from '../shared/wait-for-css-transition.ts'
+import { wait } from '../shared/wait.ts'
 
 const COMBOBOX_CHANGE_EVENT = 'rmx:combobox-change' as const
 const INPUT_COMMIT_DELAY_MS = 50
@@ -33,48 +28,6 @@ type ComboboxChangeHandler<target extends HTMLElement> = (
 
 type ShowReason = 'hint' | 'nav'
 
-const comboboxPopoverCss: CSSMixinDescriptor = css({
-  opacity: 0,
-  '&:popover-open': {
-    opacity: 1,
-  },
-  '&:not(:popover-open)': {
-    pointerEvents: 'none',
-  },
-  '&[data-show-reason="nav"]:not(:popover-open)': {
-    transition: 'opacity 180ms ease-in, overlay 180ms ease-in, display 180ms ease-in',
-    transitionBehavior: 'allow-discrete',
-  },
-  '&[data-show-reason="hint"]:not(:popover-open)': {
-    transition: 'none',
-    transitionBehavior: 'normal',
-  },
-})
-
-const comboboxInputCss: CSSMixinDescriptor = css({
-  minHeight: theme.control.height.sm,
-  width: '100%',
-  paddingInline: theme.space.sm,
-  border: `0.5px solid ${theme.colors.border.default}`,
-  borderRadius: theme.radius.md,
-  backgroundColor: theme.surface.lvl0,
-  color: theme.colors.text.primary,
-  fontFamily: theme.fontFamily.sans,
-  fontSize: theme.fontSize.sm,
-  lineHeight: theme.lineHeight.normal,
-  boxShadow: 'inset 0 1px 0 rgb(255 255 255 / 0.7)',
-  '&:focus-visible': {
-    outline: `2px solid ${theme.colors.focus.ring}`,
-    outlineOffset: theme.space.none,
-  },
-  '&[data-surface-visible="true"][aria-activedescendant]:focus-visible': {
-    outline: 'none',
-  },
-})
-
-export const inputStyle = comboboxInputCss
-export const popoverStyle = comboboxPopoverCss
-
 declare global {
   interface HTMLElementEventMap {
     [COMBOBOX_CHANGE_EVENT]: ComboboxChangeEvent
@@ -989,42 +942,3 @@ export function onComboboxChange<target extends HTMLElement>(
 ): ReturnType<typeof on<target, typeof COMBOBOX_CHANGE_EVENT>> {
   return on(COMBOBOX_CHANGE_EVENT, handler, captureBoolean)
 }
-
-export function Combobox(handle: Handle<ComboboxProps>): () => RemixNode {
-  return () => {
-    let { children, defaultValue, disabled, inputId, name, placeholder, ...divProps } = handle.props
-
-    return (
-      <combobox.Context defaultValue={defaultValue} disabled={disabled} name={name}>
-        <div {...divProps}>
-          <input
-            defaultValue={defaultValue ?? undefined}
-            id={inputId}
-            mix={[inputStyle, combobox.input()]}
-            placeholder={placeholder}
-          />
-          <div mix={[popover.surfaceStyle, popoverStyle, combobox.popover()]}>
-            <div mix={[popover.contentStyle, listbox.listStyle, combobox.list()]}>{children}</div>
-          </div>
-          {name && <input mix={combobox.hiddenInput()} />}
-        </div>
-      </combobox.Context>
-    )
-  }
-}
-
-export function ComboboxOption(handle: Handle<ComboboxOptionProps>): () => RemixNode {
-  return () => {
-    let { children, disabled, label, mix, searchValue, value, ...divProps } = handle.props
-
-    return (
-      <div
-        {...divProps}
-        mix={[listbox.optionStyle, combobox.option({ disabled, label, searchValue, value }), mix]}
-      >
-        <Glyph mix={listbox.glyphStyle} name="check" />
-        <span mix={listbox.labelStyle}>{children ?? label}</span>
-      </div>
-    )
-  }
-}

package/src/input/README.md

@@ -0,0 +1,52 @@
+# input
+
+`input` is a style mixin for text inputs. Use `input()` directly on standalone native inputs, or compose `input.root()` with `input.field()` when the input needs inline icons or controls.
+
+## Primitive Usage
+
+```tsx
+import input from 'remix/ui/input'
+
+function ProductFilters() {
+  return () => (
+    <div>
+      <input mix={input()} placeholder="Limit" />
+
+      <div mix={input.root()}>
+        <SearchIcon />
+        <input mix={input.field()} placeholder="Search and filter products" />
+      </div>
+    </div>
+  )
+}
+```
+
+Compose app-owned styles when a field needs local layout or adornments:
+
+```tsx
+import input from 'remix/ui/input'
+import { filterFieldStyle, filterRootStyle } from './filters.styles'
+
+function SearchFilter() {
+  return () => (
+    <div mix={[filterRootStyle, input.root()]}>
+      <SearchIcon />
+      <input mix={[filterFieldStyle, input.field()]} placeholder="Search" />
+    </div>
+  )
+}
+```
+
+## `remix/ui/input`
+
+- `input(options)`: styles a standalone native input. `size` may be `'md'` or `'lg'` and defaults to `'md'`.
+- `input.root(options)`: styles a flex input frame for inline icons, buttons, and a child input.
+- `input.field()`: styles the child native input inside `input.root()`.
+- `InputOptions`: accepts `size`.
+- `InputSize`: `'md'` or `'lg'`.
+
+## Behavior Notes
+
+- `input.root()` uses child selectors to size direct SVG children as presentational icons.
+- Put the icon before or after the field to control its visual position.
+- Focus and disabled states work through the native input; the root mirrors them with `:focus-within` and `:has(input:disabled)`.

package/src/input/index.ts

@@ -0,0 +1,147 @@
+import { css } from '@remix-run/ui'
+import type { CSSMixinDescriptor } from '@remix-run/ui'
+import { controlFocusShadow } from '../shared/focus-styles.ts'
+import type { CSSProps } from '../style/style.ts'
+
+export type InputSize = 'md' | 'lg'
+
+export interface InputOptions {
+  size?: InputSize
+}
+
+type InputMixin = readonly [CSSMixinDescriptor, CSSMixinDescriptor]
+
+interface InputFunction {
+  (options?: InputOptions): InputMixin
+  root(options?: InputOptions): InputMixin
+  field(): CSSMixinDescriptor
+}
+
+const frameStyles = {
+  '--rmx-input-height': '32px',
+  '--rmx-input-padding-block': '6px',
+  '--rmx-input-padding-inline': '12px',
+  '--rmx-input-root-padding-inline': '8px',
+  '--rmx-input-gap': '6px',
+  '--rmx-input-icon-size': '16px',
+  '--rmx-input-icon-color': '#707070',
+  appearance: 'none',
+  margin: 0,
+  boxSizing: 'border-box',
+  display: 'block',
+  width: '100%',
+  minWidth: 0,
+  height: 'var(--rmx-input-height)',
+  paddingBlock: 'var(--rmx-input-padding-block)',
+  paddingInline: 'var(--rmx-input-padding-inline)',
+  border: 0,
+  borderRadius: '8px',
+  background: '#FFFFFF',
+  boxShadow:
+    '0 2px 3px -1px rgba(0, 0, 0, 0.04), 0 3px 4px -1.5px rgba(0, 0, 0, 0.04), 0 4px 5px -2px rgba(0, 0, 0, 0.04), 0 0 0 1px rgba(0, 0, 0, 0.12)',
+  color: '#101010',
+  fontFamily: '"Inter Variable", Inter, ui-sans-serif, system-ui, sans-serif',
+  fontStyle: 'normal',
+  fontWeight: 400,
+  fontSize: '13px',
+  lineHeight: '20px',
+  fontFeatureSettings: '"ss01" on, "cv01" on',
+  letterSpacing: 0,
+  textShadow: '0 1px 0 #FFFFFF',
+  '&::placeholder': {
+    color: '#B0B0B0',
+    opacity: 1,
+  },
+  '&:disabled, &[aria-disabled="true"]': {
+    opacity: 0.55,
+  },
+} as const satisfies CSSProps
+
+const baseStyle: CSSMixinDescriptor = css({
+  ...frameStyles,
+  '&:focus-visible': {
+    outline: 0,
+    boxShadow: controlFocusShadow,
+  },
+})
+
+const rootBaseStyle: CSSMixinDescriptor = css({
+  ...frameStyles,
+  display: 'flex',
+  alignItems: 'center',
+  gap: 'var(--rmx-input-gap)',
+  paddingInline: 'var(--rmx-input-root-padding-inline)',
+  '&:focus-within': {
+    boxShadow: controlFocusShadow,
+  },
+  '&:has(input:disabled), &:has(input[aria-disabled="true"])': {
+    opacity: 0.55,
+  },
+  '& > svg': {
+    flex: 'none',
+    width: 'var(--rmx-input-icon-size)',
+    height: 'var(--rmx-input-icon-size)',
+    color: 'var(--rmx-input-icon-color)',
+    pointerEvents: 'none',
+  },
+  '& > button': {
+    flex: 'none',
+  },
+})
+
+const fieldBaseStyle: CSSMixinDescriptor = css({
+  appearance: 'none',
+  margin: 0,
+  boxSizing: 'border-box',
+  flex: '1 1 auto',
+  minWidth: 0,
+  width: '100%',
+  height: '20px',
+  padding: 0,
+  border: 0,
+  outline: 0,
+  background: 'transparent',
+  boxShadow: 'none',
+  color: '#101010',
+  font: 'inherit',
+  fontFeatureSettings: 'inherit',
+  letterSpacing: 'inherit',
+  textShadow: 'inherit',
+  '&::placeholder': {
+    color: '#B0B0B0',
+    opacity: 1,
+  },
+  '&:disabled, &[aria-disabled="true"]': {
+    opacity: 1,
+  },
+})
+
+const sizeStyles = {
+  md: css({}),
+  lg: css({
+    '--rmx-input-height': '36px',
+    '--rmx-input-padding-block': '8px',
+    '--rmx-input-padding-inline': '14px',
+    '--rmx-input-root-padding-inline': '10px',
+    '--rmx-input-gap': '8px',
+    '--rmx-input-icon-size': '18px',
+  }),
+} as const satisfies Record<InputSize, CSSMixinDescriptor>
+
+function createInput(options: InputOptions = {}): InputMixin {
+  let { size = 'md' } = options
+  return [baseStyle, sizeStyles[size]]
+}
+
+function root(options: InputOptions = {}): InputMixin {
+  let { size = 'md' } = options
+  return [rootBaseStyle, sizeStyles[size]]
+}
+
+function field(): CSSMixinDescriptor {
+  return fieldBaseStyle
+}
+
+export const input: InputFunction = Object.assign(createInput, { root, field })
+
+export default input

package/src/{components/listbox → listbox}/README.md

@@ -1,14 +1,14 @@
 # listbox
 
-`listbox` is a headless option-list primitive for controlled selection and highlighting. Use it under components like `select` and `combobox`, or directly when you need custom listbox markup.
+`listbox` is a headless option-list primitive for controlled selection and highlighting. Use it under components like select and combobox, or directly when you need custom listbox markup.
 
-## Usage
+## Primitive Usage
 
 ```tsx
 import type { Handle } from 'remix/ui'
-import { Glyph } from 'remix/ui/glyph'
 import * as listbox from 'remix/ui/listbox'
 import type { ListboxValue } from 'remix/ui/listbox'
+import { listStyle, optionStyle } from './listbox.styles'
 
 function FrameworkListbox(handle: Handle) {
   let value: ListboxValue = 'remix'
@@ -27,11 +27,10 @@ function FrameworkListbox(handle: Handle) {
         void handle.update()
       }}
     >
-      <div aria-label="Frameworks" tabIndex={0} mix={[listbox.listStyle, listbox.list()]}>
+      <div aria-label="Frameworks" tabIndex={0} mix={[listStyle, listbox.list()]}>
         {frameworks.map((option) => (
-          <div key={option.value} mix={[listbox.optionStyle, listbox.option(option)]}>
-            <Glyph mix={listbox.glyphStyle} name="check" />
-            <span mix={listbox.labelStyle}>{option.label}</span>
+          <div key={option.value} mix={[optionStyle, listbox.option(option)]}>
+            {option.label}
           </div>
         ))}
       </div>
@@ -52,6 +51,7 @@ Use `textValue` when the visible label is not the best string for typeahead sear
 ```tsx
 <div
   mix={[
+    optionStyle,
     listbox.option({
       label: 'Staging',
       textValue: 'beta',
@@ -63,42 +63,13 @@ Use `textValue` when the visible label is not the best string for typeahead sear
 </div>
 ```
 
-Use `ref` when a parent component needs imperative coordination with the current option registry.
-
-```tsx
-import type { ListboxRef } from 'remix/ui/listbox'
-
-let listboxRef: ListboxRef | undefined
-
-function selectLastOption() {
-  listboxRef?.navigateLast()
-  void listboxRef?.selectActive()
-}
-
-;<listbox.Context
-  value={value}
-  activeValue={activeValue}
-  ref={(ref) => {
-    listboxRef = ref
-  }}
-  onSelect={(nextValue) => {
-    value = nextValue
-  }}
-  onHighlight={(nextActiveValue) => {
-    activeValue = nextActiveValue
-  }}
->
-  {/* listbox markup */}
-</listbox.Context>
-```
-
-## `listbox.*`
+## `remix/ui/listbox`
 
 - `listbox.Context`: provider for controlled `value` and `activeValue`, option registration, selection, highlighting, optional ref access, `flashSelection`, `selectionFlashAttribute`, and `onSelectSettled`.
 - `listbox.list()`: mixin that wires `role="listbox"`, default `tabIndex={-1}`, keyboard navigation, focus scrolling, and typeahead highlighting.
 - `listbox.option(options)`: mixin that registers an option with required `label` and `value`, optional `disabled` and `textValue`, and wires `role="option"`, id, selected, disabled, highlighted, mouse, and click behavior.
-- `listStyle`, `optionStyle`, `glyphStyle`, and `labelStyle`: flat style mixins for standard listbox presentation.
 - `ListboxValue`: selected or active value, represented as `string | null`.
+- `ListboxContext` and `ListboxProviderProps`: provider context and prop types for controlled listboxes.
 - `ListboxOption`: option input shape with `label`, `value`, optional `disabled`, and optional `textValue`.
 - `ListboxRegisteredOption`: registered option metadata passed to callbacks and refs.
 - `ListboxRef`: live ref object exposing active/selected options, option navigation, search matching, scrolling, and selection helpers.
@@ -108,8 +79,5 @@ function selectLastOption() {
 - Selection and highlighting are controlled. `onSelect` and `onHighlight` notify the parent, but DOM state updates after the parent rerenders with new values.
 - Disabled options are skipped by keyboard navigation, typeahead, mouse movement, and click selection.
 - Arrow keys wrap through enabled options. `Home` and `End` move to enabled boundaries. `Enter` and Space select the active option.
-- Mouse movement highlights enabled options. `mouseleave` clears the highlight when leaving the active option.
-- `Tab` is prevented and highlights the first enabled option.
 - Typeahead highlights the next matching enabled option without selecting it and supports `textValue`.
-- Focus and keyboard navigation scroll the active option into view with nearest-edge alignment.
 - `flashSelection` applies `selectionFlashAttribute` for 60ms, delays `onSelectSettled`, and ignores new highlight/select interactions until the flash completes.

package/src/{components/listbox/listbox.ts → listbox/index.ts}

@@ -1,21 +1,18 @@
 import {
   attrs,
   createMixin,
-  css,
   on,
-  type CSSMixinDescriptor,
   type ElementProps,
   type Handle,
   type MixinFactory,
   type RemixNode,
 } from '@remix-run/ui'
-import { theme } from '../../theme/theme.ts'
 import {
   hiddenTypeahead,
   matchNextItemBySearchText,
   type SearchValue,
-} from '../../interactions/typeahead/typeahead-mixin.ts'
-import { flashAttribute } from '../../utils/flash-attribute.ts'
+} from '../shared/typeahead.ts'
+import { flashAttribute } from './flash-attribute.ts'
 
 export type ListboxValue = string | null
 
@@ -69,88 +66,6 @@ export interface ListboxRegisteredOption extends ListboxOption {
 
 interface RegisteredOption extends ListboxRegisteredOption {}
 
-const listCss: CSSMixinDescriptor = css({
-  display: 'flex',
-  flexDirection: 'column',
-  outline: 'none',
-  userSelect: 'none',
-  WebkitUserSelect: 'none',
-  '--rmx-ui-item-inset': theme.space.sm,
-  '--rmx-ui-item-indicator-gap': theme.space.xs,
-  '--rmx-ui-item-indicator-width': theme.fontSize.sm,
-})
-
-const itemCss: CSSMixinDescriptor = css({
-  display: 'grid',
-  gridTemplateColumns: 'max-content minmax(0, 1fr)',
-  alignItems: 'center',
-  width: '100%',
-  minHeight: theme.control.height.md,
-  padding: `${theme.space.xs} ${theme.space.sm}`,
-  borderRadius: theme.radius.md,
-  backgroundColor: 'transparent',
-  color: theme.colors.text.primary,
-  fontFamily: theme.fontFamily.sans,
-  fontSize: theme.fontSize.sm,
-  fontWeight: theme.fontWeight.normal,
-  lineHeight: theme.lineHeight.normal,
-  textAlign: 'left',
-  userSelect: 'none',
-  WebkitUserSelect: 'none',
-  '&:focus': {
-    outline: 'none',
-  },
-  '&[data-highlighted="true"]': {
-    backgroundColor: theme.colors.action.primary.background,
-    color: theme.colors.action.primary.foreground,
-  },
-  '&[aria-disabled="true"]': {
-    opacity: 0.5,
-  },
-  scrollMarginBlock: theme.space.xs,
-  '--rmx-listbox-option-indicator-opacity': '0',
-  '&[hidden]': {
-    display: 'none',
-  },
-  '&[data-listbox-flash="true"], &[data-select-flash="true"], &[data-combobox-flash="true"]': {
-    backgroundColor: 'transparent',
-    color: theme.colors.text.primary,
-  },
-  '&[aria-selected="true"]': {
-    '--rmx-listbox-option-indicator-opacity': '1',
-  },
-})
-
-const itemGlyphCss: CSSMixinDescriptor = css({
-  gridColumn: '1',
-  display: 'inline-flex',
-  alignItems: 'center',
-  justifyContent: 'center',
-  width: '1em',
-  height: '1em',
-  color: 'currentColor',
-  flexShrink: 0,
-  opacity: 'var(--rmx-listbox-option-indicator-opacity)',
-  '& > svg': {
-    display: 'block',
-    width: '100%',
-    height: '100%',
-  },
-})
-
-const itemLabelCss: CSSMixinDescriptor = css({
-  display: 'inline-flex',
-  alignItems: 'center',
-  minWidth: 0,
-  paddingInline: theme.space.xs,
-  WebkitUserSelect: 'none',
-})
-
-export const listStyle = listCss
-export const optionStyle = itemCss
-export const glyphStyle = itemGlyphCss
-export const labelStyle = itemLabelCss
-
 function ListboxProvider(handle: Handle<ListboxProviderProps, ListboxContext>): () => RemixNode {
   let options: RegisteredOption[] = []
   let state: State = 'idle'

package/src/menu/README.md

@@ -0,0 +1,161 @@
+# menu
+
+`Menu` renders a button-triggered menu with keyboard navigation, checked items, selection events, and nested submenus. Use it for action menus and command groups.
+
+## Component Usage
+
+```tsx
+import type { Handle } from 'remix/ui'
+import { css } from 'remix/ui'
+import { Menu, MenuItem, Submenu } from 'remix/ui/menu'
+import { onMenuSelect } from 'remix/ui/menu/primitives'
+
+export function ViewMenu(handle: Handle) {
+  let wordWrap = false
+  let density = 'comfortable'
+
+  return () => (
+    <Menu
+      label="View"
+      mix={onMenuSelect((event) => {
+        if (event.item.name === 'wordWrap') {
+          wordWrap = event.item.checked ?? false
+        } else if (event.item.name === 'density' && event.item.value) {
+          density = event.item.value
+        }
+
+        void handle.update()
+      })}
+    >
+      <MenuItem checked={wordWrap} name="wordWrap" type="checkbox">
+        Word wrap
+      </MenuItem>
+      <MenuItem disabled name="minimap">
+        Minimap
+      </MenuItem>
+      <hr mix={separatorStyle} />
+      <MenuItem checked={density === 'compact'} name="density" type="radio" value="compact">
+        Compact
+      </MenuItem>
+      <MenuItem checked={density === 'comfortable'} name="density" type="radio" value="comfortable">
+        Comfortable
+      </MenuItem>
+      <Submenu label="Zoom">
+        <MenuItem name="zoomIn" value="zoom-in">
+          Zoom in
+        </MenuItem>
+        <MenuItem name="zoomOut" value="zoom-out">
+          Zoom out
+        </MenuItem>
+      </Submenu>
+    </Menu>
+  )
+}
+
+let separatorStyle = css({
+  border: 0,
+  borderBlockStart: '1px solid #e5e7eb',
+  marginBlock: '4px',
+})
+```
+
+Use `label` or `searchValue` when the rendered item content is not the text that should be used for event labels or typeahead.
+
+```tsx
+<MenuItem label="Open command palette" name="commandPalette" searchValue="palette">
+  Command palette
+</MenuItem>
+```
+
+Use `menuLabel` when the menu surface needs a different accessible label from the visible trigger.
+
+```tsx
+<Menu label="..." menuLabel="Project actions">
+  <MenuItem name="rename">Rename project</MenuItem>
+</Menu>
+```
+
+Use `menu.contextTrigger()` with `menu.Context` and `MenuList` when a menu should open at the right-click location of an element.
+
+```tsx
+import { MenuItem, MenuList } from 'remix/ui/menu'
+import * as menu from 'remix/ui/menu/primitives'
+
+export function FileContextMenu(handle: Handle) {
+  return () => (
+    <menu.Context label="File actions">
+      <div mix={menu.contextTrigger()} tabIndex={0}>
+        File.txt
+      </div>
+      <MenuList>
+        <MenuItem name="rename">Rename</MenuItem>
+        <MenuItem name="delete">Delete</MenuItem>
+      </MenuList>
+    </menu.Context>
+  )
+}
+```
+
+Attach `onMenuSelect(...)` from `remix/ui/menu/primitives` to `MenuList` or a shared ancestor when using lower-level context menu composition.
+
+## Primitive Usage
+
+Use only the lower-level primitives when app code owns the trigger, surface, and item markup:
+
+```tsx
+import * as menu from 'remix/ui/menu/primitives'
+import { itemStyle, listStyle, popoverStyle, triggerStyle } from './menu.styles'
+
+export function PrimitiveMenu() {
+  return (
+    <menu.Context label="Project actions">
+      <button mix={[triggerStyle, menu.trigger()]} type="button">
+        Actions
+      </button>
+      <div mix={[popoverStyle, menu.popover()]}>
+        <div mix={[listStyle, menu.list()]}>
+          <div mix={[itemStyle, menu.item({ name: 'rename' })]}>Rename</div>
+          <div mix={[itemStyle, menu.item({ disabled: true, name: 'archive' })]}>Archive</div>
+        </div>
+      </div>
+    </menu.Context>
+  )
+}
+```
+
+## `remix/ui/menu`
+
+- `Menu`: composed trigger, popover, and list component for the common menu case.
+- `MenuItem`: menu item component. Supports regular, checkbox, and radio item roles through `type`, `checked`, `name`, `value`, `label`, `disabled`, and `searchValue`.
+- `Submenu`: nested menu component with its own trigger and child menu surface.
+- `MenuList`: lower-level styled list component for custom composition inside `menu.Context`.
+- `buttonStyle`, `popoverStyle`, `listStyle`, `itemStyle`, `itemSlotStyle`, `itemLabelStyle`, `itemIndicatorStyle`, and `triggerIndicatorStyle`: flat style mixins used by the component markup.
+- `MenuProps`, `MenuItemProps`, `MenuListProps`, and `SubmenuProps`: public TypeScript props for the composed APIs.
+
+## `remix/ui/menu/primitives`
+
+- `Context`: lower-level provider for custom menu composition.
+- `trigger()`: wires a button-style trigger to open the root menu.
+- `contextTrigger()`: opens the root menu from a `contextmenu` event at pointer coordinates, or from keyboard context-menu shortcuts.
+- `popover()`: wires the menu popover surface.
+- `list()`: wires the menu list root, focus handling, keyboard navigation, and typeahead.
+- `item(...)`: registers one menu item. Supports regular, checkbox, and radio roles through `type`, `checked`, `name`, `value`, `label`, `disabled`, and `searchValue`.
+- `submenuTrigger(...)`: registers a menu item that opens a child menu.
+- `onMenuSelect(...)`: event mixin for the bubbling `MenuSelectEvent`.
+- `MenuSelectEvent`: bubbling event whose `item` describes the selected item.
+- `MenuSelectItem`, `MenuProviderProps`, `MenuTriggerOptions`, `MenuContextTriggerOptions`, `MenuItemOptions`, and `SubmenuTriggerOptions`: public TypeScript event, prop, and option types for the primitives.
+
+## Behavior Notes
+
+- Click opens the root menu and focuses the list; clicking the trigger again closes it and restores focus.
+- `menu.contextTrigger()` opens the root menu from a `contextmenu` event at the pointer coordinates and supports keyboard opening with the Context Menu key or Shift+F10.
+- `ArrowDown` opens from the trigger at the first enabled item. `ArrowUp` opens at the last enabled item. Enter and Space open the menu with focus on the list.
+- Keyboard navigation skips disabled items and does not wrap past the first or last enabled item.
+- `Home` and `End` move to the first and last enabled item. Enter and Space activate the highlighted item.
+- Printable keys use typeahead. Typeahead matches `searchValue` when provided and otherwise uses the item label.
+- Submenus open with `ArrowRight`, close with `ArrowLeft`, and are anchored to the submenu trigger with `right-start` placement.
+- Pointer movement highlights enabled items. Submenus open after a short focus/pointer delay and use hover aim so they stay open while moving toward the child surface.
+- Selecting a regular item flashes that item. Selecting a checkbox or radio item flashes the committed checked state.
+- Selection dispatches one bubbled `MenuSelectEvent`, closes the full menu tree, and restores focus to the root trigger.
+- The composed `Menu` re-dispatches selection from its trigger so handlers on the `Menu` button and shared ancestors see the event once.
+- `menuLabel`, `Submenu.menuLabel`, and `Submenu.listProps` let composed menus label and customize menu surfaces separately from trigger content.