{"$schema":"https://ui.shadcn.com/schema/registry-item.json","name":"textarea","type":"registry:component","title":"Textarea","description":"A text box that eases to the height of what you write, scrolls with its own thin thumb and faded edges, and turns into a composer with tools, a send button and ⌘↵.","author":"Hairline UI","dependencies":[],"registryDependencies":["https://hairlineui.com/r/number-roll.json?as=dependency"],"files":[{"path":"registry/textarea.tsx","type":"registry:component","content":"// Hairline UI · textarea · MIT License\n// Copyright (c) 2026 Hairline UI · https://hairlineui.com/license#components\n\n\"use client\";\n\nimport * as React from \"react\";\nimport { Field, fieldSurface, useFieldIds, useShake } from \"./field\";\nimport { NumberRoll } from \"./number-roll\";\nimport { EASE_OUT, useInteractionReducedMotion } from \"./ui-interaction-motion\";\n\n/* ─────────────────────────────────────────────────────────\n * TEXTAREA: grows with what you write\n *\n *   grow     a hidden copy of the text is measured and the box\n *            eases to its height, between minRows and maxRows,\n *            then scrolls; it never snaps a line taller\n *   scroll   past maxRows the browser's scrollbar never shows:\n *            lines fade out at the top and bottom edges instead of\n *            being sliced, and a 3px thumb inside the padding\n *            shows where you are while you scroll, then fades;\n *            it can be dragged\n *   compose  `footer` (tools) and `action` (send) sit inside the box;\n *            `onSubmit` sends on ⌘↵ / Ctrl+Enter, with the hint rising\n *            in beside the action once there's something to send\n *   count    with maxLength, the count rolls as you type and turns\n *            amber in the last tenth, red at the limit\n *   error    same as every field: red line, hint gives way, shake\n *\n * Text is 16px on phones so iOS never zooms the page on focus.\n * ───────────────────────────────────────────────────────── */\n\nexport interface TextareaProps extends Omit<React.TextareaHTMLAttributes<HTMLTextAreaElement>, \"onSubmit\"> {\n  label?: React.ReactNode;\n  hint?: React.ReactNode;\n  error?: React.ReactNode;\n  minRows?: number;\n  maxRows?: number;\n  /** Show \"12 / 280\" beside the label when maxLength is set. */\n  showCount?: boolean;\n  /** Tools inside the box, under the text on the left (attach, emoji). */\n  footer?: React.ReactNode;\n  /** The main action inside the box on the right (send). */\n  action?: React.ReactNode;\n  /** ⌘↵ / Ctrl+Enter calls this with the text. */\n  onSubmit?: (value: string) => void;\n  onValueChange?: (value: string) => void;\n  ref?: React.Ref<HTMLTextAreaElement>;\n  className?: string;\n  textareaClassName?: string;\n}\n\nconst TYPE = \"px-4 py-[9px] text-[16px] leading-[1.5] sm:text-[13.5px] sm:leading-[1.55]\";\nconst FADE = 14;\n\nconst subscribeNoop = () => () => {};\nconst isMac = () => /Mac|iPhone|iPad/.test(navigator.platform);\n\nexport function Textarea({\n  label,\n  hint,\n  error,\n  minRows = 3,\n  maxRows = 10,\n  showCount = true,\n  footer,\n  action,\n  onSubmit,\n  onValueChange,\n  ref,\n  id,\n  className = \"\",\n  textareaClassName = \"\",\n  value,\n  defaultValue,\n  onChange,\n  onKeyDown,\n  onFocus,\n  onBlur,\n  maxLength,\n  disabled,\n  required,\n  ...props\n}: TextareaProps) {\n  const reduced = useInteractionReducedMotion();\n  const ids = useFieldIds(id);\n  const mac = React.useSyncExternalStore(subscribeNoop, isMac, () => true);\n  const [text, setText] = React.useState(String(defaultValue ?? \"\"));\n  const current = value !== undefined ? String(value) : text;\n  const mirror = React.useRef<HTMLDivElement>(null);\n  const area = React.useRef<HTMLTextAreaElement>(null);\n  const thumb = React.useRef<HTMLSpanElement>(null);\n  const [height, setHeight] = React.useState<number | null>(null);\n  const [overflows, setOverflows] = React.useState(false);\n  const [focused, setFocused] = React.useState(false);\n  const fadeTimer = React.useRef(0);\n  const drag = React.useRef<{ y: number; top: number } | null>(null);\n  const shakeRef = useShake<HTMLDivElement>(!!error);\n\n  // Height from the mirror, in whole lines between minRows and maxRows (line metrics read from CSS, so\n  // the 16px phone type and the 13.5px desktop type both measure right).\n  React.useLayoutEffect(() => {\n    const el = mirror.current;\n    if (!el) return;\n    const measure = () => {\n      const style = getComputedStyle(el);\n      const line = parseFloat(style.lineHeight) || 21;\n      const pad = parseFloat(style.paddingTop) + parseFloat(style.paddingBottom);\n      const next = Math.round(Math.min(maxRows * line + pad, Math.max(minRows * line + pad, el.offsetHeight)));\n      setHeight((h) => (h === next ? h : next));\n      setOverflows((o) => (o === el.offsetHeight > maxRows * line + pad + 1 ? o : !o));\n    };\n    measure();\n    const ro = new ResizeObserver(measure);\n    ro.observe(el);\n    return () => ro.disconnect();\n  }, [current, minRows, maxRows]);\n\n  // Edge fades and thumb, written straight to the elements: no render per scroll frame.\n  const paint = React.useCallback(\n    (show: boolean) => {\n      const el = area.current;\n      const t = thumb.current;\n      if (!el) return;\n      const max = el.scrollHeight - el.clientHeight;\n      const top = max > 1 ? Math.min(FADE, el.scrollTop) : 0;\n      const bottom = max > 1 ? Math.min(FADE, max - el.scrollTop) : 0;\n      const mask = `linear-gradient(to bottom, transparent 0, #000 ${top}px, #000 calc(100% - ${bottom}px), transparent 100%)`;\n      el.style.maskImage = mask;\n      el.style.webkitMaskImage = mask;\n      if (!t) return;\n      if (max <= 1) {\n        t.style.opacity = \"0\";\n        return;\n      }\n      const track = el.clientHeight - 12;\n      const size = Math.max(24, (el.clientHeight / el.scrollHeight) * track);\n      t.style.height = `${size}px`;\n      t.style.transform = `translateY(${6 + (el.scrollTop / max) * (track - size)}px)`;\n      if (show) {\n        t.style.opacity = \"1\";\n        window.clearTimeout(fadeTimer.current);\n        fadeTimer.current = window.setTimeout(() => {\n          if (!drag.current && thumb.current) thumb.current.style.opacity = \"0\";\n        }, 900);\n      }\n    },\n    [],\n  );\n\n  React.useEffect(() => () => window.clearTimeout(fadeTimer.current), []);\n  React.useLayoutEffect(() => paint(false), [paint, height, current]);\n\n  const setRefs = (el: HTMLTextAreaElement | null) => {\n    area.current = el;\n    if (typeof ref === \"function\") ref(el);\n    else if (ref) (ref as React.RefObject<HTMLTextAreaElement | null>).current = el;\n  };\n\n  const count = current.length;\n  const near = maxLength ? count >= maxLength * 0.9 : false;\n  const full = maxLength ? count >= maxLength : false;\n  const describedBy = [hint && !error ? ids.hint : null, error ? ids.error : null].filter(Boolean).join(\" \") || undefined;\n  const canSend = !!onSubmit && focused && current.trim().length > 0;\n\n  return (\n    <Field\n      id={ids.id}\n      label={label}\n      hint={hint}\n      error={error}\n      required={required}\n      className={className}\n      aside={\n        maxLength && showCount ? (\n          <span className={full ? \"text-red-600 dark:text-red-400\" : near ? \"text-amber-600 dark:text-amber-400\" : \"\"} style={{ transition: \"color 200ms\" }}>\n            <NumberRoll value={count} /> / {maxLength}\n          </span>\n        ) : undefined\n      }\n    >\n      <div ref={shakeRef} className={`${fieldSurface({ invalid: !!error, disabled, round: false })} flex-col items-stretch`}>\n        <div className=\"relative\">\n          {/* The measuring copy: same type and padding, never seen. */}\n          <div ref={mirror} aria-hidden=\"true\" className={`pointer-events-none invisible absolute inset-x-0 top-0 whitespace-pre-wrap break-words ${TYPE} ${textareaClassName}`}>\n            {current + \"​\"}\n          </div>\n          <textarea\n            ref={setRefs}\n            id={ids.id}\n            value={value}\n            defaultValue={defaultValue}\n            maxLength={maxLength}\n            disabled={disabled}\n            required={required}\n            aria-invalid={error ? true : undefined}\n            aria-describedby={describedBy}\n            aria-keyshortcuts={onSubmit ? \"Meta+Enter Control+Enter\" : undefined}\n            onChange={(e) => {\n              if (value === undefined) setText(e.target.value);\n              onChange?.(e);\n              onValueChange?.(e.target.value);\n            }}\n            onKeyDown={(e) => {\n              onKeyDown?.(e);\n              if (onSubmit && e.key === \"Enter\" && (e.metaKey || e.ctrlKey) && current.trim()) {\n                e.preventDefault();\n                onSubmit(current);\n              }\n            }}\n            onFocus={(e) => {\n              setFocused(true);\n              onFocus?.(e);\n            }}\n            onBlur={(e) => {\n              setFocused(false);\n              onBlur?.(e);\n            }}\n            onScroll={() => paint(true)}\n            style={{ height: height ?? undefined, transition: reduced ? \"none\" : `height 260ms ${EASE_OUT}` }}\n            className={`block w-full resize-none bg-transparent outline-none placeholder:text-muted-foreground/70 [scrollbar-width:none] [&::-webkit-scrollbar]:hidden ${overflows ? \"pr-6\" : \"\"} ${TYPE} ${textareaClassName}`}\n            {...props}\n          />\n          {/* Our scroll thumb: 3px, inside the padding, shown while scrolling; a wider strip takes the drag. */}\n          {overflows && (\n            <span\n              aria-hidden=\"true\"\n              className=\"absolute right-0 top-0 h-full w-4 touch-none\"\n              onPointerDown={(e) => {\n                const el = area.current;\n                if (!el) return;\n                e.preventDefault();\n                e.currentTarget.setPointerCapture(e.pointerId);\n                drag.current = { y: e.clientY, top: el.scrollTop };\n                paint(true);\n              }}\n              onPointerMove={(e) => {\n                const el = area.current;\n                const d = drag.current;\n                if (!el || !d) return;\n                const size = parseFloat(thumb.current?.style.height ?? \"24\");\n                const track = el.clientHeight - 12 - size;\n                el.scrollTop = d.top + ((e.clientY - d.y) / Math.max(1, track)) * (el.scrollHeight - el.clientHeight);\n              }}\n              onPointerUp={() => {\n                drag.current = null;\n                paint(true);\n              }}\n              onPointerCancel={() => {\n                drag.current = null;\n              }}\n            >\n              <span\n                ref={thumb}\n                className=\"absolute right-1.5 top-0 w-[3px] rounded-full bg-foreground/25 transition-[opacity,width] duration-300 hover:w-[5px] hover:bg-foreground/35\"\n                style={{ opacity: 0 }}\n              />\n            </span>\n          )}\n        </div>\n        {(footer || action || onSubmit) && (\n          <div className=\"flex min-h-10 items-center gap-2 px-2 pb-2\">\n            <div className=\"flex min-w-0 flex-1 items-center gap-1\">{footer}</div>\n            {onSubmit && (\n              <span\n                aria-hidden=\"true\"\n                className=\"hidden shrink-0 font-mono text-[11px] text-muted-foreground sm:inline\"\n                style={{ opacity: canSend ? 1 : 0, filter: canSend || reduced ? \"none\" : \"blur(3px)\", transition: reduced ? \"none\" : `opacity 200ms ${EASE_OUT}, filter 200ms ${EASE_OUT}` }}\n              >\n                {mac ? \"⌘↵\" : \"Ctrl ↵\"} to send\n              </span>\n            )}\n            {action}\n          </div>\n        )}\n      </div>\n    </Field>\n  );\n}\n\nexport default Textarea;\n"},{"path":"registry/field.tsx","type":"registry:component","content":"// Hairline UI · textarea · MIT License\n// Copyright (c) 2026 Hairline UI · https://hairlineui.com/license#components\n\n\"use client\";\n\nimport * as React from \"react\";\nimport { EASE_OUT, useInteractionReducedMotion } from \"./ui-interaction-motion\";\n\n/* ─────────────────────────────────────────────────────────\n * FIELD: the column every text control sits in\n *\n *   label    above, with an optional aside on the right (a count)\n *   hint     under the control while all is well\n *   error    takes the hint's place: the hint folds away, the\n *            error rises in out of a blur, the control shakes once\n *\n * Shared by input, textarea, password, search and select so the\n * whole family has one surface, one focus ring and one error.\n * ───────────────────────────────────────────────────────── */\n\nexport interface FieldProps {\n  id: string;\n  label?: React.ReactNode;\n  /** Right side of the label row, e.g. a character count. */\n  aside?: React.ReactNode;\n  hint?: React.ReactNode;\n  error?: React.ReactNode;\n  required?: boolean;\n  className?: string;\n  children: React.ReactNode;\n}\n\nexport type FieldSize = \"sm\" | \"md\";\n\n/** The surface of a text control: a hairline that darkens on hover and turns to the ring on focus. */\nexport function fieldSurface({ invalid, disabled, round = true }: { invalid?: boolean; disabled?: boolean; round?: boolean }) {\n  const ring = invalid\n    ? \"shadow-[inset_0_0_0_1px_color-mix(in_oklab,var(--color-red-500)_55%,transparent)] focus-within:shadow-[inset_0_0_0_1px_var(--color-red-500),0_0_0_3px_color-mix(in_oklab,var(--color-red-500)_14%,transparent)]\"\n    : \"shadow-[inset_0_0_0_1px_var(--border)] [&:not(:focus-within)]:hover:shadow-[inset_0_0_0_1px_color-mix(in_oklab,var(--foreground)_24%,var(--border))] focus-within:shadow-[inset_0_0_0_1px_var(--ring),0_0_0_3px_color-mix(in_oklab,var(--ring)_16%,transparent)]\";\n  return `relative flex w-full items-center bg-background text-foreground transition-[box-shadow,background-color,opacity] duration-200 ease-[cubic-bezier(0.16,1,0.3,1)] ${round ? \"rounded-full\" : \"rounded-[14px]\"} ${ring} ${\n    disabled ? \"pointer-events-none opacity-50\" : \"\"\n  }`;\n}\n\n/** ids for the control's label, hint and error. */\nexport function useFieldIds(id?: string) {\n  const auto = React.useId();\n  const base = id ?? auto;\n  return { id: base, hint: `${base}-hint`, error: `${base}-error` };\n}\n\n/** One short shake whenever `on` turns true (an error arrives). */\nexport function useShake<T extends HTMLElement>(on: boolean) {\n  const ref = React.useRef<T>(null);\n  const reduced = useInteractionReducedMotion();\n  React.useEffect(() => {\n    if (!on || reduced) return;\n    ref.current?.animate(\n      [{ transform: \"none\" }, { transform: \"translateX(-4px)\" }, { transform: \"translateX(4px)\" }, { transform: \"translateX(-2px)\" }, { transform: \"none\" }],\n      { duration: 380, easing: \"ease-out\" },\n    );\n  }, [on, reduced]);\n  return ref;\n}\n\n/** Sets a native input's value so React's onChange still fires (clear buttons, pickers). */\nexport function setNativeValue(el: HTMLInputElement | HTMLTextAreaElement, value: string) {\n  const proto = el instanceof HTMLTextAreaElement ? HTMLTextAreaElement.prototype : HTMLInputElement.prototype;\n  Object.getOwnPropertyDescriptor(proto, \"value\")?.set?.call(el, value);\n  el.dispatchEvent(new Event(\"input\", { bubbles: true }));\n}\n\n/** A line under the control that folds open and closed; keeps its last words while closing. */\nfunction Line({ show, children, id, tone, reduced }: { show: boolean; children: React.ReactNode; id: string; tone: string; reduced: boolean }) {\n  const [kept, setKept] = React.useState(children);\n  if (show && children !== kept) setKept(children);\n  return (\n    <div\n      className=\"grid\"\n      style={{ gridTemplateRows: show ? \"1fr\" : \"0fr\", transition: reduced ? \"none\" : `grid-template-rows 320ms ${EASE_OUT}` }}\n    >\n      <div className=\"min-h-0 overflow-hidden\">\n        <p\n          id={id}\n          className={`pt-1.5 pl-3 text-[12.5px] leading-snug ${tone}`}\n          style={{\n            opacity: show ? 1 : 0,\n            filter: show ? \"blur(0px)\" : \"blur(4px)\",\n            transform: show ? \"none\" : \"translateY(-4px)\",\n            transition: reduced ? \"none\" : show ? `opacity 280ms ${EASE_OUT} 60ms, filter 280ms ${EASE_OUT} 60ms, transform 380ms ${EASE_OUT}` : `opacity 140ms ${EASE_OUT}, filter 140ms ${EASE_OUT}, transform 200ms ${EASE_OUT}`,\n          }}\n        >\n          {show ? children : kept}\n        </p>\n      </div>\n    </div>\n  );\n}\n\nexport function Field({ id, label, aside, hint, error, required, className = \"\", children }: FieldProps) {\n  const reduced = useInteractionReducedMotion();\n  const ids = { hint: `${id}-hint`, error: `${id}-error` };\n  return (\n    <div className={`flex w-full flex-col ${className}`}>\n      {(label || aside) && (\n        <div className=\"flex items-baseline justify-between gap-3 px-3 pb-1.5\">\n          {label && (\n            <label htmlFor={id} className=\"text-[13px] font-medium text-foreground\">\n              {label}\n              {required && (\n                <span aria-hidden=\"true\" className=\"ml-0.5 text-muted-foreground\">\n                  *\n                </span>\n              )}\n            </label>\n          )}\n          {aside && <span className=\"text-[12px] tabular-nums text-muted-foreground\">{aside}</span>}\n        </div>\n      )}\n      {children}\n      <Line show={!error && !!hint} id={ids.hint} tone=\"text-muted-foreground\" reduced={reduced}>\n        {hint}\n      </Line>\n      <Line show={!!error} id={ids.error} tone=\"text-red-600 dark:text-red-400\" reduced={reduced}>\n        {error}\n      </Line>\n    </div>\n  );\n}\n\nexport default Field;\n"},{"path":"registry/ui-interaction-motion.ts","type":"registry:component","content":"// Hairline UI · textarea · MIT License\n// Copyright (c) 2026 Hairline UI · https://hairlineui.com/license#components\n\n'use client';\n\nimport * as React from 'react';\n\nexport const EASE_OUT = 'cubic-bezier(0.16, 1, 0.3, 1)';\nexport const EASE_SETTLE = 'cubic-bezier(0.22, 1.18, 0.36, 1)';\n/** Thrown things (indicators, thumbs): a slight overshoot on transform only. */\nexport const EASE_THROW = 'cubic-bezier(0.34, 1.36, 0.64, 1)';\n/**\n * The press every button primitive shares: a 3% give that eases in and settles back.\n * Tailwind v4's scale-* writes the `scale` property, so `scale` has to be in the list\n * or the press snaps.\n */\nexport const INTERACTION_PRESS =\n  'transition-[background-color,color,box-shadow,opacity,scale] duration-200 ease-[cubic-bezier(0.16,1,0.3,1)] active:scale-[0.97] motion-reduce:transition-none motion-reduce:active:scale-100';\nexport const INTERACTION_FOCUS ='focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring/50 focus-visible:ring-offset-2 focus-visible:ring-offset-background';\n\nconst query = '(prefers-reduced-motion: reduce)';\nconst subscribe = (notify: () => void) => {\n  const media = window.matchMedia(query);\n  media.addEventListener('change', notify);\n  return () => media.removeEventListener('change', notify);\n};\nexport const useInteractionReducedMotion = () => React.useSyncExternalStore(subscribe, () => window.matchMedia(query).matches, () => false);\n\nexport function useInteractionActivity<T extends Element>() {\n  const ref = React.useRef<T>(null);\n  const [visible, setVisible] = React.useState(false);\n  const [hidden, setHidden] = React.useState(false);\n  React.useEffect(() => {\n    const el = ref.current;\n    if (!el) return;\n    const observer = new IntersectionObserver(([entry]) => setVisible(entry.isIntersecting));\n    observer.observe(el);\n    const visibility = () => setHidden(document.hidden);\n    visibility(); document.addEventListener('visibilitychange', visibility);\n    return () => { observer.disconnect(); document.removeEventListener('visibilitychange', visibility); };\n  }, []);\n  return { ref, active: visible && !hidden };\n}\n\nexport function interactionIcon(on: boolean, reduced: boolean): React.CSSProperties {\n  return { opacity: on ? 1 : 0, transform: on ? 'none' : 'scale(0.6)', filter: on ? 'blur(0px)' : 'blur(3px)', transition: reduced ? 'none' : `opacity 220ms ${EASE_OUT}, transform 380ms ${EASE_OUT}, filter 220ms ${EASE_OUT}` };\n}\n\n/** A raised object: one tight contact shadow, one short ambient, a hairline of light on its top edge. */\nexport const MATERIAL_LIFT =\n  'shadow-[0_1px_1.5px_rgb(0_0_0/0.07),0_3px_8px_-2px_rgb(0_0_0/0.1),inset_0_0.5px_0_rgb(255_255_255/0.8)] dark:shadow-[0_1px_2px_rgb(0_0_0/0.5),0_4px_10px_-2px_rgb(0_0_0/0.35),inset_0_0.5px_0_rgb(255_255_255/0.1)]';\n/** A trough something sits in, shaded from above, lit along its bottom edge. */\nexport const MATERIAL_RECESS =\n  'shadow-[inset_0_1px_2.5px_rgb(0_0_0/0.09),inset_0_-0.5px_0_rgb(255_255_255/0.7)] dark:shadow-[inset_0_1px_3px_rgb(0_0_0/0.45),inset_0_-0.5px_0_rgb(255_255_255/0.07)]';\n\nexport type SpringConfig = { stiffness: number; damping: number; mass?: number };\nexport interface Spring {\n  get(): number;\n  getVelocity(): number;\n  getTarget(): number;\n  /** Aim somewhere new from wherever it is now, keeping its speed. */\n  set(target: number): void;\n  /** Add speed (units per second), on top of what it already has. */\n  push(velocity: number): void;\n  /** Be there now, at rest. */\n  jump(value: number): void;\n  configure(config: SpringConfig): void;\n  stop(): void;\n}\n\n// Every moving spring on the page shares one frame loop, which sleeps when the last one rests. Each spring's onFrame runs\n// once per frame after all of them have stepped, so several springs that draw one shape paint it once.\nconst SPRING_STEP = 1 / 240;\ntype Running = { step: () => void };\nconst runningSprings = new Set<Running>();\nconst springPainters = new Set<() => void>();\nlet springFrame = 0;\nlet springLast = 0;\nlet springSpare = 0;\n\nfunction springTick(now: number) {\n  // A hidden tab stops the frames, so the first one back must not count the whole gap as time passed.\n  springSpare += Math.min((now - springLast) / 1000, 0.05);\n  springLast = now;\n  while (springSpare >= SPRING_STEP) {\n    runningSprings.forEach((spring) => spring.step());\n    springSpare -= SPRING_STEP;\n  }\n  const painters = [...springPainters];\n  springPainters.clear();\n  painters.forEach((paint) => paint());\n  springFrame = runningSprings.size ? requestAnimationFrame(springTick) : 0;\n}\n\nfunction wakeSprings(spring: Running) {\n  runningSprings.add(spring);\n  if (springFrame) return;\n  springSpare = 0;\n  springFrame = requestAnimationFrame((now) => {\n    springLast = now - 1000 / 60;\n    springTick(now);\n  });\n}\n\n/**\n * A spring that carries its speed: re-aim it mid-flight and it curves on from where it is, push it while it swings and the\n * push adds to the swing. Use it for anything that can be interrupted; a curve restarts from a standstill every time.\n * `onFrame` should write straight to the DOM. `precision` is how close counts as there, in the value's own units.\n */\nexport function createSpring(initial: number, config: SpringConfig, onFrame: () => void, precision = 0.01): Spring {\n  let value = initial;\n  let velocity = 0;\n  let target = initial;\n  let { stiffness, damping, mass = 1 } = config;\n  const running: Running = {\n    step() {\n      velocity += ((-stiffness * (value - target) - damping * velocity) / mass) * SPRING_STEP;\n      value += velocity * SPRING_STEP;\n      if (Math.abs(value - target) < precision && Math.abs(velocity) < precision * 10) {\n        value = target;\n        velocity = 0;\n        runningSprings.delete(running);\n      }\n      springPainters.add(onFrame);\n    },\n  };\n  return {\n    get: () => value,\n    getVelocity: () => velocity,\n    getTarget: () => target,\n    set(next) {\n      if (next === target && !runningSprings.has(running)) return;\n      target = next;\n      wakeSprings(running);\n    },\n    push(speed) {\n      velocity += speed;\n      wakeSprings(running);\n    },\n    jump(next) {\n      value = next;\n      target = next;\n      velocity = 0;\n      runningSprings.delete(running);\n      onFrame();\n    },\n    configure(next) {\n      ({ stiffness, damping, mass = 1 } = next);\n    },\n    stop() {\n      runningSprings.delete(running);\n    },\n  };\n}\n\n/** Sample recent movement rather than averaging a long drag and losing its release velocity. */\nexport type PointerSample = { x: number; time: number };\nexport function samplePointer(samples: PointerSample[], x: number, time: number) {\n  samples.push({ x, time });\n  while (samples.length > 2 && time - samples[0].time > 100) samples.shift();\n}\nexport function releaseVelocity(samples: PointerSample[], now: number) {\n  if (samples.length < 2 || now - samples[samples.length - 1].time > 100) return 0;\n  const first = samples[0], last = samples[samples.length - 1];\n  return (last.x - first.x) / Math.max(1, last.time - first.time);\n}\n\n/** Smooth Apple/rational rubber-band curve: continuous exponential-like resistance without linear kinks. */\nexport function rubberBand(overshoot: number, dimension = 320, constant = 0.55): number {\n  const d = dimension || 320;\n  const abs = Math.abs(overshoot);\n  return Math.sign(overshoot) * (1 - 1 / ((abs * constant) / d + 1)) * d;\n}\n\n/** Projects resting travel from release velocity (velocity in px/ms; time in seconds). */\nexport function projectInertia(distance: number, velocity: number, time = 0.12): number {\n  return distance + velocity * 1000 * time;\n}\n\n/** Smooths incoming release velocity toward a boundary so springs don't slam or clip into walls. */\nexport function softenVelocity(velocity: number, distanceToTarget: number, factor = 10): number {\n  const maxAllowed = Math.abs(distanceToTarget) * factor;\n  return Math.sign(velocity) * Math.min(Math.abs(velocity), maxAllowed);\n}\n\n/** A damped spring sampled by WAAPI: tuned for organic lightness with a hint of life (3% breath). */\nexport function springFrames(\n  from: number,\n  to: number,\n  velocity = 0,\n  duration = 480,\n  config: { omega?: number; damping?: number; steps?: number } = {},\n) {\n  const { omega = 16, damping = 0.74, steps = 36 } = config;\n  const damped = omega * Math.sqrt(Math.max(0.001, 1 - damping * damping));\n  const displacement = from - to;\n  const coefficient = (velocity * 1000 + damping * omega * displacement) / damped;\n  return Array.from({ length: steps + 1 }, (_, i) => {\n    const t = (i / steps) * (duration / 1000);\n    const value = to + Math.exp(-damping * omega * t) * (displacement * Math.cos(damped * t) + coefficient * Math.sin(damped * t));\n    return { value: i === steps ? to : value, offset: i / steps };\n  });\n}\n\n"}],"css":{},"docs":"Docs and live preview: https://hairlineui.com/ui/textarea. MIT licensed: https://hairlineui.com/license#components","meta":{"license":"MIT"}}