figmatk 0.3.0 → 0.3.1

package/.claude-plugin/marketplace.json

@@ -13,7 +13,7 @@
     {
       "name": "figmatk",
       "description": "Swiss Army Knife for Figma Files (.deck)",
-      "version": "0.3.0",
+      "version": "0.3.1",
       "author": {
         "name": "FigmaTK Contributors"
       },

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "figmatk",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Create and edit Figma Slides .deck files programmatically — no Figma API required",
   "author": {
     "name": "FigmaTK Contributors"

package/README.md

@@ -67,7 +67,23 @@ Or add manually in Claude Desktop → Settings → Developer → Edit Config:
 }
 ```
 
-Available MCP tools: `figmatk_create_deck`, `figmatk_inspect`, `figmatk_list_text`, `figmatk_list_overrides`, `figmatk_update_text`, `figmatk_insert_image`, `figmatk_clone_slide`, `figmatk_remove_slide`, `figmatk_roundtrip`.
+Available MCP tools: `figmatk_create_deck`, `figmatk_create_template_draft`, `figmatk_annotate_template_layout`, `figmatk_publish_template_draft`, `figmatk_list_template_layouts`, `figmatk_create_from_template`, `figmatk_inspect`, `figmatk_list_text`, `figmatk_list_overrides`, `figmatk_update_text`, `figmatk_insert_image`, `figmatk_clone_slide`, `figmatk_remove_slide`, `figmatk_roundtrip`.
+
+## Template Workflows
+
+FigmaTK supports two related template states:
+
+- Draft templates: `SLIDE_ROW -> SLIDE -> ...`
+- Published templates: `SLIDE_ROW -> MODULE -> SLIDE -> ...`
+
+Use explicit naming conventions when authoring reusable templates:
+
+- Layouts: `layout:<name>`
+- Text slots: `slot:text:<name>`
+- Image slots: `slot:image:<name>`
+- Decorative fixed imagery: `fixed:image:<name>`
+
+`figmatk_list_template_layouts` understands those conventions and only falls back to heuristic image placeholders when a layout has not been explicitly annotated yet.
 
 ## Programmatic API
 
@@ -84,6 +100,7 @@ await deck.save('output.deck');
 |------|---|
 | High-level API | [docs/figmatk-api-spec.md](docs/figmatk-api-spec.md) |
 | Low-level FigDeck API | [docs/library.md](docs/library.md) |
+| Template workflows | [docs/template-workflows.md](docs/template-workflows.md) |
 | File format internals | [docs/format/](docs/format/) |
 
 ## License

package/lib/fig-deck.mjs

@@ -14,9 +14,10 @@ import { decompress } from 'fzstd';
 import { inflateRaw, deflateRaw } from 'pako';
 import { ZstdCodec } from 'zstd-codec';
 import archiver from 'archiver';
-import { readFileSync, createWriteStream, existsSync, mkdirSync, cpSync } from 'fs';
+import { readFileSync, createWriteStream, existsSync, mkdtempSync } from 'fs';
 import { execSync } from 'child_process';
 import { join, resolve } from 'path';
+import { tmpdir } from 'os';
 import { nid } from './node-helpers.mjs';
 
 export class FigDeck {
@@ -42,9 +43,8 @@ export class FigDeck {
     const absPath = resolve(deckPath);
 
     // Extract to temp dir
-    const tmp = `/tmp/figmatk_${Date.now()}`;
-    execSync(`rm -rf ${tmp} && mkdir -p ${tmp}`);
-    execSync(`unzip -o "${absPath}" -d ${tmp}`, { stdio: 'pipe' });
+    const tmp = mkdtempSync(join(tmpdir(), 'figmatk_'));
+    execSync(`unzip -o "${absPath}" -d "${tmp}"`, { stdio: 'pipe' });
     deck._tempDir = tmp;
 
     // Read canvas.fig