Fuentes

@textjs/font analiza archivos FIGfont 2 (.flf) y los distribuye exactamente como el programa figlet. Cada fuente es un módulo ES, por lo que solo se incluyen las fuentes que importas.

import { FigletText } from "@textjs/font/react";import { slant } from "@textjs/font/slant";export default function Page() {  return <FigletText font={slant} color="accent">Text.js</FigletText>;}

#Instalación

bun add @textjs/font

#Uso

<FigletText> recibe una fuente y una cadena. Las filas se miden en celdas, por lo que las letras encajan en layouts flexbox como cualquier otro <Text>.

import { FigletText } from "@textjs/font/react";import { big } from "@textjs/font/big";<FigletText font={big} layout="fitted" columns={60} align="center" color="muted">  Deployed</FigletText>

<AsciiFont> acepta las mismas fuentes y conserva sus estilos de letras integrados block y compact:

<AsciiFont text="Text.js" font={slant} color="accent" />

Fuera de React, renderFiglet devuelve una cadena por fila:

import { renderFiglet } from "@textjs/font";import { standard } from "@textjs/font/standard";renderFiglet(standard, "Hello", { layout: "full" });// ["  _   _          _   _         ", " | | | |   ___  | | | |   ___  ", …]

#Layout

El layout horizontal sigue las opciones de FIGlet.

Se implementan las seis reglas de fusión horizontal: carácter igual, guion bajo, jerarquía, par opuesto, X grande y espacio inseparable.

verticalLayout se aplica al texto de varias líneas. FIGlet 2.2.5 nunca reduce la separación entre líneas, por lo que el valor predeterminado es "full"; "fitted", "smushed" y "universal" implementan las cinco reglas verticales, incluida la superfusión de líneas verticales, y "default" usa las de la fuente.

#Ajuste de línea y alineación

columns (o width en renderFiglet) ajusta las líneas entre palabras y después dentro de ellas, exactamente donde lo haría figlet -w. align puede ser "left", "center" o "right"; sin un ancho, las filas se alinean dentro de la fila más ancha. Las fuentes de derecha a izquierda, como ivrit, se imprimen de derecha a izquierda y se alinean a la derecha; cambia este comportamiento con direction.

#Fuentes incluidas

Cada glifo es ASCII imprimible o Latin-1, por lo que cada subcarácter ocupa exactamente una celda en la fuente Menlo de DevTools. @textjs/font/all exporta todas las fuentes, además de BUNDLED_FONTS para galerías. Las fuentes se analizan en el primer renderizado, no al importarlas.

#Fuentes personalizadas

Cualquier FIGfont funciona. Descárgala y después analízala:

import { parseFont } from "@textjs/font";const doom = parseFont(await (await fetch("/fonts/doom.flf")).text(), "Doom");

El analizador lee la cabecera, las líneas de comentarios, los espacios inseparables, las marcas de fin, los 102 caracteres obligatorios y los caracteres etiquetados con códigos en decimal, octal o hexadecimal. Las fuentes TOIlet .tlf se renderizan como texto sin formato. Elige preferentemente fuentes dibujadas con ASCII o caracteres de dibujo de recuadros; el braille y los emojis no ocupan una sola celda de ancho en Menlo.

#Licencias

Las fuentes incluidas son las de la distribución FIGlet 2.2.5, byte por byte, bajo la licencia BSD de 3 cláusulas de FIGlet. Cada una conserva sus créditos en sus líneas de comentarios, disponibles en tiempo de ejecución como font.comment. No se incluyen fuentes populares sin permiso de redistribución, como Doom, Larry 3D, ANSI Shadow y Calvin S.

#Verificación con figlet

La suite de pruebas reproduce 273 salidas registradas del binario real de figlet 2.2.5: cada fuente incluida en cada modo de layout, ajuste de línea, justificación, texto de derecha a izquierda, modo de párrafo y la entrada de regresión del propio FIGlet. Todas coinciden exactamente.