@figit/fig-kiwi

Encode Figma's Kiwi binary format and HTML clipboard envelope.

import { encodeFigmaData, composeClipboardHtml } from "@figit/fig-kiwi";

const { figBytes, base64 } = encodeFigmaData(message);
const html = composeClipboardHtml(base64, { dataType: "scene", fileKey: "TEST", pasteID: 123 });

API

• encodeFigmaData(message) — encode a Kiwi Message into fig-kiwi bytes (magic + version + deflated schema + deflated data) plus base64.
• composeClipboardHtml(base64, meta?) — wrap the base64 payload in the HTML envelope Figma reads on paste, using Figma-style data-metadata and data-buffer attributes so WebKit preserves the markers during HTML clipboard sanitization. Works in any environment with btoa (no DOM).
• toClipboardItem(html) — browser/extension helper that wraps the HTML in a ClipboardItem for navigator.clipboard.write.
• KiwiWriter — varint write primitives (byte, bool, uint, int, float, string, …) for callers that need to emit other Kiwi structures.
• SCHEMA — the bundled Figma Kiwi schema.

Regenerating the schema

src/schema.json is generated. To pull a fresh copy from Figma:

# In Figma: select any node, Cmd+C
pnpm extract-schema

The script reads the system clipboard's text/html, decodes the embedded Kiwi schema, and overwrites src/schema.json. macOS and Linux clipboard reads work automatically; on Windows, pipe HTML on stdin or pass a file path:

pnpm extract-schema clipboard.html       # from a file
cat clipboard.html | pnpm extract-schema -   # from stdin

License

MIT — Figit.