{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "sticky-scroll-cards",
  "title": "Sticky Scroll Cards",
  "description": "Scroll-pinned hero where a front card flips to reveal a stack of back cards, dismissed one at a time as you keep scrolling.",
  "dependencies": ["gsap", "@gsap/react"],
  "registryDependencies": ["@soralabs/lib-scroll-trigger-utils"],
  "files": [
    {
      "path": "registry/blocks/sticky-scroll-cards/index.tsx",
      "content": "\"use client\";\n\nimport { useGSAP } from \"@gsap/react\";\nimport { cn } from \"@/lib/utils\";\nimport { gsap } from \"gsap\";\nimport { ScrollTrigger } from \"gsap/ScrollTrigger\";\nimport { useMemo, useRef } from \"react\";\nimport type { CSSProperties, ReactNode } from \"react\";\n\nimport {\n  isWindowScroller,\n  observeWindowResize,\n  waitForScrollerReady,\n} from \"@/lib/scroll-trigger-utils\";\n\ngsap.registerPlugin(ScrollTrigger);\n\n/** Minimal layout defaults — typography and styling via `variant` or the `classNames` prop. */\nconst LAYOUT = {\n  root: \"relative h-svh w-full overflow-hidden\",\n  headline:\n    \"absolute inset-0 flex items-center justify-center text-center [will-change:transform]\",\n  cardsLayer:\n    \"absolute inset-0 h-full w-full overflow-hidden [perspective:1000px] [transform-style:preserve-3d]\",\n  card: \"absolute top-1/2 left-1/2 flex aspect-[4/5] w-1/4 min-w-[300px] -translate-x-1/2 flex-col items-center justify-between rounded-2xl p-8 text-center [backface-visibility:hidden] [will-change:transform]\",\n  front: \"\",\n  back: \"\",\n  frontIcon: \"flex size-16 items-center justify-center rounded-full\",\n  backIcon: \"flex size-20 items-center justify-center rounded-full\",\n  badge: \"rounded-md px-2 py-2 text-xs uppercase\",\n  title: \"font-black text-3xl uppercase leading-[0.85]\",\n  description: \"text-base leading-tight\",\n} as const;\n\nexport type StickyScrollCardsVariant = \"minimal\" | \"studio\";\n\n/** Structural-only preset for `variant=\"minimal\"`. Override slots via the `classNames` prop. */\nexport const STICKY_SCROLL_CARDS_MINIMAL_CLASSES = {\n  ...LAYOUT,\n  root: cn(LAYOUT.root, \"bg-background text-foreground\"),\n  front: \"bg-foreground text-background\",\n  back: \"bg-muted text-foreground\",\n  frontIcon: cn(LAYOUT.frontIcon, \"border-background/80 border-2\"),\n  backIcon: cn(LAYOUT.backIcon, \"bg-background/20\"),\n  badge: \"bg-background/90 text-foreground\",\n} as const;\n\n/** Codegrid \"MaximaTherapy\"–style palette, cycled across back cards. */\nconst STUDIO_PALETTE = [\n  { bg: \"#fd4400\", fg: \"#fff\" },\n  { bg: \"#e7ebdf\", fg: \"#0f0f0f\" },\n  { bg: \"#2668fd\", fg: \"#fff\" },\n  { bg: \"#fdcb40\", fg: \"#0f0f0f\" },\n] as const;\n\n/** Codegrid \"MaximaTherapy\" editorial layout — used by `variant=\"studio\"`. */\nexport const STICKY_SCROLL_CARDS_STUDIO_CLASSES = {\n  ...LAYOUT,\n  root: cn(LAYOUT.root, \"bg-[#fbfff2] text-[#0f0f0f]\"),\n  headline: cn(\n    LAYOUT.headline,\n    \"text-[clamp(3rem,5vw,7rem)] leading-[0.85] font-black uppercase\"\n  ),\n  front: \"bg-[#fd4400] text-white\",\n  back: \"\",\n  // Fixed, not inherited from the per-card cycled palette color: the back\n  // circle is always white, so the glyph needs a color that reads on white\n  // no matter which card's foreground happens to also be white.\n  frontIcon: cn(LAYOUT.frontIcon, \"border-2 border-white/90\"),\n  backIcon: cn(LAYOUT.backIcon, \"bg-white/90 text-[#fd4400]\"),\n  badge: \"bg-white text-[#0f0f0f]\",\n} as const;\n\nfunction studioCardColor(index: number): { bg: string; fg: string } {\n  return STUDIO_PALETTE[index % STUDIO_PALETTE.length];\n}\n\nexport interface StickyScrollCardsItem {\n  description: string;\n  icon?: ReactNode;\n  title: string;\n}\n\nexport interface StickyScrollCardsTiming {\n  /** Svh of scroll consumed dismissing one card. @default 500 */\n  cardDismissDuration?: number;\n  /** Svh where the front→back flip triggers. @default 1000 */\n  cardFlipTrigger?: number;\n  /** Svh where the enter phase finishes (cards/headline settle). @default 500 */\n  cardsEnterEnd?: number;\n  /** Svh where the flip-eligible window ends and dismissal begins. @default 1500 */\n  dismissStart?: number;\n  /** Rotation (deg) each back card ends at once fully dismissed, cycled by index. @default [-50, -60, -45, 50] */\n  dismissTiltAngles?: number[];\n  /** GSAP ease for the flip tween. @default \"elastic.out(1,0.5)\" */\n  flipEase?: string;\n  /** Rotation (deg) each back card settles at after the flip, cycled by index. @default [-10, -20, -5, 10] */\n  flipTiltAngles?: number[];\n}\n\nexport interface StickyScrollCardsClassNames {\n  back?: string;\n  backIcon?: string;\n  badge?: string;\n  cardsLayer?: string;\n  description?: string;\n  front?: string;\n  frontIcon?: string;\n  headline?: string;\n  title?: string;\n  track?: string;\n}\n\nexport interface StickyScrollCardsProps {\n  /** Front-only pill label (e.g. \"Start here\"). @default \"Start here\" */\n  badgeLabel?: string;\n  /** Back cards — revealed on flip, dismissed one at a time in reverse order. */\n  cards: StickyScrollCardsItem[];\n  className?: string;\n  /** Per-slot class overrides. `cn()` merges after built-ins/variant preset. */\n  classNames?: StickyScrollCardsClassNames;\n  /**\n   * Use container query height (`cqh`) instead of viewport height (`svh/dvh`)\n   * for embedded mode. Enable when the component lives inside a\n   * `container-type: size` ancestor (e.g. a preview panel).\n   * @default false\n   */\n  containerQuery?: boolean;\n  /** Blocks/docs preview — CSS sticky scroll track (no GSAP pin). */\n  embedded?: boolean;\n  /** Card shown before the flip. */\n  front: StickyScrollCardsItem;\n  /** Hero headline, scrolls out during the enter phase. */\n  headline: string;\n  /**\n   * GSAP ScrollTrigger refresh priority. Lower numbers refresh later.\n   * Set below any pinned section that appears earlier in the DOM to ensure\n   * their spacers are re-added before this trigger measures its position.\n   * @default -1\n   */\n  refreshPriority?: number;\n  /** Scroll container for ScrollTrigger. Defaults to `window`. */\n  scroller?: Element | Window;\n  timing?: StickyScrollCardsTiming;\n  /**\n   * Visual preset. `studio` applies the Codegrid \"MaximaTherapy\" palette\n   * (cycled per back card); `minimal` uses theme tokens (override via the\n   * `classNames` prop).\n   * @default \"minimal\"\n   */\n  variant?: StickyScrollCardsVariant;\n}\n\ninterface ResolvedTiming {\n  cardDismissDuration: number;\n  cardFlipTrigger: number;\n  cardsEnterEnd: number;\n  dismissStart: number;\n  dismissTiltAngles: number[];\n  flipEase: string;\n  flipTiltAngles: number[];\n}\n\nconst DEFAULT_FLIP_TILT = [-10, -20, -5, 10];\nconst DEFAULT_DISMISS_TILT = [-50, -60, -45, 50];\n\nfunction resolveTiming(timing?: StickyScrollCardsTiming): ResolvedTiming {\n  return {\n    cardsEnterEnd: timing?.cardsEnterEnd ?? 500,\n    cardFlipTrigger: timing?.cardFlipTrigger ?? 1000,\n    dismissStart: timing?.dismissStart ?? 1500,\n    cardDismissDuration: timing?.cardDismissDuration ?? 500,\n    flipTiltAngles: timing?.flipTiltAngles ?? DEFAULT_FLIP_TILT,\n    dismissTiltAngles: timing?.dismissTiltAngles ?? DEFAULT_DISMISS_TILT,\n    flipEase: timing?.flipEase ?? \"elastic.out(1,0.5)\",\n  };\n}\n\nfunction angleAt(angles: number[], index: number): number {\n  return angles[index % angles.length];\n}\n\nfunction resolveStickyScrollCardsClasses(\n  variant: StickyScrollCardsVariant,\n  className: string | undefined,\n  classNames: StickyScrollCardsClassNames | undefined\n) {\n  const preset =\n    variant === \"studio\"\n      ? STICKY_SCROLL_CARDS_STUDIO_CLASSES\n      : STICKY_SCROLL_CARDS_MINIMAL_CLASSES;\n\n  return {\n    root: cn(preset.root, className),\n    headline: cn(preset.headline, classNames?.headline),\n    cardsLayer: cn(preset.cardsLayer, classNames?.cardsLayer),\n    front: cn(LAYOUT.card, preset.front, classNames?.front),\n    back: cn(LAYOUT.card, preset.back, classNames?.back),\n    frontIcon: cn(preset.frontIcon, classNames?.frontIcon),\n    backIcon: cn(preset.backIcon, classNames?.backIcon),\n    badge: cn(LAYOUT.badge, preset.badge, classNames?.badge),\n    title: cn(LAYOUT.title, classNames?.title),\n    description: cn(LAYOUT.description, classNames?.description),\n    track: classNames?.track,\n  };\n}\n\nfunction getTotalScrollDistanceVh(\n  cardCount: number,\n  timing: ResolvedTiming\n): number {\n  return timing.dismissStart + cardCount * timing.cardDismissDuration;\n}\n\ninterface CardRefs {\n  backEls: HTMLElement[];\n  frontEl: HTMLElement;\n  headlineEl: HTMLElement | null;\n}\n\nfunction setInitialTransforms(refs: CardRefs) {\n  gsap.set(refs.frontEl, { rotationY: 0 });\n  gsap.set(refs.backEls, { rotationY: -180 });\n}\n\nfunction StickyScrollCard({\n  badge,\n  card,\n  iconClassName,\n  itemClassName,\n  refCallback,\n  style,\n  titleClassName,\n}: {\n  badge?: ReactNode;\n  card: StickyScrollCardsItem;\n  iconClassName: string;\n  itemClassName: string;\n  refCallback?: (el: HTMLDivElement | null) => void;\n  style?: CSSProperties;\n  titleClassName: string;\n}) {\n  return (\n    <div className={itemClassName} ref={refCallback} style={style}>\n      <h3 className={titleClassName}>{card.title}</h3>\n      {badge}\n      {card.icon ? <div className={iconClassName}>{card.icon}</div> : null}\n      <p>{card.description}</p>\n    </div>\n  );\n}\n\nexport function StickyScrollCards({\n  cards,\n  front,\n  headline,\n  badgeLabel = \"Start here\",\n  className,\n  classNames,\n  variant = \"minimal\",\n  embedded = false,\n  containerQuery = false,\n  scroller: scrollerProp,\n  refreshPriority = -1,\n  timing: timingProp,\n}: StickyScrollCardsProps) {\n  const classes = useMemo(\n    () => resolveStickyScrollCardsClasses(variant, className, classNames),\n    [variant, className, classNames]\n  );\n  const resolvedTiming = useMemo(() => resolveTiming(timingProp), [timingProp]);\n\n  const trackRef = useRef<HTMLDivElement>(null);\n  const sectionRef = useRef<HTMLElement>(null);\n  const headlineRef = useRef<HTMLDivElement>(null);\n  const frontRef = useRef<HTMLDivElement>(null);\n  const backRefs = useRef<(HTMLDivElement | null)[]>([]);\n\n  const cardCount = cards.length;\n  const totalScrollVh = useMemo(\n    () => getTotalScrollDistanceVh(cardCount, resolvedTiming),\n    [cardCount, resolvedTiming]\n  );\n\n  const hasCards = cardCount > 0;\n\n  useGSAP(\n    () => {\n      if (!hasCards) {\n        return;\n      }\n\n      // Client-only: gsap.ticker touches Date.now() internally, which Next's\n      // prerender flags if called at module scope. Without this, GSAP tries\n      // to \"catch up\" after main-thread jank by compressing elapsed time on\n      // the next tick — on a pinned, transform-heavy section like this one\n      // that reads as a sudden rush/jump into the next card.\n      gsap.ticker.lagSmoothing(0);\n\n      const scrollTriggerRoot = embedded\n        ? trackRef.current\n        : sectionRef.current;\n      if (!scrollTriggerRoot) {\n        return;\n      }\n\n      if (embedded && scrollerProp === undefined) {\n        if (process.env.NODE_ENV !== \"production\") {\n          console.warn(\n            \"[StickyScrollCards] embedded=true requires a `scroller` prop — animation will not mount without it.\"\n          );\n        }\n        return;\n      }\n\n      let disposed = false;\n      let trigger: ScrollTrigger | null = null;\n      let unbindResize: (() => void) | undefined;\n      let resizeObserver: ResizeObserver | undefined;\n\n      const mountCards = async () => {\n        const section = sectionRef.current;\n        const scrollRoot = embedded ? trackRef.current : sectionRef.current;\n        const headlineEl = headlineRef.current;\n        const frontEl = frontRef.current;\n        const backEls = backRefs.current.filter(\n          (el): el is HTMLDivElement => el !== null\n        );\n\n        if (\n          !(section && scrollRoot && frontEl) ||\n          backEls.length !== cardCount\n        ) {\n          return;\n        }\n\n        const scroller = scrollerProp ?? window;\n        await waitForScrollerReady(scroller);\n\n        if (disposed || sectionRef.current !== section) {\n          return;\n        }\n        if (embedded && trackRef.current !== scrollRoot) {\n          return;\n        }\n\n        const refs: CardRefs = { frontEl, backEls, headlineEl };\n        setInitialTransforms(refs);\n\n        const svhToProgress = (svh: number) => svh / totalScrollVh;\n        const enterEndProgress = svhToProgress(resolvedTiming.cardsEnterEnd);\n        const flipTriggerProgress = svhToProgress(\n          resolvedTiming.cardFlipTrigger\n        );\n\n        const dismissRanges = backEls.map((_, i) => {\n          const dismissOrder = cardCount - 1 - i;\n          return [\n            svhToProgress(\n              resolvedTiming.dismissStart +\n                dismissOrder * resolvedTiming.cardDismissDuration\n            ),\n            svhToProgress(\n              resolvedTiming.dismissStart +\n                (dismissOrder + 1) * resolvedTiming.cardDismissDuration\n            ),\n          ] as const;\n        });\n\n        let isFlipped = false;\n\n        const revealBackCards = () => {\n          gsap.to(frontEl, {\n            duration: 1,\n            ease: resolvedTiming.flipEase,\n            rotationY: 180,\n          });\n          for (const [i, el] of backEls.entries()) {\n            gsap.to(el, {\n              duration: 1,\n              ease: resolvedTiming.flipEase,\n              rotationY: 0,\n              rotationZ: angleAt(resolvedTiming.flipTiltAngles, i),\n            });\n          }\n        };\n\n        const concealBackCards = () => {\n          gsap.to(frontEl, {\n            duration: 1,\n            ease: resolvedTiming.flipEase,\n            rotationY: 0,\n          });\n          for (const el of backEls) {\n            gsap.to(el, {\n              duration: 1,\n              ease: resolvedTiming.flipEase,\n              rotationY: -180,\n              rotationZ: 0,\n            });\n          }\n        };\n\n        const onUpdate = (progress: number) => {\n          const enterProgress = gsap.utils.clamp(\n            0,\n            1,\n            gsap.utils.mapRange(0, enterEndProgress, 0, 1, progress)\n          );\n\n          gsap.set([frontEl, ...backEls], {\n            y: `${gsap.utils.mapRange(0, 1, 50, -50, enterProgress)}%`,\n          });\n          if (headlineEl) {\n            gsap.set(headlineEl, {\n              y: `${gsap.utils.mapRange(0, 1, 0, -100, enterProgress)}%`,\n            });\n          }\n\n          if (progress > flipTriggerProgress && !isFlipped) {\n            revealBackCards();\n            isFlipped = true;\n          } else if (progress <= flipTriggerProgress && isFlipped) {\n            concealBackCards();\n            isFlipped = false;\n          }\n\n          for (const [i, el] of backEls.entries()) {\n            const [dismissStartP, dismissEndP] = dismissRanges[i];\n            const dismissProgress = gsap.utils.clamp(\n              0,\n              1,\n              gsap.utils.mapRange(dismissStartP, dismissEndP, 0, 1, progress)\n            );\n\n            gsap.set(el, {\n              rotation: gsap.utils.mapRange(\n                0,\n                1,\n                angleAt(resolvedTiming.flipTiltAngles, i),\n                angleAt(resolvedTiming.dismissTiltAngles, i),\n                dismissProgress\n              ),\n              y: `${gsap.utils.mapRange(0, 1, -50, -250, dismissProgress)}%`,\n            });\n          }\n        };\n\n        const useWindowPin = isWindowScroller(scroller);\n\n        if (embedded) {\n          trigger = ScrollTrigger.create({\n            end: \"bottom bottom\",\n            invalidateOnRefresh: true,\n            onUpdate: (self) => onUpdate(self.progress),\n            refreshPriority: -1,\n            scroller,\n            scrub: 1,\n            start: \"top top\",\n            trigger: scrollRoot,\n          });\n        } else {\n          trigger = ScrollTrigger.create({\n            end: `+=${totalScrollVh}vh`,\n            invalidateOnRefresh: true,\n            onUpdate: (self) => onUpdate(self.progress),\n            pin: true,\n            pinReparent: !useWindowPin,\n            pinSpacing: true,\n            refreshPriority,\n            scroller,\n            scrub: 1,\n            start: \"top top\",\n            trigger: section,\n          });\n        }\n\n        if (scroller instanceof HTMLElement) {\n          resizeObserver = new ResizeObserver(() => {\n            ScrollTrigger.refresh();\n            trigger?.refresh();\n          });\n          resizeObserver.observe(scroller);\n        } else {\n          unbindResize = observeWindowResize(() => {\n            ScrollTrigger.refresh();\n            trigger?.refresh();\n          });\n        }\n\n        ScrollTrigger.refresh();\n        trigger.refresh();\n        onUpdate(trigger.progress);\n      };\n\n      void mountCards();\n\n      return () => {\n        disposed = true;\n        resizeObserver?.disconnect();\n        unbindResize?.();\n        trigger?.kill();\n        trigger = null;\n      };\n    },\n    {\n      dependencies: [\n        cards,\n        front,\n        headline,\n        embedded,\n        scrollerProp,\n        refreshPriority,\n        resolvedTiming,\n        totalScrollVh,\n        hasCards,\n      ],\n      scope: embedded ? trackRef : sectionRef,\n    }\n  );\n\n  const trackStyle = {\n    \"--ssc-scroll-vh\": totalScrollVh,\n  } as CSSProperties;\n\n  const cardsSection = (\n    <section\n      className={cn(\n        embedded ? \"relative h-full w-full overflow-hidden\" : classes.root\n      )}\n      ref={sectionRef}\n    >\n      <div className={classes.headline} ref={headlineRef}>\n        <h1 className=\"w-3/5 max-lg:w-[85%]\">{headline}</h1>\n      </div>\n\n      <div className={classes.cardsLayer}>\n        <StickyScrollCard\n          badge={<span className={classes.badge}>{badgeLabel}</span>}\n          card={front}\n          iconClassName={classes.frontIcon}\n          itemClassName={cn(classes.front, \"z-[1]\")}\n          refCallback={(el) => {\n            frontRef.current = el;\n          }}\n          titleClassName={classes.title}\n        />\n\n        {cards.map((card, index) => (\n          <StickyScrollCard\n            card={card}\n            iconClassName={classes.backIcon}\n            itemClassName={classes.back}\n            key={card.title}\n            refCallback={(el) => {\n              backRefs.current[index] = el;\n            }}\n            style={\n              variant === \"studio\"\n                ? {\n                    backgroundColor: studioCardColor(index).bg,\n                    color: studioCardColor(index).fg,\n                  }\n                : undefined\n            }\n            titleClassName={classes.title}\n          />\n        ))}\n      </div>\n    </section>\n  );\n\n  if (embedded) {\n    const trackHeightStyle: CSSProperties = containerQuery\n      ? { ...trackStyle, height: \"calc(var(--ssc-scroll-vh) * 1cqh)\" }\n      : trackStyle;\n    const stickyHeightStyle: CSSProperties = containerQuery\n      ? { height: \"100cqh\" }\n      : {};\n\n    return (\n      <div\n        className={cn(\n          \"relative w-full\",\n          !containerQuery &&\n            \"h-[calc(var(--ssc-scroll-vh)*1svh)] max-lg:h-[calc(var(--ssc-scroll-vh)*1dvh)]\",\n          classes.track\n        )}\n        ref={trackRef}\n        style={trackHeightStyle}\n      >\n        <div\n          className={cn(\n            \"sticky top-0 z-0 w-full overflow-hidden\",\n            !containerQuery && \"h-svh max-lg:h-dvh\"\n          )}\n          style={stickyHeightStyle}\n        >\n          {cardsSection}\n        </div>\n      </div>\n    );\n  }\n\n  return cardsSection;\n}\n",
      "type": "registry:ui",
      "target": "components/sora-ui/blocks/sticky-scroll-cards.tsx"
    }
  ],
  "meta": {
    "keywords": [
      "sticky",
      "pin",
      "card",
      "flip",
      "stack",
      "scroll",
      "gsap",
      "scrolltrigger"
    ],
    "inspiration": {
      "type": "reimplemented",
      "label": "Codegrid",
      "stack": "GSAP and vanilla JS"
    }
  },
  "type": "registry:ui"
}
