@pixerate/editor 0.130.0 → 0.132.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-5WDKJqTy.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-5WDKJqTy.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-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 { 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-CzZu51eI.cjs';
+import { v as EffectsSlot, E as EffectProvider, f as EffectDescription, e as EffectValue } from '../helpers-CoIeXQnW.cjs';
 import { a as AgentToolProvider } from '../registry-BqA1AZt0.cjs';
-import { A as AppliedEffectInfo } from '../tools-CtheDLDr.cjs';
+import { A as AppliedEffectInfo } from '../tools-BFvkFnRj.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-CU_ARP3A.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-CU_ARP3A.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-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 { 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-X_rycLNJ.js';
+import { v as EffectsSlot, E as EffectProvider, f as EffectDescription, e as EffectValue } from '../helpers-BCd2-PAR.js';
 import { a as AgentToolProvider } from '../registry-D-4fit9C.js';
-import { A as AppliedEffectInfo } from '../tools-D8bZ-7YG.js';
+import { A as AppliedEffectInfo } from '../tools-D7ws-OKL.js';
 import '../easing-lM0Xo9Ni.js';
 import '../types-DsiXGmjo.js';
 import '../schema-Di0CS6Pe.js';

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

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

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

@@ -1,4 +1,4 @@
-import { B as BezierPath } from './bezier-CdoGygwG.cjs';
+import { B as BezierPath } from './bezier-oCBfrGDG.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.130.0",
+  "version": "0.132.0",
   "description": "UI-agnostic rich text and media editing core library",
   "author": "Pixerate",
   "license": "MIT",
@@ -191,7 +191,7 @@
     "@tiptap/extension-underline": "^2.11.5",
     "@tiptap/starter-kit": "^2.11.5",
     "@tiptap/suggestion": "^2.11.5",
-    "markdown-it": "^15.0.2",
+    "markdown-it": "^15.0.3",
     "markdown-it-task-lists": "^2.1.1",
     "prosemirror-markdown": "^1.13.8"
   },

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

@@ -193,7 +193,8 @@ The working space, Assign / Convert to Profile with intents, soft proofing with
 and colour conversions for print briefs: read [references/color-management.md](references/color-management.md).
 ### Retouching
 
-Clone Stamp, Healing Brush, Spot Healing, Smudge, Dodge, Burn and Sponge: retouch on an empty
+Clone Stamp, Healing Brush, Spot Healing, Smudge, Dodge, Burn, Sponge, Blur, Sharpen and the
+History Brush: retouch on an empty
 layer with `sample: "current-below"`, pick `spot_heal` for small spots, `heal_brush` for larger
 flaws and `clone_stamp` to copy exactly, and keep strokes short and soft. Read
 [references/retouching.md](references/retouching.md) before retouching.
@@ -396,7 +397,10 @@ in the source frame at the document's bit depth, colour mode and profile. Read
 | `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. |
 | `sponge` | Desaturate (`mode` desaturate, default) or saturate what `points` cover; `vibrance` damps clipping; passes compound, `brush.flow` sets each pass's strength. Pixels only. One undo step. Returns the layer, channel, `bounds` and dabs. |
-| `get_retouch_options` | Read-only. The retouching defaults (`aligned`, `sample`, `spotType`, `range`, `exposure`, `protectTones`, `spongeMode`, `vibrance`, `strength`) and the `cloneSource` `{x, y, offset}` or null. Call before a clone or heal stroke without `source`. |
+| `blur_stroke` | Soften what `points` cover (`strength` 0..1 × brush opacity) on pixels or a mask. One undo step. Returns the layer, channel, `bounds` and dab count. Check with `capture_view`. |
+| `sharpen_stroke` | Crisp what `points` cover (an unsharp mask at `strength`; keep it 0.2..0.5). One undo step. Returns the layer, channel, `bounds` and dab count. |
+| `history_brush` | Paint the layer (or mask) back as it was `historySteps` undo steps ago (0 = oldest kept state) along `points`. Fails if the layer did not exist then. One undo step. Returns the layer, channel, `bounds` and dab count. |
+| `get_retouch_options` | Read-only. The retouching defaults (`aligned`, `sample`, `spotType`, `range`, `exposure`, `protectTones`, `spongeMode`, `vibrance`, `strength`, `historySteps`) and the `cloneSource` `{x, y, offset}` or null (an aligned stroke samples at the brush plus `offset`; the editors show it as a crosshair). Call before a clone or heal stroke without `source`. |
 | `set_retouch_options` | Set those defaults (view state, not an undo step); each stroke tool can override them per call. Changing `aligned` clears the kept offset. Returns the options. |
 | `set_clone_source` | Set the clone source `{x, y}` in document px (the Alt-click), or remove it with `clear: true`. View state. The next `clone_stamp` / `heal_brush` fixes the offset from its first point. Returns the source. |
 | `fill_pixels` | Fill the selection (or the canvas without one / with `useSelection: false`) on pixels or a mask with `color`, `opacity`, `blend`. Returns the changed bounds. |

package/skills/pixerate-image-editor/references/color-management.md

@@ -22,7 +22,7 @@ means sRGB. The viewport assumes an sRGB display and converts other working spac
    look with `capture_view`; adjust (lower saturation in the greyed areas); then `off: true`.
 5. **Print documents**: `set_color_mode` `cmyk` with the press profile makes the document a
    CMYK one: you keep editing RGB, the viewport proofs through the press, and `export_psd`
-   writes a CMYK PSD (the separation uses `intent`). Opening a CMYK PSD does this for you. Check
+   writes a CMYK PSD (the separation uses `intent`), at 16 bits for a 16- or 32-bit document. Opening a CMYK PSD does this for you. Check
    out-of-gamut colours with `set_proof_setup` `gamutWarning` before exporting.
 6. **Numbers for a print brief**: `convert_colors` gives CMYK percentages (values × 100) and
    Lab for any `#rrggbb`, without changing the document.

package/skills/pixerate-image-editor/references/photoshop-files.md

@@ -28,8 +28,8 @@
    in linear light). Layer masks keep the depth too: 16- and 32-bit masks open and save at depth,
    blend with their full precision, and the brush, eraser, `fill_pixels` and `clear_pixels` paint
    them at depth (retouching on a mask stays 8-bit). Layer filters (develop, blur) and layer
-   effects composite at depth in merges, `compositeDeepPixels` and the exported merged image (a
-   group's effects and legacy-process develop filters stay 8-bit). The viewport always shows
+   effects (a group's too) composite at depth in merges, `compositeDeepPixels` and the exported
+   merged image; smart objects render their contents and smart filters at 8 bits. The viewport always shows
    the 8-bit rendering. Afterwards work with `list_layers` as
    usual: there is no Background source image, every pixel comes from the layers.
 4. **Smart objects come in live**: embedded contents (a PSB opens as a nested document you can

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

@@ -24,6 +24,14 @@
    eyes), `saturate` adds it; passes compound, so use a low `brush.flow`.
 6. **Smudge** drags colour along the stroke like a finger in wet paint (`strength` how far); for
    blending paint colours use the Mixer Brush instead.
+7. **Blur and sharpen locally**: `blur_stroke` softens (a background, a harsh edge, skin texture)
+   and `sharpen_stroke` crisps (eyes, a detail). Keep `strength` low (sharpen 0.2..0.5) and check
+   with `capture_view`; for the whole layer use a layer filter instead. Dabs in one stroke do not
+   compound; another stroke goes further.
+8. **Take back part of a change** with `history_brush`: it paints the layer as it was
+   `historySteps` undo steps back (0, the default, is the oldest state history keeps). Filter or
+   grade the whole layer, then paint the original back where it should not apply. It fails when the
+   layer did not exist in that state; read `historySteps` from how many steps you have made since.
 
 ## Pitfalls
 
@@ -33,4 +41,4 @@
 - `heal_brush` and `spot_heal` show a plain clone or a dark trail while a person draws and blend
   when the stroke ends; through the tools the result is already blended.
 - `dodge`, `burn`, `sponge` and `smudge` ignore `brush.opacity` (exposure, flow and strength set
-  their strength) and `brush.blend`. The Sponge refuses masks, which have no colour.
+  their strength) and `brush.blend`; `blur_stroke` and `sharpen_stroke` multiply it by `strength`. The Sponge refuses masks, which have no colour.

package/skills/pixerate-vector/SKILL.md

@@ -325,6 +325,23 @@ the browser's shaper they are kept but not drawn until outlines are available.
 | `vector.enterSymmetry` | Hand the canvas to the user drawing inside a symmetry group (pen, pencil, shapes, text go in, mirrored live). Returns `{ id }`. |
 | `vector.exitSymmetry` | Stop drawing inside it. |
 
+### Perspective drawing
+
+| Command | Use it to |
+| --- | --- |
+| `vector.getPerspective` | Read the grid (`vanishingPoints`, `origin`, `gridSize`, `extent`, `visible`), its `planes` and `drawingOn`. |
+| `vector.setPerspective` | Set a 1-, 2- or 3-point grid: vanishing points on the horizon, the origin below where the planes meet. Returns the grid. |
+| `vector.removePerspective` | Remove the grid (art stays). |
+| `vector.setPerspectivePlane` | Make the rectangle, ellipse, polygon and star tools (the user's drags) draw on a plane, or flat with `null`. |
+| `vector.attachToPerspective` | Project objects onto a plane: draw them flat next to the origin (x right, y up from it), then attach. Use for signs on walls, tiles on floors, windows. Returns `{ ids }`. |
+
+### Lenses
+
+| Command | Use it to |
+| --- | --- |
+| `vector.setLens` | Make closed paths lenses (`type` magnify, fisheye, brighten, invert, tintedGrayscale, colorAdd, colorLimit, heatMap, wireframe, transparency; `amount`, `color`) or change them. What is below shows changed inside the outline and follows every edit; bounds stay the lens's own. Use for loupes, callouts, "X-ray" wireframes, duotone windows. Returns `{ lenses: [{ id, lens }] }`. |
+| `vector.removeLens` | Make lenses plain paths again. Returns `{ ids }`. |
+
 ### Masks and clipping
 
 | Command | Use it to |

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

@@ -161,3 +161,22 @@ fill; an unfilled stroked path takes part as the area its stroke paints. Pathfin
 `outline` also run on a single path; the other operations need two or more overlapping paths. Shape Builder
 `points` should come from `vector.shapeBuilderFaces` (`point` of each face) so a click lands
 inside the intended face.
+
+## Lenses
+
+`vector.setLens` types, their `amount` and `color`. Missing values take these defaults; switching type resets to them.
+
+| Type | amount (default) | color | What shows inside the lens |
+| --- | --- | --- | --- |
+| magnify | 1–20 times (2) | – | The backdrop scaled about the lens centre. |
+| fisheye | −100…100 (50) | – | Bulged (positive) or pinched (negative); the lens edge stays put. |
+| brighten | −100…100 % (40) | – | Lighter, or darker for negative amounts. |
+| invert | 0–100 % strength (100) | – | Inverted colours. |
+| tintedGrayscale | 0–100 % (100) | `#b45309` | Brightness as dark → tint → white (a duotone). |
+| colorAdd | 0–100 % (50) | `#ff0000` | The colour added. |
+| colorLimit | 0–100 % (100) | `#22c55e` | Only the colour let through. |
+| heatMap | 0–100 % palette turn (0) | – | Brightness on a cold-to-hot palette. |
+| wireframe | 0–100 % opacity (100) | `#0f172a` | Outlines only, 1 unit wide. |
+| transparency | 0–100 % see-through (50) | – | The lens's own fill, see-through. |
+
+The lens shows what is drawn before it (below it), follows edits there, and keeps its own bounds. Move it with `vector.transform` like any path. Remove it with `vector.removeLens`.