{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "sound-pad",
  "title": "Sound Pad",
  "description": "A trigger pad with one-shot, toggle, hold and loop modes, a hotkey, playback progress and an accent colour, plus a grid with hotkeys and arrow navigation.",
  "dependencies": [
    "class-variance-authority"
  ],
  "registryDependencies": [
    "kbd",
    "@audiocn/core",
    "@audiocn/use-frame-source"
  ],
  "files": [
    {
      "path": "components/ui/sound-pad.tsx",
      "content": "\"use client\";\n\nimport { cva } from \"class-variance-authority\";\nimport type { VariantProps } from \"class-variance-authority\";\nimport {\n  createContext,\n  useCallback,\n  useContext,\n  useEffect,\n  useEffectEvent,\n  useMemo,\n  useRef,\n  useState,\n} from \"react\";\nimport type {\n  ComponentProps,\n  CSSProperties,\n  KeyboardEvent,\n  PointerEvent,\n} from \"react\";\n\nimport { Kbd } from \"@/components/ui/kbd\";\nimport { useFrameSource } from \"@/hooks/use-frame-source\";\nimport { clamp } from \"@/lib/audio/decibels\";\nimport type { FrameSource } from \"@/lib/audio/types\";\nimport { cn } from \"@/lib/utils\";\n\nexport type SoundPadMode = \"one-shot\" | \"toggle\" | \"hold\" | \"loop\";\n\ninterface PadHandlers {\n  press: () => void;\n  release: () => void;\n}\n\ninterface SoundPadGridContextValue {\n  hotkeys: boolean;\n  register: (hotkey: string, handlers: PadHandlers) => () => void;\n}\n\nconst SoundPadGridContext = createContext<SoundPadGridContextValue | null>(\n  null\n);\n\ninterface SoundPadContextValue {\n  hotkey?: string;\n  playing: boolean;\n}\n\nconst SoundPadContext = createContext<SoundPadContextValue>({ playing: false });\n\nconst isTyping = (target: EventTarget | null) =>\n  target instanceof HTMLElement &&\n  (target.isContentEditable ||\n    [\"INPUT\", \"SELECT\", \"TEXTAREA\"].includes(target.tagName));\n\nconst moveFocus = (event: KeyboardEvent<HTMLDivElement>) => {\n  // data-sound-pad, not data-slot: a trigger rendering the pad replaces its slot.\n  const pads = [\n    ...event.currentTarget.querySelectorAll<HTMLElement>(\"[data-sound-pad]\"),\n  ];\n  const index = pads.indexOf(event.target as HTMLElement);\n  if (index === -1) {\n    return;\n  }\n  const perRow = Math.max(\n    1,\n    pads.filter((pad) => pad.offsetTop === pads[0]?.offsetTop).length\n  );\n  const moves: Record<string, number> = {\n    ArrowDown: perRow,\n    ArrowLeft: -1,\n    ArrowRight: 1,\n    ArrowUp: -perRow,\n  };\n  const offset = moves[event.key];\n  if (offset === undefined) {\n    return;\n  }\n  const next = pads[clamp(index + offset, 0, pads.length - 1)];\n  if (next) {\n    event.preventDefault();\n    next.focus();\n  }\n};\n\nexport interface SoundPadGridProps extends ComponentProps<\"div\"> {\n  /**\n   * The most columns. The grid drops columns to keep pads at least\n   * `--pad-min-width` wide (default 5.5rem). Default 4.\n   */\n  columns?: number;\n  /** Listen for pad hotkeys. Default false. */\n  hotkeys?: boolean;\n  /** `global` listens on the whole page, never while typing. Default `focus`. */\n  hotkeyScope?: \"focus\" | \"global\";\n}\n\nexport const SoundPadGrid = ({\n  columns = 4,\n  hotkeys = false,\n  hotkeyScope = \"focus\",\n  className,\n  style,\n  onKeyDown,\n  onKeyUp,\n  ...props\n}: SoundPadGridProps) => {\n  const padsRef = useRef(new Map<string, PadHandlers>());\n  const heldRef = useRef(new Set<string>());\n\n  const register = useCallback((hotkey: string, handlers: PadHandlers) => {\n    const key = hotkey.toLowerCase();\n    padsRef.current.set(key, handlers);\n    return () => {\n      if (padsRef.current.get(key) === handlers) {\n        padsRef.current.delete(key);\n        // A pad going away (disabled, loading, unmounted) mid-hold won't see\n        // its keyup, so release it now.\n        if (heldRef.current.delete(key)) {\n          handlers.release();\n        }\n      }\n    };\n  }, []);\n\n  const handleDown = useCallback(\n    (key: string, repeat: boolean, target: EventTarget | null) => {\n      if (!hotkeys || repeat || isTyping(target)) {\n        return false;\n      }\n      const pad = padsRef.current.get(key.toLowerCase());\n      if (!pad) {\n        return false;\n      }\n      heldRef.current.add(key.toLowerCase());\n      pad.press();\n      return true;\n    },\n    [hotkeys]\n  );\n\n  const handleUp = useCallback((key: string) => {\n    const normalized = key.toLowerCase();\n    if (!heldRef.current.has(normalized)) {\n      return;\n    }\n    heldRef.current.delete(normalized);\n    padsRef.current.get(normalized)?.release();\n  }, []);\n\n  useEffect(() => {\n    if (!hotkeys || hotkeyScope !== \"global\") {\n      return;\n    }\n    const down = (event: globalThis.KeyboardEvent) => {\n      if (event.metaKey || event.ctrlKey || event.altKey) {\n        return;\n      }\n      if (handleDown(event.key, event.repeat, event.target)) {\n        event.preventDefault();\n      }\n    };\n    const up = (event: globalThis.KeyboardEvent) => {\n      handleUp(event.key);\n    };\n    const held = heldRef.current;\n    const pads = padsRef.current;\n    // Keyups never arrive once the window loses focus or this subscription\n    // ends, so release what is held then.\n    const releaseHeld = () => {\n      for (const key of held) {\n        pads.get(key)?.release();\n      }\n      held.clear();\n    };\n    document.addEventListener(\"keydown\", down);\n    document.addEventListener(\"keyup\", up);\n    window.addEventListener(\"blur\", releaseHeld);\n    return () => {\n      document.removeEventListener(\"keydown\", down);\n      document.removeEventListener(\"keyup\", up);\n      window.removeEventListener(\"blur\", releaseHeld);\n      releaseHeld();\n    };\n  }, [handleDown, handleUp, hotkeyScope, hotkeys]);\n\n  const contextValue = useMemo(\n    () => ({ hotkeys, register }),\n    [hotkeys, register]\n  );\n\n  return (\n    <SoundPadGridContext.Provider value={contextValue}>\n      <div\n        className={cn(\n          \"grid grid-cols-(--pad-columns) gap-(--pad-gap) [--pad-gap:0.5rem]\",\n          className\n        )}\n        data-slot=\"sound-pad-grid\"\n        onKeyDown={(event) => {\n          onKeyDown?.(event);\n          if (event.defaultPrevented) {\n            return;\n          }\n          const hotkeyPressed =\n            hotkeyScope === \"focus\" &&\n            !event.metaKey &&\n            !event.ctrlKey &&\n            !event.altKey &&\n            handleDown(event.key, event.repeat, event.target);\n          if (hotkeyPressed) {\n            event.preventDefault();\n            return;\n          }\n          moveFocus(event);\n        }}\n        onKeyUp={(event) => {\n          onKeyUp?.(event);\n          if (hotkeyScope === \"focus\") {\n            handleUp(event.key);\n          }\n        }}\n        role=\"group\"\n        style={\n          {\n            // Up to `columns` tracks, never narrower than --pad-min-width.\n            \"--pad-columns\": `repeat(auto-fill, minmax(max(var(--pad-min-width, 5.5rem), calc((100% - ${columns - 1} * var(--pad-gap)) / ${columns})), 1fr))`,\n            ...style,\n          } as CSSProperties\n        }\n        {...props}\n      />\n    </SoundPadGridContext.Provider>\n  );\n};\n\nconst soundPadVariants = cva(\n  \"group/sound-pad focus-visible:ring-ring/40 relative flex flex-col items-start justify-between gap-2 overflow-hidden rounded-xl p-3 text-left transition-[background-color,box-shadow,transform] outline-none select-none [--pad-accent:var(--primary)] focus-visible:ring-3 active:scale-[0.98] disabled:pointer-events-none disabled:opacity-50 data-loading:opacity-60 data-playing:ring-2 data-playing:ring-(--pad-accent)\",\n  {\n    defaultVariants: { size: \"default\", variant: \"default\" },\n    variants: {\n      size: {\n        default: \"min-h-24\",\n        lg: \"min-h-32 p-4\",\n        sm: \"min-h-16 p-2\",\n      },\n      variant: {\n        default:\n          \"bg-[color-mix(in_oklch,var(--pad-accent)_14%,var(--muted))] hover:bg-[color-mix(in_oklch,var(--pad-accent)_22%,var(--muted))]\",\n        ghost: \"hover:bg-muted\",\n        outline: \"hover:bg-muted border bg-transparent\",\n      },\n    },\n  }\n);\n\nexport interface SoundPadProps\n  extends\n    Omit<ComponentProps<\"button\">, \"onToggle\">,\n    VariantProps<typeof soundPadVariants> {\n  onTrigger?: () => void;\n  onStop?: () => void;\n  playing?: boolean;\n  /** How presses map to trigger and stop. Default `one-shot`. */\n  mode?: SoundPadMode;\n  /** Active when the grid enables hotkeys. */\n  hotkey?: string;\n  /** The sound is not ready yet. */\n  loading?: boolean;\n  /** A CSS colour for the pad. */\n  accent?: string;\n}\n\nexport const SoundPad = ({\n  onTrigger,\n  onStop,\n  playing = false,\n  mode = \"one-shot\",\n  hotkey,\n  loading = false,\n  accent,\n  variant = \"default\",\n  size = \"default\",\n  disabled,\n  className,\n  style,\n  onPointerDown,\n  onPointerUp,\n  onPointerLeave,\n  onClick,\n  onKeyDown,\n  onKeyUp,\n  children,\n  ...props\n}: SoundPadProps) => {\n  const grid = useContext(SoundPadGridContext);\n  const [pressed, setPressed] = useState(false);\n  const inactive = disabled || loading;\n\n  const press = () => {\n    setPressed(true);\n    if ((mode === \"toggle\" || mode === \"loop\") && playing) {\n      onStop?.();\n      return;\n    }\n    onTrigger?.();\n  };\n\n  const release = () => {\n    setPressed(false);\n    if (mode === \"hold\") {\n      onStop?.();\n    }\n  };\n\n  // The grid calls these from its own key listeners, so they read the\n  // latest props without re-registering on every render.\n  const pressFromHotkey = useEffectEvent(press);\n  const releaseFromHotkey = useEffectEvent(release);\n\n  useEffect(() => {\n    if (!(grid && hotkey) || inactive) {\n      return;\n    }\n    return grid.register(hotkey, {\n      press: () => {\n        pressFromHotkey();\n      },\n      release: () => {\n        releaseFromHotkey();\n      },\n    });\n  }, [grid, hotkey, inactive]);\n\n  const holding = mode === \"hold\";\n  const contextValue = useMemo(() => ({ hotkey, playing }), [hotkey, playing]);\n\n  return (\n    <SoundPadContext.Provider value={contextValue}>\n      <button\n        aria-keyshortcuts={hotkey}\n        aria-pressed={\n          mode === \"toggle\" || mode === \"loop\" ? playing : undefined\n        }\n        className={cn(soundPadVariants({ size, variant }), className)}\n        data-loading={loading ? \"\" : undefined}\n        data-mode={mode}\n        data-playing={playing ? \"\" : undefined}\n        data-pressed={pressed ? \"\" : undefined}\n        data-slot=\"sound-pad\"\n        data-sound-pad=\"\"\n        disabled={inactive}\n        onClick={(event) => {\n          onClick?.(event);\n          if (!holding && event.detail === 0) {\n            press();\n            setPressed(false);\n          }\n        }}\n        onKeyDown={(event) => {\n          onKeyDown?.(event);\n          if (\n            holding &&\n            (event.key === \" \" || event.key === \"Enter\") &&\n            !event.repeat\n          ) {\n            event.preventDefault();\n            press();\n          }\n        }}\n        onKeyUp={(event) => {\n          onKeyUp?.(event);\n          if (holding && (event.key === \" \" || event.key === \"Enter\")) {\n            release();\n          }\n        }}\n        onPointerDown={(event: PointerEvent<HTMLButtonElement>) => {\n          onPointerDown?.(event);\n          if (event.button === 0) {\n            press();\n          }\n        }}\n        onPointerLeave={(event) => {\n          onPointerLeave?.(event);\n          if (pressed) {\n            release();\n          }\n        }}\n        onPointerUp={(event) => {\n          onPointerUp?.(event);\n          release();\n        }}\n        style={\n          {\n            \"--pad-accent\": accent,\n            ...style,\n          } as CSSProperties\n        }\n        type=\"button\"\n        {...props}\n      >\n        {children}\n      </button>\n    </SoundPadContext.Provider>\n  );\n};\n\nexport const SoundPadIcon = ({\n  className,\n  ...props\n}: ComponentProps<\"span\">) => (\n  <span\n    aria-hidden\n    className={cn(\n      \"relative text-(--pad-accent) [&_svg:not([class*='size-'])]:size-5\",\n      className\n    )}\n    data-slot=\"sound-pad-icon\"\n    {...props}\n  />\n);\n\nexport const SoundPadLabel = ({\n  className,\n  ...props\n}: ComponentProps<\"span\">) => (\n  <span\n    className={cn(\n      \"relative mt-auto line-clamp-2 text-sm font-medium group-has-data-[variant=ring]/sound-pad:pe-6\",\n      className\n    )}\n    data-slot=\"sound-pad-label\"\n    {...props}\n  />\n);\n\nexport const SoundPadShortcut = ({\n  className,\n  children,\n  ...props\n}: ComponentProps<\"kbd\">) => {\n  const { hotkey } = useContext(SoundPadContext);\n  if (!(children || hotkey)) {\n    return null;\n  }\n  return (\n    <Kbd\n      className={cn(\"absolute top-2 right-2 uppercase\", className)}\n      data-slot=\"sound-pad-shortcut\"\n      {...props}\n    >\n      {children ?? hotkey}\n    </Kbd>\n  );\n};\n\nexport interface SoundPadProgressProps extends ComponentProps<\"div\"> {\n  /** 0..1, for declarative use. */\n  value?: number;\n  /** A smooth progress source with no React renders. */\n  source?: FrameSource<number> | null;\n  /** Default `bar`. */\n  variant?: \"bar\" | \"fill\" | \"ring\";\n}\n\nexport const SoundPadProgress = ({\n  value,\n  source,\n  variant = \"bar\",\n  className,\n  style,\n  ...props\n}: SoundPadProgressProps) => {\n  const elementRef = useRef<HTMLDivElement>(null);\n  const { playing } = useContext(SoundPadContext);\n\n  useFrameSource(source, (next) => {\n    elementRef.current?.style.setProperty(\n      \"--pad-progress\",\n      clamp(next, 0, 1).toFixed(4)\n    );\n  });\n\n  // A declarative value, or 0 once playback stops. While a source plays it\n  // stays undefined, so React leaves the source's per-frame writes alone.\n  let progress: string | undefined;\n  if (value !== undefined) {\n    progress = clamp(value, 0, 1).toFixed(4);\n  } else if (!playing) {\n    progress = \"0\";\n  }\n  const progressStyle = {\n    \"--pad-progress\": progress,\n    ...style,\n  } as CSSProperties;\n\n  if (variant === \"ring\") {\n    return (\n      <div\n        aria-hidden\n        className={cn(\n          \"pointer-events-none absolute right-2 bottom-2 size-5 [--pad-progress:0]\",\n          className\n        )}\n        data-slot=\"sound-pad-progress\"\n        data-variant={variant}\n        ref={elementRef}\n        style={progressStyle}\n        {...props}\n      >\n        <div className=\"size-full rounded-full bg-[conic-gradient(var(--pad-accent)_calc(var(--pad-progress)*360deg),color-mix(in_oklch,var(--pad-accent)_20%,transparent)_0)] [mask:radial-gradient(farthest-side,transparent_calc(100%-3px),black_calc(100%-3px))]\" />\n      </div>\n    );\n  }\n\n  return (\n    <div\n      aria-hidden\n      className={cn(\n        \"pointer-events-none absolute inset-x-0 bottom-0 [--pad-progress:0]\",\n        variant === \"fill\" ? \"top-0\" : \"h-1\",\n        className\n      )}\n      data-slot=\"sound-pad-progress\"\n      data-variant={variant}\n      ref={elementRef}\n      style={progressStyle}\n      {...props}\n    >\n      <div\n        className={cn(\n          \"size-full origin-left scale-x-(--pad-progress) bg-(--pad-accent)\",\n          variant === \"fill\" && \"opacity-20\"\n        )}\n      />\n    </div>\n  );\n};\n\nexport { soundPadVariants };\n",
      "type": "registry:ui"
    }
  ],
  "type": "registry:ui"
}