@pixerate/editor 0.132.0 → 0.134.0

package/dist/video-editor/index.d.cts

@@ -1,11 +1,11 @@
-import { V as VideoProject, a as VideoAnimatable, b as VideoAsset, c as VideoAssetProxy, d as VideoClip, e as VideoClipAnimation, f as VideoClipEffect, g as VideoEffectRef, h as VideoEffectValues, i as VideoGrade, j as VideoGradeLut, k as VideoKeyframes, l as VideoMarker, m as VideoSequence, n as VideoTrack, o as VideoTranscriptWord, p as VideoTransform, q as VideoTransition, v as videoKeysOf, r as VideoTrackKind, s as VideoPlacementMode, t as VideoKeyframeProperty, u as VideoKey, w as VideoMediaClip, x as VideoEffectsEngine, y as VideoLayer, z as VideoFrame, A as VideoRect, B as VideoEffectPlace, C as VideoFfmpegOptions, D as VideoFfmpegExport, E as VideoEdlOptions, F as VideoFadeCurve, G as VideoFit, H as VideoBlendMode, I as VideoAssetKind, J as VideoClipAnimationEffect, K as VideoTransitionType } from '../export-CfAogLEr.cjs';
-export { L as VIDEO_BLEND_MODES, M as VIDEO_CLIP_ANIMATION_EFFECTS, N as VIDEO_CLIP_TYPES, O as VIDEO_EASE_NAMES, P as VIDEO_EFFECT_PLACES, Q as VIDEO_FADE_CURVES, R as VIDEO_FITS, S as VIDEO_KEYFRAME_LIMITS, T as VIDEO_KEYFRAME_PROPERTIES, U as VIDEO_PLACEMENT_MODES, W as VIDEO_TRANSFORM_PROPERTIES, X as VIDEO_TRANSITION_TYPES, Y as VIDEO_WIPE_DIRECTIONS, Z as VideoAudioSource, _ as VideoClipType, $ as VideoColorClip, a0 as VideoEase, a1 as VideoEffectClip, a2 as VideoEffectJob, a3 as VideoEffectUse, a4 as VideoEffectsEngineOptions, a5 as VideoLayerEffect, a6 as VideoLoudnessMeasurement, a7 as VideoLoudnessTarget, a8 as VideoSequenceClip, a9 as VideoTextClip, aa as VideoWipeDirection, ab as checkVideoEffectPlace, ac as checkVideoEffectValues, ad as ffmpegFilterValue, ae as isVideoKeyframes, af as mixEffectPixels, ag as overEffectPixels, ah as parseVideoLoudnessMeasurement, ai as placeVideoRect, aj as removeVideoKey, ak as retimeVideoAnimatable, al as setVideoKey, am as sortVideoKeys, an as splitVideoAnimatable, ao as toVideoEdl, ap as toVideoFfmpeg, aq as toVideoLoudnessMeasure, ar as videoClipEffectUses, as as videoClipSoundGain, at as videoEaseBezier, au as videoEaseProgress, av as videoEffectFrameTime, aw as videoEffectLayerKey, ax as videoEffectValuesAt, ay as videoFadeCurveGain, az as videoFfmpegUnsupportedEffects, aA as videoFrameAt, aB as videoFrameLeafLayers, aC as videoKeyframeBreakpoints, aD as videoKeyframeFfmpegExpr, aE as videoLayersUseEffects, aF as videoLayersWithoutTransitionEffects, aG as videoProjectEffects, aH as videoShellQuote, aI as videoTextStyle, aJ as videoTitleFrame, aK as videoTransformAt, aL as videoTransitionAudioCurve, aM as videoTransitionEase, aN as videoValueAt } from '../export-CfAogLEr.cjs';
+import { V as VideoProject, a as VideoAnimatable, b as VideoAsset, c as VideoAssetProxy, d as VideoClip, e as VideoClipAnimation, f as VideoClipEffect, g as VideoEffectRef, h as VideoEffectValues, i as VideoGrade, j as VideoGradeLut, k as VideoKeyframes, l as VideoMarker, m as VideoSequence, n as VideoTrack, o as VideoTranscriptWord, p as VideoTransform, q as VideoTransition, v as videoKeysOf, r as VideoTrackKind, s as VideoPlacementMode, t as VideoKeyframeProperty, u as VideoKey, w as VideoMediaClip, x as VideoEffectsEngine, y as VideoLayer, z as VideoFrame, A as VideoRect, B as VideoEffectPlace, C as VideoFfmpegOptions, D as VideoFfmpegExport, E as VideoEdlOptions, F as VideoFadeCurve, G as VideoFit, H as VideoBlendMode, I as VideoAssetKind, J as VideoClipAnimationEffect, K as VideoTransitionType } from '../export-KzubBKo7.cjs';
+export { L as VIDEO_BLEND_MODES, M as VIDEO_CLIP_ANIMATION_EFFECTS, N as VIDEO_CLIP_TYPES, O as VIDEO_EASE_NAMES, P as VIDEO_EFFECT_PLACES, Q as VIDEO_FADE_CURVES, R as VIDEO_FITS, S as VIDEO_KEYFRAME_LIMITS, T as VIDEO_KEYFRAME_PROPERTIES, U as VIDEO_PLACEMENT_MODES, W as VIDEO_TRANSFORM_PROPERTIES, X as VIDEO_TRANSITION_TYPES, Y as VIDEO_WIPE_DIRECTIONS, Z as VideoAudioSource, _ as VideoClipType, $ as VideoColorClip, a0 as VideoEase, a1 as VideoEffectClip, a2 as VideoEffectJob, a3 as VideoEffectUse, a4 as VideoEffectsEngineOptions, a5 as VideoLayerEffect, a6 as VideoLoudnessMeasurement, a7 as VideoLoudnessTarget, a8 as VideoSequenceClip, a9 as VideoTextClip, aa as VideoWipeDirection, ab as checkVideoEffectPlace, ac as checkVideoEffectValues, ad as ffmpegFilterValue, ae as isVideoKeyframes, af as mixEffectPixels, ag as overEffectPixels, ah as parseVideoLoudnessMeasurement, ai as placeVideoRect, aj as removeVideoKey, ak as retimeVideoAnimatable, al as setVideoKey, am as sortVideoKeys, an as splitVideoAnimatable, ao as toVideoEdl, ap as toVideoFfmpeg, aq as toVideoLoudnessMeasure, ar as videoClipEffectUses, as as videoClipSoundGain, at as videoEaseBezier, au as videoEaseProgress, av as videoEffectFrameTime, aw as videoEffectLayerKey, ax as videoEffectValuesAt, ay as videoFadeCurveGain, az as videoFfmpegUnsupportedEffects, aA as videoFrameAt, aB as videoFrameLeafLayers, aC as videoKeyframeBreakpoints, aD as videoKeyframeFfmpegExpr, aE as videoLayersUseEffects, aF as videoLayersWithoutTransitionEffects, aG as videoProjectEffects, aH as videoShellQuote, aI as videoTextStyle, aJ as videoTitleFrame, aK as videoTransformAt, aL as videoTransitionAudioCurve, aM as videoTransitionEase, aN as videoValueAt } from '../export-KzubBKo7.cjs';
 import { A as AnimationPlayer, C as Clock } from '../player-CmbY3218.cjs';
 import { b as AnimationLoopMode } from '../evaluate-BsxYieLN.cjs';
 import { H as HistoryManager } from '../HistoryManager-DeQQMBCj.cjs';
-import { v as EffectsSlot, E as EffectProvider, f as EffectDescription, e as EffectValue } from '../helpers-CoIeXQnW.cjs';
+import { v as EffectsSlot, E as EffectProvider, f as EffectDescription, e as EffectValue } from '../helpers-DHl28yLO.cjs';
 import { a as AgentToolProvider } from '../registry-BqA1AZt0.cjs';
-import { A as AppliedEffectInfo } from '../tools-BFvkFnRj.cjs';
+import { A as AppliedEffectInfo } from '../tools-3EBjR91b.cjs';
 import '../easing-lM0Xo9Ni.cjs';
 import '../types-DsiXGmjo.cjs';
 import '../schema-Di0CS6Pe.cjs';

package/dist/video-editor/index.d.ts

@@ -1,11 +1,11 @@
-import { V as VideoProject, a as VideoAnimatable, b as VideoAsset, c as VideoAssetProxy, d as VideoClip, e as VideoClipAnimation, f as VideoClipEffect, g as VideoEffectRef, h as VideoEffectValues, i as VideoGrade, j as VideoGradeLut, k as VideoKeyframes, l as VideoMarker, m as VideoSequence, n as VideoTrack, o as VideoTranscriptWord, p as VideoTransform, q as VideoTransition, v as videoKeysOf, r as VideoTrackKind, s as VideoPlacementMode, t as VideoKeyframeProperty, u as VideoKey, w as VideoMediaClip, x as VideoEffectsEngine, y as VideoLayer, z as VideoFrame, A as VideoRect, B as VideoEffectPlace, C as VideoFfmpegOptions, D as VideoFfmpegExport, E as VideoEdlOptions, F as VideoFadeCurve, G as VideoFit, H as VideoBlendMode, I as VideoAssetKind, J as VideoClipAnimationEffect, K as VideoTransitionType } from '../export-Crl82sbE.js';
-export { L as VIDEO_BLEND_MODES, M as VIDEO_CLIP_ANIMATION_EFFECTS, N as VIDEO_CLIP_TYPES, O as VIDEO_EASE_NAMES, P as VIDEO_EFFECT_PLACES, Q as VIDEO_FADE_CURVES, R as VIDEO_FITS, S as VIDEO_KEYFRAME_LIMITS, T as VIDEO_KEYFRAME_PROPERTIES, U as VIDEO_PLACEMENT_MODES, W as VIDEO_TRANSFORM_PROPERTIES, X as VIDEO_TRANSITION_TYPES, Y as VIDEO_WIPE_DIRECTIONS, Z as VideoAudioSource, _ as VideoClipType, $ as VideoColorClip, a0 as VideoEase, a1 as VideoEffectClip, a2 as VideoEffectJob, a3 as VideoEffectUse, a4 as VideoEffectsEngineOptions, a5 as VideoLayerEffect, a6 as VideoLoudnessMeasurement, a7 as VideoLoudnessTarget, a8 as VideoSequenceClip, a9 as VideoTextClip, aa as VideoWipeDirection, ab as checkVideoEffectPlace, ac as checkVideoEffectValues, ad as ffmpegFilterValue, ae as isVideoKeyframes, af as mixEffectPixels, ag as overEffectPixels, ah as parseVideoLoudnessMeasurement, ai as placeVideoRect, aj as removeVideoKey, ak as retimeVideoAnimatable, al as setVideoKey, am as sortVideoKeys, an as splitVideoAnimatable, ao as toVideoEdl, ap as toVideoFfmpeg, aq as toVideoLoudnessMeasure, ar as videoClipEffectUses, as as videoClipSoundGain, at as videoEaseBezier, au as videoEaseProgress, av as videoEffectFrameTime, aw as videoEffectLayerKey, ax as videoEffectValuesAt, ay as videoFadeCurveGain, az as videoFfmpegUnsupportedEffects, aA as videoFrameAt, aB as videoFrameLeafLayers, aC as videoKeyframeBreakpoints, aD as videoKeyframeFfmpegExpr, aE as videoLayersUseEffects, aF as videoLayersWithoutTransitionEffects, aG as videoProjectEffects, aH as videoShellQuote, aI as videoTextStyle, aJ as videoTitleFrame, aK as videoTransformAt, aL as videoTransitionAudioCurve, aM as videoTransitionEase, aN as videoValueAt } from '../export-Crl82sbE.js';
+import { V as VideoProject, a as VideoAnimatable, b as VideoAsset, c as VideoAssetProxy, d as VideoClip, e as VideoClipAnimation, f as VideoClipEffect, g as VideoEffectRef, h as VideoEffectValues, i as VideoGrade, j as VideoGradeLut, k as VideoKeyframes, l as VideoMarker, m as VideoSequence, n as VideoTrack, o as VideoTranscriptWord, p as VideoTransform, q as VideoTransition, v as videoKeysOf, r as VideoTrackKind, s as VideoPlacementMode, t as VideoKeyframeProperty, u as VideoKey, w as VideoMediaClip, x as VideoEffectsEngine, y as VideoLayer, z as VideoFrame, A as VideoRect, B as VideoEffectPlace, C as VideoFfmpegOptions, D as VideoFfmpegExport, E as VideoEdlOptions, F as VideoFadeCurve, G as VideoFit, H as VideoBlendMode, I as VideoAssetKind, J as VideoClipAnimationEffect, K as VideoTransitionType } from '../export-DMeG6E06.js';
+export { L as VIDEO_BLEND_MODES, M as VIDEO_CLIP_ANIMATION_EFFECTS, N as VIDEO_CLIP_TYPES, O as VIDEO_EASE_NAMES, P as VIDEO_EFFECT_PLACES, Q as VIDEO_FADE_CURVES, R as VIDEO_FITS, S as VIDEO_KEYFRAME_LIMITS, T as VIDEO_KEYFRAME_PROPERTIES, U as VIDEO_PLACEMENT_MODES, W as VIDEO_TRANSFORM_PROPERTIES, X as VIDEO_TRANSITION_TYPES, Y as VIDEO_WIPE_DIRECTIONS, Z as VideoAudioSource, _ as VideoClipType, $ as VideoColorClip, a0 as VideoEase, a1 as VideoEffectClip, a2 as VideoEffectJob, a3 as VideoEffectUse, a4 as VideoEffectsEngineOptions, a5 as VideoLayerEffect, a6 as VideoLoudnessMeasurement, a7 as VideoLoudnessTarget, a8 as VideoSequenceClip, a9 as VideoTextClip, aa as VideoWipeDirection, ab as checkVideoEffectPlace, ac as checkVideoEffectValues, ad as ffmpegFilterValue, ae as isVideoKeyframes, af as mixEffectPixels, ag as overEffectPixels, ah as parseVideoLoudnessMeasurement, ai as placeVideoRect, aj as removeVideoKey, ak as retimeVideoAnimatable, al as setVideoKey, am as sortVideoKeys, an as splitVideoAnimatable, ao as toVideoEdl, ap as toVideoFfmpeg, aq as toVideoLoudnessMeasure, ar as videoClipEffectUses, as as videoClipSoundGain, at as videoEaseBezier, au as videoEaseProgress, av as videoEffectFrameTime, aw as videoEffectLayerKey, ax as videoEffectValuesAt, ay as videoFadeCurveGain, az as videoFfmpegUnsupportedEffects, aA as videoFrameAt, aB as videoFrameLeafLayers, aC as videoKeyframeBreakpoints, aD as videoKeyframeFfmpegExpr, aE as videoLayersUseEffects, aF as videoLayersWithoutTransitionEffects, aG as videoProjectEffects, aH as videoShellQuote, aI as videoTextStyle, aJ as videoTitleFrame, aK as videoTransformAt, aL as videoTransitionAudioCurve, aM as videoTransitionEase, aN as videoValueAt } from '../export-DMeG6E06.js';
 import { A as AnimationPlayer, C as Clock } from '../player-BK2kKbfd.js';
 import { b as AnimationLoopMode } from '../evaluate-BbCeF6pt.js';
 import { H as HistoryManager } from '../HistoryManager-DWSLd6Tf.js';
-import { v as EffectsSlot, E as EffectProvider, f as EffectDescription, e as EffectValue } from '../helpers-BCd2-PAR.js';
+import { v as EffectsSlot, E as EffectProvider, f as EffectDescription, e as EffectValue } from '../helpers-Coa4e2j_.js';
 import { a as AgentToolProvider } from '../registry-D-4fit9C.js';
-import { A as AppliedEffectInfo } from '../tools-D7ws-OKL.js';
+import { A as AppliedEffectInfo } from '../tools-y1M6O3UT.js';
 import '../easing-lM0Xo9Ni.js';
 import '../types-DsiXGmjo.js';
 import '../schema-Di0CS6Pe.js';

package/dist/{warp-2N9wkOkL.d.ts → warp-C1gwu2G_.d.ts}

@@ -1,4 +1,4 @@
-import { B as BezierPath } from './bezier-0IHDCvv_.js';
+import { B as BezierPath } from './bezier-lNEOp0Jx.js';
 import { W as WarpStyle, a as WarpMesh, V as Vec2, B as Box } from './types-CwMPoRMU.js';
 
 /**

package/dist/{warp-DErXW5rz.d.cts → warp-Ceqdz7kj.d.cts}

@@ -1,4 +1,4 @@
-import { B as BezierPath } from './bezier-oCBfrGDG.cjs';
+import { B as BezierPath } from './bezier-J8i4uqSH.cjs';
 import { W as WarpStyle, a as WarpMesh, V as Vec2, B as Box } from './types-CwMPoRMU.cjs';
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pixerate/editor",
-  "version": "0.132.0",
+  "version": "0.134.0",
   "description": "UI-agnostic rich text and media editing core library",
   "author": "Pixerate",
   "license": "MIT",

package/skills/pixerate-image-editor/SKILL.md

@@ -392,7 +392,7 @@ in the source frame at the document's bit depth, colour mode and profile. Read
 | `convert_colors` | Read-only. `colors` #rrggbb from the document's profile (or `from`) to `to`: channel `values` 0..1 (CMYK, RGB, grey), `hex` for RGB, and `lab`. |
 | `clone_stamp` | Copy pixels from the clone source along `points`: each point paints what is at point + offset (source − first point, whole px). `source` `{x, y}` sets the source for this stroke (else the current one, see `set_clone_source`); `aligned` keeps the offset for later strokes; `sample` current \| current-below \| all; `brush` `{size, hardness, spacing, opacity, flow, smoothing, pressureSize, pressureOpacity}`; `layerId`, `channel` (a mask clones from itself). One undo step. Returns the layer, channel, `bounds`, dabs and `clone` `{offset, source, aligned}`. Call `set_clone_source` or pass `source` first. |
 | `heal_brush` | As `clone_stamp`, then blends the cloned texture into the colour and light around the stroke (Poisson seamless cloning, when the stroke ends). Use for blemishes, wrinkles, dust and seams where the surroundings have the right tone. Returns as `clone_stamp`. |
-| `spot_heal` | Remove what `points` cover with no source: `type` proximity-match (default: copies the best matching nearby patch, then heals it in) or smooth (fills from the edges). `sample`, `brush`, `layerId`, `channel`. One undo step. Returns the layer, channel, `bounds`, dabs and `spotHeal` `{offset}` (null for a smooth fill). |
+| `spot_heal` | Remove what `points` cover with no source: `type` proximity-match (default: copies the best matching nearby patch, then heals it in), content-aware (synthesises texture, continues lines and patterns) or smooth (fills from the edges). `sample`, `brush`, `layerId`, `channel`. One undo step. Returns the layer, channel, `bounds`, dabs and `spotHeal` `{offset}` (null for a smooth fill). |
 | `smudge` | Drag colour along `points` like a finger in wet paint; `strength` 0..1 (default 0.5) is how far. Works on masks too. One undo step. Returns the layer, channel, `bounds` and dabs. |
 | `dodge` | Lighten what `points` cover, most in `range` shadows \| midtones \| highlights, at `exposure` 0..1 (overlaps in one stroke never exceed it); `protectTones` keeps hue and saturation. Alpha kept. One undo step. Returns the layer, channel, `bounds` and dabs. |
 | `burn` | As `dodge`, darkening. |

package/skills/pixerate-image-editor/references/retouching.md

@@ -5,8 +5,9 @@
    untouched, so a bad stroke is easy to mask or erase. Smudge, Dodge, Burn and Sponge change the
    pixels they touch, so run them on a duplicate (`duplicate_layer`) instead.
 2. **Pick the tool by the job.** A small spot or blemish on skin, sky or a wall: `spot_heal` with
-   a brush a little larger than the spot (`proximity-match` copies a nearby patch; `smooth` fills
-   from the edges and suits flat areas). A larger flaw, or one next to an edge: `heal_brush` from a
+   a brush a little larger than the spot (`proximity-match` copies a nearby patch; `content-aware`
+   synthesises texture and continues lines and patterns across the spot, best for larger spots and
+   where an edge runs through; `smooth` fills from the edges and suits flat areas). A larger flaw, or one next to an edge: `heal_brush` from a
    clean source of the same texture; it takes the colour and light around the stroke, so the source
    may be lighter or darker. Copy exactly (a repeat, a straight line, an edge): `clone_stamp`.
 3. **Sources and offsets.** `set_clone_source` (or `source` on the stroke) is the Alt-click. The

package/skills/pixerate-vector/SKILL.md

@@ -306,6 +306,17 @@ the browser's shaper they are kept but not drawn until outlines are available.
 | `vector.setResizing` | Set how children of a frame follow it on resize (`horizontal`, `vertical`; a missing axis keeps its value). Fails on objects not directly inside a frame. Returns `{ nodes: [{ id, horizontal, vertical }] }`. |
 | `vector.exportFrameSvg` | Export one frame as an SVG of its own size (its corner at the origin). Returns `{ svg, width, height }`; use it per artboard instead of `vector.exportSvg`. |
 
+### Pages and master pages
+
+| Command | Use it to |
+| --- | --- |
+| `vector.listPages` | Read the pages (top-level frames in order, with `number`, `masterId`, `bounds`) and master pages (`usedBy`, `bounds`: place master art inside them). |
+| `vector.addPage` | Add a page right of the others (`after`, `name`, `masterId`); the first page takes the artboard's art in. Add art with `parentId`. Returns `{ id }` and the pages. |
+| `vector.addMasterPage` | Add a master page (`assignTo` page ids or "all"): art in it (parentId) shows on its pages, laid out by `resizing`; text can show `{page}` and `{pages}`. Use for headers, footers, page numbers, backgrounds. |
+| `vector.setPageMaster` | Make pages use a master, or none with null. |
+| `vector.movePage` | Reorder a page (`index` from 0); numbers follow. |
+| `vector.goToPage` | Select a page and show it to the user. |
+
 ### Connectors
 
 | Command | Use it to |
@@ -417,32 +428,11 @@ the animation editor.
 
 ## Pitfalls
 
-- Mesh and freeform fills draw as fine tiles, not SVG gradients: they cannot be edited with
-  `vector.setGradient` or as stops, and other tools see them as SVG patterns. Point indices
-  shift after `vector.removeFreeformPoint`; read them again with `vector.getShading`.
-
-- A connector's geometry is regenerated after every edit while an end is glued: editing its
-  anchors directly does not stick. Unglue the end (`vector.setConnector` with `null`) or change
-  `route` instead. Connectors cannot be glued to connectors.
-
-- Scaling a frame (`vector.scale`, the selection handles) lays its children out by their
-  constraints, so it is a resize, not a zoom; group the frame (or scale its children) to scale the
-  art itself. A frame clips by default: objects moved outside it disappear (`clip: false` shows
-  them). Moving an object over a frame does not put it inside; use `vector.frameSelection` or
-  `adopt`.
+The most common ones are below. Read [references/pitfalls.md](references/pitfalls.md) before working with connectors, frames, masks, filters, text, symbols, constraints, blends, gradient meshes or live corners.
 
-- The `d` in `vector.list` draws live corners cut, which adds anchors. On a path with corner
-  radii, anchor indices counted from `d` do not match the stored anchors; count anchors on a path
-  without corners, or clear corners first.
 - `d` and anchor positions are in the node's own space; `bounds` are in document space. For
   rotated nodes (`rotation` not 0), `vector.moveAnchor` and `vector.bendSegment` take document
   coordinates, so compute them from the drawn position, not from `d`.
-- `vector.boolean` without `live` fails when the result is empty (shapes that do not overlap)
-  and consumes its inputs. Subtract removes upper shapes from the lowest: restack with
-  `vector.arrange` first.
-- `vector.blend`, `vector.group` and live booleans need nodes that share a parent.
-- Blend in-betweens are locked and regenerate; edit the keys, not the steps.
-- `strokeAlign` inside and outside only apply when every subpath is closed.
 - Stroke widths, corner radii and effect sizes are kept when scaling: scale them yourself if the
   design should grow proportionally.
 - `vector.importSvg` without `replace` adds on top; with `replace: true` it discards the current
@@ -450,36 +440,5 @@ the animation editor.
 - With a stack, `vector.setStyle` `fill` / `stroke` and the stroke settings edit only the top
   layer, and `fill: null` / `stroke: null` remove every layer. Edit other layers with
   `vector.updateFill` / `vector.updateStroke`, by the index `vector.getAppearance` reports.
-- Layer indexes shift after a remove or a move: use the stack each write returns.
-- Path effects apply to the whole node, every layer alike. Blend in-betweens mix the top fill and
-  stroke only.
-- In a mask group the order matters: the bottom child is always the mask. `vector.arrange` inside
-  the group can change which object masks; deleting the mask releases the group instead.
-- A mask group's path effects act on its contents, not on the mask. Hit-testing, bounds,
-  snapping and booleans use the masked result; an opacity mask counts wherever it paints, even
-  where it is dark.
-- Filters and blend modes are drawn, not geometry: bounds, snapping, booleans and Outline Stroke
-  ignore them. A node's blend mode and filter isolate its layers, so layer blend modes inside a
-  node with a filter mix only with the node's own layers. Background blur is not available.
-- Text positions are code units: an emoji or other character outside the Basic Multilingual
-  Plane counts 2. Take ranges from `vector.getText` rather than counting characters yourself.
-- Scaling text scales its font size (by the square root of the area change) and an area box per
-  axis; it is never stretched. Skew is not kept on text.
-- Without an outline shaper (`vector.listFonts` `outlines: false`), text exports as SVG `<text>`
-  positioned character by character; other viewers need the same fonts installed. Create Outlines
-  (with an outline shaper) when the SVG must look the same everywhere.
-- An instance's `transform` may scale; its art's strokes scale with it unless `scaleStrokes: false`.
-  Transform commands act on the instance, not the art: edit the art with `vector.editSymbol`.
-- While a symbol is being edited (`vector.listSymbols` `editing`), `vector.list` lists its art, not
-  the document. Always finish with `vector.exitSymbolEdit`. A symbol cannot contain an instance
-  of itself (directly or through another symbol).
-- Constraint refs to anchors give them stable ids; later anchor edits keep them, but rebuilding a
-  path (booleans, Outline Stroke, Expand) drops them, and constraints on missing anchors are
-  removed. `segment` means the straight line between two anchors, even when the segment is curved;
-  `tangent` / `smooth` on one anchor act on its handles.
-- After any edit the solver moves the rest of the geometry to keep the constraints; the anchors
-  you just moved move least. A fixed or fully constrained part will not move: remove or change a
-  constraint first.
-- `vector.typeOnPath` consumes the path. Duplicate it first if the path should stay visible.
 - A command that fails changes nothing; read its message (for example "Nothing is selected; pass
   ids.") and retry with the missing input.

package/skills/pixerate-vector/references/pitfalls.md

@@ -0,0 +1,62 @@
+# Vector editor pitfalls by area
+
+Detail moved out of SKILL.md (progressive disclosure). Each pitfall says what goes wrong and what to do instead.
+
+- Mesh and freeform fills draw as fine tiles, not SVG gradients: they cannot be edited with
+  `vector.setGradient` or as stops, and other tools see them as SVG patterns. Point indices
+  shift after `vector.removeFreeformPoint`; read them again with `vector.getShading`.
+
+- A connector's geometry is regenerated after every edit while an end is glued: editing its
+  anchors directly does not stick. Unglue the end (`vector.setConnector` with `null`) or change
+  `route` instead. Connectors cannot be glued to connectors.
+
+- Scaling a frame (`vector.scale`, the selection handles) lays its children out by their
+  constraints, so it is a resize, not a zoom; group the frame (or scale its children) to scale the
+  art itself. A frame clips by default: objects moved outside it disappear (`clip: false` shows
+  them). Moving an object over a frame does not put it inside; use `vector.frameSelection` or
+  `adopt`.
+
+- The `d` in `vector.list` draws live corners cut, which adds anchors. On a path with corner
+  radii, anchor indices counted from `d` do not match the stored anchors; count anchors on a path
+  without corners, or clear corners first.
+- `vector.boolean` without `live` fails when the result is empty (shapes that do not overlap)
+  and consumes its inputs. Subtract removes upper shapes from the lowest: restack with
+  `vector.arrange` first.
+- `vector.blend`, `vector.group` and live booleans need nodes that share a parent.
+- Blend in-betweens are locked and regenerate; edit the keys, not the steps.
+- `strokeAlign` inside and outside only apply when every subpath is closed.
+- Layer indexes shift after a remove or a move: use the stack each write returns.
+- Path effects apply to the whole node, every layer alike. Blend in-betweens mix the top fill and
+  stroke only.
+- In a mask group the order matters: the bottom child is always the mask. `vector.arrange` inside
+  the group can change which object masks; deleting the mask releases the group instead.
+- A mask group's path effects act on its contents, not on the mask. Hit-testing, bounds,
+  snapping and booleans use the masked result; an opacity mask counts wherever it paints, even
+  where it is dark.
+- Filters and blend modes are drawn, not geometry: bounds, snapping, booleans and Outline Stroke
+  ignore them. A node's blend mode and filter isolate its layers, so layer blend modes inside a
+  node with a filter mix only with the node's own layers. Background blur is not available.
+- Text positions are code units: an emoji or other character outside the Basic Multilingual
+  Plane counts 2. Take ranges from `vector.getText` rather than counting characters yourself.
+- Scaling text scales its font size (by the square root of the area change) and an area box per
+  axis; it is never stretched. Skew is not kept on text.
+- Without an outline shaper (`vector.listFonts` `outlines: false`), text exports as SVG `<text>`
+  positioned character by character; other viewers need the same fonts installed. Create Outlines
+  (with an outline shaper) when the SVG must look the same everywhere.
+- An instance's `transform` may scale; its art's strokes scale with it unless `scaleStrokes: false`.
+  Transform commands act on the instance, not the art: edit the art with `vector.editSymbol`.
+- While a symbol is being edited (`vector.listSymbols` `editing`), `vector.list` lists its art, not
+  the document. Always finish with `vector.exitSymbolEdit`. A symbol cannot contain an instance
+  of itself (directly or through another symbol).
+- Constraint refs to anchors give them stable ids; later anchor edits keep them, but rebuilding a
+  path (booleans, Outline Stroke, Expand) drops them, and constraints on missing anchors are
+  removed. `segment` means the straight line between two anchors, even when the segment is curved;
+  `tangent` / `smooth` on one anchor act on its handles.
+- After any edit the solver moves the rest of the geometry to keep the constraints; the anchors
+  you just moved move least. A fixed or fully constrained part will not move: remove or change a
+  constraint first.
+- `vector.typeOnPath` consumes the path. Duplicate it first if the path should stay visible.
+- Master art on a page is drawn from its master page and is locked there: edit the master page
+  (its id from `vector.listPages`, `parentId` to add to it), not the page. Give master objects
+  `resizing` (for example `vertical: "bottom"` for a footer) so they sit right on pages of other
+  sizes. Master pages are not pages: they are not numbered and PDF export by artboards skips them.