Communitygithub.com

liquid-glass-all

Implementación completa de Liquid Glass de Apple WWDC25: 26 propiedades de material + 82 acciones (click/doble click/presión larga/click derecho/arrastre/impulso/sombra fantasma/expandir/contraer/separar/combinar/fundir/teclado/accesibilidad/desplazamiento en bordes). Úsalo cuando el usuario pida vidrio líquido de Apple, interfaz de vidrio esmerilado, vidrio refractivo transparente, botones, menús o Dock Liquid Glass, o necesite realimentación por presión, deformación o análisis de trayectoria óptica.

¿Qué es liquid-glass-all?

Esta skill implementa un componente de vidrio líquido completo y autónomo para la web, inspirado en el diseño Liquid Glass de Apple WWDC25. Consiste en un único archivo HTML (`liquid-glass-all.html`) que utiliza WebGL con shaders de fragmentos para lograr efectos ópticos realistas: refracción, grosor, Fresnel, dispersión cromática y brillo interno, todo calculado en la GPU. Soporta más de 80 interacciones diferentes, incluyendo clics, doble clic, presión larga, arrastre con inercia, expansión/contracción de menús, separación/fusión de elementos tipo Dock, y eventos de teclado. Además, incorpora características de accesibilidad y adaptación a diferentes contextos de uso. Incluye un modo de autocomprobación (`?selftest=1`) que verifica 13 funcionalidades clave. Está optimizado para rendimiento, con un presupuesto de hasta 10 paneles de vidrio en pantalla y un sistema de degradación automática que reduce la calidad si la tasa de fotogramas baja de 42 FPS. Es ideal para desarrolladores que necesitan implementar rápidamente interfaces de usuario sofisticadas con efecto vidrio sin escribir shaders desde cero.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Liquid Glass · Implementación completa

Implementación WebGL en un solo archivo. La refracción, el grosor, el Fresnel, la dispersión y el brillo interno del vidrio se calculan completamente en el shader de fragmentos; el DOM solo contiene texto, botones y sombras. No escribas shaders desde cero: 90 líneas son suficientes, pero 400 líneas desde cero tienen una probabilidad de éxito extremadamente baja. Modifica liquid-glass-all.html.

0. Ruta más rápida (1 minuto para ver el efecto)

  1. Abre liquid-glass-all.html en Chrome / Edge.
  2. El panel de control derecho tiene 5 deslizadores (refract / mag / rim / disp / tint) + 4 botones de receta. Al cambiarlos verás los cambios al instante.
  3. Todas las acciones están ahí: haz clic en una cápsula para expandirla, mantén presionado para arrastrar, presión larga para burbujas, clic derecho para otro menú, doble clic para elevar, tecla de separación del Dock, teclado Espacio/S/W/Esc.
  4. Verificación con la autocomprobación incorporada: añade ?selftest=1 a la URL; en la esquina superior izquierda de la página aparecerán 13 resultados PASS / FAIL.
  5. Captura de pantalla para mostrar: ?pose=1 muestra una pose con «expandido + separado + burbujas»; ?pose&wire=1 añade un campo de diagnóstico de trayectoria óptica.
chrome --headless=new --enable-unsafe-swiftshader --virtual-time-budget=6000 ^
  --window-size=1280,800 --screenshot=out.png "file:///<ruta_absoluta>/liquid-glass-all.html?selftest=1"

Después de la captura, revisa realmente la imagen y confirma que en la esquina superior izquierda aparece FAIL 0. No te fíes solo del código para decir que está completo.

1. Activos

liquid-glass-all/
├── SKILL.md                       # Este archivo: rutas, acciones, trayectoria óptica, errores comunes, verificación
├── liquid-glass-all.html          # Implementación completa (único producto ejecutable)
└── references/
    ├── action-matrix.md           # Tabla completa de las 82 acciones (desencadenante / qué cambia / parámetros / inversa)
    ├── feature-matrix.md          # 26 propiedades de material × cobertura de esta implementación
    ├── optics-model.md            # Modelo físico de la trayectoria óptica y constantes (lectura obligatoria antes de escribir shaders)
    └── interaction-playbook.md    # Máquina de estados, temporización, pruebas de acierto, verificación

2. Resumen rápido de las 82 acciones (9 categorías)

La tabla completa está en references/action-matrix.md. Aquí solo la estructura:

CategoríaCantidadContenido
A Puntero13hover entrada/movimiento/salida, atenuación de vecindad, press, release, clic, inicio de arrastre/seguimiento/rebote, límite de borde, menú contextual, menú de presión larga
B Arrastre con inercia6estiramiento direccional, traslación elástica, atenuación de deformación, deslizamiento inercial, elevación por arrastre, sombra fantasma con retardo
C Morfología Morph10expandir/contraer, fundido de entrada de elementos de menú, seguimiento de esquinas redondeadas, separación/aparición del lado derecho/fusión, acento de división, salto de ancho cero, cuello de conexión por fusión
D Realimentación por presión8contracción, aumento de refracción, aumento de grosor, brillo interno, propagación a paneles vecinos, brillo del arco inferior, resaltado direccional, flash indicador
E Animaciones ópticas8tres modos de refracción, cambio de variante, mapeo tint, inversión claro/oscuro, color de derrame ambiental, sombra adaptativa, desvanecimiento por desenfoque, deriva de manchas de fondo
F Adaptación7muestreo de brillo/color principal, subida de fondo, resolución adaptativa, actualización de trayectoria óptica, límite DPR, cadena de degradación
G Sistema y accesibilidad8reordenamiento por resize, desplazamiento soft/hard, tres interruptores de accesibilidad, pérdida de foco de ventana, anillo de foco Tab, semántica de lector de pantalla
H Controles8botón de operación principal, 5 deslizadores, segmentación de variantes, tres botones de modo, 4 interruptores, 4 recetas, botón de separación, cabezal de expansión
K Teclado7Espacio / S / W / Esc / Tab / ↑↓ / Enter

Barra de monitoreo de acciones en la parte inferior de la página: registra cada acción y muestra las últimas 4, para confirmar si «esto se activó o no».

3. Siete pasos de la trayectoria óptica (el orden no puede cambiar)

  1. Contorno: sdRoundBox obtiene la distancia con signo 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)). Usa sqrt, no pow.
  3. Ángulo de incidencia: sinI = min(H'/sqrt(1+H'²), 0.62), thT = asin(sinI/1.5168). 0.62 es un límite superior estricto; si se sube a 0.93, los bordes se extienden a 200px y todo se vuelve negro.
  4. Grosor: tpx = mdim*(0.05+0.28*H)*(1+0.40*thick)*vg, vg = 1+0.24*(1-smoothstep(-0.85,0.35,q.y)) (más grueso abajo, más delgado arriba).
  5. Desplazamiento: off = -dir*tan(thI-thT)*tpx*refract*Tf, más término de ajuste de borde; finalmente clamp(off,-10,10).
  6. Foco/labio: focal = mag*magMul*(0.50*cW - 0.40*eW); 1-focal debe ser siempre positivo, de lo contrario se produce un giro local de 180° y el texto aparece al revés. magMul es a nivel de panel: lens 1.30 / capsule 0.85 / plate 0.55 / nav 0.90 / dock 0.80.
  7. Composición: sp = c + rel*(1-focal) - off; muestreo RGB separado por ±disp*7*eW; luego compresión de brillo tint 0.58*L+0.133, color de derrame ambiental 0.10, borde Fresnel, blanco lechoso, brillo especular superior, arco inferior, brillo interno.

La textura Y debe invertirse: uv0 = vec2(sp.x/uRes.x, 1.0 - sp.y/uRes.y). Sin esta línea, la imagen aparece reflejada y el texto al revés.

4. Máquina de estados y umbrales clave

AcciónUmbral / Parámetro
hoverDentro del panel; fuera del panel hasta 180px, atenuación fade
presspress→1 (k=0.19/fotograma), scale 0.965, refracción ×1.3, arco inferior ×1.75
Clicpointerup y desplazamiento ≤4px → retraso de 240ms para evitar conflicto con doble clic
Doble clicDos pointerdown con intervalo <300ms; el segundo down cancela inmediatamente el temporizador de clic
Presión larga500ms después de pointerdown; si el movimiento es >4px, se cancela; el punto de progreso se agranda en el punto de contacto
ArrastreSolo se convierte en arrastre si el desplazamiento es >4px; clamp a 8px de margen interior
InerciaVelocidad al soltar >6px/evento → comienza con v*1.05, se multiplica por 0.94 cada fotograma, termina cuando <1px y se ajusta
Expandir136×48 → 236×296, el borde inferior no se mueve: ty = lay.y + lay.h - 296; los elementos del menú aparecen gradualmente desde altura 110→250, los pointerEvents se activan solo después de la mitad
SepararDock 300 → izquierda 140; el lado derecho tx se fija en lay.x + lay.w - 140, ancho 0→140
FusionarEl lado derecho primero reduce su ancho, la posición no se mueve (para evitar «deslizarse»)
FundirTras la separación, queda un espacio de 20px entre las dos piezas; los bordes interactúan entre sí; la unión metaball real requiere SDF smooth-min, no implementada en la versión Web de un solo paso
MuellePosición ω=15, ancho ω=18.5, ζ=0.66, dt=1/60 → aproximadamente 0.45s, 6% de sobrepaso

5. Recetas de parámetros

Deseadorefractmagrimdisptintthick
Cápsula de vidrio grueso1.200.350.950.220.24✓
Lente con tira de color1.500.601.000.180.10✓
Letras pequeñas bajo vidrio grueso1.250.420.800.300.16✓
Navegación superior (contenida)0.900.200.600.150.10✗
Panel de control (legible)1.000.150.550.120.14✗

Orden de ajuste: refract para desplazamiento → mag para labio → rim para borde → disp/tint para textura. Al revés, siempre lucharán entre sí.

6. Ocho errores comunes que debes evitar

  1. Los arrays de uniform no son fiables: uGeo[12] en ANGLE/D3D no da error pero no funciona → una draw call por panel.
  2. Las ramas de uniform en bucles se optimizan: usa mix / step sin ramas dentro de bucles.
  3. Los uniform declarados pero no usados se optimizan, getUniformLocation devuelve null, lo que provoca falsos informes de falta de uniform.
  4. gl.getUniform(prog, null) lanza TypeError, todo el código posterior del fotograma se salta (parece un bloqueo).
  5. Eje Y de la textura: si no se invierte, la imagen aparece reflejada y el texto al revés.
  6. Solo enlazar click pierde eventos: usa pointerdown + pointerup + umbral de desplazamiento.
  7. half es una palabra reservada de GLSL ES: escribir vec2 half provoca un error de compilación, el log solo dice syntax error. Otras palabras problemáticas: filter, input, output, long, short, packed.
  8. smoothstep con argumentos en orden inverso es comportamiento indefinido: smoothstep(1.0,-1.0,d) falla al cambiar de máquina; siempre escribe 1.0 - smoothstep(pequeño, grande, x).

Dos errores específicos de la capa de acciones:

  • Después de una presión larga, al levantar el dedo no debe considerarse un clic (marca longFired), de lo contrario, el menú de presión larga se abre y va seguido inmediatamente de una expansión.
  • El clic derecho debe interceptarse antes de pointerdown (e.button !== 0 devolver directamente), de lo contrario, el clic derecho iniciará un arrastre.

7. Verificación (ejecutar después de cada cambio)

?selftest=1 cubre 13 puntos: clic expandir/contraer, presión larga para burbujas, Esc cerrar burbujas, clic derecho para otro menú, separación y fusión del Dock, cuello de fusión, selección con teclas de dirección, Esc cerrar global, doble clic para elevar, inercia, W campo de trayectoria óptica.

Además, verifica manualmente:

  • El contenido dentro del vidrio está en la orientación correcta (sin invertir, sin reflejar)
  • El borde tiene un anillo Fresnel, brillo especular superior y arco inferior brillante, todo presente
  • En fondos oscuros, el interior del vidrio no es negro sólido (tiene un tono grisáceo brumoso)
  • Al arrastrar, la sombra fantasma tiene retardo; al soltar, hay inercia y luego se ajusta
  • Al separar, las dos piezas «se parten», no «se separan tirando»
  • El texto al desplazarse se desvanece en los bordes; al llegar al final, cambia a borde duro
  • Los tres interruptores de accesibilidad funcionan (reducir transparencia / aumentar contraste / reducir movimiento)

8. Presupuesto de rendimiento

ElementoPresupuesto
Paneles de vidrio en pantalla≤10 (esta implementación tiene 10, incluyendo bubble / bridge de ancho cero que aparecen según sea necesario)
Draw calls2 programas + un AABB draw por panel
Subida de fondoCada 5 fotogramas; si está estático, puede ser cada 8 fotogramas
Muestreo de brilloCada 10 fotogramas, solo para paneles con w*h>24000
Factor de renderizado<42fps → 0.72, >56fps → 1.0, límite DPR 2
Cadena de degradaciónReducir paneles → reducir factor → reducir subida → desactivar dispersión → volver a versión CSS

9. Líneas rojas y límites de la plataforma

  • El vidrio solo está en la capa de navegación; la capa de contenido no tiene vidrio.
  • No apilar vidrio (pierde la referencia de refracción, parece una mancha sucia); Regular y Clear no se mezclan en la misma pantalla.
  • Tint solo para la operación principal; los reflejos deben ser moderados; rim > 1.2 se verá falso.
  • Lo que Web no puede hacer: el texto/los iconos sobre el vidrio no se refractan a sí mismos (eso es la tubería de composición del sistema iOS 26); la versión CSS de respaldo no puede lograr el labio de lente con dispersión cromática píxel a píxel.
  • No cubierto por la versión de auto-dibujado: unión metaball real (esta implementación usa un cuello estrecho como aproximación), iluminación por inclinación del dispositivo, estadísticas de color principal fotograma a fotograma de video en tiempo real.

Individual skills in this repo

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

Skills relacionados