Communitygithub.com

liquid-glass-all

Implementação completa do Liquid Glass da Apple WWDC25: 26 propriedades de material + 82 ações (clique/duplo clique/toque longo/clique direito/arrastar/inércia/sombra fantasma/expandir-recolher/separar-mesclar/fusão/teclado/acessibilidade/rolagem nas bordas).

O que é liquid-glass-all?

Esta skill fornece uma implementação funcional completa de um elemento de interface do usuário no estilo Liquid Glass (vidro líquido), inspirado nas demonstrações da Apple WWDC25. O arquivo único `liquid-glass-all.html` utiliza WebGL para renderizar todo o efeito de vidro, incluindo refração, espessura, efeito Fresnel, dispersão cromática, brilho interno e muito mais, diretamente no fragment shader. Com 82 ações de interação diferentes, como clique, duplo clique, toque longo, arrasto com inércia e menus contextuais, e suporte a teclado e acessibilidade, a skill é ideal para desenvolvedores que desejam adicionar interfaces de vidro sofisticadas e responsivas a projetos web. A implementação é validada por um teste automático interno (`?selftest=1`) e usa 2 programas de shader com 10 chamadas de draw, garantindo desempenho previsível. O documento SKILL.md descreve detalhadamente o modelo óptico, a máquina de estados, as 7 etapas do traçado de raios e 8 armadilhas comuns, servindo como guia completo para modificação e extensão.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Cyt-56/liquid-glass-webgl/tree/HEAD/skill

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Liquid Glass · Implementação Completa

Implementação em arquivo único com WebGL. Toda a refração, espessura, efeito Fresnel, dispersão cromática, brilho de borda e brilho interno do vidro são calculados no fragment shader. O DOM contém apenas texto, botões e sombras projetadas. Não escreva shaders do zero: 90 linhas são suficientes para rodar, mas escrever 400 linhas do zero tem taxa de sucesso extremamente baixa. Modifique a partir de liquid-glass-all.html.

0. Caminho Mais Rápido (ver o efeito em 1 minuto)

  1. Abra liquid-glass-all.html no Chrome / Edge.
  2. O painel de controle à direita tem 5 controles deslizantes (refract / mag / rim / disp / tint) + 4 botões de receita. Altere e veja a mudança imediatamente.
  3. Todas as ações estão lá: clique na cápsula para expandir, pressione e arraste, toque longo para bolhas, clique direito para outro menu, duplo clique para levantar, botão de separação do Dock, teclas de atalho Espaço/S/W/Esc.
  4. Use o teste automático interno: adicione ?selftest=1 ao final do URL. O canto superior esquerdo da página exibirá 13 linhas PASS / FAIL.
  5. Captura de tela posada: ?pose=1 posiciona a interface no estado "Expandido + Separado + Bolhas"; ?pose&wire=1 adiciona o campo de diagnóstico óptico.
chrome --headless=new --enable-unsafe-swiftshader --virtual-time-budget=6000 ^
  --window-size=1280,800 --screenshot=out.png "file:///<caminho_absoluto>/liquid-glass-all.html?selftest=1"

Após a captura de tela, realmente leia a imagem para confirmar que o canto superior esquerdo mostra FAIL 0. Não confie apenas no código para declarar sucesso.

1. Ativos

liquid-glass-all/
├── SKILL.md                       # Este arquivo: caminhos, ações, traçado de raios, armadilhas, validação
├── liquid-glass-all.html          # Implementação completa (único artefato de execução)
└── references/
    ├── action-matrix.md           # Tabela completa das 82 ações (gatilho / o que muda / parâmetros / reversão)
    ├── feature-matrix.md          # 26 propriedades de material × cobertura desta implementação
    ├── optics-model.md            # Modelo físico do traçado de raios e constantes (leitura obrigatória antes de escrever shaders)
    └── interaction-playbook.md    # Máquina de estados, temporização, teste de colisão, validação

2. Referência Rápida das 82 Ações (9 Categorias)

A tabela completa está em references/action-matrix.md. Aqui está apenas o esqueleto:

CategoriaQtdConteúdo
A Ponteiro13Hover entrada/movimento/saída, atenuação de vizinhança, press, release, clique, início de arrasto/seguimento/retorno elástico, clamp de borda, menu de clique direito, menu de toque longo
B Arrasto com Inércia6Esticamento direcional, translação elástica, atenuação de deformação, deslize inercial, levantamento ao arrastar, sombra fantasma com atraso
C Morfologia10Expandir/recolher, fade-in de itens de menu, arredondamento acompanhante, separar/crescimento da peça direita/mesclar, acento de divisão, salto de largura zero, pescoço de fusão
D Feedback de Pressão8Retração, aumento de refração, aumento de espessura, brilho interno, propagação para placa vizinha, brilho do arco inferior, destaque direcional, flash de orientação
E Animação Óptica8Três modos de refração, alternância de variante, mapeamento de matiz, inversão claro/escuro, cor de ambiente vazada, sombra adaptativa, esmaecimento por desfoco, deriva de manchas de fundo
F Adaptabilidade7Amostragem de brilho/cor principal, upload de fundo, resolução adaptativa, atualização do traçado de raios, limite máximo de DPR, cadeia de degradação
G Sistema e Acessibilidade8Reorganização em resize, rolagem soft/hard, três switches de acessibilidade, perda de foco da janela, anel de foco Tab, semântica para leitores de tela
H Controles8Botão de ação principal, 5 controles deslizantes, segmentação de variante, três botões de modo, 4 switches, 4 receitas, botão de separação, cabeçalho de expansão
K Teclado7Espaço / S / W / Esc / Tab / ↑↓ / Enter

Barra de monitoramento de ações na parte inferior da página: cada ação gera um ponto e exibe os 4 eventos mais recentes, para confirmar "essa ação realmente foi acionada".

3. Sete Etapas do Traçado de Raios (a ordem não pode ser alterada)

  1. Contorno: sdRoundBox calcula a distância com sinal d; x = clamp(-d/band, 0, 1), 0 = contorno, 1 = centro, band = max(5, min(hx,hy)*0.30).
  2. Campo de altura convexa: H(x)=sqrt(1-(1-x)²), H'(x)=v/sqrt(1-v²) (v=clamp(1-x,0.02,0.9995)). Use sqrt, não pow.
  3. Ângulo de incidência: sinI = min(H'/sqrt(1+H'²), 0.62), thT = asin(sinI/1.5168). 0.62 é o limite superior rígido; definir como 0.93 empurra a borda para 200px, escurecendo todo o bloco.
  4. Espessura: tpx = mdim*(0.05+0.28*H)*(1+0.40*thick)*vg, vg = 1+0.24*(1-smoothstep(-0.85,0.35,q.y)) (mais espesso embaixo, mais fino em cima).
  5. Deslocamento: off = -dir*tan(thI-thT)*tpx*refract*Tf, mais termo de ajuste de borda; no final clamp(off,-10,10).
  6. Foco/lábio: focal = mag*magMul*(0.50*cW - 0.40*eW); 1-focal deve ser sempre positivo, caso contrário haverá inversão local de 180°, texto de cabeça para baixo. magMul é definido no nível do painel: lens 1.30 / capsule 0.85 / plate 0.55 / nav 0.90 / dock 0.80.
  7. Composição: sp = c + rel*(1-focal) - off; amostragem RGB separada por ±disp*7*eW; depois compressão de brilho com matiz 0.58*L+0.133, cor de ambiente vazada 0.10, borda Fresnel, branco leitoso, espelho no topo, arco inferior, brilho interno.

A textura Y deve ser invertida: uv0 = vec2(sp.x/uRes.x, 1.0 - sp.y/uRes.y). Pular esta linha resulta em imagem espelhada + texto invertido.

4. Máquina de Estados e Limiares Críticos

AçãoLimiar / Parâmetro
hoverDentro do painel; fora do painel, atenuação fade em 180px
presspress→1 (k=0.19/frame), scale 0.965, refração ×1.3, arco inferior ×1.75
Cliquepointerup e deslocamento ≤4px → atraso de 240ms para acionar, evitando conflito com duplo clique
Duplo cliqueDois pointerdown com intervalo <300ms; no segundo down, cancela imediatamente o timer de clique simples
Toque longo500ms após pointerdown; movimento >4px cancela; ponto de progresso ampliado no ponto de contato
ArrastoDeslocamento >4px inicia arrasto; clamp de margem interna de 8px
InérciaVelocidade na soltura >6px/evento → começa com v*1.05, multiplica por 0.94 a cada frame, termina quando <1px e ancora
Expandir136×48 → 236×296, base fixa: ty = lay.y + lay.h - 296; itens de menu com fade-in de altura 110→250, pointerEvents ativado somente após metade
SepararDock 300 → esquerda 140; peça direita tx fixada em lay.x + lay.w - 140, largura 0→140
MesclarPeça direita primeiro reduz a largura, mantendo a posição (evita "deslizar")
FusãoApós separar, as duas peças mantêm uma lacuna de 20px; os rims se acoplam mutuamente; união real metaball requer SDF smooth-min, não implementado na versão single-pass Web
MolaPosição ω=15, largura ω=18.5, ζ=0.66, dt=1/60 → ~0.45s, 6% de overshoot

5. Receitas de Parâmetros

Desejadorefractmagrimdisptintthick
Cápsula de vidro grosso1.200.350.950.220.24✓
Lente com faixa colorida1.500.601.000.180.10✓
Tampa de vidro grosso com texto pequeno1.250.420.800.300.16✓
Navegação superior (contida)0.900.200.600.150.10✗
Painel de controle (legível)1.000.150.550.120.14✗

Ordem de ajuste: refract para deslocamento → mag para lábio → rim para borda → disp/tint para textura. A ordem inversa sempre causa conflitos.

6. Oito Armadilhas Obrigatórias

  1. Arrays uniform não são confiáveis: uGeo[12] no ANGLE/D3D não gera erro de atribuição, mas não funciona → um draw call por painel.
  2. Branches uniform dentro de loops são otimizados: Use mix / step para escrita sem branches.
  3. Uniforms não utilizados são otimizados: getUniformLocation retorna null, gerando falsos relatórios de falta de uniform.
  4. gl.getUniform(prog, null) lança TypeError: O código restante do frame é todo ignorado (parece travamento).
  5. Eixo Y da textura: Não inverter resulta em imagem espelhada + texto invertido.
  6. Apenas click perde eventos: Use pointerdown + pointerup + limite de deslocamento.
  7. half é palavra reservada do GLSL ES: Escrever vec2 half causa falha de compilação, relatório apenas "syntax error". Palavras semelhantes: filter, input, output, long, short, packed.
  8. smoothstep com ordem inversa é comportamento indefinido: smoothstep(1.0,-1.0,d) falha em diferentes máquinas; sempre escreva 1.0 - smoothstep(pequeno,grande,x).

Mais duas armadilhas específicas da camada de ação:

  • Após toque longo, soltar o dedo não pode contar como clique (marcar longFired), caso contrário, ao abrir o menu de toque longo, um clique de expansão ocorrerá imediatamente.
  • Clique direito deve ser interceptado antes de pointerdown (e.button !== 0 retornar diretamente), caso contrário, o clique direito iniciará um arrasto.

7. Validação (Execute após cada modificação)

?selftest=1 cobre 13 itens: clique para expandir/recolher, toque longo para bolhas, Esc fecha bolhas, clique direito para outro menu, separação e mesclagem do Dock, pescoço de fusão, seleção com teclas direcionais, Esc recolhimento global, duplo clique para levantar, inércia, campo de raios W.

Confirme manualmente:

  • Conteúdo dentro do vidro na orientação correta (sem inversão, sem espelhamento)
  • Borda com rim, espelho no topo e arco inferior brilhante estão todos presentes
  • Em fundo escuro, o interior do vidro não é preto sólido (tem um tom cinza nebuloso)
  • Durante o arrasto, a sombra fantasma tem atraso; ao soltar, há inércia antes de ancorar
  • Ao separar, as duas peças "se partem", não "se afastam puxando"
  • Texto rolante desaparece gradualmente nas bordas; na extremidade, corta para modo hard (linha fina de cabelo)
  • Todos os três switches de acessibilidade funcionam (reduzir transparência / aumentar contraste / reduzir movimento)

8. Orçamento de Desempenho

ItemOrçamento
Painéis de vidro na tela≤10 (esta implementação usa 10, incluindo bubble/bridge com largura zero que aparecem sob demanda)
Draw calls2 programas + 1 AABB draw por painel
Upload de fundoA cada 5 frames; estático pode ser a cada 8 frames
Amostragem de brilhoA cada 10 frames, apenas painéis com w*h > 24000
Fator de renderização<42fps → 0.72, >56fps → 1.0, DPR máximo 2
Cadeia de degradaçãoReduzir painéis → reduzir fator → reduzir upload → desligar dispersão cromática → recorrer a versão CSS

9. Linhas Vermelhas e Limites da Plataforma

  • O vidro está apenas na camada de navegação; a camada de conteúdo não recebe vidro.
  • Não empilhe vidro (perde referência de refração, parece sujeira); Regular e Clear não podem ser misturados na mesma tela.
  • tint apenas para ações principais; brilho contido, rim > 1.2 parece falso.
  • O que a Web não pode fazer: Texto/ícones sobre vidro não são refratados pelo próprio vidro (isso é feito no pipeline de composição do iOS 26); o fallback CSS não consegue reproduzir o lábio de lente e a dispersão cromática pixel a pixel.
  • Não coberto pela versão de desenho próprio: União real metaball (esta implementação usa aproximação de pescoço estreito), iluminação por inclinação do dispositivo, estatísticas de cor principal quadro a quadro de vídeo ao vivo.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas