Saltar al contenido
fontstay.dev
Código fuente en GitHub
Tema
Simulación de visión

Para revisar el diseño; no corrige la visión del color.

Ayudas de lectura

CLI y biblioteca para Node

El paquete fontstay es el motor de ajuste de este sitio sin el navegador: una herramienta de línea de comandos y una biblioteca de Node que leen archivos de fuentes e imprimen las mismas reglas @font-face y exportaciones que la aplicación. No necesita DOM ni red, así que encaja en pipelines de compilación y CI.

Instalación

El paquete aún no está publicado en npm. Requiere Node 24 o superior; compílalo desde una copia del repositorio. En los ejemplos siguientes, fontstay equivale a node packages/fontstay/dist/bin.js.

git clone https://github.com/fogrew/fontstay.dev.git
cd fontstay.dev
pnpm install
pnpm cli:build
node packages/fontstay/dist/bin.js --version

Comandos

fit lee uno o varios archivos de fuentes (WOFF2, WOFF, TTF, OTF) e imprime el CSS de reserva. Varios archivos se combinan en una sola hoja de estilos, como en la aplicación. mcp inicia un servidor MCP por stdio para agentes de programación y no admite opciones.

Ajusta una fuente para Windows y macOS sin las caras cirílica y griega. La salida es el mismo texto que la exportación CSS de la aplicación.

$ fontstay fit font.woff2 --systems windows,macos --no-scripts
@font-face {
  font-family: "Source Sans Pro Fallback";
  src: local("Arial"), local("ArialMT");
  size-adjust: 93.697%;
  ascent-override: 105.0194%;
  descent-override: 29.1365%;
  line-gap-override: 0%;
}

body {
  font-family: "Source Sans Pro", "Source Sans Pro Fallback", sans-serif;
  /* Safari has no vertical overrides: match the x-height and fix the line box */
  font-size-adjust: 0.48;
  line-height: 1.4;
}

.fonts-loading {
  letter-spacing: -0.0003em;
  word-spacing: -0.0025em;
}
fontstay fit Inter.woff2 -o fallbacks.css
fontstay fit regular.woff2 bold.woff2 --format tailwind
fontstay fit font.woff2 -a 'last 2 chrome versions, os windows' --json

Opciones

OpciónSignificado
-s, --systems <list>Sistemas a ajustar: windows, macos, ios, android, linux, chromeos. Por defecto: todos los sistemas con al menos un 1 % de cuota en la audiencia.
-a, --audience <query>Consulta de Browserslist, opcionalmente con partes «os <system>» y «not os <system>». Por defecto: baseline widely available.
-f, --format <format>Formato de salida, véase más abajo. Por defecto: css.
-k, --kind <kind>Familia genérica de las fuentes de reserva: sans-serif, serif, monospace o cursive. Por defecto: se detecta a partir de la fuente.
--locale <en|ru>Perfil de frecuencias del ajuste: en o ru. Por defecto: en.
--unicode-rangeAñade unicode-range con los glifos que cubre cada fuente.
--no-scriptsNo genera caras separadas para cirílico y griego.
-o, --out <file>Escribe la salida en un archivo en lugar de stdout.
--jsonImprime un informe JSON en lugar del texto del archivo.
-h, --help / -v, --versionMuestra la ayuda o la versión.

Formatos de salida

--format acepta uno de estos valores. Coinciden con los formatos de exportación de la aplicación y parten del mismo ajuste.

Ejecuta este comando para cada formato con la fuente de ejemplo Fira Sans. La salida mostrada procede de la CLI compilada.

Comando

fontstay fit tests/fixtures/fonts/FiraSans-Regular.ttf --systems windows --no-scripts --format css

Salida de la CLI

@font-face {
  font-family: "Fira Sans Fallback";
  src: local("Trebuchet MS"), local("TrebuchetMS");
  size-adjust: 100.3942%;
  ascent-override: 93.1328%;
  descent-override: 26.3959%;
  line-gap-override: 0%;
}

body {
  font-family: "Fira Sans", "Fira Sans Fallback", sans-serif;
  /* Safari has no vertical overrides: match the x-height and fix the line box */
  font-size-adjust: 0.527;
  line-height: 1.4;
}

.fonts-loading {
  letter-spacing: -0.0019em;
}

Salida e informes

El texto del archivo va a stdout. Con --json se imprime un informe con las claves file (la salida en el formato elegido), fonts (familia, tipo detectado, cobertura de glifos y la fuente de reserva elegida por sistema para cada fuente), shares (cuota de cada sistema en la audiencia, en porcentaje), systems, uncovered (sistemas de la audiencia sin fuente de reserva) y audience (la consulta resuelta y el número de navegadores que coinciden). Las cuotas dependen de los datos de navegadores en el momento de la ejecución.

Las advertencias van a stderr, así que nunca acaban en la salida: una fuente cuyas reservas comparten menos del 90 % de sus glifos y los sistemas sin ninguna fuente de reserva. Con --out, la herramienta también informa del archivo escrito en stderr.

Biblioteca para Node

fit recibe los bytes de la fuente y fitFiles lee archivos. Ambas devuelven el CSS, la salida en el formato pedido, un informe por fuente y las cuotas de la audiencia. Los fallos lanzan FitRunError (invalid-audience, no-systems, no-fit) o FontParseError (por ejemplo invalid-font). Los tipos están en index.d.ts.

import { fit, fitFiles } from 'fontstay';
import { readFile } from 'node:fs/promises';

const { css, fonts, shares } = await fit({
  fonts: [{ fileName: 'font.woff2', data: await readFile('font.woff2') }],
  audience: 'defaults',
  systems: ['windows', 'macos'],
});

const tailwind = (await fitFiles(['font.woff2'], { format: 'tailwind' })).file.text;

Códigos de salida

CódigoSignificado
0Correcto.
1Fallo: un archivo que no se puede leer, una fuente no válida o una audiencia no válida.
2Error de uso: un comando desconocido, ningún archivo de fuente o un valor de opción no válido.

Configurar el servidor MCP