@pixerate/editor 0.222.0 → 0.222.2

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.
Files changed (31) hide show
  1. package/package.json +1 -1
  2. package/skills/README.md +11 -3
  3. package/skills/pixerate-paint-editor/SKILL.md +20 -59
  4. package/skills/pixerate-paint-editor/references/oils.md +19 -0
  5. package/skills/pixerate-paint-editor/references/wet-media.md +35 -0
  6. package/skills/pixerate-paint-oil-impasto/SKILL.md +103 -0
  7. package/skills/pixerate-paint-oil-impasto/evals/impasto-highlights.json +24 -0
  8. package/skills/pixerate-paint-oil-impasto/evals/lean-to-thick.json +17 -0
  9. package/skills/pixerate-paint-oil-impasto/evals/mix-green.json +15 -0
  10. package/skills/pixerate-paint-sketch-to-finish/SKILL.md +97 -0
  11. package/skills/pixerate-paint-sketch-to-finish/evals/clipped-shading.json +26 -0
  12. package/skills/pixerate-paint-sketch-to-finish/evals/flats-under-ink.json +27 -0
  13. package/skills/pixerate-paint-sketch-to-finish/evals/sketch-ink-hide.json +20 -0
  14. package/skills/pixerate-paint-watercolour/SKILL.md +106 -0
  15. package/skills/pixerate-paint-watercolour/evals/glaze-over-dry.json +24 -0
  16. package/skills/pixerate-paint-watercolour/evals/paper-and-brush-for-detail.json +16 -0
  17. package/skills/pixerate-paint-watercolour/evals/sky-wash.json +19 -0
  18. package/skills/pixerate-vector/SKILL.md +11 -61
  19. package/skills/pixerate-vector/references/best-practices.md +62 -0
  20. package/skills/pixerate-vector-icon-set/SKILL.md +111 -0
  21. package/skills/pixerate-vector-icon-set/evals/consistent-strokes.json +22 -0
  22. package/skills/pixerate-vector-icon-set/evals/plus-icon.json +15 -0
  23. package/skills/pixerate-vector-icon-set/evals/repeats-as-symbol.json +192 -0
  24. package/skills/pixerate-vector-illustration/SKILL.md +112 -0
  25. package/skills/pixerate-vector-illustration/evals/clip-stripes.json +21 -0
  26. package/skills/pixerate-vector-illustration/evals/radial-sun.json +16 -0
  27. package/skills/pixerate-vector-illustration/evals/subtle-shadow.json +16 -0
  28. package/skills/pixerate-vector-logo/SKILL.md +107 -0
  29. package/skills/pixerate-vector-logo/evals/centre-lockup.json +20 -0
  30. package/skills/pixerate-vector-logo/evals/knockout-ring.json +21 -0
  31. package/skills/pixerate-vector-logo/evals/live-union.json +19 -0
@@ -0,0 +1,192 @@
1
+ {
2
+ "prompt": "The three stars are copies of the same rating icon. Make them one reusable symbol, so that editing it once updates all three, and keep them where they are.",
3
+ "fixture": {
4
+ "editor": "vector",
5
+ "width": 72,
6
+ "height": 24,
7
+ "setup": [
8
+ {
9
+ "id": "vector.addShape",
10
+ "params": {
11
+ "kind": "star",
12
+ "x": 2,
13
+ "y": 2,
14
+ "width": 20,
15
+ "height": 20,
16
+ "name": "Star",
17
+ "fill": "#f5b301",
18
+ "stroke": null
19
+ }
20
+ },
21
+ {
22
+ "id": "vector.addShape",
23
+ "params": {
24
+ "kind": "star",
25
+ "x": 26,
26
+ "y": 2,
27
+ "width": 20,
28
+ "height": 20,
29
+ "name": "Star",
30
+ "fill": "#f5b301",
31
+ "stroke": null
32
+ }
33
+ },
34
+ {
35
+ "id": "vector.addShape",
36
+ "params": {
37
+ "kind": "star",
38
+ "x": 50,
39
+ "y": 2,
40
+ "width": 20,
41
+ "height": 20,
42
+ "name": "Star",
43
+ "fill": "#f5b301",
44
+ "stroke": null
45
+ }
46
+ }
47
+ ]
48
+ },
49
+ "checks": [
50
+ {
51
+ "why": "one symbol",
52
+ "tool": "run_command",
53
+ "args": {
54
+ "id": "vector.listSymbols"
55
+ },
56
+ "expect": {
57
+ "result": {
58
+ "symbols": {
59
+ "$length": 1
60
+ }
61
+ }
62
+ }
63
+ },
64
+ {
65
+ "why": "three instances of it and no loose copies",
66
+ "tool": "run_command",
67
+ "args": {
68
+ "id": "vector.list"
69
+ },
70
+ "expect": {
71
+ "result": {
72
+ "nodes": {
73
+ "$length": 3,
74
+ "$every": {
75
+ "type": "instance"
76
+ }
77
+ }
78
+ }
79
+ }
80
+ },
81
+ {
82
+ "why": "in their original places",
83
+ "tool": "run_command",
84
+ "args": {
85
+ "id": "vector.list"
86
+ },
87
+ "expect": {
88
+ "result": {
89
+ "nodes": {
90
+ "$expr": "[2, 26, 50].every((x) => v.some((n) => Math.abs(n.bounds.x + n.bounds.width / 2 - (x + 10)) <= 0.5))"
91
+ }
92
+ }
93
+ }
94
+ }
95
+ ],
96
+ "solution": [
97
+ {
98
+ "tool": "run_command",
99
+ "args": {
100
+ "id": "vector.list"
101
+ }
102
+ },
103
+ {
104
+ "tool": "run_command",
105
+ "args": {
106
+ "id": "vector.makeSymbol",
107
+ "params": {
108
+ "ids": [
109
+ {
110
+ "$read": "run_command",
111
+ "args": {
112
+ "id": "vector.list"
113
+ },
114
+ "path": "result.nodes.0.id"
115
+ }
116
+ ],
117
+ "name": "Rating star"
118
+ }
119
+ }
120
+ },
121
+ {
122
+ "tool": "run_command",
123
+ "args": {
124
+ "id": "vector.delete",
125
+ "params": {
126
+ "ids": [
127
+ {
128
+ "$read": "run_command",
129
+ "args": {
130
+ "id": "vector.list"
131
+ },
132
+ "path": "result.nodes.1.id"
133
+ },
134
+ {
135
+ "$read": "run_command",
136
+ "args": {
137
+ "id": "vector.list"
138
+ },
139
+ "path": "result.nodes.2.id"
140
+ }
141
+ ]
142
+ }
143
+ }
144
+ },
145
+ {
146
+ "tool": "run_command",
147
+ "args": {
148
+ "id": "vector.placeSymbol",
149
+ "params": {
150
+ "symbolId": {
151
+ "$read": "run_command",
152
+ "args": {
153
+ "id": "vector.listSymbols"
154
+ },
155
+ "path": "result.symbols.0.id"
156
+ },
157
+ "x": 36,
158
+ "y": {
159
+ "$read": "run_command",
160
+ "args": {
161
+ "id": "vector.list"
162
+ },
163
+ "path": "result.nodes.0.transform.5"
164
+ }
165
+ }
166
+ }
167
+ },
168
+ {
169
+ "tool": "run_command",
170
+ "args": {
171
+ "id": "vector.placeSymbol",
172
+ "params": {
173
+ "symbolId": {
174
+ "$read": "run_command",
175
+ "args": {
176
+ "id": "vector.listSymbols"
177
+ },
178
+ "path": "result.symbols.0.id"
179
+ },
180
+ "x": 60,
181
+ "y": {
182
+ "$read": "run_command",
183
+ "args": {
184
+ "id": "vector.list"
185
+ },
186
+ "path": "result.nodes.0.transform.5"
187
+ }
188
+ }
189
+ }
190
+ }
191
+ ]
192
+ }
@@ -0,0 +1,112 @@
1
+ ---
2
+ name: pixerate-vector-illustration
3
+ description: The illustration workflow in the Pixerate vector editor - blocking in shapes back to front, grouping and naming parts, colour from a small palette, gradients (linear, radial, mesh and freeform) with even interpolation, stacked fills and strokes instead of duplicate shapes, clipping and opacity masks, blends, subtle shadows and glows with one light direction, and preparing artboards for export. Use when asked to draw, illustrate or paint a scene, character, object, spot illustration, poster or background in vector, add shading, gradients, highlights, shadows or texture, show art inside a shape, or when vector.setGradient, vector.addFill, vector.makeClippingMask, vector.addFilter or vector.blend are available. Load with pixerate-vector, which lists every command.
4
+ metadata:
5
+ kind: workflow
6
+ reference: pixerate-vector
7
+ ---
8
+
9
+ # Making an illustration
10
+
11
+ An illustration is built like a painting: big shapes first, back to front, then form (light and
12
+ shade), then detail, then finish. In vector, every stage should stay editable: shading lives in
13
+ gradients and stacked fills rather than extra shapes, art shown inside a shape lives in masks,
14
+ and effects stay live until the file is delivered.
15
+
16
+ This skill is the method. `pixerate-vector` has the full command reference; run the commands
17
+ with `run_command`, or several as one undo step with `run_commands` and `atomic: true`.
18
+
19
+ ## Goal and quality bar
20
+
21
+ - A clear structure: parts grouped and named ("Sky", "Hill far", "Tree 1"), stacked back to
22
+ front, the tree shallow.
23
+ - A small palette (5-8 colours plus tints), used consistently; gradients two to four stops.
24
+ - One light direction for every highlight, shade and shadow.
25
+ - Non-destructive: gradients, appearance stacks, masks, blends and filters are live; shapes are
26
+ not duplicated to fake shading.
27
+ - Shadows and glows subtle: drop shadows black at 0.15-0.3 opacity, offset 2-8 units straight
28
+ away from the light, blur about twice the offset.
29
+
30
+ ## Inputs to confirm
31
+
32
+ - **Subject and format:** what to draw, the artboard size or ratio.
33
+ - **Style:** flat (solid fills), soft (gradients), or textured; outlined or not.
34
+ - **Palette:** brand colours or free; the light direction if it matters.
35
+
36
+ ## Working method
37
+
38
+ 1. **Read and plan.** `vector.list` for the artboard and what exists. Plan the layers from back to
39
+ front (sky, far, middle, near, foreground details) and the palette.
40
+ 2. **Block in.** Big shapes with `vector.addShape` and `vector.addPath`, flat colours, one
41
+ `run_commands` per group with `atomic: true`; `vector.group` each object with a `name`.
42
+ **Check:** `vector.list` order is back to front; names say what each group is.
43
+ 3. **Form.** Shade with gradients rather than extra shapes: `vector.setStyle` `fill` with a
44
+ `linear` or `radial` gradient (`interpolation: "oklab"` for clean blends between saturated
45
+ colours), `vector.setGradient` to place it, `vector.setMeshGradient` or
46
+ `vector.setFreeformGradient` for organic shading. For a highlight or a texture over a fill,
47
+ `vector.addFill` on the same path with its own `opacity` and `blendMode` (screen to lighten,
48
+ multiply to darken).
49
+ **Check:** `vector.getAppearance` shows the stack; the shape count did not grow.
50
+ 4. **Masks for art inside shapes.** Put the shape that frames the art on top and
51
+ `vector.makeClippingMask` with the art below it (a pattern in a window, a scene in a circle);
52
+ `vector.makeOpacityMask` with a white-to-black gradient for fades and reflections.
53
+ **Check:** `vector.list` shows the mask group's `mask` with the right `contents`.
54
+ 5. **Transitions and repeats.** `vector.blend` between two shapes for smooth steps (a sunset of
55
+ bands, a row of fading circles); symbols for repeated objects (trees, stars).
56
+ 6. **Shadows and glows.** `vector.addFilter` `dropShadow` (`offsetX` 0 and `offsetY` positive for
57
+ light from above), `outerGlow` for light sources, `layerBlur` for depth of field.
58
+ **Check:** `vector.list` `filters` show one light direction across the design.
59
+ 7. **Finish and export.** Review the stack, then `vector.exportSvg` (or `vector.exportFrameSvg`
60
+ per artboard). Expand live effects (`vector.expandAppearance`, `vector.expandBlend`) only for
61
+ targets that need plain SVG.
62
+
63
+ ## Decision table
64
+
65
+ | Want | Approach |
66
+ | --- | --- |
67
+ | Roundness on a ball, sun or face | Radial gradient, light stop toward the light |
68
+ | Sky or ground fading | Linear gradient, two or three stops |
69
+ | Organic shading (fabric, a face) | Mesh or freeform gradient |
70
+ | A highlight or texture over a colour | `vector.addFill` stacked on the same path, screen or overlay |
71
+ | An outline around an outline | `vector.addStroke` stacked, each with its own `strokeAlign` |
72
+ | Art visible only inside a shape | `vector.makeClippingMask` (the frame on top) |
73
+ | A fade-out or reflection | `vector.makeOpacityMask` with a white-to-black gradient |
74
+ | Even steps between two shapes | `vector.blend` |
75
+ | Card or object lifted off the page | `vector.addFilter` `dropShadow`, subtle |
76
+
77
+ ## Recipes
78
+
79
+ **Radial shading.** `vector.setStyle` with `fill: { type: "radial", interpolation: "oklab",
80
+ stops: [{ offset: 0, color: light }, { offset: 1, color: dark }] }`; move the centre toward the
81
+ light with `vector.setGradient`.
82
+
83
+ **Pattern in a window.** Draw the pattern, draw the window shape on top, then
84
+ `vector.makeClippingMask` with all their ids: the window clips, its own fill is not drawn, and
85
+ the pattern stays movable inside.
86
+
87
+ **Subtle shadow.** `vector.addFilter` `{ type: "dropShadow", params: { color: "#000000",
88
+ opacity: 0.2, offsetX: 0, offsetY: 4, blur: 8 } }` on the object.
89
+
90
+ ## Pitfalls
91
+
92
+ - **Duplicates for shading.** A copied shape for a highlight drifts when the original is edited;
93
+ stack a fill instead.
94
+ - **Muddy gradients.** sRGB interpolation between saturated hues passes through grey; use
95
+ `oklab`, or add a midpoint stop.
96
+ - **Mixed light directions** make a scene look collaged; keep every shadow offset the same way.
97
+ - **Heavy shadows.** Dark, hard, far shadows look pasted on.
98
+ - **The mask on the wrong layer.** `vector.makeClippingMask` uses the topmost object as the mask
99
+ unless `maskId` says otherwise; put the frame on top first.
100
+ - **Filters in exports.** SVG filters render differently in some tools; expand or rasterize where
101
+ the result must look identical everywhere.
102
+
103
+ ## Tools used
104
+
105
+ - `vector.list`, `vector.getAppearance`: structure, order, fills, masks and filters
106
+ - `vector.addShape`, `vector.addPath`, `vector.group`, `vector.moveLayer`: block in, group and order
107
+ - `vector.setStyle`, `vector.setGradient`, `vector.setMeshGradient`, `vector.setFreeformGradient`: colour and gradients
108
+ - `vector.addFill`, `vector.addStroke`, `vector.setBlendMode`: appearance stacks
109
+ - `vector.makeClippingMask`, `vector.makeOpacityMask`, `vector.setMaskOptions`: masks
110
+ - `vector.blend`, `vector.makeSymbol`, `vector.placeSymbol`: transitions and repeats
111
+ - `vector.addFilter`, `vector.updateFilter`: shadows, glows and blur
112
+ - `vector.expandAppearance`, `vector.expandBlend`, `vector.exportSvg`, `vector.exportFrameSvg`: finish and export
@@ -0,0 +1,21 @@
1
+ {
2
+ "prompt": "Show the stripes only inside the round window, and keep the stripes movable inside it.",
3
+ "fixture": {
4
+ "editor": "vector",
5
+ "width": 100,
6
+ "height": 100,
7
+ "setup": [
8
+ { "id": "vector.addShape", "params": { "kind": "rect", "x": 10, "y": 10, "width": 16, "height": 80, "name": "Stripe", "fill": "#457b9d", "stroke": null } },
9
+ { "id": "vector.addShape", "params": { "kind": "rect", "x": 42, "y": 10, "width": 16, "height": 80, "name": "Stripe", "fill": "#457b9d", "stroke": null } },
10
+ { "id": "vector.addShape", "params": { "kind": "rect", "x": 74, "y": 10, "width": 16, "height": 80, "name": "Stripe", "fill": "#457b9d", "stroke": null } },
11
+ { "id": "vector.addShape", "params": { "kind": "ellipse", "x": 20, "y": 20, "width": 60, "height": 60, "name": "Window", "fill": "#ffffff", "stroke": null } }
12
+ ]
13
+ },
14
+ "checks": [
15
+ { "why": "a clipping mask using the window, with all three stripes inside", "tool": "run_command", "args": { "id": "vector.list" }, "expect": { "result": { "nodes": { "$some": { "mask": { "type": "clip", "enabled": true, "contents": { "$length": 3 } } } } } } },
16
+ { "why": "the stripes are still separate, editable paths", "tool": "run_command", "args": { "id": "vector.list" }, "expect": { "result": { "nodes": { "$expr": "v.filter((n) => n.name === 'Stripe' && n.type === 'path').length === 3" } } } }
17
+ ],
18
+ "solution": [
19
+ { "tool": "run_command", "args": { "id": "vector.makeClippingMask", "params": { "ids": { "$read": "run_command", "args": { "id": "vector.list" }, "path": "result.nodes.*.id" } } } }
20
+ ]
21
+ }
@@ -0,0 +1,16 @@
1
+ {
2
+ "prompt": "Give the sun a soft radial gradient: yellow in the middle fading to orange at the edge.",
3
+ "fixture": {
4
+ "editor": "vector",
5
+ "width": 100,
6
+ "height": 100,
7
+ "setup": [{ "id": "vector.addShape", "params": { "kind": "ellipse", "x": 30, "y": 30, "width": 40, "height": 40, "name": "Sun", "fill": "#ffcc00", "stroke": null } }]
8
+ },
9
+ "checks": [
10
+ { "why": "a radial gradient from yellow at the centre to orange at the edge", "tool": "run_command", "args": { "id": "vector.list" }, "expect": { "result": { "nodes": { "$some": { "name": "Sun", "fill": { "$expr": "v && v.type === 'radial' && v.stops.length >= 2 && v.stops[0].offset === 0 && v.stops[v.stops.length - 1].offset === 1" } } } } } },
11
+ { "why": "the sun is still the same shape and place", "tool": "run_command", "args": { "id": "vector.list" }, "expect": { "result": { "nodes": { "$some": { "name": "Sun", "bounds": { "x": 30, "y": 30, "width": 40, "height": 40 } } } } } }
12
+ ],
13
+ "solution": [
14
+ { "tool": "run_command", "args": { "id": "vector.setStyle", "params": { "ids": { "$read": "run_command", "args": { "id": "vector.list" }, "path": "result.nodes.*.id" }, "fill": { "type": "radial", "interpolation": "oklab", "stops": [{ "offset": 0, "color": "#ffe14d" }, { "offset": 1, "color": "#ff8c1a" }] } } } }
15
+ ]
16
+ }
@@ -0,0 +1,16 @@
1
+ {
2
+ "prompt": "Add a subtle drop shadow under the card, with the light coming from above.",
3
+ "fixture": {
4
+ "editor": "vector",
5
+ "width": 200,
6
+ "height": 140,
7
+ "setup": [{ "id": "vector.addShape", "params": { "kind": "rect", "x": 40, "y": 30, "width": 120, "height": 80, "cornerRadius": 8, "name": "Card", "fill": "#ffffff", "stroke": null } }]
8
+ },
9
+ "checks": [
10
+ { "why": "a soft, faint shadow falling straight down", "tool": "run_command", "args": { "id": "vector.list" }, "expect": { "result": { "nodes": { "$some": { "name": "Card", "filters": { "$some": { "type": "dropShadow", "params": { "opacity": { "$min": 0.08, "$max": 0.35 }, "offsetX": { "$min": -1, "$max": 1 }, "offsetY": { "$min": 2, "$max": 10 }, "blur": { "$min": 3 } } } } } } } } },
11
+ { "why": "drawn as an effect: still one card, no extra shadow shape", "tool": "run_command", "args": { "id": "vector.list" }, "expect": { "result": { "nodes": { "$length": 1 } } } }
12
+ ],
13
+ "solution": [
14
+ { "tool": "run_command", "args": { "id": "vector.addFilter", "params": { "ids": { "$read": "run_command", "args": { "id": "vector.list" }, "path": "result.nodes.*.id" }, "type": "dropShadow", "params": { "color": "#000000", "opacity": 0.2, "offsetX": 0, "offsetY": 4, "blur": 8 } } } }
15
+ ]
16
+ }
@@ -0,0 +1,107 @@
1
+ ---
2
+ name: pixerate-vector-logo
3
+ description: The logo workflow in the Pixerate vector editor - building a mark from primitives with live booleans, Pathfinder and Shape Builder, optical corrections, a lockup of mark and wordmark aligned and spaced on the artboard, text converted to outlines for the final file, colour variants (full colour, one colour, reversed) through symbols, and clean single-path SVG export. Use when asked to design, draw, redraw, vectorise, clean up or export a logo, logomark, wordmark, monogram, emblem or brand mark, make a one-colour or reversed version, or prepare a logo file for print or the web, or when vector.boolean, vector.pathfinder, vector.createOutlines or vector.exportSvg are available. Load with pixerate-vector, which lists every command.
4
+ metadata:
5
+ kind: workflow
6
+ reference: pixerate-vector
7
+ ---
8
+
9
+ # Making a logo
10
+
11
+ A logo has to survive every size and every background, so it is built from few, clean shapes,
12
+ kept editable while it is being designed and flattened only for delivery. Design with live
13
+ booleans and real text; deliver plain paths with text outlined, one file per variant.
14
+
15
+ This skill is the method. `pixerate-vector` has the full command reference; run the commands
16
+ with `run_command`, or several as one undo step with `run_commands` and `atomic: true`.
17
+
18
+ ## Goal and quality bar
19
+
20
+ - The mark is built from simple geometry: primitives combined with booleans, with as few anchors
21
+ as the shape needs.
22
+ - It reads at 16 px and at poster size: no hairlines thinner than about 1/30 of the mark's
23
+ height, no details that close up when small.
24
+ - The lockup is aligned on the artboard: mark and wordmark centred (or aligned to a shared edge),
25
+ with a deliberate gap kept in every variant.
26
+ - Delivery files are self-contained: text outlined (`vector.createOutlines`), live booleans and
27
+ effects expanded, one path per colour where possible, no hidden or stray nodes.
28
+ - Variants match: full colour, one colour (black) and reversed (white on dark) are the same
29
+ geometry.
30
+
31
+ ## Inputs to confirm
32
+
33
+ - **Name and wording** for the wordmark, and the typeface (`vector.listFonts`).
34
+ - **Colours:** the brand palette as hex, and which variants are needed.
35
+ - **Stage:** still designing (keep live) or delivering (flatten and outline).
36
+
37
+ ## Working method
38
+
39
+ 1. **Read.** `vector.list`: the artboard, existing shapes and text, their fills and bounds.
40
+ **Check:** you know which nodes are the mark and which the wordmark.
41
+ 2. **Build the mark from primitives.** `vector.addShape` (rect, ellipse, polygon, star) on round
42
+ numbers; combine with `vector.boolean` and `live: true` while designing (`union` for one
43
+ silhouette, `subtract` for cut-outs, `intersect`); `vector.pathfinder` when you need every
44
+ region (`divide`) or `vector.shapeBuilder` to merge chosen regions.
45
+ **Check:** `vector.list` shows the live group with its `liveBoolean` and the expected bounds.
46
+ 3. **Correct optically.** Round shapes overshoot flat ones by 2-3 % so they look the same height;
47
+ a horizontal bar looks thicker than a vertical one of equal width, so thin it slightly;
48
+ centre by eye mass (a triangle's centroid, not its box).
49
+ 4. **Set the wordmark** with `vector.addText` (point text) and `vector.setTextStyle` for tracking;
50
+ keep it as text while designing.
51
+ **Check:** the text result's `overflow` is empty and `missingFonts` lists nothing.
52
+ 5. **Lock it up.** Position mark and wordmark with `vector.transform` (`dx`, `dy`) or
53
+ `vector.align`, then group them (`vector.group` with a `name`).
54
+ **Check:** `vector.list` bounds: centres equal (or edges aligned), the gap what you intended.
55
+ 6. **Variants.** Make the lockup a symbol (`vector.makeSymbol`) and place it once per variant
56
+ (`vector.placeSymbol`), recolouring with `vector.setInstanceOptions` `fill`, so a geometry
57
+ change updates every variant. Check each against its background colour (contrast).
58
+ 7. **Deliver.** For each variant: `vector.createOutlines` on the text, `vector.expandAppearance`
59
+ on live booleans and effects (or `vector.boolean` without `live` for one path),
60
+ `vector.removeRedundantPoints`, then `vector.exportSvg` with `precision` 2.
61
+ **Check:** `vector.list` has only plain paths; the SVG has no `text` and no filters.
62
+
63
+ ## Decision table
64
+
65
+ | Want | Command |
66
+ | --- | --- |
67
+ | One silhouette from overlapping shapes, still editable | `vector.boolean` `union`, `live: true` |
68
+ | A hole or notch | `vector.boolean` `subtract` (top shape cuts the one below) |
69
+ | Every overlap as its own piece | `vector.pathfinder` `divide` |
70
+ | Merge or remove particular regions | `vector.shapeBuilder` |
71
+ | A ring or donut for export | `vector.boolean` `subtract` without `live`: one path with two subpaths |
72
+ | Same logo in several colours | A symbol, with `vector.setInstanceOptions` per variant |
73
+ | Text that must not depend on fonts | `vector.createOutlines` (keep a text copy while designing) |
74
+
75
+ ## Recipes
76
+
77
+ **Live union.** `vector.boolean` `{ operation: "union", live: true, ids }` with the parts'
78
+ ids from `vector.list`; adjust a part later by its own id inside the group.
79
+
80
+ **Knockout for export.** `vector.boolean` `{ operation: "subtract", ids: [outer, inner] }`: one
81
+ path, the hole see-through (not painted white).
82
+
83
+ **Centre a lockup.** For each part, `dx = artboard.width / 2 - (bounds.x + bounds.width / 2)`
84
+ with `vector.transform`; leave `dy` at 0 to keep the vertical gap.
85
+
86
+ ## Pitfalls
87
+
88
+ - **White shapes as holes.** A white circle over a red one is not a hole; it shows on a coloured
89
+ background. Subtract it.
90
+ - **Flattening too early.** A destructive boolean or outlined text cannot be re-edited; keep live
91
+ versions until delivery.
92
+ - **Live effects in delivered files.** Filters and live booleans export as SVG filters or
93
+ Pixerate attributes that other tools may not read; expand first.
94
+ - **Missing fonts.** A family the shaper lacks draws in a fallback; check `missingFonts` before
95
+ outlining, since outlines bake whatever was drawn.
96
+ - **Hairlines and tiny counters** disappear at favicon size; test the mark small.
97
+
98
+ ## Tools used
99
+
100
+ - `vector.list`, `vector.getText`, `vector.listFonts`: read shapes, text and fonts
101
+ - `vector.addShape`, `vector.addPath`, `vector.addText`, `vector.setTextStyle`: build the mark and wordmark
102
+ - `vector.boolean`, `vector.pathfinder`, `vector.shapeBuilder`: combine shapes
103
+ - `vector.transform`, `vector.align`, `vector.group`: lock up and space
104
+ - `vector.makeSymbol`, `vector.placeSymbol`, `vector.setInstanceOptions`: colour variants
105
+ - `vector.setStyle`: brand colours
106
+ - `vector.createOutlines`, `vector.expandAppearance`, `vector.removeRedundantPoints`: prepare for delivery
107
+ - `vector.exportSvg`: the delivered file
@@ -0,0 +1,20 @@
1
+ {
2
+ "prompt": "Centre the logo mark and the wordmark bar under it horizontally on the artboard, keeping the gap between them.",
3
+ "fixture": {
4
+ "editor": "vector",
5
+ "width": 120,
6
+ "height": 80,
7
+ "setup": [
8
+ { "id": "vector.addShape", "params": { "kind": "ellipse", "x": 14, "y": 8, "width": 32, "height": 32, "name": "Mark", "fill": "#1d3557", "stroke": null } },
9
+ { "id": "vector.addShape", "params": { "kind": "rect", "x": 30, "y": 52, "width": 64, "height": 12, "name": "Wordmark", "fill": "#1d3557", "stroke": null } }
10
+ ]
11
+ },
12
+ "checks": [
13
+ { "why": "both centred on the artboard", "tool": "run_command", "args": { "id": "vector.list" }, "expect": { "result": { "nodes": { "$length": 2, "$every": { "bounds": { "$expr": "Math.abs(v.x + v.width / 2 - 60) <= 0.5" } } } } } },
14
+ { "why": "the vertical layout and gap are unchanged", "tool": "run_command", "args": { "id": "vector.list" }, "expect": { "result": { "nodes": [{ "name": "Mark", "bounds": { "y": 8, "height": 32 } }, { "name": "Wordmark", "bounds": { "y": 52, "height": 12 } }] } } }
15
+ ],
16
+ "solution": [
17
+ { "tool": "run_command", "args": { "id": "vector.transform", "params": { "ids": [{ "$read": "run_command", "args": { "id": "vector.list" }, "path": "result.nodes.0.id" }], "dx": 30 } } },
18
+ { "tool": "run_command", "args": { "id": "vector.transform", "params": { "ids": [{ "$read": "run_command", "args": { "id": "vector.list" }, "path": "result.nodes.1.id" }], "dx": -2 } } }
19
+ ]
20
+ }
@@ -0,0 +1,21 @@
1
+ {
2
+ "prompt": "Cut the small circle out of the big one so the mark becomes a ring you can see through. This is for the final export file, so make it a single plain path.",
3
+ "fixture": {
4
+ "editor": "vector",
5
+ "width": 64,
6
+ "height": 64,
7
+ "setup": [
8
+ { "id": "vector.addShape", "params": { "kind": "ellipse", "x": 4, "y": 4, "width": 56, "height": 56, "name": "Outer", "fill": "#e63946", "stroke": null } },
9
+ { "id": "vector.addShape", "params": { "kind": "ellipse", "x": 20, "y": 20, "width": 24, "height": 24, "name": "Inner", "fill": "#ffffff", "stroke": null } }
10
+ ]
11
+ },
12
+ "checks": [
13
+ { "why": "one plain path, no groups", "tool": "run_command", "args": { "id": "vector.list" }, "expect": { "result": { "nodes": { "$length": 1, "$every": { "type": "path" } } } } },
14
+ { "why": "a ring: the outer outline and the hole (two subpaths)", "tool": "run_command", "args": { "id": "vector.list" }, "expect": { "result": { "nodes": { "$every": { "bounds": { "x": 4, "y": 4, "width": 56, "height": 56 }, "d": { "$expr": "(v.match(/M/g) || []).length === 2" } } } } } },
15
+ { "why": "the hole is see-through: no white is painted", "tool": "run_command", "args": { "id": "vector.list" }, "expect": { "result": { "nodes": { "$every": { "fill": "#e63946" } } } } }
16
+ ],
17
+ "solution": [
18
+ { "tool": "run_command", "args": { "id": "vector.list" } },
19
+ { "tool": "run_command", "args": { "id": "vector.boolean", "params": { "operation": "subtract", "ids": { "$read": "run_command", "args": { "id": "vector.list" }, "path": "result.nodes.*.id" } } } }
20
+ ]
21
+ }
@@ -0,0 +1,19 @@
1
+ {
2
+ "prompt": "Merge the circle and the square into one silhouette for the logo mark, but keep both shapes editable so I can still nudge them.",
3
+ "fixture": {
4
+ "editor": "vector",
5
+ "width": 64,
6
+ "height": 64,
7
+ "setup": [
8
+ { "id": "vector.addShape", "params": { "kind": "ellipse", "x": 8, "y": 8, "width": 32, "height": 32, "name": "Circle", "fill": "#1d3557", "stroke": null } },
9
+ { "id": "vector.addShape", "params": { "kind": "rect", "x": 24, "y": 24, "width": 32, "height": 32, "name": "Square", "fill": "#1d3557", "stroke": null } }
10
+ ]
11
+ },
12
+ "checks": [
13
+ { "why": "one top-level object: a live union of the two", "tool": "run_command", "args": { "id": "vector.list" }, "expect": { "result": { "nodes": { "$expr": "v.filter((n) => n.depth === 0).length === 1", "$some": { "depth": 0, "liveBoolean": "union", "children": 2 } } } } },
14
+ { "why": "covering both shapes", "tool": "run_command", "args": { "id": "vector.list" }, "expect": { "result": { "nodes": { "$some": { "depth": 0, "bounds": { "x": 8, "y": 8, "width": 48, "height": 48 } } } } } }
15
+ ],
16
+ "solution": [
17
+ { "tool": "run_command", "args": { "id": "vector.boolean", "params": { "operation": "union", "live": true, "ids": { "$read": "run_command", "args": { "id": "vector.list" }, "path": "result.nodes.*.id" } } } }
18
+ ]
19
+ }