{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "textura-twist",
  "title": "Textura Twist",
  "author": "Visant Labs <visantsupply@gmail.com>",
  "description": "A imagem gira em redemoinho em volta do ponteiro e se desfaz devagar quando ele sai.",
  "dependencies": [],
  "registryDependencies": [
    "utils",
    "@visant/css-color"
  ],
  "files": [
    {
      "path": "registry/visant/ui/textura-twist.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 Twist — a imagem gira em redemoinho em volta do ponteiro, como\n * tinta mexida com um palito. O miolo dá a volta inteira, a borda quase não\n * sai do lugar, e quando o cursor sai o redemoinho se desfaz devagar até a\n * foto voltar a ser foto.\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. **Girar a amostra, não a imagem.** Cada pixel lê a foto num ponto\n *    girado em volta do cursor por um ângulo que depende só da distância.\n *    Pixel nenhum se perde nem se repete, então o redemoinho nunca abre\n *    buraco de papel no meio da foto.\n * 2. **A queda é ao quadrado.** O ângulo cai com `(1 − r)²` suavizado: o\n *    miolo torce muito e a borda do raio chega a zero com derivada zero.\n *    Queda linear deixaria um vinco visível no círculo do raio.\n * 3. **Desfazer é o mesmo gesto ao contrário.** A saída não troca de\n *    efeito: a força cai devagar e o redemoinho destorce pelo mesmo caminho\n *    que torceu, em vez de sumir com um corte.\n * 4. **O ponteiro também desliza.** A posição corre atrás do cursor com uma\n *    fração por quadro, então o redemoinho arrasta a tinta. Quando ele\n *    começa do zero, a posição salta direto para o cursor.\n * 5. **Sem laço à toa.** Desenha na carga, no tema, no tamanho e no knob. O\n *    laço só existe enquanto o redemoinho torce, destorce ou anda, e com\n *    movimento reduzido ele salta direto para o estado final.\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 vec3 uPapel;\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  vec2 d=px-uPonto.xy;\n  float r=length(d)/uRaio;\n  vec2 amostra=px;\n  if(r<1.){\n    float q=1.-smoothstep(0.,1.,r);\n    float a=uPonto.z*q*q;\n    float c=cos(a);\n    float s=sin(a);\n    amostra=uPonto.xy+mat2(c,s,-s,c)*d;\n  }\n  gl_FragColor=vec4(ler(amostra),1.);\n}\n`;\n\nexport interface TexturaTwistProps extends Omit<React.HTMLAttributes<HTMLDivElement>, \"children\"> {\n  /** A imagem a torcer. Fundo transparente vira papel. */\n  src: string;\n  /** Texto alternativo da imagem. */\n  alt?: string;\n  /**\n   * Quanto o miolo gira, em graus.\n   * @min 0\n   * @max 720\n   * @step 15\n   */\n  angle?: number;\n  /**\n   * Raio do redemoinho, em % do lado menor.\n   * @min 10\n   * @max 70\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 TexturaTwist({\n  src,\n  alt = \"Imagem em redemoinho\",\n  angle = 300,\n  radius = 38,\n  resting = false,\n  className,\n  ...props\n}: TexturaTwistProps) {\n  const wrapRef = React.useRef<HTMLDivElement>(null);\n  const params = React.useRef({ angle, radius });\n  params.current = { angle, 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      papel: u(\"uPapel\"),\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 o redemoinho 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    };\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 giro = (Math.max(0, Math.min(720, p.angle)) * Math.PI) / 180;\n      const r = Math.max(10, Math.min(70, p.radius)) / 100;\n      gl.uniform2f(U.res, canvas.width, canvas.height);\n      gl.uniform3f(U.ponto, ponto.x * dpr, ponto.y * dpr, giro * ponto.forca);\n      gl.uniform1f(U.raio, Math.max(1, Math.min(canvas.width, canvas.height) * r));\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 o redemoinho torce, destorce ou anda.\n    const quadro = () => {\n      // Torce mais rápido do que destorce: desfazer pede calma.\n      const passo = ponto.alvo > ponto.forca ? 0.1 : 0.06;\n      ponto.forca += (ponto.alvo - ponto.forca) * passo;\n      ponto.x += (ponto.ax - ponto.x) * 0.18;\n      ponto.y += (ponto.ay - ponto.y) * 0.18;\n      const parado =\n        Math.abs(ponto.alvo - ponto.forca) < 0.003 && 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  }, [angle, 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 que gira em redemoinho sob o cursor, em hero de música, evento ou campanha psicodélica",
      "evite": "Pele beliscada sem giro: textura-pinch; foto escorrendo em ruído, textura-warp"
    }
  },
  "categories": [
    "shaders",
    "textura",
    "webgl",
    "ponteiro",
    "imagem",
    "redemoinho",
    "distorcao"
  ],
  "type": "registry:ui"
}