[matmen]

Image.renderText now takes several fonts by priority and draws color glyphs, so emoji fonts can sit next to a text font:

const image = await Image.renderText([sourceSans, notoColorEmoji], 48, 'Hi 😀🔥 👍', { color: 0x000000ff });

This is the first of three steps. Emoji sequences (skin tones, flags, families, keycaps) need GSUB ligatures, which come next. COLR v1 comes after that.

Fallback fonts

• Every character comes from the first font that has a glyph for it.
• The first font sets the line height and baseline.
• Kerning applies between glyphs of the same font.
• Each glyph is placed on whole pixels only if its own font is hinted. Before this, the first font decided for every glyph.
• A single font as before renders unchanged; all existing targets pass.

Color glyphs (src/render/color.ts)

• COLR version 0 with CPAL (Twemoji, Segoe UI Emoji): each layer outline goes through the existing rasterizer and is filled with its palette color, from the first palette. Layers marked with the text color take the text's color.
• CBDT/CBLC (Noto Color Emoji): index formats 1–5, image formats 17–19. The PNG comes from the strike closest to the size (the smallest one at least as large) and is resampled to the font size.
• Fonts that contain only bitmaps, like Noto Color Emoji, can now be loaded at all. Before this they failed with "no supported glyph outlines".
• Color glyphs render into a premultiplied RGBA layer above the text. They take the alpha of the text color, and a stroke goes around them too.
• render() is now async, because PNG decoding is.

Invisible characters

Default ignorable code points take no room, even when a font has glyphs for them. This covers ZWJ, the variation selectors FE0E/FE0F and tag characters. HarfBuzz hides them the same way. Twemoji, for example, has wide empty glyphs for ZWJ and FE0F, which left gaps.

Tests

• Subsets of Noto Color Emoji (73 kB, OFL) and Twemoji Mozilla (15 kB, CC-BY 4.0) are added under tests/fonts, with license notices.
• New targets emoji-cbdt.png and emoji-colr.png.
• New checks:
  • emoji keep their colors;
  • ZWJ and FE0F take no room;
  • characters fall back to the next font;
  • a bitmap-only font renders on its own.

🤖 Generated with Claude Code

https://claude.ai/code/session_01YJgRK5qpwJEbHPuFv6kgAQ