@netzi/tokens 0.1.0-beta.8

package/CHANGELOG.md

@@ -0,0 +1,389 @@
+# @netzi/tokens
+
+## 0.1.0-beta.8
+
+### Patch Changes
+
+- c57b4f0: **Publicación en el npm público con licencia propietaria de uso libre** (ADR 0005).
+  Los paquetes pasan a `registry.npmjs.org` con `access: public`, `homepage`
+  (<https://ui.netzi.tech>), `bugs` (netzi.tech@gmail.com) y `LICENSE.md` dentro:
+  instalar y usar es libre en cualquier aplicación; redistribuir o derivar, no. El
+  tarball deja de llevar sourcemaps (exponían el TypeScript original) y `files` deja
+  fuera todo lo que no sea el compilado, los tipos, las hojas y la documentación.
+
+## 0.1.0-beta.7
+
+### Minor Changes
+
+- effd0cd: **Fuentes de marca autoalojadas** (#59). `fonts.css` importaba Plus Jakarta Sans
+  y Fira Code desde Google Fonts: toda app que lo usara mandaba la IP de cada
+  visitante a Google antes de ningún consentimiento (políticas 14 y 08b). Ahora las
+  dos familias viajan **dentro del paquete** como fuentes variables woff2
+  (`styles/fonts/`, ~95 KB) en dos subconjuntos, `latin` y `latin-ext` (ç, ñ, ß, ã,
+  l·l), con `font-display: swap` y sus licencias OFL-1.1 al lado. La importación
+  no cambia (`@import '@netzi/tokens/fonts.css'`); Vite y el CLI de Angular
+  reescriben las rutas y copian los archivos al build. Un guardián impide que
+  ninguna hoja publicada vuelva a cargar algo de fuera.
+
+### Patch Changes
+
+- 0ff1e00: **Contraste (WCAG 1.4.3) en botón `soft`, anuncios y página de estado** (#56).
+  axe sobre las 58 páginas del playground, en claro y oscuro:
+  - `netzi-button variant="soft"` escribía con `--netzi-primary-dark` (4.34:1 en
+    claro, **2.85:1** en oscuro) y su hover era un azul literal que ignoraba el
+    preset. Ahora escribe con `--netzi-primary-text` (garantizado a 4.5:1 sobre el
+    tinte en los seis presets y los dos temas) y el hover usa
+    `--netzi-primary-tint-strong`. El hover y la sombra del botón primario también
+    dejan de ser azul fijo: siguen al preset.
+  - `netzi-announcement` de éxito (**2.7:1**) y peligro (4.2:1) mezclaban el acento
+    demasiado claro para el texto blanco; las mezclas bajan al 50 % y 65 % y las
+    tintas pasan a tokens (`--netzi-on-primary-dark`, `--netzi-on-accent`). Un
+    guardián mide cada mezcla como la calcula el navegador.
+  - El código gigante de `netzi-status-page` (ilustración al 12 %) pasa a ser
+    decoración de verdad: `aria-hidden` y el número pintado por CSS desde
+    `data-code`. El estado lo dan el título y la descripción de `netzi-result`.
+  - README de tokens: `--netzi-primary` / `--netzi-blue` y compañía son relleno;
+    para texto van sus `-text`.
+
+  Los placeholders de `netzi-input` / `netzi-number` que citaba la incidencia no
+  se reproducen: usan `--netzi-text-2` (5.5:1 sobre blanco) y axe no los marca en
+  ninguna página.
+
+## 0.1.0-beta.6
+
+### Minor Changes
+
+- 0adae8d: **Escala tipográfica** (#51). El kit publicaba tamaños solo para sus controles
+  (`--netzi-control-fs-*`); el texto que no es un control —líneas secundarias,
+  pies, metadatos, títulos— no tenía token, cada app se inventaba el suyo y
+  `var(--netzi-font-size-xs)`, que parece existir, se descartaba en silencio.
+  Llegan `--netzi-font-size-xs/sm/md/lg/xl/2xl/3xl` (11 · 12.5 · 14 · 16 · 18 ·
+  22 · 28 px, sacados de lo que el kit ya usa; `md` = 14px es el 100 % de
+  `--netzi-font-scale`, con el que todos escalan), `--netzi-line-height-none/
+tight/normal/relaxed` (1 / 1.25 / 1.5 / 1.65) y
+  `--netzi-font-weight-regular…extrabold` (400–800, los cortes que carga
+  `fonts.css`). La densidad compacta no los cambia. Documentados en el README de
+  tokens y en el showcase («Tipografía»); un guardián fija la escala, el anclaje
+  en 14 y que todo tamaño multiplique la escala de accesibilidad.
+
+## 0.1.0-beta.5
+
+### Minor Changes
+
+- ba4ed7a: **Interruptor, checkbox y radio: primario oscuro con la marca blanca; y las
+  muestras de preset, redondas y del color puro.**
+  - El interruptor encendido llevaba el pulgar casi negro (`--netzi-on-primary`)
+    sobre el azul claro, porque sobre ese azul el blanco no llega a 3:1. Negro
+    sobre azul se veía raro (queja literal). Los tres controles de selección pasan
+    a pintar el estado activo con `--netzi-primary-dark` y encima el nuevo
+    `--netzi-on-primary-dark`, blanco en todos los presets: pasa de 3:1 en cada uno
+    y en los dos temas, y la pista encendida se distingue del fondo (el morado
+    oscuro sube un punto en tema oscuro para eso). Lo fija el guardián.
+  - Las muestras de preset del panel de ajustes eran cuadrados con un tinte del
+    color al 18 % y el color dentro; en oscuro salían marrón, oliva, granate…
+    seis manchas turbias. Ahora son círculos del color puro y el activo lleva un
+    anillo con hueco (`outline` con offset, que funciona igual sobre cristal).
+  - El pulgar del interruptor y el del deslizador pasan a `--netzi-thumb`, opaco;
+    iban con `--netzi-surface`, que dentro de un panel de cristal es un tinte
+    translúcido, y salían como un agujero oscuro con un aro.
+
+- f34e282: **El cristal se ve igual en todas las capas, y con grosor.** Venía de una queja
+  con razón: «casi todas las ventanas que lo soportan tienen colores o
+  transparencia diferente». Lo era, y era medible.
+  - **Un solo velo.** El fondo que apaga la app detrás de una capa modal estaba
+    escrito a mano en cada componente y no coincidía: `modal`, `drawer` y la paleta
+    ⌘K usaban `rgba(8,12,20,.55)` con `blur(2px)`, `connection-guard` iba a `.62`
+    con `blur(3px)`, y el menú lateral en móvil a `.5` **sin desenfoque**. Ahora
+    todos salen de **`--netzi-scrim`** y **`--netzi-scrim-filter`**, que además se
+    hunden un punto en tema oscuro (el mismo alfa sobre un fondo ya oscuro apenas
+    separaba la capa del contenido).
+  - **El canto tiene grosor.** `--netzi-float-glow` pasa de una sola línea de luz
+    arriba a **luz arriba + sombra dentro del borde de abajo**. Un filo solo se lee
+    como un velo iluminado; los dos juntos, como el canto de una pieza de vidrio.
+  - **El velo deja la app viva.** Bajó de `0.55` a `0.28` en claro (y de `.62` a
+    `.45` en oscuro), con un desenfoque casi nulo: con el valor anterior, abrir un
+    panel dejaba todo el contenido de detrás en un gris muerto. Lo que se difumina
+    es lo que hay **bajo el panel**, que es de lo que va el cristal.
+  - **La lámina se lee como lámina.** El realce sube a `saturate(200%)` y el brillo
+    del filtro a `1.45` en claro, para que el panel salga blanco esmerilado en vez
+    de gris sucio. Y el vidrio se abre de verdad, en los dos temas: alfa `0.44` y
+    brillo `1.25` en claro (antes `0.70` / `1.2`), alfa `0.12` y brillo `0.56` en
+    oscuro (antes `0.62` / `0.68`), y solo 10 px de desenfoque (antes 28), para
+    que se vea lo que hay debajo. El punto lo eligió el usuario probando cinco
+    niveles del más denso al más abierto, y se quedó el más abierto; con lo de
+    antes, un panel se leía como una placa gris opaca. Lo que cede es el caso
+    extremo de un plano del color contrario debajo (blanco puro en oscuro, negro
+    puro en claro): ahí el texto secundario —dos niveles reforzado, `#d8dee6` en
+    oscuro y `#2a333c` en claro— se queda en 4.1-4.2:1, y el primario no baja de
+    4.5:1 en ningún caso. Contra el fondo del kit, la tinta y un gris medio (una
+    tarjeta o una foto, ya promediadas por el desenfoque) todo pasa de 5:1;
+    `tokens-contrast.spec.ts` fija los suelos.
+  - **Lo que va dentro de un panel de cristal también es cristal.** Las tarjetas
+    del panel de ajustes, la burbuja de un comentario en las notificaciones o el
+    hover de un botón pintaban `--netzi-surface*` opaco dentro de una capa
+    translúcida. Llegan `--netzi-float-surface`, `-2` y `-3` —tintes translúcidos
+    con cristal, las superficies de siempre sin él— y cada capa flotante re-escopa
+    las tres superficies a ellos, con lo que todo lo anidado los hereda sin que
+    ningún componente tenga que saberlo. Son tintes oscuros en los dos temas
+    (una tarjeta es más gris que la lámina); en claro el texto secundario baja un
+    punto más para compensar, y el guardián verifica los suelos sobre cada tinte.
+  - **La burbuja del valor del slider ya no tapa lo que tiene encima.** Flotaba
+    fuera de su caja y se montaba sobre el rótulo: en el panel de ajustes, «TAMAÑO
+    DE LETRA» se leía «TAMAÑO DE LET». Ahora el control reserva su hueco cuando
+    lleva burbuja.
+  - **Al `netzi-cron-picker` le faltaba el filo** (era la única de las quince capas
+    sin él) y ya lo lleva.
+
+  Va con un guardián en la suite que compara **todas** las capas entre sí y falla si
+  alguien vuelve a escribir un velo o un desenfoque a mano, o deja una capa sin
+  filo. Es lo único que caza esto: leyendo un componente suelto no se ve.
+
+- 62a66c3: **Fondo ambiental (`ambient`), y el shell ya no cambia de tono al abrir una capa.**
+  - **Fondo ambiental.** Nuevo eje del tema (`NetziThemeService.setAmbient`,
+    interruptor «Fondo ambiental» en `netzi-settings`, `data-ambient="on"` en la
+    raíz): manchas de color suaves —primario del preset, morado y verde— debajo del
+    contenido, que el layout pinta bajo `--netzi-bg` y que se ven a través del
+    topbar y del sidebar de cristal. Salió de comparar el kit con una referencia:
+    el mismo cristal, sobre un fondo liso, se ve como una placa gris; sobre esto,
+    como vidrio. Los porcentajes son bajos y el texto se sigue leyendo encima
+    (`--netzi-text-3` sobre la mancha más fuerte: 4.4:1 en claro, 4.6:1 en
+    oscuro). Se apaga solo en alto contraste. Token: `--netzi-ambient`.
+  - **El shell ya no apaga su filtro bajo una capa modal.** Se hacía por frames
+    (30 → 51 medidos) con la premisa de que el velo lo tapaba, y era falsa: el velo
+    es translúcido y el topbar daba un salto de tono, sin transición, justo al
+    abrir un modal o un drawer. Fuera. `NetziOverlayService` y su marca
+    `data-netzi-overlay` se quedan, para que la app reaccione a «hay algo encima».
+
+- f2c3dbf: **Llega la lente del canto (opt-in) y `NetziOverlayService`, la cuenta de capas
+  modales abiertas.**
+
+  Salió de intentar la refracción del cristal de Apple. **No se puede hacer hoy**, y
+  queda comprobado: Chromium acepta `backdrop-filter: url(#filtro-svg)` y luego lo
+  **ignora** —el mismo filtro aplicado como `filter` normal sí deforma el
+  contenido—, y Safari ni lo acepta. Así que el fondo no se puede curvar.
+
+  Lo que sí se puede, y lo que salió midiendo:
+  - **`NetziOverlayService`** lleva la cuenta de las capas modales abiertas
+    (modal, drawer, ⌘K, aviso de conexión) y marca el documento con
+    `data-netzi-overlay="open"`, para que la app pueda reaccionar (pausar una
+    animación cara, un vídeo de fondo). Se cuenta en vez de marcar un booleano
+    porque las capas se apilan (un drawer que abre un modal de confirmación).
+    Con esa marca el kit apagaba el filtro del topbar y del sidebar bajo el velo
+    (30 → 51 fps medidos) y **se descartó**: el velo es translúcido y el salto de
+    tono del shell se veía al abrir. Antes coherencia que frames.
+  - **La lente del canto** (`data-glass-lens="on"`): el borde de modal, drawer y ⌘K
+    lleva su propio desenfoque, más fuerte que el del interior, y eso da la
+    sensación de espesor. Es **opt-in** porque es una segunda capa de
+    `backdrop-filter`: con una sola capa en pantalla sale **gratis** (60 fps), pero
+    apilada con el shell cae a **26**.
+
+  De paso, `netzi-command` pasa a pintar su cristal en una capa aparte como el
+  modal y el drawer: tenerlo en el propio elemento habría hecho que el anillo
+  filtrara sobre un fondo ya filtrado.
+
+## 0.1.0-beta.4
+
+### Minor Changes
+
+- 38da044: **Contraste del texto: los tres niveles pasan WCAG AA en los cuatro escenarios.**
+  `--netzi-text-3` era el token de **todos** los rótulos secundarios del kit —etiquetas,
+  ayudas, pies, metadatos, placeholders— y no llegaba al mínimo en ningún tema (2.73 y 2.52
+  en claro, 3.77 y 4.12 en oscuro, con 4.5:1 exigido). El modo `[data-contrast='high']`, que
+  existe justo para esto, subía `border`, `border-2` y `text-2` pero **no lo tocaba**.
+
+  Cada nivel pasa a tener un papel, y no son tres grados de gris intercambiables:
+  - **`--netzi-text-2` es todo el texto secundario** (`#637381` → `#5c6b78` en claro). Sube
+    porque el valor anterior tampoco llegaba sobre `--netzi-surface-3` (4.31:1), la
+    superficie que la auditoría original no miró y que usan chips, badges, kbd y pestañas.
+  - **`--netzi-text-3` queda reservado a lo NO textual** —iconos decorativos, chevrons,
+    separadores, líneas, la barra de redimensionar y los estados deshabilitados— y sube a
+    `#7a8996` para cumplir el 3:1 de SC 1.4.11. Ya no es una trampa esperando a que alguien
+    lo use para un rótulo.
+  - **`[data-contrast='high']` redefine también `text-3`**: cada nivel toma el valor del de
+    encima, así que el modo cumple 4.5:1 incluso donde se haya usado `text-3` para texto.
+
+  En el kit se han migrado a `--netzi-text-2` las **67 declaraciones que sí pintan texto** en
+  34 componentes (data-table, command, clock, date, time, combobox, select, notifications,
+  layout, richtext, table, stat, stepper, contacts, dropzone, chart…), y se han quitado dos
+  `opacity` que anulaban el token por debajo: los días del mes contiguo del calendario
+  quedaban en 2.25:1 efectivo y la guía del pie de imagen del editor en 3:1. Las 43
+  declaraciones restantes siguen en `text-3` a propósito, porque no son texto.
+
+  Además, **el path de `netzi-page-header` marca la página actual reforzándola**
+  (`--netzi-text` + peso 600) en vez de atenuarla, igual que ya hacía `netzi-breadcrumb`.
+
+  Los ratios están medidos sobre el propio `tokens.css` y verificados por
+  `tokens-contrast.spec.ts`: si un valor deja de cumplir, la suite se pone roja.
+
+- 059475f: **Los colores semánticos y el primario cumplen contraste como texto.** Tenían dos
+  papeles y no valían para los dos: el saturado es de **relleno** (un fondo, un punto
+  de estado, una barra de gráfica), y como **texto** sobre superficie clara no llegaba
+  ni de lejos. Medido: los badges daban 1.46-2.36:1, el semántico suelto 1.63-2.78:1
+  y el blanco sobre el primario azul —el preset por defecto— **2.68:1** en los dos
+  temas.
+
+  **Tokens nuevos, uno por color**: `--netzi-blue-text`, `--netzi-green-text`,
+  `--netzi-yellow-text`, `--netzi-red-text`, `--netzi-purple-text` y
+  `--netzi-primary-text`, este último redefinido **por preset** (el primario es
+  themeable, así que su versión legible también). Oscurecidos en claro; en oscuro casi
+  todos sirven crudos y solo el rojo y el morado piden un punto de luz. Cada uno
+  cumple 4.5:1 sobre las cuatro superficies **y sobre su propio tinte**, que es el
+  fondo del badge y el caso peor.
+
+  Migradas las **69 declaraciones `color:`** de 41 archivos. Los rellenos
+  (`background`, `border-color`, el `fill` de una barra) **no se tocan**: ahí el
+  saturado es el correcto.
+
+  **La tinta sobre un relleno sólido pasa a ser la que cumple sobre ESE color**, no
+  una fija. `--netzi-on-primary` y `--netzi-on-accent` pasan a tinta oscura: es lo que
+  el kit ya hacía con los presets verde, naranja y cyan, así que unifica en vez de
+  inventar y no cambia ningún color de marca. El morado es el único que se queda en
+  blanco, porque es el único donde la oscura no cumple (4.13 frente a 4.57).
+
+  **Tres `color: #fff` en duro** que ninguna migración de tokens podía alcanzar y que
+  ningún tema tocaba: el contador de notificaciones (2.78:1 sobre el rojo), el número
+  del paso con error del stepper y la marca del checkbox del select. Más la marca del
+  sidebar, que fijaba su tinta en duro sobre el degradado.
+
+  **Y un guardián nuevo** para que no vuelva a colarse: el spec falla si aparece un
+  `color:` con un literal en vez de un token, nombrando archivo y declaración.
+
+  De paso se simplifica el cristal: el refuerzo del texto pasa a declararse en el
+  propio eje `[data-glass='on']` con literales, en vez de redefinir `--netzi-text-2`
+  en cada una de las 15 capas apuntando a un token intermedio. Menos indirección y una
+  declaración por tema en lugar de treinta.
+
+- 959d2fc: **Superficies de cristal para las capas flotantes.** Nuevo eje de tema
+  `data-glass="on"` (`NetziThemeService.setGlass()`, con su interruptor en
+  `netzi-settings`): las capas que se pintan **encima** del contenido —topbar,
+  sidebar, paneles de select/combobox/date/time/cron/teléfono, popover y todo lo que
+  lo usa (menú, notificaciones, contactos, cuenta, idioma, menús de la tabla), modal,
+  drawer, paleta ⌘K, toasts, menú de tabla del editor y el aviso de conexión— pasan a
+  ser translúcidas con el fondo desenfocado y saturado. Las superficies de
+  **contenido** (tarjetas, secciones, tablas) siguen opacas a propósito.
+
+  Los componentes no saben nada del cristal: consumen tokens nuevos
+  (`--netzi-float-bg`, `--netzi-float-border`, `--netzi-float-border-2`,
+  `--netzi-float-filter`, `--netzi-float-text-2`, `--netzi-float-text-3`) que con el
+  eje apagado valen exactamente lo mismo que los de siempre.
+
+  **El suelo de contraste no lo pone solo el alfa.** Sobre cristal el texto se lee
+  contra lo que haya debajo, que cambia al scrollear, así que el caso a cumplir es el
+  fondo más contrario posible. Taparlo con opacidad exige alfa 0.82, y a 0.82 esto ya
+  no parece cristal; en su lugar el propio `backdrop-filter` **acota el fondo** antes
+  de componerlo —`contrast(0.6)` comprime su rango y `brightness()` lo empuja al tono
+  de la capa (`1.2` en claro, `0.66` en oscuro)—, y con eso bastan **0.70** de alfa en
+  claro y **0.62** en oscuro: se ve lo de detrás y el peor caso sigue dando **4.64:1**
+  (negro puro debajo) y **4.66:1** (blanco puro debajo), con el texto de la capa subido
+  un nivel. `tokens-contrast.spec.ts` modela la cadena entera, no solo el alfa. Las
+  capas llevan además un filo especular (`--netzi-float-glow`), que es lo que hace que
+  una superficie translúcida se lea como cristal y no como un velo.
+
+  **El desenfoque no va en las capas que hospedan controles anclados.** Un
+  `backdrop-filter` distinto de `none` convierte al elemento en bloque contenedor de
+  sus descendientes `position: fixed`: medido, un hijo fijo saltaba de (0,0) al origen
+  del contenedor. Como el topbar, el sidebar, el popover, el modal, el drawer y el
+  panel de fecha hospedan controles que se anclan al viewport, en esos el filtro va en
+  una capa `::before` aparte. El panel de `netzi-date` además pasa a scrollear en un
+  envoltorio interior, para que su capa de cristal no se desplace con el contenido.
+
+  **`netzi-tooltip` se queda opaco a propósito.** Es tinta invertida
+  (`--netzi-text` de fondo) sobre un texto diminuto y efímero, que es justo donde la
+  translucidez más estorba y menos aporta; el cristal ahí sería un peaje de
+  legibilidad sin ganancia visual.
+
+  Degradación automática, sin JS: con `prefers-reduced-transparency: reduce` y donde
+  no haya `backdrop-filter`, la superficie opaca de siempre.
+
+- af3207d: **Alias semánticos de estado, alias por simetría y un tinte marcado.** Toda app
+  da por hechos `--netzi-success` / `--netzi-warning` / `--netzi-danger` /
+  `--netzi-info`, y hasta ahora solo existían los colores crudos
+  (`--netzi-green`…). El problema no es el nombre: un token que no existe **no
+  falla**. La declaración entera se descarta y el elemento se queda sin fondo, sin
+  color o sin radio, sin un aviso en build ni en consola. El propio kit lo tenía:
+  `netzi-cron-picker` pintaba el borde y la nota del campo con error con
+  `var(--netzi-danger)` y llevaba desde el primer día marcándolos en gris.
+  - Los cuatro estados, en crudo y como texto (`--netzi-danger-text`…), declarados
+    como **referencia** al color de marca, no como copia.
+  - Alias por simetría: `--netzi-surface-1`, `--netzi-text-1` y
+    `--netzi-radius-md`, que son los nombres que se escriben al ver el `-2`.
+  - **`--netzi-primary-tint-strong`** (22 % en claro, 28 % en oscuro): el tinte del
+    10 % está calibrado para superficies grandes y en una pieza pequeña se pierde
+    contra el panel (1.13:1). Este llega a 1.32:1. Su tinta es `--netzi-text`; el
+    suave no se puede subir porque es el techo de `--netzi-primary-text`.
+  - Un **guardián en la suite** (`tokens-declarados.spec.ts`) recorre todo el CSS
+    del kit y falla si un `var(--netzi-*)` apunta a un token que nadie declara, que
+    es como se destapó lo del cron.
+
+### Patch Changes
+
+- 1175b77: Alturas de control estandarizadas: todos los inputs de valor (input, select,
+  número, password, teléfono, combobox, moneda, color, búsqueda, fecha, hora) y el
+  botón comparten una **altura fija por tamaño** (sm 36 / md 44 / lg 52 px;
+  compacta 32/40/46) vía tokens `--netzi-control-h-{sm,md,lg}`, así alinean exacto
+  al ponerlos en fila. Los inputs de valor ganan un input `size` (sm/md/lg). Las
+  alturas escalan con `--netzi-font-scale`. Se corrige el botón `lg` (antes medía
+  igual que `md`). Multilínea (textarea, tags) quedan como excepción con
+  `min-height`.
+- 1175b77: **Los README de los paquetes ya dicen qué registry usar, y por qué el otro es
+  peligroso.** Ninguno documentaba la configuración del scope `@netzi`: el de `ui` solo
+  decía `pnpm add …` y el de `tokens` remitía al `.npmrc` "del repo", que un consumidor
+  externo no tiene. Como el README **viaja dentro del paquete**, es el sitio por el que se
+  enteran los de fuera.
+
+  Ahora los dos traen la línea del endpoint del **proyecto** y el aviso de que el endpoint
+  de **grupo** reenvía al npm público cualquier `@netzi/*` que no encuentre
+  (`302 → registry.npmjs.org`), que el scope `@netzi` **no está reclamado** en npmjs.org y
+  que apagar el reenvío en los ajustes del grupo **no lo evita** (issue #16).
+
+- 1175b77: El **`CHANGELOG.md` ahora se incluye en el paquete publicado**. Antes solo se
+  empaquetaba el `README.md` (ng-packagr lo copia solo; el CHANGELOG no estaba en los
+  `assets` de `@netzi/ui` ni en el `files` de `@netzi/tokens`), así que quien instalaba
+  el paquete no veía el historial de cambios. Se añade `./CHANGELOG.md` a los assets de
+  `@netzi/ui` y a `files` de `@netzi/tokens`. Aplica desde la próxima publicación.
+
+## 0.1.0-beta.3
+
+### Minor Changes
+
+- 13ebbcd: Nueva **escala de espaciado** `--netzi-space-0..8` (base 4px: 0/2/4/8/12/16/24/32/48).
+  Da a las apps tokens de gaps/paddings coherentes con el sistema, en vez de píxeles/rem
+  sueltos. Bajo `[data-density='compact']` los pasos medios/grandes se reducen (4→10, 5→12,
+  6→20, 7→28, 8→40), coherente con la densidad de los controles; los pasos finos no cambian.
+  Documentada en el README de tokens, en el showcase de tokens (sección "Espaciado") y en
+  Storybook (Fundamentos/Espaciado). Cierra #34.
+
+## 0.1.0-beta.2
+
+### Patch Changes
+
+- 1e27de5: El **`CHANGELOG.md` ahora se incluye en el paquete publicado**. Antes solo se
+  empaquetaba el `README.md` (ng-packagr lo copia solo; el CHANGELOG no estaba en los
+  `assets` de `@netzi/ui` ni en el `files` de `@netzi/tokens`), así que quien instalaba
+  el paquete no veía el historial de cambios. Se añade `./CHANGELOG.md` a los assets de
+  `@netzi/ui` y a `files` de `@netzi/tokens`. Aplica desde la próxima publicación.
+
+## 0.1.0-beta.1
+
+### Patch Changes
+
+- 145ff48: Alturas de control estandarizadas: todos los inputs de valor (input, select,
+  número, password, teléfono, combobox, moneda, color, búsqueda, fecha, hora) y el
+  botón comparten una **altura fija por tamaño** (sm 36 / md 44 / lg 52 px;
+  compacta 32/40/46) vía tokens `--netzi-control-h-{sm,md,lg}`, así alinean exacto
+  al ponerlos en fila. Los inputs de valor ganan un input `size` (sm/md/lg). Las
+  alturas escalan con `--netzi-font-scale`. Se corrige el botón `lg` (antes medía
+  igual que `md`). Multilínea (textarea, tags) quedan como excepción con
+  `min-height`.
+
+## 0.1.0-beta.0
+
+Primera beta pública de los tokens (reinicio de numeración: el canal beta
+arranca aquí; el desarrollo previo vive en la historia de git).
+
+Incluye: superficies y texto para tema claro/oscuro, color primario con
+presets (`[data-preset]`) y tinte derivado, tonos semánticos, contraste alto,
+densidad compacta, radios (`--netzi-radius-sm/-/lg`), sombras, tipografía con
+familia configurable y **escala global de tamaño de letra**
+(`--netzi-font-scale`), y base CSS con herencia correcta de color en
+controles. Override por CSS para white-label.

package/LICENSE.md

@@ -0,0 +1,33 @@
+# Licencia de uso de Netzi UI (@netzi/ui y @netzi/tokens)
+
+Copyright © 2026 Netzi Tech. Todos los derechos reservados.
+
+Netzi Tech concede a quien obtenga este paquete desde el registro público de npm
+una licencia **gratuita, mundial, no exclusiva e intransferible** para:
+
+1. **Instalar y usar** el paquete, tal cual se distribuye, en aplicaciones propias o
+   de terceros, con o sin fines comerciales.
+2. **Incorporarlo** a los artefactos compilados de esas aplicaciones (bundles) y
+   distribuir dichos artefactos.
+
+No se concede ningún otro derecho. En particular, **no está permitido**:
+
+- redistribuir el paquete por separado, ni total ni parcialmente, en ningún otro
+  registro, repositorio o medio;
+- modificar, descompilar, desofuscar o crear obras derivadas del paquete, salvo lo
+  estrictamente necesario para integrarlo en una aplicación;
+- retirar o alterar este aviso, las marcas o las atribuciones incluidas;
+- usar el nombre «Netzi» o sus marcas para promocionar productos derivados sin
+  autorización escrita.
+
+Las tipografías incluidas (Plus Jakarta Sans y Fira Code) se distribuyen bajo la SIL
+Open Font License 1.1, que acompaña a cada fuente y prevalece sobre esta licencia
+para esos archivos.
+
+EL PAQUETE SE ENTREGA «TAL CUAL», SIN GARANTÍA DE NINGÚN TIPO, EXPRESA O IMPLÍCITA,
+INCLUIDAS LAS DE COMERCIALIZACIÓN, IDONEIDAD PARA UN FIN CONCRETO Y NO INFRACCIÓN.
+EN NINGÚN CASO NETZI TECH RESPONDERÁ POR DAÑOS DERIVADOS DEL USO DEL PAQUETE.
+
+Esta licencia aplica a la versión del paquete que la acompaña. Netzi Tech podrá
+publicar versiones futuras bajo otros términos, incluidas licencias de pago; cada
+versión lleva la licencia que le corresponde. Contacto: <netzi.tech@gmail.com>.