@pixerate/editor 0.199.0 → 0.201.0

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

@@ -2,6 +2,8 @@ import { AdjustmentKind, AdjustmentLayer, AdjustmentParamsMap, Annotation, Creat
 import { type PathToSelectionOptions, type SelectionToPathOptions } from './selection/path.cjs';
 import { type MagneticEdgeOptions } from './selection/magnetic.cjs';
 import { type ObjectTarget } from './selection/segment/grabcut.cjs';
+import { type FocusAreaOptions } from './selection/segment/focus.cjs';
+import { type SkyOptions } from './selection/segment/sky.cjs';
 import { RenderOptions } from './renderer.cjs';
 import { type BlendMode } from './blend.cjs';
 import type { ImageHistogram } from './histogram.cjs';
@@ -152,6 +154,20 @@ export interface QuickSelectCommandOptions {
     /** Smoother, less blocky edges (Photoshop's Auto-Enhance). Default false. */
     enhanceEdge?: boolean;
 }
+/** Options of {@link ImageEditorController.selectFocusArea}. */
+export interface FocusAreaCommandOptions extends FocusAreaOptions {
+    /** How the area combines with the selection (default `replace`). */
+    mode?: SelectionMode;
+    /** Sample every layer (default true) or only the active pixel layer. */
+    sampleAllLayers?: boolean;
+}
+/** Options of {@link ImageEditorController.selectSky}. */
+export interface SkyCommandOptions extends SkyOptions {
+    /** How the sky combines with the selection (default `replace`). */
+    mode?: SelectionMode;
+    /** Sample every layer (default true) or only the active pixel layer. */
+    sampleAllLayers?: boolean;
+}
 /** Options of {@link ImageEditorController.selectObject}. */
 export interface SelectObjectCommandOptions {
     /** How the object combines with the selection (default `replace`). */
@@ -1540,6 +1556,25 @@ export declare class ImageEditorController {
      * Resolves to the resulting selection.
      */
     selectObject(target: ObjectTarget, options?: SelectObjectCommandOptions): Promise<SelectionMask | null>;
+    /**
+     * Select › Focus Area: selects the parts of the image that are in focus (fine detail above the
+     * image's noise), fitted to its edges, combined with the selection by `mode` as one undo step.
+     * Resolves to the selection and the noise level measured (σ of luminance in levels).
+     */
+    selectFocusArea(options?: FocusAreaCommandOptions): Promise<{
+        selection: SelectionMask | null;
+        noiseLevel: number;
+    }>;
+    /**
+     * Select › Sky: selects the sky (blue, or bright and grey when overcast; smooth; grown down from
+     * the top of the image, with patches seen through gaps), fitted to its edges, combined with the
+     * selection by `mode` as one undo step. Resolves to the selection and, when no sky was found
+     * (the selection is then unchanged), why.
+     */
+    selectSky(options?: SkyCommandOptions): Promise<{
+        selection: SelectionMask | null;
+        note?: string;
+    }>;
     /**
      * Supplies the pixels the selection tools sample (natural size RGBA), e.g. decoded in a worker
      * or in a test; `null` goes back to reading the source image. Without a canvas (Node, workers)

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

@@ -2,6 +2,8 @@ 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 FocusAreaOptions } from './selection/segment/focus.js';
+import { type SkyOptions } from './selection/segment/sky.js';
 import { RenderOptions } from './renderer.js';
 import { type BlendMode } from './blend.js';
 import type { ImageHistogram } from './histogram.js';
@@ -152,6 +154,20 @@ export interface QuickSelectCommandOptions {
     /** Smoother, less blocky edges (Photoshop's Auto-Enhance). Default false. */
     enhanceEdge?: boolean;
 }
+/** Options of {@link ImageEditorController.selectFocusArea}. */
+export interface FocusAreaCommandOptions extends FocusAreaOptions {
+    /** How the area combines with the selection (default `replace`). */
+    mode?: SelectionMode;
+    /** Sample every layer (default true) or only the active pixel layer. */
+    sampleAllLayers?: boolean;
+}
+/** Options of {@link ImageEditorController.selectSky}. */
+export interface SkyCommandOptions extends SkyOptions {
+    /** How the sky combines with the selection (default `replace`). */
+    mode?: SelectionMode;
+    /** Sample every layer (default true) or only the active pixel layer. */
+    sampleAllLayers?: boolean;
+}
 /** Options of {@link ImageEditorController.selectObject}. */
 export interface SelectObjectCommandOptions {
     /** How the object combines with the selection (default `replace`). */
@@ -1540,6 +1556,25 @@ export declare class ImageEditorController {
      * Resolves to the resulting selection.
      */
     selectObject(target: ObjectTarget, options?: SelectObjectCommandOptions): Promise<SelectionMask | null>;
+    /**
+     * Select › Focus Area: selects the parts of the image that are in focus (fine detail above the
+     * image's noise), fitted to its edges, combined with the selection by `mode` as one undo step.
+     * Resolves to the selection and the noise level measured (σ of luminance in levels).
+     */
+    selectFocusArea(options?: FocusAreaCommandOptions): Promise<{
+        selection: SelectionMask | null;
+        noiseLevel: number;
+    }>;
+    /**
+     * Select › Sky: selects the sky (blue, or bright and grey when overcast; smooth; grown down from
+     * the top of the image, with patches seen through gaps), fitted to its edges, combined with the
+     * selection by `mode` as one undo step. Resolves to the selection and, when no sky was found
+     * (the selection is then unchanged), why.
+     */
+    selectSky(options?: SkyCommandOptions): Promise<{
+        selection: SelectionMask | null;
+        note?: string;
+    }>;
     /**
      * Supplies the pixels the selection tools sample (natural size RGBA), e.g. decoded in a worker
      * or in a test; `null` goes back to reading the source image. Without a canvas (Node, workers)