{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "textura-sphere",
  "title": "Textura Sphere",
  "author": "Visant Labs <visantsupply@gmail.com>",
  "description": "Uma bolha de vidro passeia sob o ponteiro e amplia a imagem como olho de peixe.",
  "dependencies": [],
  "registryDependencies": [
    "utils",
    "@visant/css-color"
  ],
  "files": [
    {
      "path": "registry/visant/ui/textura-sphere.tsx",
      "content": "\"use client\";\n\nimport * as React from \"react\";\n\nimport { cn } from \"@/lib/utils\";\nimport { onThemeChange, resolveCssColor } from \"@/lib/css-color\";\n\n/**\n * Textura Sphere — uma bolha de vidro passeia sob o ponteiro e amplia a\n * imagem como olho de peixe: o miolo cresce, a borda se espreme contra a\n * curva, e um reflexo pequeno no alto diz que aquilo é vidro. Quando o\n * cursor sai, a bolha murcha e some.\n *\n * Original da Visant Labs, da família texturas: superfície que reage ao\n * ponteiro, um gesto só por peça.\n *\n * ── As decisões que não se veem ────────────────────────────────────────────\n *\n * 1. **A altura da esfera é a lente.** Cada pixel dentro da bolha lê a\n *    imagem mais perto do centro na proporção de `√(1 − r²)`, a altura de\n *    uma esfera naquele ponto. No miolo amplia muito; na borda a altura é\n *    zero e a amostra volta a coincidir com o pixel, então a foto emenda.\n * 2. **Sombra e reflexo saem do tema.** A borda escurece para a cor do texto\n *    e o reflexo clareia para o papel. Nada de branco ou preto fixos: no\n *    escuro a bolha continua vidro, não vira um buraco claro.\n * 3. **A borda é antisserrilhada à mão.** O canvas nasce sem `antialias`, e\n *    o corte da esfera mistura dentro e fora numa faixa de 1,5 px. Sem isso\n *    a bolha teria contorno de escada em tela de 1×.\n * 4. **A bolha cresce, não só aparece.** Na entrada o raio vai de 60% a\n *    100% junto com a força, e na saída faz o caminho de volta. A posição\n *    corre atrás do cursor, então ela desliza em vez de pular.\n * 5. **Sem laço à toa.** Desenha na carga, no tema, no tamanho e no knob. O\n *    laço só existe enquanto a bolha cresce, murcha ou anda, e com movimento\n *    reduzido ela salta direto para o cursor.\n */\n\nconst VERT = `attribute vec2 a_pos;void main(){gl_Position=vec4(a_pos,0.0,1.0);}`;\n\nconst FRAG = `\nprecision mediump float;\nuniform vec2 uRes;\nuniform vec2 uImg;\nuniform sampler2D uTex;\nuniform vec3 uPonto;\nuniform float uRaio;\nuniform float uLente;\nuniform vec3 uPapel;\nuniform vec3 uTinta;\n\nvec3 ler(vec2 px){\n  float s=max(uRes.x/uImg.x,uRes.y/uImg.y);\n  vec2 tam=uImg*s;\n  vec2 uv=(px-(uRes-tam)*.5)/tam;\n  if(uv.x<0.||uv.y<0.||uv.x>1.||uv.y>1.)return uPapel;\n  vec4 c=texture2D(uTex,uv);\n  return mix(uPapel,c.rgb,c.a);\n}\n\nvoid main(){\n  vec2 px=vec2(gl_FragCoord.x,uRes.y-gl_FragCoord.y);\n  vec3 fora=ler(px);\n  float a=uPonto.z;\n  if(a<=0.){gl_FragColor=vec4(fora,1.);return;}\n  float R=uRaio*(.6+.4*a);\n  vec2 d=(px-uPonto.xy)/R;\n  float r=length(d);\n  float sombra=(1.-smoothstep(1.,1.14,r))*step(1.,r);\n  fora=mix(fora,uTinta,sombra*.14*a);\n  if(r>1.){gl_FragColor=vec4(fora,1.);return;}\n  float z=sqrt(max(0.,1.-r*r));\n  vec3 dentro=ler(uPonto.xy+d*R*(1.-uLente*a*z));\n  dentro=mix(dentro,uTinta,smoothstep(.78,1.,r)*.24*a);\n  float brilho=1.-smoothstep(0.,.28,length(d-vec2(-.36,-.42)));\n  dentro=mix(dentro,uPapel,brilho*brilho*.55*a);\n  float corte=smoothstep(1.,1.-1.5/R,r);\n  gl_FragColor=vec4(mix(fora,dentro,corte),1.);\n}\n`;\n\nexport interface TexturaSphereProps extends Omit<React.HTMLAttributes<HTMLDivElement>, \"children\"> {\n  /** A imagem debaixo da bolha. Fundo transparente vira papel. */\n  src: string;\n  /** Texto alternativo da imagem. */\n  alt?: string;\n  /**\n   * Quanto a bolha amplia o miolo.\n   * @min 0\n   * @max 90\n   * @step 1\n   */\n  strength?: number;\n  /**\n   * Raio da bolha, em % do lado menor.\n   * @min 10\n   * @max 50\n   * @step 1\n   */\n  radius?: number;\n  /**\n   * Nasce com o efeito armado no centro e volta pra lá quando o ponteiro sai.\n   * Sem isto, a peça parada é a foto pura: o efeito só existe com ponteiro.\n   */\n  resting?: boolean;\n}\n\nfunction compilar(gl: WebGLRenderingContext, frag: string): WebGLProgram | null {\n  const shader = (tipo: number, src: string) => {\n    const s = gl.createShader(tipo);\n    if (!s) return null;\n    gl.shaderSource(s, src);\n    gl.compileShader(s);\n    return gl.getShaderParameter(s, gl.COMPILE_STATUS) ? s : null;\n  };\n  const vs = shader(gl.VERTEX_SHADER, VERT);\n  const fs = shader(gl.FRAGMENT_SHADER, frag);\n  const p = gl.createProgram();\n  if (!vs || !fs || !p) return null;\n  gl.attachShader(p, vs);\n  gl.attachShader(p, fs);\n  gl.linkProgram(p);\n  gl.deleteShader(vs);\n  gl.deleteShader(fs);\n  return gl.getProgramParameter(p, gl.LINK_STATUS) ? p : null;\n}\n\nexport function TexturaSphere({\n  src,\n  alt = \"Imagem sob uma bolha de vidro\",\n  strength = 55,\n  radius = 26,\n  resting = false,\n  className,\n  ...props\n}: TexturaSphereProps) {\n  const wrapRef = React.useRef<HTMLDivElement>(null);\n  const params = React.useRef({ strength, radius });\n  params.current = { strength, radius };\n  const descanso = React.useRef(resting);\n  descanso.current = resting;\n  const redesenhar = React.useRef<() => void>(() => {});\n  const armar = React.useRef<() => void>(() => {});\n\n  React.useEffect(() => {\n    const wrap = wrapRef.current;\n    if (!wrap) return;\n    const canvas = document.createElement(\"canvas\");\n    canvas.setAttribute(\"aria-hidden\", \"true\");\n    canvas.className = \"absolute inset-0 block h-full w-full\";\n    wrap.appendChild(canvas);\n    const gl = canvas.getContext(\"webgl\", { antialias: false, alpha: false });\n    const prog = gl && compilar(gl, FRAG);\n    if (!gl || !prog) {\n      canvas.remove();\n      return;\n    }\n\n    const buf = gl.createBuffer();\n    gl.bindBuffer(gl.ARRAY_BUFFER, buf);\n    gl.bufferData(gl.ARRAY_BUFFER, new Float32Array([-1, -1, 3, -1, -1, 3]), gl.STATIC_DRAW);\n    gl.useProgram(prog);\n    const aPos = gl.getAttribLocation(prog, \"a_pos\");\n    gl.enableVertexAttribArray(aPos);\n    gl.vertexAttribPointer(aPos, 2, gl.FLOAT, false, 0, 0);\n    const u = (n: string) => gl.getUniformLocation(prog, n);\n    const U = {\n      res: u(\"uRes\"),\n      img: u(\"uImg\"),\n      tex: u(\"uTex\"),\n      ponto: u(\"uPonto\"),\n      raio: u(\"uRaio\"),\n      lente: u(\"uLente\"),\n      papel: u(\"uPapel\"),\n      tinta: u(\"uTinta\"),\n    };\n\n    const tex = gl.createTexture();\n    gl.bindTexture(gl.TEXTURE_2D, tex);\n    // 1×1 transparente até a imagem chegar: o primeiro quadro é só papel.\n    gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, 1, 1, 0, gl.RGBA, gl.UNSIGNED_BYTE, new Uint8Array(4));\n    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_S, gl.CLAMP_TO_EDGE);\n    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_T, gl.CLAMP_TO_EDGE);\n    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.LINEAR);\n    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.LINEAR);\n    gl.uniform1i(U.tex, 0);\n    gl.uniform2f(U.img, 1, 1);\n\n    const mq = window.matchMedia(\"(prefers-reduced-motion: reduce)\");\n    let dpr = 1;\n    let raf = 0;\n    // x/y é onde a bolha está; ax/ay é onde o cursor está.\n    const ponto = { x: 0, y: 0, ax: 0, ay: 0, forca: 0, alvo: 0 };\n\n    const cores = () => {\n      gl.uniform3fv(U.papel, resolveCssColor(\"var(--background)\", wrap));\n      gl.uniform3fv(U.tinta, resolveCssColor(\"var(--foreground)\", wrap));\n    };\n\n    const medir = () => {\n      // offsetWidth é a medida local: a vitrine escala o palco com transform.\n      dpr = Math.min(2, window.devicePixelRatio || 1);\n      canvas.width = Math.max(1, Math.round(wrap.offsetWidth * dpr));\n      canvas.height = Math.max(1, Math.round(wrap.offsetHeight * dpr));\n      gl.viewport(0, 0, canvas.width, canvas.height);\n    };\n\n    const desenhar = () => {\n      const p = params.current;\n      const r = Math.max(10, Math.min(50, p.radius)) / 100;\n      gl.uniform2f(U.res, canvas.width, canvas.height);\n      gl.uniform3f(U.ponto, ponto.x * dpr, ponto.y * dpr, ponto.forca);\n      gl.uniform1f(U.raio, Math.max(1, Math.min(canvas.width, canvas.height) * r));\n      gl.uniform1f(U.lente, Math.max(0, Math.min(90, p.strength)) / 100);\n      gl.drawArrays(gl.TRIANGLES, 0, 3);\n    };\n\n    const assentar = () => {\n      ponto.x = ponto.ax;\n      ponto.y = ponto.ay;\n      ponto.forca = ponto.alvo;\n    };\n\n    // O laço só vive enquanto a bolha cresce, murcha ou anda atrás do cursor.\n    const quadro = () => {\n      ponto.forca += (ponto.alvo - ponto.forca) * 0.14;\n      ponto.x += (ponto.ax - ponto.x) * 0.2;\n      ponto.y += (ponto.ay - ponto.y) * 0.2;\n      const parado =\n        Math.abs(ponto.alvo - ponto.forca) < 0.004 && Math.hypot(ponto.ax - ponto.x, ponto.ay - ponto.y) < 0.3;\n      if (parado) assentar();\n      desenhar();\n      raf = parado ? 0 : requestAnimationFrame(quadro);\n    };\n    const pedirQuadro = () => {\n      if (mq.matches) {\n        assentar();\n        desenhar();\n      } else if (!raf) raf = requestAnimationFrame(quadro);\n    };\n\n    // O repouso armado: o efeito fica no centro, sem ponteiro nenhum.\n    let dentro = false;\n    const repousar = () => {\n      ponto.ax = wrap.offsetWidth / 2;\n      ponto.ay = wrap.offsetHeight / 2;\n      ponto.alvo = 1;\n    };\n    armar.current = () => {\n      if (dentro) return;\n      if (descanso.current) repousar();\n      else ponto.alvo = 0;\n      pedirQuadro();\n    };\n\n    redesenhar.current = () => {\n      if (!raf) desenhar();\n    };\n\n    const mover = (e: PointerEvent) => {\n      dentro = true;\n      // Ponteiro em px locais: a vitrine escala o palco com transform.\n      const r = wrap.getBoundingClientRect();\n      const k = r.width ? wrap.offsetWidth / r.width : 1;\n      ponto.ax = (e.clientX - r.left) * k;\n      ponto.ay = (e.clientY - r.top) * k;\n      if (ponto.forca < 0.01) {\n        ponto.x = ponto.ax;\n        ponto.y = ponto.ay;\n      }\n      ponto.alvo = 1;\n      pedirQuadro();\n    };\n    const sair = () => {\n      dentro = false;\n      armar.current();\n    };\n\n    let vivo = true;\n    const img = new Image();\n    img.crossOrigin = \"anonymous\";\n    img.decoding = \"async\";\n    img.onload = () => {\n      if (!vivo) return;\n      gl.bindTexture(gl.TEXTURE_2D, tex);\n      gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, gl.RGBA, gl.UNSIGNED_BYTE, img);\n      gl.uniform2f(U.img, img.naturalWidth || 1, img.naturalHeight || 1);\n      desenhar();\n    };\n    img.src = src;\n\n    cores();\n    medir();\n    if (descanso.current) {\n      repousar();\n      assentar();\n    }\n    desenhar();\n\n    const ro = new ResizeObserver(() => {\n      medir();\n      if (descanso.current && !dentro) {\n        repousar();\n        assentar();\n      }\n      desenhar();\n    });\n    ro.observe(wrap);\n    const offTema = onThemeChange(() => {\n      cores();\n      desenhar();\n    });\n    wrap.addEventListener(\"pointermove\", mover);\n    wrap.addEventListener(\"pointerleave\", sair);\n\n    return () => {\n      vivo = false;\n      img.onload = null;\n      cancelAnimationFrame(raf);\n      ro.disconnect();\n      offTema();\n      wrap.removeEventListener(\"pointermove\", mover);\n      wrap.removeEventListener(\"pointerleave\", sair);\n      redesenhar.current = () => {};\n      armar.current = () => {};\n      gl.deleteTexture(tex);\n      gl.deleteBuffer(buf);\n      gl.deleteProgram(prog);\n      gl.getExtension(\"WEBGL_lose_context\")?.loseContext();\n      canvas.remove();\n    };\n  }, [src]);\n\n  React.useEffect(() => {\n    redesenhar.current();\n  }, [strength, radius]);\n\n  React.useEffect(() => {\n    armar.current();\n  }, [resting]);\n\n  return (\n    <div\n      ref={wrapRef}\n      role=\"img\"\n      aria-label={alt}\n      className={cn(\"relative block aspect-square w-full overflow-hidden bg-background\", className)}\n      {...props}\n    />\n  );\n}\n",
      "type": "registry:ui"
    }
  ],
  "meta": {
    "uso": {
      "quando": "Foto de produto com uma lupa de vidro sob o cursor, pra mostrar detalhe em hero ou página de produto",
      "evite": "Pele puxada pro cursor: textura-pinch; lupa com retícula de jornal, shader-halftone"
    }
  },
  "categories": [
    "shaders",
    "textura",
    "webgl",
    "ponteiro",
    "imagem",
    "lupa",
    "fisheye"
  ],
  "type": "registry:ui"
}