{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "slider",
  "type": "registry:ui",
  "title": "Slider",
  "description": "Slider is a single-value control for selecting a number within min/max by dragging or keyboard-adjusting a thumb along a track.",
  "author": "Skrewww",
  "dependencies": [],
  "registryDependencies": [
    "@skrewww/foundation"
  ],
  "docs": "Host requirements (assumed already present, not installed by this command): react, react-dom.",
  "files": [
    {
      "path": "components/ui/Slider.tsx",
      "content": "/** @skrewww-component slider */\n\"use client\";\n\nimport {\n  useCallback,\n  useId,\n  useRef,\n  type CSSProperties,\n  type KeyboardEvent,\n  type PointerEvent as ReactPointerEvent,\n} from \"react\";\nimport { cn } from \"@/lib/cn\";\nimport { useControllableState } from \"@/lib/use-controllable\";\nimport styles from \"@/components/ui/slider.module.css\";\n\nexport type SliderProps = {\n  label: string;\n  value?: number;\n  defaultValue?: number;\n  onValueChange?: (value: number) => void;\n  min?: number;\n  max?: number;\n  step?: number;\n  disabled?: boolean;\n  id?: string;\n  className?: string;\n  \"aria-describedby\"?: string;\n};\n\nfunction clamp(n: number, min: number, max: number) {\n  return Math.min(Math.max(n, min), max);\n}\n\nfunction countDecimals(step: number) {\n  if (!Number.isFinite(step) || step <= 0) return 0;\n  const text = String(step);\n  const i = text.indexOf(\".\");\n  return i === -1 ? 0 : text.length - i - 1;\n}\n\nfunction snapToStep(raw: number, min: number, max: number, step: number) {\n  if (!Number.isFinite(step) || step <= 0) {\n    return clamp(raw, min, max);\n  }\n  const decimals = countDecimals(step);\n  const steps = Math.round((raw - min) / step);\n  const snapped = min + steps * step;\n  const rounded =\n    decimals > 0 ? Number(snapped.toFixed(decimals)) : Math.round(snapped);\n  return clamp(rounded, min, max);\n}\n\nexport function Slider({\n  label,\n  value,\n  defaultValue = 0,\n  onValueChange,\n  min = 0,\n  max = 100,\n  step = 1,\n  disabled = false,\n  id: idProp,\n  className,\n  \"aria-describedby\": ariaDescribedBy,\n}: SliderProps) {\n  const generatedId = useId();\n  const id = idProp ?? generatedId;\n  const labelId = `${id}-label`;\n  const controlRef = useRef<HTMLDivElement>(null);\n  const draggingRef = useRef(false);\n\n  const safeMin = Number.isFinite(min) ? min : 0;\n  const safeMax = Number.isFinite(max) && max > safeMin ? max : safeMin + 100;\n  const safeStep = Number.isFinite(step) && step > 0 ? step : 1;\n  const range = safeMax - safeMin;\n\n  const [current, setCurrent] = useControllableState({\n    value,\n    defaultValue: snapToStep(defaultValue, safeMin, safeMax, safeStep),\n    onChange: onValueChange,\n  });\n\n  const numeric = typeof current === \"number\" && Number.isFinite(current) ? current : safeMin;\n  const valueNow = snapToStep(numeric, safeMin, safeMax, safeStep);\n  const percent = range === 0 ? 0 : ((valueNow - safeMin) / range) * 100;\n\n  const commitFromClientX = useCallback(\n    (clientX: number) => {\n      const el = controlRef.current;\n      if (!el || disabled) return;\n      const rect = el.getBoundingClientRect();\n      if (rect.width <= 0) return;\n      const ratio = clamp((clientX - rect.left) / rect.width, 0, 1);\n      const next = snapToStep(safeMin + ratio * range, safeMin, safeMax, safeStep);\n      setCurrent(next);\n    },\n    [disabled, range, safeMax, safeMin, safeStep, setCurrent],\n  );\n\n  function handleKeyDown(event: KeyboardEvent<HTMLDivElement>) {\n    if (disabled) return;\n\n    const pageStep = Math.max(safeStep, (range / 10) || safeStep);\n    let next: number | null = null;\n\n    switch (event.key) {\n      case \"ArrowRight\":\n      case \"ArrowUp\":\n        next = snapToStep(valueNow + safeStep, safeMin, safeMax, safeStep);\n        break;\n      case \"ArrowLeft\":\n      case \"ArrowDown\":\n        next = snapToStep(valueNow - safeStep, safeMin, safeMax, safeStep);\n        break;\n      case \"Home\":\n        next = safeMin;\n        break;\n      case \"End\":\n        next = safeMax;\n        break;\n      case \"PageUp\":\n        next = snapToStep(valueNow + pageStep, safeMin, safeMax, safeStep);\n        break;\n      case \"PageDown\":\n        next = snapToStep(valueNow - pageStep, safeMin, safeMax, safeStep);\n        break;\n      default:\n        return;\n    }\n\n    event.preventDefault();\n    setCurrent(next);\n  }\n\n  function handlePointerDown(event: ReactPointerEvent<HTMLDivElement>) {\n    if (disabled) return;\n    // Ignore non-primary mouse buttons; allow touch/pen (button may be 0).\n    if (event.pointerType === \"mouse\" && event.button !== 0) return;\n    draggingRef.current = true;\n    if (typeof event.currentTarget.setPointerCapture === \"function\") {\n      event.currentTarget.setPointerCapture(event.pointerId);\n    }\n    commitFromClientX(event.clientX);\n  }\n\n  function handlePointerMove(event: ReactPointerEvent<HTMLDivElement>) {\n    if (!draggingRef.current || disabled) return;\n    commitFromClientX(event.clientX);\n  }\n\n  function handlePointerUp(event: ReactPointerEvent<HTMLDivElement>) {\n    if (!draggingRef.current) return;\n    draggingRef.current = false;\n    if (\n      typeof event.currentTarget.hasPointerCapture === \"function\" &&\n      event.currentTarget.hasPointerCapture(event.pointerId) &&\n      typeof event.currentTarget.releasePointerCapture === \"function\"\n    ) {\n      event.currentTarget.releasePointerCapture(event.pointerId);\n    }\n  }\n\n  return (\n    <div className={cn(styles.root, disabled && styles.rootDisabled, className)}>\n      <span id={labelId} className={cn(styles.label, disabled && styles.labelDisabled)}>\n        {label}\n      </span>\n      <div\n        ref={controlRef}\n        id={id}\n        role=\"slider\"\n        tabIndex={disabled ? -1 : 0}\n        aria-valuemin={safeMin}\n        aria-valuemax={safeMax}\n        aria-valuenow={valueNow}\n        aria-labelledby={labelId}\n        aria-describedby={ariaDescribedBy}\n        aria-disabled={disabled || undefined}\n        data-disabled={disabled ? \"\" : undefined}\n        className={styles.control}\n        style={\n          {\n            \"--slider-control-height\": \"1.5rem\",\n            \"--slider-track-height\": \"0.25rem\",\n            \"--slider-thumb-size\": \"1rem\",\n            \"--slider-thumb-stroke\": \"2px\",\n            \"--slider-fill-percent\": `${percent}%`,\n            \"--slider-thumb-left\": `${percent}%`,\n          } as CSSProperties\n        }\n        onKeyDown={handleKeyDown}\n        onPointerDown={handlePointerDown}\n        onPointerMove={handlePointerMove}\n        onPointerUp={handlePointerUp}\n        onPointerCancel={handlePointerUp}\n      >\n        <span className={styles.track} aria-hidden=\"true\" />\n        <span className={styles.fill} aria-hidden=\"true\" />\n        <span className={styles.thumb} aria-hidden=\"true\" />\n      </div>\n    </div>\n  );\n}\n",
      "type": "registry:ui",
      "target": "~/components/ui/Slider.tsx"
    },
    {
      "path": "components/ui/slider.module.css",
      "content": ".root {\n  display: flex;\n  flex-direction: column;\n  gap: 0.5rem;\n  width: 100%;\n  color: var(--semantic-text-primary);\n}\n\n.rootDisabled {\n  cursor: not-allowed;\n}\n\n.label {\n  font-size: 0.875rem;\n  font-weight: 500;\n  line-height: 1.4;\n}\n\n.labelDisabled {\n  opacity: var(--opacity-disabled);\n}\n\n.control {\n  position: relative;\n  box-sizing: border-box;\n  display: block;\n  width: 100%;\n  height: var(--slider-control-height);\n  margin: 0;\n  padding: 0;\n  border: none;\n  background: transparent;\n  cursor: pointer;\n  touch-action: none;\n  -webkit-tap-highlight-color: transparent;\n}\n\n.control[data-disabled] {\n  cursor: not-allowed;\n  opacity: var(--opacity-disabled);\n  pointer-events: none;\n}\n\n.control:focus {\n  outline: none;\n}\n\n.track {\n  position: absolute;\n  left: 0;\n  right: 0;\n  top: 50%;\n  height: var(--slider-track-height);\n  transform: translateY(-50%);\n  border-radius: 9999px;\n  background: var(--semantic-border-default);\n  pointer-events: none;\n}\n\n.fill {\n  position: absolute;\n  left: 0;\n  top: 50%;\n  height: var(--slider-track-height);\n  width: var(--slider-fill-percent);\n  max-width: 100%;\n  transform: translateY(-50%);\n  border-radius: 9999px;\n  background: var(--semantic-action-primary);\n  pointer-events: none;\n}\n\n.thumb {\n  position: absolute;\n  top: 50%;\n  left: var(--slider-thumb-left);\n  width: var(--slider-thumb-size);\n  height: var(--slider-thumb-size);\n  box-sizing: border-box;\n  border-radius: 50%;\n  border: var(--slider-thumb-stroke) solid var(--semantic-action-primary);\n  background: var(--semantic-surface-default);\n  box-shadow: 0 1px 2px rgb(0 0 0 / 0.15);\n  transform: translate(-50%, -50%);\n  pointer-events: none;\n}\n\n.control:hover:not([data-disabled]) .fill {\n  background: var(--semantic-action-primary-hover);\n}\n\n.control:hover:not([data-disabled]) .thumb {\n  border-color: var(--semantic-action-primary-hover);\n}\n\n.control:focus-visible .thumb {\n  border-color: var(--semantic-focus-ring);\n  outline: 2px solid var(--semantic-focus-ring);\n  outline-offset: 2px;\n}\n",
      "type": "registry:ui",
      "target": "~/components/ui/slider.module.css"
    },
    {
      "path": "lib/cn.ts",
      "content": "export function cn(...classes: Array<string | false | null | undefined>): string {\n  return classes.filter(Boolean).join(\" \");\n}\n",
      "type": "registry:lib",
      "target": "~/lib/cn.ts"
    },
    {
      "path": "lib/use-controllable.ts",
      "content": "import { useCallback, useEffect, useRef, useState } from \"react\";\n\nexport function useControllableState<T>({\n  value,\n  defaultValue,\n  onChange,\n  controlled: controlledProp,\n  valueProvided,\n}: {\n  value?: T;\n  defaultValue?: T;\n  onChange?: (next: T) => void;\n  /** Explicit controlled override — prefer `valueProvided` from the component root. */\n  controlled?: boolean;\n  /** True when the parent passed a `value` prop, including `undefined`. */\n  valueProvided?: boolean;\n}) {\n  const [uncontrolled, setUncontrolled] = useState(defaultValue as T);\n  const isControlled = controlledProp ?? valueProvided ?? value !== undefined;\n  const current = isControlled ? (value as T) : uncontrolled;\n  const wasControlledRef = useRef(isControlled);\n\n  useEffect(() => {\n    if (process.env.NODE_ENV !== \"development\") return;\n    if (wasControlledRef.current !== isControlled) {\n      console.warn(\n        \"[Skrewww] A component changed between controlled and uncontrolled modes. Keep `value` or `defaultValue` usage consistent across renders.\",\n      );\n    }\n    wasControlledRef.current = isControlled;\n  }, [isControlled]);\n\n  const setValue = useCallback(\n    (next: T) => {\n      if (!isControlled) setUncontrolled(next);\n      onChange?.(next);\n    },\n    [isControlled, onChange],\n  );\n\n  return [current, setValue] as const;\n}\n",
      "type": "registry:lib",
      "target": "~/lib/use-controllable.ts"
    }
  ]
}
