Build Agentic workflows, RAG pipelines, with rich AI model and tool support on one collaborative workspace. Deploy on cloud, VPC, or self-hosted, so teams move from prototype to production without rebuilding the stack.
Python agentagentic-aiagentic-frameworkagentic-workflowaiautomationclaudedeepseekgenaigptllmlow-codemcpnextjsno-codeopenaipythonskillsworkflow
'use client'
import { useStableCallback } from '@base-ui/utils/useStableCallback'
import { useTimeout } from '@base-ui/utils/useTimeout'
import * as React from 'react'
import { cn } from '../../cn'
type OptionColumnProps = {
label: string
normalizeDigits: (text: string) => string
value: number
options: { value: number; label: string }[]
onValueChange: (value: number) => void
onEscape?: () => void
scrollRequest?: number
focusOnMount?: boolean
readOnly?: boolean
}
function OptionColumn({
label,
normalizeDigits,
value,
options,
onValueChange,
focusOnMount,
onEscape,
scrollRequest = 0,
readOnly,
}: OptionColumnProps) {
const ref = React.useRef<HTMLDivElement>(null)
const id = React.useId()
const selectedIndex = options.findIndex((option) => option.value === value)
const tabbableIndex = Math.max(0, selectedIndex)
const searchRef = React.useRef({ text: '', time: 0, startIndex: 0 })
React.useEffect(() => {
searchRef.current = { text: '', time: 0, startIndex: 0 }
}, [normalizeDigits])
// At rest the scroll position is the selection. Only scrolls this column starts are positioning.
const scrollRef = React.useRef<{ moved: boolean; target: number | null }>({
moved: false,
target: null,
})
const quietTimer = useTimeout()
const cancelGesture = useStableCallback(() => {
quietTimer.clear()
scrollRef.current.moved = false
})
const scrollToOption = useStableCallback((option: HTMLElement, smooth = false) => {
const column = ref.current
if (!column) return
scrollRef.current.target =
Math.abs(column.scrollTop - option.offsetTop) < 1 ? null : option.offsetTop
column.scrollTo({
top: option.offsetTop,
behavior:
smooth &&
!column.ownerDocument.defaultView?.matchMedia('(prefers-reduced-motion: reduce)').matches
? 'smooth'
: 'instant',
})
})
function nearestOption() {
const column = ref.current
if (!column?.clientHeight) return undefined
return Array.from(column.querySelectorAll<HTMLElement>('[role="option"]')).reduce<
HTMLElement | undefined
>(
(nearest, option) =>
!nearest ||
Math.abs(option.offsetTop - column.scrollTop) <
Math.abs(nearest.offsetTop - column.scrollTop)
? option
: nearest,
undefined,
)
}
const selectNearest = React.useEffectEvent(() => {
const option = nearestOption()
if (!option) return undefined
const next = Number(option.dataset.optionValue)
if (next !== value && !readOnly) onValueChange(next)
return option
})
const finishScroll = React.useEffectEvent(() => {
cancelGesture()
scrollRef.current.target = null
if (readOnly) {
const selected = ref.current?.querySelector<HTMLElement>('[aria-selected="true"]')
if (selected) scrollToOption(selected)
return
}
const option = selectNearest()
if (option && ref.current?.contains(ref.current.ownerDocument.activeElement))
option.focus({ preventScroll: true })
})
React.useEffect(() => {
const column = ref.current
if (!column) return
const supportsScrollEnd = 'onscrollend' in column
function onScroll() {
const positioning = scrollRef.current.target !== null
if (!positioning) {
scrollRef.current.moved = true
selectNearest()
}
// A positioning scroll that never reaches its target was taken over; rest decides.
if (positioning || !supportsScrollEnd) quietTimer.start(150, () => finishScroll())
}
const onScrollEnd = function onScrollEnd() {
const { target } = scrollRef.current
if (target === null || Math.abs(column.scrollTop - target) < 1) finishScroll()
}
column.addEventListener('scroll', onScroll, { passive: true })
if (supportsScrollEnd) column.addEventListener('scrollend', onScrollEnd)
return () => {
cancelGesture()
column.removeEventListener('scroll', onScroll)
column.removeEventListener('scrollend', onScrollEnd)
}
}, [cancelGesture, quietTimer])
// Entry and Now are explicit positioning commands, never scroll-driven selections.
React.useLayoutEffect(() => {
cancelGesture()
const selected = ref.current?.querySelector<HTMLElement>('[aria-selected="true"]')
if (selected) scrollToOption(selected)
}, [scrollRequest, cancelGesture, scrollToOption])
React.useLayoutEffect(() => {
if (!focusOnMount) return
ref.current
?.querySelector<HTMLElement>('[aria-selected="true"]')
?.focus({ preventScroll: true })
}, [focusOnMount])
function focusValue(next: number, smooth = false) {
cancelGesture()
onValueChange(next)
const option = ref.current?.querySelector<HTMLElement>(`[data-option-value="${next}"]`)
if (!option) return
option.focus({ preventScroll: true })
scrollToOption(option, smooth)
}
return (
<div
role="listbox"
tabIndex={-1}
aria-orientation="vertical"
aria-readonly={readOnly || undefined}
ref={ref}
aria-label={label}
className={cn(
"relative flex h-full min-h-0 min-w-0 flex-1 snap-y snap-mandatory scrollbar-none flex-col items-stretch gap-0.5 overflow-y-auto overscroll-none scroll-auto after:pointer-events-none after:h-[max(0px,calc(100%-1.625rem))] after:shrink-0 after:content-['']",
readOnly && 'overflow-y-hidden',
)}
onBlur={(event) => {
if (!event.currentTarget.contains(event.relatedTarget))
searchRef.current = { text: '', time: 0, startIndex: 0 }
}}
onKeyDown={(event) => {
if (event.key === 'Escape') cancelGesture()
if (event.key === 'Escape' && onEscape) {
event.preventDefault()
event.stopPropagation()
onEscape()
return
}
if (readOnly) return
if (event.altKey || event.ctrlKey || event.metaKey || event.nativeEvent.isComposing) return
if (['ArrowUp', 'ArrowDown', 'PageUp', 'PageDown', 'Home', 'End'].includes(event.key))
searchRef.current = { text: '', time: 0, startIndex: 0 }
if (['ArrowUp', 'ArrowDown', 'PageUp', 'PageDown'].includes(event.key)) {
event.preventDefault()
event.stopPropagation()
const currentOption = scrollRef.current.moved
? nearestOption()
: event.target instanceof HTMLElement
? event.target
: undefined
const currentValue = Number(currentOption?.dataset.optionValue)
const currentIndex = Math.max(
0,
options.findIndex((option) => option.value === currentValue),
)
const step = event.key.startsWith('Page') ? 5 : 1
const delta = event.key.endsWith('Up') ? -step : step
const nextIndex = Math.max(0, Math.min(options.length - 1, currentIndex + delta))
const option = options[nextIndex]
if (option) focusValue(option.value)
return
}
if (event.key === 'Home' || event.key === 'End') {
event.preventDefault()
event.stopPropagation()
const option = event.key === 'Home' ? options[0] : options.at(-1)
if (option) focusValue(option.value)
} else if (
!event.ctrlKey &&
!event.metaKey &&
!event.altKey &&
!event.nativeEvent.isComposing &&
Array.from(event.key).length === 1 &&
event.key !== ' '
) {
event.preventDefault()
event.stopPropagation()
const now = Date.now()
const previous = searchRef.current
let text = now - previous.time < 1000 ? previous.text : ''
let startIndex = text ? previous.startIndex : tabbableIndex + 1
const key = event.key.toLowerCase()
// Repeated letters cycle; repeated digits must still form values such as 11 or 55.
if (
text === key &&
!/^\d$/.test(normalizeDigits(key)) &&
!options.some((option) => option.label.toLowerCase().startsWith(key + key))
) {
text = ''
startIndex = tabbableIndex + 1
}
text += key
searchRef.current = { text, time: now, startIndex }
const normalized = normalizeDigits(text)
const numeric = /^\d+$/.test(normalized)
let match = numeric
? options.find((option) => option.value === Number(normalized))
: undefined
if (!numeric) {
for (let offset = 0; offset < options.length; offset++) {
const option = options[(startIndex + offset) % options.length]
if (option?.label.toLowerCase().startsWith(text)) {
match = option
break
}
}
}
if (match) focusValue(match.value)
else if (!numeric) searchRef.current = { text: '', time: 0, startIndex: 0 }
}
}}
>
{options.map((option, index) => (
<button
key={option.value}
id={`${id}-${option.value}`}
type="button"
role="option"
aria-selected={option.value === value}
tabIndex={index === tabbableIndex ? 0 : -1}
data-option-value={option.value}
onClick={(event) => {
if (!readOnly) focusValue(option.value, event.detail > 0)
}}
className={cn(
'aria-selected:bg-components-button-ghost-bg-hover',
'flex min-h-6 shrink-0 snap-start items-center justify-center rounded-md px-1 system-xs-medium text-text-secondary tabular-nums hover:not-aria-selected:bg-state-base-hover-subtle focus-visible:outline-2 focus-visible:-outline-offset-2 focus-visible:outline-state-accent-solid forced-colors:aria-selected:outline forced-colors:aria-selected:outline-[Highlight]',
)}
>
{option.label}
</button>
))}
</div>
)
}
export { OptionColumn }