figmatk 0.0.17 → 0.0.19

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -13,7 +13,7 @@
13
13
  {
14
14
  "name": "figmatk",
15
15
  "description": "Swiss Army Knife for Figma Files (.deck)",
16
- "version": "0.0.17",
16
+ "version": "0.0.19",
17
17
  "author": {
18
18
  "name": "FigmaTK Contributors"
19
19
  },
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "figmatk",
3
- "version": "0.0.17",
3
+ "version": "0.0.19",
4
4
  "description": "Create and edit Figma Slides .deck files programmatically — no Figma API required",
5
5
  "author": {
6
6
  "name": "FigmaTK Contributors"
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "figmatk",
3
- "version": "0.0.17",
3
+ "version": "0.0.19",
4
4
  "description": "Figma Toolkit — Swiss-army knife CLI for Figma .deck and .fig files",
5
5
  "type": "module",
6
6
  "bin": {
@@ -6,7 +6,7 @@ description: >
6
6
  clone or remove slides, or produce a .deck file for Figma Slides.
7
7
  Powered by FigmaTK under the hood.
8
8
  metadata:
9
- version: "0.0.17"
9
+ version: "0.0.19"
10
10
  ---
11
11
 
12
12
  # Figma Slides Creator
@@ -30,6 +30,12 @@ To let the user view the result: tell them to **open the file in Figma Desktop**
30
30
 
31
31
  ---
32
32
 
33
+ ## File locations — always use /tmp
34
+
35
+ **All files go in `/tmp/`** — scripts, output decks, images, everything. Never write to the Desktop, Documents, Downloads, or any user directory. Never create intermediate notes or reference markdown files. Just build and save the deck.
36
+
37
+ ---
38
+
33
39
  ## Path A — Create from Scratch (High-Level API)
34
40
 
35
41
  Use this when the user wants a new presentation. Follow these steps **in order, every time, no exceptions**.
@@ -94,6 +100,7 @@ If this fails, check the error and fix the script — **do not change the worksp
94
100
  | Shape fill color | `{ fill: '#F4900C' }` | `{ fill: hex('#F4900C') }` — use the hex() helper |
95
101
  | `addLine` options | `{ strokeColor: ..., strokeWeight: 2 }` | `{ color: 'Black', weight: 2 }` |
96
102
  | `align` value | `align: 'left'` | `align: 'LEFT'` (uppercase) |
103
+ | `addImage` without await | `slide.addImage(...)` | `await slide.addImage(...)` — async, images silently missing without await |
97
104
 
98
105
  ### Hex color helper (for shape fills)
99
106
 
@@ -145,7 +152,7 @@ slide.addDiamond(x, y, width, height, opts)
145
152
  slide.addTriangle(x, y, width, height, opts)
146
153
  slide.addStar(x, y, width, height, opts)
147
154
  slide.addLine(x1, y1, x2, y2, opts) // opts: color, weight
148
- slide.addImage(x, y, width, height, pathOrBuf, opts) // opts: cornerRadius, opacity
155
+ await slide.addImage(x, y, width, height, pathOrBuf, opts) // ⚠️ ASYNC — must use await, opts: cornerRadius, opacity
149
156
  slide.addTable(data, opts) // 2D string array; opts: x, y, width, colWidths, rowHeight
150
157
  slide.addSVG(x, y, width, svgPathOrBuf, opts)
151
158
  ```