@hanzo/ui

Temas

Los tokens se resuelven contra el tema, las propiedades personalizadas llevan la identidad, y tres mandos dejan que una persona reajuste todo.

Nada en la biblioteca nombra un color. Un componente pide $background o $color12, el tema responde, y la respuesta cambia entre oscuro y claro sin que el componente lo sepa. Una marca cambia la respuesta fijando una propiedad personalizada; una persona la cambia moviendo un mando por el que se multiplican las rampas.

Tokens

Un valor de prop que empieza por $ es un token. La rampa de color va de la superficie al texto: $color1 es el fondo más quieto, $color12 el texto más fuerte.

TokenQué es
$backgroundEl fondo de la página. Lee --background, así que lo responde la hoja de la marca.
$colorEl color de texto por defecto.
$color1 – $color12La rampa neutra: $color2/$color3 son superficies elevadas, $color10/$color11 texto atenuado, $color12 el más fuerte.
$borderColorEl filete. Translúcido, así que se lee como una línea más clara sobre cualquier superficie, y no como un gris que no viene a cuento.
$accentBackground / $accentColorEl único control fuerte que se le permite a una página. Leen --primary, así que les llega el mando de acento.
defaultsecondarydestructiveoutline

Las escalas

El tamaño, el espacio y el radio son los mismos números en cada host, y cada peldaño lleva un mando.

Tipo. fontSize="$n", nunca un número. Doce peldaños leen la rampa de diseño, de --text-xs a --text-9xl, y los cuatro peldaños de en medio interpolan a sus vecinos, así que la escala de una persona mueve los dieciséis y la escala sigue siendo una escala.

Peldaño$1$2$3$4$5$6$7$8$9$10$11$14
px111314151517212626324064

$1 es una etiqueta, $2 la navegación y el cuerpo denso, $3 la base, $6 un título de sección, $7 un título de página, $8 y lo que sigue el display. Los peldaños de display aprietan la interlínea y el tracking a −0.025em, que es la diferencia entre un tipo compuesto y un tipo que solamente es grande.

Espacio. La rampa de 4px, y solo esa: $1 4, $2 8, $3 12, $4 16, $5 24, $6 32, $8 48, $10 64. Cada paso se multiplica por --density.

Radio. Cuatro valores. $1 y $2 son 6, un control; $3 y $4 son 8, un campo o una fila; de $5 a $9 son 12, un panel; $10 y por encima son la píldora. Todo, menos la píldora, se multiplica por --radius-scale.

Propiedades personalizadas

La identidad es un conjunto de propiedades personalizadas en :root, el oscuro primero, y .light las reajusta. Hanzo pone .t_dark o .t_light en el body y el CSS responde a las dos grafías, así que los tokens de los componentes y la hoja de estilos nombran un solo tema.

:root {
  --background: #0a0a0a;
  --foreground: #e5e5e5;
  --primary: #fafafa;
  --border: rgb(255 255 255 / .10);
  --ring: rgb(255 255 255 / .40);
  --font-sans: 'Zen', ui-sans-serif, system-ui, sans-serif;
  --font-mono: 'Zen Mono', ui-monospace, monospace;
}

El conjunto entero es --background, --foreground, --card, --popover, --primary, --secondary, --muted, --accent, --destructive, cada uno con su -foreground, luego --border, --input, --ring, --radius, de --chart-1 a --chart-5, y la familia --sidebar-*. Vienen de @hanzo/design y se componen en la hoja que importa la raíz; un host que también monta la hoja propia de design la sigue en directo.

Una marca reajusta declarando los mismos nombres más tarde en la cascada. Un host que trae su propia familia ata --font-sans-provided y no --font-sans, porque el enlace del paquete vive en una capa y una declaración sin capa gana, sea cual sea su especificidad.

Los mandos de apariencia

@hanzo/design publica tres mandos por los que se multiplica cada rampa, y @hanzo/appearance es el panel que los fija para una persona:

MandoQué mueve
--type-scaleCada peldaño --text-*, y con él cada fontSize="$n".
--type-ratioCuánto se separan los peldaños.
--densityCada paso --space-*, y cada gap y cada padding de gui.
--primary / --accentEl único color fuerte.
--font-sansLa familia de lectura: la de la marca, la del sistema, una serif, o mono.
--container-max / --container-prose / --container-wideLas tres medidas a las que se compone una página.

Caen como propiedades en línea sobre html, que es :root, así que le ganan a cualquier hoja sin necesidad de un selector que las supere en especificidad, y llegan a los componentes porque gui resuelve un tamaño en JavaScript como var(--text-base) y la variable sigue leyendo la cascada en el elemento. Un eje que nadie ha fijado está ausente, no en neutro: escribir 1 se vería igual y, en silencio, le ganaría a una marca que publicó su propia escala.

import { Appearance } from '@hanzo/appearance'
import { bootScript } from '@hanzo/appearance/state'

// In <head>, so the first paint is already correct.
<script dangerouslySetInnerHTML={{ __html: bootScript() }} />

// Wherever the product keeps settings.
<Appearance />

Hanzo vuelve a aplicar la preferencia guardada en cada montaje, así que una elección hecha en una página se mantiene en la siguiente. El control de la cabecera de este sitio es ese panel.