History

Danila Poyarkov 099e5d7a15 fix(fig): keep filled frames and copied text sized as in OpenPencil when exported to Figma (#956 ) * fix(fig): keep filled frames fixed along the axis they fill Figma stores fill on the child and keeps that axis fixed in the frame's own sizing; a hugging value there wins over the stretch or grow. A row filled across a vertical card, or an instance stretched to the card's width, was written with its own sizing still hugging, so in Figma the row shrank and pushed its badge against the title, and the button shrank to its label. The .fig and clipboard writer now writes a filled axis as FIXED, both on the frame's own record and in an instance's sizing override, which Figma applies over the record. Unedited imported layers keep their stored sizing, since Figma's own files also hold hugging axes on stretched children. * fix(clipboard): keep how text resizes when copying to Figma The Figma clipboard writer forced every text record to a fixed size and layout version 5. Figma then kept the width OpenPencil measured instead of laying the text out in its own font, so labels it draws wider overflowed or wrapped: a pricing card's title ran under its badge and its button label broke onto two lines. Text now keeps the auto-resize and layout version the .fig writer gives it, as Figma's own files store them, and a paste into Figma 126 grows each label to fit.		2026-10-07 18:05:23 +00:00
..
docs	fix(fig): write text glyphs from the layout the renderer draws (#928 )	2026-10-06 11:37:02 +00:00
scripts	feat(fig): occurrence-scoped instance interpretation as the single .fig reader	2026-10-01 11:20:27 +04:00
src	fix(fig): keep filled frames and copied text sized as in OpenPencil when exported to Figma (#956 )	2026-10-07 18:05:23 +00:00
tests	test: resolve repository files without climbing directories (#946 )	2026-10-07 12:35:39 +00:00
AGENTS.md	feat(fig): occurrence-scoped instance interpretation as the single .fig reader	2026-10-01 11:20:27 +04:00
package.json	build: update dependencies (#873 )	2026-10-04 12:48:24 +00:00
README.md	fix(fig): write text glyphs from the layout the renderer draws (#928 )	2026-10-06 11:37:02 +00:00
tsconfig.json	fix: explain unsupported browsers instead of a blank window (#745 )	2026-09-22 14:40:59 +04:00
tsconfig.test.json	feat(fig): scaffold package shell	2026-06-30 10:51:36 +03:00
tsdown.config.ts	refactor(fig): own Figma clipboard encoding and conversion	2026-09-11 00:36:03 +03:00

README.md

@open-pencil/fig

.fig file-format package for OpenPencil.

The package owns the outer .fig archive boundary and is the staged home for Figma-specific SceneGraph conversion policy. Production SceneGraph read/write remains available through @open-pencil/core/io while conversion modules move behind this package's public API.

Current ownership:

Complete .fig archive parsing through parseFigBuffer()
.fig archive assembly through writeFigArchive()
Canvas payload and image resource handling
readFigContainer() / writeFigContainer() helpers for raw fig-kiwi payloads
.fig source and archive result types
NodeChange-to-SceneGraph property conversion, including styles, plugin metadata, text, paint, vector, and font policy, through @open-pencil/fig/node-change
Component-property, symbol-override, derived-symbol-data, and instance synchronization policy through @open-pencil/fig/instance-overrides
Effective raw-metadata precedence and invalidation over SceneGraph's format-neutral edited-field tracking
SceneGraph-to-NodeChange export conversion with an explicit text-shaping runtime service for saved glyphs
Package-local archive, conversion, instance, export, and dist smoke tests

Architecture documentation

Start with the package docs for the source model, instance evaluation, materialization, document sessions, export, and validation contracts.

Planned ownership:

Oracle-backed .fig fixtures

Non-goals:

Generic Kiwi schema/runtime internals — use @open-pencil/kiwi
Format-neutral IO registration, export targeting, CanvasKit thumbnails, or browser workers — use @open-pencil/core/io
Editor actions, renderer behavior, Vue/app UI, CLI formatting, or MCP transport

This follows the existing @open-pencil/pen pattern: a format package owns its source model/parser and SceneGraph policy, while core registers it in the shared IO system.

Checks

cd packages/fig
bun run check