History

Danila Poyarkov b0231927c5 docs: route contributors through per-domain guides and ship npm license text (#785 ) Root AGENTS.md becomes a map plus cross-cutting rules; folder rules live in one AGENTS.md per package and top-level folder, checked by check:docs. CONTRIBUTING.md owns process; README and the docs page link to it. Release preparation copies the root LICENSE into every published package, Core, CLI, and MCP gain READMEs, and the release workflow test packs its fixture in-process instead of through npm.		2026-09-29 01:02:06 +04:00
..
scripts	refactor(fig): own NodeChange export policy	2026-07-18 02:41:35 +03:00
src	refactor!: move shared primitives below dom-css and core (#771 )	2026-09-26 11:39:11 +04:00
tests	fix: convert document colour profiles, keep text edits live, and fix .fig exports (#716 )	2026-09-18 00:43:10 +03:00
AGENTS.md	docs: route contributors through per-domain guides and ship npm license text (#785 )	2026-09-29 01:02:06 +04:00
package.json	Release v0.15.1	2026-09-18 16:33:46 +03:00
README.md	refactor(fig): own NodeChange export policy	2026-07-18 02:41:35 +03: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 glyph-outline runtime service
Package-local archive, conversion, instance, export, and dist smoke tests

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