@cntyclub/ui-react 0.1.0

package/src/components/ui/tooltip.tsx

@@ -0,0 +1,102 @@
+"use client";
+
+import { Tooltip as TooltipPrimitive } from "@base-ui/react/tooltip";
+import type * as React from "react";
+
+import { cn } from "../../lib/utils/css";
+
+const TooltipCreateHandle = TooltipPrimitive.createHandle;
+
+const TooltipProvider = TooltipPrimitive.Provider;
+
+const Tooltip = TooltipPrimitive.Root;
+
+function TooltipTrigger(props: TooltipPrimitive.Trigger.Props) {
+  return <TooltipPrimitive.Trigger data-slot="tooltip-trigger" {...props} />;
+}
+
+function TooltipTitle({
+  className,
+  ...props
+}: React.HTMLAttributes<HTMLParagraphElement>) {
+  return (
+    <p
+      data-slot="tooltip-title"
+      className={cn("font-medium leading-snug", className)}
+      {...props}
+    />
+  );
+}
+
+function TooltipDescription({
+  className,
+  ...props
+}: React.HTMLAttributes<HTMLParagraphElement>) {
+  return (
+    <p
+      data-slot="tooltip-description"
+      className={cn("text-muted-foreground leading-snug", className)}
+      {...props}
+    />
+  );
+}
+
+function TooltipPopup({
+  className,
+  align = "center",
+  sideOffset = 4,
+  side = "top",
+  arrow = false,
+  children,
+  ...props
+}: TooltipPrimitive.Popup.Props & {
+  align?: TooltipPrimitive.Positioner.Props["align"];
+  side?: TooltipPrimitive.Positioner.Props["side"];
+  sideOffset?: TooltipPrimitive.Positioner.Props["sideOffset"];
+  arrow?: boolean;
+}) {
+  return (
+    <TooltipPrimitive.Portal>
+      <TooltipPrimitive.Positioner
+        align={align}
+        className="z-50 h-(--positioner-height) w-(--positioner-width) max-w-(--available-width) transition-[top,left,right,bottom,transform] data-instant:transition-none"
+        data-slot="tooltip-positioner"
+        side={side}
+        sideOffset={arrow ? (sideOffset as number) + 5 : sideOffset}
+      >
+        <TooltipPrimitive.Popup
+          className={cn(
+            "relative flex h-(--popup-height,auto) w-(--popup-width,auto) origin-(--transform-origin) text-balance rounded-md border bg-popover not-dark:bg-clip-padding text-popover-foreground text-xs shadow-md/5 transition-[width,height,scale,opacity] before:pointer-events-none before:absolute before:inset-0 before:rounded-[calc(var(--radius-md)-1px)] before:shadow-[0_1px_--theme(--color-black/6%)] data-ending-style:scale-98 data-starting-style:scale-98 data-ending-style:opacity-0 data-starting-style:opacity-0 data-instant:duration-0 dark:before:shadow-[0_-1px_--theme(--color-white/6%)]",
+            className,
+          )}
+          data-slot="tooltip-popup"
+          {...props}
+        >
+          <TooltipPrimitive.Viewport
+            className="relative size-full overflow-clip px-(--viewport-inline-padding) py-1 [--viewport-inline-padding:--spacing(2)] data-instant:transition-none **:data-current:data-ending-style:opacity-0 **:data-current:data-starting-style:opacity-0 **:data-previous:data-ending-style:opacity-0 **:data-previous:data-starting-style:opacity-0 **:data-current:w-[calc(var(--popup-width)-2*var(--viewport-inline-padding)-2px)] **:data-previous:w-[calc(var(--popup-width)-2*var(--viewport-inline-padding)-2px)] **:data-previous:truncate **:data-current:opacity-100 **:data-previous:opacity-100 **:data-current:transition-opacity **:data-previous:transition-opacity"
+            data-slot="tooltip-viewport"
+          >
+            {children}
+          </TooltipPrimitive.Viewport>
+          {arrow && (
+            <TooltipPrimitive.Arrow
+              data-slot="tooltip-arrow"
+              className="absolute block size-2.5 bg-popover data-[side=top]:[clip-path:polygon(0%_0%,100%_0%,50%_100%)] data-[side=bottom]:[clip-path:polygon(50%_0%,0%_100%,100%_100%)] data-[side=left]:[clip-path:polygon(0%_0%,100%_50%,0%_100%)] data-[side=right]:[clip-path:polygon(100%_0%,0%_50%,100%_100%)]"
+            />
+          )}
+        </TooltipPrimitive.Popup>
+      </TooltipPrimitive.Positioner>
+    </TooltipPrimitive.Portal>
+  );
+}
+
+export {
+  TooltipCreateHandle,
+  TooltipProvider,
+  Tooltip,
+  TooltipTrigger,
+  TooltipPopup,
+  TooltipPopup as TooltipContent,
+  TooltipTitle,
+  TooltipDescription,
+};

package/src/components/ui/vertical-scroll-fader.tsx

@@ -0,0 +1,250 @@
+"use client";
+
+import { Transition } from "@headlessui/react";
+import { Slot } from "@radix-ui/react-slot";
+import type React from "react";
+import {
+  createContext,
+  forwardRef,
+  useContext,
+  useEffect,
+  useMemo,
+  useRef,
+  useState,
+} from "react";
+import useResizeObserver from "use-resize-observer";
+import useCallbackRef from "../../lib/hooks/use-callback-ref";
+import { useHover } from "../../lib/hooks/use-hover";
+import { cn } from "../../lib/utils/css";
+import type { AsChildProps } from "../../types/helpers";
+
+interface VerticalScrollFaderContextValue {
+  isTopOverflowing: boolean;
+  isBottomOverflowing: boolean;
+  containerRef: React.RefObject<HTMLElement | null>;
+  onScroll: () => void;
+}
+
+const VerticalScrollFaderContext =
+  createContext<VerticalScrollFaderContextValue>({
+    isTopOverflowing: false,
+    isBottomOverflowing: false,
+    containerRef: { current: null },
+    onScroll: () => {},
+  });
+
+const getScrollDirection = (element: HTMLElement) =>
+  getComputedStyle(element).flexDirection === "column-reverse" ? -1 : 1;
+
+function VerticalScrollFaderInner(
+  { asChild, ...props }: AsChildProps<"div">,
+  ref: React.ForwardedRef<HTMLDivElement>,
+) {
+  const containerRef = useRef<HTMLElement>(null);
+
+  const [isTopOverflowing, setIsTopOverflowing] = useState(false);
+  const [isBottomOverflowing, setIsBottomOverflowing] = useState(false);
+
+  const onScroll = useCallbackRef(() => {
+    if (!containerRef.current) return;
+
+    const { scrollTop, scrollHeight, clientHeight } = containerRef.current;
+    const scrollDirection = getScrollDirection(containerRef.current!);
+    setIsTopOverflowing(
+      scrollDirection > 0
+        ? Math.floor(scrollTop - 1) > 0
+        : Math.round(-scrollTop + clientHeight + 1) < scrollHeight,
+    );
+    setIsBottomOverflowing(
+      scrollDirection > 0
+        ? Math.round(scrollTop + clientHeight + 1) < scrollHeight
+        : Math.floor(-scrollTop - 1) > 0,
+    );
+  });
+
+  const contextValue = useMemo(
+    () => ({ isTopOverflowing, isBottomOverflowing, containerRef, onScroll }),
+    [isTopOverflowing, isBottomOverflowing, onScroll],
+  );
+
+  const Comp = asChild ? Slot : "div";
+
+  return (
+    <VerticalScrollFaderContext.Provider value={contextValue}>
+      <Slot className="relative" onScroll={onScroll}>
+        <Comp ref={ref} {...props} />
+      </Slot>
+    </VerticalScrollFaderContext.Provider>
+  );
+}
+
+const VerticalScrollFader = forwardRef(VerticalScrollFaderInner);
+
+function VerticalScrollFaderContentInner(
+  {
+    asChild,
+    faderSize = "3rem",
+    showScrollbar,
+    ...props
+  }: AsChildProps<"div"> & {
+    faderSize?: string;
+    showScrollbar?: boolean;
+  },
+  ref: React.ForwardedRef<HTMLDivElement>,
+) {
+  const Comp = asChild ? Slot : "div";
+  const { isTopOverflowing, isBottomOverflowing, containerRef, onScroll } =
+    useContext(VerticalScrollFaderContext);
+
+  useResizeObserver({
+    ref: containerRef as React.RefObject<Element>,
+    onResize: onScroll,
+  });
+
+  // A single vertical mask gradient fades the top and bottom edges over their
+  // fader sizes. An edge that isn't overflowing has a 0 fader size, so it shows
+  // no fade. Inline styles (with -webkit- for Safari) keep this independent of
+  // Tailwind mask-utility emission.
+  const maskImage = `linear-gradient(to bottom, transparent 0, #000 var(--top-fader-size), #000 calc(100% - var(--bottom-fader-size)), transparent 100%)`;
+
+  return (
+    <Slot
+      onScroll={onScroll}
+      className={cn(
+        "overflow-auto [transition:--top-fader-size_150ms,--bottom-fader-size_150ms]",
+        !showScrollbar &&
+          "[scrollbar-width:none] [&::-webkit-scrollbar]:hidden",
+      )}
+      style={{
+        "--fader-size": faderSize,
+        "--top-fader-size": isTopOverflowing ? "var(--fader-size)" : "0rem",
+        "--bottom-fader-size": isBottomOverflowing
+          ? "var(--fader-size)"
+          : "0rem",
+        maskImage,
+        WebkitMaskImage: maskImage,
+      }}
+      ref={containerRef}
+    >
+      <Comp ref={ref} {...props} />
+    </Slot>
+  );
+}
+
+const VerticalScrollFaderContent = forwardRef(VerticalScrollFaderContentInner);
+
+function VerticalScrollFaderTopScrollerInner(
+  { asChild, ...props }: AsChildProps<"button">,
+  ref: React.ForwardedRef<HTMLButtonElement>,
+) {
+  const Comp = asChild ? Slot : "button";
+  const { containerRef, isTopOverflowing } = useContext(
+    VerticalScrollFaderContext,
+  );
+  const onClick = useCallbackRef(() => {
+    if (!containerRef.current) return;
+    containerRef.current.scrollBy({
+      top: -containerRef.current.clientHeight,
+      behavior: "smooth",
+    });
+  });
+
+  const [hoverRef, hovered] = useHover<HTMLElement>({
+    mounted: isTopOverflowing,
+  });
+  useEffect(() => {
+    if (!hovered || !isTopOverflowing) return;
+    let stopped = false;
+    let animationFrameId: number;
+    let startTime: DOMHighResTimeStamp;
+
+    const animate = (timestamp: DOMHighResTimeStamp) => {
+      if (stopped) return;
+      if (!startTime) startTime = timestamp;
+      const elapsed = Math.min(timestamp - startTime, 2000);
+      containerRef.current?.scrollBy({
+        top: -Math.log2(elapsed + 1),
+      });
+      animationFrameId = requestAnimationFrame(animate);
+    };
+    animationFrameId = requestAnimationFrame(animate);
+
+    return () => {
+      stopped = true;
+      cancelAnimationFrame(animationFrameId);
+    };
+  }, [hovered, isTopOverflowing, containerRef.current?.scrollBy]);
+
+  return (
+    <Transition show={isTopOverflowing}>
+      <Slot onClick={onClick} ref={hoverRef}>
+        <Comp {...(asChild ? {} : { type: "button" })} ref={ref} {...props} />
+      </Slot>
+    </Transition>
+  );
+}
+
+const VerticalScrollFaderTopScroller = forwardRef(
+  VerticalScrollFaderTopScrollerInner,
+);
+
+function VerticalScrollFaderBottomScrollerInner(
+  { asChild, ...props }: AsChildProps<"button">,
+  ref: React.ForwardedRef<HTMLButtonElement>,
+) {
+  const Comp = asChild ? Slot : "button";
+  const { containerRef, isBottomOverflowing } = useContext(
+    VerticalScrollFaderContext,
+  );
+  const onClick = useCallbackRef(() => {
+    if (!containerRef.current) return;
+    containerRef.current.scrollBy({
+      top: containerRef.current.clientHeight,
+      behavior: "smooth",
+    });
+  });
+  const [hoverRef, hovered] = useHover({
+    mounted: isBottomOverflowing,
+  });
+  useEffect(() => {
+    if (!hovered || !isBottomOverflowing) return;
+    let stopped = false;
+    let animationFrameId: number;
+    let startTime: DOMHighResTimeStamp;
+
+    const animate = (timestamp: DOMHighResTimeStamp) => {
+      if (stopped) return;
+      if (!startTime) startTime = timestamp;
+      const elapsed = Math.min(timestamp - startTime, 2000);
+      containerRef.current?.scrollBy({
+        top: Math.log2(elapsed + 1),
+      });
+      animationFrameId = requestAnimationFrame(animate);
+    };
+    animationFrameId = requestAnimationFrame(animate);
+
+    return () => {
+      stopped = true;
+      cancelAnimationFrame(animationFrameId);
+    };
+  }, [hovered, isBottomOverflowing, containerRef.current?.scrollBy]);
+
+  return (
+    <Transition show={isBottomOverflowing}>
+      <Slot onClick={onClick} ref={hoverRef}>
+        <Comp {...(asChild ? {} : { type: "button" })} ref={ref} {...props} />
+      </Slot>
+    </Transition>
+  );
+}
+
+const VerticalScrollFaderBottomScroller = forwardRef(
+  VerticalScrollFaderBottomScrollerInner,
+);
+
+export {
+  VerticalScrollFader,
+  VerticalScrollFaderContent,
+  VerticalScrollFaderTopScroller,
+  VerticalScrollFaderBottomScroller,
+};

package/src/components/ui/video-player.tsx

@@ -0,0 +1,275 @@
+"use client";
+
+import { cva, type VariantProps } from "class-variance-authority";
+import {
+  Maximize2Icon,
+  Minimize2Icon,
+  PauseIcon,
+  PlayIcon,
+  Volume2Icon,
+  VolumeXIcon,
+} from "lucide-react";
+import * as React from "react";
+
+import { cn } from "../../lib/utils/css";
+
+const videoPlayerVariants = cva(
+  "group relative overflow-hidden rounded-2xl bg-black ring-1 ring-inset ring-white/10",
+  {
+    defaultVariants: { size: "md" },
+    variants: {
+      size: {
+        sm: "w-full max-w-xs",
+        md: "w-full max-w-lg",
+        lg: "w-full max-w-2xl",
+      },
+    },
+  },
+);
+
+interface VideoPlayerProps
+  extends Omit<React.ComponentProps<"div">, "title">,
+    VariantProps<typeof videoPlayerVariants> {
+  src: string;
+  poster?: string;
+  title?: string;
+  autoPlay?: boolean;
+  loop?: boolean;
+}
+
+function VideoPlayer({
+  className,
+  size,
+  src,
+  poster,
+  title,
+  autoPlay = false,
+  loop = false,
+  ...props
+}: VideoPlayerProps) {
+  const containerRef = React.useRef<HTMLDivElement>(null);
+  const videoRef = React.useRef<HTMLVideoElement>(null);
+  const hideTimerRef = React.useRef<ReturnType<typeof setTimeout> | null>(null);
+
+  const [playing, setPlaying] = React.useState(false);
+  const [currentTime, setCurrentTime] = React.useState(0);
+  const [duration, setDuration] = React.useState(0);
+  const [muted, setMuted] = React.useState(false);
+  const [fullscreen, setFullscreen] = React.useState(false);
+  const [controlsVisible, setControlsVisible] = React.useState(true);
+
+  const clearHideTimer = () => {
+    if (hideTimerRef.current) clearTimeout(hideTimerRef.current);
+  };
+
+  const scheduleHide = React.useCallback(() => {
+    clearHideTimer();
+    hideTimerRef.current = setTimeout(() => setControlsVisible(false), 2500);
+  }, []);
+
+  React.useEffect(() => () => clearHideTimer(), []);
+
+  React.useEffect(() => {
+    if (!playing) {
+      clearHideTimer();
+      setControlsVisible(true);
+    }
+  }, [playing]);
+
+  React.useEffect(() => {
+    const handler = () => setFullscreen(!!document.fullscreenElement);
+    document.addEventListener("fullscreenchange", handler);
+    return () => document.removeEventListener("fullscreenchange", handler);
+  }, []);
+
+  const handleMouseMove = () => {
+    setControlsVisible(true);
+    if (playing) scheduleHide();
+  };
+
+  const handleMouseLeave = () => {
+    if (playing) setControlsVisible(false);
+  };
+
+  const togglePlay = () => {
+    const v = videoRef.current;
+    if (!v) return;
+    if (v.paused) {
+      v.play();
+    } else {
+      v.pause();
+    }
+  };
+
+  const handleSeek = (e: React.ChangeEvent<HTMLInputElement>) => {
+    const v = videoRef.current;
+    if (!v) return;
+    const t = Number(e.target.value);
+    v.currentTime = t;
+    setCurrentTime(t);
+  };
+
+  const toggleMute = () => {
+    const v = videoRef.current;
+    if (!v) return;
+    v.muted = !v.muted;
+    setMuted(v.muted);
+  };
+
+  const toggleFullscreen = () => {
+    const el = containerRef.current;
+    if (!el) return;
+    if (!document.fullscreenElement) {
+      el.requestFullscreen().catch(() => {});
+    } else {
+      document.exitFullscreen().catch(() => {});
+    }
+  };
+
+  const formatTime = (s: number) => {
+    if (!isFinite(s) || s < 0) return "0:00";
+    const m = Math.floor(s / 60);
+    const sec = Math.floor(s % 60);
+    return `${m}:${sec.toString().padStart(2, "0")}`;
+  };
+
+  const progress = duration > 0 ? (currentTime / duration) * 100 : 0;
+
+  return (
+    <div
+      ref={containerRef}
+      className={cn(videoPlayerVariants({ size }), className)}
+      data-slot="video-player"
+      onMouseLeave={handleMouseLeave}
+      onMouseMove={handleMouseMove}
+      {...props}
+    >
+      {/* Video */}
+      <video
+        ref={videoRef}
+        autoPlay={autoPlay}
+        className="aspect-video w-full object-cover"
+        loop={loop}
+        playsInline
+        poster={poster}
+        src={src}
+        onEnded={() => setPlaying(false)}
+        onLoadedMetadata={() => {
+          const v = videoRef.current;
+          if (v) setDuration(v.duration);
+        }}
+        onPause={() => setPlaying(false)}
+        onPlay={() => {
+          setPlaying(true);
+          scheduleHide();
+        }}
+        onTimeUpdate={() => {
+          const v = videoRef.current;
+          if (v) setCurrentTime(v.currentTime);
+        }}
+        onClick={togglePlay}
+      />
+
+      {/* Center play overlay — visible when paused */}
+      {!playing && (
+        <button
+          className="absolute inset-0 flex cursor-pointer items-center justify-center bg-black/20"
+          data-slot="video-player-overlay"
+          type="button"
+          onClick={togglePlay}
+        >
+          <span className="flex size-14 items-center justify-center rounded-full bg-white/90 text-black shadow-lg ring-1 ring-inset ring-white/20 backdrop-blur-sm transition-transform hover:scale-105">
+            <PlayIcon className="size-5 translate-x-0.5" />
+          </span>
+        </button>
+      )}
+
+      {/* Controls */}
+      <div
+        className={cn(
+          "absolute inset-x-0 bottom-0 flex flex-col gap-2 bg-gradient-to-t from-black/70 via-black/30 to-transparent px-3 pb-3 pt-10 transition-opacity duration-200",
+          controlsVisible ? "opacity-100" : "opacity-0",
+        )}
+        data-slot="video-player-controls"
+      >
+        {/* Scrubber */}
+        <div className="relative flex items-center">
+          <div className="relative h-1 w-full overflow-hidden rounded-full bg-white/25">
+            <div
+              className="pointer-events-none h-full rounded-full bg-white"
+              style={{ width: `${progress}%` }}
+            />
+          </div>
+          <input
+            aria-label="Seek"
+            className="absolute inset-0 h-full w-full cursor-pointer opacity-0"
+            max={duration || 100}
+            min={0}
+            step={0.1}
+            type="range"
+            value={currentTime}
+            onChange={handleSeek}
+          />
+        </div>
+
+        {/* Button row */}
+        <div className="flex items-center justify-between gap-2">
+          <div className="flex items-center gap-0.5">
+            <button
+              aria-label={playing ? "Pause" : "Play"}
+              className="flex size-7 items-center justify-center rounded-md text-white/80 transition-colors hover:bg-white/10 hover:text-white"
+              type="button"
+              onClick={togglePlay}
+            >
+              {playing ? (
+                <PauseIcon className="size-4" />
+              ) : (
+                <PlayIcon className="size-4" />
+              )}
+            </button>
+
+            <button
+              aria-label={muted ? "Unmute" : "Mute"}
+              className="flex size-7 items-center justify-center rounded-md text-white/80 transition-colors hover:bg-white/10 hover:text-white"
+              type="button"
+              onClick={toggleMute}
+            >
+              {muted ? (
+                <VolumeXIcon className="size-4" />
+              ) : (
+                <Volume2Icon className="size-4" />
+              )}
+            </button>
+
+            <span className="select-none pl-1 text-[11px] tabular-nums text-white/60">
+              {formatTime(currentTime)} / {formatTime(duration)}
+            </span>
+          </div>
+
+          <div className="flex items-center gap-1.5">
+            {title ? (
+              <span className="max-w-28 truncate text-[11px] font-medium text-white/50">
+                {title}
+              </span>
+            ) : null}
+
+            <button
+              aria-label={fullscreen ? "Exit fullscreen" : "Enter fullscreen"}
+              className="flex size-7 items-center justify-center rounded-md text-white/80 transition-colors hover:bg-white/10 hover:text-white"
+              type="button"
+              onClick={toggleFullscreen}
+            >
+              {fullscreen ? (
+                <Minimize2Icon className="size-4" />
+              ) : (
+                <Maximize2Icon className="size-4" />
+              )}
+            </button>
+          </div>
+        </div>
+      </div>
+    </div>
+  );
+}
+
+export { VideoPlayer, videoPlayerVariants };