@netzi/tokens 0.1.0-beta.10 → 0.1.0-beta.9

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.
package/CHANGELOG.md CHANGED
@@ -1,554 +1,5 @@
1
1
  # @netzi/tokens
2
2
 
3
- ## 0.1.0-beta.10
4
-
5
- ### Minor Changes
6
-
7
- - 2e5ff29: **Contraste del sistema y colores forzados (#150, criterio A.9).**
8
- - **`prefers-contrast: more` activa el contraste alto sin que la app haga nada.** Sin
9
- `data-contrast` en la página, los tokens toman los valores de `[data-contrast='high']` cuando
10
- el sistema pide más contraste, también en las secciones oscuras. El atributo, con cualquier
11
- valor, manda: `data-contrast="normal"` fija el normal aunque el sistema pida más. El eje de
12
- contraste de la fuente DTCG declara la preferencia (`axis.system`) y el build emite cada bloque
13
- de contraste alto también dentro de `@media (prefers-contrast: more)`, con la misma
14
- especificidad que el original para que la cascada con el cristal no cambie.
15
- - **`NetziThemeService` sigue el contraste del sistema.** Campo nuevo
16
- `NetziThemeConfig.systemContrast` (por defecto `true`) y señal `resolvedContrast()`
17
- (`NetziResolvedThemeContrast`: `'normal' | 'high'`). `setContrast()` fija la elección manual
18
- (con `false` escribe `data-contrast="normal"`) y `reset()` vuelve a seguir al sistema. Una
19
- configuración guardada antes sigue al sistema, salvo si eligió el alto. El interruptor de
20
- `netzi-settings` sale encendido cuando lo pide el sistema.
21
- - **Colores forzados en cada componente.** Con `forced-colors: active` (el tema de contraste de
22
- Windows) cada control conserva su borde, su foco, lo elegido y lo deshabilitado con los colores
23
- del sistema: lo elegido con `Highlight`/`HighlightText` (casilla, interruptor, radio,
24
- segmentado, pestañas, día y hora elegidos, opción de select, phone y comandos, página actual
25
- del menú y de la paginación…), lo deshabilitado con `GrayText` y el foco que era solo un halo
26
- de sombra o un color de borde con un contorno. Los SVG del reloj, la gráfica y la valoración
27
- se repintan con colores del sistema, porque el navegador no ajusta su `fill` ni su `stroke`;
28
- las muestras de color se quedan sin ajustar, con borde del sistema.
29
-
30
- Lo vigilan un guardián de las hojas (`colores-forzados.spec.ts`), specs de navegador con la
31
- emulación de Playwright y una auditoría con colores forzados en cada ruta del playground.
32
-
33
- - 4a9cfaa: **Con el dedo, 8 px entre objetivos táctiles vecinos (#210, criterio A.5).** Nuevo token
34
- público `--netzi-touch-gap` (8 px): la separación mínima entre las zonas de toque de dos
35
- objetivos con puntero táctil, que los componentes usan en su `@media (pointer: coarse)`.
36
- Con ratón el aspecto no cambia.
37
-
38
- Lo respetan la paginación (antes 4 px), las estrellas de `netzi-rating` (sus zonas se
39
- tocaban), el selector de iconos, las muestras de `netzi-color`, la barra, el menú de tabla y
40
- la cuadrícula de `netzi-richtext`, los chips y rejillas de `netzi-cron-picker`, las
41
- pestañas, los botones de `netzi-copy` (que además miden ya 44 px), las filas de
42
- `netzi-radio-group`, las columnas de hora, los chips de `netzi-tags`, el rango de fecha y
43
- hora en dos líneas, las cabeceras de `netzi-accordion`, los eventos pulsables de
44
- `netzi-timeline`, los pasos de `netzi-stepper` (que ya no encogen por debajo de su
45
- contenido) y las cabeceras ordenables de `netzi-data-table` frente a su asa de
46
- redimensionar.
47
-
48
- Con los paneles abiertos, también los días del calendario de `netzi-date` (el panel ocupa
49
- casi todo el ancho de un móvil de 360 px; más estrecho, encogen los días, no la
50
- separación), su encabezado y su menú de atajos, el inicio y el fin del rango de
51
- `netzi-clock`, los ítems de `netzi-menu` (que además miden 44 px), y las opciones de
52
- `netzi-combobox` frente al borde de su panel, sus chips en el campo y las filas del «+n»,
53
- y el buscador y «Todos/Ninguno» de `netzi-select` y el buscador de `netzi-phone`.
54
- Las celdas de `netzi-otp` se separan y, si no caben en una fila, bajan a dos (3 + 3) sin
55
- encoger. Con el dedo, los paneles de select, combobox, teléfono, fecha, hora y cron abren a
56
- 8 px de su control (6 con ratón), y uno más ancho que la pantalla menos sus márgenes (el
57
- calendario a 360 px) toma el margen que le quepa en vez de salirse por un lado.
58
-
59
- Las piezas de un control segmentado siguen tocándose, como pide la política.
60
-
61
- - 4a9cfaa: **Una pantalla se imprime limpia** (#176, criterio B.13): sin el marco de navegación ni las capas flotantes, en claro y sin vidrio, y sin partir filas.
62
- - **`@netzi/tokens`**: eje de entorno nuevo, `print` (`tokens/themes/print.tokens.json`). Reinicia el modo, el cristal y el fondo ambiental (`resets`): en `tokens.css` cada bloque que fija `data-theme`, `data-glass` o `data-ambient` va ahora dentro de `@media not print`, así que al imprimir sale el claro y opaco de siempre con el preset, el contraste y la densidad intactos, sin repetir ningún valor. En `@media print`, la raíz pierde las sombras y el desenfoque del velo, y cada duración baja a `0.01ms`. `base.css` imprime el papel en blanco, sin animaciones ni transiciones a medio camino, y con el atributo opcional `data-print-urls` (en un enlace o en un contenedor) cada enlace externo imprime su dirección detrás. Los enlaces se imprimen subrayados. La resolución DTCG (`effectiveAxes`) aplica la misma regla con el medio `print`, y el contrato de contraste se comprueba también en papel.
63
- - **`@netzi/ui`**: `netzi-layout` imprime solo el contenido, a todo el ancho y con su alto natural (sin menú lateral, topbar, barra de anuncio, pestañas, barra de acciones ni enlace de saltar al contenido). No se imprimen `netzi-toaster`, `netzi-command`, el aviso de `netzi-connection-guard` ni los paneles de `netzi-popover`, `netzi-select`, `netzi-combobox`, `netzi-date`, `netzi-time`, `netzi-phone` y `netzi-cron-picker` (salvo el modo en línea); `netziTooltip` se cierra con `beforeprint`. `netzi-data-table` sale entera aunque tenga altura fija, repite el encabezado en cada página, no parte ninguna fila y deja fuera los botones de su barra, la franja de carga y el relleno de la ventana virtual (que solo imprime las filas pintadas). `netzi-descriptions` no parte un par etiqueta-valor. Un `netzi-modal` o un `netzi-drawer` abierto se imprime una vez, sin el velo y en el flujo donde está el componente, sin tapar la página (fijo se repetiría en cada hoja). Sin sombra en el botón primario ni en los pulgares de `netzi-range-slider`, y sin el menú de tablas de `netzi-richtext`. La hoja de la marca propia lleva su regla oscura en `@media not print`.
64
-
65
- Página nueva en el playground: «Impresión» (`/impresion`).
66
-
67
- - eb2dbaa: **Marca propia con contraste (#174).** El contrato de contraste solo se comprobaba al construir
68
- los tokens y para los seis presets propios, y el README enseñaba a cambiar `--netzi-blue` a un
69
- morado sin aviso: la tinta encima se quedaba en 3,35:1.
70
-
71
- `@netzi/tokens`:
72
- - Nueva entrada `@netzi/tokens/brand`, en JavaScript sin dependencias (vale en cualquier
73
- framework): `deriveBrand(color)` deriva de un color los siete tokens del primario que se
74
- redefinen juntos (`primary`, `primary-hover`, `primary-dark`, `primary-text`,
75
- `primary-graphic`, `on-primary`, `on-primary-dark`) con texto a 4,5:1 y gráfico a 3:1 sobre
76
- cada superficie y sobre el tinte, en claro y en oscuro. Si ninguna tinta llega a 4,5:1 sobre
77
- el color, el relleno pasa al tono más cercano que sí (`adjusted`).
78
- - `validateBrand({ light, dark })` mide una marca hecha a mano contra ese contrato y dice cada
79
- par que falla (modo, tinta, fondo, ratio y mínimo; `TypeError` si falta un modo); `brandVariables` y `parseBrandColor`
80
- completan la API. La fórmula del contraste es la misma del build, que ahora la importa de ahí.
81
- - El README documenta el contrato y su ejemplo cumple; un test lo lee y mete lo derivado en la
82
- fuente DTCG para pasarle el contrato del build.
83
-
84
- `@netzi/ui`:
85
- - `provideNetziBrand(color)` y `NetziThemeService.setBrand(color | null)` escriben la marca en
86
- una hoja propia (`<style id="netzi-brand">`, con el nonce de `CSP_NONCE` si la app lo da) por
87
- encima del preset: la regla clara en la raíz y la oscura en todo `[data-theme='dark']`, también
88
- en las secciones oscuras anidadas. `theme.brand()` da los tokens derivados. La derivación se
89
- carga con `import()` solo cuando hay marca, fuera del bloque principal. La marca es de la app:
90
- no se guarda con las preferencias del usuario ni la borra `reset()`.
91
- - En desarrollo (`isDevMode()`), avisa en la consola, una vez por color, si el color no es válido
92
- o no puede ser el relleno tal cual, con los pares que fallaban y el tono que se aplica.
93
-
94
- - 4a9cfaa: **Token de medida legible: `--netzi-measure` (#213).** El ancho máximo del texto corrido (un
95
- párrafo, una descripción, un aviso) para que cada línea se quede en unos 40 a 75 caracteres (64
96
- de mediana) en cualquier ancho de ventana (criterio C.9). Vale `33em`. Va en `em` y no en `ch`,
97
- que sería lo habitual: el `ch` es el ancho del cero de la fuente que pinta en ese momento, el de
98
- la fuente de respaldo mide un 21 % menos que el de Plus Jakarta Sans, y al llegar la fuente de
99
- marca cada párrafo acotado cambiaba de ancho y rehacía sus líneas (criterio C.12). Se aplica al
100
- texto con `max-inline-size`, nunca a la página: el hueco junto al texto lo llenan el contenido
101
- auxiliar, las acciones, otro panel, la rejilla o la prosa en columnas entre párrafos; un párrafo
102
- no se parte en columnas, y una descripción corta puede dejar hueco. Solo CSS: el formato DTCG no admite `em`.
103
- - 4a9cfaa: **Cada duración y cada curva del kit sale de un token (#214).** Los bucles (giradores,
104
- latidos, barras indeterminadas, el brillo del skeleton), el destello de error del menú y el
105
- rebote de la aguja del reloj seguían escritos a mano en diez hojas.
106
-
107
- `@netzi/tokens`:
108
- - Bucles, con la duración de una vuelta: `--netzi-duration-loop-spin` (700ms, el giro de un
109
- indicador de carga), `-loop-orbit` (1100ms, el anillo que recorre un ítem o una pestaña),
110
- `-loop-pulse` (1200ms, el latido que sustituye al giro con movimiento reducido),
111
- `-loop-sweep` (1200ms, la barra indeterminada) y `-loop-shine` (1300ms, el brillo del
112
- skeleton). No cambian con `prefers-reduced-motion`: cada componente quita o sustituye su
113
- bucle en su propia regla.
114
- - `--netzi-duration-flash` (1400ms): un aviso que se enciende, se deja ver y se apaga solo.
115
- - Curvas `--netzi-ease-swing` (la de `ease-in-out`), `--netzi-ease-spin` (la de `linear`) y
116
- `--netzi-ease-settle` (`cubic-bezier(0.34, 1.45, 0.5, 1)`, un rebote sutil al asentar).
117
- - Al imprimir, las nuevas duraciones bajan a `0.01ms` como las demás.
118
-
119
- `@netzi/ui`:
120
- - Las hojas usan esos tokens con el mismo valor que tenían, salvo dos redondeos al token de su
121
- intención: el giro del spinner del botón pasa de 600 a 700 ms, como el resto de los
122
- spinners, y la barra de progreso de la navegación de `netzi-layout`, de 1100 a 1200 ms,
123
- como la de `netzi-progress`.
124
- - El guardián de movimiento ya no exime los bucles ni tiene lista de excepciones: solo pasan
125
- `0s` y el `0.01ms` de la regla reducida.
126
- - `netzi-data-table` en scroll continuo mueve el área con el teclado en píxeles enteros: con
127
- una cabecera o unas filas de alto con decimales, bajar y volver a subir lo mismo (Av Pág, ↓,
128
- Re Pág, ↑) dejaba el área a un píxel de arriba.
129
- - En una pantalla de hasta 640 px, el menú del engranaje de `netzi-data-table` cuenta su
130
- relleno en el tope de alto: cuando no cabía entero, el panel se salía 8 px por abajo, con
131
- su último apartado bajo el borde. El menú pasa a medir 300 px con su relleno (antes, 308).
132
-
133
- - b4f64fe: **Con el dedo, los campos de formulario no bajan de 44 px** (#100, WCAG 2.5.5). Con puntero táctil (`pointer: coarse`), incluidos sus paneles abiertos (el editor de texto va aparte, en #108):
134
- - Nuevo token `--netzi-touch-target` (44 px). Los controles de tamaño `sm` y `md` suben a 46 px (el borde de 1 px no le quita al input que se toca), cada densidad desde su propia base; `lg` no baja de ahí.
135
- - Crecen a 44 px: casillas, radios e interruptores (la fila, o la caja si no hay texto), opciones, buscadores y «Todos/Ninguno» de `netzi-select`, opciones, chips y el «+n» de `netzi-combobox`, el buscador y las opciones de `netzi-phone`, días, flechas, título, atajos y su menú de `netzi-date` (el panel ocupa el ancho del móvil y a 320 px las columnas encogen en vez de recortarse), celdas de `netzi-time`, segmentos de `netzi-segmented`, chips y enlaces de `netzi-cron-picker`, muestras de `netzi-color`, estrellas de `netzi-rating`, la franja de los sliders, celdas de `netzi-otp`, botones −/+ e input de `netzi-number`, AM/PM, unidades y extremos de `netzi-clock`, el ojo de `netzi-password` y el campo de `netzi-tags`.
136
- - Amplían la zona de toque sin mover el dibujo: las × de chips, tags y archivos, «Limpiar» de la búsqueda y del combobox, el chevrón del combobox, las ayudas (i) del cron y la barra de valor del selector de color.
137
- - Para que esas zonas no se pisen: en `netzi-combobox` múltiple, «Limpiar» se aparta del chevrón algo más de un objetivo y el campo reserva a la derecha sitio para los dos (chips e input no quedan debajo); las filas de chips de `netzi-tags` se separan 10 px; la cabecera de cada campo de `netzi-cron-picker` deja sitio a la zona de su (i).
138
- - `netzi-range-slider` con `showValue` reserva sitio encima para las burbujas, que tapaban la etiqueta del field (también con ratón).
139
- - En pantallas táctiles estrechas, el panel de `netzi-date` con reloj apila calendario y hora (hasta 680 px), la rejilla de meses y horas del cron pasa a 4 columnas (hasta 400 px) y `netzi-color-picker` encoge hasta el ancho disponible, también dentro del popover de `netzi-color`, que a 320 px se salía 12 px por la derecha (esto último también con ratón).
140
-
141
- **Los paneles anclados que no caben debajo abren encima** (también con ratón). Hasta ahora `netzi-time`, `netzi-date`, `netzi-select`, `netzi-combobox`, `netzi-phone` y `netzi-cron-picker` elegían el lado antes de montar el panel, sin saber cuánto mide: abrían debajo salvo que abajo quedaran menos de 160 px. El de la hora con reloj (~355 px) se salía entonces por abajo de un móvil y el dial y AM/PM no se podían tocar. Ahora, ya montado, se mide su alto entero (sin acotar): si cabe debajo, no cambia; si no cabe debajo y encima sí, abre encima; si no cabe en ningún lado, va al que tiene más sitio y se acota a él, y se desplaza por dentro. Vale para los seis: el alto máximo acota el panel entero, con su buscador y su relleno (en `netzi-phone` y `netzi-combobox` solo acotaba la lista, y a media pantalla de un móvil bajo el buscador de países quedaba por encima del borde). Por eso un select, una fecha o un cron que no caben enteros debajo (antes se encogían ahí) ahora abren encima si allí caben o hay más sitio. Con el dedo, si el buscador y «Todos/Ninguno» de `netzi-select` no dejan sitio a la lista, se desplaza el panel entero en vez de aplastarla.
142
-
143
- Con ratón y teclado nada más cambia de tamaño. El job de accesibilidad de CI lo vigila: mide la zona de toque real de cada control de las páginas de formularios, también con los paneles abiertos y con valor (texto escrito, un archivo, chips en el campo y en el «+n»), y que ningún otro control le pise parte de ella (44 px a 360, 375, 768 y 1024 de ancho; a 320, nada recortado y 24 px), y que los paneles abiertos quepan enteros en la pantalla, también en pantallas bajas (360×640 y 740×360 con el disparador a media pantalla). Mide además con una fuente de otras métricas, para que un alto que salga del texto (y no de un mínimo explícito) no dé 44 en un sistema y menos en otro.
144
-
145
- `netzi-date` y `netzi-time` encogen con su campo dentro de una fila flex: la hora del panel de fecha, a 320 px, empujaba el botón del reloj fuera de su caja.
146
-
147
- - e9ac2d9: **`netzi-data-table`: barras de desplazamiento nativas y finas, y sombras de lo oculto (#117).**
148
- - **Barras nativas finas** con el color de un token nuevo, `--netzi-scrollbar-thumb`
149
- (`--netzi-text-2`), con su contrato de 3:1 sobre cada superficie y también sobre una fila
150
- marcada (el tinte del primario, donde se pintan las barras superpuestas), en claro, en
151
- oscuro, con alto contraste y en cada preset. El pulgar no baja de 24 px y con el dedo
152
- (`pointer: coarse`) vuelve la barra del sistema. Van por `scrollbar-width`/`scrollbar-color` y,
153
- en los motores que solo entienden la vía con prefijo, por `::-webkit-scrollbar`. No se
154
- dibuja ninguna barra a mano: se arrastran, se tocan y se manejan con el teclado como
155
- cualquier barra del sistema, no tapan clics en el borde y no añaden nada al árbol de
156
- accesibilidad.
157
- - **Sombras en los bordes solo con contenido oculto** a ese lado (inicio, final y abajo),
158
- sin depender del puntero: aparecen y se van con la posición del scroll, también al
159
- desplazar con el teclado. Se pintan en una capa sin puntero que termina donde empiezan las
160
- barras. En RTL se invierten.
161
- - **Columnas fijadas**: la sombra de su borde sale solo cuando hay contenido pasando por
162
- detrás (antes estaba siempre). Con columnas fijadas a un lado, la sombra de ese lado la
163
- lleva el borde fijado y no el del área.
164
- - **La barra horizontal queda a la vista con una tabla alta.** Sin `maxHeight`, `fill` ni
165
- `autoPageSize`, si la tabla no cabe a lo ancho su área no pasa del alto que se ve del
166
- contenedor que desplaza la página (el área de contenido de `netzi-layout`, el cuerpo de
167
- un modal) o, si desplaza el documento, del de la ventana. El encabezado va en el mismo
168
- contenedor que el cuerpo: se desplaza a lo ancho con él y, al bajar, se queda arriba
169
- (ahora el encabezado es fijo en todos los modos, no solo con altura fija o `fill`). Una
170
- tabla que cabe a lo ancho conserva su alto natural.
171
- - El área sigue siendo una región con nombre y una parada de Tab, y se desplaza con las
172
- flechas, Re Pág, Av Pág, Inicio y Fin (nativo del navegador, ahora con test). Su anillo
173
- de foco pasa a ser el del token (`--netzi-focus-ring`), por fuera del borde.
174
- - **Lo que se enfoca no queda debajo del encabezado fijo** (WCAG 2.4.11): el área reserva
175
- con `scroll-padding` su alto (medido), así que Tab, Re Pág y Av Pág dejan lo enfocado a la
176
- vista; el propio encabezado lo anula con un margen negativo y enfocarlo no desplaza nada.
177
- Que tampoco quede detrás de las columnas fijadas, sin que enfocar lo fijado desplace el
178
- área, lo resuelve #135 (con su propio changeset).
179
- - **Capas:** la de sombras va con `z-index: 4` y el encabezado con 2–3, sin contexto de
180
- apilado propio (para que los menús de las celdas pasen por encima del pie): una barra fija
181
- de la app que deba quedar encima de la tabla necesita un `z-index` mayor que 4.
182
- - Un contenedor con scroll solo horizontal y alto según su contenido no cuenta como el que
183
- desplaza la página (crecería con la tabla); el tope nunca pasa del alto de la ventana.
184
-
185
- Lo oculto se detecta con el evento `scroll` (pasivo) y con `ResizeObserver` del área y de la
186
- tabla, una medida por frame; sin bucles de `requestAnimationFrame`.
187
-
188
- - 29f7661: **Tamaños de ventana con nombre (#157, ADR 0016).** Tokens nuevos con los cortes de ancho en
189
- los que cambia el diseño, siempre los mismos: `--netzi-window-medium` (600px),
190
- `--netzi-window-expanded` (840px), `--netzi-window-large` (1200px) y
191
- `--netzi-window-extra-large` (1600px), el ancho en el que empieza cada tamaño (compacto empieza
192
- en 0). `--netzi-window-reflow` (375px) es el corte de reflujo dentro de compacto: por debajo,
193
- lo que va en fila dentro de un panel flotante se apila.
194
-
195
- Una `var()` no vale dentro de `@media`, así que en una hoja se escribe el número del token, en
196
- forma de rango: `@media (width < 600px)` o `@media (width >= 840px)`. La salida DTCG los
197
- publica como `dimension` en px, y el README trae la tabla de tamaños y paneles.
198
-
199
- - b737fae: **Tokens de movimiento con el movimiento reducido dentro (#151).** Las duraciones y las curvas
200
- iban escritas a mano en cada componente (quince duraciones distintas entre 80 y 340 ms), y por eso
201
- la respuesta a `prefers-reduced-motion` también se repetía componente a componente.
202
-
203
- `@netzi/tokens`:
204
- - Duraciones con nombre de intención: `--netzi-duration-instant` (100ms), `-fast` (150ms),
205
- `-base` (200ms) y `-slow` (280ms); curvas `--netzi-ease-standard` (la de `ease`), `-enter` y
206
- `-exit`. Salen de la fuente DTCG con los tipos `duration` y `cubicBezier`, también en la salida
207
- DTCG resuelta.
208
- - Las duraciones del desplazamiento, `--netzi-duration-move-{fast,base,slow}`, valen lo mismo
209
- que su fundido y con `prefers-reduced-motion: reduce` pasan a `0.01ms` en un solo bloque de
210
- `tokens.css` (`themes/motion.tokens.json`). Lo que se desplaza, gira o escala con ellas salta
211
- sin regla propia; los fundidos de color y opacidad conservan su duración. A `0.01ms` y no a
212
- cero para que `transitionend` y `animationend` sigan llegando.
213
-
214
- `@netzi/ui`:
215
- - Las hojas del kit usan los tokens en vez de duraciones y curvas literales (también la
216
- transición en línea del tooltip). Cada valor va al paso más cercano de la escala: 30 ms
217
- de diferencia como mucho (60 ms en el giro de la aguja del reloj); `ease-out` pasa a `--netzi-ease-enter` y
218
- `ease-in` a `--netzi-ease-exit`. Los bucles (giradores, latidos, el brillo del skeleton)
219
- conservan su ciclo.
220
- - El toast y las muestras de color de los ajustes ya no necesitan su regla de movimiento
221
- reducido: el desplazamiento va con un token `move`.
222
- - Si tu app redefine un token de duración, el kit entero sigue el nuevo ritmo; para quitar el
223
- movimiento en un ámbito, redefine allí los tres `--netzi-duration-move-*` a `0.01ms`.
224
-
225
- - 4a9cfaa: **Escala de capas con nombre (`--netzi-layer-*`, #215).** El `z-index` ya no es un número
226
- suelto en cada hoja: sale de once capas con nombre de intención, de abajo arriba,
227
- `content` (0), `sticky` (2), `bar` (20), `flyout` (50), `scrim` (80), `modal` (100),
228
- `dropdown` (120), `toast` (200), `tooltip` (300), `blocking` (1000) y `top` (10000). El
229
- README las documenta en ese orden, con sus reglas: dentro de su capa, un componente ordena
230
- con `-1`, `0` o `1`, y lo que va justo encima de otra pieza de su capa sube un escalón con
231
- `calc(var(--netzi-layer-…) + 1)`.
232
-
233
- Una barra fija de la app que deba pasar por encima de los encabezados fijos de la tabla va en
234
- `var(--netzi-layer-bar)`.
235
-
236
- En `@netzi/ui`, las hojas de drawer, modal, layout, toaster, fecha, hora, combobox, popover,
237
- select, teléfono, paleta de comandos, editor, cron, conexión y tabla de datos, y el tooltip,
238
- usan la escala. El apilado no cambia, con una excepción: el panel del selector de cron
239
- estaba en 1200, por encima del aviso, del tooltip y de la pantalla de sin conexión, y pasa a
240
- la capa de desplegables como el resto de paneles. Un guardián (`tokens-capas.spec.ts`) falla
241
- con cualquier `z-index` numérico distinto de `-1`, `0` o `1` en las hojas y los estilos en
242
- línea del kit.
243
-
244
- - 021a5bb: **Estados de interacción como un solo sistema, con presionado (#156, criterio B.7).** Nuevo
245
- grupo `state` en la fuente DTCG: una capa translúcida por estado, del color del texto y con su
246
- opacidad (`--netzi-state-hover` 8 %, `--netzi-state-focus` 12 %, `--netzi-state-pressed` 12 %,
247
- `--netzi-state-dragged` 16 %, y cada una con su `--netzi-state-*-opacity` para la plataforma que
248
- pinte la capa con su propio color), el seleccionado (`--netzi-state-selected`, el tinte del
249
- primario de siempre) y una sola opacidad para lo deshabilitado
250
- (`--netzi-state-disabled-opacity`, 0.6). Las capas se redeclaran en cada sección con tema o
251
- contraste propios, como el anillo de foco.
252
-
253
- El relleno de marca tiene su presionado propio, `--netzi-primary-pressed`: el hover con la capa
254
- de presionado del extremo contrario a su tinta, calibrado en cada preset. `deriveBrand` lo
255
- deriva igual para una marca propia (`primaryPressed`, el octavo token del contrato), y
256
- `validateBrand` mide `--netzi-on-primary` también sobre él.
257
-
258
- El contrato de contraste del build cubre el sistema: `--netzi-text` llega a 4.5:1 sobre cada
259
- superficie con cualquier capa encima, el anillo de foco a 3:1 sobre las de hover, foco y
260
- presionado, la tinta del primario sobre su presionado, y el texto de lo deshabilitado se queda a
261
- 3:1 (nuevo: un contrato sobre una opacidad nombra su tinta con `ink`).
262
-
263
- - a4662c0: **Nuevos tokens `--netzi-*-graphic` y `--netzi-*-veil` para lo no textual de un estado (#189,
264
- WCAG 1.4.11).** La estrella marcada, el punto de presencia, el borde de un campo inválido o el
265
- icono de un resultado necesitan 3:1 frente a lo que tienen al lado, y el crudo del estado no
266
- llega en claro: azul 2,08:1 en el peor fondo, verde 1,33, amarillo 1,41 y rojo 2,15.
267
- - `--netzi-info-graphic` (`#0e84cd`), `--netzi-success-graphic` (`#069047`),
268
- `--netzi-warning-graphic` (`#9d7a0c`) y `--netzi-danger-graphic` (`#df464b`) en claro; en
269
- oscuro, el crudo de siempre. Son alias de `--netzi-blue-graphic`, `--netzi-green-graphic`,
270
- `--netzi-yellow-graphic` y `--netzi-red-graphic`, como los `-text`.
271
- - `--netzi-info-veil`, `--netzi-success-veil`, `--netzi-warning-veil` y `--netzi-danger-veil`:
272
- el gráfico al 14 %, el fondo redondo de un icono de estado.
273
- - El contrato `non-text` de cada gráfico pide 3:1 sobre cada superficie y sobre su velo
274
- compuesto sobre cada una; el build lo comprueba en las 24 combinaciones de modo, contraste y
275
- preset.
276
-
277
- - 4a9cfaa: **Paleta categórica para gráficas: `--netzi-chart-1` … `--netzi-chart-8`** (#175). Ocho colores
278
- para ocho series, sin repetirse, en el orden en que se asignan: azul, naranja quemado, verde
279
- azulado, vino, oliva, índigo, rosa rojizo y pizarra, con su versión aclarada en oscuro.
280
- - Cada uno declara su contrato `non-text` (3:1, WCAG 1.4.11) sobre todas las superficies y el
281
- build lo comprueba en las 24 combinaciones de modo, contraste y preset. El peor par mide
282
- 3.16:1 en claro y 3.75:1 en oscuro.
283
- - Elegida para que las series se distingan también con protanopia, deuteranopia y tritanopia
284
- (simulación de Machado 2009): la distancia mínima entre dos series, en OKLab, es 10.0 sin
285
- daltonismo y 7.1 con él en claro, y 8.9 y 6.2 en oscuro. Lo fija `test/chart.spec.ts`.
286
- - Es fija, no sigue al preset: con el primario como serie 1, el preset verde o el rojo chocaba
287
- con la serie del mismo tono.
288
-
289
- - 11d7658: **Espaciado, radio y texto por papel; las escalas primitivas pasan a desuso para las apps
290
- (#228).** La política de diseño reserva las primitivas a la fuente, pero el README enseñaba
291
- `--netzi-space-*`, `--netzi-radius-sm/lg`, `--netzi-font-size-*`, `--netzi-font-weight-*` y
292
- `--netzi-line-height-*`. Ahora cada uso tiene su papel en la capa semántica, con el mismo
293
- valor en cada tema y densidad:
294
- - **Espaciado**, de lo más cercano a lo más lejano: `--netzi-space-related` (4px),
295
- `--netzi-space-group` (8), `--netzi-space-stack` (12), `--netzi-space-inset-sm` (12),
296
- `--netzi-space-inset` (16), `--netzi-space-inset-lg` (24), `--netzi-space-section` (32) y
297
- `--netzi-space-page` (48). La densidad compacta los reduce igual que antes, también en una
298
- sección con su propia densidad.
299
- - **Radios**: `--netzi-radius-control` (6px), `--netzi-radius-surface-sm` (8),
300
- `--netzi-radius-surface` (10) y `--netzi-radius-pill`.
301
- - **Texto**: los estilos `--netzi-typography-*`, que ya existían.
302
-
303
- Las escalas se deprecan en `@netzi/tokens` `0.1.0-beta.10` y **pasan a internas como pronto en
304
- `@netzi/tokens` `0.1.0-beta.11`**: siguen en `tokens.css` con su valor (los papeles se apoyan
305
- en ellas), pero salen de `public-tokens.json` y pueden cambiar sin aviso. Se avisa como con los
306
- sinónimos: `$deprecated` en la fuente y en la salida DTCG, el comentario `/* deprecated: … */`
307
- en `tokens.css`, la lista del build y la tabla «Escalas que pasan a internas» del README.
308
- `--netzi-radius-full`, que no llegó a publicarse, es interno desde ya: usa
309
- `--netzi-radius-pill`. `--netzi-radius-md`, en desuso desde #216, apunta ahora a
310
- `--netzi-radius-surface-sm`.
311
-
312
- Duraciones, curvas, familias y la escala de letra (`--netzi-duration-*`, `--netzi-ease-*`,
313
- `--netzi-font-sans`, `--netzi-font-mono`, `--netzi-font-scale`) ya tenían nombre de intención:
314
- pasan a la capa semántica **sin cambiar de nombre**.
315
-
316
- **Migración**, en tus hojas:
317
-
318
- | Antes | Después |
319
- | -------------------------------------------------------- | -------------------------------------------------------------- |
320
- | `var(--netzi-space-2)` | `var(--netzi-space-related)` |
321
- | `var(--netzi-space-3)` | `var(--netzi-space-group)` |
322
- | `var(--netzi-space-4)` | `var(--netzi-space-stack)` o `var(--netzi-space-inset-sm)` |
323
- | `var(--netzi-space-5)` | `var(--netzi-space-inset)` |
324
- | `var(--netzi-space-6)` | `var(--netzi-space-inset-lg)` |
325
- | `var(--netzi-space-7)` | `var(--netzi-space-section)` |
326
- | `var(--netzi-space-8)` | `var(--netzi-space-page)` |
327
- | `var(--netzi-radius-sm)` | `var(--netzi-radius-control)` |
328
- | `var(--netzi-radius)` | `var(--netzi-radius-surface-sm)` |
329
- | `var(--netzi-radius-lg)` | `var(--netzi-radius-surface)` |
330
- | `font-size` + `font-weight` + `line-height` de la escala | `font: var(--netzi-typography-<papel>)` y su `-letter-spacing` |
331
-
332
- - 79e0661: **Nuevo token `--netzi-primary-graphic`: el primario para lo no textual que tiene que verse (#140,
333
- WCAG 1.4.11).** El relleno de una barra de progreso, un anillo de carga o una barra de
334
- navegación necesitan 3:1 frente a lo que tienen al lado, y `--netzi-primary` no llega en claro
335
- con azul (2,15:1 en el peor fondo), verde (1,36), naranja (1,78), rojo (2,51) ni cian (1,92).
336
- - Es el tono más cercano al primario que llega a 3:1 sobre `bg`, `surface`, `surface-2`,
337
- `surface-3` y el tinte del primario, calibrado por preset y por tema. En oscuro coincide con
338
- el primario salvo en morado, que se aclara un punto para cumplir sobre el tinte.
339
- - Su contrato `non-text` lo comprueba el build en las 24 combinaciones de modo, contraste y
340
- preset: si se rebaja, el CSS no se escribe.
341
- - `--netzi-primary-text` también cumple, pero se aleja más del color de marca. Sigue siendo el
342
- que va con lo que late en opacidad: en el valle del latido, el no textual baja de 3:1.
343
-
344
- - 4a9cfaa: **Qué tokens son para tu app: `public-tokens.json` (#217).** Cada token de la fuente declara
345
- si es **público** (el contrato: se puede usar y redefinir, y no cambia sin pasar por desuso) o
346
- **interno** (puede cambiar en cualquier versión). La capa semántica es pública; de las
347
- primitivas lo son las escalas (espacio, radios, tipografía, interlineado, duraciones y
348
- curvas); de las de componente, las capas flotantes, el velo, los controles, el objetivo
349
- táctil, el anillo de foco, la paleta de gráficas, el fondo ambiental y la lente del cristal.
350
-
351
- Quedan **internos** los colores de marca crudos (`--netzi-blue`, `--netzi-blue-dark`,
352
- `--netzi-green`, `--netzi-yellow`, `--netzi-red`, `--netzi-purple`) y los pulgares del kit
353
- (`--netzi-thumb`, `--netzi-scrollbar-thumb`). Siguen saliendo en `tokens.css` igual que antes:
354
- nada cambia de valor. Si tu app los usa, pasa al primario y a los estados, que siguen al
355
- preset de marca y al contraste alto (`--netzi-primary`, `--netzi-info`, `--netzi-success`…).
356
-
357
- El paquete publica la lista en `@netzi/tokens/public-tokens.json` (nombre, ruta canónica, capa
358
- y aviso de desuso), y la salida DTCG resuelta lo marca en `$extensions["tech.netzi"].visibility`.
359
- El README tiene la sección «Públicos e internos» y su catálogo ya solo enseña tokens públicos.
360
-
361
- - 4a9cfaa: **`radius-full`, elevación con nombre y estilos de texto compuestos (#220).**
362
- - `--netzi-radius-full` para lo del todo redondeado (píldoras, puntos, avatares,
363
- interruptores). En `@netzi/ui` sustituye a los 77 `999px`, `100px` y `50%` de las hojas, todos
364
- en piezas cuadradas o en píldoras: el dibujo no cambia. Un guardián lo vigila.
365
- - Elevación con nombre de intención: `--netzi-elevation-base` (sin sombra), `-raised`,
366
- `-floating` y `-modal`, con los valores de siempre en cada tema. `@netzi/ui` y el playground
367
- pasan a usarlos.
368
- - Un estilo compuesto por paso de la escala (`typography` en DTCG): `--netzi-typography-display`,
369
- `-headline`, `-title`, `-title-sm`, `-body`, `-body-sm` y `-caption`, como atajo `font`, y su
370
- espaciado en `--netzi-typography-<estilo>-letter-spacing`.
371
-
372
- **En desuso**, se deprecan en `@netzi/tokens` `0.1.0-beta.10` y se retiran como pronto en `@netzi/tokens` `0.1.0-beta.11` (ADR 0012): `--netzi-shadow-sm`,
373
- `--netzi-shadow` y `--netzi-shadow-lg`. Siguen valiendo lo mismo en cada tema y en cada sección
374
- con su propio tema o contraste. Migración, buscar y sustituir:
375
-
376
- | Antes | Después |
377
- | ------------------------ | --------------------------------- |
378
- | `var(--netzi-shadow-sm)` | `var(--netzi-elevation-raised)` |
379
- | `var(--netzi-shadow)` | `var(--netzi-elevation-floating)` |
380
- | `var(--netzi-shadow-lg)` | `var(--netzi-elevation-modal)` |
381
-
382
- Si tu app redefinía una sombra, redefine su nivel. De paso, `--netzi-surface-1`,
383
- `--netzi-text-1` y `--netzi-radius-md` (en desuso desde #216) se redeclaran también en cada
384
- sección con su propio tema o densidad, así que siguen al tema como sus canónicos.
385
-
386
- - 4a9cfaa: **Un solo nombre por papel: `surface-1`, `text-1` y `radius-md` pasan a desuso (#216).** Eran
387
- sinónimos de `--netzi-surface`, `--netzi-text` y `--netzi-radius`, que son los canónicos (la
388
- raíz de cada grupo de la fuente, nota en el ADR 0009). Siguen publicándose con el mismo valor,
389
- porque apuntan al canónico; se deprecan en `@netzi/tokens` `0.1.0-beta.10` y se retiran **como pronto en `@netzi/tokens` `0.1.0-beta.11`**, en un cambio
390
- incompatible propio (ADR 0012).
391
-
392
- Cómo se avisa: `$deprecated` en la fuente DTCG y en la salida resuelta, un comentario
393
- `/* deprecated: … */` encima de cada uno en `tokens.css`, la lista que imprime el build y la
394
- tabla «En desuso» del README.
395
-
396
- **Migración**, buscar y sustituir en tus hojas:
397
-
398
- | Antes | Después |
399
- | ------------------------ | ---------------------- |
400
- | `var(--netzi-surface-1)` | `var(--netzi-surface)` |
401
- | `var(--netzi-text-1)` | `var(--netzi-text)` |
402
- | `var(--netzi-radius-md)` | `var(--netzi-radius)` |
403
-
404
- Si tu app **redefine** uno de los sinónimos (`--netzi-surface-1: …`), redefine el canónico:
405
- el sinónimo lo sigue. `@netzi/ui` y el playground ya solo usaban los canónicos; ahora un
406
- guardián lo vigila.
407
-
408
- - cf23e6b: **Cambio incompatible para las apps que redefinen tokens del tema claro: una sección clara dentro
409
- de una página oscura pinta el tema claro (#237).** El claro no tenía bloque propio (son los
410
- valores de las capas, en `:root`), así que una sección con `data-theme="light"` heredaba todos los
411
- valores oscuros de la página. Ahora `[data-theme='light']` vuelve a declarar, con el valor de las
412
- capas, cada token que cambia el tema oscuro, y cada contexto de la página (preset, alto contraste,
413
- también el que pide el sistema, cristal y fondo ambiental) le devuelve a la sección lo suyo, así
414
- que pinta lo mismo que una página clara con ellos. Con los tokens de fábrica nada cambia en la raíz,
415
- tampoco con `data-theme="light"` puesto en `<html>`, ni al imprimir.
416
-
417
- **Por qué es incompatible.** El bloque claro pesa lo que un atributo. Una app que pone
418
- `data-theme="light"` en `<html>` (como hacen las plantillas de Netzi) y redefine el claro con un
419
- selector que pesa menos (`html { … }`) o con un `:root` cargado antes de `@netzi/tokens` ve que el
420
- bloque pisa su valor; y una sección clara dentro de una página oscura toma el claro de fábrica en
421
- vez del suyo.
422
-
423
- **Migración.** Declara tus tokens del claro también en `[data-theme='light']`, como ya hacías en
424
- `[data-theme='dark']` para el oscuro, y carga tu hoja después de `@netzi/tokens`:
425
- - Antes: `:root { --netzi-surface: #fdfcfa; }`
426
- - Después: `:root, [data-theme='light'] { --netzi-surface: #fdfcfa; }`
427
-
428
- - 54f5fdf: **El texto corrido mide 16 px y cada estilo de texto publica su tamaño suelto (#219, #155,
429
- ADR 0015).** La política de diseño fija el texto corriente en 16 px; en los tokens medía 14.
430
- - `--netzi-typography-body` pasa a 16 px (`font.size.lg`): párrafos, descripciones y prosa.
431
- - Nuevo `--netzi-typography-body-ui`, a 14 px: el texto de interfaz (opciones, pestañas,
432
- celdas, mensajes breves). `body-sm` (12.5 px) queda para lo secundario.
433
- - Cada estilo publica también `--netzi-typography-<papel>-font-size`, el tamaño solo, para la
434
- hoja que pone el peso y el interlineado por su cuenta y no quiere que el atajo `font` se los
435
- pise. Como el tamaño del estilo, multiplica `--netzi-font-scale`.
436
- - Los avisos de desuso de `--netzi-font-size-*` proponen ahora ese tamaño del papel
437
- (`md` → `--netzi-typography-body-ui-font-size`, `lg` → `--netzi-typography-body-font-size`).
438
-
439
- No rompe nada publicado: los estilos de texto (#220) se estrenan en esta misma versión, así
440
- que ninguna app los usa todavía. `md` sigue valiendo 14 px y sigue siendo el 100 % del ajuste
441
- de tamaño de letra.
442
-
443
- ### Patch Changes
444
-
445
- - 0f16d1c: **Colores forzados: el texto resaltado se lee y los anillos se ven sobre el resaltado (#150).**
446
- - Con colores forzados, Chromium pinta detrás del texto una placa del color del lienzo. Lo
447
- elegido con `Highlight`/`HighlightText` (segmentado, paginación, menú lateral, días y horas,
448
- opciones de select, combobox y phone, chips, ajustes, idiomas, comandos, menús de la tabla,
449
- editor, cron, pestañas de trabajo, contadores de pestañas, paso actual…) quedaba blanco sobre
450
- blanco. Esas reglas llevan ahora `forced-color-adjust: none`, y lo que llevan dentro hereda el
451
- texto del resaltado sin fondos propios.
452
- - El foco o la opción activa encima de lo elegido llevan su contorno con el texto del resaltado
453
- por dentro (`HighlightText`) o con el del lienzo por fuera: el ítem actual del menú lateral con
454
- el foco, la opción activa y elegida del combobox, del select y del phone, y la casilla marcada
455
- con el foco.
456
- - **Contraste alto:** `--netzi-border-2` sube a 3:1 sobre cada superficie, en claro (`#828b94`)
457
- y en oscuro (`#68717b`), y el contrato de contraste de los tokens lo comprueba.
458
-
459
- - 4a9cfaa: **El ejemplo de uso del README pinta con tokens semánticos (#218).** El botón de ejemplo
460
- usaba `background: var(--netzi-blue)`, una primitiva: quien lo copiaba se saltaba el preset
461
- de marca y el contraste alto, justo lo que el propio README desaconseja más abajo. Ahora
462
- usa `--netzi-primary` de relleno y `--netzi-on-primary` de tinta, que es el par que cada
463
- preset redefine y cuyo contraste comprueba el build.
464
-
465
- También se corrigen las cifras del aviso «relleno o texto»: `--netzi-blue` da 2.54:1 sobre
466
- el fondo claro y 2.68:1 sobre blanco (no 2.9:1), y `--netzi-primary-dark` baja a 4.23:1 en
467
- `surface-3`.
468
-
469
- - 6be96b3: **Lo marcado y los tonos llegan a 3:1 frente a cualquier superficie (#147, WCAG 1.4.11).**
470
- - `--netzi-primary-dark`, el relleno de checkbox, radio y toggle marcados, se mide ahora frente a todas las superficies y no solo al fondo de la página. Para cumplirlo se oscurecen el verde (`#079b4e`) y el naranja (`#bf780a`) en claro y se aclara el morado en oscuro (`#824ff3`). El blanco encima sigue por encima de 3:1.
471
- - Los puntos de `netzi-timeline` con tono (info, success, warning, danger) y los tramos del medidor de `netzi-password` pintan con el tono de texto de su color (`--netzi-*-text`) en vez del crudo, que en claro se quedaba por debajo.
472
-
473
- - 4a9cfaa: **Nada salta al cargar: imágenes del editor y fuentes de marca (#178).**
474
- - `@netzi/tokens/fonts.css` añade `'Plus Jakarta Sans Fallback'` y `'Fira Code Fallback'`:
475
- Arial y Courier New (Liberation Sans y Liberation Mono en Linux) con `size-adjust`,
476
- `ascent-override`, `descent-override` y `line-gap-override` calculados con las métricas
477
- de las fuentes del kit. Mientras llega la de marca, el texto ocupa casi lo mismo y la
478
- página no salta al cambiar. `--netzi-font-sans` y `--netzi-font-mono` (y la fuente por
479
- defecto de `NetziThemeService`) los nombran justo detrás de la de marca; quien tenía
480
- guardada la fuente por defecto anterior pasa a la nueva sola. **Aviso:** si la lista de
481
- `fonts` que pasas a `netzi-settings` usaba como valor la fuente por defecto anterior
482
- (`'Plus Jakarta Sans', -apple-system, system-ui, sans-serif`), cámbiala por
483
- `NETZI_THEME_DEFAULTS.font`; si no, ninguna opción saldrá marcada.
484
- - `netzi-richtext`: cada imagen guarda su tamaño propio y lo emite como `width` y `height`
485
- con `height:auto`, así que reserva su hueco antes de descargarse sin deformarse. Si al
486
- insertarla no se conoce, el editor lo lee cuando la imagen carga (fuera del historial
487
- de deshacer). Un `<img>` con `width` y `height` a la vez se lee como tamaño propio; un
488
- `width` suelto sigue siendo el ancho elegido.
489
- - `netzi-richtext`: mientras carga el motor, la barra ya ocupa su sitio (inerte) y el
490
- documento reserva su alto (el mínimo si está vacío, el máximo si tiene contenido), así
491
- que al montarse no empuja lo que hay debajo.
492
-
493
- - 4a9cfaa: **El texto cortado con puntos suspensivos se puede leer entero (#167, A.13).** Había 16
494
- textos que se cortaban con `text-overflow: ellipsis` y solo la barra de pestañas ofrecía el
495
- completo, con un `title` que solo veía el puntero. Ahora:
496
- - **Directiva nueva `netziTruncated`.** Enseña el texto entero en un tooltip del kit, solo
497
- mientras el elemento no cabe, con el puntero (sobre el texto o sobre el control que lo
498
- contiene) y con el foco del teclado. Es el mismo tooltip de `netziTooltip`, con todo lo
499
- suyo (WCAG 1.4.13): se puede recorrer con el puntero, persiste con el foco, se descarta
500
- con Escape sin mover el foco y se cierra al imprimir; solo funde la opacidad, sin
501
- desplazarse. No toca `aria-describedby`: el texto ya está entero en el DOM y el lector lo
502
- lee igual. Un texto suelto cortado (el nombre de un archivo, una celda) se vuelve una
503
- parada de Tab mientras no cabe, con el anillo de foco del kit (`base.css` de
504
- `@netzi/tokens` lo pinta en `[data-netzi-truncated-stop]`). Entradas: `netziTruncated` (texto propio; vacío, el del
505
- elemento), `netziTruncatedPlacement` y `netziTruncatedActive` (foco virtual, para listas
506
- con `aria-activedescendant`).
507
- - **Aplicada en cada texto que se corta:** chip, nombre del archivo en
508
- dropzone, país en phone, copy, valor del select, página actual de las migas, adjunto de notifications, celdas y
509
- cabeceras de `netzi-data-table` y las etiquetas de sus submenús de fijar y de anchos, el
510
- título de las pestañas de `netzi-workspace-bar` (sustituye a su `title`) y la zona
511
- horaria de `netzi-date` y `netzi-time` (la zona IANA entera, también con el foco en el
512
- campo).
513
- - **La etiqueta de un paso de `netzi-stepper` ya no se corta:** pasa a otra línea. Con los
514
- pasos desactivados no se llega a ella con el teclado, y un tooltip no bastaría.
515
- - **Un solo oyente de teclado y de impresión para todos los tooltips** (`netziTooltip` y
516
- `netziTruncated`), y solo mientras alguno espera su retardo o está a la vista. Antes cada
517
- instancia escuchaba el documento, y con mil celdas cada tecla recorría mil oyentes.
518
- - En la tabla, solo llevan la directiva las celdas de ancho estricto (redimensionando o en
519
- una columna fijada): con el ancho libre crecen con su texto. Una cabecera sin orden también acaba en puntos suspensivos (antes se
520
- recortaba en seco), y la cabecera con orden se enseña al pasar por toda la celda.
521
-
522
- Un guardián de hojas falla si un `text-overflow: ellipsis` del kit no lleva la directiva.
523
-
524
- - 38a1913: **`tokens.css` se genera desde una fuente única en JSON DTCG** (#127). Los valores no
525
- cambian: cada `--netzi-*` vale lo mismo en cada tema, preset, contraste, cristal, densidad y
526
- entorno que en la versión anterior, y las rutas de importación son las mismas.
527
- - La fuente sigue el formato del W3C Design Tokens Community Group (2025.10), en tres capas
528
- (primitivos, semánticos y de componente) y un archivo por eje de tema, y Style Dictionary
529
- genera el CSS. Es la base para publicar los mismos tokens a plataformas que no leen CSS.
530
- - Cada token que se pinta sobre algo declara su contrato de contraste (texto 4.5:1, no
531
- textual 3:1) y el build lo comprueba en las 24 combinaciones de modo, contraste y preset:
532
- si un par no llega, el paquete no se construye.
533
- - Los comentarios de `tokens.css` salen ahora de las descripciones de la fuente; el orden de
534
- algunos bloques cambia sin efecto en la cascada.
535
-
536
- - a2f75a9: **El tinte del tema oscuro y las manchas del fondo ambiental siguen al preset de cada sección
537
- (#232).** Dentro de una sección con su propio `data-preset` en una página oscura,
538
- `--netzi-primary-tint` y `--netzi-primary-tint-strong` tomaban el alfa del tema claro; y con
539
- `data-ambient="on"`, `--netzi-ambient` pintaba las manchas con el primario de la página. Ahora se
540
- vuelven a declarar en cada sección con preset dentro de una página donde aplica el tema oscuro o el
541
- fondo ambiental, y el alto contraste las sigue apagando también ahí. La fuente exige la
542
- redeclaración a cada referencia del valor, también la que va dentro de un degradado o de un estilo
543
- de texto, y a los tokens que declara cada contexto.
544
- - 7e4b2f0: **Los estados, los tintes y el pulgar de la barra se redeclaran en cada sección con tema,
545
- preset o contraste propios (#232).** Una variable que usa otra se resuelve donde se declara: dentro
546
- de una sección con su propio `data-theme`, `--netzi-info-text` (y el resto de `-text`, `-graphic`
547
- y `-veil` de los estados), `--netzi-primary-tint`, `--netzi-tint` y el pulgar de la barra de
548
- desplazamiento heredaban el valor de la raíz, el del tema de la página. Ahora se vuelven a declarar
549
- en cada eje que cambia lo que referencian, como ya hacían el anillo de foco y los papeles de
550
- espaciado. La fuente lo exige a cualquier referencia, así que un token nuevo no puede olvidarlo.
551
-
552
3
  ## 0.1.0-beta.9
553
4
 
554
5
  ### Patch Changes