figmatk 0.0.12 → 0.0.14

package/.claude-plugin/marketplace.json

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

package/.claude-plugin/plugin.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "figmatk",
-  "version": "0.0.12",
+  "version": "0.0.14",
   "description": "Figma Toolkit — Swiss-army knife CLI for Figma .deck and .fig files",
   "type": "module",
   "bin": {

package/skills/figma-slides-creator/SKILL.md

@@ -6,7 +6,7 @@ description: >
   clone or remove slides, or produce a .deck file for Figma Slides.
   Powered by FigmaTK under the hood.
 metadata:
-  version: "0.0.12"
+  version: "0.0.14"
 ---
 
 # FigmaTK Skill
@@ -32,30 +32,36 @@ To let the user view the result: tell them to **open the file in Figma Desktop**
 
 ## Path A — Create from Scratch (High-Level API)
 
-Use this when the user wants a new presentation. Write a Node.js script and execute it.
+Use this when the user wants a new presentation. Follow these steps **in order, every time, no exceptions**.
 
-### Setup (required before running any script)
+### Step 1 — Set up workspace (MANDATORY FIRST STEP — never skip)
 
-The plugin cache does not include `node_modules`. Always install figmatk into a local workspace first:
+The environment has no `node_modules`. **Before writing any script**, run this exact command:
 
 ```bash
 mkdir -p /tmp/figmatk-ws && cd /tmp/figmatk-ws && npm init -y && npm install figmatk
 ```
 
-Then write your script inside `/tmp/figmatk-ws/` and run it from there:
+Do not proceed to Step 2 until this command succeeds.
 
-```bash
-node /tmp/figmatk-ws/my-deck.mjs
-```
+### Step 2 — Write the script to `/tmp/figmatk-ws/deck.mjs`
 
-> **Import:** always use the bare specifier `import { Deck } from 'figmatk'` — Node will resolve it from the local `node_modules` in the workspace.
+**Always write the script to `/tmp/figmatk-ws/deck.mjs`** — not to the current directory, not to any other path.
+
+**Always use the bare specifier** `import { Deck } from 'figmatk'` — never a file path import.
 
 ```javascript
 import { Deck } from 'figmatk';
 
+function hex(h) {
+  return { r: parseInt(h.slice(1,3),16)/255, g: parseInt(h.slice(3,5),16)/255, b: parseInt(h.slice(5,7),16)/255 };
+}
+
 const deck = await Deck.create('My Presentation');
 
-const slide = deck.addBlankSlide();          // template blank slide auto-removed
+// Each call to addBlankSlide() returns a new blank slide.
+// The template blank slide is auto-removed on the first call.
+const slide = deck.addBlankSlide();
 slide.setBackground('Black');                // named color — see list below
 slide.addText('Slide Title', {
   style: 'Title', color: 'White',
@@ -66,9 +72,18 @@ slide.addText('Subtitle', {
   x: 64, y: 240, width: 1200, align: 'LEFT'
 });
 
-await deck.save('/path/to/output.deck');
+await deck.save('/tmp/my-presentation.deck');
+console.log('Done — open /tmp/my-presentation.deck in Figma Desktop');
 ```
 
+### Step 3 — Run the script
+
+```bash
+node /tmp/figmatk-ws/deck.mjs
+```
+
+If this fails, check the error and fix the script — **do not change the workspace setup or the import path**.
+
 ### ⚠️ Critical gotchas
 
 | Issue | Wrong | Right |
@@ -102,13 +117,17 @@ function hex(h) {
 | `Body 3` | 24pt | Regular | Captions, labels |
 | `Note` | 20pt | Regular | Footnotes, sources |
 
-### Named colors for `setBackground()`
+### Colors for `setBackground()`
+
+Accepts named colors, hex strings, or designer aliases — **when using figmatk 0.0.12+ from the workspace install**.
 
-> **Case-sensitive.** `'Black'` works, `'black'` does not.
+**Named colors** (case-sensitive, from the Light Slides theme):
 
 `'Black'`, `'White'`, `'Grey'`, `'Blue'`, `'Red'`, `'Yellow'`, `'Green'`, `'Orange'`, `'Pink'`, `'Purple'`, `'Teal'`, `'Violet'`, `'Persimmon'`, `'Pale Pink'`, `'Pale Blue'`, `'Pale Green'`, `'Pale Teal'`, `'Pale Purple'`, `'Pale Persimmon'`, `'Pale Violet'`, `'Pale Red'`, `'Pale Yellow'`
 
-Use `'Black'` for dark backgrounds, `'White'` for light. For custom slide backgrounds, use the closest named color — **not hex**.
+**Hex strings** (0.0.12+): `slide.setBackground('#C8102E')`
+
+**Designer aliases** (0.0.12+): `slide.setBackground('navy')`, `slide.setBackground('coral')`, `slide.setBackground('terracotta')` etc.
 
 ### Slide dimensions