{"$schema":"https://ui.shadcn.com/schema/registry-item.json","name":"stepper","type":"registry:component","title":"Stepper","description":"Multi-step flow with an active ring that glides between step markers, connectors that fill as steps complete, panels that slide in from the direction of travel while the container morphs to each panel's height, and an async per-step guard that shakes the marker when it refuses. Linear or free navigation, controlled/uncontrolled, reduced-motion safe.","author":"kara ","dependencies":["clsx","lucide-react","motion","tailwind-merge"],"registryDependencies":[],"files":[{"path":"components/motion/stepper.tsx","type":"registry:component","target":"@components/motion/stepper.tsx","content":"\"use client\";\n// karaui.kamisama-v0.my.id/components/motion/stepper\n\nimport { Check } from \"lucide-react\";\nimport {\n AnimatePresence,\n motion,\n useAnimationControls,\n useReducedMotion,\n} from \"motion/react\";\nimport {\n Children,\n createContext,\n type ReactNode,\n useCallback,\n useContext,\n useEffect,\n useId,\n useMemo,\n useRef,\n useState,\n} from \"react\";\nimport { Button, type ButtonProps } from \"@/components/motion/button\";\nimport { EASE_OUT, SPRING_LAYOUT, SPRING_SWAP } from \"@/lib/ease\";\nimport { cn } from \"@/lib/utils\";\n\nexport type StepperStep = {\n id: string;\n title: string;\n description?: string;\n};\n\n/** Return false (or a promise of false) to keep the user on the current step. */\nexport type StepperGuard = (index: number) => boolean | Promise;\n\nexport interface StepperProps {\n steps: StepperStep[];\n /** Controlled active step index. */\n value?: number;\n /** Uncontrolled initial step index. Default 0. */\n defaultValue?: number;\n onValueChange?: (index: number) => void;\n /** Runs before leaving a step forward (Next, or jumping ahead). */\n canAdvance?: StepperGuard;\n /** Called when Next is pressed on the last step and its guard passes. */\n onComplete?: () => void | Promise;\n /**\n * Linear (default): the indicator only jumps back, or forward to steps\n * already reached. Non-linear: any step, still guarded by `canAdvance`.\n */\n linear?: boolean;\n children: ReactNode;\n className?: string;\n}\n\ntype StepperContextValue = {\n steps: StepperStep[];\n value: number;\n count: number;\n direction: 1 | -1;\n reached: number;\n completed: ReadonlySet;\n errorStep: number | null;\n errorTick: number;\n pending: boolean;\n linear: boolean;\n isFirst: boolean;\n isLast: boolean;\n baseId: string;\n next: () => Promise;\n previous: () => void;\n goTo: (index: number) => Promise;\n};\n\nconst StepperContext = createContext(null);\n\n/** Step state and navigation for custom controls inside ``. */\nexport function useStepper() {\n const ctx = useContext(StepperContext);\n if (!ctx) throw new Error(\"useStepper must be used within \");\n return ctx;\n}\n\nconst clamp = (n: number, max: number) => Math.min(Math.max(n, 0), max);\n\n/**\n * Multi-step flow: an indicator whose active ring glides between steps and\n * whose connectors fill as you advance, panels that slide in from the\n * direction of travel while the container morphs to each panel's height, and\n * a guard per step that shakes the indicator when it refuses. Controlled or\n * uncontrolled; reduced-motion safe.\n */\nexport function Stepper({\n steps,\n value: controlledValue,\n defaultValue = 0,\n onValueChange,\n canAdvance,\n onComplete,\n linear = true,\n children,\n className,\n}: StepperProps) {\n const count = steps.length;\n const baseId = useId();\n const [internalValue, setInternalValue] = useState(() =>\n clamp(defaultValue, count - 1),\n );\n const value = clamp(controlledValue ?? internalValue, count - 1);\n\n const [direction, setDirection] = useState<1 | -1>(1);\n const [reached, setReached] = useState(value);\n const [completed, setCompleted] = useState>(\n () => new Set(),\n );\n const [errorStep, setErrorStep] = useState(null);\n // Bumped on every refusal so the same step can shake twice in a row.\n const [errorTick, setErrorTick] = useState(0);\n const [pending, setPending] = useState(false);\n\n // A controlled jump past `reached` (e.g. restoring a draft) still counts.\n useEffect(() => setReached((r) => Math.max(r, value)), [value]);\n\n const commit = useCallback(\n (index: number) => {\n setDirection(index > value ? 1 : -1);\n setErrorStep(null);\n if (controlledValue === undefined) setInternalValue(index);\n onValueChange?.(index);\n },\n [value, controlledValue, onValueChange],\n );\n\n const guard = useCallback(\n async (index: number) => {\n if (!canAdvance) return true;\n setPending(true);\n try {\n return await canAdvance(index);\n } finally {\n setPending(false);\n }\n },\n [canAdvance],\n );\n\n const refuse = useCallback((index: number) => {\n setErrorStep(index);\n setErrorTick((t) => t + 1);\n }, []);\n\n const markDone = useCallback((from: number, to: number) => {\n setCompleted((prev) => {\n const next = new Set(prev);\n for (let i = from; i < to; i++) next.add(i);\n return next;\n });\n }, []);\n\n const goTo = useCallback(\n async (target: number) => {\n const index = clamp(target, count - 1);\n if (index === value || pending) return false;\n if (index < value) {\n commit(index);\n return true;\n }\n // Linear: forward only to steps already reached, or the very next one.\n if (linear && index > Math.max(reached, value + 1)) return false;\n // Every step being skipped over must pass its guard, in order.\n for (let i = value; i < index; i++) {\n if (!(await guard(i))) {\n refuse(i);\n if (i !== value) commit(i);\n return false;\n }\n }\n markDone(value, index);\n setReached((r) => Math.max(r, index));\n commit(index);\n return true;\n },\n [count, value, pending, linear, reached, guard, refuse, markDone, commit],\n );\n\n const next = useCallback(async () => {\n if (pending) return false;\n if (value < count - 1) return goTo(value + 1);\n if (!(await guard(value))) {\n refuse(value);\n return false;\n }\n markDone(value, value + 1);\n setErrorStep(null);\n setPending(true);\n try {\n await onComplete?.();\n } finally {\n setPending(false);\n }\n return true;\n }, [pending, value, count, goTo, guard, refuse, markDone, onComplete]);\n\n const previous = useCallback(() => {\n if (value > 0 && !pending) commit(value - 1);\n }, [value, pending, commit]);\n\n const ctx = useMemo(\n () => ({\n steps,\n value,\n count,\n direction,\n reached,\n completed,\n errorStep,\n errorTick,\n pending,\n linear,\n isFirst: value === 0,\n isLast: value === count - 1,\n baseId,\n next,\n previous,\n goTo,\n }),\n [\n steps,\n value,\n count,\n direction,\n reached,\n completed,\n errorStep,\n errorTick,\n pending,\n linear,\n baseId,\n next,\n previous,\n goTo,\n ],\n );\n\n return (\n \n
\n {children}\n
\n \n );\n}\n\n// ── indicator ──────────────────────────────────────────────────────────────\n\nexport interface StepperIndicatorProps {\n /** Show each step's title under its marker. Default true. */\n showTitles?: boolean;\n className?: string;\n}\n\n/** Numbered markers joined by connectors that fill as steps complete. */\nexport function StepperIndicator({\n showTitles = true,\n className,\n}: StepperIndicatorProps) {\n const {\n steps,\n value,\n reached,\n completed,\n errorStep,\n errorTick,\n linear,\n baseId,\n goTo,\n } = useStepper();\n const reduce = useReducedMotion();\n\n return (\n
    \n {steps.map((step, i) => {\n const active = i === value;\n const done = completed.has(i) && !active;\n const error = errorStep === i;\n const reachable = !linear || i <= reached;\n const state = error\n ? \"error\"\n : done\n ? \"completed\"\n : active\n ? \"current\"\n : \"upcoming\";\n\n return (\n \n {i < steps.length - 1 && (\n // Connector from this marker's center to the next one's.\n \n \n \n )}\n goTo(i)}\n layoutGroup={baseId}\n />\n {showTitles && (\n \n {step.title}\n \n )}\n \n );\n })}\n
\n );\n}\n\nfunction StepMarker({\n index,\n state,\n shakeKey,\n disabled,\n label,\n current,\n controls,\n onSelect,\n layoutGroup,\n}: {\n index: number;\n state: \"upcoming\" | \"current\" | \"completed\" | \"error\";\n shakeKey: number;\n disabled: boolean;\n label: string;\n current: boolean;\n controls: string;\n onSelect: () => void;\n layoutGroup: string;\n}) {\n const reduce = useReducedMotion();\n const shake = useAnimationControls();\n\n useEffect(() => {\n if (!shakeKey || reduce) return;\n shake.start({\n x: [0, -5, 5, -3, 3, 0],\n transition: { duration: 0.4, ease: EASE_OUT },\n });\n }, [shakeKey, reduce, shake]);\n\n return (\n \n {state === \"current\" && (\n \n )}\n \n {state === \"completed\" ? (\n \n \n \n ) : (\n \n {index + 1}\n \n )}\n \n \n );\n}\n\n// ── panels ─────────────────────────────────────────────────────────────────\n\nexport interface StepperPanelsProps {\n /** One child per step, in step order. */\n children: ReactNode;\n className?: string;\n}\n\n/**\n * Shows the active step's child. Panels slide in from the direction of\n * travel and the container morphs to each panel's height. Focus moves to the\n * new panel after navigation so keyboard and screen-reader users land on it.\n */\nexport function StepperPanels({ children, className }: StepperPanelsProps) {\n const { value, direction, steps, baseId } = useStepper();\n const reduce = useReducedMotion();\n const panels = Children.toArray(children);\n const containerRef = useRef(null);\n const shownStep = useRef(value);\n\n useEffect(() => {\n // Only move focus in response to navigation, never on first render.\n if (shownStep.current === value) return;\n shownStep.current = value;\n // The exiting panel is still mounted mid-transition, so look the entering\n // one up by its step instead of trusting a shared ref.\n containerRef.current\n ?.querySelector(`[data-step=\"${value}\"]`)\n ?.focus({ preventScroll: true });\n }, [value]);\n\n const offset = reduce ? 0 : 24;\n\n return (\n \n \n ({\n opacity: 0,\n x: dir * offset,\n filter: reduce ? \"blur(0px)\" : \"blur(4px)\",\n }),\n center: {\n opacity: 1,\n x: 0,\n filter: \"blur(0px)\",\n transition: { duration: 0.26, ease: EASE_OUT },\n },\n exit: (dir: number) => ({\n opacity: 0,\n x: dir * -offset,\n filter: reduce ? \"blur(0px)\" : \"blur(4px)\",\n transition: { duration: 0.16, ease: EASE_OUT },\n }),\n }}\n initial=\"enter\"\n animate=\"center\"\n exit=\"exit\"\n className=\"outline-none\"\n >\n {panels[value]}\n \n \n \n );\n}\n\n// ── controls ───────────────────────────────────────────────────────────────\n\nexport interface StepperPreviousProps extends Omit {\n children?: ReactNode;\n}\n\n/** Goes back one step. Hidden from layout on the first step. */\nexport function StepperPrevious({\n children = \"Back\",\n className,\n variant = \"ghost\",\n ...props\n}: StepperPreviousProps) {\n const { isFirst, pending, previous } = useStepper();\n return (\n \n {children}\n \n );\n}\n\nexport interface StepperNextProps extends Omit {\n children?: ReactNode;\n /** Label on the last step. Default \"Finish\". */\n finishLabel?: ReactNode;\n}\n\n/** Advances through the step guard; on the last step it runs `onComplete`. */\nexport function StepperNext({\n children = \"Continue\",\n finishLabel = \"Finish\",\n ...props\n}: StepperNextProps) {\n const { isLast, pending, next } = useStepper();\n return (\n void next()}\n {...props}\n >\n {isLast ? finishLabel : children}\n \n );\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 { ButtonState, StatefulButtonProps } from \"./stateful\";\nexport { StatefulButton } from \"./stateful\";\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/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/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 { TOUCH_TARGET_CLASS } from \"@/lib/touch\";\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-primary/5\",\n outline:\n \"border border-border bg-transparent text-foreground hover:bg-primary/5\",\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/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":"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":"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 * Grow a small control's *hit area* to at least 44×44px (WCAG 2.5.5, Apple\n * HIG) on a coarse pointer, without changing what it looks like or the space\n * it takes in layout. An invisible `::after` box, centered on the control and\n * `max(100%, 2.75rem)` on each axis, catches the taps: a 32px icon button\n * reaches 6px past each edge, a wide 40px button only grows vertically, and a\n * control already 44px or larger is left as it is. Hit-testing a pseudo\n * element lands on its owner, so handlers, focus and `:active` all behave.\n *\n * Mouse and trackpad rendering is untouched — nothing here applies outside\n * `pointer: coarse`. Requirements on the element it goes on:\n * - It must be the containing block: add `relative` (and keep it mergeable, so\n * a consumer's `absolute` still wins through `cn`).\n * - It must not clip itself (`overflow-hidden`), or the overhang is clipped\n * away along with its hit area.\n * - It must render children: `` and other void elements have no\n * `::after`. Put it on the wrapper or label instead.\n * - It must not already use `::after` for something visible.\n *\n * Centered 44px means two 32px buttons with a 4px gap overlap by 8px; the\n * later one wins that strip, which still ends well short of the earlier\n * button's visual center. Below a ~32px pitch the later neighbour starts\n * eating into that center — use `TOUCH_TARGET_Y_CLASS` for such dense rows.\n *\n * The overhang is real geometry: inside a scroll container it counts as\n * scrollable overflow, so a control flush against a scroller's edge can add a\n * few pixels of scroll on touch screens. Give such a scroller a little padding\n * on that side.\n */\nexport const TOUCH_TARGET_CLASS =\n \"pointer-coarse:after:absolute pointer-coarse:after:top-1/2 pointer-coarse:after:left-1/2 pointer-coarse:after:size-[max(100%,2.75rem)] pointer-coarse:after:-translate-x-1/2 pointer-coarse:after:-translate-y-1/2 pointer-coarse:after:content-['']\";\n\n/**\n * `TOUCH_TARGET_CLASS` on the vertical axis only, for controls packed tighter\n * than ~32px apart in a row (pagination dots, dense swatches), where growing\n * sideways would hand most of each control to its neighbour. Same rules.\n */\nexport const TOUCH_TARGET_Y_CLASS =\n \"pointer-coarse:after:absolute pointer-coarse:after:inset-x-0 pointer-coarse:after:top-1/2 pointer-coarse:after:h-[max(100%,2.75rem)] pointer-coarse:after:-translate-y-1/2 pointer-coarse:after:content-['']\";\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"},{"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"}]}