@pixerate/editor 0.199.0 → 0.201.0

package/dist/image-editor/selection/segment/focus.d.cts

@@ -0,0 +1,22 @@
+/**
+ * Select › Focus Area: the parts of the image that are in focus. Fine detail survives only where
+ * the lens was focused, so a sharpness map (the Laplacian's local energy, less a floor for the
+ * image's noise) is split into in and out of focus, closed over smooth areas inside sharp ones,
+ * and fitted to the image's edges with a guided filter.
+ */
+import type { PixelBuffer, SelectionMask } from '../mask.cjs';
+export interface FocusAreaOptions {
+    /** In-Focus Range 0..100 (default 50): higher takes in less sharp areas too. */
+    range?: number;
+    /** Image Noise Level 0..100 (default 0): raise it when grain is selected as detail. */
+    noise?: number;
+    /** Soften the edge over this many natural pixels (default 4; 0 for a hard edge). */
+    softness?: number;
+}
+export interface FocusAreaResult {
+    selection: SelectionMask;
+    /** The noise measured in the image (σ of luminance, in levels of 255). */
+    noiseLevel: number;
+}
+/** The in-focus areas of `pixels` as a selection of the whole image. */
+export declare function focusArea(pixels: PixelBuffer, options?: FocusAreaOptions): FocusAreaResult;

package/dist/image-editor/selection/segment/focus.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Select › Focus Area: the parts of the image that are in focus. Fine detail survives only where
+ * the lens was focused, so a sharpness map (the Laplacian's local energy, less a floor for the
+ * image's noise) is split into in and out of focus, closed over smooth areas inside sharp ones,
+ * and fitted to the image's edges with a guided filter.
+ */
+import type { PixelBuffer, SelectionMask } from '../mask.js';
+export interface FocusAreaOptions {
+    /** In-Focus Range 0..100 (default 50): higher takes in less sharp areas too. */
+    range?: number;
+    /** Image Noise Level 0..100 (default 0): raise it when grain is selected as detail. */
+    noise?: number;
+    /** Soften the edge over this many natural pixels (default 4; 0 for a hard edge). */
+    softness?: number;
+}
+export interface FocusAreaResult {
+    selection: SelectionMask;
+    /** The noise measured in the image (σ of luminance, in levels of 255). */
+    noiseLevel: number;
+}
+/** The in-focus areas of `pixels` as a selection of the whole image. */
+export declare function focusArea(pixels: PixelBuffer, options?: FocusAreaOptions): FocusAreaResult;

package/dist/image-editor/selection/segment/guided.d.cts

@@ -0,0 +1,13 @@
+/**
+ * Helpers for the masks Focus Area and Select Sky compute on the reduced copy: its luminance and
+ * colour planes (the guide for `guidedFilterColor`, which fits a rough mask to the image's edges)
+ * and scaling a soft mask back up to the image.
+ */
+import { type SelectionMask } from '../mask.cjs';
+import type { WorkImage } from './work.cjs';
+/** The work image as three planes of 0..1 values, the guide `guidedFilterColor` takes. */
+export declare function workPlanes(work: WorkImage): [Float32Array, Float32Array, Float32Array];
+/** The work image's luminance, 0..1. */
+export declare function workLuma(work: WorkImage): Float32Array;
+/** A soft mask over the whole work image (0..1), scaled up bilinearly to a selection of the image. */
+export declare function softMaskToSelection(work: WorkImage, mask: Float32Array): SelectionMask;

package/dist/image-editor/selection/segment/guided.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Helpers for the masks Focus Area and Select Sky compute on the reduced copy: its luminance and
+ * colour planes (the guide for `guidedFilterColor`, which fits a rough mask to the image's edges)
+ * and scaling a soft mask back up to the image.
+ */
+import { type SelectionMask } from '../mask.js';
+import type { WorkImage } from './work.js';
+/** The work image as three planes of 0..1 values, the guide `guidedFilterColor` takes. */
+export declare function workPlanes(work: WorkImage): [Float32Array, Float32Array, Float32Array];
+/** The work image's luminance, 0..1. */
+export declare function workLuma(work: WorkImage): Float32Array;
+/** A soft mask over the whole work image (0..1), scaled up bilinearly to a selection of the image. */
+export declare function softMaskToSelection(work: WorkImage, mask: Float32Array): SelectionMask;

package/dist/image-editor/selection/segment/index.d.cts

@@ -3,3 +3,6 @@ export * from './work.cjs';
 export * from './quick.cjs';
 export * from './grabcut.cjs';
 export * from './subject.cjs';
+export * from './guided.cjs';
+export * from './focus.cjs';
+export * from './sky.cjs';

package/dist/image-editor/selection/segment/index.d.ts

@@ -3,3 +3,6 @@ export * from './work.js';
 export * from './quick.js';
 export * from './grabcut.js';
 export * from './subject.js';
+export * from './guided.js';
+export * from './focus.js';
+export * from './sky.js';

package/dist/image-editor/selection/segment/sky.d.cts

@@ -0,0 +1,21 @@
+/**
+ * Select › Sky without a segmentation model. Sky is smooth, sits at the top of the frame, and is
+ * blue, or bright and grey when overcast. Each pixel gets a score from those three cues; the sky
+ * is grown down from the top rows through high-scoring pixels; patches of the same colour seen
+ * through gaps (between branches, under a bridge) are added; and the edge is fitted to the image
+ * with the colour guided filter.
+ */
+import { type PixelBuffer, type SelectionMask } from '../mask.cjs';
+export interface SkyOptions {
+    /** 0..100 (default 50): higher takes in less sky-like pixels (haze, a sunset glow). */
+    threshold?: number;
+    /** Soften the edge over this many natural pixels (default 4; 0 for a hard edge). */
+    softness?: number;
+}
+export interface FoundSky {
+    selection: SelectionMask;
+    /** Why nothing was selected, when nothing was. */
+    reason?: string;
+}
+/** The sky in `pixels`, as a selection of the whole image (empty, with a reason, when there is none). */
+export declare function findSky(pixels: PixelBuffer, options?: SkyOptions): FoundSky;

package/dist/image-editor/selection/segment/sky.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Select › Sky without a segmentation model. Sky is smooth, sits at the top of the frame, and is
+ * blue, or bright and grey when overcast. Each pixel gets a score from those three cues; the sky
+ * is grown down from the top rows through high-scoring pixels; patches of the same colour seen
+ * through gaps (between branches, under a bridge) are added; and the edge is fitted to the image
+ * with the colour guided filter.
+ */
+import { type PixelBuffer, type SelectionMask } from '../mask.js';
+export interface SkyOptions {
+    /** 0..100 (default 50): higher takes in less sky-like pixels (haze, a sunset glow). */
+    threshold?: number;
+    /** Soften the edge over this many natural pixels (default 4; 0 for a hard edge). */
+    softness?: number;
+}
+export interface FoundSky {
+    selection: SelectionMask;
+    /** Why nothing was selected, when nothing was. */
+    reason?: string;
+}
+/** The sky in `pixels`, as a selection of the whole image (empty, with a reason, when there is none). */
+export declare function findSky(pixels: PixelBuffer, options?: SkyOptions): FoundSky;

package/dist/image-editor/selection/segment/work.d.cts

@@ -1,6 +1,6 @@
 /**
- * The reduced copy of the image the graph segmentations (Quick Selection, Object Selection) work
- * on, and scaling their result back up to the image with an anti-aliased edge.
+ * The reduced copy of the image the segmentations (Quick, Object and Subject Selection, Focus
+ * Area) work on, and scaling their result back up to the image.
  */
 import { type PixelBuffer, type SelectionMask } from '../mask.cjs';
 /** The reduced image the segmentations work on (sRGB, 0..255 per channel). */

package/dist/image-editor/selection/segment/work.d.ts

@@ -1,6 +1,6 @@
 /**
- * The reduced copy of the image the graph segmentations (Quick Selection, Object Selection) work
- * on, and scaling their result back up to the image with an anti-aliased edge.
+ * The reduced copy of the image the segmentations (Quick, Object and Subject Selection, Focus
+ * Area) work on, and scaling their result back up to the image.
  */
 import { type PixelBuffer, type SelectionMask } from '../mask.js';
 /** The reduced image the segmentations work on (sRGB, 0..255 per channel). */

package/dist/image-editor/selection/tool-options.d.cts

@@ -47,6 +47,12 @@ export interface SelectionToolOptions {
     objectSampleAll?: boolean;
     /** Object Selection: smoother, less blocky edges (Auto-Enhance; default false). */
     objectEnhance?: boolean;
+    /** Focus Area: In-Focus Range 0..100 (default 50). */
+    focusRange?: number;
+    /** Focus Area: Image Noise Level 0..100 (default 0). */
+    focusNoise?: number;
+    /** Focus Area: soften the edge over this many pixels (default 4). */
+    focusSoftness?: number;
     /** Type Mask: the text to select (default "Type"). A click places its first baseline. */
     typeText?: string;
     /** Type Mask: font size in px (default 72). */

package/dist/image-editor/selection/tool-options.d.ts

@@ -47,6 +47,12 @@ export interface SelectionToolOptions {
     objectSampleAll?: boolean;
     /** Object Selection: smoother, less blocky edges (Auto-Enhance; default false). */
     objectEnhance?: boolean;
+    /** Focus Area: In-Focus Range 0..100 (default 50). */
+    focusRange?: number;
+    /** Focus Area: Image Noise Level 0..100 (default 0). */
+    focusNoise?: number;
+    /** Focus Area: soften the edge over this many pixels (default 4). */
+    focusSoftness?: number;
     /** Type Mask: the text to select (default "Type"). A click places its first baseline. */
     typeText?: string;
     /** Type Mask: font size in px (default 72). */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pixerate/editor",
-  "version": "0.199.0",
+  "version": "0.201.0",
   "description": "UI-agnostic rich text and media editing core library",
   "author": "Pixerate",
   "license": "MIT",

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

@@ -254,6 +254,8 @@ in the source frame at the document's bit depth, colour mode and profile. Read
 | `select_line` | Single row or column marquee: `orientation` `row` (at y) or `column` (at x), `position` in natural px, `mode`. A 1 px line across the image. Returns the summary. |
 | `quick_select` | Quick Selection: `strokes` (brush paths of `{x, y}`), `size` (diameter, default 30), `mode`, `sampleAllLayers`, `enhanceEdge`. Each stroke grows out to its region's edges; with `replace` the first replaces and the rest add. Paint inside the area, then check and fix with `add` / `subtract` strokes. Returns the summary. |
 | `select_object` | Object Selection (GrabCut): `rect` (a box around the object) or `point` (on it), `mode`, `sampleAllLayers`, `enhanceEdge`. Outside the box is background. Make the box a little larger than the object. Returns the summary. |
+| `select_focus_area` | Select › Focus Area: the in-focus (sharp) parts, edge fitted to the image. `range` 0..100 (higher takes in softer areas), `noise` 0..100 (raise when grain is selected), `softness` px, `mode`. Returns the summary and `noiseLevel`. |
+| `select_sky` | Select › Sky: the sky (blue or overcast, from the top down, with patches through gaps), edge fitted to the skyline. `threshold` 0..100 (higher takes in haze), `softness` px, `mode`. Returns the summary, and `note` when none was found. |
 | `select_polygon` | The lasso: `points` (at least 3 `{x, y}` along the outline, closed automatically), `mode`, `feather`, `antiAlias`; `snapToEdges: {width, contrast}` makes it the Magnetic Lasso (points snap to edges, the outline follows them). Trace a subject's contour, not its box. Returns the summary (plus `outlinePoints` when snapped). |
 | `magic_wand` | Select similar colour from `x`, `y`: `tolerance` 0..255 (default 32), `contiguous` (default true), `distance` `rgb` or `perceptual`, `sampleMerged`, `sample` (`composite` or `active-layer`), `mode`, `feather`. For flat backdrops and solid colours. Returns the summary. |
 | `select_color_range` | Color Range, soft: `samples` (`[{color, x?, y?}]`) or a `preset` (reds … magentas, highlights, midtones, shadows, skinTones); `fuzziness` (samples 0..200, default 40; tone presets' falloff, default 20), `localized` px radius around positioned samples, `invert`, `sample`, `mode`, `feather`. Returns the summary. |

package/skills/pixerate-image-selection-masking/SKILL.md

@@ -99,6 +99,8 @@ This skill is the method. `pixerate-image-editor` has the full tool reference.
 | One object among others, where you can box it (a product on a table, a person in a group) | `select_object` with a `rect` a little larger than the object on every side; then `quick_select` add / subtract strokes for what it missed |
 | A subject with a clear outline (product, person, animal) | `select_subject` (with a host model, by description; without one it takes whatever stands out most, so check `method` and the result); else `select_object` around it, or `select_polygon` with `snapToEdges` (12–30 points within `width` of the edge), then `refine_selection` |
 | An area or subject that differs from its surroundings (a shirt, a sky, a car) | `quick_select` with strokes painted inside it, away from the edge (`size` a fraction of its width); `add` / `subtract` strokes where it fell short or leaked |
+| The sky (to replace, recolour, or to leave out with `invert_selection`) | `select_sky`; raise `threshold` for haze or a sunset glow, lower it if pale buildings come in |
+| A sharp subject on a blurred background (shallow depth of field) | `select_focus_area`; raise `range` if parts of the subject are missing, `noise` if grainy background comes in |
 | A low-contrast or busy outline the edges don't follow | `select_polygon` without `snapToEdges`, along the contour (20–60 points) |
 | Flat backdrop or solid colour (studio white, green screen, sky without clouds) | `magic_wand` on the backdrop (`tolerance` 20–40; `distance: "perceptual"` for gradients), then `invert_selection` |
 | A colour spread across the image (all the reds, a dress) | `select_color_range` with `samples` (several picks) or a hue `preset`; `localized` to keep one area |
@@ -117,8 +119,8 @@ This skill is the method. `pixerate-image-editor` has the full tool reference.
   Add the new background with `add_pixel_layer` and move it under the cutout (`move_layer`).
   `render_preview` and look for a halo; if there is one, load the copy's pixels back as a
   selection, `shrink` 1 px, and mask.
-- **Replace the sky:** `magic_wand` or `select_color_range` `preset: "blues"` on the sky,
-  `add` missed patches, `refine_selection` radius 8–16 along the horizon and trees, then
+- **Replace the sky:** `select_sky` (or `magic_wand` / `select_color_range` `preset: "blues"`
+  if it finds none), `add` missed patches, `refine_selection` radius 8–16 along the horizon and trees, then
   `add_layer_mask` on the new sky layer. Match it with a clipped curves layer (`clipped: true`).
 - **Adjust only part of an image:** select, then `apply_selection_as_mask` with `kind` and
   `params`, and `feather` in proportion to the image (a few px for objects, 50–200 px for
@@ -203,6 +205,8 @@ This skill is the method. `pixerate-image-editor` has the full tool reference.
 - `select_polygon`: the lasso, along a contour; with `snapToEdges`, the Magnetic Lasso
 - `quick_select`: brush strokes that grow out to the region's edges
 - `select_object`: the object in a box or under a point
+- `select_focus_area`: what is in focus
+- `select_sky`: the sky
 - `select_line`: a single row or column
 - `select_layer_transparency`: a layer's own pixels
 - `grow_selection`, `select_similar`: add similar colour, connected or anywhere