docs: close Fig package boundary track

- Describe complete Fig archive, conversion, instance, and metadata ownership\n- Refresh contributor paths across localized development guides\n- Mark Track D complete in the local master plan
2026-07-18 03:41:17 +03:00 · 2026-07-18 03:41:17 +03:00 · 8ceda4d12f
parent 8b9be17a56
commit 8ceda4d12f
9 changed files with 37 additions and 37 deletions
--- a/README.md
+++ b/README.md
@ -266,7 +266,7 @@ packages/
  scene-graph/    @open-pencil/scene-graph — nodes, primitives, hit testing, copy/snap/undo
  pen/            @open-pencil/pen — Pencil document format helpers
  kiwi/           @open-pencil/kiwi — Kiwi runtime and low-level .fig container parsing
-  fig/            @open-pencil/fig — focused .fig package entrypoint
+  fig/            @open-pencil/fig — .fig archives, SceneGraph conversion, instances, metadata
  core/           @open-pencil/core — editor engine, renderer, layout, tools, RPC, document I/O
  dom-css/        @open-pencil/dom-css — HTML/CSS/Tailwind to editable design documents
  vue/            @open-pencil/vue — headless Vue SDK
--- a/packages/docs/de/development/contributing.md
+++ b/packages/docs/de/development/contributing.md
@ -73,14 +73,14 @@ Der Core-Engine-Quellcode lebt in `packages/core/src/`. App-spezifischer Editor-

 | Datei | Zweck |
 |-------|-------|
-| `packages/core/src/scene-graph/` | Szenengraph: Knoten, Variablen, Instanzen, Hit-Testing |
+| `packages/scene-graph/src/` | Szenengraph: Knoten, Variablen, Instanzen, Hit-Testing und Undo |
 | `packages/core/src/canvas/renderer.ts` | CanvasKit-Rendering-Pipeline |
-| `packages/core/src/layout.ts` | Yoga-Layout-Adapter |
-| `packages/core/src/scene-graph/undo.ts` | Rückgängig/Wiederherstellen-Manager |
+| `packages/core/src/layout/` | Yoga-Layout-Adapter |
 | `packages/core/src/clipboard.ts` | Figma-kompatible Zwischenablage |
 | `packages/core/src/vector/` | Vektornetzwerk-Modell |
-| `packages/core/src/kiwi/binary/codec.ts` | Kiwi-Binär-Encoder/Decoder |
-| `packages/core/src/kiwi/fig-import.ts` | .fig-Datei-Import-Logik |
+| `packages/kiwi/src/schema-runtime/` | Kiwi-Schema-Runtime und Binär-Codec |
+| `packages/fig/src/node-change/` | SceneGraph- und Figma-NodeChange-Konvertierung |
+| `packages/core/src/io/formats/fig/` | App-seitige .fig-Lese-/Schreiborchestrierung |
 | `packages/core/src/tools/` | Vereinheitlichte Werkzeugdefinitionen (KI, MCP, CLI) |
 | `packages/core/src/figma-api/` | Figma Plugin API-Implementierung |
 | `packages/mcp/src/server.ts` | MCP-Server-Factory |
--- a/packages/docs/development/contributing.md
+++ b/packages/docs/development/contributing.md
@ -91,15 +91,15 @@ Core engine source lives in `packages/core/src/`. App-specific editor, document,

 | File | Purpose |
 |------|---------|
-| `packages/core/src/scene-graph/` | Scene graph: nodes, variables, instances, hit testing |
+| `packages/scene-graph/src/` | Scene graph: nodes, variables, instances, hit testing, undo |
 | `packages/core/src/canvas/renderer.ts` | CanvasKit rendering pipeline |
-| `packages/core/src/layout.ts` | Yoga layout adapter |
-| `packages/core/src/scene-graph/undo.ts` | Undo/redo manager |
+| `packages/core/src/layout/` | Yoga layout adapter |
 | `packages/core/src/clipboard.ts` | Figma-compatible clipboard |
 | `packages/core/src/vector/` | Vector network model |
 | `packages/core/src/io/formats/raster/render.ts` | Offscreen image export (PNG/JPG/WEBP) |
-| `packages/core/src/kiwi/binary/codec.ts` | Kiwi binary encoder/decoder |
-| `packages/core/src/kiwi/fig-import.ts` | .fig file import logic |
+| `packages/kiwi/src/schema-runtime/` | Kiwi schema runtime and binary codec |
+| `packages/fig/src/node-change/` | SceneGraph and Figma NodeChange conversion policy |
+| `packages/core/src/io/formats/fig/` | App-facing .fig read/write orchestration |
 | `packages/cli/src/index.ts` | CLI entry point |
 | `packages/core/src/tools/` | Unified tool definitions split by domain (read, create, modify, structure, variables, vector, analyze) |
 | `packages/core/src/figma-api/` | Figma Plugin API implementation |
--- a/packages/docs/development/roadmap.md
+++ b/packages/docs/development/roadmap.md
@ -234,7 +234,7 @@ These are parsed or visible in Figma docs and most likely to cause visible diffe
 | Strokes                      | `packages/core/src/canvas/strokes.ts`                                                                          |
 | Effects / shadows            | `packages/core/src/canvas/shadows.ts`                                                                          |
 | Text rendering               | `packages/core/src/canvas/text.ts`, `packages/core/src/canvas/text-derived.ts`                                 |
-| Layout engine                | `packages/core/src/layout.ts`, `packages/core/src/layout/**`                                                   |
+| Layout engine                | `packages/core/src/layout/**`                                                   |
 | Property panels              | `src/components/properties/**`, `packages/vue/src/controls/**`                                                 |
 | CLI                          | `packages/cli/src/index.ts`, `packages/cli/src/commands/**`                                                    |
 | MCP/tools                    | `packages/core/src/tools/**`, `packages/mcp/src/tool/registration.ts`                                          |
--- a/packages/docs/es/development/contributing.md
+++ b/packages/docs/es/development/contributing.md
@ -76,15 +76,15 @@ El código fuente del motor core vive en `packages/core/src/`. El código espec

 | Archivo | Propósito |
 |---------|-----------|
-| `packages/core/src/scene-graph/` | Grafo de escena: nodos, variables, instancias, hit testing |
+| `packages/scene-graph/src/` | Grafo de escena: nodos, variables, instancias, hit testing y deshacer |
 | `packages/core/src/canvas/renderer.ts` | Pipeline de renderizado CanvasKit |
-| `packages/core/src/layout.ts` | Adaptador de layout Yoga |
-| `packages/core/src/scene-graph/undo.ts` | Gestor de deshacer/rehacer |
+| `packages/core/src/layout/` | Adaptador de layout Yoga |
 | `packages/core/src/clipboard.ts` | Portapapeles compatible con Figma |
 | `packages/core/src/vector/` | Modelo de red vectorial |
 | `packages/core/src/io/formats/raster/render.ts` | Exportación de imagen offscreen (PNG/JPG/WEBP) |
-| `packages/core/src/kiwi/binary/codec.ts` | Codificador/decodificador binario Kiwi |
-| `packages/core/src/kiwi/fig-import.ts` | Lógica de importación de archivos .fig |
+| `packages/kiwi/src/schema-runtime/` | Runtime de esquema y códec binario Kiwi |
+| `packages/fig/src/node-change/` | Política de conversión entre SceneGraph y Figma NodeChange |
+| `packages/core/src/io/formats/fig/` | Orquestación de lectura/escritura .fig para la app |
 | `packages/cli/src/index.ts` | Punto de entrada del CLI |
 | `packages/core/src/tools/` | Definiciones unificadas de herramientas (IA, MCP, CLI) |
 | `packages/core/src/figma-api/` | Implementación de Figma Plugin API |
--- a/packages/docs/fr/development/contributing.md
+++ b/packages/docs/fr/development/contributing.md
@ -76,15 +76,15 @@ Le code source du moteur core se trouve dans `packages/core/src/`. Le code propr

 | Fichier | Objectif |
 |---------|----------|
-| `packages/core/src/scene-graph/` | Graphe de scène : nœuds, variables, instances, hit testing |
+| `packages/scene-graph/src/` | Graphe de scène : nœuds, variables, instances, hit testing et annulation |
 | `packages/core/src/canvas/renderer.ts` | Pipeline de rendu CanvasKit |
-| `packages/core/src/layout.ts` | Adaptateur layout Yoga |
-| `packages/core/src/scene-graph/undo.ts` | Gestionnaire annuler/rétablir |
+| `packages/core/src/layout/` | Adaptateur layout Yoga |
 | `packages/core/src/clipboard.ts` | Presse-papiers compatible Figma |
 | `packages/core/src/vector/` | Modèle de réseau vectoriel |
 | `packages/core/src/io/formats/raster/render.ts` | Export d'image hors-écran (PNG/JPG/WEBP) |
-| `packages/core/src/kiwi/binary/codec.ts` | Encodeur/décodeur binaire Kiwi |
-| `packages/core/src/kiwi/fig-import.ts` | Logique d'import de fichiers .fig |
+| `packages/kiwi/src/schema-runtime/` | Runtime de schéma et codec binaire Kiwi |
+| `packages/fig/src/node-change/` | Conversion entre SceneGraph et Figma NodeChange |
+| `packages/core/src/io/formats/fig/` | Orchestration de lecture/écriture .fig pour l'application |
 | `packages/cli/src/index.ts` | Point d'entrée du CLI |
 | `packages/core/src/tools/` | Définitions d'outils unifiées (IA, MCP, CLI) |
 | `packages/core/src/figma-api/` | Implémentation de Figma Plugin API |
--- a/packages/docs/it/development/contributing.md
+++ b/packages/docs/it/development/contributing.md
@ -76,15 +76,15 @@ Il codice sorgente del motore core si trova in `packages/core/src/`. Il codice s

 | File | Scopo |
 |------|-------|
-| `packages/core/src/scene-graph/` | Grafo scena: nodi, variabili, istanze, hit testing |
+| `packages/scene-graph/src/` | Grafo scena: nodi, variabili, istanze, hit testing e annullamento |
 | `packages/core/src/canvas/renderer.ts` | Pipeline di rendering CanvasKit |
-| `packages/core/src/layout.ts` | Adattatore layout Yoga |
-| `packages/core/src/scene-graph/undo.ts` | Gestore annulla/ripristina |
+| `packages/core/src/layout/` | Adattatore layout Yoga |
 | `packages/core/src/clipboard.ts` | Appunti compatibili con Figma |
 | `packages/core/src/vector/` | Modello rete vettoriale |
 | `packages/core/src/io/formats/raster/render.ts` | Export immagine offscreen (PNG/JPG/WEBP) |
-| `packages/core/src/kiwi/binary/codec.ts` | Encoder/decoder binario Kiwi |
-| `packages/core/src/kiwi/fig-import.ts` | Logica import file .fig |
+| `packages/kiwi/src/schema-runtime/` | Runtime dello schema e codec binario Kiwi |
+| `packages/fig/src/node-change/` | Conversione tra SceneGraph e Figma NodeChange |
+| `packages/core/src/io/formats/fig/` | Orchestrazione lettura/scrittura .fig per l'app |
 | `packages/cli/src/index.ts` | Punto di ingresso CLI |
 | `packages/core/src/tools/` | Definizioni strumenti unificate (IA, MCP, CLI) |
 | `packages/core/src/figma-api/` | Implementazione Figma Plugin API |
--- a/packages/docs/pl/development/contributing.md
+++ b/packages/docs/pl/development/contributing.md
@ -76,15 +76,15 @@ Kod źródłowy silnika core znajduje się w `packages/core/src/`. Kod aplikacyj

 | Plik | Cel |
 |------|-----|
-| `packages/core/src/scene-graph/` | Graf sceny: węzły, zmienne, instancje, hit testing |
+| `packages/scene-graph/src/` | Graf sceny: węzły, zmienne, instancje, hit testing i cofanie |
 | `packages/core/src/canvas/renderer.ts` | Pipeline renderowania CanvasKit |
-| `packages/core/src/layout.ts` | Adapter layoutu Yoga |
-| `packages/core/src/scene-graph/undo.ts` | Menedżer cofnij/ponów |
+| `packages/core/src/layout/` | Adapter layoutu Yoga |
 | `packages/core/src/clipboard.ts` | Schowek kompatybilny z Figmą |
 | `packages/core/src/vector/` | Model sieci wektorowej |
 | `packages/core/src/io/formats/raster/render.ts` | Eksport obrazu offscreen (PNG/JPG/WEBP) |
-| `packages/core/src/kiwi/binary/codec.ts` | Koder/dekoder binarny Kiwi |
-| `packages/core/src/kiwi/fig-import.ts` | Logika importu plików .fig |
+| `packages/kiwi/src/schema-runtime/` | Runtime schematu i kodek binarny Kiwi |
+| `packages/fig/src/node-change/` | Konwersja między SceneGraph i Figma NodeChange |
+| `packages/core/src/io/formats/fig/` | Orkiestracja odczytu/zapisu .fig dla aplikacji |
 | `packages/cli/src/index.ts` | Punkt wejścia CLI |
 | `packages/core/src/tools/` | Ujednolicone definicje narzędzi (AI, MCP, CLI) |
 | `packages/core/src/figma-api/` | Implementacja Figma Plugin API |
--- a/packages/docs/ru/development/contributing.md
+++ b/packages/docs/ru/development/contributing.md
@ -76,15 +76,15 @@ bun run check

 | Файл | Назначение |
 |------|------------|
-| `packages/core/src/scene-graph/` | Граф сцены: узлы, переменные, экземпляры, проверка попадания |
+| `packages/scene-graph/src/` | Граф сцены: узлы, переменные, экземпляры, проверка попадания и отмена |
 | `packages/core/src/canvas/renderer.ts` | Конвейер отрисовки CanvasKit |
-| `packages/core/src/layout.ts` | Адаптер компоновки Yoga |
-| `packages/core/src/scene-graph/undo.ts` | Менеджер отмены/повтора |
+| `packages/core/src/layout/` | Адаптер компоновки Yoga |
 | `packages/core/src/clipboard.ts` | Figma-совместимый буфер обмена |
 | `packages/core/src/vector/` | Модель векторных сетей |
 | `packages/core/src/io/formats/raster/render.ts` | Внеэкранный экспорт изображений (PNG/JPG/WEBP) |
-| `packages/core/src/kiwi/binary/codec.ts` | Бинарный кодировщик/декодировщик Kiwi |
-| `packages/core/src/kiwi/fig-import.ts` | Логика импорта .fig файлов |
+| `packages/kiwi/src/schema-runtime/` | Среда схемы и бинарный кодек Kiwi |
+| `packages/fig/src/node-change/` | Преобразование SceneGraph и Figma NodeChange |
+| `packages/core/src/io/formats/fig/` | Оркестрация чтения и записи .fig для приложения |
 | `packages/cli/src/index.ts` | Точка входа CLI |
 | `packages/core/src/tools/` | Унифицированные определения инструментов по доменам (read, create, modify, structure, variables, vector, analyze) |
 | `packages/core/src/figma-api/` | Реализация Figma Plugin API |