@pixerate/editor 0.129.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-Cbr9IqpJ.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-Cbr9IqpJ.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-C5aAd44p.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-BpCmUNxb.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-ClPKUB-v.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-ClPKUB-v.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-CPWcK504.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-AugT22z3.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-CIsO617e.d.ts → warp-2N9wkOkL.d.ts}

@@ -1,4 +1,4 @@
-import { B as BezierPath } from './bezier-DP4NnJp3.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';
 
 /**
@@ -345,4 +345,4 @@ declare function warpMeshEditPoints(m: WarpMesh): {
 /** The mesh's grid lines (patch borders) as cubics `[p0, p1, p2, p3]`. */
 declare function warpMeshGridCurves(m: WarpMesh): Vec2[][];
 
-export { warpPresetGrid as A, warpPresetMesh as B, type TextAlign as C, DEFAULT_AUTO_LEADING as D, DEFAULT_TEXT_STYLE as E, type LaidChar as F, TEXT_ALIGNS as G, caretAt as H, fitParagraphRuns as I, fitRuns as J, fontOf as K, type LaidFragment as L, layoutText as M, paragraphRanges as N, restyleRange as O, type ParagraphRun as P, spliceRuns as Q, styleAt as R, textIndexAt as S, type TextShaper as T, type WarpPreset as W, type TextFont as a, type TextRun as b, type ParagraphStyle as c, type TextStyle as d, type TextLayout as e, type LaidLine as f, WARP_STYLES as g, WARP_STYLE_LABELS as h, dragWarpMeshPoint as i, evalWarpMesh as j, fitWarpMesh as k, isValidWarpMesh as l, mapWarpMeshPoints as m, removeWarpMeshSplitV as n, resizeWarpMesh as o, pullWarpMesh as p, splitWarpMeshV as q, removeWarpMeshSplitU as r, splitWarpMeshU as s, identityWarpMesh as t, warpMeshControlBounds as u, warpMeshEditPoints as v, warpMeshColumns as w, warpMeshGridCurves as x, warpMeshParamAt as y, warpMeshRows as z };
+export { textIndexAt as A, warpMeshEditPoints as B, warpMeshGridCurves as C, DEFAULT_AUTO_LEADING as D, warpMeshParamAt as E, warpPresetMesh as F, fitWarpMesh as G, isValidWarpMesh as H, mapWarpMeshPoints as I, removeWarpMeshSplitU as J, removeWarpMeshSplitV as K, type LaidFragment as L, splitWarpMeshU as M, splitWarpMeshV as N, warpMeshColumns as O, type ParagraphRun as P, warpMeshControlBounds as Q, warpMeshRows as R, warpPresetGrid as S, type TextShaper as T, type WarpPreset as W, type TextFont as a, type TextRun as b, type ParagraphStyle as c, type TextStyle as d, type TextLayout as e, type TextAlign as f, DEFAULT_TEXT_STYLE as g, type LaidChar as h, type LaidLine as i, TEXT_ALIGNS as j, WARP_STYLES as k, WARP_STYLE_LABELS as l, caretAt as m, dragWarpMeshPoint as n, evalWarpMesh as o, fitParagraphRuns as p, fitRuns as q, fontOf as r, identityWarpMesh as s, layoutText as t, paragraphRanges as u, pullWarpMesh as v, resizeWarpMesh as w, restyleRange as x, spliceRuns as y, styleAt as z };

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

@@ -1,4 +1,4 @@
-import { B as BezierPath } from './bezier-CvgQiYRg.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';
 
 /**
@@ -345,4 +345,4 @@ declare function warpMeshEditPoints(m: WarpMesh): {
 /** The mesh's grid lines (patch borders) as cubics `[p0, p1, p2, p3]`. */
 declare function warpMeshGridCurves(m: WarpMesh): Vec2[][];
 
-export { warpPresetGrid as A, warpPresetMesh as B, type TextAlign as C, DEFAULT_AUTO_LEADING as D, DEFAULT_TEXT_STYLE as E, type LaidChar as F, TEXT_ALIGNS as G, caretAt as H, fitParagraphRuns as I, fitRuns as J, fontOf as K, type LaidFragment as L, layoutText as M, paragraphRanges as N, restyleRange as O, type ParagraphRun as P, spliceRuns as Q, styleAt as R, textIndexAt as S, type TextShaper as T, type WarpPreset as W, type TextFont as a, type TextRun as b, type ParagraphStyle as c, type TextStyle as d, type TextLayout as e, type LaidLine as f, WARP_STYLES as g, WARP_STYLE_LABELS as h, dragWarpMeshPoint as i, evalWarpMesh as j, fitWarpMesh as k, isValidWarpMesh as l, mapWarpMeshPoints as m, removeWarpMeshSplitV as n, resizeWarpMesh as o, pullWarpMesh as p, splitWarpMeshV as q, removeWarpMeshSplitU as r, splitWarpMeshU as s, identityWarpMesh as t, warpMeshControlBounds as u, warpMeshEditPoints as v, warpMeshColumns as w, warpMeshGridCurves as x, warpMeshParamAt as y, warpMeshRows as z };
+export { textIndexAt as A, warpMeshEditPoints as B, warpMeshGridCurves as C, DEFAULT_AUTO_LEADING as D, warpMeshParamAt as E, warpPresetMesh as F, fitWarpMesh as G, isValidWarpMesh as H, mapWarpMeshPoints as I, removeWarpMeshSplitU as J, removeWarpMeshSplitV as K, type LaidFragment as L, splitWarpMeshU as M, splitWarpMeshV as N, warpMeshColumns as O, type ParagraphRun as P, warpMeshControlBounds as Q, warpMeshRows as R, warpPresetGrid as S, type TextShaper as T, type WarpPreset as W, type TextFont as a, type TextRun as b, type ParagraphStyle as c, type TextStyle as d, type TextLayout as e, type TextAlign as f, DEFAULT_TEXT_STYLE as g, type LaidChar as h, type LaidLine as i, TEXT_ALIGNS as j, WARP_STYLES as k, WARP_STYLE_LABELS as l, caretAt as m, dragWarpMeshPoint as n, evalWarpMesh as o, fitParagraphRuns as p, fitRuns as q, fontOf as r, identityWarpMesh as s, layoutText as t, paragraphRanges as u, pullWarpMesh as v, resizeWarpMesh as w, restyleRange as x, spliceRuns as y, styleAt as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pixerate/editor",
-  "version": "0.129.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 |
@@ -343,7 +360,7 @@ contents whole while you work, without losing the mask.
 
 | Command | Use it to |
 | --- | --- |
-| `vector.addEffect` | Add a live path effect `type` (trim, roundCorners, puckerBloat, twist, zigzag, wiggle, offset, merge, repeater, envelope, contour: concentric steps blending to end colours, blockShadow: the shape swept along an angle under it, a long shadow when endOpacity fades, extrude: shaded side faces making the shape a solid, parallel or toward a vanishing point) with `params` to `ids`, at `index` in the stack (default last). Effects apply top to bottom. Returns `{ effects: [{ nodeId, effectId }] }`. |
+| `vector.addEffect` | Add a live path effect `type` (trim, roundCorners, puckerBloat, twist, zigzag, wiggle, offset, merge, repeater, envelope, contour: concentric steps blending to end colours, blockShadow: the shape swept along an angle under it, a long shadow when endOpacity fades, extrude: shaded side faces making the shape a solid, parallel or toward a vanishing point, bevel: a shaded chiselled edge inside the shape) with `params` to `ids`, at `index` in the stack (default last). Effects apply top to bottom. Returns `{ effects: [{ nodeId, effectId }] }`. |
 | `vector.updateEffect` | Change effect `effectId` on `nodeId`: `params` (merged), `enabled`, or move it to `index` (0 applies first). Returns the node's effect stack. |
 | `vector.removeEffect` | Remove effect `effectId` from `nodeId`. |
 | `vector.envelope` | Warp with a live envelope: a `preset` (arc, arcLower, arcUpper, arch, bulge, shellLower, shellUpper, flag, wave, fish, rise, fisheye, inflate, squeeze, twist) with `bend`, `horizontal`, `vertical` (percent, -100 to 100) and `orientation`; or a `mesh` of `rows` x `columns` (1 to 16, optional control `points`); or `topObject: true` (top closed path becomes the envelope), `release: true`, `expand: true`. Reapplying changes an existing envelope. |

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

@@ -113,6 +113,7 @@ default below. Lengths are in the node's own units, angles degrees, percentages
 | contour | direction `inside`, steps 4, offset 6, fillColor `#ffffff`, strokeColor null, acceleration 0, join `round`, miterLimit 4 | CorelDRAW's Contour: each shape plus `steps` concentric copies `offset` apart (`center`: inward until the shape is used up), their fill and stroke blending to the end colours (null keeps the shape's colour); inside steps draw over the shape, outside ones under it. Acceleration −100…100 holds the colour back (positive) or rushes it (negative). Use for embossed badges, topographic lines and soft glows. |
 | blockShadow | angle 45 (degrees, 0 right, 90 down), distance 20, color `#1e293b` (null: the shape's own fill), opacity 100, endOpacity 100 (%) | CorelDRAW's Block Shadow: each shape swept `distance` along `angle` as one solid shape drawn under all of them. Set endOpacity below opacity (e.g. 0) with a long distance for a flat-design long shadow. The direction is in the node's own space, so it turns with the node. Put it last in the stack so it shadows the final shapes. |
 | extrude | mode `parallel`, angle 45, depth 30, vanishingPoint {x 0, y -300} (offset from the middle), toward 30 (%), color null (the shape's own fill), lightAngle -135 (light from the top left), shading 60 (%) | CorelDRAW's Extrude: one side face per edge (curves flattened), back to front, under the shape. Parallel moves the back `depth` along `angle`; perspective pulls it `toward` percent to the vanishing point. Faces lighten as they face the light and darken facing away. Use for 3D lettering, isometric blocks and buttons; put it last in the stack. |
+| bevel | width 8, lightAngle -135 (light from the top left), shading 60 (%), color null (the shape's own paint as one colour) | CorelDRAW's Bevel: a band `width` wide inside the outline, one sloped face per edge shaded by the light, the middle flat in the shape's own paint, the stroke on top. Bounds do not change. Use for buttons, badges and chiselled lettering; combine with extrude for a bevelled solid. |
 | envelope | style `arc`, bend 50, horizontal 0, vertical 0, orientation `horizontal`, rows 2, columns 2, mesh null | Prefer `vector.envelope`. |
 
 Effects apply in stack order (index 0 first) to everything above them; effects after a repeater
@@ -160,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`.