@pixerate/editor 0.211.0 → 0.213.0

package/dist/image-editor/controller.d.ts

@@ -2,7 +2,7 @@ import { AdjustmentKind, AdjustmentLayer, AdjustmentParamsMap, Annotation, Creat
 import { type PathToSelectionOptions, type SelectionToPathOptions } from './selection/path.js';
 import { type MagneticEdgeOptions } from './selection/magnetic.js';
 import type { ObjectTarget } from './selection/segment/grabcut.js';
-import { type DocumentPath } from './paths.js';
+import { type DocumentPath, type PathEditTarget } from './paths.js';
 import { type SelectionJob, type SelectionJobResult, type SelectionWorkerFactory } from './selection/worker.js';
 import type { SelectionProgress } from './selection/segment/work.js';
 import type { FocusAreaOptions } from './selection/segment/focus.js';
@@ -20,7 +20,7 @@ import { type RefineEdit } from './selection/refine-edits.js';
 import { type LayerMaskProps } from './selection/layer-mask.js';
 import { type AlphaChannel } from './selection/channels.js';
 import type { AdjustmentLayerMask } from './types.js';
-import { type LayerBlendMode, type ImageLayer, type LayerFilter, type LayerTarget, type PixelLayer, type RasterMask, type SmartContents, type SmartFilter, type SmartPlacement, type LiveShape, type ShapeFillRule, type VectorMask, type ShapeOperation, type ShapePaint, type ShapeStroke, type ParagraphStyle, type TextStyle, type TextOrientation, type TypeLayer, type ImageEffectAnimation } from './layers/model.js';
+import { type LayerBlendMode, type ImageLayer, type LayerFilter, type LayerTarget, type PixelLayer, type RasterMask, type SmartContents, type SmartFilter, type SmartPlacement, type LiveShape, type ShapeComponent, type ShapeFillRule, type VectorMask, type ShapeOperation, type ShapePaint, type ShapeStroke, type ParagraphStyle, type TextStyle, type TextOrientation, type TypeLayer, type ImageEffectAnimation } from './layers/model.js';
 import { type TextLayout, type TextShaper } from './layers/text.js';
 import type { VectorSubpath } from '../vector/types.js';
 import { EffectsSlot } from '../effects/helpers.js';
@@ -479,12 +479,17 @@ export interface StrokeSelectionOptions extends Omit<FillOptions, 'useSelection'
     /** Where the band lies against the selection edge (default `outside`). */
     location?: 'inside' | 'center' | 'outside';
 }
+/** Where Content-Aware Fill puts its result. */
+export type ContentAwareFillOutput = 'current' | 'new-layer' | 'duplicate-layer';
 /** Edit › Content-Aware Fill (see `contentAwareFill`). */
 export interface ContentAwareFillOptions {
     /** The pixel layer to sample and fill (default the active layer). */
     layerId?: string;
-    /** `current` (default) paints into the layer; `new-layer` puts the fill on a new layer above it. */
-    output?: 'current' | 'new-layer';
+    /**
+     * `current` (default) paints into the layer; `new-layer` puts the fill on a new layer above it;
+     * `duplicate-layer` paints it into a copy of the layer, above it.
+     */
+    output?: ContentAwareFillOutput;
     /** How far around the selection to sample, in pixels (default its larger side, at least 32). */
     sampleRadius?: number;
     /** Random seed: the same seed gives the same fill (default 0). */
@@ -1106,6 +1111,26 @@ export declare class ImageEditorController {
     }): DocumentPath;
     /** Replaces a path's geometry (its name is kept). One undo step. */
     setPathGeometry(id: string, input: VectorMaskPathInput): DocumentPath;
+    /**
+     * What the path tools (Path Selection, Direct Selection, Pen) edit: the active path in the Paths
+     * panel, else the active layer when it is a shape, else the active layer's vector mask; null
+     * when there is none of these (the Pen then starts a new Work Path).
+     */
+    pathEditTarget(): PathEditTarget | null;
+    /** The components a path tool target holds (document pixels). Throws for a target that is gone. */
+    getPathEditComponents(target: PathEditTarget): ShapeComponent[];
+    /**
+     * Replaces a path tool target's components: one undo step, or none with `commitToHistory` false
+     * (the later moves of a drag whose first move recorded one). A component that still has its
+     * `live` shape is kept as given (drop `live` from one whose anchors changed); a shape layer keeps
+     * at least one component.
+     */
+    setPathEditComponents(target: PathEditTarget, components: readonly ShapeComponent[], commitToHistory?: boolean): void;
+    /**
+     * The Pen with no path to add to: a new Work Path from `components` (replacing the last one,
+     * unless it was saved), made the active path. One undo step. Returns the path.
+     */
+    startWorkPath(components: readonly ShapeComponent[]): DocumentPath;
     /** Renames a path; renaming the Work Path saves it (Photoshop's Save Path). One undo step. */
     renamePath(id: string, name: string): DocumentPath;
     /** Duplicates a path as a saved path. One undo step. */
@@ -1528,7 +1553,7 @@ export declare class ImageEditorController {
     contentAwareFill(options?: ContentAwareFillOptions): {
         layerId: string;
         bounds: CropBox;
-        output: 'current' | 'new-layer';
+        output: ContentAwareFillOutput;
     };
     /**
      * `contentAwareFill` with the synthesis in the selection worker when there is one, with
@@ -1540,7 +1565,7 @@ export declare class ImageEditorController {
     }): Promise<{
         layerId: string;
         bounds: CropBox;
-        output: 'current' | 'new-layer';
+        output: ContentAwareFillOutput;
     }>;
     /**
      * The fill without changing anything: the window, its pixels before and after (RGBA, the fill