orbital-ds 0.14.0 → 0.16.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (44) hide show
  1. package/AGENTS.md +5 -0
  2. package/README.md +97 -93
  3. package/components.manifest.json +79 -1
  4. package/dist/hooks/use-ds-messages.d.ts +5 -0
  5. package/dist/lib/i18n.d.ts +5 -0
  6. package/dist/lib/i18n.js +18 -3
  7. package/dist/styles.css +1108 -1041
  8. package/dist/themes/fractalia.css +77 -1
  9. package/dist/themes/fractalia.guide.md +10 -3
  10. package/dist/themes/fractalia.meta.json +16 -3
  11. package/dist/themes/fractalia.scoped.css +77 -1
  12. package/dist/themes/liquid.css +502 -500
  13. package/dist/themes/liquid.fonts.css +7 -7
  14. package/dist/themes/liquid.guide.md +82 -73
  15. package/dist/themes/liquid.meta.json +134 -134
  16. package/dist/themes/liquid.scoped.css +502 -500
  17. package/dist/ui/ai-tag.d.ts +8 -0
  18. package/dist/ui/ai-tag.js +45 -0
  19. package/dist/ui/alert.js +18 -9
  20. package/dist/ui/avatar.d.ts +4 -1
  21. package/dist/ui/avatar.js +10 -1
  22. package/dist/ui/badge.d.ts +1 -1
  23. package/dist/ui/bottom-nav.d.ts +15 -0
  24. package/dist/ui/bottom-nav.js +97 -0
  25. package/dist/ui/bubble.d.ts +1 -1
  26. package/dist/ui/button.d.ts +1 -1
  27. package/dist/ui/choice-card.d.ts +16 -0
  28. package/dist/ui/choice-card.js +98 -0
  29. package/dist/ui/copy-button.d.ts +14 -0
  30. package/dist/ui/copy-button.js +112 -0
  31. package/dist/ui/icon-tile.d.ts +1 -1
  32. package/dist/ui/input-group.d.ts +1 -1
  33. package/dist/ui/item.d.ts +1 -1
  34. package/dist/ui/marker.d.ts +1 -1
  35. package/dist/ui/progress.d.ts +4 -1
  36. package/dist/ui/progress.js +5 -1
  37. package/dist/ui/sparkline.d.ts +1 -1
  38. package/dist/ui/status-badge.d.ts +2 -2
  39. package/dist/ui/tabs.d.ts +1 -1
  40. package/package.json +181 -180
  41. package/scripts/brand-file.mjs +221 -0
  42. package/scripts/cli.mjs +452 -370
  43. package/scripts/init.mjs +176 -72
  44. package/scripts/setup.mjs +90 -10
@@ -1,7 +1,7 @@
1
- /*
2
- * Fuentes del tema liquid. San Francisco (SF Pro), la fuente de Apple, es la del
3
- * sistema en macOS e iOS y no se puede distribuir: allí la toma la pila
4
- * `-apple-system, BlinkMacSystemFont`. En el resto de sistemas el respaldo es Inter
5
- * (la más cercana con licencia libre). Importar el PRIMERO del CSS de la app.
6
- */
7
- @import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap');
1
+ /*
2
+ * Fuentes del tema liquid. San Francisco (SF Pro), la fuente de Apple, es la del
3
+ * sistema en macOS e iOS y no se puede distribuir: allí la toma la pila
4
+ * `-apple-system, BlinkMacSystemFont`. En el resto de sistemas el respaldo es Inter
5
+ * (la más cercana con licencia libre). Importar el PRIMERO del CSS de la app.
6
+ */
7
+ @import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap');
@@ -1,73 +1,82 @@
1
- # Tema `liquid` — guía de diseño
2
-
3
- ## Esencia
4
- **Liquid Glass de Apple** (iOS 26 · macOS Tahoe 26): el contenido es opaco y sobrio; el cristal translúcido vive solo
5
- en la **capa funcional** que flota encima (navegación, menús, diálogos, controles).
6
-
7
- ## Gesto firma
8
- - **Cristal con filo especular**: translúcido, desenfoca y satura lo de debajo, con un filo de luz (arriba a la
9
- izquierda) y una sombra suave. Lo llevan el lateral, los menús, los popovers, los diálogos, los tooltips y el botón
10
- `outline` (botón de cristal).
11
- - **Contenido agrupado**: lienzo `#F2F2F7` (negro en oscuro) y tarjetas blancas (`#1C1C1E`), sin borde ni sombra.
12
- - **Cápsulas y radios concéntricos**: los botones, las etiquetas, los campos de una línea y las pestañas son cápsulas,
13
- y el radio interior es el exterior menos el relleno (menú 22 px → fila 16 px).
14
- - **Interruptor de iOS** (verde, con el pulgar blanco) y **control segmentado** con el pulgar elevado.
15
-
16
- ## Principios (de las HIG de Apple)
17
- - **El cristal no va en el contenido.** Tarjetas, listas, tablas y campos se quedan opacos. El cristal es para lo que flota.
18
- - **Sin cristal sobre cristal**: un menú abierto sobre el lateral no suma capas; por eso las capas no llevan filo dibujado.
19
- - **El color solo en la acción principal**: el primario es cristal tintado con el azul de sistema; lo demás es neutro.
20
- Usa un único botón `default` por vista y deja el resto en `outline` (cristal), `secondary` (relleno gris) o `ghost`.
21
- - **Las piezas grandes, más opacas**: el lateral usa un cristal más denso que los menús.
22
- - **Lateral flotante**: en macOS 26 el lateral flota separado del borde. Usa `<Sidebar variant="floating">` para
23
- verlo así; con la variante por defecto queda a ras, también de cristal.
24
-
25
- ## Referencias y qué se tomó de cada una
26
- - **[HIG · Materials](https://developer.apple.com/design/human-interface-guidelines/materials)**: capa funcional,
27
- variante *regular*, sin cristal sobre cristal, piezas grandes más opacas, Reducir transparencia y Aumentar contraste.
28
- - **[HIG · Color](https://developer.apple.com/design/human-interface-guidelines/color)**: colores de sistema de
29
- iOS 26 (normal y contraste alto), grises, rellenos y separadores.
30
- - **[Adopting Liquid Glass](https://developer.apple.com/documentation/technologyoverviews/adopting-liquid-glass)**:
31
- color solo en la acción principal, controles en cápsula, formas concéntricas, sheets y menús de cristal.
32
- - **[Firefox Acorn · iOS 26](https://acorn.firefox.com/latest/mobile/patterns/i-os-26-and-liquid-glass-w2oH48nk)**:
33
- cómo lo adapta una app real.
34
- - **[LogRocket · Liquid glass en CSS](https://blog.logrocket.com/how-create-liquid-glass-effects-css-and-svg/)**:
35
- receta CSS (desenfoque + saturación + brillo + filo inset). La refracción con SVG se descarta: solo va en Chromium.
36
-
37
- ## Paleta
38
- - Claro: lienzo `#F2F2F7`, tarjeta `#FFFFFF`, texto `#000`, secundario `#6C6C70`, primario `#0088FF`, enlace `#0066CC`
39
- (el de apple.com), separador `rgba(60,60,67,.29)`, rellenos `rgba(120,120,128,.16)` / `rgba(118,118,128,.12)`.
40
- - Oscuro: lienzo `#000`, tarjeta `#1C1C1E`, inset `#2C2C2E`, primario `#0091FF`, enlace `#5CB8FF`,
41
- secundario `rgba(235,235,245,.6)`.
42
- - Gráficos: azul, verde, naranja, morado y teal del sistema.
43
- - Interruptor: `#34C759` / `#30D158` (por el hueco `--ds-switch-track-on`).
44
-
45
- ## Tipografía
46
- **San Francisco** (SF Pro Text / Display) mediante la pila del sistema en Apple; **Inter** como respaldo en el resto
47
- (`liquid.fonts.css`). Escala de Apple: 13 (footnote) · 15 (subheadline, el texto de la interfaz) · 17 (body) · 20 · 22 ·
48
- 28 · 34 (large title). Titulares en 700 con seguimiento ligeramente negativo.
49
-
50
- ## Formas y profundidad
51
- Radios 8 · 12 · 16 · 22 · 26, diálogos y sheets en 34, controles en cápsula. El contenido no tiene sombra; el cristal,
52
- `0 8px 32px` suave más el filo especular. Las sombras de los botones se **suman** al anillo de foco, no lo sustituyen.
53
-
54
- ## Qué evita
55
- Cristal en tarjetas, tablas o campos; filos dibujados en las capas; color fuera de la acción principal; cabeceras de
56
- sección en MAYÚSCULAS (Apple usa estilo título: escribe así los textos de la app); fondos decorativos (`--ds-page-backdrop`
57
- es `none`; la variante de escaparate `liquid-wallpaper` añade uno para lucir el cristal).
58
-
59
- ## Accesibilidad
60
- - AA en todos los pares salvo el **texto blanco sobre el azul de sistema** (3,5:1 claro, 3,2:1 oscuro), declarado en la
61
- ficha como en Apple.
62
- - **Aumentar contraste** (`prefers-contrast: more`): azul y rojo de contraste alto (el azul pasa a 4,6:1), separadores
63
- más marcados, filos en tarjetas, campos y botones de cristal, y cristal casi opaco.
64
- - **Reducir transparencia** (`prefers-reduced-transparency`): el cristal se vuelve opaco y deja de desenfocar.
65
- - **Reducir movimiento**: la estructura ya detiene las animaciones.
66
- - El rojo destructivo usa el de contraste alto (`#E9152D`) para que el texto blanco llegue a AA.
67
-
68
- ## Estado de los valores
69
- - **Verificados** (HIG): colores de sistema de iOS 26, grises, fondos agrupados, escala de texto y principios del cristal.
70
- - **Aproximados**: la receta del cristal (CSS no refracta en todos los navegadores), los textos de estado claros
71
- (oscurecidos para AA), el secundario claro (`#6C6C70` en lugar de `rgba(60,60,67,.6)`), los radios grandes, las medidas
72
- del interruptor y las curvas de muelle.
73
- - **Pendiente**: el efecto de borde al hacer scroll bajo las barras y la lente (refracción) del cristal.
1
+ # Tema `liquid` — guía de diseño
2
+
3
+ ## Esencia
4
+ **Liquid Glass de Apple** (iOS 26 · macOS Tahoe 26): el contenido es opaco y sobrio; el cristal translúcido vive solo
5
+ en la **capa funcional** que flota encima (navegación, menús, diálogos, controles).
6
+
7
+ ## Gesto firma
8
+ - **Cristal con filo especular**: translúcido, desenfoca y satura lo de debajo, con un filo de luz (arriba a la
9
+ izquierda) y una sombra suave. Lo llevan el lateral, los menús, los popovers, los diálogos, los tooltips y el botón
10
+ `outline` (botón de cristal).
11
+ - **Contenido agrupado**: lienzo `#F2F2F7` (negro en oscuro) y tarjetas blancas (`#1C1C1E`), sin borde ni sombra.
12
+ - **Cápsulas y radios concéntricos**: los botones, las etiquetas, los campos de una línea y las pestañas son cápsulas,
13
+ y el radio interior es el exterior menos el relleno (menú 22 px → fila 16 px).
14
+ - **Interruptor de iOS** (verde, con el pulgar blanco) y **control segmentado** con el pulgar elevado.
15
+
16
+ ## Principios (de las HIG de Apple)
17
+ - **El cristal no va en el contenido.** Tarjetas, listas, tablas y campos se quedan opacos. El cristal es para lo que flota.
18
+ - **Sin cristal sobre cristal**: un menú abierto sobre el lateral no suma capas; por eso las capas no llevan filo dibujado.
19
+ - **El color solo en la acción principal**: el primario es cristal tintado con el azul de sistema; lo demás es neutro.
20
+ Usa un único botón `default` por vista y deja el resto en `outline` (cristal), `secondary` (relleno gris) o `ghost`.
21
+ - **Las piezas grandes, más opacas**: el lateral usa un cristal más denso que los menús.
22
+ - **Lateral flotante**: en macOS 26 el lateral flota separado del borde. Usa `<Sidebar variant="floating">` para
23
+ verlo así; con la variante por defecto queda a ras, también de cristal.
24
+
25
+ ## Referencias y qué se tomó de cada una
26
+ - **[HIG · Materials](https://developer.apple.com/design/human-interface-guidelines/materials)**: capa funcional,
27
+ variante *regular*, sin cristal sobre cristal, piezas grandes más opacas, Reducir transparencia y Aumentar contraste.
28
+ - **[HIG · Color](https://developer.apple.com/design/human-interface-guidelines/color)**: colores de sistema de
29
+ iOS 26 (normal y contraste alto), grises, rellenos y separadores.
30
+ - **[Adopting Liquid Glass](https://developer.apple.com/documentation/technologyoverviews/adopting-liquid-glass)**:
31
+ color solo en la acción principal, controles en cápsula, formas concéntricas, sheets y menús de cristal.
32
+ - **[Firefox Acorn · iOS 26](https://acorn.firefox.com/latest/mobile/patterns/i-os-26-and-liquid-glass-w2oH48nk)**:
33
+ cómo lo adapta una app real.
34
+ - **[LogRocket · Liquid glass en CSS](https://blog.logrocket.com/how-create-liquid-glass-effects-css-and-svg/)**:
35
+ receta CSS (desenfoque + saturación + brillo + filo inset). La refracción con SVG se descarta: solo va en Chromium.
36
+
37
+ ## Paleta
38
+ - Claro: lienzo `#F2F2F7`, tarjeta `#FFFFFF`, texto `#000`, secundario `#6C6C70`, primario `#0088FF`, enlace `#0066CC`
39
+ (el de apple.com), separador `rgba(60,60,67,.29)`, rellenos `rgba(120,120,128,.16)` / `rgba(118,118,128,.12)`.
40
+ - Oscuro: lienzo `#000`, tarjeta `#1C1C1E`, inset `#2C2C2E`, primario `#0091FF`, enlace `#5CB8FF`,
41
+ secundario `rgba(235,235,245,.6)`.
42
+ - Gráficos: azul, verde, naranja, morado y teal del sistema.
43
+ - Interruptor: `#34C759` / `#30D158` (por el hueco `--ds-switch-track-on`).
44
+
45
+ ## Tu marca sobre liquid
46
+ - Modo recomendado: **solo primario** (`--mode primary`). Liquid Glass no tiene color propio: la marca va en la acción
47
+ principal, el foco, el enlace, el destino activo del lateral y la serie 1. El interruptor sigue verde, como en iOS.
48
+ - El **hover del primario** sale de `--primary` (`color-mix`), así que sigue a tu color sin escribirlo aparte.
49
+ - En modo **completo**, el asistente deriva la paleta pero **no pisa el cristal**: lateral y menús siguen siendo
50
+ `var(--lq-glass…)`. Si escribes la marca a mano, no pongas colores opacos en `--popover` ni en `--sidebar`.
51
+ - Con tu marca, «Aumentar contraste» ya no cambia el primario (gana `brand.css`): el asistente lo deriva con AA.
52
+
53
+ ## Tipografía
54
+ **San Francisco** (SF Pro Text / Display) mediante la pila del sistema en Apple; **Inter** como respaldo en el resto
55
+ (`liquid.fonts.css`). Escala de Apple: 13 (footnote) · 15 (subheadline, el texto de la interfaz) · 17 (body) · 20 · 22 ·
56
+ 28 · 34 (large title). Titulares en 700 con seguimiento ligeramente negativo.
57
+
58
+ ## Formas y profundidad
59
+ Radios 8 · 12 · 16 · 22 · 26, diálogos y sheets en 34, controles en cápsula. El contenido no tiene sombra; el cristal,
60
+ `0 8px 32px` suave más el filo especular. Las sombras de los botones se **suman** al anillo de foco, no lo sustituyen.
61
+
62
+ ## Qué evita
63
+ Cristal en tarjetas, tablas o campos; filos dibujados en las capas; color fuera de la acción principal; cabeceras de
64
+ sección en MAYÚSCULAS (Apple usa estilo título: escribe así los textos de la app); fondos decorativos (`--ds-page-backdrop`
65
+ es `none`; la variante de escaparate `liquid-wallpaper` añade uno para lucir el cristal).
66
+
67
+ ## Accesibilidad
68
+ - AA en todos los pares salvo el **texto blanco sobre el azul de sistema** (3,5:1 claro, 3,2:1 oscuro), declarado en la
69
+ ficha como en Apple.
70
+ - **Aumentar contraste** (`prefers-contrast: more`): azul y rojo de contraste alto (el azul pasa a 4,6:1), separadores
71
+ más marcados, filos en tarjetas, campos y botones de cristal, y cristal casi opaco.
72
+ - **Reducir transparencia** (`prefers-reduced-transparency`): el cristal se vuelve opaco y deja de desenfocar. Gana
73
+ también cuando «Aumentar contraste» está activo a la vez.
74
+ - **Reducir movimiento**: la estructura ya detiene las animaciones.
75
+ - El rojo destructivo usa el de contraste alto (`#E9152D`) para que el texto blanco llegue a AA.
76
+
77
+ ## Estado de los valores
78
+ - **Verificados** (HIG): colores de sistema de iOS 26, grises, fondos agrupados, escala de texto y principios del cristal.
79
+ - **Aproximados**: la receta del cristal (CSS no refracta en todos los navegadores), los textos de estado claros
80
+ (oscurecidos para AA), el secundario claro (`#6C6C70` en lugar de `rgba(60,60,67,.6)`), los radios grandes, las medidas
81
+ del interruptor y las curvas de muelle.
82
+ - **Pendiente**: el efecto de borde al hacer scroll bajo las barras y la lente (refracción) del cristal.
@@ -1,134 +1,134 @@
1
- {
2
- "name": "liquid",
3
- "label": "Liquid Glass (Apple)",
4
- "essence": "Liquid Glass de Apple: contenido opaco y sobrio; cristal translúcido solo en la capa funcional que flota encima.",
5
- "conformance": "strict",
6
- "branding": "primary",
7
- "signature": [
8
- "cristal con filo especular en lateral, menús, diálogos y botones de cristal",
9
- "contenido agrupado opaco: #F2F2F7 y tarjetas blancas sin borde ni sombra",
10
- "cápsulas y radios concéntricos",
11
- "interruptor verde de iOS y control segmentado con pulgar elevado"
12
- ],
13
- "fonts": {
14
- "display": "SF Pro Display (sistema; Inter como respaldo)",
15
- "body": "SF Pro Text (sistema; Inter como respaldo)",
16
- "mono": "SF Mono (sistema)",
17
- "file": "liquid.fonts.css",
18
- "distributable": false,
19
- "scale": "escala de texto de Apple: 13 · 15 · 17 · 20 · 22 · 28 · 34"
20
- },
21
- "palette": {
22
- "light": {
23
- "background": "#F2F2F7",
24
- "foreground": "#000000",
25
- "card": "#FFFFFF",
26
- "primary": "#0088FF",
27
- "link": "#0066CC",
28
- "switch": "#34C759"
29
- },
30
- "dark": {
31
- "background": "#000000",
32
- "card": "#1C1C1E",
33
- "primary": "#0091FF",
34
- "switch": "#30D158"
35
- },
36
- "brandNotes": "Liquid Glass no tiene color propio: toma el del contenido. La marca de una app va solo en el primario (acción principal, foco, enlace); modo «primary»."
37
- },
38
- "radii": [
39
- 8,
40
- 12,
41
- 16,
42
- 22,
43
- 26,
44
- 34,
45
- 9999
46
- ],
47
- "references": [
48
- {
49
- "name": "Apple HIG · Materials",
50
- "tookFromIt": "cristal solo en la capa funcional, variante regular, sin cristal sobre cristal, piezas grandes más opacas, Reducir transparencia y Aumentar contraste",
51
- "source": "https://developer.apple.com/design/human-interface-guidelines/materials"
52
- },
53
- {
54
- "name": "Apple HIG · Color",
55
- "tookFromIt": "colores de sistema de iOS 26 (normal y contraste alto), grises, rellenos y separadores",
56
- "source": "https://developer.apple.com/design/human-interface-guidelines/color"
57
- },
58
- {
59
- "name": "Adopting Liquid Glass",
60
- "tookFromIt": "color solo en la acción principal (cristal tintado), controles en cápsula, formas concéntricas, sheets y menús de cristal",
61
- "source": "https://developer.apple.com/documentation/technologyoverviews/adopting-liquid-glass"
62
- },
63
- {
64
- "name": "Firefox Acorn · iOS 26 and Liquid Glass",
65
- "tookFromIt": "cómo adapta una app real los patrones de iOS 26",
66
- "source": "https://acorn.firefox.com/latest/mobile/patterns/i-os-26-and-liquid-glass-w2oH48nk"
67
- },
68
- {
69
- "name": "LogRocket · Liquid glass con CSS y SVG",
70
- "tookFromIt": "receta CSS (desenfoque + saturación + brillo + filo especular inset); la refracción SVG se descarta por ser solo de Chromium",
71
- "source": "https://blog.logrocket.com/how-create-liquid-glass-effects-css-and-svg/"
72
- }
73
- ],
74
- "status": {
75
- "verified": [
76
- "colores de sistema de iOS 26 (azul, verde, rojo, naranja, morado, cian, teal) y sus variantes de contraste alto",
77
- "grises y fondos agrupados (#F2F2F7, #1C1C1E, #2C2C2E)",
78
- "principios de uso del cristal (capa funcional, regular, sin cristal sobre cristal)",
79
- "escala de texto de Apple (13 a 34 pt)"
80
- ],
81
- "approximate": [
82
- "receta del cristal (opacidad, desenfoque, saturación, filo especular): sin refracción real, que CSS no puede hacer en todos los navegadores",
83
- "textos de estado claros, oscurecidos desde los de contraste alto para llegar a AA",
84
- "secondaryLabel claro: #6C6C70 en lugar de rgba(60,60,67,0.6), que no llega a AA",
85
- "radios (22, 26 y 34 px) y medidas del interruptor de iOS 26",
86
- "curvas de muelle traducidas a cubic-bezier",
87
- "seguimiento de titulares (-0.015em, el de apple.com)"
88
- ],
89
- "designed": [
90
- "relleno gris para «secondary» y cristal para «outline»"
91
- ],
92
- "pending": [
93
- "efecto de borde al hacer scroll bajo las barras",
94
- "refracción (lente) de las piezas de cristal, solo viable con SVG en Chromium"
95
- ]
96
- },
97
- "guide": "liquid.guide.md",
98
- "a11y": {
99
- "level": "AA",
100
- "exceptions": [
101
- "primary-foreground/primary",
102
- "sidebar-primary-foreground/sidebar-primary"
103
- ],
104
- "note": "El azul de sistema de iOS 26 con texto blanco da 3,5:1 (claro) y 3,2:1 (oscuro), como en Apple. Con «Aumentar contraste» (prefers-contrast: more) pasa al azul de contraste alto (#1E6EF4, 4,6:1). Respeta además Reducir transparencia."
105
- },
106
- "motion": {
107
- "about": "muelle suave y fluido; el cristal se flexiona al pulsar y se materializa al aparecer",
108
- "durations": {
109
- "fast": "150ms",
110
- "base": "300ms",
111
- "slow": "450ms"
112
- },
113
- "ease": {
114
- "standard": "cubic-bezier(0.32, 0.72, 0, 1)",
115
- "enter": "cubic-bezier(0.32, 0.72, 0, 1)",
116
- "exit": "cubic-bezier(0.4, 0, 1, 1)"
117
- },
118
- "choreography": {
119
- "motion-distance": "10px",
120
- "motion-scale": "0.94",
121
- "motion-blur": "8px",
122
- "spring-bounce": "0.15",
123
- "motion-stagger": "40ms",
124
- "motion-press-scale": "0.96"
125
- },
126
- "auto": {
127
- "about": "el contenido sube y aparece; los avisos (cristal) crecen al materializarse",
128
- "surfaces": "ds-auto-enter",
129
- "notices": "ds-auto-pop",
130
- "headers": "ds-auto-fade",
131
- "rows": "ds-auto-fade"
132
- }
133
- }
134
- }
1
+ {
2
+ "name": "liquid",
3
+ "label": "Liquid Glass (Apple)",
4
+ "essence": "Liquid Glass de Apple: contenido opaco y sobrio; cristal translúcido solo en la capa funcional que flota encima.",
5
+ "conformance": "strict",
6
+ "branding": "primary",
7
+ "signature": [
8
+ "cristal con filo especular en lateral, menús, diálogos y botones de cristal",
9
+ "contenido agrupado opaco: #F2F2F7 y tarjetas blancas sin borde ni sombra",
10
+ "cápsulas y radios concéntricos",
11
+ "interruptor verde de iOS y control segmentado con pulgar elevado"
12
+ ],
13
+ "fonts": {
14
+ "display": "SF Pro Display (sistema; Inter como respaldo)",
15
+ "body": "SF Pro Text (sistema; Inter como respaldo)",
16
+ "mono": "SF Mono (sistema)",
17
+ "file": "liquid.fonts.css",
18
+ "distributable": false,
19
+ "scale": "escala de texto de Apple: 13 · 15 · 17 · 20 · 22 · 28 · 34"
20
+ },
21
+ "palette": {
22
+ "light": {
23
+ "background": "#F2F2F7",
24
+ "foreground": "#000000",
25
+ "card": "#FFFFFF",
26
+ "primary": "#0088FF",
27
+ "link": "#0066CC",
28
+ "switch": "#34C759"
29
+ },
30
+ "dark": {
31
+ "background": "#000000",
32
+ "card": "#1C1C1E",
33
+ "primary": "#0091FF",
34
+ "switch": "#30D158"
35
+ },
36
+ "brandNotes": "Liquid Glass no tiene color propio: toma el del contenido. La marca de una app va solo en el primario (acción principal, foco, enlace); modo «primary»."
37
+ },
38
+ "radii": [
39
+ 8,
40
+ 12,
41
+ 16,
42
+ 22,
43
+ 26,
44
+ 34,
45
+ 9999
46
+ ],
47
+ "references": [
48
+ {
49
+ "name": "Apple HIG · Materials",
50
+ "tookFromIt": "cristal solo en la capa funcional, variante regular, sin cristal sobre cristal, piezas grandes más opacas, Reducir transparencia y Aumentar contraste",
51
+ "source": "https://developer.apple.com/design/human-interface-guidelines/materials"
52
+ },
53
+ {
54
+ "name": "Apple HIG · Color",
55
+ "tookFromIt": "colores de sistema de iOS 26 (normal y contraste alto), grises, rellenos y separadores",
56
+ "source": "https://developer.apple.com/design/human-interface-guidelines/color"
57
+ },
58
+ {
59
+ "name": "Adopting Liquid Glass",
60
+ "tookFromIt": "color solo en la acción principal (cristal tintado), controles en cápsula, formas concéntricas, sheets y menús de cristal",
61
+ "source": "https://developer.apple.com/documentation/technologyoverviews/adopting-liquid-glass"
62
+ },
63
+ {
64
+ "name": "Firefox Acorn · iOS 26 and Liquid Glass",
65
+ "tookFromIt": "cómo adapta una app real los patrones de iOS 26",
66
+ "source": "https://acorn.firefox.com/latest/mobile/patterns/i-os-26-and-liquid-glass-w2oH48nk"
67
+ },
68
+ {
69
+ "name": "LogRocket · Liquid glass con CSS y SVG",
70
+ "tookFromIt": "receta CSS (desenfoque + saturación + brillo + filo especular inset); la refracción SVG se descarta por ser solo de Chromium",
71
+ "source": "https://blog.logrocket.com/how-create-liquid-glass-effects-css-and-svg/"
72
+ }
73
+ ],
74
+ "status": {
75
+ "verified": [
76
+ "colores de sistema de iOS 26 (azul, verde, rojo, naranja, morado, cian, teal) y sus variantes de contraste alto",
77
+ "grises y fondos agrupados (#F2F2F7, #1C1C1E, #2C2C2E)",
78
+ "principios de uso del cristal (capa funcional, regular, sin cristal sobre cristal)",
79
+ "escala de texto de Apple (13 a 34 pt)"
80
+ ],
81
+ "approximate": [
82
+ "receta del cristal (opacidad, desenfoque, saturación, filo especular): sin refracción real, que CSS no puede hacer en todos los navegadores",
83
+ "textos de estado claros, oscurecidos desde los de contraste alto para llegar a AA",
84
+ "secondaryLabel claro: #6C6C70 en lugar de rgba(60,60,67,0.6), que no llega a AA",
85
+ "radios (22, 26 y 34 px) y medidas del interruptor de iOS 26",
86
+ "curvas de muelle traducidas a cubic-bezier",
87
+ "seguimiento de titulares (-0.015em, el de apple.com)"
88
+ ],
89
+ "designed": [
90
+ "relleno gris para «secondary» y cristal para «outline»"
91
+ ],
92
+ "pending": [
93
+ "efecto de borde al hacer scroll bajo las barras",
94
+ "refracción (lente) de las piezas de cristal, solo viable con SVG en Chromium"
95
+ ]
96
+ },
97
+ "guide": "liquid.guide.md",
98
+ "a11y": {
99
+ "level": "AA",
100
+ "exceptions": [
101
+ "primary-foreground/primary",
102
+ "sidebar-primary-foreground/sidebar-primary"
103
+ ],
104
+ "note": "El azul de sistema de iOS 26 con texto blanco da 3,5:1 (claro) y 3,2:1 (oscuro), como en Apple. Con «Aumentar contraste» (prefers-contrast: more) pasa al azul de contraste alto (#1E6EF4, 4,6:1). Respeta además Reducir transparencia."
105
+ },
106
+ "motion": {
107
+ "about": "muelle suave y fluido; el cristal se flexiona al pulsar y se materializa al aparecer",
108
+ "durations": {
109
+ "fast": "150ms",
110
+ "base": "300ms",
111
+ "slow": "450ms"
112
+ },
113
+ "ease": {
114
+ "standard": "cubic-bezier(0.32, 0.72, 0, 1)",
115
+ "enter": "cubic-bezier(0.32, 0.72, 0, 1)",
116
+ "exit": "cubic-bezier(0.4, 0, 1, 1)"
117
+ },
118
+ "choreography": {
119
+ "motion-distance": "10px",
120
+ "motion-scale": "0.94",
121
+ "motion-blur": "8px",
122
+ "spring-bounce": "0.15",
123
+ "motion-stagger": "40ms",
124
+ "motion-press-scale": "0.96"
125
+ },
126
+ "auto": {
127
+ "about": "el contenido sube y aparece; los avisos (cristal) crecen al materializarse",
128
+ "surfaces": "ds-auto-enter",
129
+ "notices": "ds-auto-pop",
130
+ "headers": "ds-auto-fade",
131
+ "rows": "ds-auto-fade"
132
+ }
133
+ }
134
+ }