@pixerate/editor 0.133.0 → 0.135.0

package/dist/image-editor/index.js

@@ -363,7 +363,7 @@ import {
   writePsd,
   xyToTempTint,
   xyToUv
-} from "../chunk-AOCFL7L7.js";
+} from "../chunk-ESIWZMMK.js";
 import {
   parseCssColor
 } from "../chunk-CTTF4KYV.js";
@@ -439,21 +439,25 @@ import {
 } from "../chunk-GX332W2C.js";
 import {
   DEFAULT_RETOUCH,
+  IDENTITY_CLONE_TRANSFORM,
   RETOUCH_SAMPLES,
   RegionPixelSource,
   RetouchDabStroke,
   SPOT_HEAL_TYPES,
   TONE_RANGES,
   TilePixelSource,
+  TransformedPixelSource,
   applyRetouchToTile,
   applyToneToDeepTile,
   bestOffset,
   boxBlurPixels,
+  cloneSamplePoint,
   contentAwareFill,
   dilateMask,
   dodgeBurn,
   dodgeBurnCurve,
   healPixels,
+  isIdentityCloneTransform,
   luma,
   maskBounds,
   membraneFill,
@@ -471,7 +475,7 @@ import {
   spotHealPixels,
   spotHealWindow,
   toneOf
-} from "../chunk-6CTZAGZ2.js";
+} from "../chunk-ILYFOJUN.js";
 import {
   BrushstrokeCache,
   brushstrokeDataUrl,
@@ -806,7 +810,7 @@ import {
   warpMeshParamAt,
   warpMeshRows,
   warpPresetMesh
-} from "../chunk-FOBB6AIO.js";
+} from "../chunk-HHTCDFZC.js";
 import "../chunk-YGJIER2R.js";
 import "../chunk-KHNZ6MOU.js";
 import {
@@ -4180,7 +4184,7 @@ var ImageEditorController = class {
       activeLayerId: null,
       activeTarget: "pixels",
       outputOpacity: 1,
-      paint: { brush: { ...DEFAULT_BRUSH }, foreground: "#000000", background: "#ffffff", paint: { type: "color", color: "#000000" }, mixer: { ...DEFAULT_MIXER }, mixerLoad: EMPTY_MIXER_LOAD, retouch: { ...DEFAULT_RETOUCH }, cloneSource: null },
+      paint: { brush: { ...DEFAULT_BRUSH }, foreground: "#000000", background: "#ffffff", paint: { type: "color", color: "#000000" }, mixer: { ...DEFAULT_MIXER }, mixerLoad: EMPTY_MIXER_LOAD, retouch: { ...DEFAULT_RETOUCH }, cloneSource: null, cloneTransform: { ...IDENTITY_CLONE_TRANSFORM } },
       fit: options.fit ?? "margin"
     };
     if (options.image instanceof Object && "width" in options.image) {
@@ -6038,7 +6042,8 @@ var ImageEditorController = class {
       mixer: options.mixer ? normalizeMixer({ ...cur.mixer, ...options.mixer }) : cur.mixer,
       mixerLoad: cur.mixerLoad,
       retouch,
-      cloneSource
+      cloneSource,
+      cloneTransform: cur.cloneTransform
     };
     this.state.paint = next;
     this.notify();
@@ -6079,6 +6084,24 @@ var ImageEditorController = class {
     this.notify();
     return source;
   }
+  /**
+   * The Clone Source panel's transform for the Clone Stamp and Healing Brush: `scaleX` / `scaleY`
+   * (factors, 0.01..10 in size; negative flips) and `rotate` (degrees, clockwise), merged into the
+   * current one; `null` resets it. View state, no undo. Returns the transform.
+   */
+  setCloneTransform(t) {
+    const cur = this.state.paint.cloneTransform;
+    const next = t ? { ...cur, ...t } : { ...IDENTITY_CLONE_TRANSFORM };
+    for (const k of ["scaleX", "scaleY"]) {
+      const v = next[k];
+      if (!Number.isFinite(v) || Math.abs(v) < 0.01 || Math.abs(v) > 10) throw new LayerOperationError(`${k} must be a scale factor between 0.01 and 10 in size (negative flips), not ${String(v)}.`);
+    }
+    if (!Number.isFinite(next.rotate)) throw new LayerOperationError("rotate must be a number of degrees.");
+    next.rotate = ((next.rotate + 180) % 360 + 360) % 360 - 180;
+    this.state.paint = { ...this.state.paint, cloneTransform: next };
+    this.notify();
+    return next;
+  }
   /** D: black foreground, white background. */
   resetPaintColors() {
     this.setPaintOptions({ foreground: "#000000", background: "#ffffff" });
@@ -6261,7 +6284,9 @@ var ImageEditorController = class {
     if (!cs) throw new LayerOperationError(`The ${tool === "clone" ? "Clone Stamp" : "Healing Brush"} needs a source point; Alt-click the canvas, call set_clone_source, or pass source { x, y }.`);
     let offset = { x: 0, y: 0 };
     let first = { x: 0, y: 0 };
-    const paint = () => ({ kind: "source", source, dx: offset.x, dy: offset.y });
+    const xf = this.state.paint.cloneTransform;
+    const transformed = isIdentityCloneTransform(xf) ? null : new TransformedPixelSource(source, (x, y) => cloneSamplePoint(xf, cs, { x: cs.x - offset.x, y: cs.y - offset.y }, x, y));
+    const paint = () => transformed ? { kind: "source", source: transformed, dx: 0, dy: 0 } : { kind: "source", source, dx: offset.x, dy: offset.y };
     return {
       kind: "coverage",
       coverage,
@@ -6275,7 +6300,7 @@ var ImageEditorController = class {
       finalPaint: tool === "heal" ? (cov) => {
         if (!cov.bounds) return null;
         const g = pad(cov.bounds, 2);
-        const src = readSourceRegion(source, g, offset.x, offset.y);
+        const src = transformed ? readSourceRegion(transformed, g) : readSourceRegion(source, g, offset.x, offset.y);
         const dst = readSourceRegion(source, g);
         return { kind: "source", source: new RegionPixelSource(g, healPixels(g.width, g.height, src, dst, covered(cov, g))), dx: 0, dy: 0 };
       } : void 0,
@@ -7088,7 +7113,10 @@ var ImageEditorController = class {
     if (s.activeTool !== "clone" && s.activeTool !== "heal") return null;
     const cs = s.paint.cloneSource;
     if (!cs) return null;
-    if (cursor && cs.offset && s.paint.retouch.aligned) return { x: cursor.x + cs.offset.x, y: cursor.y + cs.offset.y };
+    if (cursor && cs.offset && s.paint.retouch.aligned) {
+      const [x, y] = cloneSamplePoint(s.paint.cloneTransform, cs, { x: cs.x - cs.offset.x, y: cs.y - cs.offset.y }, cursor.x, cursor.y);
+      return { x, y };
+    }
     return { x: cs.x, y: cs.y };
   }
   async render(targetCanvas, options) {
@@ -10719,6 +10747,30 @@ var RETOUCH_OPTION_CONTROLS = [
   { id: "strength", label: "Strength", section: "layer", min: 0, max: 1, step: 0.01, default: 0.5, decimals: 0, track: plain2, displayScale: 100, unit: "%", tools: ["smudge", "blur", "sharpen"] },
   { id: "historySteps", label: "Steps back", section: "layer", min: 0, max: 50, step: 1, default: 0, decimals: 0, track: plain2, unit: "", tools: ["history"] }
 ];
+var CLONE_TRANSFORM_CONTROLS = [
+  { id: "width", label: "Source W", section: "layer", min: 1, max: 400, step: 1, default: 100, decimals: 0, track: plain2, unit: "%" },
+  { id: "height", label: "Source H", section: "layer", min: 1, max: 400, step: 1, default: 100, decimals: 0, track: plain2, unit: "%" },
+  { id: "angle", label: "Source angle", section: "layer", min: -180, max: 180, step: 1, default: 0, decimals: 0, track: plain2, unit: "\xB0" }
+];
+function cloneTransformView(controller) {
+  const t = controller.getState().paint.cloneTransform;
+  return {
+    width: Math.round(Math.abs(t.scaleX) * 100),
+    height: Math.round(Math.abs(t.scaleY) * 100),
+    angle: t.rotate,
+    flipH: t.scaleX < 0,
+    flipV: t.scaleY < 0,
+    identity: t.scaleX === 1 && t.scaleY === 1 && t.rotate === 0
+  };
+}
+function setCloneTransformValue(controller, id, value) {
+  const t = controller.getState().paint.cloneTransform;
+  if (id === "width") controller.setCloneTransform({ scaleX: Math.sign(t.scaleX) * (value ?? 100) / 100 });
+  else if (id === "height") controller.setCloneTransform({ scaleY: Math.sign(t.scaleY) * (value ?? 100) / 100 });
+  else if (id === "angle") controller.setCloneTransform({ rotate: value ?? 0 });
+  else if (id === "flipH") controller.setCloneTransform({ scaleX: -t.scaleX });
+  else controller.setCloneTransform({ scaleY: -t.scaleY });
+}
 var RETOUCH_CHOICES = [
   {
     id: "sample",
@@ -11526,12 +11578,12 @@ function createImageRetouchTools(controller) {
   const getOptions = {
     name: "get_retouch_options",
     title: "Get retouch options",
-    description: "Reads the retouching tools' options (aligned, sample, spotType, range, exposure, protectTones, spongeMode, vibrance, strength, historySteps) and the clone source ({x, y, offset} or null; offset is the aligned offset the last clone or heal stroke fixed: an aligned stroke samples at the brush plus offset, which the editors show as a crosshair). Call it before clone_stamp or heal_brush without a source to see where they will sample.",
+    description: "Reads the retouching tools' options (aligned, sample, spotType, range, exposure, protectTones, spongeMode, vibrance, strength, historySteps), the Clone Source transform ({scaleX, scaleY, rotate}) and the clone source ({x, y, offset} or null; offset is the aligned offset the last clone or heal stroke fixed: an aligned stroke samples at the brush plus offset, which the editors show as a crosshair). Call it before clone_stamp or heal_brush without a source to see where they will sample.",
     inputSchema: { type: "object", properties: {}, additionalProperties: false },
     annotations: { title: "Get retouch options", ...READ6 },
     handler: () => {
-      const { retouch, cloneSource } = controller.getState().paint;
-      return { options: { ...retouch }, cloneSource: cloneSource ? { ...cloneSource } : null };
+      const { retouch, cloneSource, cloneTransform } = controller.getState().paint;
+      return { options: { ...retouch }, cloneSource: cloneSource ? { ...cloneSource } : null, cloneTransform: { ...cloneTransform } };
     }
   };
   const setOptions = {
@@ -11580,7 +11632,40 @@ function createImageRetouchTools(controller) {
       return controller.setCloneSource(checkSource(controller, { x: args.x, y: args.y }));
     }
   };
-  return [cloneStamp, healBrush, spotHeal, smudge, dodge, burn, spongeTool, blurTool, sharpenTool, historyBrush, getOptions, setOptions, setSource];
+  const setTransform = {
+    name: "set_clone_transform",
+    title: "Transform the clone source",
+    description: "Photoshop's Clone Source panel: the Clone Stamp and Healing Brush lay the source scaled by `scaleX` / `scaleY` (percent, default 100; negative or the flip flags mirror it) and rotated by `rotate` degrees clockwise about the stroke's start. Merged into the current transform; reset true goes back to 100 %, 0\xB0. Use it to clone a reflection, a smaller copy or a tilted patch. View state, not an undo step. Returns the transform ({scaleX, scaleY, rotate} as factors and degrees).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        scaleX: { type: "number", description: "Width in percent of the source (1..1000; negative flips horizontally)." },
+        scaleY: { type: "number", description: "Height in percent of the source (1..1000; negative flips vertically)." },
+        rotate: { type: "number", description: "Rotation in degrees, clockwise (-180..180)." },
+        flipHorizontal: { type: "boolean", description: "Mirror the source left to right (negates the width scale; default false)." },
+        flipVertical: { type: "boolean", description: "Mirror the source top to bottom (negates the height scale; default false)." },
+        reset: { type: "boolean", description: "Back to 100 %, no flip, 0\xB0 (default false); other arguments are not allowed with it." }
+      },
+      additionalProperties: false
+    },
+    annotations: { title: "Transform the clone source", ...WRITE5, idempotentHint: false },
+    handler: (args) => {
+      if (args.reset === true) {
+        if (Object.keys(args).some((k) => k !== "reset")) throw new LayerOperationError("Give either reset true or transform values, not both.");
+        return controller.setCloneTransform(null);
+      }
+      const cur = controller.getState().paint.cloneTransform;
+      const next = {};
+      if (args.scaleX !== void 0) next.scaleX = args.scaleX / 100;
+      if (args.scaleY !== void 0) next.scaleY = args.scaleY / 100;
+      if (args.rotate !== void 0) next.rotate = args.rotate;
+      if (args.flipHorizontal === true) next.scaleX = -(next.scaleX ?? cur.scaleX);
+      if (args.flipVertical === true) next.scaleY = -(next.scaleY ?? cur.scaleY);
+      if (!Object.keys(next).length) throw new LayerOperationError("Pass scaleX, scaleY, rotate, flipHorizontal or flipVertical, or reset true.");
+      return controller.setCloneTransform(next);
+    }
+  };
+  return [cloneStamp, healBrush, spotHeal, smudge, dodge, burn, spongeTool, blurTool, sharpenTool, historyBrush, getOptions, setOptions, setSource, setTransform];
 }
 function pick(args, keys) {
   const out = {};
@@ -15003,6 +15088,7 @@ export {
   BRUSH_OPTION_CONTROLS,
   BUILTIN_PROFILES,
   BrushstrokeCache,
+  CLONE_TRANSFORM_CONTROLS,
   COLOR_MODE_OPTIONS,
   CoverageMap,
   D50,
@@ -15056,6 +15142,7 @@ export {
   HIDE,
   HISTOGRAM_BINS,
   HUE_RANGE_LABELS,
+  IDENTITY_CLONE_TRANSFORM,
   IDENTITY_MATRIX3,
   IMAGE_ADJUSTMENT_CONTROLS,
   IMAGE_CROP_PRESETS,
@@ -15190,6 +15277,7 @@ export {
   TilePixelSource,
   TiledSurface,
   TransformTooLargeError,
+  TransformedPixelSource,
   TypeToolGesture,
   U_MAX,
   VIBRANCE_GREY,
@@ -15297,7 +15385,9 @@ export {
   clampControlValue,
   clampCropToImage,
   cleanMixer,
+  cloneSamplePoint,
   cloneSourceLabel,
+  cloneTransformView,
   collectTiles,
   colorBalanceChannel,
   colorModePlanes,
@@ -15516,6 +15606,7 @@ export {
   isContentsDecoded,
   isDefaultDepthMask,
   isGradientPaint,
+  isIdentityCloneTransform,
   isIdentityTransform,
   isInterpolation,
   isLayerEffectKind,
@@ -15785,6 +15876,7 @@ export {
   serializeLayersExternal,
   serializePatterns,
   serializeSelection,
+  setCloneTransformValue,
   setControlPath,
   setLayerEffects,
   setLayerEffectsEnabled,