@gunkin/uiify 0.0.14-alpha → 0.0.16-alpha

package/agents/reference/components/carousel.md

@@ -0,0 +1,274 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# carousel
+
+- Import: `@gunkin/uiify/components/carousel`
+- Tier 2 (Client component — pre-hydration SSR); state source none; native element `section > div[scroll-snap]`
+- Without JavaScript: pre-hydration-only
+- Types file: `dist/components/carousel.d.ts`
+- Note: The documented interactive carousel uses /client and requires hydration for synchronized controls. The base entry remains a native no-JS scroller with CSS Scroll Snap and fragment navigation; /fade adds client-driven CSS transitions.
+
+## Exports
+
+- Runtime: `Carousel`
+- Types: `CarouselAxis`, `CarouselItem`, `CarouselLabels`, `CarouselProps`, `CarouselStyle`
+
+## Values
+
+- `CarouselAxis`: `"inline" | "block"`
+- `CarouselReason`: `"previous" | "next" | "dot" | "command" | "scroll" | "drag" | "autoplay" | "controlled" | "items"`
+
+## Props and shapes
+
+### CarouselItem
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `id` | `string` | yes |  |
+| `label` | `string` | yes |  |
+| `children` | `ReactNode` | yes |  |
+| `className` | `string` | no |  |
+
+### CarouselLabels
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `previous` | `string` | yes |  |
+| `next` | `string` | yes |  |
+| `goTo` | `string` | yes |  |
+| `navigation` | `string` | yes |  |
+| `start` | `string` | yes |  |
+| `stop` | `string` | yes |  |
+| `of` | `string` | yes |  |
+
+### CarouselIcons
+
+Visible content for the client entries' buttons. Empty by default: `labels` already supplies each button's accessible name, so a consumer supplies whatever it wants to see — an icon, a glyph, a word — without the component shipping one of its own.
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `previous` | `ReactNode` | no |  |
+| `next` | `ReactNode` | no |  |
+
+### CarouselStyle
+
+Extends: `CSSProperties`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `"--uiify-carousel-slide-size"` | `string` | no |  |
+| `"--uiify-carousel-gap"` | `string` | no |  |
+| `"--uiify-carousel-fade-duration"` | `string` | no |  |
+
+### CarouselProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `id` | `string` | yes |  |
+| `items` | `readonly CarouselItem[]` | yes |  |
+| `"aria-label"` | `string` | yes |  |
+| `axis` | `CarouselAxis` | no |  |
+| `dir` | `"ltr" \| "rtl"` | no |  |
+| `navigation` | `boolean` | no |  |
+| `pagination` | `boolean` | no |  |
+| `className` | `string` | no |  |
+| `style` | `CarouselStyle` | no |  |
+| `labels` | `Partial<CarouselLabels>` | no |  |
+| `icons` | `CarouselIcons` | no |  |
+
+### CarouselChange
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `previousIndex` | `number` | yes |  |
+| `index` | `number` | yes |  |
+| `reason` | `CarouselReason` | yes |  |
+
+### CarouselAutoplayOptions
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `delay` | `number` | no |  |
+| `paused` | `boolean` | no |  |
+| `cycles` | `number` | no |  |
+| `stopOnInteraction` | `boolean` | no |  |
+
+### CarouselClientProps
+
+Extends: `CarouselProps`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `ref` | `Ref<CarouselClientHandle>` | no |  |
+| `defaultValue` | `number` | no |  |
+| `value` | `number` | no |  |
+| `rewind` | `boolean` | no |  |
+| `mouseDrag` | `boolean` | no |  |
+| `autoplay` | `boolean \| CarouselAutoplayOptions` | no |  |
+| `onSelect` | `(index: number, detail: CarouselChange) => void` | no |  |
+| `beforeChange` | `(detail: CarouselChange) => void` | no |  |
+| `afterChange` | `(detail: CarouselChange) => void` | no |  |
+| `onSwipe` | `(detail: CarouselChange) => void` | no |  |
+
+### FadeCarouselClientProps
+
+Extends: `Omit<CarouselClientProps, "axis">`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `swipe` | `boolean` | no |  |
+
+### CarouselClientHandle
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `next` | `() => void` | yes |  |
+| `previous` | `() => void` | yes |  |
+| `goTo` | `(index: number) => void` | yes |  |
+| `start` | `() => void` | yes |  |
+| `stop` | `() => void` | yes |  |
+| `reset` | `() => void` | yes |  |
+
+### CarouselPage
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `index` | `number` | yes |  |
+| `offset` | `number` | yes |  |
+
+### CarouselSnapshot
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `settledIndex` | `number` | yes |  |
+| `ready` | `boolean` | yes |  |
+| `index` | `number` | yes |  |
+| `requestedIndex` | `number \| null` | yes |  |
+| `settledChange` | `CarouselChange \| null` | yes |  |
+| `pages` | `readonly CarouselPage[]` | yes |  |
+| `visibleIndices` | `readonly number[]` | yes |  |
+| `atStart` | `boolean` | yes |  |
+| `atEnd` | `boolean` | yes |  |
+| `moving` | `boolean` | yes |  |
+| `interacting` | `boolean` | yes |  |
+
+### CarouselControllerOptions
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `defaultValue` | `number` | yes |  |
+| `value` | `number` | no |  |
+| `rewind` | `boolean` | yes |  |
+| `onSelect` | `CarouselClientProps["onSelect"]` | no |  |
+| `beforeChange` | `CarouselClientProps["beforeChange"]` | no |  |
+| `afterChange` | `CarouselClientProps["afterChange"]` | no |  |
+| `onSwipe` | `CarouselClientProps["onSwipe"]` | no |  |
+
+### CarouselController
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `getSnapshot` | `() => CarouselSnapshot` | yes |  |
+| `getGeometry` | `() => CarouselGeometry \| undefined` | yes |  |
+| `subscribe` | `(listener: () => void) => () => void` | yes |  |
+| `goTo` | `(index: number, reason: CarouselReason) => void` | yes |  |
+| `next` | `(reason: CarouselReason) => void` | yes |  |
+| `previous` | `(reason: CarouselReason) => void` | yes |  |
+| `setInteracting` | `(active: boolean) => void` | yes |  |
+| `update` | `(options: CarouselControllerOptions) => void` | yes |  |
+| `refresh` | `() => void` | yes |  |
+| `destroy` | `() => void` | yes |  |
+
+### CarouselGeometry
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `physicalAxis` | `"x" \| "y"` | yes |  |
+| `sign` | `1 \| -1` | yes |  |
+| `viewportSize` | `number` | yes |  |
+| `currentOffset` | `number` | yes |  |
+| `itemStarts` | `readonly number[]` | yes |  |
+| `itemSizes` | `readonly number[]` | yes |  |
+
+### CarouselObservation
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `geometry` | `CarouselGeometry` | yes |  |
+| `visibleIndices` | `readonly number[]` | yes |  |
+
+### CarouselObserver
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `watch` | `(receive: (index: number, visible: readonly number[]) => void) => void` | yes |  |
+| `measure` | `(receive: (value: CarouselObservation) => void) => void` | yes |  |
+| `destroy` | `() => void` | yes |  |
+
+### CarouselAutoplaySnapshot
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `requested` | `boolean` | yes |  |
+| `playing` | `boolean` | yes |  |
+| `completedAdvances` | `number` | yes |  |
+
+### CarouselAutoplayController
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `getSnapshot` | `() => CarouselAutoplaySnapshot` | yes |  |
+| `subscribe` | `(listener: () => void) => () => void` | yes |  |
+| `start` | `() => void` | yes |  |
+| `stop` | `() => void` | yes |  |
+| `reset` | `() => void` | yes |  |
+| `update` | `(options: CarouselAutoplayOptions) => void` | yes |  |
+| `destroy` | `() => void` | yes |  |
+
+### CarouselPresentation
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `mode` | `"scroll" \| "fade"` | yes |  |
+| `snapshot` | `CarouselSnapshot` | yes |  |
+| `autoplay` | `CarouselAutoplaySnapshot` | no |  |
+| `preserveFallbackFocus` | `boolean` | yes |  |
+| `mounted` | `boolean` | yes | True once mounted client-side, even before the controller reports `ready`. |
+
+### CarouselMarkupProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `base` | `CarouselProps` | yes |  |
+| `rootRef` | `Ref<HTMLElement>` | no |  |
+| `presentation` | `CarouselPresentation` | no |  |
+
+### CarouselClientViewProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `base` | `CarouselProps` | yes |  |
+| `rootRef` | `Ref<HTMLElement>` | yes |  |
+| `mode` | `"scroll" \| "fade"` | yes |  |
+| `controller` | `CarouselController` | no |  |
+| `autoplay` | `CarouselAutoplayController` | no |  |
+
+### CarouselCommandController
+
+Actions accepted by native commandfor buttons targeting the root.
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `next` | `() => void` | yes |  |
+| `previous` | `() => void` | yes |  |
+
+## Sub-entries
+
+### `@gunkin/uiify/components/carousel/client`
+
+- Runtime: `CarouselClient`
+- Types: `CarouselClientProps`, `CarouselClientHandle`, `CarouselAutoplayOptions`, `CarouselChange`, `CarouselReason`
+
+### `@gunkin/uiify/components/carousel/fade`
+
+- Runtime: `FadeCarouselClient`
+- Types: `CarouselClientHandle`, `FadeCarouselClientProps`

package/agents/reference/components/checkbox.md

@@ -0,0 +1,32 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# checkbox
+
+- Import: `@gunkin/uiify/components/checkbox`
+- Tier 0 (RSC — zero client JavaScript); state source S1; native element `input[type=checkbox]`
+- Without JavaScript: full
+- Types file: `dist/components/checkbox.d.ts`
+- Note: Native checkbox + label; default entry ships controlled callbacks with use client.
+
+## Exports
+
+- Runtime: `Checkbox`
+- Types: `CheckboxProps`, `CheckedState`
+
+## Props and shapes
+
+### CheckboxProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `id` | `string` | yes |  |
+| `label` | `ReactNode` | no |  |
+| `checked` | `CheckedState` | no |  |
+| `defaultChecked` | `boolean` | no |  |
+| `disabled` | `boolean` | no |  |
+| `className` | `string` | no |  |
+| `onCheckedChange` | `(checked: boolean) => void` | no |  |
+| `"aria-label"` | `string` | no |  |
+
+## Other types
+
+- `CheckedState`: `boolean | "indeterminate"`

package/agents/reference/components/collapsible.md

@@ -0,0 +1,26 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# collapsible
+
+- Import: `@gunkin/uiify/components/collapsible`
+- Tier 0 (RSC — zero client JavaScript); state source S1; native element `details`
+- Without JavaScript: full
+- Types file: `dist/components/collapsible.d.ts`
+- Note: Native details/summary disclosure. Built on @gunkin/uiify/elements/details.
+
+## Exports
+
+- Runtime: `Collapsible`
+- Types: `CollapsibleProps`
+
+## Props and shapes
+
+### CollapsibleProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `id` | `string` | yes |  |
+| `label` | `ReactNode` | yes |  |
+| `content` | `ReactNode` | yes |  |
+| `defaultOpen` | `boolean` | no |  |
+| `disabled` | `boolean` | no |  |
+| `className` | `string` | no |  |

package/agents/reference/components/color-picker.md

@@ -0,0 +1,33 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# color-picker
+
+- Import: `@gunkin/uiify/components/color-picker`
+- Tier 1 (RSC shell + thin client island); state source S1; native element `input[type=color]`
+- Without JavaScript: degraded-documented
+- Types file: `dist/components/color-picker.d.ts`
+
+## Exports
+
+- Runtime: `ColorPicker`
+- Types: `ColorPickerProps`, `ColorSpace`
+
+## Values
+
+- `ColorSpace`: `"limited-srgb" | "display-p3"`
+
+## Props and shapes
+
+### ColorPickerOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `alpha` | `boolean` | no |  |
+| `colorSpace` | `ColorSpace` | no |  |
+| `defaultValue` | `string` | no |  |
+| `label` | `string` | yes |  |
+| `onValueChange` | `(value: string) => void` | no |  |
+| `value` | `string` | no |  |
+
+## Other types
+
+- `ColorPickerProps`: `Omit<ComponentPropsWithRef<"input">, | "alpha" | "className" | "colorSpace" | "defaultValue" | "onChange" | "ref" | "style" | "type" | "value"> & ColorPickerOwnProps & { readonly className?: string; readonly onChange?: ChangeEventHandler<HTMLInputElement>; readonly ref?: Ref<HTMLInputElement>; readonly style?: CSSProperties; }`

package/agents/reference/components/combobox.md

@@ -0,0 +1,193 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# combobox
+
+- Import: `@gunkin/uiify/components/combobox`
+- Tier 2 (Client component — pre-hydration SSR); state source S2; native element `input+listbox`
+- Without JavaScript: pre-hydration-only
+- Types file: `dist/components/combobox.d.ts`
+
+## Exports
+
+- Runtime: `Combobox`, `ComboboxControl`, `ComboboxContent`, `ComboboxEmpty`, `ComboboxInput`, `ComboboxItem`, `ComboboxRoot`, `ComboboxTags`, `ComboboxTrigger`
+- Types: `ComboboxContentOwnProps`, `ComboboxControlOwnProps`, `ComboboxControlProps`, `ComboboxEmptyOwnProps`, `ComboboxFilterFn`, `ComboboxInputOwnProps`, `ComboboxInputProps`, `ComboboxItemData`, `ComboboxItemOwnProps`, `ComboboxRootControlledOwnProps`, `ComboboxRootShellOwnProps`, `ComboboxRootShellProps`, `ComboboxRootProps`, `ComboboxTagsOwnProps`, `ComboboxTagsProps`, `ComboboxTriggerOwnProps`, `ComboboxTriggerProps`
+
+## Values
+
+- `ActiveMoveDirection`: `"first" | "last" | "next" | "prev"`
+
+## Props and shapes
+
+### ComboboxItemData
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `disabled` | `boolean` | no |  |
+| `label` | `string` | yes |  |
+| `value` | `string` | yes |  |
+
+### ComboboxActiveStore
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `getActiveId` | `() => string \| null` | yes |  |
+| `isActive` | `(id: string) => boolean` | yes |  |
+| `setActiveId` | `(next: string \| null) => void` | yes |  |
+| `subscribe` | `(listener: () => void) => () => void` | yes |  |
+| `subscribeItem` | `(id: string, listener: () => void) => () => void` | yes |  |
+
+### ComboboxMultiValueOptions
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `addOnPaste` | `boolean` | no |  |
+| `allowCustomValue` | `boolean` | no |  |
+| `delimiters` | `readonly string[]` | no |  |
+| `maxValues` | `number` | no |  |
+| `validateValue` | `(value: string) => boolean` | no |  |
+
+### ComboboxContextValue
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `activeStore` | `ComboboxActiveStore` | yes |  |
+| `addOnPaste` | `boolean` | yes |  |
+| `anchorProps` | `UseAnchorPositionReturn["anchorProps"]` | yes |  |
+| `anchorRef` | `UseAnchorPositionReturn["anchorRef"]` | yes |  |
+| `close` | `() => void` | yes |  |
+| `filterFn` | `ComboboxFilterFn` | yes |  |
+| `inputNode` | `HTMLElement \| null` | yes |  |
+| `inputValue` | `string` | yes |  |
+| `items` | `readonly ComboboxItemData[]` | yes |  |
+| `listboxId` | `string` | yes |  |
+| `delimiters` | `readonly string[]` | yes |  |
+| `multiple` | `boolean` | yes |  |
+| `selectedValues` | `readonly string[]` | yes |  |
+| `getValueLabel` | `(value: string) => string` | yes |  |
+| `isValueSelected` | `(value: string) => boolean` | yes |  |
+| `toggleValue` | `(item: ComboboxItemData) => void` | yes |  |
+| `removeValue` | `(value: string) => void` | yes |  |
+| `commitValue` | `(value: string) => boolean` | yes |  |
+| `open` | `() => void` | yes |  |
+| `openState` | `boolean` | yes |  |
+| `popupProps` | `UsePopoverReturn["popupProps"]` | yes |  |
+| `popupRef` | `UsePopoverReturn["popupRef"]` | yes |  |
+| `positionerProps` | `UseAnchorPositionReturn["positionerProps"]` | yes |  |
+| `positionerRef` | `UseAnchorPositionReturn["positionerRef"]` | yes |  |
+| `selectItem` | `(item: ComboboxItemData) => void` | yes |  |
+| `setInputElement` | `(element: HTMLElement \| null) => void` | yes |  |
+| `setInputValue` | `(value: string) => void` | yes |  |
+| `value` | `string \| readonly string[] \| undefined` | no |  |
+
+### ComboboxRootShellOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `className` | `string` | no |  |
+| `defaultInputValue` | `string` | no |  |
+| `defaultOpen` | `boolean` | no |  |
+| `defaultValue` | `string` | no |  |
+| `filterFn` | `ComboboxFilterFn` | no |  |
+| `id` | `string` | no |  |
+| `items` | `readonly ComboboxItemData[]` | yes |  |
+
+### ComboboxRootControlledOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `inputValue` | `string` | no |  |
+| `onInputValueChange` | `(value: string) => void` | no |  |
+| `onOpenChange` | `PopoverChangeHandler` | no |  |
+| `onValueChange` | `(value: string) => void` | no |  |
+| `open` | `boolean` | no |  |
+| `value` | `string \| readonly string[]` | no |  |
+
+### ComboboxRootShellProps
+
+Extends: `ComboboxRootShellOwnProps`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+
+### ComboboxRootSingleProps
+
+Extends: `ComboboxRootShellOwnProps`, `Omit<ComboboxRootControlledOwnProps, "onValueChange" | "value">`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `multiple` | `false` | no |  |
+| `defaultValue` | `string` | no |  |
+| `onValueChange` | `(value: string) => void` | no |  |
+| `value` | `string` | no |  |
+| `children` | `ReactNode` | no |  |
+
+### ComboboxRootMultiProps
+
+Extends: `Omit<ComboboxRootShellOwnProps, "defaultValue">`, `Omit<ComboboxRootControlledOwnProps, "onValueChange" | "value">`, `ComboboxMultiValueOptions`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `multiple` | `true` | yes |  |
+| `defaultValue` | `readonly string[]` | no |  |
+| `onValueChange` | `(value: string[]) => void` | no |  |
+| `value` | `readonly string[]` | no |  |
+| `children` | `ReactNode` | no |  |
+
+### ComboboxControlOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+
+### ComboboxTagsOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+
+### ComboboxInputOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `className` | `string` | no |  |
+
+### ComboboxTriggerOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+
+### ComboboxContentOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `align` | `AnchorAlign` | no |  |
+| `children` | `(filteredItems: ComboboxItemData[]) => ReactNode` | yes |  |
+| `className` | `string` | no |  |
+| `side` | `AnchorSide` | no |  |
+
+### ComboboxItemOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `className` | `string` | no |  |
+| `item` | `ComboboxItemData` | yes |  |
+
+### ComboboxEmptyOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+
+## Other types
+
+- `ComboboxFilterFn`: `(items: readonly ComboboxItemData[], inputValue: string) => ComboboxItemData[]`
+- `ComboboxRootProps`: `ComboboxRootSingleProps | ComboboxRootMultiProps`
+- `ComboboxControlProps<TAs>`: `RenderableProps<TAs, ComboboxControlOwnProps, Record<string, never>, HTMLElement>`
+- `ComboboxTagsProps<TAs>`: `RenderableProps<TAs, ComboboxTagsOwnProps, Record<string, never>, HTMLElement>`
+- `ComboboxInputProps<TAs>`: `RenderableProps<TAs, ComboboxInputOwnProps, { open: boolean }, HTMLInputElement>`
+- `ComboboxTriggerProps<TAs>`: `RenderableProps<TAs, ComboboxTriggerOwnProps, { open: boolean }, HTMLElement>`

package/agents/reference/components/context-menu.md

@@ -0,0 +1,129 @@
+<!-- Generated from the package source. Do not edit by hand. -->
+# context-menu
+
+- Import: `@gunkin/uiify/components/context-menu`
+- Tier 2 (Client component — pre-hydration SSR); state source S2; native element `[popover]`
+- Without JavaScript: pre-hydration-only
+- Types file: `dist/components/context-menu.d.ts`
+
+## Exports
+
+- Runtime: `ContextMenu`, `ContextMenuCheckboxItem`, `ContextMenuContent`, `ContextMenuItem`, `ContextMenuLabel`, `ContextMenuRadioItem`, `ContextMenuRoot`, `ContextMenuSeparator`, `ContextMenuSub`, `ContextMenuSubContent`, `ContextMenuSubTrigger`, `ContextMenuTrigger`
+- Types: `ContextMenuCheckboxItemOwnProps`, `ContextMenuContentOwnProps`, `ContextMenuContentProps`, `ContextMenuItemOwnProps`, `ContextMenuItemProps`, `ContextMenuRadioItemOwnProps`, `ContextMenuRootControlledOwnProps`, `ContextMenuRootShellOwnProps`, `ContextMenuRootShellProps`, `ContextMenuRootProps`, `ContextMenuSubContentOwnProps`, `ContextMenuSubOwnProps`, `ContextMenuSubTriggerOwnProps`, `ContextMenuTriggerOwnProps`, `ContextMenuTriggerProps`, `ContextMenuLabelOwnProps`, `ContextMenuSeparatorOwnProps`
+
+## Props and shapes
+
+### ContextMenuContextValue
+
+Extends: `UseMenuSurfaceReturn`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `openAtPointer` | `(event: MouseEvent<HTMLElement>) => void` | yes | Opens at the pointer's coordinates: positions the virtual anchor, then opens. |
+| `radioValue` | `string \| undefined` | yes |  |
+| `setRadioValue` | `(value: string) => void` | yes |  |
+
+### ContextMenuRootShellOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `defaultOpen` | `boolean` | no |  |
+| `id` | `string` | no |  |
+
+### ContextMenuRootControlledOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `onOpenChange` | `PopoverChangeHandler` | no |  |
+| `open` | `boolean` | no |  |
+
+### ContextMenuRootShellProps
+
+Extends: `ContextMenuRootShellOwnProps`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+
+### ContextMenuRootProps
+
+Extends: `ContextMenuRootShellOwnProps`, `ContextMenuRootControlledOwnProps`
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+
+### ContextMenuTriggerOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+
+### ContextMenuContentOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+
+### ContextMenuItemOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+| `disabled` | `boolean` | no |  |
+| `onSelect` | `(event: MenuSelectEvent) => void` | no |  |
+| `textValue` | `string` | no |  |
+
+### ContextMenuCheckboxItemOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `checked` | `boolean \| "indeterminate"` | no |  |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+| `disabled` | `boolean` | no |  |
+| `onCheckedChange` | `(checked: boolean) => void` | no |  |
+| `textValue` | `string` | no |  |
+
+### ContextMenuRadioItemOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+| `disabled` | `boolean` | no |  |
+| `textValue` | `string` | no |  |
+| `value` | `string` | yes |  |
+
+### ContextMenuSubOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+
+### ContextMenuSubTriggerOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+| `disabled` | `boolean` | no |  |
+| `textValue` | `string` | no |  |
+
+### ContextMenuSubContentOwnProps
+
+| Member | Type | Required | Description |
+| --- | --- | --- | --- |
+| `children` | `ReactNode` | no |  |
+| `className` | `string` | no |  |
+
+## Other types
+
+- `ContextMenuLabelOwnProps`: `DropdownMenuLabelOwnProps`
+- `ContextMenuSeparatorOwnProps`: `DropdownMenuSeparatorOwnProps`
+- `ContextMenuTriggerProps<TAs>`: `RenderableProps<TAs, ContextMenuTriggerOwnProps, { open: boolean }, HTMLElement>`
+- `ContextMenuContentProps<TAs>`: `RenderableProps<TAs, ContextMenuContentOwnProps, { open: boolean }, HTMLElement>`
+- `ContextMenuItemProps<TAs>`: `RenderableProps<TAs, ContextMenuItemOwnProps, { disabled: boolean }, HTMLElement>`