{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "textura-beam",
  "title": "Textura Beam",
  "author": "Visant Labs <visantsupply@gmail.com>",
  "description": "Facho de luz que desce do alto com poeira boiando dentro e que mira o cursor.",
  "dependencies": [],
  "registryDependencies": [
    "utils",
    "@visant/css-color"
  ],
  "files": [
    {
      "path": "registry/visant/ui/textura-beam.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 Beam — um facho de luz que desce do alto, com poeira boiando\n * dentro, e que mira o ponteiro como canhão de palco seguindo o ator. Fundo\n * de dobra de lançamento, de \"em breve\" ou de palco de evento.\n *\n * Original da Visant Labs, família texturas: superfície que reage ao ponteiro,\n * um gesto só.\n *\n * ── As decisões que não se veem ────────────────────────────────────────────\n *\n * 1. **A fonte fica fora do quadro.** O canhão está acima da borda de cima, no\n *    meio; só o cone entra na cena. Fonte visível vira desenho de lâmpada, e\n *    a peça é a luz, não o equipamento.\n * 2. **A poeira só existe dentro da luz.** Os grãos estão no quadro inteiro,\n *    mas cada um é multiplicado pela intensidade do facho naquele ponto: como\n *    na vida, só se vê a poeira que a luz pega. Mover o facho \"revela\" poeira\n *    nova em vez de arrastar a mesma.\n * 3. **Duas camadas de poeira.** Uma fina e lenta, outra maior e mais rápida,\n *    com escalas diferentes: dá profundidade sem nenhum 3D.\n * 4. **O cone enfraquece com a distância** e ganha um foco no alvo, a mancha\n *    onde a luz \"bate\". Cone uniforme lê como triângulo chapado.\n * 5. **O laço dorme.** A poeira pede tempo, então há laço, mas ele para fora da\n *    tela. Com movimento reduzido: um quadro parado, que só refaz quando o\n *    ponteiro mexe (o facho pula, sem deriva). Sem ponteiro, aponta pra baixo.\n */\n\nconst VERT = `attribute vec2 a_pos;void main(){gl_Position=vec4(a_pos,0.0,1.0);}`;\n\nconst FRAG = `\n#ifdef GL_FRAGMENT_PRECISION_HIGH\nprecision highp float;\n#else\nprecision mediump float;\n#endif\nuniform vec2 uRes;\nuniform vec2 uAlvo;\nuniform float uAbre;\nuniform float uTime;\nuniform float uPoeira;\nuniform vec3 uFundo;\nuniform vec3 uLuz;\nuniform vec3 uGrao;\n\nvec2 hash(vec2 p){\n  p=vec2(dot(p,vec2(127.1,311.7)),dot(p,vec2(269.5,183.3)));\n  return fract(sin(p)*43758.5453);\n}\n\nfloat poeira(vec2 q,float escala,vec2 deriva,float raio){\n  vec2 p=q*escala+deriva;\n  vec2 id=floor(p);\n  vec2 f=fract(p);\n  vec2 h=hash(id);\n  vec2 o=.2+.6*h+.12*vec2(sin(uTime*.7+h.x*6.3),cos(uTime*.5+h.y*6.3));\n  float d=length(f-o)*uRes.y/escala;\n  float pisca=.5+.5*sin(uTime*(1.+h.y*2.)+h.x*6.3);\n  return (1.-smoothstep(raio*.4,raio,d))*step(.45,h.y)*(.5+.5*pisca);\n}\n\nvoid main(){\n  vec2 px=vec2(gl_FragCoord.x,uRes.y-gl_FragCoord.y);\n  vec2 fonte=vec2(uRes.x*.5,-uRes.y*.18);\n  vec2 eixo=normalize(uAlvo-fonte);\n  vec2 v=px-fonte;\n  float ao=dot(v,eixo);\n  float pe=dot(v,vec2(-eixo.y,eixo.x));\n  float ang=atan(abs(pe),max(ao,1.));\n  float cone=(1.-smoothstep(uAbre*.55,uAbre,ang))*step(0.,ao);\n  float queda=1./(1.+ao/uRes.y*.9);\n  vec2 dz=(px-uAlvo)/uRes.y;\n  float foco=exp(-dot(dz,dz)*28.)*cone;\n  float luz=cone*queda*.62+foco*.35;\n  vec3 col=mix(uFundo,uLuz,luz);\n\n  vec2 q=px/uRes.y;\n  float s=uRes.y/600.;\n  float g=poeira(q,22.,vec2(uTime*.05,-uTime*.12),2.2*s);\n  g=max(g,poeira(q,11.,vec2(-uTime*.04,-uTime*.22),3.6*s)*.8);\n  col=mix(col,uGrao,g*min(1.,luz*1.8)*uPoeira);\n  gl_FragColor=vec4(col,1.);\n}\n`;\n\n/** Paradas padrão: fundo, luz, poeira. Tudo token. */\nconst CORES_PADRAO = [\n  \"var(--background)\",\n  \"color-mix(in oklab, var(--brand) 85%, var(--background))\",\n  \"color-mix(in oklab, var(--brand) 40%, var(--foreground))\",\n];\n\nexport interface TexturaBeamProps extends Omit<React.HTMLAttributes<HTMLDivElement>, \"children\"> {\n  /**\n   * Abertura do facho.\n   * @min 0\n   * @max 100\n   * @step 1\n   */\n  width?: number;\n  /**\n   * Quanta poeira boia na luz.\n   * @min 0\n   * @max 100\n   * @step 1\n   */\n  dust?: number;\n  /**\n   * Velocidade da poeira.\n   * @min 0\n   * @max 100\n   * @step 1\n   */\n  speed?: number;\n  /** Paradas: fundo, luz e poeira. Qualquer cor CSS ou token. */\n  colors?: string[];\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 TexturaBeam({\n  width = 40,\n  dust = 60,\n  speed = 30,\n  colors,\n  className,\n  ...props\n}: TexturaBeamProps) {\n  const wrapRef = React.useRef<HTMLDivElement>(null);\n  const params = React.useRef({ width, dust, speed });\n  params.current = { width, dust, speed };\n  const redesenhar = React.useRef<() => void>(() => {});\n  const coresChave = (colors ?? CORES_PADRAO).join(\"|\");\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      alvo: u(\"uAlvo\"),\n      abre: u(\"uAbre\"),\n      time: u(\"uTime\"),\n      poeira: u(\"uPoeira\"),\n      fundo: u(\"uFundo\"),\n      luz: u(\"uLuz\"),\n      grao: u(\"uGrao\"),\n    };\n\n    const mq = window.matchMedia(\"(prefers-reduced-motion: reduce)\");\n    let reduzido = mq.matches;\n    let visivel = false;\n    let raf = 0;\n    let ultimo = 0;\n    let tempo = 3;\n    let dpr = 1;\n    let dentro = false;\n    const alvo = { x: 0, y: 0 };\n    const mira = { x: 0, y: 0 };\n\n    const cores = () => {\n      const [a, b, c] = coresChave.split(\"|\").map((cor) => resolveCssColor(cor, wrap));\n      gl.uniform3fv(U.fundo, a);\n      gl.uniform3fv(U.luz, b ?? a);\n      gl.uniform3fv(U.grao, c ?? b ?? a);\n    };\n\n    // Sem ponteiro, o facho desce reto até o chão.\n    const repousar = () => {\n      alvo.x = canvas.width * 0.5;\n      alvo.y = canvas.height * 0.85;\n    };\n\n    const medir = () => {\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      if (!dentro) {\n        repousar();\n        Object.assign(mira, alvo);\n      }\n    };\n\n    const desenhar = () => {\n      const p = params.current;\n      gl.uniform2f(U.res, canvas.width, canvas.height);\n      gl.uniform2f(U.alvo, mira.x, mira.y);\n      // 0 → 6° de meia-abertura, 100 → 32°\n      gl.uniform1f(U.abre, ((6 + (p.width / 100) * 26) * Math.PI) / 180);\n      gl.uniform1f(U.time, tempo);\n      gl.uniform1f(U.poeira, p.dust / 100);\n      gl.drawArrays(gl.TRIANGLES, 0, 3);\n    };\n\n    const quadro = (agora: number) => {\n      const dt = ultimo ? Math.min(0.05, (agora - ultimo) / 1000) : 0;\n      ultimo = agora;\n      tempo += dt * (0.1 + (params.current.speed / 100) * 2);\n      const k = 1 - Math.pow(0.9, dt * 60);\n      mira.x += (alvo.x - mira.x) * k;\n      mira.y += (alvo.y - mira.y) * k;\n      desenhar();\n      raf = visivel && !reduzido ? requestAnimationFrame(quadro) : 0;\n    };\n\n    const ligar = () => {\n      if (!raf && visivel && !reduzido) {\n        ultimo = 0;\n        raf = requestAnimationFrame(quadro);\n      }\n    };\n    const desligar = () => {\n      cancelAnimationFrame(raf);\n      raf = 0;\n    };\n\n    redesenhar.current = () => {\n      if (!raf) desenhar();\n    };\n\n    const mover = (e: PointerEvent) => {\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      alvo.x = (e.clientX - r.left) * k * dpr;\n      alvo.y = (e.clientY - r.top) * k * dpr;\n      dentro = true;\n      if (reduzido) {\n        Object.assign(mira, alvo);\n        desenhar();\n      }\n    };\n    const sair = () => {\n      dentro = false;\n      repousar();\n      if (reduzido) {\n        Object.assign(mira, alvo);\n        desenhar();\n      }\n    };\n    const trocarMovimento = () => {\n      reduzido = mq.matches;\n      if (reduzido) {\n        desligar();\n        desenhar();\n      } else ligar();\n    };\n\n    cores();\n    medir();\n    desenhar();\n\n    const ro = new ResizeObserver(() => {\n      medir();\n      desenhar();\n    });\n    ro.observe(wrap);\n    const io = new IntersectionObserver(([e]) => {\n      visivel = e.isIntersecting;\n      if (visivel) ligar();\n      else desligar();\n    });\n    io.observe(wrap);\n    const offTema = onThemeChange(() => {\n      cores();\n      desenhar();\n    });\n    mq.addEventListener(\"change\", trocarMovimento);\n    wrap.addEventListener(\"pointermove\", mover);\n    wrap.addEventListener(\"pointerleave\", sair);\n\n    return () => {\n      desligar();\n      ro.disconnect();\n      io.disconnect();\n      offTema();\n      mq.removeEventListener(\"change\", trocarMovimento);\n      wrap.removeEventListener(\"pointermove\", mover);\n      wrap.removeEventListener(\"pointerleave\", sair);\n      redesenhar.current = () => {};\n      gl.deleteBuffer(buf);\n      gl.deleteProgram(prog);\n      gl.getExtension(\"WEBGL_lose_context\")?.loseContext();\n      canvas.remove();\n    };\n  }, [coresChave]);\n\n  React.useEffect(() => {\n    redesenhar.current();\n  }, [width, dust, speed]);\n\n  return (\n    <div\n      ref={wrapRef}\n      role=\"img\"\n      aria-label=\"Facho de luz com poeira que mira o cursor\"\n      className={cn(\"relative block aspect-[16/10] w-full overflow-hidden bg-background\", className)}\n      {...props}\n    />\n  );\n}\n",
      "type": "registry:ui"
    }
  ],
  "meta": {
    "uso": {
      "quando": "Fundo de palco com um facho de luz e poeira que mira o cursor, em abertura de evento, lançamento ou música",
      "evite": "Brilho macio sem direção: textura-glow; cortina de palco, textura-curtain"
    }
  },
  "categories": [
    "efeitos",
    "textura",
    "webgl",
    "fundo",
    "ponteiro",
    "facho",
    "luz",
    "poeira"
  ],
  "type": "registry:ui"
}