{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "aspect-ratio",
  "title": "Aspect ratio",
  "description": "A media frame that keeps its ratio and shows a skeleton until the image loads.",
  "dependencies": [
    "@base-ui/react@^1.7.0",
    "@keyline-icons/react@^2.2.0"
  ],
  "registryDependencies": [
    "@khaeli/skeleton",
    "@khaeli/utils"
  ],
  "files": [
    {
      "path": "registry/khaeli/ui/aspect-ratio.tsx",
      "content": "\"use client\"\n\nimport * as React from \"react\"\nimport { flushSync } from \"react-dom\"\nimport { mergeProps } from \"@base-ui/react/merge-props\"\nimport { useRender } from \"@base-ui/react/use-render\"\nimport { ImageIcon } from \"@keyline-icons/react\"\nimport { cn } from \"@/lib/utils\"\n\nimport { Skeleton } from \"@/components/ui/skeleton\"\n\ntype AspectRatioValue = number | `${number}/${number}` | `${number}:${number}`\n\ntype MediaState = \"loading\" | \"loaded\" | \"error\"\n\ntype AspectRatioProps = useRender.ComponentProps<\"div\"> & {\n  ratio?: AspectRatioValue\n  placeholder?: boolean\n  fallback?: React.ReactNode\n}\n\nconst mediaSelector = \":scope > img, :scope > picture > img, :scope > video\"\n\nfunction parseAspectRatio(ratio: AspectRatioValue | undefined) {\n  if (ratio === undefined) {\n    return 1\n  }\n\n  let value = Number.NaN\n\n  if (typeof ratio === \"number\") {\n    value = ratio\n  } else {\n    const trimmed = ratio.trim()\n    const pair = trimmed.match(/^(\\d*\\.?\\d+)\\s*[/:]\\s*(\\d*\\.?\\d+)$/)\n    if (pair) {\n      value = Number(pair[1]) / Number(pair[2])\n    } else if (/^\\d*\\.?\\d+$/.test(trimmed)) {\n      value = Number(trimmed)\n    }\n  }\n\n  if (!Number.isFinite(value) || value <= 0) return 1\n\n  return value\n}\n\nfunction readMediaState(media: Element): MediaState {\n  if (media instanceof HTMLImageElement) {\n    if (!media.getAttribute(\"src\") && !media.getAttribute(\"srcset\")) {\n      return \"loading\"\n    }\n    if (!media.complete) {\n      return \"loading\"\n    }\n    return media.naturalWidth > 0 ? \"loaded\" : \"error\"\n  }\n  if (media instanceof HTMLVideoElement) {\n    if (\n      media.error ||\n      media.networkState === HTMLMediaElement.NETWORK_NO_SOURCE\n    ) {\n      return \"error\"\n    }\n    return media.readyState >= HTMLMediaElement.HAVE_CURRENT_DATA\n      ? \"loaded\"\n      : \"loading\"\n  }\n  return \"loaded\"\n}\n\nfunction useMediaState(\n  containerRef: React.RefObject<HTMLElement | null>,\n  enabled: boolean\n) {\n  const [state, setState] = React.useState<MediaState | null>(null)\n\n  React.useLayoutEffect(() => {\n    const container = containerRef.current\n    if (!enabled || !container) {\n      return\n    }\n\n    const findMedia = () => container.querySelector(mediaSelector)\n\n    const sync = () => {\n      const media = findMedia()\n      setState(media ? readMediaState(media) : null)\n    }\n\n    const isOwn = (target: EventTarget | null) => {\n      const media = findMedia()\n      return (\n        media !== null &&\n        (target === media ||\n          (target instanceof HTMLSourceElement &&\n            target.parentElement === media))\n      )\n    }\n\n    const handleLoad = (event: Event) => {\n      if (isOwn(event.target)) {\n        setState(\"loaded\")\n      }\n    }\n\n    const handleError = (event: Event) => {\n      if (isOwn(event.target)) {\n        setState(\"error\")\n      }\n    }\n\n    container.addEventListener(\"load\", handleLoad, true)\n    container.addEventListener(\"loadeddata\", handleLoad, true)\n    container.addEventListener(\"error\", handleError, true)\n\n    const observer = new MutationObserver(() => flushSync(sync))\n    observer.observe(container, {\n      childList: true,\n      subtree: true,\n      attributes: true,\n      attributeFilter: [\"src\", \"srcset\"],\n    })\n\n    sync()\n\n    return () => {\n      container.removeEventListener(\"load\", handleLoad, true)\n      container.removeEventListener(\"loadeddata\", handleLoad, true)\n      container.removeEventListener(\"error\", handleError, true)\n      observer.disconnect()\n      setState(null)\n    }\n  }, [containerRef, enabled])\n\n  return enabled ? state : null\n}\n\nfunction AspectRatio({\n  ratio,\n  placeholder = true,\n  fallback = <ImageIcon aria-hidden=\"true\" />,\n  className,\n  style,\n  render,\n  ref,\n  children,\n  ...props\n}: AspectRatioProps) {\n  const containerRef = React.useRef<HTMLDivElement>(null)\n  const value = React.useMemo(() => parseAspectRatio(ratio), [ratio])\n  const state = useMediaState(containerRef, placeholder)\n\n  return useRender({\n    defaultTagName: \"div\",\n    render,\n    ref: ref ? [containerRef, ref] : containerRef,\n    props: mergeProps<\"div\">(\n      {\n        ...({ \"data-slot\": \"aspect-ratio\" } as Record<string, string>),\n        className: cn(\n          \"relative aspect-(--ratio) w-full [&>:is(img,video)]:object-cover [&>:is(img,video,iframe,picture)]:absolute [&>:is(img,video,iframe,picture)]:inset-0 [&>:is(img,video,iframe,picture)]:size-full [&>:is(img,video,iframe,picture)]:rounded-[inherit] [&>picture>img]:size-full [&>picture>img]:rounded-[inherit] [&>picture>img]:object-cover\",\n          \"[&>:is(img,video,picture)]:transition-opacity [&>:is(img,video,picture)]:duration-300 [&>:is(img,video,picture)]:ease-out-quint data-[state=error]:[&>:is(img,video,picture)]:opacity-0 data-[state=loading]:[&>:is(img,video,picture)]:opacity-0 motion-reduce:[&>:is(img,video,picture)]:transition-none\",\n          className\n        ),\n        style: { ...style, \"--ratio\": value } as React.CSSProperties,\n        children: (\n          <>\n            {state === \"loading\" || state === \"error\" ? (\n              <Skeleton\n                data-slot=\"aspect-ratio-placeholder\"\n                className={cn(\n                  \"pointer-events-none absolute inset-0 rounded-[inherit]\",\n                  state === \"error\" && \"animate-none\"\n                )}\n              />\n            ) : null}\n            {children}\n            {state === \"error\" && fallback !== null ? (\n              <span\n                data-slot=\"aspect-ratio-fallback\"\n                aria-hidden=\"true\"\n                className=\"pointer-events-none absolute inset-0 grid animate-in place-items-center rounded-[inherit] text-muted-foreground animation-duration-200 fade-in-0 [&>svg:not([class*='size-'])]:size-6\"\n              >\n                {fallback}\n              </span>\n            ) : null}\n          </>\n        ),\n        \"aria-busy\": state === \"loading\" || undefined,\n      },\n      props,\n      {\n        \"data-state\": state ?? undefined,\n      } as Record<string, string | undefined>\n    ),\n  })\n}\n\nexport { AspectRatio, parseAspectRatio }\nexport type { AspectRatioProps, AspectRatioValue }\n",
      "type": "registry:ui"
    }
  ],
  "docs": "Install @khaeli/foundation first: this item's styling lives in its tokens and [data-slot] rules.",
  "type": "registry:ui"
}