{"$schema":"https://ui.shadcn.com/schema/registry-item.json","name":"plinko","type":"registry:block","title":"Plinko","description":"A Plinko board where balls drop through rows of pegs, bounce left or right off each one and land in a slot. Pegs flash when hit, the slot pulses on landing, several balls can fall at once, and reduced motion lands a ball instantly.","author":"Saurabh ","dependencies":["@floating-ui/dom","clsx","lucide-react","motion","tailwind-merge"],"registryDependencies":[],"files":[{"path":"components/motion/plinko.tsx","type":"registry:component","target":"@components/motion/plinko.tsx","content":"\"use client\";\n// beui.dev/components/blocks/plinko\n\nimport { type LucideIcon, Volume2, VolumeX, Zap, ZapOff } from \"lucide-react\";\nimport { AnimatePresence, motion, useAnimate, useReducedMotion } from \"motion/react\";\nimport { useEffect, useRef, useState } from \"react\";\nimport { ActionSwapCascadeIcon } from \"@/components/motion/action-swap-cascade\";\nimport { Button } from \"@/components/motion/button\";\nimport { Tooltip } from \"@/components/motion/tooltip\";\nimport { EASE_OUT } from \"@/lib/ease\";\nimport { createTickPlayer } from \"@/lib/tick-sound\";\nimport { cn } from \"@/lib/utils\";\n\nexport type PlinkoValue = string | number;\n\nexport interface PlinkoProps {\n /** Rows of pegs when `slots` isn't passed. Default 12. */\n rows?: number;\n /**\n * Slot values, left to right. Their count sets the board: n slots get\n * n - 1 rows of pegs, so `rows` is ignored when this is passed. Without it\n * the slots come from `plinkoSlots(rows)`. Fewer than 2 slots render nothing.\n */\n slots?: PlinkoValue[];\n /** Called with the slot index and its value when a ball lands. */\n onLand?: (slot: number, value: PlinkoValue) => void;\n /** Balls allowed in flight at once. Default 12. */\n maxBalls?: number;\n /** Label of the drop button. Default \"Drop ball\". */\n dropLabel?: string;\n /** Flash each peg as the ball hits it (controlled). Its button is hidden with reduced motion, where no pegs are hit. */\n pegFlash?: boolean;\n /** Initial peg flash state when uncontrolled. Default true. */\n defaultPegFlash?: boolean;\n /** Called when the peg flash button is toggled. */\n onPegFlashChange?: (pegFlash: boolean) => void;\n /** Tooltip and accessible name of the peg flash button. Default \"Peg flash\". */\n pegFlashLabel?: string;\n /** Click on every peg hit and landing (controlled). */\n sound?: boolean;\n /** Initial sound state when uncontrolled. Default false. */\n defaultSound?: boolean;\n /** Called when the sound button is toggled. */\n onSoundChange?: (sound: boolean) => void;\n /** Tooltip and accessible name of the sound button. Default \"Sound\". */\n soundLabel?: string;\n /** Accessible name for the board. Default \"Plinko board\". */\n \"aria-label\"?: string;\n className?: string;\n}\n\n// Board geometry in SVG units; the board scales to its container's width.\nconst GAP = 32; // horizontal space between pegs\nconst ROW = 30; // vertical space between peg rows\nconst PEG = 3.5;\nconst BALL = 7;\nconst TOP = 48; // first peg row\nconst SLOT = 34; // slot height\n\n// A ball falls between pegs under gravity and rises a little after each hit.\n// lib/ease has no ease-in, and the fall must accelerate, so these two are\n// local: FALL speeds up like a drop, RISE slows down like a hop.\nconst FALL = [0.55, 0, 1, 0.45] as const;\nconst RISE = [0, 0.55, 0.45, 1] as const;\nconst HOP_TIME = 0.09; // seconds rising after a peg\nconst DROP_TIME = 0.16; // seconds falling to the next peg\nconst HOP_HEIGHT = 7;\n// Landing tick playback rates: 0.55 in the centre slot, up to 0.95 at the edges.\nconst LANDING_RATE = 0.55;\nconst LANDING_SPREAD = 0.4;\n\ntype Ball = {\n id: number;\n path: { x: number; y: number }[];\n times: number[];\n slot: number;\n duration: number;\n /** Id of the peg hit on each row, top to bottom. */\n pegs: string[];\n /** Row of the last peg hit, -1 before the first. */\n lastRow: number;\n /** Last rendered y, to catch the frame the ball turns back up off a peg. */\n y: number;\n /** Moving up on the last frame: still on the hop from the last peg. */\n rising: boolean;\n /** Set once the ball reaches its slot; its exit fade must not land again. */\n landed?: boolean;\n};\n\nlet nextBall = 0;\n\n/** Height of the ball's centre where it touches a peg on `row`. */\nconst contactY = (row: number) => TOP + row * ROW - PEG - BALL;\n\n/** Random left/right steps from the top peg to a slot, as keyframes. */\nfunction plan(rows: number, width: number): Omit {\n const center = width / 2;\n const points = [{ x: center, y: BALL }]; // enters fully inside the board\n const steps: number[] = [0.22]; // first fall from the chute to the top peg\n const pegs: string[] = [];\n let k = 0; // rightward steps so far\n for (let row = 0; row < rows; row++) {\n const x = center + (k - row / 2) * GAP;\n pegs.push(`${row}-${k}`);\n points.push({ x, y: contactY(row) });\n const right = Math.random() < 0.5;\n points.push({ x: x + (right ? GAP / 4 : -GAP / 4), y: contactY(row) - HOP_HEIGHT });\n steps.push(HOP_TIME, DROP_TIME);\n if (right) k++;\n }\n // Come to rest just inside the slot's top edge, clear of its label.\n const slotY = TOP + rows * ROW - BALL + 3;\n points.push({ x: center + (k - rows / 2) * GAP, y: slotY });\n const duration = steps.reduce((sum, step) => sum + step, 0);\n const times = [0];\n for (const step of steps) times.push(times[times.length - 1] + step / duration);\n return { path: points, times, slot: k, duration, pegs };\n}\n\n/**\n * A Plinko board: balls drop through rows of pegs, bounce left or right off\n * each one and land in a slot. Pegs flash when hit and the slot pulses on\n * landing. Optional sound clicks on every peg and lands with a thunk that\n * brightens toward the rarer edge slots. With reduced motion a ball lands at\n * once.\n */\nexport function Plinko({\n rows: rowsProp = 12,\n slots,\n onLand,\n maxBalls = 12,\n dropLabel = \"Drop ball\",\n pegFlash,\n defaultPegFlash = true,\n onPegFlashChange,\n pegFlashLabel = \"Peg flash\",\n sound,\n defaultSound = false,\n onSoundChange,\n soundLabel = \"Sound\",\n \"aria-label\": ariaLabel = \"Plinko board\",\n className,\n}: PlinkoProps) {\n const reduce = useReducedMotion() ?? false;\n const [scope, animate] = useAnimate();\n const [balls, setBalls] = useState([]);\n const [announcement, setAnnouncement] = useState(\"\");\n // The last slot hit stays marked after its flash fades.\n const [lastSlot, setLastSlot] = useState(null);\n const [internalSound, setInternalSound] = useState(defaultSound);\n const soundOn = sound ?? internalSound;\n const [internalFlash, setInternalFlash] = useState(defaultPegFlash);\n const flashOn = pegFlash ?? internalFlash;\n\n // Landings are numbered so a second ball in the same slot still changes\n // the live region's text and is announced again.\n const landings = useRef(0);\n // Each player cuts its own previous tick, so landings get their own player:\n // another ball's peg click would otherwise cut the longer landing thunk.\n const players = useRef> | null>(null);\n const getPlayers = () => {\n if (!players.current) players.current = { peg: createTickPlayer(), landing: createTickPlayer() };\n return players.current;\n };\n useEffect(\n () => () => {\n players.current?.peg.dispose();\n players.current?.landing.dispose();\n players.current = null;\n },\n [],\n );\n\n const togglePegFlash = () => {\n const next = !flashOn;\n if (pegFlash === undefined) setInternalFlash(next);\n onPegFlashChange?.(next);\n };\n\n const toggleSound = () => {\n const next = !soundOn;\n // Unlock audio inside the click, where browsers allow it.\n if (next) getPlayers().peg.prepare();\n if (sound === undefined) setInternalSound(next);\n onSoundChange?.(next);\n };\n\n const labels = slots ?? plinkoSlots(rowsProp);\n const rows = labels.length - 1;\n const invalid = labels.length < 2;\n useEffect(() => {\n if (process.env.NODE_ENV !== \"production\" && invalid)\n console.warn(\"Plinko needs at least 2 slots; it renders nothing until it has them.\");\n }, [invalid]);\n\n // A new board size makes every ball in flight point at pegs that moved, so\n // drop them in the same render. Clearing them in an effect would mount them\n // in the new board first, and their exit would land in a slot that may not\n // exist any more.\n const [boardRows, setBoardRows] = useState(rows);\n if (boardRows !== rows) {\n setBoardRows(rows);\n setBalls([]);\n setLastSlot(null);\n }\n\n const width = (rows + 2) * GAP;\n const height = TOP + rows * ROW + SLOT;\n // Each row runs one peg past the ball's reach on both sides, so the board\n // reads as a triangle that widens down to the slots.\n const pegs = Array.from({ length: rows }, (_, row) =>\n Array.from({ length: row + 3 }, (_, i) => ({\n id: `${row}-${i - 1}`,\n x: width / 2 + (i - 1 - row / 2) * GAP,\n y: TOP + row * ROW,\n })),\n ).flat();\n\n const land = (slot: number) => {\n animate(`[data-slot=\"${slot}\"]`, { opacity: [0.9, 0] }, { duration: 0.3, ease: EASE_OUT });\n // A lower thunk than a peg hit marks the landing. It brightens toward\n // the edges, where landing is rarest, so a good drop is heard.\n if (soundOn)\n getPlayers().landing.play(LANDING_RATE + LANDING_SPREAD * (Math.abs(slot - rows / 2) / (rows / 2)));\n setLastSlot(slot);\n landings.current++;\n setAnnouncement(`Ball ${landings.current} landed in slot ${slot + 1}: ${labels[slot]}`);\n onLand?.(slot, labels[slot]);\n };\n\n // Flash and click a peg on the frame the ball turns back up off it. Reading\n // the ball's own frames keeps both on its clock: a background tab pauses\n // them together. motion rebinds onUpdate every render, so the settings\n // read here are always current.\n const hitPegs = (ball: Ball, y: number) => {\n const rising = y < ball.y;\n // The row comes from where the ball turned, not from counting turns, so\n // a slow frame that skips a whole hop misses only that peg. Both frames\n // sit within a hop height above the contact, which rounds to its row.\n const row = Math.round((Math.max(ball.y, y) - contactY(0)) / ROW);\n if (rising && !ball.rising && row > ball.lastRow && row < ball.pegs.length) {\n ball.lastRow = row;\n const peg = ball.pegs[row];\n if (flashOn) {\n // Fast attack, slower decay: the pop peaks a third of the way in.\n animate(\n `[data-peg=\"${peg}\"]`,\n { scale: [1, 1.8, 1], opacity: [0.4, 1, 0.4] },\n { duration: 0.3, times: [0, 0.3, 1], ease: EASE_OUT },\n );\n }\n if (soundOn) getPlayers().peg.play();\n }\n ball.y = y;\n ball.rising = rising;\n };\n\n const full = balls.length >= maxBalls;\n const drop = () => {\n if (full) return;\n const ball: Ball = { id: nextBall++, lastRow: -1, y: 0, rising: false, ...plan(rows, width) };\n if (soundOn) getPlayers().peg.prepare();\n if (reduce) {\n land(ball.slot);\n return;\n }\n setBalls((current) => [...current, ball]);\n };\n\n if (invalid) return null;\n\n return (\n
\n \n {pegs.map((peg) => (\n \n ))}\n\n {labels.map((label, slot) => {\n const x = width / 2 + (slot - rows / 2) * GAP - GAP / 2;\n const y = TOP + rows * ROW;\n return (\n // biome-ignore lint/suspicious/noArrayIndexKey: slots are positional\n \n \n \n \n {label}\n \n \n );\n })}\n\n {/* Keyed by size: balls from a board that changed size leave at once. */}\n \n {balls.map((ball) => (\n point.x),\n y: ball.path.map((point) => point.y),\n opacity: 1,\n scale: 1,\n }}\n // Settle into the slot: a short fade with a small drop.\n exit={{\n opacity: 0,\n y: (ball.path.at(-1)?.y ?? 0) + 4,\n transition: { duration: 0.12, ease: EASE_OUT },\n }}\n transition={{\n opacity: { duration: 0.15, ease: EASE_OUT },\n scale: { duration: 0.15, ease: EASE_OUT },\n x: { duration: ball.duration, times: ball.times, ease: \"linear\" },\n y: {\n duration: ball.duration,\n times: ball.times,\n // Fall into the first peg, then hop up and fall down per row.\n ease: ball.times.slice(1).map((_, i) => (i % 2 === 1 ? RISE : FALL)),\n },\n }}\n onUpdate={(latest) => {\n if (typeof latest.y === \"number\") hitPegs(ball, latest.y);\n }}\n onAnimationComplete={() => {\n if (ball.landed) return;\n ball.landed = true;\n land(ball.slot);\n setBalls((current) => current.filter((other) => other.id !== ball.id));\n }}\n />\n ))}\n \n \n\n
\n {/* aria-disabled, not disabled: a disabled button drops keyboard focus. */}\n \n {dropLabel}\n \n {/* With reduced motion balls land at once and hit no pegs. */}\n {reduce ? null : (\n \n )}\n \n
\n

\n {announcement}\n

\n
\n );\n}\n\n/**\n * Slot values for a board of `rows`: `center` in the middle, growing evenly\n * (geometrically) to `edge` at both ends, where landing is rarest. Rounded to\n * readable numbers: 12 rows give 100, 50, 20, 10, 5, 2, 1, 2, 5, 10, 20, 50, 100.\n * Values from 1 to 10 round to whole numbers, the rest to one significant\n * figure, so fractional curves work: 8 rows with `center: 0.5, edge: 10`\n * give 10, 5, 2, 1, 0.5, 1, 2, 5, 10.\n * `rows` is rounded to at least 1, `center` raised to at least 0.01 and\n * `edge` to at least `center`.\n */\nexport function plinkoSlots(\n rowCount: number,\n options: { center?: number; edge?: number } = {},\n): number[] {\n const rows = Math.max(1, Math.round(rowCount) || 1);\n // Any positive center works; zero or below would divide by zero.\n const center = Math.max(0.01, options.center ?? 1);\n const edge = Math.max(center, options.edge ?? 100);\n const half = rows / 2;\n return Array.from({ length: rows + 1 }, (_, slot) => {\n const value = center * (edge / center) ** (Math.abs(slot - half) / half);\n if (value >= 1 && value < 10) return Math.round(value);\n // One significant figure: 46 reads as 50, 315 as 300, 0.46 as 0.5.\n return Number(value.toPrecision(1));\n });\n}\n\n/** An icon button that shows and toggles one on/off setting. */\nfunction ToggleButton({\n on,\n onToggle,\n label,\n onIcon: OnIcon,\n offIcon: OffIcon,\n}: {\n on: boolean;\n onToggle: () => void;\n label: string;\n onIcon: LucideIcon;\n offIcon: LucideIcon;\n}) {\n return (\n // aria-label names the button; the tooltip shows the same label on hover\n // and focus. Tooltip's asLabel would hydrate differently from the server.\n \n \n \n {on ? : }\n \n \n \n );\n}\n"},{"path":"components/motion/action-swap-cascade.tsx","type":"registry:component","target":"@components/motion/action-swap-cascade.tsx","content":"\"use client\";\n\nimport {\n ActionSwapButton,\n ActionSwapIcon,\n ActionSwapText,\n type ActionSwapButtonProps,\n type ActionSwapIconProps,\n type ActionSwapTextProps,\n} from \"./action-swap\";\n\nexport type {\n ActionSwapButtonSize,\n ActionSwapButtonVariant,\n ActionSwapItem,\n} from \"./action-swap\";\n\nexport type ActionSwapCascadeButtonProps = Omit;\nexport type ActionSwapCascadeTextProps = Omit;\nexport type ActionSwapCascadeIconProps = Omit;\n\nexport function ActionSwapCascadeButton(props: ActionSwapCascadeButtonProps) {\n return ;\n}\n\nexport function ActionSwapCascadeText(props: ActionSwapCascadeTextProps) {\n return ;\n}\n\nexport function ActionSwapCascadeIcon(props: ActionSwapCascadeIconProps) {\n return ;\n}\n"},{"path":"components/motion/button/index.tsx","type":"registry:component","target":"@components/motion/button/index.tsx","content":"export type {\n ButtonLinkProps,\n ButtonProps,\n ButtonSize,\n ButtonVariant,\n} from \"./base\";\nexport { Button, ButtonLink } from \"./base\";\nexport type { MagneticButtonProps } from \"./magnetic\";\nexport { MagneticButton } from \"./magnetic\";\nexport type { MetallicButtonProps } from \"./metallic\";\nexport { MetallicButton } from \"./metallic\";\nexport type { ButtonState, StatefulButtonProps } from \"./stateful\";\nexport { StatefulButton } from \"./stateful\";\n"},{"path":"components/motion/tooltip.tsx","type":"registry:component","target":"@components/motion/tooltip.tsx","content":"\"use client\";\n\nimport { AnimatePresence } from \"motion/react\";\nimport {\n type ComponentProps,\n type PointerEvent as ReactPointerEvent,\n cloneElement,\n createContext,\n isValidElement,\n type ReactElement,\n type ReactNode,\n type Ref,\n type RefObject,\n useCallback,\n useContext,\n useEffect,\n useId,\n useLayoutEffect,\n useMemo,\n useRef,\n useState,\n} from \"react\";\nimport { createPortal } from \"react-dom\";\nimport { TooltipSurface } from \"@/components/motion/tooltip-surface\";\nimport { useDismiss } from \"@/lib/hooks/use-dismiss\";\nimport { useHoverGesture } from \"@/lib/hooks/use-hover-gesture\";\nimport { useTapGesture } from \"@/lib/hooks/use-tap-gesture\";\nimport { cn } from \"@/lib/utils\";\nimport { focusFromKeyboard, graceArea, inBox, inPolygon, watchModality } from \"./tooltip/grace\";\nimport { TooltipArrow, TooltipPositioner } from \"./tooltip/positioner\";\nimport {\n type TooltipAlign,\n type TooltipAnchor,\n type TooltipPoint,\n type TooltipSide,\n useTooltipPointer,\n} from \"./tooltip/use-position\";\n\nexport type { TooltipAlign, TooltipSide };\n\n/* -------------------------------------------------------------------------- */\n/* Provider */\n/* -------------------------------------------------------------------------- */\n\ninterface TooltipTiming {\n /** Delay before a hover opens a tooltip (ms). */\n delay: number;\n /** Delay before a tooltip closes once the pointer has left it (ms). */\n closeDelay: number;\n /** After one tooltip closes, others open instantly for this long (ms). */\n skipDelay: number;\n}\n\nconst TimingContext = createContext({ delay: 120, closeDelay: 0, skipDelay: 300 });\n\nexport interface TooltipProviderProps extends Partial {\n children: ReactNode;\n}\n\n/** Shared timing for every tooltip inside it. Optional: tooltips work without one. */\nexport function TooltipProvider({ children, ...timing }: TooltipProviderProps) {\n const parent = useContext(TimingContext);\n const { delay = parent.delay, closeDelay = parent.closeDelay, skipDelay = parent.skipDelay } =\n timing;\n const value = useMemo(() => ({ delay, closeDelay, skipDelay }), [delay, closeDelay, skipDelay]);\n return {children};\n}\n\n/* -------------------------------------------------------------------------- */\n/* Root */\n/* -------------------------------------------------------------------------- */\n\n// Moving along a toolbar should feel instant after the first label, and only\n// one label may show at a time: a keyboard-focused control and a hovered one\n// would otherwise both claim the screen.\nlet lastClosedAt = 0;\nlet current: { close: () => void } | null = null;\n\nfunction isEmpty(content: ReactNode) {\n return content == null || content === false || content === \"\";\n}\n\ninterface TooltipContextValue {\n open: boolean;\n contentId: string;\n labelId: string;\n asLabel: boolean;\n empty: boolean;\n followCursor: boolean;\n anchor: TooltipAnchor | null;\n /** True when a TooltipTrigger owns the anchor; false for an external `anchorRef`. */\n triggered: boolean;\n floatingRef: RefObject;\n pointer: ReturnType;\n setTrigger: (element: TooltipAnchor | null) => void;\n setEmpty: (empty: boolean) => void;\n close: () => void;\n onContentEnter: () => void;\n onContentLeave: (event: ReactPointerEvent) => void;\n}\n\nconst TooltipContext = createContext(null);\n\nfunction useTooltipContext(part: string) {\n const context = useContext(TooltipContext);\n if (!context) throw new Error(`${part} must be used inside `);\n return context;\n}\n\nexport interface TooltipRootProps {\n children?: ReactNode;\n open?: boolean;\n defaultOpen?: boolean;\n onOpenChange?: (open: boolean) => void;\n /** Delay before showing on hover (ms). Keyboard focus shows immediately. */\n delay?: number;\n /** Delay before hiding once the pointer has left (ms). */\n closeDelay?: number;\n /** Never show, e.g. while the label it carries is already visible. */\n disabled?: boolean;\n /**\n * Use the tooltip as the trigger's accessible name rather than its\n * description. For icon-only controls whose only label is the tooltip.\n */\n asLabel?: boolean;\n /** Follow real pointer coordinates; keyboard focus still uses the anchor. */\n followCursor?: boolean;\n /** Existing anchor for controlled integrations such as chart cells. */\n anchorRef?: RefObject;\n /** Id of the tooltip surface, for anchors that reference it themselves. */\n id?: string;\n}\n\nfunction TooltipRoot({\n children,\n open: controlledOpen,\n defaultOpen = false,\n onOpenChange,\n delay: delayProp,\n closeDelay: closeDelayProp,\n disabled = false,\n asLabel = false,\n followCursor = false,\n anchorRef,\n id,\n initialEmpty = false,\n}: TooltipRootProps & { initialEmpty?: boolean }) {\n const timing = useContext(TimingContext);\n const delay = delayProp ?? timing.delay;\n const closeDelay = closeDelayProp ?? timing.closeDelay;\n const [uncontrolledOpen, setUncontrolledOpen] = useState(defaultOpen);\n const open = controlledOpen ?? uncontrolledOpen;\n const [empty, setEmpty] = useState(initialEmpty);\n const [trigger, setTrigger] = useState(null);\n const [external, setExternal] = useState(null);\n const anchor = anchorRef ? external : trigger;\n const generatedId = useId();\n const contentId = id ?? `${generatedId}-content`;\n const labelId = `${generatedId}-label`;\n const floatingRef = useRef(null);\n const anchorObject = useRef(null);\n const pointer = useTooltipPointer(anchor, followCursor);\n\n // An external ref can attach after this component renders; read it once it has.\n useLayoutEffect(() => {\n if (!anchorRef) return;\n const element = anchorRef.current ?? null;\n if (element !== external) setExternal(element);\n });\n\n // Everything the event listeners read, current without re-binding them.\n const latest = useRef({ open, delay, closeDelay, disabled, empty, onOpenChange, controlled: false });\n useLayoutEffect(() => {\n anchorObject.current = anchor;\n latest.current = {\n open,\n delay,\n closeDelay,\n disabled,\n empty,\n onOpenChange,\n controlled: controlledOpen !== undefined,\n };\n });\n\n const openTimer = useRef | null>(null);\n const closeTimer = useRef | null>(null);\n const grace = useRef<(() => void) | null>(null);\n const self = useRef<{ close: () => void }>({ close: () => {} });\n\n const clearTimers = useCallback(() => {\n if (openTimer.current) clearTimeout(openTimer.current);\n if (closeTimer.current) clearTimeout(closeTimer.current);\n openTimer.current = null;\n closeTimer.current = null;\n }, []);\n\n const stopGrace = useCallback(() => {\n grace.current?.();\n grace.current = null;\n }, []);\n\n // Only a real change reaches the consumer: a pointer leaving a closed\n // tooltip is not news.\n const commit = useCallback((next: boolean) => {\n if (latest.current.open === next) return;\n if (!latest.current.controlled) setUncontrolledOpen(next);\n latest.current.onOpenChange?.(next);\n }, []);\n\n const openNow = useCallback(() => {\n clearTimers();\n stopGrace();\n if (latest.current.disabled || latest.current.empty) return;\n if (current && current !== self.current) current.close();\n current = self.current;\n commit(true);\n }, [clearTimers, stopGrace, commit]);\n\n const close = useCallback(() => {\n clearTimers();\n stopGrace();\n if (latest.current.open) lastClosedAt = Date.now();\n if (current === self.current) current = null;\n commit(false);\n }, [clearTimers, stopGrace, commit]);\n useLayoutEffect(() => {\n self.current.close = close;\n }, [close]);\n\n const requestOpen = useCallback(() => {\n clearTimers();\n if (latest.current.open || latest.current.disabled || latest.current.empty) return;\n const warm = Date.now() - lastClosedAt < timing.skipDelay;\n if (warm || latest.current.delay <= 0) openNow();\n else openTimer.current = setTimeout(openNow, latest.current.delay);\n }, [clearTimers, openNow, timing.skipDelay]);\n\n const requestClose = useCallback(() => {\n clearTimers();\n if (latest.current.closeDelay > 0) {\n closeTimer.current = setTimeout(close, latest.current.closeDelay);\n } else close();\n }, [clearTimers, close]);\n\n // Hold the label open while the pointer crosses from one box toward the other.\n const startGrace = useCallback(\n (exit: TooltipPoint, from: Element, to: Element | null) => {\n stopGrace();\n if (!to) return requestClose();\n const target = to.getBoundingClientRect();\n const origin = from.getBoundingClientRect();\n const corridor = graceArea(exit, target);\n const onMove = (event: PointerEvent) => {\n const point = { x: event.clientX, y: event.clientY };\n if (inBox(point, target) || inBox(point, origin)) return;\n if (!inPolygon(point, corridor)) requestClose();\n };\n document.addEventListener(\"pointermove\", onMove);\n grace.current = () => document.removeEventListener(\"pointermove\", onMove);\n },\n [stopGrace, requestClose],\n );\n\n const hover = useHoverGesture();\n const tap = useTapGesture();\n\n // Listeners go on the trigger itself rather than on cloned props, so a\n // component that owns its own handlers keeps them, and no wrapper element\n // sits between the control and its layout.\n useEffect(() => {\n if (anchorRef || !trigger) return;\n watchModality();\n // A mouse press dismisses the label and keeps it away until the pointer\n // leaves; hovering a control you just clicked should not bring it back.\n let suppressed = false;\n // Focus that came from the keyboard holds the label open on its own.\n let keyboardFocus = false;\n\n const onEnter = (event: PointerEvent) => {\n if (!hover.enter(event)) return;\n stopGrace();\n if (closeTimer.current) clearTimeout(closeTimer.current);\n if (!suppressed) requestOpen();\n };\n const onLeave = (event: PointerEvent) => {\n if (!hover.leave(event)) return;\n suppressed = false;\n if (keyboardFocus) return;\n if (openTimer.current) {\n clearTimers();\n return;\n }\n if (latest.current.open && !followCursor) {\n startGrace({ x: event.clientX, y: event.clientY }, trigger, floatingRef.current);\n } else requestClose();\n };\n const onDown = (event: PointerEvent) => {\n tap.start(event, latest.current.open);\n if (event.pointerType === \"mouse\") {\n suppressed = true;\n close();\n }\n };\n // A finger never hovers, and Safari does not focus a button on tap either,\n // so the label is only reachable if the tap itself toggles it. The click\n // carries no pointerType; the pointerdown before it says whether it was a\n // tap, and keyboard activation has none at all.\n const onClick = () => {\n const gesture = tap.take();\n if (!gesture || gesture.pointerType === \"mouse\") return;\n if (gesture.state) close();\n else openNow();\n };\n const onKey = () => tap.drop();\n const onFocusIn = () => {\n if (!focusFromKeyboard()) return;\n keyboardFocus = true;\n openNow();\n };\n const onFocusOut = (event: FocusEvent) => {\n if (trigger.contains(event.relatedTarget as Node | null)) return;\n keyboardFocus = false;\n close();\n };\n\n // Both element kinds dispatch the same events; one type keeps the listeners typed.\n const el = trigger as HTMLElement;\n el.addEventListener(\"pointerenter\", onEnter);\n el.addEventListener(\"pointerleave\", onLeave);\n el.addEventListener(\"pointerdown\", onDown);\n el.addEventListener(\"pointercancel\", tap.drop);\n el.addEventListener(\"click\", onClick);\n el.addEventListener(\"keydown\", onKey);\n el.addEventListener(\"focusin\", onFocusIn);\n el.addEventListener(\"focusout\", onFocusOut);\n return () => {\n el.removeEventListener(\"pointerenter\", onEnter);\n el.removeEventListener(\"pointerleave\", onLeave);\n el.removeEventListener(\"pointerdown\", onDown);\n el.removeEventListener(\"pointercancel\", tap.drop);\n el.removeEventListener(\"click\", onClick);\n el.removeEventListener(\"keydown\", onKey);\n el.removeEventListener(\"focusin\", onFocusIn);\n el.removeEventListener(\"focusout\", onFocusOut);\n };\n }, [\n anchorRef,\n trigger,\n followCursor,\n hover,\n tap,\n requestOpen,\n requestClose,\n openNow,\n close,\n clearTimers,\n stopGrace,\n startGrace,\n ]);\n\n // While open, a trigger that turns disabled loses focus without a blur event,\n // and a window that loses focus never reports the pointer leaving.\n useEffect(() => {\n if (!open || anchorRef || !trigger) return;\n const observer = new MutationObserver(() => {\n if (trigger.matches(\":disabled, [aria-disabled='true']\")) close();\n });\n observer.observe(trigger, { attributes: true, attributeFilter: [\"disabled\", \"aria-disabled\"] });\n window.addEventListener(\"blur\", close);\n return () => {\n observer.disconnect();\n window.removeEventListener(\"blur\", close);\n };\n }, [open, anchorRef, trigger, close]);\n\n // A chart drives its own open state and swaps content as it goes; only a\n // trigger-owned label closes itself for having nothing to say.\n useEffect(() => {\n if (disabled || (empty && !anchorRef)) close();\n }, [disabled, empty, anchorRef, close]);\n\n useEffect(\n () => () => {\n clearTimers();\n stopGrace();\n if (current === self.current) current = null;\n },\n [clearTimers, stopGrace],\n );\n\n const insideTooltip = useCallback(\n (target: Element) => Boolean(floatingRef.current?.contains(target)),\n [],\n );\n // ...and closed by the next tap that lands somewhere else, or Escape. The\n // label covers nothing interactive, so that tap passes through to what it hit.\n useDismiss(open, close, anchorObject, { ignore: insideTooltip });\n\n const onContentEnter = useCallback(() => {\n stopGrace();\n clearTimers();\n }, [stopGrace, clearTimers]);\n\n const onContentLeave = useCallback(\n (event: ReactPointerEvent) => {\n const floating = floatingRef.current;\n if (!floating) return;\n if (anchorRef) {\n // Bridge the small gap back onto a chart; it reopens on its own terms.\n clearTimers();\n closeTimer.current = setTimeout(close, 100);\n return;\n }\n startGrace({ x: event.clientX, y: event.clientY }, floating, anchorObject.current);\n },\n [anchorRef, clearTimers, close, startGrace],\n );\n\n const value = useMemo(\n () => ({\n open,\n contentId,\n labelId,\n asLabel,\n empty,\n followCursor,\n anchor,\n triggered: !anchorRef,\n floatingRef,\n pointer,\n setTrigger,\n setEmpty,\n close,\n onContentEnter,\n onContentLeave,\n }),\n [\n open,\n contentId,\n labelId,\n asLabel,\n empty,\n followCursor,\n anchor,\n anchorRef,\n pointer,\n close,\n onContentEnter,\n onContentLeave,\n ],\n );\n\n return {children};\n}\n\n/* -------------------------------------------------------------------------- */\n/* Trigger */\n/* -------------------------------------------------------------------------- */\n\nfunction mergeIds(...ids: unknown[]) {\n return ids.filter((value) => typeof value === \"string\" && value).join(\" \") || undefined;\n}\n\nfunction assignRef(ref: Ref | undefined, value: T | null) {\n if (typeof ref === \"function\") ref(value);\n else if (ref) (ref as { current: T | null }).current = value;\n}\n\nexport interface TooltipTriggerProps extends ComponentProps<\"button\"> {\n /** Use the single child element as the trigger instead of rendering a button. */\n asChild?: boolean;\n}\n\nexport function TooltipTrigger({ asChild = false, children, ref, ...props }: TooltipTriggerProps) {\n const { open, contentId, labelId, asLabel, empty, setTrigger } =\n useTooltipContext(\"TooltipTrigger\");\n const child = asChild && isValidElement(children) ? children : null;\n const childProps = (child?.props ?? props) as Record;\n const childRef = child ? (childProps.ref as Ref | undefined) : undefined;\n const attached = useRef(null);\n\n const setRef = useCallback(\n (element: TooltipAnchor | null) => {\n attached.current = element;\n setTrigger(element);\n assignRef(childRef ?? (ref as Ref | undefined), element);\n },\n [setTrigger, childRef, ref],\n );\n\n useEffect(() => {\n if (process.env.NODE_ENV !== \"production\" && child && !attached.current) {\n console.warn(\n \"TooltipTrigger: the child did not attach a ref, so the tooltip has nothing to listen to. Render a DOM element or a component that passes `ref` through.\",\n );\n }\n }, [child]);\n\n const aria = asLabel\n ? {\n \"aria-labelledby\": empty\n ? (childProps[\"aria-labelledby\"] as string | undefined)\n : labelId,\n }\n : {\n \"aria-describedby\": mergeIds(\n childProps[\"aria-describedby\"],\n open && !empty ? contentId : undefined,\n ),\n };\n\n if (asChild) {\n if (!child) return children;\n return cloneElement(child as ReactElement>, { ref: setRef, ...aria });\n }\n\n return (\n }\n {...aria}\n >\n {children}\n \n );\n}\n\n/* -------------------------------------------------------------------------- */\n/* Content */\n/* -------------------------------------------------------------------------- */\n\nexport interface TooltipContentProps {\n children?: ReactNode;\n side?: TooltipSide;\n align?: TooltipAlign;\n /** Gap between anchor and tooltip (px). */\n sideOffset?: number;\n /** Draw an arrow pointing at the anchor. */\n arrow?: boolean;\n /** Point within the anchor, as fractions of its rendered width and height. */\n anchorPoint?: TooltipPoint;\n className?: string;\n}\n\nexport function TooltipContent({\n children,\n side = \"top\",\n align = \"center\",\n sideOffset,\n arrow = false,\n anchorPoint,\n className,\n}: TooltipContentProps) {\n const {\n open,\n contentId,\n labelId,\n asLabel,\n followCursor,\n anchor,\n floatingRef,\n pointer,\n setEmpty,\n close,\n onContentEnter,\n onContentLeave,\n } = useTooltipContext(\"TooltipContent\");\n const empty = isEmpty(children);\n const arrowRef = useRef(null);\n\n useLayoutEffect(() => {\n setEmpty(empty);\n }, [empty, setEmpty]);\n\n if (typeof document === \"undefined\") return null;\n\n return createPortal(\n <>\n {/* The name has to exist while the label is closed, so it lives apart from the surface. */}\n {asLabel && !empty ? (\n \n ) : null}\n \n {open && !empty ? (\n \n {(positioned, isPresent, placedSide) => (\n \n {children}\n {arrow ? : null}\n \n )}\n \n ) : null}\n \n ,\n document.body,\n );\n}\n\n/* -------------------------------------------------------------------------- */\n/* Tooltip (root, or one-line shorthand when given `content`) */\n/* -------------------------------------------------------------------------- */\n\nexport interface TooltipProps\n extends TooltipRootProps,\n Omit {\n /**\n * Shorthand: the tooltip's content. With it, `children` is the trigger\n * element; without it, compose `TooltipTrigger` and `TooltipContent`.\n */\n content?: ReactNode;\n /** Shorthand only: classes for the tooltip surface. */\n className?: string;\n}\n\nexport function Tooltip(props: TooltipProps) {\n if (!(\"content\" in props)) return ;\n const {\n content,\n children,\n side,\n align,\n sideOffset,\n arrow,\n anchorPoint,\n className,\n ...root\n } = props;\n if (!root.anchorRef && !isValidElement(children)) return children ?? null;\n return (\n \n {isValidElement(children) ? {children} : null}\n \n {content}\n \n \n );\n}\n"},{"path":"lib/ease.ts","type":"registry:lib","target":"@lib/ease.ts","content":"// Shared motion tokens. Easing curves mirror the CSS custom properties in\n// globals.css; springs are the canonical physics used across components.\n// Strong custom variants — defaults like `ease-in`/`ease-out` feel weak.\n\nexport const EASE_OUT = [0.16, 1, 0.3, 1] as const;\nexport const EASE_IN_OUT = [0.77, 0, 0.175, 1] as const;\nexport const EASE_DRAWER = [0.32, 0.72, 0, 1] as const;\n\n/** CSS string form of EASE_OUT for inline style transitions. */\nexport const EASE_OUT_CSS = \"cubic-bezier(0.16, 1, 0.3, 1)\";\n\n/** Press feedback on buttons and other tappable surfaces. */\nexport const SPRING_PRESS = {\n type: \"spring\",\n stiffness: 500,\n damping: 30,\n mass: 0.6,\n} as const;\n\n/** Content swaps — label/icon slots trading places inside a control. */\nexport const SPRING_SWAP = {\n type: \"spring\",\n stiffness: 460,\n damping: 30,\n mass: 0.55,\n} as const;\n\n/** Overlay panel entrances — modals and sheets summoned by pointer. */\nexport const SPRING_PANEL = {\n type: \"spring\",\n stiffness: 420,\n damping: 40,\n mass: 0.5,\n} as const;\n\n/** Shared-layout glides — pills, indicators and panels morphing between positions. */\nexport const SPRING_LAYOUT = {\n type: \"spring\",\n stiffness: 360,\n damping: 32,\n mass: 0.6,\n} as const;\n\n/** Cursor-follow physics for decorative mouse tracking (magnetic, tilt, dock). */\nexport const SPRING_MOUSE = {\n stiffness: 200,\n damping: 15,\n mass: 0.3,\n} as const;\n\n/** Dragged handles and fills (sliders) — critically damped `useSpring` config,\n * so the value follows the pointer butterily and never rebounds off an end. */\nexport const SPRING_GLIDE = {\n stiffness: 700,\n damping: 50,\n mass: 0.5,\n} as const;\n"},{"path":"lib/tick-sound.ts","type":"registry:lib","target":"@lib/tick-sound.ts","content":"// Synthesizes a short, dry mechanical detent for gesture feedback (e.g. the\n// WheelPicker row-cross click) entirely at runtime. Several inharmonic modes\n// make it read as a tiny physical impact instead of an oscillator beep, while\n// the high-passed transient gives it definition through phone speakers.\n\nimport { getAudioContext, retainAudioContext } from \"@/lib/audio-context\";\n\nconst DURATION = 0.016; // seconds, short enough to stay distinct during a fling\nconst MASTER_GAIN = 0.055;\n\nconst MODES = [\n { frequency: 980, decay: 0.0038, gain: 0.5, phase: 0 },\n { frequency: 1820, decay: 0.0024, gain: 0.3, phase: 0.65 },\n { frequency: 3160, decay: 0.00115, gain: 0.12, phase: 1.3 },\n] as const;\n\n// The context is shared page-wide (lib/audio-context.ts). The gain and the\n// click buffer belong to it, so they are rebuilt if it was closed and\n// recreated.\nlet output: { gain: GainNode; buffer: AudioBuffer } | null = null;\n\nfunction buildClickBuffer(context: AudioContext): AudioBuffer {\n const sampleRate = context.sampleRate;\n const length = Math.ceil(DURATION * sampleRate);\n const buffer = context.createBuffer(1, length, sampleRate);\n const data = buffer.getChannelData(0);\n\n let peak = 0;\n let previousNoise = 0;\n for (let i = 0; i < length; i++) {\n const t = i / sampleRate;\n const attack = Math.min(1, t / 0.00012);\n const fadeOut = Math.min(1, (DURATION - t) / 0.001);\n let resonance = 0;\n for (const mode of MODES) {\n resonance +=\n Math.sin(2 * Math.PI * mode.frequency * t + mode.phase) *\n Math.exp(-t / mode.decay) *\n mode.gain;\n }\n\n // Differencing consecutive noise samples removes the low, papery part of\n // white noise and leaves only a tiny impact at the front of the sound.\n const noise = Math.random() * 2 - 1;\n const transient =\n (noise - previousNoise) * Math.exp(-t / 0.00038) * 0.035;\n previousNoise = noise;\n\n data[i] = (resonance + transient) * attack * fadeOut;\n peak = Math.max(peak, Math.abs(data[i]));\n }\n if (peak > 0) {\n const norm = 0.9 / peak;\n for (let i = 0; i < length; i++) data[i] *= norm;\n }\n\n return buffer;\n}\n\nfunction prepareOutput() {\n const ctx = getAudioContext();\n if (!ctx) return null;\n if (output?.gain.context !== ctx) {\n const gain = ctx.createGain();\n gain.gain.value = MASTER_GAIN;\n gain.connect(ctx.destination);\n output = { gain, buffer: buildClickBuffer(ctx) };\n }\n return { ctx, ...output };\n}\n\ninterface TickPlayer {\n prepare: () => void;\n /** `rate` below 1 plays a lower, longer tick; above 1 a higher, shorter one. */\n play: (rate?: number) => void;\n dispose: () => void;\n}\n\n/**\n * Lazily-initialized tick player. No `AudioContext` is created until the first\n * `prepare()` or `play()` call anywhere on the page. Every player shares the\n * same context and buffer; the context closes once the last player anywhere\n * on the page is disposed. Safe during SSR or in browsers without Web Audio:\n * `prepare()` and `play()` become silent no-ops.\n */\nexport function createTickPlayer(): TickPlayer {\n const release = retainAudioContext();\n let disposed = false;\n let activeSource: AudioBufferSourceNode | null = null;\n\n return {\n prepare() {\n if (disposed) return;\n prepareOutput();\n },\n play(rate = 1) {\n if (disposed) return;\n const ready = prepareOutput();\n if (!ready) return;\n const { ctx, gain, buffer } = ready;\n // A fast fling can cross rows more quickly than the tail of a tick.\n // Cutting that tail keeps the feedback dry instead of stacking into a\n // louder metallic ring.\n activeSource?.stop();\n const source = ctx.createBufferSource();\n source.buffer = buffer;\n source.playbackRate.value = rate;\n source.connect(gain);\n source.onended = () => {\n source.disconnect();\n if (activeSource === source) activeSource = null;\n };\n activeSource = source;\n source.start();\n },\n dispose() {\n if (disposed) return;\n disposed = true;\n activeSource?.stop();\n activeSource = null;\n release();\n },\n };\n}\n"},{"path":"lib/utils.ts","type":"registry:lib","target":"@lib/utils.ts","content":"import { clsx, type ClassValue } from \"clsx\"\nimport { twMerge } from \"tailwind-merge\"\n\nexport function cn(...inputs: ClassValue[]) {\n return twMerge(clsx(inputs))\n}\n"},{"path":"components/motion/action-swap.tsx","type":"registry:component","target":"@components/motion/action-swap.tsx","content":"\"use client\";\n\nimport { AnimatePresence, type HTMLMotionProps, motion, useReducedMotion, type Variants } from \"motion/react\";\nimport type { ReactNode } from \"react\";\nimport { useState } from \"react\";\nimport { EASE_OUT, SPRING_LAYOUT, SPRING_PRESS, SPRING_SWAP } from \"@/lib/ease\";\nimport { cn } from \"@/lib/utils\";\n\nexport type ActionSwapItem = {\n id: string;\n label: ReactNode;\n icon?: ReactNode;\n ariaLabel?: string;\n};\n\nexport type ActionSwapButtonVariant = \"primary\" | \"secondary\" | \"outline\" | \"ghost\";\nexport type ActionSwapButtonSize = \"sm\" | \"md\" | \"lg\" | \"icon\";\nexport type ActionSwapAnimation = \"blur\" | \"roll\" | \"cascade\";\n\n/** Animations with a single-element variant set (cascade animates per letter). */\ntype CoreAnimation = \"blur\" | \"roll\";\n\nexport interface ActionSwapButtonProps extends Omit<\n HTMLMotionProps<\"button\">,\n \"children\" | \"onChange\"\n> {\n items: ActionSwapItem[];\n value?: string;\n defaultValue?: string;\n onValueChange?: (value: string, item: ActionSwapItem) => void;\n variant?: ActionSwapButtonVariant;\n size?: ActionSwapButtonSize;\n animation?: ActionSwapAnimation;\n iconOnly?: boolean;\n cycle?: boolean;\n}\n\nexport interface ActionSwapTextProps {\n value: string;\n children: ReactNode;\n animation?: ActionSwapAnimation;\n className?: string;\n}\n\nexport interface ActionSwapIconProps {\n value: string;\n children: ReactNode;\n animation?: ActionSwapAnimation;\n className?: string;\n}\n\n// The arriving layer springs in, so a second press mid-swap bends it toward\n// the new target instead of restarting. The leaving layer is a little quicker,\n// still long enough to cross the arrival so the swap reads as one morph.\nconst BLUR_TRANSITION = SPRING_SWAP;\nconst BLUR_EXIT_TRANSITION = { duration: 0.16, ease: EASE_OUT } as const;\nconst ROLL_TRANSITION = SPRING_SWAP;\nconst ROLL_EXIT_TRANSITION = { duration: 0.14, ease: EASE_OUT } as const;\n// A light blur softens the crossing without smearing small glyphs.\nconst SWAP_BLUR = \"blur(2px)\";\nconst ROLL_BLUR = \"blur(3px)\";\n\n// Cascade rolls the label one letter at a time, left to right. The leaving\n// and landing strings overlap as independent layers (no shared cells), so\n// proportional glyph widths never jitter. Exits cascade at half the enter\n// stagger so the tail of the old label lingers briefly.\nconst CASCADE_STAGGER = 0.025;\n\nconst CASCADE_LETTER_VARIANTS: Variants = {\n initial: { opacity: 0, y: \"105%\", filter: ROLL_BLUR },\n animate: (delay: number = 0) => ({\n opacity: 1,\n y: \"0%\",\n filter: \"blur(0px)\",\n transition: { ...SPRING_SWAP, delay },\n }),\n exit: (delay: number = 0) => ({\n opacity: 0,\n y: \"-105%\",\n filter: ROLL_BLUR,\n transition: { duration: 0.16, ease: EASE_OUT, delay: delay * 0.5 },\n }),\n};\n\nconst TEXT_VARIANTS: Record = {\n blur: {\n initial: { opacity: 0, scale: 0.9, filter: SWAP_BLUR },\n animate: {\n opacity: 1,\n scale: 1,\n filter: \"blur(0px)\",\n transition: BLUR_TRANSITION,\n },\n exit: {\n opacity: 0,\n scale: 0.96,\n filter: SWAP_BLUR,\n transition: BLUR_EXIT_TRANSITION,\n },\n },\n roll: {\n initial: { opacity: 0, y: \"90%\", filter: ROLL_BLUR },\n animate: {\n opacity: 1,\n y: \"0%\",\n filter: \"blur(0px)\",\n transition: ROLL_TRANSITION,\n },\n exit: {\n opacity: 0,\n y: \"-90%\",\n filter: ROLL_BLUR,\n transition: ROLL_EXIT_TRANSITION,\n },\n },\n};\n\nconst ICON_VARIANTS: Record = {\n blur: {\n initial: { opacity: 0, scale: 0.25, filter: SWAP_BLUR },\n animate: {\n opacity: 1,\n scale: 1,\n filter: \"blur(0px)\",\n transition: BLUR_TRANSITION,\n },\n exit: {\n opacity: 0,\n scale: 0.25,\n filter: SWAP_BLUR,\n transition: BLUR_EXIT_TRANSITION,\n },\n },\n roll: {\n initial: { opacity: 0, y: 12, filter: ROLL_BLUR },\n animate: {\n opacity: 1,\n y: 0,\n filter: \"blur(0px)\",\n transition: ROLL_TRANSITION,\n },\n exit: {\n opacity: 0,\n y: -12,\n filter: ROLL_BLUR,\n transition: ROLL_EXIT_TRANSITION,\n },\n },\n};\n\nconst VARIANT_CLASS: Record = {\n primary: \"bg-primary text-primary-foreground hover:bg-primary/90\",\n secondary: \"border border-border bg-card text-foreground hover:border-border\",\n outline: \"border border-border bg-transparent text-foreground hover:bg-muted/60\",\n ghost: \"text-muted-foreground hover:bg-muted/60 hover:text-foreground\",\n};\n\nconst SIZE_CLASS: Record = {\n sm: \"h-8 gap-1.5 rounded-full px-3 text-xs\",\n md: \"h-10 gap-2 rounded-full px-4 text-sm\",\n lg: \"h-12 gap-2.5 rounded-full px-5 text-base\",\n icon: \"h-10 w-10 rounded-full\",\n};\n\nexport function ActionSwapText({\n value,\n children,\n animation = \"blur\",\n className,\n}: ActionSwapTextProps) {\n const reduce = useReducedMotion();\n\n // Cascade needs a plain string to split into letters; non-string content\n // and reduced motion fall back to the closest single-element animation.\n const label = typeof children === \"string\" ? children : null;\n const cascade = animation === \"cascade\" && label !== null && !reduce;\n const coreAnimation: CoreAnimation =\n animation === \"cascade\" ? \"roll\" : animation;\n\n return (\n \n \n {cascade\n ? label.split(\"\").map((char, index) => (\n \n {char}\n \n ))\n : children}\n \n {cascade ? (\n <>\n {/* Letters are decorative fragments; readers get the whole label. */}\n {label}\n \n \n {label.split(\"\").map((char, i) => (\n \n {char}\n \n ))}\n \n \n \n ) : (\n \n \n {children}\n \n \n )}\n \n );\n}\n\nexport function ActionSwapIcon({\n value,\n children,\n animation = \"blur\",\n className,\n}: ActionSwapIconProps) {\n const reduce = useReducedMotion();\n // Icons are single elements — cascade maps to its closest motion, roll.\n const coreAnimation: CoreAnimation =\n animation === \"cascade\" ? \"roll\" : animation;\n\n return (\n \n \n \n {children}\n \n \n \n );\n}\n\nexport function ActionSwapButton({\n items,\n value,\n defaultValue,\n onValueChange,\n variant = \"secondary\",\n size = \"md\",\n animation = \"blur\",\n iconOnly = size === \"icon\",\n cycle = true,\n className,\n disabled,\n onClick,\n style,\n ...rest\n}: ActionSwapButtonProps) {\n const reduce = useReducedMotion();\n const [internalValue, setInternalValue] = useState(defaultValue ?? items[0]?.id);\n const currentValue = value ?? internalValue;\n const activeIndex = Math.max(0, items.findIndex((item) => item.id === currentValue));\n const activeItem = items[activeIndex] ?? items[0];\n const hasIcon = items.some((item) => item.icon);\n const nextItem = cycle && items.length > 0 ? items[(activeIndex + 1) % items.length] : undefined;\n\n if (!activeItem) return null;\n\n const accessibleLabel = activeItem.ariaLabel ?? (iconOnly && typeof activeItem.label === \"string\" ? activeItem.label : undefined);\n const layoutTransition = reduce ? { duration: 0 } : SPRING_LAYOUT;\n\n return (\n {\n onClick?.(event);\n if (event.defaultPrevented || disabled || !cycle || !nextItem) return;\n if (value === undefined) setInternalValue(nextItem.id);\n onValueChange?.(nextItem.id, nextItem);\n }}\n {...rest}\n >\n {/* Position-only layout keeps the contents from stretching with the\n button while its width glides. */}\n {hasIcon ? (\n \n \n {activeItem.icon ?? null}\n \n \n ) : null}\n {!iconOnly ? (\n \n \n {activeItem.label}\n \n \n ) : null}\n \n );\n}\n"},{"path":"components/motion/button/base.tsx","type":"registry:component","target":"@components/motion/button/base.tsx","content":"\"use client\";\n\nimport {\n AnimatePresence,\n type HTMLMotionProps,\n motion,\n useReducedMotion,\n} from \"motion/react\";\nimport {\n forwardRef,\n type PointerEvent,\n type ReactNode,\n useCallback,\n useRef,\n useState,\n} from \"react\";\nimport { EASE_OUT, SPRING_PRESS } from \"@/lib/ease\";\nimport { useHoverCapable } from \"@/lib/hooks/use-hover-capable\";\nimport { cn } from \"@/lib/utils\";\n\nexport type ButtonVariant = \"primary\" | \"secondary\" | \"ghost\" | \"outline\";\nexport type ButtonSize = \"sm\" | \"md\" | \"lg\" | \"icon\";\n\nexport interface ButtonProps extends Omit<\n HTMLMotionProps<\"button\">,\n \"children\"\n> {\n variant?: ButtonVariant;\n size?: ButtonSize;\n pressScale?: number;\n /** Spawn a Material-style ripple from the press point. Off by default. */\n ripple?: boolean;\n children?: ReactNode;\n}\n\nexport interface ButtonLinkProps extends Omit<\n HTMLMotionProps<\"a\">,\n \"children\"\n> {\n variant?: ButtonVariant;\n size?: ButtonSize;\n pressScale?: number;\n children?: ReactNode;\n}\n\ntype Ripple = { id: number; x: number; y: number; size: number };\n\nconst VARIANT_CLASS: Record = {\n primary: \"bg-primary text-primary-foreground hover:bg-primary/90\",\n secondary: \"border border-border bg-card text-foreground hover:border-border\",\n ghost: \"text-muted-foreground hover:text-foreground hover:bg-muted/60\",\n outline:\n \"border border-border bg-transparent text-foreground hover:bg-muted/60\",\n};\n\nconst SIZE_CLASS: Record = {\n sm: \"h-8 px-3 text-xs gap-1.5 rounded-full\",\n md: \"h-10 px-5 text-sm gap-2 rounded-full\",\n lg: \"h-12 px-6 text-base gap-2 rounded-full\",\n icon: \"h-8 w-8 rounded-lg\",\n};\n\nexport const Button = forwardRef(\n function Button(\n {\n variant = \"primary\",\n size = \"md\",\n pressScale = 0.93,\n ripple = false,\n className,\n children,\n onPointerDown,\n ...rest\n },\n ref,\n ) {\n const reduce = useReducedMotion();\n const canHover = useHoverCapable();\n const [ripples, setRipples] = useState([]);\n const nextId = useRef(0);\n\n const handlePointerDown = useCallback(\n (event: PointerEvent) => {\n if (ripple && !reduce) {\n const rect = event.currentTarget.getBoundingClientRect();\n const size = Math.max(rect.width, rect.height) * 2;\n const id = nextId.current++;\n setRipples((prev) => [\n ...prev,\n {\n id,\n x: event.clientX - rect.left,\n y: event.clientY - rect.top,\n size,\n },\n ]);\n }\n onPointerDown?.(event);\n },\n [ripple, reduce, onPointerDown],\n );\n\n return (\n \n {ripple && !reduce ? (\n \n \n {ripples.map((r) => (\n \n setRipples((prev) => prev.filter((x) => x.id !== r.id))\n }\n />\n ))}\n \n \n ) : null}\n {children}\n \n );\n },\n);\n\nexport const ButtonLink = forwardRef(\n function ButtonLink(\n {\n variant = \"primary\",\n size = \"md\",\n pressScale = 0.93,\n className,\n children,\n ...rest\n },\n ref,\n ) {\n const reduce = useReducedMotion();\n const canHover = useHoverCapable();\n\n return (\n \n {children}\n \n );\n },\n);\n"},{"path":"components/motion/button/magnetic.tsx","type":"registry:component","target":"@components/motion/button/magnetic.tsx","content":"\"use client\";\n\nimport { forwardRef } from \"react\";\nimport { Magnetic } from \"../magnetic\";\nimport { Button, type ButtonProps } from \"./base\";\n\nexport interface MagneticButtonProps extends ButtonProps {\n /** Magnetic pull strength. Default 0.25. */\n strength?: number;\n /** Class applied to the magnetic wrapper. */\n magneticClassName?: string;\n}\n\nexport const MagneticButton = forwardRef(function MagneticButton(\n { strength = 0.25, magneticClassName, children, ...rest },\n ref,\n) {\n return (\n \n \n \n );\n});\n"},{"path":"components/motion/button/metallic.tsx","type":"registry:component","target":"@components/motion/button/metallic.tsx","content":"\"use client\";\n\nimport { motion, useReducedMotion } from \"motion/react\";\nimport { forwardRef, useState } from \"react\";\nimport { EASE_IN_OUT } from \"@/lib/ease\";\nimport { cn } from \"@/lib/utils\";\nimport { Button, type ButtonProps } from \"./base\";\n\nexport interface MetallicButtonProps extends Omit<\n ButtonProps,\n \"ripple\" | \"variant\"\n> {\n /** Stops the traveling reflection while preserving the chrome rim. */\n paused?: boolean;\n}\n\n// The rim and highlight drift separately so the material stays quiet and reflective.\nconst SILVER_DRIFT = {\n duration: 8,\n ease: EASE_IN_OUT,\n repeat: Infinity,\n};\n\nconst CHROME_SHIMMER = {\n duration: 2.4,\n ease: EASE_IN_OUT,\n};\n\nexport const MetallicButton = forwardRef<\n HTMLButtonElement,\n MetallicButtonProps\n>(function MetallicButton(\n {\n size = \"md\",\n paused = false,\n className,\n children,\n onHoverStart,\n onHoverEnd,\n ...rest\n },\n ref,\n) {\n const reduce = useReducedMotion();\n const still = paused || Boolean(reduce);\n const [hovered, setHovered] = useState(false);\n\n return (\n {\n setHovered(true);\n onHoverStart?.(event, info);\n }}\n onHoverEnd={(event, info) => {\n setHovered(false);\n onHoverEnd?.(event, info);\n }}\n className={cn(\n \"group relative isolate overflow-hidden border-0 bg-transparent text-foreground\",\n \"hover:bg-transparent hover:text-foreground\",\n \"focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2\",\n \"shadow-[0_8px_22px_rgba(0,0,0,0.16)]\",\n size === \"icon\" && \"rounded-full\",\n className,\n )}\n {...rest}\n >\n \n\n \n\n \n\n \n\n \n {children}\n \n \n );\n});\n"},{"path":"components/motion/button/stateful.tsx","type":"registry:component","target":"@components/motion/button/stateful.tsx","content":"\"use client\";\n\nimport { Check, Loader2, X } from \"lucide-react\";\nimport {\n AnimatePresence,\n motion,\n useReducedMotion,\n type Variants,\n} from \"motion/react\";\nimport {\n forwardRef,\n type ReactNode,\n useLayoutEffect,\n useRef,\n useState,\n} from \"react\";\nimport { EASE_OUT, SPRING_SWAP } from \"@/lib/ease\";\nimport { Button, type ButtonProps } from \"./base\";\n\nexport type ButtonState = \"idle\" | \"loading\" | \"success\" | \"error\";\n\nexport interface StatefulButtonProps extends Omit {\n state?: ButtonState;\n children: ReactNode;\n loadingText?: ReactNode;\n successText?: ReactNode;\n errorText?: ReactNode;\n icon?: ReactNode;\n}\n\nconst CASCADE_STAGGER = 0.025;\nconst ROLL_BLUR = \"blur(6px)\";\n\nconst CASCADE_LETTER_VARIANTS: Variants = {\n initial: { opacity: 0, y: \"105%\", filter: ROLL_BLUR },\n animate: (delay: number = 0) => ({\n opacity: 1,\n y: \"0%\",\n filter: \"blur(0px)\",\n transition: { ...SPRING_SWAP, delay },\n }),\n exit: (delay: number = 0) => ({\n opacity: 0,\n y: \"-105%\",\n filter: ROLL_BLUR,\n transition: { duration: 0.16, ease: EASE_OUT, delay: delay * 0.5 },\n }),\n};\n\nconst ICON_VARIANTS: Variants = {\n // Width collapses too, so the icon adds/removes its own space smoothly\n // instead of popping the row width in a single frame.\n initial: { opacity: 0, width: 0, scale: 0.7, filter: ROLL_BLUR },\n animate: {\n opacity: 1,\n width: \"1.5rem\",\n scale: 1,\n filter: \"blur(0px)\",\n transition: SPRING_SWAP,\n },\n exit: {\n opacity: 0,\n width: 0,\n scale: 0.7,\n filter: ROLL_BLUR,\n transition: { duration: 0.16, ease: EASE_OUT },\n },\n};\n\nfunction IconSlot({ keyId, children }: { keyId: string; children: ReactNode }) {\n const reduce = useReducedMotion();\n return (\n \n {children}\n \n );\n}\n\nfunction TextSlot({\n value,\n children,\n}: {\n value: string;\n children: ReactNode;\n}) {\n const reduce = useReducedMotion();\n const measureRef = useRef(null);\n const [width, setWidth] = useState();\n const label = typeof children === \"string\" ? children : null;\n const cascade = label !== null && !reduce;\n\n // Measure strings with the same per-letter layout as the cascade. Measuring\n // the whole string preserves kerning, which can make it narrower than the\n // inline-block letters and clip the final glyph during the width animation.\n useLayoutEffect(() => {\n const nextWidth = measureRef.current?.offsetWidth;\n if (!nextWidth) return;\n setWidth((current) => (current === nextWidth ? current : nextWidth));\n });\n\n return (\n \n \n {cascade\n ? label.split(\"\").map((char, index) => (\n \n {char}\n \n ))\n : children}\n \n\n {cascade ? (\n <>\n {label}\n \n \n {label.split(\"\").map((char, index) => (\n \n {char}\n \n ))}\n \n \n \n ) : (\n \n \n {children}\n \n \n )}\n \n );\n}\n\nexport const StatefulButton = forwardRef(function StatefulButton(\n {\n state = \"idle\",\n children,\n loadingText = \"Loading\",\n successText = \"Done\",\n errorText = \"Try again\",\n icon,\n disabled,\n ...rest\n },\n ref,\n) {\n const isBusy = state === \"loading\";\n const stateText =\n state === \"loading\"\n ? loadingText\n : state === \"success\"\n ? successText\n : state === \"error\"\n ? errorText\n : children;\n const textKey =\n typeof stateText === \"string\" ? `${state}-${stateText}` : state;\n\n return (\n \n );\n});\n"},{"path":"components/motion/tooltip/grace.ts","type":"registry:component","target":"@components/motion/tooltip/grace.ts","content":"type Point = { x: number; y: number };\ntype Box = { left: number; top: number; right: number; bottom: number };\n\n/**\n * The corridor a pointer may cross between the trigger and the open tooltip\n * without closing it: the convex hull of where it left and the box it is\n * heading for. A fixed timeout either cuts a slow diagonal move short or keeps\n * the label alive after the pointer has plainly gone elsewhere; this follows\n * the path itself.\n */\nexport function graceArea(exit: Point, target: Box): Point[] {\n // A few pixels either side of the exit point give the corridor some width at\n // its narrow end, so a hand that drifts sideways while it moves stays inside.\n const pad = 5;\n return hull([\n { x: exit.x - pad, y: exit.y - pad },\n { x: exit.x + pad, y: exit.y - pad },\n { x: exit.x - pad, y: exit.y + pad },\n { x: exit.x + pad, y: exit.y + pad },\n { x: target.left, y: target.top },\n { x: target.right, y: target.top },\n { x: target.right, y: target.bottom },\n { x: target.left, y: target.bottom },\n ]);\n}\n\nexport function inBox(point: Point, box: Box) {\n return (\n point.x >= box.left && point.x <= box.right && point.y >= box.top && point.y <= box.bottom\n );\n}\n\nexport function inPolygon(point: Point, polygon: Point[]) {\n let inside = false;\n for (let i = 0, j = polygon.length - 1; i < polygon.length; j = i++) {\n const a = polygon[i];\n const b = polygon[j];\n if (\n a.y > point.y !== b.y > point.y &&\n point.x < ((b.x - a.x) * (point.y - a.y)) / (b.y - a.y) + a.x\n ) {\n inside = !inside;\n }\n }\n return inside;\n}\n\n// Monotone chain; the corridor is always convex, so a hull is all it needs.\nfunction hull(points: Point[]) {\n const sorted = [...points].sort((a, b) => a.x - b.x || a.y - b.y);\n const cross = (o: Point, a: Point, b: Point) =>\n (a.x - o.x) * (b.y - o.y) - (a.y - o.y) * (b.x - o.x);\n const lower: Point[] = [];\n for (const p of sorted) {\n while (lower.length >= 2 && cross(lower[lower.length - 2], lower[lower.length - 1], p) <= 0) {\n lower.pop();\n }\n lower.push(p);\n }\n const upper: Point[] = [];\n for (let i = sorted.length - 1; i >= 0; i--) {\n const p = sorted[i];\n while (upper.length >= 2 && cross(upper[upper.length - 2], upper[upper.length - 1], p) <= 0) {\n upper.pop();\n }\n upper.push(p);\n }\n lower.pop();\n upper.pop();\n return lower.concat(upper);\n}\n\n/**\n * How the user last reached for the page. A focus that a mouse press caused is\n * not a request to read the label: the pointer is already on the control and\n * hovering showed it. A focus that followed a key — Tab, or a roving arrow key\n * moving focus in script — is the only way a keyboard user sees it at all.\n */\nlet modality: \"keyboard\" | \"pointer\" = \"keyboard\";\nlet listening = false;\n\nexport function watchModality() {\n if (listening || typeof window === \"undefined\") return;\n listening = true;\n window.addEventListener(\"keydown\", () => (modality = \"keyboard\"), true);\n window.addEventListener(\"pointerdown\", () => (modality = \"pointer\"), true);\n}\n\nexport function focusFromKeyboard() {\n return modality === \"keyboard\";\n}\n"},{"path":"components/motion/tooltip/positioner.tsx","type":"registry:component","target":"@components/motion/tooltip/positioner.tsx","content":"\"use client\";\n\nimport { useIsPresent } from \"motion/react\";\nimport { type CSSProperties, type ReactNode, type Ref, useCallback, useState } from \"react\";\nimport { type TooltipSide, useTooltipPosition } from \"./use-position\";\n\ntype PositionProps = Parameters[0];\n\n/** Readiness lives with the mounted overlay, not a trigger ref's attach/detach cycle. */\nexport function TooltipPositioner({\n children,\n ...position\n}: Omit & {\n children: (ready: boolean, present: boolean, side: TooltipSide) => ReactNode;\n}) {\n const present = useIsPresent();\n const [ready, setReady] = useState(false);\n const [side, setSide] = useState(position.side);\n const onPosition = useCallback((placed: TooltipSide) => {\n setReady(true);\n setSide(placed);\n }, []);\n useTooltipPosition({ ...position, open: present, onPosition });\n return (\n \n {children(ready, present, side)}\n \n );\n}\n\n// Each arrow is a 12px box whose base sits on the surface's inner border edge,\n// so its fill covers the border beneath it and only the two outer edges stroke.\nconst ARROW: Record = {\n top: { path: \"M0 6L6 12L12 6\", style: { top: \"calc(100% - 6px)\" } },\n bottom: { path: \"M0 6L6 0L12 6\", style: { bottom: \"calc(100% - 6px)\" } },\n left: { path: \"M6 0L12 6L6 12\", style: { left: \"calc(100% - 6px)\" } },\n right: { path: \"M6 0L0 6L6 12\", style: { right: \"calc(100% - 6px)\" } },\n};\n\nexport function TooltipArrow({ side, ref }: { side: TooltipSide; ref: Ref }) {\n const { path, style } = ARROW[side];\n return (\n \n \n \n \n );\n}\n"},{"path":"components/motion/tooltip/use-position.ts","type":"registry:component","target":"@components/motion/tooltip/use-position.ts","content":"\"use client\";\n\nimport {\n arrow as arrowMiddleware,\n autoUpdate,\n computePosition,\n flip,\n hide,\n offset,\n type Placement,\n shift,\n type VirtualElement,\n} from \"@floating-ui/dom\";\nimport { type RefObject, useCallback, useLayoutEffect, useRef } from \"react\";\n\nexport type TooltipSide = \"top\" | \"right\" | \"bottom\" | \"left\";\nexport type TooltipAlign = \"start\" | \"center\" | \"end\";\nexport type TooltipPoint = { x: number; y: number };\nexport type TooltipAnchor = HTMLElement | SVGElement;\n\nconst ORIGIN: Record = {\n top: \"center bottom\",\n bottom: \"center top\",\n left: \"right center\",\n right: \"left center\",\n};\n\n/** Position is geometry, not animation. One write per frame, never a spring chasing a pointer. */\nexport function useTooltipPosition({\n open,\n anchor,\n floatingRef,\n arrowRef,\n anchorPoint,\n followCursor,\n side,\n align,\n sideOffset,\n onDismiss,\n onPosition,\n pointer,\n}: {\n open: boolean;\n anchor: TooltipAnchor | null;\n floatingRef: RefObject;\n arrowRef?: RefObject;\n anchorPoint?: TooltipPoint;\n followCursor: boolean;\n side: TooltipSide;\n align: TooltipAlign;\n sideOffset?: number;\n onDismiss: () => void;\n onPosition: (side: TooltipSide) => void;\n pointer: ReturnType;\n}) {\n const { cursor, onMove } = pointer;\n const preferred: Placement = align === \"center\" ? side : `${side}-${align}`;\n const cursorSide = useRef(null);\n useLayoutEffect(() => {\n cursorSide.current = open ? preferred : null;\n }, [open, preferred]);\n const frame = useRef(null);\n const version = useRef(0);\n const update = useRef<() => void>(() => {});\n const schedule = useCallback(() => {\n // Invalidate older async calculations as soon as new geometry is requested.\n version.current++;\n if (frame.current !== null) return;\n frame.current = requestAnimationFrame(() => {\n frame.current = null;\n update.current();\n });\n }, []);\n useLayoutEffect(() => {\n onMove.current = schedule;\n return () => {\n onMove.current = null;\n };\n }, [onMove, schedule]);\n const pointX = anchorPoint?.x;\n const pointY = anchorPoint?.y;\n\n // Latest committed inputs are read without recreating observers for every period/content update.\n useLayoutEffect(() => {\n update.current = () => {\n const floating = floatingRef.current;\n if (!open || !anchor || !floating) return;\n const revision = ++version.current;\n const currentCursor = followCursor ? cursor.current : null;\n const virtual = Boolean(currentCursor) || pointX !== undefined || pointY !== undefined;\n const reference: Element | VirtualElement = virtual\n ? {\n contextElement: anchor,\n getBoundingClientRect: () => {\n const rect = anchor.getBoundingClientRect();\n const x = currentCursor?.x ?? rect.left + rect.width * (pointX ?? 0.5);\n const y = currentCursor?.y ?? rect.top + rect.height * (pointY ?? 0.5);\n return { x, y, left: x, right: x, top: y, bottom: y, width: 0, height: 0 };\n },\n }\n : anchor;\n const arrowElement = arrowRef?.current ?? null;\n void computePosition(reference, floating, {\n strategy: \"fixed\",\n placement: currentCursor ? (cursorSide.current ?? preferred) : preferred,\n middleware: [\n offset(sideOffset ?? (currentCursor ? 12 : 8)),\n flip({ padding: 8 }),\n shift({ padding: 8 }),\n ...(arrowElement ? [arrowMiddleware({ element: arrowElement, padding: 10 })] : []),\n // A label left floating over whatever scrolled into its trigger's place\n // describes nothing there. Points inside a chart move with the chart.\n ...(virtual ? [] : [hide({ strategy: \"referenceHidden\" })]),\n ],\n }).then(({ x, y, placement, middlewareData }) => {\n if (version.current !== revision || !floating.isConnected) return;\n // Hold the chosen side for this hover session. Crossing a flip threshold\n // repeatedly must not bounce the surface above and below the pointer.\n if (currentCursor) cursorSide.current = placement;\n else cursorSide.current = null;\n const placedSide = placement.split(\"-\")[0] as TooltipSide;\n const dpr = window.devicePixelRatio || 1;\n floating.style.transform = `translate3d(${Math.round(x * dpr) / dpr}px, ${Math.round(y * dpr) / dpr}px, 0)`;\n floating.style.setProperty(\"--tooltip-origin\", ORIGIN[placedSide]);\n // A box with no size has no clipped state to report, only a missing layout.\n const box = anchor.getBoundingClientRect();\n const clipped =\n Boolean(middlewareData.hide?.referenceHidden) && (box.width > 0 || box.height > 0);\n floating.style.visibility = clipped ? \"hidden\" : \"visible\";\n floating.dataset.placement = placement;\n const surface = arrowElement?.parentElement;\n if (arrowElement && surface) {\n // Measured against the positioner, drawn inside the surface's border.\n const { x: ax, y: ay } = middlewareData.arrow ?? {};\n if (ax != null) arrowElement.style.left = `${ax - surface.clientLeft}px`;\n if (ay != null) arrowElement.style.top = `${ay - surface.clientTop}px`;\n // Paint with whatever the surface resolved to, so a restyled tooltip\n // keeps a matching arrow without a second set of classes.\n const style = getComputedStyle(surface);\n arrowElement.style.setProperty(\"--tooltip-arrow-fill\", style.backgroundColor);\n arrowElement.style.setProperty(\"--tooltip-arrow-stroke\", style.borderTopColor);\n }\n onPosition(placedSide);\n });\n };\n if (open) schedule();\n }, [\n open,\n anchor,\n floatingRef,\n arrowRef,\n followCursor,\n pointX,\n pointY,\n preferred,\n sideOffset,\n schedule,\n onPosition,\n cursor,\n ]);\n\n useLayoutEffect(() => {\n const floating = floatingRef.current;\n if (!open || !anchor || !floating) return;\n const stop = autoUpdate(anchor, floating, schedule);\n const onScroll = () => {\n // A stationary pointer no longer describes the same chart point after scrolling.\n if (followCursor && cursor.current) onDismiss();\n };\n window.addEventListener(\"scroll\", onScroll, true);\n return () => {\n stop();\n window.removeEventListener(\"scroll\", onScroll, true);\n version.current++;\n if (frame.current !== null) cancelAnimationFrame(frame.current);\n frame.current = null;\n };\n }, [open, anchor, floatingRef, followCursor, onDismiss, schedule, cursor]);\n\n useLayoutEffect(\n () => () => {\n version.current++;\n if (frame.current !== null) cancelAnimationFrame(frame.current);\n },\n [],\n );\n}\n\n/** Pointer lifetime belongs to the anchor, including the opening delay. */\nexport function useTooltipPointer(anchor: TooltipAnchor | null, followCursor: boolean) {\n const cursor = useRef(null);\n const onMove = useRef<(() => void) | null>(null);\n const pointerFocus = useRef(false);\n useLayoutEffect(() => {\n if (!anchor || !followCursor) return;\n const point = (event: PointerEvent) => {\n if (event.type === \"pointermove\" && event.pointerType === \"touch\" && !event.buttons) return;\n cursor.current = { x: event.clientX, y: event.clientY };\n if (event.type === \"pointerdown\") pointerFocus.current = true;\n onMove.current?.();\n };\n const keyboard = () => {\n cursor.current = null;\n pointerFocus.current = false;\n onMove.current?.();\n };\n const focus = () => {\n if (!pointerFocus.current) cursor.current = null;\n pointerFocus.current = false;\n onMove.current?.();\n };\n const leave = () => {\n cursor.current = null;\n };\n anchor.addEventListener(\"pointerenter\", point as EventListener, { passive: true });\n anchor.addEventListener(\"pointermove\", point as EventListener, { passive: true });\n anchor.addEventListener(\"pointerdown\", point as EventListener, { passive: true });\n anchor.addEventListener(\"pointerleave\", leave);\n anchor.addEventListener(\"pointercancel\", leave);\n anchor.addEventListener(\"keydown\", keyboard);\n anchor.addEventListener(\"focusin\", focus);\n return () => {\n cursor.current = null;\n anchor.removeEventListener(\"pointerenter\", point as EventListener);\n anchor.removeEventListener(\"pointermove\", point as EventListener);\n anchor.removeEventListener(\"pointerdown\", point as EventListener);\n anchor.removeEventListener(\"pointerleave\", leave);\n anchor.removeEventListener(\"pointercancel\", leave);\n anchor.removeEventListener(\"keydown\", keyboard);\n anchor.removeEventListener(\"focusin\", focus);\n };\n }, [anchor, followCursor]);\n\n return { cursor, onMove };\n}\n"},{"path":"components/motion/tooltip-surface.tsx","type":"registry:component","target":"@components/motion/tooltip-surface.tsx","content":"\"use client\";\n\nimport { motion, useReducedMotion } from \"motion/react\";\nimport type { ComponentProps, ReactNode, Ref } from \"react\";\nimport { EASE_OUT } from \"@/lib/ease\";\nimport { cn } from \"@/lib/utils\";\n\n/** Presentation only: the unanimated parent owns measurement and positioning. */\nexport function TooltipSurface({\n children,\n side: _side = \"top\",\n className,\n ref,\n ready = true,\n style,\n ...props\n}: Omit, \"children\"> & {\n children?: ReactNode;\n /** Start the entrance only after the positioning layer has been measured. */\n ready?: boolean;\n side?: \"top\" | \"right\" | \"bottom\" | \"left\";\n ref?: Ref;\n}) {\n const reduce = useReducedMotion();\n const closed = { opacity: 0, scale: reduce ? 1 : 0.94 };\n return (\n \n {children}\n \n );\n}\n"},{"path":"lib/hooks/use-dismiss.ts","type":"registry:hook","target":"@lib/hooks/use-dismiss.ts","content":"\"use client\";\n\nimport { type RefObject, useEffect } from \"react\";\n\n/**\n * What the dismissing gesture does to the control it landed on.\n *\n * `\"pass-through\"` is the platform norm (native popover light-dismiss): the\n * tap closes the overlay *and* activates whatever was under it. Use\n * `\"consume\"` where the open overlay sits over or beside controls that would\n * be costly to trigger by accident — the dismissal then swallows the\n * activation too, so the gesture only closes.\n */\nexport type DismissBehavior = \"pass-through\" | \"consume\";\n\nexport interface DismissOptions {\n /** Default `\"pass-through\"`. */\n behavior?: DismissBehavior;\n /** Dismiss on Escape as well. Default true. */\n escape?: boolean;\n /** Return true for an outside target that should *not* dismiss. Must be stable. */\n ignore?: (target: Element) => boolean;\n}\n\n/**\n * What every currently open dismiss scope counts as inside itself. A consumed\n * dismissal reads this to tell a stray gesture from one that belongs to an\n * overlay in front of it: overlays have no shared z-order to consult, but the\n * one the gesture landed in has said as much by registering it.\n */\nconst openScopes = new Set<(target: Element) => boolean>();\n\nfunction claimedByAnotherScope(\n self: (target: Element) => boolean,\n target: Element,\n) {\n for (const scope of openScopes) {\n if (scope !== self && scope(target)) return true;\n }\n return false;\n}\n\n// preventDefault on pointerdown does not suppress the click that follows, so\n// consuming a gesture means swallowing that click itself. The swallower\n// deliberately outlives the effect that installed it — the dismissal it\n// belongs to has already unmounted or re-rendered by the time the click lands.\n// It releases on that click, or on the next gesture if the pointer is dragged\n// away and no click ever arrives, so it can never eat a later one. A keydown\n// releases it too: a gesture that ends with neither a click nor a cancel would\n// otherwise leave it armed, and the click Enter synthesizes on some focused\n// control is not the one this dismissal was owed.\nfunction consumeActivation(source: Event) {\n const swallow = (event: MouseEvent) => {\n event.preventDefault();\n event.stopPropagation();\n release();\n };\n const restart = (event: Event) => {\n if (event !== source) release();\n };\n const release = () => {\n window.removeEventListener(\"click\", swallow, true);\n window.removeEventListener(\"pointerdown\", restart, true);\n window.removeEventListener(\"pointercancel\", restart, true);\n window.removeEventListener(\"keydown\", release, true);\n };\n window.addEventListener(\"click\", swallow, true);\n window.addEventListener(\"pointerdown\", restart, true);\n window.addEventListener(\"pointercancel\", restart, true);\n window.addEventListener(\"keydown\", release, true);\n}\n\n/**\n * Close an open overlay on Escape or a pointerdown outside `ref`. Pass `null`\n * for `ref` when what counts as inside isn't one element, and say so with\n * `ignore` instead.\n *\n * The pointerdown listener is capture-phase: a bubble-phase one is blinded by\n * any handler in between that stops propagation, and an overlay cannot know\n * what it is layered over. `onDismiss` and `ignore` must be stable (wrap in\n * useCallback) so the listeners aren't re-bound every render while open.\n */\nexport function useDismiss(\n open: boolean,\n onDismiss: () => void,\n ref: RefObject | null,\n {\n behavior = \"pass-through\",\n escape: dismissOnEscape = true,\n ignore,\n }: DismissOptions = {},\n) {\n useEffect(() => {\n if (!open) return;\n const inside = (target: Element) =>\n Boolean(ref?.current?.contains(target)) || Boolean(ignore?.(target));\n const onKey = (event: KeyboardEvent) => {\n if (dismissOnEscape && event.key === \"Escape\") onDismiss();\n };\n const onPointer = (event: PointerEvent) => {\n const target = event.target as Element | null;\n if (!target || inside(target)) return;\n // Outside this overlay, but inside one that is also open: the gesture is\n // that overlay's to answer, and swallowing its click from behind would\n // cost the user the control they actually aimed at.\n if (behavior === \"consume\" && !claimedByAnotherScope(inside, target)) {\n consumeActivation(event);\n }\n onDismiss();\n };\n openScopes.add(inside);\n window.addEventListener(\"keydown\", onKey);\n window.addEventListener(\"pointerdown\", onPointer, true);\n return () => {\n openScopes.delete(inside);\n window.removeEventListener(\"keydown\", onKey);\n window.removeEventListener(\"pointerdown\", onPointer, true);\n };\n }, [open, onDismiss, ref, behavior, dismissOnEscape, ignore]);\n}\n"},{"path":"lib/hooks/use-hover-gesture.ts","type":"registry:hook","target":"@lib/hooks/use-hover-gesture.ts","content":"\"use client\";\n\nimport { useMemo, useRef } from \"react\";\nimport { isHoveringPointer } from \"@/lib/touch\";\n\ninterface BoundaryEvent {\n pointerId: number;\n pointerType: string;\n buttons: number;\n}\n\nexport interface HoverGesture {\n /** True when this enter starts a hover: the pointer arrived resting, not pressing. */\n enter: (event: BoundaryEvent) => boolean;\n /** True when this leave ends a hover that entered as one. */\n leave: (event: BoundaryEvent) => boolean;\n}\n\n/**\n * Pairs a surface's enter with its leave, per pointer.\n *\n * `isHoveringPointer` answers the question the *enter* asks — is this pointer\n * resting on the surface or pressing it — and both boundary cases go wrong if\n * the leave is asked the same question again:\n *\n * - A pen with no hover never rests. It arrives in contact, taps, and the spec\n * then requires its boundary events after `pointerup`, so the leave carries\n * `buttons: 0` and reads as a mouse gliding off. Hover teardown then undid\n * the tap — the panel the pen had just opened closed under it.\n * - A mouse pressed on the surface and dragged off leaves with `buttons: 1`.\n * Skipping teardown there strands the surface open: the release happens\n * outside, and no second leave ever comes.\n *\n * So the state a hover holds is released by the pointer that took it, whatever\n * the buttons say at the boundary, and a pointer that arrived in contact never\n * took it in the first place. Contact is the exception tracked here, not\n * hover: a leave from a pointer this surface never saw enter — mounted under\n * the cursor, say — still counts, since the alternative is state with no way\n * out.\n */\nexport function useHoverGesture(): HoverGesture {\n const contact = useRef(new Set());\n\n return useMemo(\n () => ({\n enter: (event) => {\n if (isHoveringPointer(event)) {\n contact.current.delete(event.pointerId);\n return true;\n }\n contact.current.add(event.pointerId);\n return false;\n },\n leave: (event) => {\n const arrivedInContact = contact.current.delete(event.pointerId);\n return !arrivedInContact && event.pointerType !== \"touch\";\n },\n }),\n [],\n );\n}\n"},{"path":"lib/hooks/use-tap-gesture.ts","type":"registry:hook","target":"@lib/hooks/use-tap-gesture.ts","content":"\"use client\";\n\nimport { useMemo, useRef } from \"react\";\n\n/** What a pointerdown recorded, read back by the click that ends its gesture. */\nexport interface TapRecord {\n /** Which input started the gesture. */\n pointerType: string;\n /** What the surface was showing when it started. */\n state: S;\n}\n\nexport interface TapGesture {\n /** Record the gesture a pointerdown starts, with the state it starts in. */\n start: (event: { pointerType: string }, state: S) => void;\n /** Read the record and clear it. `null` when no pointer is behind this click. */\n take: () => TapRecord | null;\n /** Drop the record: this gesture will never spend it on a click. */\n drop: () => void;\n}\n\n/**\n * The pointer gesture behind a click, recorded where the click cannot report\n * it. A `click` carries no `pointerType` in the engines that matter, so the\n * `pointerdown` before it is the only thing that says which input activated\n * the control — and whether one did at all, since keyboard activation\n * synthesizes a click with no pointer behind it.\n *\n * State goes in with the record because a click reports that no better: a\n * browser that focuses a control on contact can open the very panel the tap\n * was meant to open, and reading \"is it open\" at click time then undoes it.\n * What the gesture started against is what it acts on.\n *\n * The record is spent by one click and dropped by everything else, because a\n * record that outlives its gesture is worse than none:\n *\n * - A scroll or an OS gesture takes the touch away — `pointercancel`, no click\n * ever — and the finger would sit in the record until some later click.\n * - That later click is often `Enter` on a keyboard, which arrives with no\n * pointerdown of its own and would inherit the abandoned finger. A keydown\n * is the start of a keyboard activation and never part of a tap, so it drops\n * the record too.\n *\n * Both ends have to be wired by the surface: `drop` on `onPointerCancel` and\n * on `onKeyDown`.\n */\nexport function useTapGesture(): TapGesture {\n const record = useRef | null>(null);\n\n return useMemo(\n () => ({\n start: (event, state) => {\n record.current = { pointerType: event.pointerType, state };\n },\n take: () => {\n const spent = record.current;\n record.current = null;\n return spent;\n },\n drop: () => {\n record.current = null;\n },\n }),\n [],\n );\n}\n"},{"path":"lib/audio-context.ts","type":"registry:lib","target":"@lib/audio-context.ts","content":"// One AudioContext for every synthesized sound on the page (lib/tick-sound.ts,\n// lib/game-sounds.ts). Browsers cap concurrent contexts, and a page can show a\n// date made of several WheelPickers next to a game, so they all share this\n// one. It is created on first use and closed once every player is disposed.\n\ntype AudioContextCtor = typeof AudioContext;\n\nlet context: AudioContext | null = null;\nlet users = 0;\n\n/**\n * Registers a sound player. Call the returned function when the player is\n * disposed; the context closes after the last one.\n */\nexport function retainAudioContext() {\n users++;\n let released = false;\n return () => {\n if (released) return;\n released = true;\n users--;\n if (users === 0 && context) {\n void context.close();\n context = null;\n }\n };\n}\n\n/**\n * The shared context, created on first call and resumed if suspended. Null\n * during SSR and in browsers without Web Audio.\n */\nexport function getAudioContext(): AudioContext | null {\n if (!context) {\n if (typeof window === \"undefined\") return null;\n const Ctor =\n window.AudioContext ??\n (window as unknown as { webkitAudioContext?: AudioContextCtor }).webkitAudioContext;\n if (!Ctor) return null;\n context = new Ctor();\n }\n // Browsers may refuse outside a user gesture. Players call this from\n // pointer and key handlers first, so a later call finds it running.\n if (context.state === \"suspended\") void context.resume().catch(() => undefined);\n return context;\n}\n"},{"path":"lib/hooks/use-hover-capable.ts","type":"registry:hook","target":"@lib/hooks/use-hover-capable.ts","content":"\"use client\";\n\nimport { useEffect, useState } from \"react\";\n\n/**\n * Returns true only on devices that have a true hover (mouse / trackpad).\n * Touch devices fire phantom `:hover` on tap that sticks until tap-elsewhere\n * — gate hover-only effects (scale lifts, magnetic pulls) behind this.\n */\nexport function useHoverCapable() {\n const [canHover, setCanHover] = useState(false);\n\n useEffect(() => {\n if (typeof window === \"undefined\" || !window.matchMedia) return;\n const mq = window.matchMedia(\"(hover: hover) and (pointer: fine)\");\n const update = () => setCanHover(mq.matches);\n update();\n mq.addEventListener?.(\"change\", update);\n return () => mq.removeEventListener?.(\"change\", update);\n }, []);\n\n return canHover;\n}\n"},{"path":"components/motion/magnetic.tsx","type":"registry:component","target":"@components/motion/magnetic.tsx","content":"\"use client\";\n\nimport { motion, useMotionValue, useReducedMotion, useSpring } from \"motion/react\";\nimport { useRef, type ReactNode } from \"react\";\nimport { SPRING_MOUSE } from \"@/lib/ease\";\nimport { useHoverCapable } from \"@/lib/hooks/use-hover-capable\";\nimport { cn } from \"@/lib/utils\";\n\nexport interface MagneticProps {\n children: ReactNode;\n strength?: number;\n className?: string;\n}\n\nexport function Magnetic({ children, strength = 0.35, className }: MagneticProps) {\n const ref = useRef(null);\n const reduce = useReducedMotion();\n const canHover = useHoverCapable();\n // Decorative cursor-follow: skip on touch (phantom hover) and reduced motion.\n const enabled = !reduce && canHover;\n const x = useMotionValue(0);\n const y = useMotionValue(0);\n const sx = useSpring(x, SPRING_MOUSE);\n const sy = useSpring(y, SPRING_MOUSE);\n\n const onMove = (e: React.MouseEvent) => {\n const el = ref.current;\n if (!el || !enabled) return;\n const rect = el.getBoundingClientRect();\n x.set((e.clientX - rect.left - rect.width / 2) * strength);\n y.set((e.clientY - rect.top - rect.height / 2) * strength);\n };\n\n const onLeave = () => {\n x.set(0);\n y.set(0);\n };\n\n return (\n \n {children}\n \n );\n}\n"},{"path":"lib/touch.ts","type":"registry:lib","target":"@lib/touch.ts","content":"// Shared touch primitives. iOS and iPadOS run their own gestures on top of the\n// page — the long-press selection callout and the selection it drags in with\n// it — and they win: once the platform claims a touch it cancels ours\n// mid-gesture, so a press-and-hold or a drag simply dies. Surfaces that own\n// their gesture have to opt out.\n//\n// What the two classes below cover, precisely:\n// - `-webkit-touch-callout: none` stops iOS's long-press callout. WebKit-only:\n// it is not a property other engines have, so it is inert everywhere else.\n// - `user-select: none` stops the long-press selection on every engine,\n// Android included, and stops a drag from painting a selection under the\n// cursor. It is inherited, so it reaches every descendant — which is why the\n// two classes differ only in whether they apply it unconditionally.\n// What neither covers:\n// - Chrome for Android's long-press menu on a link or an image. No CSS\n// suppresses it; a gesture surface that wraps one needs its own\n// `onContextMenu` with `preventDefault()`.\n// - The native drag of an `` or `` descendant. `-webkit-user-drag` is\n// not inherited and plain divs and buttons are not drag sources, so setting\n// it on the surface does nothing — the child itself needs `draggable={false}`.\n\n/**\n * Classes for a surface that *is* the control: a thumb, a drum, a stage, a\n * handle, a hold button. Selection is suppressed on every input, because a\n * drag that highlights the control's own label is wrong on a mouse too.\n * Compose with `touch-none` when the surface also owns the scroll axis — leave\n * it off when the page must still scroll from there.\n */\nexport const TOUCH_GESTURE_CLASS = \"select-none [-webkit-touch-callout:none]\";\n\n/**\n * The same opt-out for a gesture surface that wraps content the consumer owns:\n * a scroller, a context-menu trigger, a sheet header, a list row. Selection is\n * suppressed only where the platform runs its own press gestures — a coarse\n * pointer — so a mouse user can still select and copy that content. If the\n * gesture itself would paint a selection under the cursor, add `select-none`\n * for the duration of the gesture rather than reaching for\n * `TOUCH_GESTURE_CLASS`.\n *\n * `pointer: coarse` describes the *primary* pointer and nothing else, so a\n * hybrid machine reads it wrong in both directions: a tablet with a mouse\n * plugged in keeps touch as primary and loses mouse selection, and a laptop\n * with a touchscreen keeps the mouse as primary and leaves selection live\n * under a finger. No media query can answer per interaction — the query is\n * about the device, and the question is about the gesture in progress. The\n * default stays here because it is right on the machines that are one thing or\n * the other, and losing a selection is a nuisance; where the miss costs a\n * *gesture* instead, the surface pairs it with `holdSelection` on the press.\n */\nexport const TOUCH_GESTURE_CONTENT_CLASS =\n \"[-webkit-touch-callout:none] pointer-coarse:select-none\";\n\n/**\n * Suppress selection on `element` for as long as a gesture is running on it,\n * whatever the primary pointer of the machine happens to be. Returns the\n * release. Inline, so it wins over the class above and is gone again the\n * moment the gesture ends.\n *\n * For the press gestures a native selection would otherwise steal — a\n * long-press that opens a menu. Elsewhere prefer the classes: a surface that\n * takes selection away for the whole session is a surface whose text nobody\n * can copy.\n */\nexport function holdSelection(element: HTMLElement) {\n element.style.setProperty(\"user-select\", \"none\");\n element.style.setProperty(\"-webkit-user-select\", \"none\");\n return () => {\n element.style.removeProperty(\"user-select\");\n element.style.removeProperty(\"-webkit-user-select\");\n };\n}\n\n/**\n * Pointer capture, best effort. WebKit throws `NotFoundError` when the pointer\n * is already gone by the time the handler runs — routine on iOS, where the\n * system can claim the touch first — and an uncaught throw takes the rest of\n * the handler, the gesture included, down with it. Touch pointers carry\n * implicit capture anyway, so losing it is never fatal.\n */\nexport function capturePointer(element: Element, pointerId: number) {\n try {\n element.setPointerCapture(pointerId);\n } catch {\n // Pointer is no longer active — implicit capture still applies on touch.\n }\n}\n\n/** Release a capture taken with `capturePointer`, ignoring a stale pointer. */\nexport function releasePointer(element: Element, pointerId: number) {\n try {\n if (element.hasPointerCapture(pointerId)) {\n element.releasePointerCapture(pointerId);\n }\n } catch {\n // Capture was already dropped by the browser.\n }\n}\n\n/**\n * Whether this event came from a pointer that is *hovering*: not a touch, and\n * not currently pressed. Which input the user is holding right now is not\n * something a device capability can answer — a touchscreen laptop hovers and\n * taps, and iPadOS reports a fine hovering pointer for a finger — so both\n * paths stay live and each handler branches on the event it was given.\n *\n * A pen resting on the glass is making contact, not hovering: `buttons` is the\n * tell, and it sends a pen tap down the same route a finger takes.\n *\n * This answers what an *enter* asks. A leave is the other half of a pair and\n * has to be read against the enter that started it — `useHoverGesture` in\n * `lib/hooks/use-hover-gesture` does that, and hover surfaces should use it\n * rather than asking this question twice.\n */\nexport const isHoveringPointer = (event: {\n pointerType: string;\n buttons: number;\n}) => event.pointerType !== \"touch\" && event.buttons === 0;\n"}]}