{"$schema":"https://ui.shadcn.com/schema/registry-item.json","name":"liquid-glass","type":"registry:ui","title":"LiquidGlass","description":"Glass-like visual effect using SVG filters for chromatic displacement","author":"fancy-ui <https://fancy-ui.rama.app>","categories":["effects"],"registryDependencies":["https://fancy-ui.rama.app/r/internals.json","https://fancy-ui.rama.app/r/internals-dom.json","https://fancy-ui.rama.app/r/utils.json"],"files":[{"path":"react/src/components/liquid-glass/LiquidGlass.tsx","content":"\"use client\";\n\nimport { useEffect, useMemo, useRef, useState, type CSSProperties, type ReactNode } from \"react\";\nimport { cn } from \"../../utils\";\nimport { uid } from \"../../internals/use-id\";\nimport \"./liquid-glass.css\";\n\n/**\n * LiquidGlass - glass-like refraction built on an SVG displacement filter\n *\n * The element measures itself with a ResizeObserver, paints a displacement map\n * as an inline SVG data URI at that exact size, and points `backdrop-filter` at\n * a filter that displaces the red, green and blue channels by slightly\n * different amounts, which is what produces the chromatic edge.\n */\nexport interface LiquidGlassProps {\n\t/** Border radius in px */\n\tradius?: number;\n\t/** Border thickness factor */\n\tborder?: number;\n\t/** HSL lightness of fill */\n\tlightness?: number;\n\t/** Gaussian blur std deviation */\n\tdisplace?: number;\n\t/** SVG blend mode */\n\tblend?: string;\n\t/** X displacement channel */\n\txChannel?: \"R\" | \"G\" | \"B\";\n\t/** Y displacement channel */\n\tyChannel?: \"R\" | \"G\" | \"B\";\n\t/** Fill opacity */\n\talpha?: number;\n\t/** Inner blur */\n\tblur?: number;\n\t/** Red channel offset */\n\trOffset?: number;\n\t/** Green channel offset */\n\tgOffset?: number;\n\t/** Blue channel offset */\n\tbOffset?: number;\n\t/** Displacement scale */\n\tscale?: number;\n\t/** Frosted overlay opacity */\n\tfrost?: number;\n\t/** Backdrop blur in pixels for the Safari fallback */\n\tfallbackBlur?: number;\n\t/** Backdrop saturation percentage for the Safari fallback */\n\tfallbackSaturation?: number;\n\t/** CSS classes for the inner container */\n\tclassName?: string;\n\t/** CSS classes for the outer container */\n\tcontainerClass?: string;\n\tchildren?: ReactNode;\n}\n\nexport function LiquidGlass({\n\tradius = 16,\n\tborder: borderProp = 0.07,\n\tlightness = 50,\n\tdisplace,\n\tblend = \"difference\",\n\txChannel = \"R\",\n\tyChannel = \"B\",\n\talpha = 0.93,\n\tblur = 11,\n\trOffset = 0,\n\tgOffset = 10,\n\tbOffset = 20,\n\tscale = -180,\n\tfrost = 0.05,\n\tfallbackBlur = 20,\n\tfallbackSaturation = 180,\n\tclassName = \"\",\n\tcontainerClass = \"\",\n\tchildren,\n}: LiquidGlassProps) {\n\tconst liquidGlassRoot = useRef<HTMLDivElement>(null);\n\tconst [dimensions, setDimensions] = useState({ width: 0, height: 0 });\n\tconst [filterId, setFilterId] = useState(\"\");\n\n\t// Built once per input change, and not at all while the filter is absent —\n\t// the same caching and laziness the Svelte source gets from `$derived.by`\n\t// read only inside its `{#if filterId}` block. Every input is a primitive,\n\t// so the comparison is cheap and the kilobyte string plus its URI encoding\n\t// no longer run on renders that a parent alone caused.\n\tconst displacementDataUri = useMemo(() => {\n\t\tif (!filterId) return \"\";\n\n\t\tconst brd = Math.min(dimensions.width, dimensions.height) * (borderProp * 0.5);\n\n\t\tconst displacementImage = `<svg viewBox=\"0 0 ${dimensions.width} ${dimensions.height}\" xmlns=\"http://www.w3.org/2000/svg\"><defs><linearGradient id=\"red-${filterId}\" x1=\"100%\" y1=\"0%\" x2=\"0%\" y2=\"0%\"><stop offset=\"0%\" stop-color=\"#0000\"/><stop offset=\"100%\" stop-color=\"red\"/></linearGradient><linearGradient id=\"blue-${filterId}\" x1=\"0%\" y1=\"0%\" x2=\"0%\" y2=\"100%\"><stop offset=\"0%\" stop-color=\"#0000\"/><stop offset=\"100%\" stop-color=\"blue\"/></linearGradient></defs><rect x=\"0\" y=\"0\" width=\"${dimensions.width}\" height=\"${dimensions.height}\" fill=\"black\"/><rect x=\"0\" y=\"0\" width=\"${dimensions.width}\" height=\"${dimensions.height}\" rx=\"${radius}\" fill=\"url(#red-${filterId})\"/><rect x=\"0\" y=\"0\" width=\"${dimensions.width}\" height=\"${dimensions.height}\" rx=\"${radius}\" fill=\"url(#blue-${filterId})\" style=\"mix-blend-mode:${blend}\"/><rect x=\"${brd}\" y=\"${brd}\" width=\"${dimensions.width - brd * 2}\" height=\"${dimensions.height - brd * 2}\" rx=\"${radius}\" fill=\"hsl(0 0% ${lightness}% / ${alpha})\" style=\"filter:blur(${blur}px)\"/></svg>`;\n\n\t\treturn `data:image/svg+xml,${encodeURIComponent(displacementImage)}`;\n\t}, [\n\t\tdimensions.width,\n\t\tdimensions.height,\n\t\tborderProp,\n\t\tradius,\n\t\tblend,\n\t\tlightness,\n\t\talpha,\n\t\tblur,\n\t\tfilterId,\n\t]);\n\n\t// Same declaration order as the Svelte source's style string, and the same\n\t// two shapes: `backdrop-filter` only appears once the filter it points at does.\n\tconst backdropStyle = {\n\t\t\"--frost\": frost,\n\t\tborderRadius: `${radius}px`,\n\t\t...(filterId ? { backdropFilter: `url(#displacementFilter-${filterId})` } : null),\n\t\t\"--lg-fallback-blur\": `${fallbackBlur}px`,\n\t\t\"--lg-fallback-saturation\": `${fallbackSaturation}%`,\n\t} as CSSProperties;\n\n\tuseEffect(() => {\n\t\t// The filter id is minted here, after mount, exactly where the Svelte\n\t\t// source mints it in `onMount`. It is what keeps two instances on one page\n\t\t// from sharing a filter, and it must never reach the server HTML — an id\n\t\t// the client alone ever sees cannot disagree with a server render. `uid()`\n\t\t// is the counter kept for exactly that case (it throws when called on the\n\t\t// server), so no seed prop is needed and no two instances can collide.\n\t\tsetFilterId(uid(\"lg\"));\n\n\t\tconst node = liquidGlassRoot.current;\n\t\tif (!node) return;\n\n\t\tconst observer = new ResizeObserver((entries) => {\n\t\t\tconst entry = entries[0];\n\t\t\tif (!entry) return;\n\n\t\t\tlet width = 0;\n\t\t\tlet height = 0;\n\n\t\t\tif (entry.borderBoxSize && entry.borderBoxSize.length) {\n\t\t\t\twidth = entry.borderBoxSize[0]!.inlineSize;\n\t\t\t\theight = entry.borderBoxSize[0]!.blockSize;\n\t\t\t} else if (entry.contentRect) {\n\t\t\t\twidth = entry.contentRect.width;\n\t\t\t\theight = entry.contentRect.height;\n\t\t\t}\n\n\t\t\tsetDimensions({ width, height });\n\t\t});\n\n\t\tobserver.observe(node);\n\n\t\treturn () => observer.disconnect();\n\t\t// Mount-only, mirroring `onMount`: the root element is unconditional, so\n\t\t// it is already attached by the time this runs and never changes identity.\n\t}, []);\n\n\treturn (\n\t\t<div\n\t\t\tref={liquidGlassRoot}\n\t\t\tclassName={cn(\"liquid-glass-effect\", containerClass)}\n\t\t\tstyle={backdropStyle}\n\t\t>\n\t\t\t<div className={cn(\"liquid-glass-slot\", className)}>{children}</div>\n\n\t\t\t{filterId ? (\n\t\t\t\t<svg className=\"liquid-glass-filter\" xmlns=\"http://www.w3.org/2000/svg\">\n\t\t\t\t\t<defs>\n\t\t\t\t\t\t<filter id={`displacementFilter-${filterId}`} colorInterpolationFilters=\"sRGB\">\n\t\t\t\t\t\t\t<feImage\n\t\t\t\t\t\t\t\tx=\"0\"\n\t\t\t\t\t\t\t\ty=\"0\"\n\t\t\t\t\t\t\t\twidth=\"100%\"\n\t\t\t\t\t\t\t\theight=\"100%\"\n\t\t\t\t\t\t\t\thref={displacementDataUri}\n\t\t\t\t\t\t\t\tresult=\"map\"\n\t\t\t\t\t\t\t/>\n\t\t\t\t\t\t\t<feDisplacementMap\n\t\t\t\t\t\t\t\tin=\"SourceGraphic\"\n\t\t\t\t\t\t\t\tin2=\"map\"\n\t\t\t\t\t\t\t\txChannelSelector={xChannel}\n\t\t\t\t\t\t\t\tyChannelSelector={yChannel}\n\t\t\t\t\t\t\t\tscale={scale + rOffset}\n\t\t\t\t\t\t\t\tresult=\"dispRed\"\n\t\t\t\t\t\t\t/>\n\t\t\t\t\t\t\t<feColorMatrix\n\t\t\t\t\t\t\t\tin=\"dispRed\"\n\t\t\t\t\t\t\t\ttype=\"matrix\"\n\t\t\t\t\t\t\t\tvalues=\"1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0\"\n\t\t\t\t\t\t\t\tresult=\"red\"\n\t\t\t\t\t\t\t/>\n\t\t\t\t\t\t\t<feDisplacementMap\n\t\t\t\t\t\t\t\tin=\"SourceGraphic\"\n\t\t\t\t\t\t\t\tin2=\"map\"\n\t\t\t\t\t\t\t\txChannelSelector={xChannel}\n\t\t\t\t\t\t\t\tyChannelSelector={yChannel}\n\t\t\t\t\t\t\t\tscale={scale + gOffset}\n\t\t\t\t\t\t\t\tresult=\"dispGreen\"\n\t\t\t\t\t\t\t/>\n\t\t\t\t\t\t\t<feColorMatrix\n\t\t\t\t\t\t\t\tin=\"dispGreen\"\n\t\t\t\t\t\t\t\ttype=\"matrix\"\n\t\t\t\t\t\t\t\tvalues=\"0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0 1 0\"\n\t\t\t\t\t\t\t\tresult=\"green\"\n\t\t\t\t\t\t\t/>\n\t\t\t\t\t\t\t<feDisplacementMap\n\t\t\t\t\t\t\t\tin=\"SourceGraphic\"\n\t\t\t\t\t\t\t\tin2=\"map\"\n\t\t\t\t\t\t\t\txChannelSelector={xChannel}\n\t\t\t\t\t\t\t\tyChannelSelector={yChannel}\n\t\t\t\t\t\t\t\tscale={scale + bOffset}\n\t\t\t\t\t\t\t\tresult=\"dispBlue\"\n\t\t\t\t\t\t\t/>\n\t\t\t\t\t\t\t<feColorMatrix\n\t\t\t\t\t\t\t\tin=\"dispBlue\"\n\t\t\t\t\t\t\t\ttype=\"matrix\"\n\t\t\t\t\t\t\t\tvalues=\"0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 1 0\"\n\t\t\t\t\t\t\t\tresult=\"blue\"\n\t\t\t\t\t\t\t/>\n\t\t\t\t\t\t\t<feBlend in=\"red\" in2=\"green\" mode=\"screen\" result=\"rg\" />\n\t\t\t\t\t\t\t<feBlend in=\"rg\" in2=\"blue\" mode=\"screen\" result=\"output\" />\n\t\t\t\t\t\t\t{displace !== undefined ? <feGaussianBlur stdDeviation={displace} /> : null}\n\t\t\t\t\t\t</filter>\n\t\t\t\t\t</defs>\n\t\t\t\t</svg>\n\t\t\t) : null}\n\t\t</div>\n\t);\n}\n","type":"registry:ui","target":"@ui/fancy/components/liquid-glass/LiquidGlass.tsx"},{"path":"react/src/components/liquid-glass/index.ts","content":"\"use client\";\n\nexport { LiquidGlass } from \"./LiquidGlass\";\nexport type { LiquidGlassProps } from \"./LiquidGlass\";\n","type":"registry:ui","target":"@ui/fancy/components/liquid-glass/index.ts"},{"path":"react/src/components/liquid-glass/liquid-glass.css","content":".liquid-glass-effect {\n\tposition: relative;\n\tdisplay: block;\n\topacity: 1;\n\tborder-radius: inherit;\n\tbackground: light-dark(hsl(0 0% 100% / var(--frost, 0)), hsl(0 0% 0% / var(--frost, 0)));\n\tbox-shadow:\n\t\t0 0 2px 1px\n\t\t\tlight-dark(\n\t\t\t\tcolor-mix(in oklch, canvasText, #0000 85%),\n\t\t\t\tcolor-mix(in oklch, canvasText, #0000 90%)\n\t\t\t)\n\t\t\tinset,\n\t\t0 0 10px 4px\n\t\t\tlight-dark(\n\t\t\t\tcolor-mix(in oklch, canvasText, #0000 90%),\n\t\t\t\tcolor-mix(in oklch, canvasText, #0000 95%)\n\t\t\t)\n\t\t\tinset,\n\t\t0px 4px 16px rgba(17, 17, 26, 0.05),\n\t\t0px 8px 24px rgba(17, 17, 26, 0.05),\n\t\t0px 16px 56px rgba(17, 17, 26, 0.05),\n\t\t0px 4px 16px rgba(17, 17, 26, 0.05) inset,\n\t\t0px 8px 24px rgba(17, 17, 26, 0.05) inset,\n\t\t0px 16px 56px rgba(17, 17, 26, 0.05) inset;\n}\n\n/* Safari cannot resolve SVG url() references inside backdrop-filter, so it needs a\n   plain-blur fallback. -webkit-named-image is a WebKit-only feature query (Chromium\n   and Firefox return false), so this never overrides Chromium's working SVG filter.\n   Ship the -webkit- prefixed backdrop-filter too for Safari and iOS 17 and older. */\n@supports (background: -webkit-named-image(i)) {\n\t.liquid-glass-effect {\n\t\t-webkit-backdrop-filter: blur(var(--lg-fallback-blur)) saturate(var(--lg-fallback-saturation)) !important;\n\t\tbackdrop-filter: blur(var(--lg-fallback-blur)) saturate(var(--lg-fallback-saturation)) !important;\n\t}\n}\n\n.liquid-glass-slot {\n\twidth: 100%;\n\theight: 100%;\n\toverflow: hidden;\n\tborder-radius: inherit;\n}\n\n.liquid-glass-filter {\n\tposition: absolute;\n\tinset: 0;\n\twidth: 100%;\n\theight: 100%;\n\tpointer-events: none;\n}\n","type":"registry:ui","target":"@ui/fancy/components/liquid-glass/liquid-glass.css"}],"meta":{"license":"MIT","package":"fancy-ui-react","version":"0.7.0","source":"https://fancy-ui.rama.app/docs/components/liquid-glass?framework=react"}}