@pixerate/editor 0.214.0 → 0.216.0

package/dist/image-editor/layers/edge-color.d.cts

@@ -0,0 +1,27 @@
+/**
+ * Edge colour on a layer's soft edge (`LayerEdgeColor`): decontamination and despill, run over the
+ * canvas by the compositor from the layer's own pixels and its mask, so nothing is baked. The live
+ * edge cast (`ambient`) needs what is behind the layer and runs in the compositor's blend step.
+ */
+import type { LayerEdgeColor, RasterMask } from '../../raster/layers.cjs';
+/** How far (px) the old background's colour is looked for around the edge. */
+export declare const EDGE_COLOR_RADIUS = 8;
+/** True when decontamination or despill is on (they need the layer's mask). */
+export declare function hasEdgeUnmix(edge: LayerEdgeColor | undefined): boolean;
+/**
+ * A mask's coverage (0..255) over the canvas, `width × height`, for a layer at `offset`: the
+ * painted mask with its feather (density only changes how much shows, not the matte).
+ */
+export declare function maskCoverageOverCanvas(mask: RasterMask, ox: number, oy: number, width: number, height: number): Uint8ClampedArray;
+/** True when a coverage has a soft band (some pixels partly covered). */
+export declare function hasSoftBand(coverage: ArrayLike<number>): boolean;
+/**
+ * Despill: along a soft edge, takes out (by `amount`, 0..1) the part of each pixel's colour that
+ * points the way of the old background's hue (its local mean, from what is fully outside within
+ * `radius`). Luminance is kept, pixels fully in or out are unchanged, and the outer edge (more
+ * background) gets the most. It does not remove light that bounced onto the subject itself.
+ * Works in place on RGBA `rgba` with `coverage` (0..255) over the same `w × h`.
+ */
+export declare function despillEdge(rgba: Uint8ClampedArray, coverage: ArrayLike<number>, w: number, h: number, amount: number, radius?: number): void;
+/** Decontamination, then despill, of canvas RGBA `rgba` (`w × h`) in place, given the mask's coverage. */
+export declare function applyEdgeUnmix(rgba: Uint8ClampedArray, coverage: ArrayLike<number>, w: number, h: number, edge: LayerEdgeColor): void;

package/dist/image-editor/layers/edge-color.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Edge colour on a layer's soft edge (`LayerEdgeColor`): decontamination and despill, run over the
+ * canvas by the compositor from the layer's own pixels and its mask, so nothing is baked. The live
+ * edge cast (`ambient`) needs what is behind the layer and runs in the compositor's blend step.
+ */
+import type { LayerEdgeColor, RasterMask } from '../../raster/layers.js';
+/** How far (px) the old background's colour is looked for around the edge. */
+export declare const EDGE_COLOR_RADIUS = 8;
+/** True when decontamination or despill is on (they need the layer's mask). */
+export declare function hasEdgeUnmix(edge: LayerEdgeColor | undefined): boolean;
+/**
+ * A mask's coverage (0..255) over the canvas, `width × height`, for a layer at `offset`: the
+ * painted mask with its feather (density only changes how much shows, not the matte).
+ */
+export declare function maskCoverageOverCanvas(mask: RasterMask, ox: number, oy: number, width: number, height: number): Uint8ClampedArray;
+/** True when a coverage has a soft band (some pixels partly covered). */
+export declare function hasSoftBand(coverage: ArrayLike<number>): boolean;
+/**
+ * Despill: along a soft edge, takes out (by `amount`, 0..1) the part of each pixel's colour that
+ * points the way of the old background's hue (its local mean, from what is fully outside within
+ * `radius`). Luminance is kept, pixels fully in or out are unchanged, and the outer edge (more
+ * background) gets the most. It does not remove light that bounced onto the subject itself.
+ * Works in place on RGBA `rgba` with `coverage` (0..255) over the same `w × h`.
+ */
+export declare function despillEdge(rgba: Uint8ClampedArray, coverage: ArrayLike<number>, w: number, h: number, amount: number, radius?: number): void;
+/** Decontamination, then despill, of canvas RGBA `rgba` (`w × h`) in place, given the mask's coverage. */
+export declare function applyEdgeUnmix(rgba: Uint8ClampedArray, coverage: ArrayLike<number>, w: number, h: number, edge: LayerEdgeColor): void;

package/dist/image-editor/layers/serialize.d.cts

@@ -1,3 +1,12 @@
+/**
+ * Schema version 3 of the image editor document: the layer tree, with pixel layers and painted
+ * masks stored as PNG assets (cropped to their content and placed by position), plus the
+ * document-level crop, transform, output opacity, migrated blur and selection.
+ *
+ * Encoding is synchronous and exact (see `png.ts`). Each surface's encoding is memoised, so
+ * saving an unchanged layer again costs nothing.
+ */
+import type { LayerEdgeColor } from '../../raster/layers.cjs';
 import type { SerializedDocumentPath } from '../paths.cjs';
 import type { Annotation, CropBox, DepthMaskOptions, ImageTransform } from '../types.cjs';
 import type { SerializedSelection } from '../selection/mask.cjs';
@@ -36,6 +45,8 @@ interface SerializedLayerBase {
     vectorMask?: SerializedVectorMask;
     locks?: LayerLocks;
     effects?: SerializedLayerEffects;
+    /** Edge colour amounts 0..1 and the cast colour (see `LayerEdgeColor`). */
+    edge?: LayerEdgeColor;
 }
 /** A stored vector mask: its components as JSON (document pixels) and its properties. */
 export interface SerializedVectorMask {
@@ -271,6 +282,8 @@ export interface SerializeContext {
     /** Stores a smart object's contents (once per id). Without it, smart objects cannot be written. */
     addContents?(contents: SmartContents): void;
 }
+/** Stored edge colour, with amounts clamped to 0..1 (none when nothing is on). */
+export declare function readEdgeColor(raw: unknown): LayerEdgeColor | undefined;
 export declare function serializeEffects(effects: LayerEffects): SerializedLayerEffects;
 /** Reads stored effects (leniently: broken effects are dropped), or `undefined`. */
 export declare function deserializeEffects(raw: unknown): LayerEffects | undefined;

package/dist/image-editor/layers/serialize.d.ts

@@ -1,3 +1,12 @@
+/**
+ * Schema version 3 of the image editor document: the layer tree, with pixel layers and painted
+ * masks stored as PNG assets (cropped to their content and placed by position), plus the
+ * document-level crop, transform, output opacity, migrated blur and selection.
+ *
+ * Encoding is synchronous and exact (see `png.ts`). Each surface's encoding is memoised, so
+ * saving an unchanged layer again costs nothing.
+ */
+import type { LayerEdgeColor } from '../../raster/layers.js';
 import type { SerializedDocumentPath } from '../paths.js';
 import type { Annotation, CropBox, DepthMaskOptions, ImageTransform } from '../types.js';
 import type { SerializedSelection } from '../selection/mask.js';
@@ -36,6 +45,8 @@ interface SerializedLayerBase {
     vectorMask?: SerializedVectorMask;
     locks?: LayerLocks;
     effects?: SerializedLayerEffects;
+    /** Edge colour amounts 0..1 and the cast colour (see `LayerEdgeColor`). */
+    edge?: LayerEdgeColor;
 }
 /** A stored vector mask: its components as JSON (document pixels) and its properties. */
 export interface SerializedVectorMask {
@@ -271,6 +282,8 @@ export interface SerializeContext {
     /** Stores a smart object's contents (once per id). Without it, smart objects cannot be written. */
     addContents?(contents: SmartContents): void;
 }
+/** Stored edge colour, with amounts clamped to 0..1 (none when nothing is on). */
+export declare function readEdgeColor(raw: unknown): LayerEdgeColor | undefined;
 export declare function serializeEffects(effects: LayerEffects): SerializedLayerEffects;
 /** Reads stored effects (leniently: broken effects are dropped), or `undefined`. */
 export declare function deserializeEffects(raw: unknown): LayerEffects | undefined;

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

@@ -18,3 +18,4 @@ export * from './refine-edits.cjs';
 export * from './select-and-mask.cjs';
 export * from './worker.cjs';
 export * from './inspect.cjs';
+export * from './uncertainty.cjs';

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

@@ -18,3 +18,4 @@ export * from './refine-edits.js';
 export * from './select-and-mask.js';
 export * from './worker.js';
 export * from './inspect.js';
+export * from './uncertainty.js';

package/dist/image-editor/selection/inspect.d.cts

@@ -68,3 +68,12 @@ export declare function inspectMaskEdge(mask: SelectionMask, image: PixelBuffer
     x: number;
     y: number;
 }, options?: InspectMaskEdgeOptions): MaskEdgeReport;
+/**
+ * A cached sampler of the image's edge strength at document pixels: the Sobel magnitude of
+ * alpha-weighted R, G and B, the largest of the three, as a fraction of a full 0–255 step.
+ * Reads clamp at the image's edges. `W` is the canvas width (for the cache key).
+ */
+export declare function createGradientSampler(image: PixelBuffer & {
+    x: number;
+    y: number;
+}, W: number): (x: number, y: number) => number;

package/dist/image-editor/selection/inspect.d.ts

@@ -68,3 +68,12 @@ export declare function inspectMaskEdge(mask: SelectionMask, image: PixelBuffer
     x: number;
     y: number;
 }, options?: InspectMaskEdgeOptions): MaskEdgeReport;
+/**
+ * A cached sampler of the image's edge strength at document pixels: the Sobel magnitude of
+ * alpha-weighted R, G and B, the largest of the three, as a fraction of a full 0–255 step.
+ * Reads clamp at the image's edges. `W` is the canvas width (for the cache key).
+ */
+export declare function createGradientSampler(image: PixelBuffer & {
+    x: number;
+    y: number;
+}, W: number): (x: number, y: number) => number;

package/dist/image-editor/selection/uncertainty.d.cts

@@ -0,0 +1,40 @@
+/**
+ * Where a selection is unsure of itself (a trimap's unknown band): the stretches of its edge that
+ * run where the image shows no edge, widened into a band. The smart selection tools report these
+ * as `uncertainRegions`, so an agent looks at and refines only them (`refine_selection` `regions`).
+ */
+import type { CropBox } from '../types.cjs';
+import { type PixelBuffer, type SelectionMask } from './mask.cjs';
+export interface UncertainRegion {
+    bounds: CropBox;
+    /** Pixels in the unknown band. */
+    area: number;
+    /** 0–1: how strongly the image backs the edge here (low = unsure). */
+    confidence: number;
+}
+export interface SelectionUncertainty {
+    /** The unknown band over the canvas (255 = unsure). */
+    unknown: SelectionMask;
+    /** The least confident regions first (at most `maxRegions`). */
+    regions: UncertainRegion[];
+    /** How many regions there are in all. */
+    count: number;
+    /** 0–1 over the whole edge. */
+    confidence: number;
+}
+export interface SelectionUncertaintyOptions {
+    /** Half-width of the unknown band in px (default 1/200 of the shorter side, at least 2). */
+    band?: number;
+    /** Regions smaller than this many pixels are left out (default 16). */
+    minArea?: number;
+    /** At most this many regions are listed (default 20). */
+    maxRegions?: number;
+}
+/**
+ * The unknown band of `mask` against `image` (RGBA, straight alpha, at `image.x`, `image.y` in
+ * document pixels). An empty selection has no band.
+ */
+export declare function selectionUncertainty(mask: SelectionMask, image: PixelBuffer & {
+    x: number;
+    y: number;
+}, options?: SelectionUncertaintyOptions): SelectionUncertainty;

package/dist/image-editor/selection/uncertainty.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Where a selection is unsure of itself (a trimap's unknown band): the stretches of its edge that
+ * run where the image shows no edge, widened into a band. The smart selection tools report these
+ * as `uncertainRegions`, so an agent looks at and refines only them (`refine_selection` `regions`).
+ */
+import type { CropBox } from '../types.js';
+import { type PixelBuffer, type SelectionMask } from './mask.js';
+export interface UncertainRegion {
+    bounds: CropBox;
+    /** Pixels in the unknown band. */
+    area: number;
+    /** 0–1: how strongly the image backs the edge here (low = unsure). */
+    confidence: number;
+}
+export interface SelectionUncertainty {
+    /** The unknown band over the canvas (255 = unsure). */
+    unknown: SelectionMask;
+    /** The least confident regions first (at most `maxRegions`). */
+    regions: UncertainRegion[];
+    /** How many regions there are in all. */
+    count: number;
+    /** 0–1 over the whole edge. */
+    confidence: number;
+}
+export interface SelectionUncertaintyOptions {
+    /** Half-width of the unknown band in px (default 1/200 of the shorter side, at least 2). */
+    band?: number;
+    /** Regions smaller than this many pixels are left out (default 16). */
+    minArea?: number;
+    /** At most this many regions are listed (default 20). */
+    maxRegions?: number;
+}
+/**
+ * The unknown band of `mask` against `image` (RGBA, straight alpha, at `image.x`, `image.y` in
+ * document pixels). An empty selection has no band.
+ */
+export declare function selectionUncertainty(mask: SelectionMask, image: PixelBuffer & {
+    x: number;
+    y: number;
+}, options?: SelectionUncertaintyOptions): SelectionUncertainty;

package/dist/image-editor/selection-worker.cjs

@@ -1,15 +1,15 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkL52VMQZScjs = require('../chunk-L52VMQZS.cjs');
-require('../chunk-QYLWG22N.cjs');
+var _chunkUC3PWFM3cjs = require('../chunk-UC3PWFM3.cjs');
+require('../chunk-SS53NNZO.cjs');
 require('../chunk-K6PXS6DO.cjs');
 require('../chunk-MQDIP4CF.cjs');
 require('../chunk-474IQG74.cjs');
 
 // src/image-editor/selection-worker.ts
 if (typeof self !== "undefined" && typeof window === "undefined" && typeof self.postMessage === "function") {
-  _chunkL52VMQZScjs.startSelectionWorker.call(void 0, self);
+  _chunkUC3PWFM3cjs.startSelectionWorker.call(void 0, self);
 }
 
 
-exports.startSelectionWorker = _chunkL52VMQZScjs.startSelectionWorker;
+exports.startSelectionWorker = _chunkUC3PWFM3cjs.startSelectionWorker;

package/dist/image-editor/selection-worker.js

@@ -1,7 +1,7 @@
 import {
   startSelectionWorker
-} from "../chunk-LQ5SALHK.js";
-import "../chunk-L3G23N5Y.js";
+} from "../chunk-U7C655AM.js";
+import "../chunk-ZNA3IQZF.js";
 import "../chunk-ZIF4UJJ6.js";
 import "../chunk-XI2NV5U7.js";
 import "../chunk-HVVR5PZW.js";