FontCollection

FontCollection holds the fonts a paragraph can use. Valo never opens font files or talks to the network. Register bytes the host already loaded.

let mut fonts = FontCollection::new();
fonts.add(Font::from_bytes(regular)?);
let cjk = fonts.add(Font::from_bytes(cjk)?);
fonts.add_fallback(cjk);

const fonts = new FontCollection();
fonts.registerFont('Inter', bytes, false);
fonts.registerFont('Noto Sans SC', cjkBytes, true); // fallback

This page already registered Fira Sans and JetBrains Mono. Change a family name, size, or colour.

Add styled families first, then fallbacks for codepoints they do not cover. Rebuild paragraphs after adding faces — lists built from earlier snapshots are unaffected.

registerFont returns false when the bytes do not parse. An empty collection cannot build a paragraph (JavaScript throws). registerInstances registers every face a file offers — named instances of a variable font included — and optionally appends them to the fallback chain.

Native system fonts

On native platforms, valo-system-fonts discovers installed faces and implements FontSource. It is never a wasm dependency. See Integrations.

After layout, unanswered families and codepoints are available as a font demand so the host can fetch more faces.

Next: Paragraph.