Fonts & images

Fonts

Text embeds as real glyph runs with subset fonts. It stays selectable, searchable, and copyable. Pass a URL or raw bytes. You can also use the googleFonts helper:

import { googleFonts } from "@takumi-rs/helpers";

const pdf = await render(doc, {
  fonts: [...(await googleFonts(["Inter"])), { name: "Brand Sans", weight: 700, data: fontBytes }],
  fontFamilies: ["Brand Sans", "Inter", "sans-serif"],
});

fontFamilies sets the fallback chain for each render. Registered fonts deduplicate across calls that use the same renderer.

Images

The renderer never fetches over the network. Pass pre-fetched bytes for each image URL in the document:

const logoBytes = new Uint8Array(await (await fetch(logoUrl)).arrayBuffer());

const pdf = await render(doc, {
  images: [{ src: logoUrl, data: logoBytes }],
});

SVG image sources rasterize at 2× their placed size. Raster sources embed once for each distinct pixel data.

Runtimes

takumi-pdf is wasm-only. It runs on Node.js, Bun, and Cloudflare Workers. The module fits within the Workers free-tier size limit. Import takumi-pdf/no-init to control wasm instantiation.