History

Danila Poyarkov 6c6f24409e feat: let a collection name the attribute its modes switch by (#913 ) * feat: let a collection name the attribute its modes switch by Manually switched modes were always selected by data-<collection name>, so a collection called New wrote data-new and a codebase already using data-color-scheme could not be matched. A collection can now name its attribute in the inspector, validated so a stylesheet can select it as is. The stylesheet and exported code use it, setting it is undoable, and .fig files keep it in the collection's plugin data. * fix: show the switch attribute only where there are modes to switch * fix: return to the list after committing the switch attribute * fix: keep a collection's switch attribute when a new one is refused setModeAttribute cleared the attribute when given a name a stylesheet cannot select on; it now leaves the current one, and only an empty name restores the default. In the inspector, Enter on a refused name keeps the focus so it can be corrected. * docs: describe the switch attribute in the mode conditions The Switched manually row still said the attribute is named after the collection. The changelog had collected four copies of the variables dialog entry through rebases; one remains, with the switch attribute in it.		2026-10-06 12:35:41 +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	feat: let a collection name the attribute its modes switch by (#913 )	2026-10-06 12:35:41 +00:00
tests	fix(fig): write text glyphs from the layout the renderer draws (#928 )	2026-10-06 11:37:02 +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