字型

@textjs/font 解析 FIGfont 2（.flf）檔案，並以與 figlet 程式完全相同的方式配置版面。每個字型都是一個 ES 模組，因此只會隨附你匯入的字型。

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>;}

#安裝

bun add @textjs/font

#使用方式

<FigletText> 接受一個字型和一個字串。每列以儲存格為單位測量，因此字樣能像其他 <Text> 一樣放入 flexbox 版面配置。

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> 接受相同的字型，並保留內建的 block 和 compact 字樣：

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

在 React 之外，renderFiglet 為每列回傳一個字串：

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

#版面配置

水平版面配置遵循 FIGlet 的旗標。

已實作全部六種水平擠合規則：相同字元、底線、階層、相對配對、大 X 和硬空白。

verticalLayout 適用於多行文字。FIGlet 2.2.5 不會縮小行距，因此預設為 "full"；"fitted"、"smushed" 和 "universal" 實作了五種垂直規則，包括垂直線超級擠合，而 "default" 使用字型本身的設定。

#換行與對齊

columns（或 renderFiglet 中的 width）會先在單字之間換行，再於單字內換行，換行位置與 figlet -w 完全相同。align 可設為 "left"、"center" 或 "right"；未指定寬度時，各列會以最寬列的寬度對齊。ivrit 等由右至左的字型會由右至左輸出並靠右對齊；使用 direction 可覆寫此設定。

#隨附字型

每個字形都由可列印的 ASCII 或 Latin-1 字元組成，因此每個組成字元在 DevTools 的 Menlo 字型中恰好佔一個儲存格。@textjs/font/all 匯出所有字型，以及供字型展示使用的 BUNDLED_FONTS。字型會在首次渲染時解析，而非匯入時。

#自訂字型

任何 FIGfont 都能使用。先擷取，再解析：

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

解析器會讀取標頭、註解行、硬空白、結束標記、102 個必要字元，以及以十進位、八進位或十六進位代碼標記的字元。TOIlet .tlf 字型會以純文字渲染。優先使用以 ASCII 或框線字元繪製的字型；點字和 emoji 在 Menlo 中的寬度並非一個儲存格。

#授權

隨附字型與 FIGlet 2.2.5 發行版的字型逐位元組相同，採用 FIGlet 的 BSD 3-Clause 授權。每個字型的註解行都保留作者資訊，可在執行時透過 font.comment 取得。未取得再散布授權的熱門字型，例如 Doom、Larry 3D、ANSI Shadow 和 Calvin S，並未隨附。

#與 figlet 比對驗證

測試套件會重播從實際 figlet 2.2.5 二進位檔記錄的 273 筆輸出：涵蓋每個隨附字型的所有版面配置模式、換行、對齊、由右至左文字、段落模式，以及 FIGlet 本身的迴歸測試輸入。所有結果都完全一致。