{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "scroll-gallery",
  "title": "Scroll Gallery",
  "description": "A full-viewport sticky scroll slider with strip-mask image transitions and animated title swaps, driven by GSAP ScrollTrigger.",
  "dependencies": ["gsap", "@gsap/react"],
  "registryDependencies": ["utils", "@soralabs/lib-scroll-trigger-utils"],
  "files": [
    {
      "path": "registry/blocks/scroll-gallery/index.tsx",
      "content": "/* oxlint-disable next/no-img-element, react-doctor/nextjs-no-img-element */\n\"use client\";\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 } from \"react\";\n\nimport {\n  isWindowScroller,\n  observeWindowResize,\n  waitForScrollerReady,\n} from \"@/lib/scroll-trigger-utils\";\n\ngsap.registerPlugin(ScrollTrigger);\n\nconst MASK_HIDDEN =\n  \"linear-gradient(to bottom, transparent 0%, transparent 100%)\";\nconst MASK_REVEALED = \"linear-gradient(to bottom, black 0%, black 100%)\";\n\nconst MASKED_IMAGE_STYLE =\n  \"width:100%;height:100%;object-fit:cover;transform-origin:center center;backface-visibility:hidden;mask-size:100% 100%;-webkit-mask-size:100% 100%;mask-repeat:no-repeat;-webkit-mask-repeat:no-repeat;will-change:transform,mask-image;\";\n\nconst IMAGE_CONTAINER_STYLE =\n  \"position:absolute;top:0;left:0;width:100%;height:100%;transform:translateZ(0);backface-visibility:hidden;\";\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  images: \"absolute inset-0 h-full w-full\",\n  imageFrame: \"absolute inset-0 h-full w-full\",\n  image: \"h-full w-full object-cover\",\n  info: \"absolute top-1/2 left-0 z-[2] w-full -translate-y-1/2\",\n  infoInner: \"flex gap-8\",\n  prefix: \"flex-1\",\n  title: \"relative flex-[2] overflow-hidden\",\n  link: \"flex flex-1 justify-end\",\n} as const;\n\nexport type ScrollGalleryVariant = \"minimal\" | \"studio\";\n\n/** Structural-only preset for `variant=\"minimal\"`. Override slots via the `classNames` prop. */\nexport const SCROLL_GALLERY_MINIMAL_CLASSES = {\n  ...LAYOUT,\n  prefixText: \"\",\n  titleText: \"\",\n  linkText: \"\",\n} as const;\n\n/** Deadlock Studios featured-work layout — used by `variant=\"studio\"` or pass via the `classNames` prop. */\nexport const SCROLL_GALLERY_STUDIO_CLASSES = {\n  root: \"relative h-svh w-full overflow-hidden max-lg:h-dvh\",\n  images: \"absolute inset-0 h-full w-full\",\n  imageFrame: \"absolute inset-0 h-full w-full\",\n  image: \"h-full w-full origin-center object-cover\",\n  info: \"absolute top-1/2 left-0 z-[2] w-screen -translate-y-1/2 border-white/20 border-b\",\n  infoInner: \"flex gap-8 px-9\",\n  prefix: \"flex-1 max-[1000px]:hidden\",\n  prefixText:\n    \"font-medium text-[36px] text-white leading-none tracking-[-0.02rem] antialiased will-change-transform max-[1000px]:text-[18px]\",\n  title: \"relative h-10 flex-[2] overflow-hidden max-[1000px]:h-[22px]\",\n  titleText:\n    \"font-medium text-[36px] text-white leading-none tracking-[-0.02rem] antialiased will-change-transform [clip-path:polygon(0_0,100%_0,100%_100%,0%_100%)] max-[1000px]:text-[18px]\",\n  link: \"flex flex-1 justify-end\",\n  linkText:\n    \"font-medium text-[36px] text-white leading-none tracking-[-0.02rem] no-underline antialiased will-change-transform max-[1000px]:text-[18px]\",\n} as const;\n\nexport interface ScrollGallerySlide {\n  image: string;\n  /** Per-slide CTA label. Falls back to `linkLabel`. */\n  linkLabel?: string;\n  title: string;\n  url?: string;\n}\n\nexport interface ScrollGalleryTiming {\n  /** Scroll padding after the last transition (vh units). @default 300 */\n  finalDelay?: number;\n  /** Scroll padding before the first transition (vh units). @default 300 */\n  initialDelay?: number;\n  /** Starting scale for the active image. @default 1.25 */\n  scaleFrom?: number;\n  /** Resting scale after a slide is revealed. @default 1 */\n  scaleTo?: number;\n  /** Multiplier for strip-mask reveal speed. @default 2 */\n  stripRevealSpeed?: number;\n  /** Progress within a transition before the title advances (0–1). @default 0.3 */\n  titleChangeThreshold?: number;\n  /** Title slide-out / slide-in duration (seconds). @default 0.3 */\n  titleDuration?: number;\n  /** GSAP ease for title transitions. @default \"power2.out\" */\n  titleEase?: string;\n  /** Vertical offset for title enter/exit (CSS %). @default \"120%\" */\n  titleOffset?: string;\n}\n\nexport interface ScrollGalleryClassNames {\n  /** First slide img element. */\n  image?: string;\n  /** Image frame wrapper. */\n  imageFrame?: string;\n  /** Image stack wrapper. */\n  images?: string;\n  /** Info band wrapper. */\n  info?: string;\n  /** Info band inner flex row. */\n  infoInner?: string;\n  /** CTA link column. */\n  link?: string;\n  /** CTA link text. */\n  linkText?: string;\n  /** Prefix label column. */\n  prefix?: string;\n  /** Prefix label text. */\n  prefixText?: string;\n  /** Animated title column. */\n  title?: string;\n  /** Animated title text. */\n  titleText?: string;\n  /** Extra classes on the scroll track (embedded mode only). */\n  track?: string;\n}\n\nexport interface ScrollGalleryProps {\n  className?: string;\n  /** Per-slot class overrides. `cn()` merges after built-ins/variant preset. */\n  classNames?: ScrollGalleryClassNames;\n  /**\n   * Use container query height (`cqh`) instead of viewport height (`svh/dvh`)\n   * for embedded mode. Enable when the gallery 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  /**\n   * Scroll distance per transition in embedded mode (vh units, same as `scrollPerTransition`).\n   * When omitted, embedded mode auto-targets ~5 panel heights total.\n   */\n  embeddedScrollPerTransition?: number;\n  /** Global CTA label (right column). @default \"Explore\" */\n  linkLabel?: string;\n  /** ScrollTrigger pin start. @default \"top top\" */\n  pinStart?: string;\n  /** Prefix label (left column). Set `showPrefix={false}` to hide. @default \"Featured\" */\n  prefixLabel?: 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  /** Scroll distance in vh per slide transition. @default 1000 */\n  scrollPerTransition?: number;\n  /** GSAP scrub smoothing (seconds). @default 1 */\n  scrub?: number;\n  showInfoBand?: boolean;\n  showLink?: boolean;\n  showPrefix?: boolean;\n  slides: ScrollGallerySlide[];\n  /** Number of horizontal mask strips for the wipe transition. @default 20 */\n  stripsCount?: number;\n  timing?: ScrollGalleryTiming;\n  /**\n   * Visual preset. `studio` applies Deadlock Studios editorial styling;\n   * `minimal` is structural-only (override via the `classNames` prop).\n   * @default \"minimal\"\n   */\n  variant?: ScrollGalleryVariant;\n}\n\nfunction resolveScrollGalleryClasses(\n  variant: ScrollGalleryVariant,\n  classNames: ScrollGalleryClassNames | undefined\n) {\n  const preset =\n    variant === \"studio\"\n      ? SCROLL_GALLERY_STUDIO_CLASSES\n      : SCROLL_GALLERY_MINIMAL_CLASSES;\n\n  return {\n    rootPreset: preset.root,\n    images: cn(preset.images, classNames?.images),\n    imageFrame: cn(preset.imageFrame, classNames?.imageFrame),\n    image: cn(preset.image, classNames?.image),\n    info: cn(preset.info, classNames?.info),\n    infoInner: cn(preset.infoInner, classNames?.infoInner),\n    prefix: cn(preset.prefix, classNames?.prefix),\n    prefixText: cn(preset.prefixText, classNames?.prefixText),\n    title: cn(preset.title, classNames?.title),\n    titleText: cn(preset.titleText, classNames?.titleText),\n    link: cn(preset.link, classNames?.link),\n    linkText: cn(preset.linkText, classNames?.linkText),\n    track: classNames?.track,\n  };\n}\n\ninterface ResolvedTiming {\n  finalDelay: number;\n  initialDelay: number;\n  scaleFrom: number;\n  scaleRange: number;\n  scaleStep: number;\n  scaleTo: number;\n  stripRevealSpeed: number;\n  titleChangeThreshold: number;\n  titleDuration: number;\n  titleEase: string;\n  titleOffset: string;\n}\n\nfunction resolveTiming(timing?: ScrollGalleryTiming): ResolvedTiming {\n  const scaleFrom = timing?.scaleFrom ?? 1.25;\n  const scaleTo = timing?.scaleTo ?? 1;\n  const scaleRange = scaleFrom - scaleTo;\n\n  return {\n    initialDelay: timing?.initialDelay ?? 300,\n    finalDelay: timing?.finalDelay ?? 300,\n    titleChangeThreshold: timing?.titleChangeThreshold ?? 0.3,\n    titleDuration: timing?.titleDuration ?? 0.3,\n    titleEase: timing?.titleEase ?? \"power2.out\",\n    titleOffset: timing?.titleOffset ?? \"120%\",\n    scaleFrom,\n    scaleTo,\n    scaleRange,\n    scaleStep: scaleRange / 2,\n    stripRevealSpeed: timing?.stripRevealSpeed ?? 2,\n  };\n}\n\nfunction getTotalScrollDistanceVh(\n  slideCount: number,\n  scrollPerTransition: number,\n  timing: ResolvedTiming\n): number {\n  const transitionCount = Math.max(0, slideCount - 1);\n  return (\n    transitionCount * scrollPerTransition +\n    timing.initialDelay +\n    timing.finalDelay\n  );\n}\n\n/** ~5 preview-panel heights for blocks embedded demos (not full-page 20+ vh). */\nconst EMBEDDED_SCROLL_TARGET_TOTAL = 520;\n\nfunction resolveEmbeddedScrollConfig(\n  slideCount: number,\n  scrollPerTransition: number,\n  embeddedScrollPerTransition: number | undefined,\n  timing: ResolvedTiming\n): { scrollPerTransition: number; timing: ResolvedTiming } {\n  const embeddedTiming: ResolvedTiming = {\n    ...timing,\n    initialDelay: Math.min(timing.initialDelay, 50),\n    finalDelay: Math.min(timing.finalDelay, 50),\n  };\n  const transitionCount = Math.max(0, slideCount - 1);\n\n  if (embeddedScrollPerTransition !== undefined) {\n    return {\n      scrollPerTransition: embeddedScrollPerTransition,\n      timing: embeddedTiming,\n    };\n  }\n\n  if (transitionCount === 0) {\n    return { scrollPerTransition, timing: embeddedTiming };\n  }\n\n  const padding = embeddedTiming.initialDelay + embeddedTiming.finalDelay;\n  const perTransition = Math.max(\n    70,\n    Math.floor((EMBEDDED_SCROLL_TARGET_TOTAL - padding) / transitionCount)\n  );\n\n  return { scrollPerTransition: perTransition, timing: embeddedTiming };\n}\n\nfunction createStripBounds(stripsCount: number) {\n  return Array.from({ length: stripsCount }, (_, j) => {\n    const posFromBottom = stripsCount - j - 1;\n    const step = 100 / stripsCount;\n    const lower = (posFromBottom + 1) * step;\n    const upper = posFromBottom * step;\n    return {\n      lower,\n      upperGap: upper - 0.1,\n      delay: (j / stripsCount) * 0.5,\n    };\n  });\n}\n\nfunction mergeIntervals(intervals: { top: number; bottom: number }[]) {\n  if (!intervals.length) {\n    return [];\n  }\n  intervals.sort((a, b) => a.top - b.top);\n  const merged = [{ ...intervals[0] }];\n  for (let i = 1; i < intervals.length; i++) {\n    const last = merged.at(-1);\n    const next = intervals[i];\n    if (!last) {\n      break;\n    }\n    if (next.top <= last.bottom) {\n      last.bottom = Math.max(last.bottom, next.bottom);\n    } else {\n      merged.push({ ...next });\n    }\n  }\n  return merged;\n}\n\nfunction buildStripMask(\n  stripBounds: ReturnType<typeof createStripBounds>,\n  getAdj: (j: number, bounds: (typeof stripBounds)[number]) => number\n) {\n  const intervals: { top: number; bottom: number }[] = [];\n  for (let j = 0; j < stripBounds.length; j++) {\n    const bounds = stripBounds[j];\n    const adj = Math.max(0, Math.min(1, getAdj(j, bounds)));\n    if (adj <= 0) {\n      continue;\n    }\n    const sliceHeight = bounds.lower - bounds.upperGap;\n    intervals.push({\n      top: bounds.lower - adj * sliceHeight,\n      bottom: bounds.lower,\n    });\n  }\n  const merged = mergeIntervals(intervals);\n  if (!merged.length) {\n    return MASK_HIDDEN;\n  }\n  const stops: string[] = [];\n  let cursor = 0;\n  for (const { top, bottom } of merged) {\n    if (top > cursor) {\n      stops.push(`transparent ${cursor}%`, `transparent ${top}%`);\n    }\n    stops.push(`black ${top}%`, `black ${bottom}%`);\n    cursor = bottom;\n  }\n  if (cursor < 100) {\n    stops.push(`transparent ${cursor}%`, \"transparent 100%\");\n  }\n  return `linear-gradient(to bottom, ${stops.join(\", \")})`;\n}\n\nfunction setMaskImage(el: HTMLElement, value: string) {\n  el.style.maskImage = value;\n  el.style.webkitMaskImage = value;\n}\n\nfunction createScaleSetter(el: HTMLElement, initialScale: number) {\n  const apply = (value: number) => {\n    el.style.transform = `translate3d(0, 0, 0) scale(${value})`;\n  };\n  apply(initialScale);\n  return apply;\n}\n\nfunction imageScaleStyle(scale: number): CSSProperties {\n  return {\n    backfaceVisibility: \"hidden\",\n    transform: `translate3d(0, 0, 0) scale(${scale})`,\n  };\n}\n\nexport function ScrollGallery({\n  slides,\n  stripsCount = 20,\n  scrollPerTransition = 1000,\n  scrub = 1,\n  pinStart = \"top top\",\n  timing: timingProp,\n  scroller: scrollerProp,\n  embedded = false,\n  containerQuery = false,\n  embeddedScrollPerTransition,\n  prefixLabel = \"Featured\",\n  linkLabel = \"Explore\",\n  showInfoBand = true,\n  showPrefix = true,\n  showLink = true,\n  className,\n  classNames,\n  refreshPriority = -1,\n  variant = \"minimal\",\n}: ScrollGalleryProps) {\n  const classes = useMemo(\n    () => resolveScrollGalleryClasses(variant, classNames),\n    [variant, classNames]\n  );\n\n  const resolvedTiming = useMemo(() => resolveTiming(timingProp), [timingProp]);\n  const scrollConfig = useMemo(() => {\n    if (!embedded) {\n      return {\n        scrollPerTransition,\n        timing: resolvedTiming,\n      };\n    }\n\n    return resolveEmbeddedScrollConfig(\n      slides.length,\n      scrollPerTransition,\n      embeddedScrollPerTransition,\n      resolvedTiming\n    );\n  }, [\n    embedded,\n    embeddedScrollPerTransition,\n    resolvedTiming,\n    scrollPerTransition,\n    slides.length,\n  ]);\n  const scrollDistanceVh = useMemo(\n    () =>\n      getTotalScrollDistanceVh(\n        slides.length,\n        scrollConfig.scrollPerTransition,\n        scrollConfig.timing\n      ),\n    [slides.length, scrollConfig]\n  );\n\n  const trackRef = useRef<HTMLDivElement>(null);\n  const sectionRef = useRef<HTMLElement>(null);\n  const firstImgRef = useRef<HTMLImageElement>(null);\n  const titleRef = useRef<HTMLParagraphElement>(null);\n  const exploreLinkRef = useRef<HTMLAnchorElement>(null);\n  const slideImagesRef = useRef<HTMLDivElement>(null);\n\n  const shouldAnimate = slides.length > 0;\n  const displayPrefix = showInfoBand && showPrefix && Boolean(prefixLabel);\n  const displayLink = showInfoBand && showLink;\n\n  useGSAP(\n    () => {\n      if (!shouldAnimate) {\n        return;\n      }\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            \"[ScrollGallery] 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      const createdContainers: HTMLDivElement[] = [];\n\n      const mountGallery = async () => {\n        const section = sectionRef.current;\n        const scrollRoot = embedded ? trackRef.current : sectionRef.current;\n        const slideImages = slideImagesRef.current;\n        const titleElement = titleRef.current;\n        const exploreLink = exploreLinkRef.current;\n        const firstSlideImg = firstImgRef.current;\n\n        if (!(section && slideImages && firstSlideImg && scrollRoot)) {\n          return;\n        }\n        if (showInfoBand && !titleElement) {\n          return;\n        }\n        if (displayLink && !exploreLink) {\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 titleEl = titleElement;\n        const exploreLinkEl = exploreLink;\n        const {\n          finalDelay,\n          initialDelay,\n          scaleFrom,\n          scaleStep,\n          scaleTo,\n          stripRevealSpeed,\n          titleChangeThreshold,\n          titleDuration,\n          titleEase,\n          titleOffset,\n        } = scrollConfig.timing;\n        const activeScrollPerTransition = scrollConfig.scrollPerTransition;\n\n        const stripBounds = createStripBounds(stripsCount);\n        const totalSlides = slides.length;\n        const setFirstImgScale = createScaleSetter(firstSlideImg, scaleFrom);\n\n        interface SlideLayer {\n          img: HTMLImageElement;\n          revealState: \"hidden\" | \"animating\" | \"revealed\";\n          setScale: (v: number) => void;\n          transitionIndex: number;\n        }\n\n        const slideLayers: SlideLayer[] = [];\n\n        for (let i = 1; i < totalSlides; i++) {\n          const imgContainer = document.createElement(\"div\");\n          imgContainer.style.cssText = IMAGE_CONTAINER_STYLE;\n\n          const img = document.createElement(\"img\");\n          img.style.cssText = MASKED_IMAGE_STYLE;\n          img.src = slides[i].image;\n          img.alt = slides[i].title;\n          img.decoding = \"async\";\n          setMaskImage(img, MASK_HIDDEN);\n\n          imgContainer.append(img);\n          slideImages.append(imgContainer);\n          createdContainers.push(imgContainer);\n\n          slideLayers.push({\n            transitionIndex: i - 1,\n            img,\n            setScale: createScaleSetter(img, scaleFrom),\n            revealState: \"hidden\",\n          });\n        }\n\n        const transitionCount = totalSlides - 1;\n        const totalScrollDistance =\n          transitionCount * activeScrollPerTransition +\n          initialDelay +\n          finalDelay;\n\n        const transitionRanges: { startPercent: number; endPercent: number }[] =\n          [];\n        let pos = initialDelay;\n        for (let i = 0; i < transitionCount; i++) {\n          const start = pos;\n          const end = start + activeScrollPerTransition;\n          transitionRanges.push({\n            startPercent: start / totalScrollDistance,\n            endPercent: end / totalScrollDistance,\n          });\n          pos = end;\n        }\n\n        function calculateImageProgress(scrollProgress: number) {\n          const firstRange = transitionRanges[0];\n          const lastRange = transitionRanges.at(-1);\n          if (!(firstRange && lastRange)) {\n            return 0;\n          }\n          if (scrollProgress < firstRange.startPercent) {\n            return 0;\n          }\n          if (scrollProgress > lastRange.endPercent) {\n            return transitionRanges.length;\n          }\n          for (let i = 0; i < transitionRanges.length; i++) {\n            const { startPercent, endPercent } = transitionRanges[i];\n            if (\n              scrollProgress >= startPercent &&\n              scrollProgress <= endPercent\n            ) {\n              const norm =\n                (scrollProgress - startPercent) / (endPercent - startPercent);\n              return i + norm;\n            }\n          }\n          return transitionRanges.length;\n        }\n\n        function getScaleForImage(\n          imageIndex: number,\n          currentImageIndex: number,\n          progress: number\n        ) {\n          const continuousProgress = currentImageIndex + progress;\n          const diff = continuousProgress - imageIndex;\n          if (diff <= 0) {\n            return scaleFrom;\n          }\n          if (diff >= 2) {\n            return scaleTo;\n          }\n          return scaleFrom - scaleStep * diff;\n        }\n\n        let currentTitleIndex = 0;\n        let queuedTitleIndex: number | null = null;\n        let isAnimating = false;\n        let lastImageProgress = 0;\n\n        function updateLinkForSlide(index: number) {\n          if (!(displayLink && exploreLinkEl)) {\n            return;\n          }\n          exploreLinkEl.href = slides[index].url ?? \"#\";\n          const label = slides[index].linkLabel ?? linkLabel;\n          if (label) {\n            exploreLinkEl.textContent = label;\n          }\n        }\n\n        function animateTitleChange(index: number, direction: \"down\" | \"up\") {\n          if (!titleEl) {\n            return;\n          }\n          if (index === currentTitleIndex) {\n            return;\n          }\n          if (index < 0 || index >= slides.length) {\n            return;\n          }\n          if (isAnimating) {\n            queuedTitleIndex = index;\n            return;\n          }\n          isAnimating = true;\n          const offset = titleOffset;\n          const outY = direction === \"down\" ? `-${offset}` : offset;\n          const inY = direction === \"down\" ? offset : `-${offset}`;\n\n          gsap.killTweensOf(titleEl);\n          updateLinkForSlide(index);\n\n          gsap.to(titleEl, {\n            y: outY,\n            duration: titleDuration,\n            ease: titleEase,\n            onComplete: () => {\n              titleEl.textContent = slides[index].title;\n              gsap.set(titleEl, { y: inY });\n              gsap.to(titleEl, {\n                y: \"0%\",\n                duration: titleDuration,\n                ease: titleEase,\n                onComplete: () => {\n                  currentTitleIndex = index;\n                  isAnimating = false;\n                  if (\n                    queuedTitleIndex !== null &&\n                    queuedTitleIndex !== currentTitleIndex\n                  ) {\n                    const next = queuedTitleIndex;\n                    queuedTitleIndex = null;\n                    animateTitleChange(next, direction);\n                  }\n                },\n              });\n            },\n          });\n        }\n\n        function getTitleIndexForProgress(imageProgress: number) {\n          const idx = Math.floor(imageProgress);\n          const specific = imageProgress - idx;\n          return specific >= titleChangeThreshold\n            ? Math.min(idx + 1, slides.length - 1)\n            : idx;\n        }\n\n        function setLayerRevealed(layer: SlideLayer) {\n          if (layer.revealState === \"revealed\") {\n            return;\n          }\n          setMaskImage(layer.img, MASK_REVEALED);\n          layer.revealState = \"revealed\";\n        }\n\n        function setLayerHidden(layer: SlideLayer) {\n          if (layer.revealState === \"hidden\") {\n            return;\n          }\n          setMaskImage(layer.img, MASK_HIDDEN);\n          layer.revealState = \"hidden\";\n        }\n\n        const useWindowPin = isWindowScroller(scroller);\n\n        const handleScrollUpdate = (progress: number) => {\n          const imageProgress = calculateImageProgress(progress);\n          const scrollDirection =\n            imageProgress > lastImageProgress ? \"down\" : \"up\";\n          const currentImageIndex = Math.floor(imageProgress);\n          const imageSpecificProgress = imageProgress - currentImageIndex;\n\n          if (showInfoBand && titleEl) {\n            const correctTitleIndex = getTitleIndexForProgress(imageProgress);\n            if (correctTitleIndex !== currentTitleIndex) {\n              queuedTitleIndex = correctTitleIndex;\n              if (!isAnimating) {\n                animateTitleChange(correctTitleIndex, scrollDirection);\n              }\n            }\n          }\n\n          setFirstImgScale(\n            getScaleForImage(0, currentImageIndex, imageSpecificProgress)\n          );\n\n          for (const layer of slideLayers) {\n            const { transitionIndex, setScale } = layer;\n            setScale(\n              getScaleForImage(\n                transitionIndex,\n                currentImageIndex,\n                imageSpecificProgress\n              )\n            );\n\n            if (transitionIndex < currentImageIndex) {\n              setLayerRevealed(layer);\n            } else if (transitionIndex === currentImageIndex) {\n              layer.revealState = \"animating\";\n              setMaskImage(\n                layer.img,\n                buildStripMask(stripBounds, (_j, bounds) =>\n                  Math.max(\n                    0,\n                    Math.min(\n                      1,\n                      (imageSpecificProgress - bounds.delay) * stripRevealSpeed\n                    )\n                  )\n                )\n              );\n            } else {\n              setLayerHidden(layer);\n            }\n          }\n\n          lastImageProgress = imageProgress;\n        };\n\n        if (embedded) {\n          trigger = ScrollTrigger.create({\n            trigger: scrollRoot,\n            scroller,\n            start: \"top top\",\n            end: \"bottom bottom\",\n            scrub,\n            invalidateOnRefresh: true,\n            refreshPriority: -1,\n            onUpdate: (self) => {\n              handleScrollUpdate(self.progress);\n            },\n          });\n        } else {\n          trigger = ScrollTrigger.create({\n            trigger: section,\n            scroller,\n            start: pinStart,\n            end: `+=${totalScrollDistance}vh`,\n            pin: true,\n            pinReparent: !useWindowPin,\n            pinSpacing: true,\n            scrub,\n            invalidateOnRefresh: true,\n            refreshPriority,\n            onUpdate: (self) => {\n              handleScrollUpdate(self.progress);\n            },\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        handleScrollUpdate(trigger.progress);\n      };\n\n      mountGallery().catch(() => {\n        /* ScrollTrigger setup aborted on unmount */\n      });\n\n      return () => {\n        disposed = true;\n        resizeObserver?.disconnect();\n        trigger?.kill();\n        trigger = null;\n        unbindResize?.();\n        for (const el of createdContainers) {\n          el.remove();\n        }\n      };\n    },\n    {\n      scope: embedded ? trackRef : sectionRef,\n      dependencies: [\n        slides,\n        stripsCount,\n        scrollPerTransition,\n        scrub,\n        pinStart,\n        scrollerProp,\n        scrollConfig,\n        shouldAnimate,\n        showInfoBand,\n        displayLink,\n        linkLabel,\n        embedded,\n        refreshPriority,\n      ],\n    }\n  );\n\n  const firstSlide = slides[0];\n  const initialLinkLabel = firstSlide?.linkLabel ?? linkLabel;\n  const initialImageScale = scrollConfig.timing.scaleFrom;\n\n  const trackStyle = {\n    \"--sg-scroll-vh\": scrollDistanceVh,\n  } as CSSProperties;\n\n  const gallerySection = (\n    <section\n      className={cn(\n        embedded\n          ? \"relative h-full w-full overflow-hidden\"\n          : classes.rootPreset,\n        className\n      )}\n      ref={sectionRef}\n    >\n      <div className={classes.images} ref={slideImagesRef}>\n        <div className={classes.imageFrame}>\n          {firstSlide ? (\n            <img\n              alt={firstSlide.title}\n              className={classes.image}\n              ref={firstImgRef}\n              src={firstSlide.image}\n              style={imageScaleStyle(initialImageScale)}\n            />\n          ) : null}\n        </div>\n      </div>\n\n      {showInfoBand && firstSlide ? (\n        <div className={classes.info}>\n          <div className={classes.infoInner}>\n            {displayPrefix ? (\n              <div className={classes.prefix}>\n                <p className={classes.prefixText}>{prefixLabel}</p>\n              </div>\n            ) : null}\n\n            <div className={classes.title}>\n              <p className={classes.titleText} ref={titleRef}>\n                {firstSlide.title}\n              </p>\n            </div>\n\n            {displayLink ? (\n              <div className={classes.link}>\n                <a\n                  className={classes.linkText}\n                  href={firstSlide.url ?? \"#\"}\n                  ref={exploreLinkRef}\n                >\n                  {initialLinkLabel}\n                </a>\n              </div>\n            ) : null}\n          </div>\n        </div>\n      ) : null}\n    </section>\n  );\n\n  if (embedded) {\n    const trackHeightStyle: CSSProperties = containerQuery\n      ? { ...trackStyle, height: `calc(var(--sg-scroll-vh) * 1cqh)` }\n      : trackStyle;\n\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(--sg-scroll-vh)*1svh)] max-lg:h-[calc(var(--sg-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          {gallerySection}\n        </div>\n      </div>\n    );\n  }\n\n  return gallerySection;\n}\n",
      "type": "registry:ui",
      "target": "components/sora-ui/blocks/scroll-gallery.tsx"
    }
  ],
  "meta": {
    "demoProps": {
      "ScrollGallery": {
        "prefixLabel": {
          "value": "Featured"
        },
        "linkLabel": {
          "value": "Explore"
        },
        "showPrefix": {
          "value": true
        },
        "showLink": {
          "value": true
        },
        "showInfoBand": {
          "value": true
        },
        "scrollPerTransition": {
          "value": 600,
          "min": 200,
          "max": 1500,
          "step": 50
        },
        "stripsCount": {
          "value": 20,
          "min": 4,
          "max": 40,
          "step": 2
        },
        "scrub": {
          "value": 1,
          "min": 0,
          "max": 3,
          "step": 0.1
        }
      }
    }
  },
  "type": "registry:ui"
}
