@pixerate/editor 0.133.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-CeFplzAW.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-CeFplzAW.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-BuKdqUlM.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-CRnZJXXr.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-zB4HITwP.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-zB4HITwP.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-cssRNUzH.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-CVGqEpO8.js';
+import { A as AppliedEffectInfo } from '../tools-y1M6O3UT.js';
 import '../easing-lM0Xo9Ni.js';
 import '../types-DsiXGmjo.js';
 import '../schema-Di0CS6Pe.js';

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

@@ -1,4 +1,4 @@
-import { B as BezierPath } from './bezier-BAGdL89w.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-ChcFDdlT.d.cts → warp-Ceqdz7kj.d.cts}

@@ -1,4 +1,4 @@
-import { B as BezierPath } from './bezier-DL2wPsFf.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.133.0",
+  "version": "0.134.0",
   "description": "UI-agnostic rich text and media editing core library",
   "author": "Pixerate",
   "license": "MIT",

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.