@pixerate/editor 0.213.0 → 0.215.0

package/dist/raster/compositor.d.ts

@@ -29,7 +29,7 @@ import { type BlendMode } from './blend.js';
 import { type GlobalLight, type LayerEffects } from './effects/model.js';
 import { type EffectPattern } from './effects/patterns.js';
 import { type EffectCompositeInput } from './effects/render.js';
-import type { RasterMask, RasterNode } from './layers.js';
+import type { RasterMask, RasterNode, LayerEdgeColor } from './layers.js';
 import { type PixelSurface, type RasterRect, type TileKey, type TiledSurface } from './surface.js';
 /** What the compositor needs from its host besides the layers. */
 export interface RasterSources {
@@ -61,9 +61,18 @@ export interface CompositorLayer extends RasterNode {
     fillOpacity?: number;
     /** Layer effects. */
     effects?: LayerEffects;
+    /** Edge colour; the engine applies `ambient` (the profile's pixel filters handle the rest). */
+    edge?: LayerEdgeColor;
     /** Groups. */
     children?: readonly CompositorLayer[];
 }
+/**
+ * Live edge cast (`LayerEdgeColor.ambient`): pulls straight RGBA `content` toward `below` (the
+ * composite behind it, same size) or a fixed colour, by `amount × (1 − α)` where α is the content's
+ * alpha times `coverage` (its mask). Opaque and invisible pixels are unchanged. `max` is 255 for
+ * bytes or 1 for float samples; `color` is in the same units.
+ */
+export declare function applyEdgeAmbient(content: Uint8ClampedArray | Float32Array, below: ArrayLike<number>, coverage: ArrayLike<number> | null, amount: number, color: readonly [number, number, number] | null, max: number): void;
 /** A pixel layer's filters as the engine runs them. */
 export interface PixelFilterSpec {
     /** Identifies the settings (part of the cache key). */

package/dist/raster/deep-compositor.d.cts

@@ -17,7 +17,7 @@
  *   each is rendered alone at 8 bits, converted, and blended in float with its blend mode and
  *   opacity.
  */
-import type { CompositorLayer, CompositorProfile, RasterCompositor, RasterSources } from './compositor.cjs';
+import { type CompositorLayer, type CompositorProfile, type RasterCompositor, type RasterSources } from './compositor.cjs';
 import type { RasterRect } from './surface.cjs';
 /** Float hooks of an editor's own layer kinds (see `CompositorProfile`). */
 export interface DeepCompositorProfile<L extends CompositorLayer, S extends RasterSources> {

package/dist/raster/deep-compositor.d.ts

@@ -17,7 +17,7 @@
  *   each is rendered alone at 8 bits, converted, and blended in float with its blend mode and
  *   opacity.
  */
-import type { CompositorLayer, CompositorProfile, RasterCompositor, RasterSources } from './compositor.js';
+import { type CompositorLayer, type CompositorProfile, type RasterCompositor, type RasterSources } from './compositor.js';
 import type { RasterRect } from './surface.js';
 /** Float hooks of an editor's own layer kinds (see `CompositorProfile`). */
 export interface DeepCompositorProfile<L extends CompositorLayer, S extends RasterSources> {

package/dist/raster/index.cjs

@@ -59,7 +59,8 @@
 
 
 
-var _chunkUOGKSVRQcjs = require('../chunk-UOGKSVRQ.cjs');
+
+var _chunkB46UQUDCcjs = require('../chunk-B46UQUDC.cjs');
 require('../chunk-QT26RHKK.cjs');
 
 
@@ -514,4 +515,5 @@ function drawSurfaceToViewport(ctx, surface, mapping, view, options) {
 
 
 
-exports.BIT_DEPTHS = _chunkOLNIPTB3cjs.BIT_DEPTHS; exports.BLEND_MODES = _chunkOLNIPTB3cjs.BLEND_MODES; exports.CURVE_LUT_SIZE = _chunkUOGKSVRQcjs.CURVE_LUT_SIZE; exports.DEFAULT_GLOBAL_LIGHT = _chunkUOGKSVRQcjs.DEFAULT_GLOBAL_LIGHT; exports.DIRECT_GAUSSIAN_MAX_SIGMA = _chunkK6PXS6DOcjs.DIRECT_GAUSSIAN_MAX_SIGMA; exports.DeepCompositor = _chunkUOGKSVRQcjs.DeepCompositor; exports.INTERPOLATIONS = _chunkUOGKSVRQcjs.INTERPOLATIONS; exports.LAYER_EFFECT_KINDS = _chunkUOGKSVRQcjs.LAYER_EFFECT_KINDS; exports.LayerEffectError = _chunkUOGKSVRQcjs.LayerEffectError; exports.MAX_EFFECT_REACH = _chunkUOGKSVRQcjs.MAX_EFFECT_REACH; exports.MAX_TRANSFORM_PIXELS = _chunkUOGKSVRQcjs.MAX_TRANSFORM_PIXELS; exports.PAINTERLY_BLEND_MODES = _chunkOLNIPTB3cjs.PAINTERLY_BLEND_MODES; exports.PatternPlacement = _chunkUOGKSVRQcjs.PatternPlacement; exports.PatternTile = _chunkUOGKSVRQcjs.PatternTile; exports.RasterCompositor = _chunkUOGKSVRQcjs.RasterCompositor; exports.SHADOW_AMBIENT = _chunkOLNIPTB3cjs.SHADOW_AMBIENT; exports.STROKE_CHAMFER_MAX = _chunkUOGKSVRQcjs.STROKE_CHAMFER_MAX; exports.SurfaceDraft = _chunk474IQG74cjs.SurfaceDraft; exports.SurfaceViewportRenderer = SurfaceViewportRenderer; exports.TILE = _chunk474IQG74cjs.TILE; exports.TILE_SHIFT = _chunk474IQG74cjs.TILE_SHIFT; exports.TiledSurface = _chunk474IQG74cjs.TiledSurface; exports.TransformTooLargeError = _chunkUOGKSVRQcjs.TransformTooLargeError; exports.ZlibError = _chunkXFM3OCHUcjs.ZlibError; exports.activeEffectItems = _chunkUOGKSVRQcjs.activeEffectItems; exports.adler32 = _chunkXFM3OCHUcjs.adler32; exports.base64ToBytes = _chunkOLNIPTB3cjs.base64ToBytes; exports.blendChannel = _chunkOLNIPTB3cjs.blendChannel; exports.blendImageData = _chunkOLNIPTB3cjs.blendImageData; exports.blendLum = _chunkOLNIPTB3cjs.blendLum; exports.blendPixel = _chunkOLNIPTB3cjs.blendPixel; exports.blendRgb = _chunkOLNIPTB3cjs.blendRgb; exports.blendTile = _chunkUOGKSVRQcjs.blendTile; exports.buildEffectMaps = _chunkUOGKSVRQcjs.buildEffectMaps; exports.builtinPattern = _chunkUOGKSVRQcjs.builtinPattern; exports.builtinPatternIds = _chunkUOGKSVRQcjs.builtinPatternIds; exports.bytesToBase64 = _chunkOLNIPTB3cjs.bytesToBase64; exports.canvasCompositeOperation = _chunkOLNIPTB3cjs.canvasCompositeOperation; exports.changedTiles = _chunkUOGKSVRQcjs.changedTiles; exports.collectTiles = _chunk474IQG74cjs.collectTiles; exports.compositeLayerEffects = _chunkUOGKSVRQcjs.compositeLayerEffects; exports.compositeSurfaceOver = _chunkUOGKSVRQcjs.compositeSurfaceOver; exports.contentBounds = _chunk474IQG74cjs.contentBounds; exports.contourLut = _chunkUOGKSVRQcjs.contourLut; exports.convertSurfaceDepth = _chunkOLNIPTB3cjs.convertSurfaceDepth; exports.curveLut = _chunkUOGKSVRQcjs.curveLut; exports.decodePng = _chunkOLNIPTB3cjs.decodePng; exports.deepBytes = _chunkOLNIPTB3cjs.deepBytes; exports.deepTile = _chunkOLNIPTB3cjs.deepTile; exports.defaultEffectGradient = _chunkUOGKSVRQcjs.defaultEffectGradient; exports.defaultLayerEffect = _chunkUOGKSVRQcjs.defaultLayerEffect; exports.deflate = _chunkXFM3OCHUcjs.deflate; exports.deflateRaw = _chunkXFM3OCHUcjs.deflateRaw; exports.depthOf = _chunkOLNIPTB3cjs.depthOf; exports.drawSurfaceToViewport = drawSurfaceToViewport; exports.effectColorHex = _chunkUOGKSVRQcjs.effectColorHex; exports.effectFillColors = _chunkUOGKSVRQcjs.effectFillColors; exports.effectReach = _chunkUOGKSVRQcjs.effectReach; exports.effectsAreLocal = _chunkUOGKSVRQcjs.effectsAreLocal; exports.effectsFingerprint = _chunkUOGKSVRQcjs.effectsFingerprint; exports.effectsMargin = _chunkUOGKSVRQcjs.effectsMargin; exports.effectsScale = _chunkUOGKSVRQcjs.effectsScale; exports.emptySurface = _chunk474IQG74cjs.emptySurface; exports.encodePng = _chunkOLNIPTB3cjs.encodePng; exports.fillRect = _chunk474IQG74cjs.fillRect; exports.findLayer = _chunkUOGKSVRQcjs.findLayer; exports.finishTile = _chunk474IQG74cjs.finishTile; exports.flattenLayers = _chunkUOGKSVRQcjs.flattenLayers; exports.gaussianBlur = _chunkK6PXS6DOcjs.gaussianBlur; exports.gradientT = _chunkUOGKSVRQcjs.gradientT; exports.hasActiveEffects = _chunkUOGKSVRQcjs.hasActiveEffects; exports.hashNoise = _chunkUOGKSVRQcjs.hashNoise; exports.inflate = _chunkXFM3OCHUcjs.inflate; exports.inflateRaw = _chunkXFM3OCHUcjs.inflateRaw; exports.insertLayer = _chunkUOGKSVRQcjs.insertLayer; exports.isBitDepth = _chunkOLNIPTB3cjs.isBitDepth; exports.isBlendMode = _chunkOLNIPTB3cjs.isBlendMode; exports.isInterpolation = _chunkUOGKSVRQcjs.isInterpolation; exports.isLayerEffectKind = _chunkUOGKSVRQcjs.isLayerEffectKind; exports.isLayerLocked = _chunkUOGKSVRQcjs.isLayerLocked; exports.isPainterlyBlendMode = _chunkOLNIPTB3cjs.isPainterlyBlendMode; exports.isPng = _chunkOLNIPTB3cjs.isPng; exports.isSeparableBlendMode = _chunkOLNIPTB3cjs.isSeparableBlendMode; exports.keepDeepSamples = _chunkOLNIPTB3cjs.keepDeepSamples; exports.keysWeight = _chunkUOGKSVRQcjs.keysWeight; exports.layerEffectFields = _chunkUOGKSVRQcjs.layerEffectFields; exports.layerEffectLabel = _chunkUOGKSVRQcjs.layerEffectLabel; exports.mapLayer = _chunkUOGKSVRQcjs.mapLayer; exports.mergeLayerEffect = _chunkUOGKSVRQcjs.mergeLayerEffect; exports.mixPigment8 = _chunkOLNIPTB3cjs.mixPigment8; exports.mixPigmentRgb = _chunkOLNIPTB3cjs.mixPigmentRgb; exports.newEffectId = _chunkUOGKSVRQcjs.newEffectId; exports.normalizeBlendMode = _chunkOLNIPTB3cjs.normalizeBlendMode; exports.normalizeLayerEffects = _chunkUOGKSVRQcjs.normalizeLayerEffects; exports.packRgba = _chunk474IQG74cjs.packRgba; exports.parseDataUrl = _chunkOLNIPTB3cjs.parseDataUrl; exports.parseEffectColor = _chunkUOGKSVRQcjs.parseEffectColor; exports.patchEffectMaps = _chunkUOGKSVRQcjs.patchEffectMaps; exports.pigment8 = _chunkOLNIPTB3cjs.pigment8; exports.pngDataUrl = _chunkOLNIPTB3cjs.pngDataUrl; exports.proxyOf = _chunkOLNIPTB3cjs.proxyOf; exports.readDeepRegion = _chunkOLNIPTB3cjs.readDeepRegion; exports.readPixel = _chunk474IQG74cjs.readPixel; exports.readRegion = _chunk474IQG74cjs.readRegion; exports.reduceSurface = _chunkUOGKSVRQcjs.reduceSurface; exports.renderLayerEffects = _chunkUOGKSVRQcjs.renderLayerEffects; exports.scaleLayerEffect = _chunkUOGKSVRQcjs.scaleLayerEffect; exports.screenToWorld = screenToWorld; exports.setLum = _chunkOLNIPTB3cjs.setLum; exports.solidSurface = _chunk474IQG74cjs.solidSurface; exports.srgbDecode = _chunkOLNIPTB3cjs.srgbDecode; exports.srgbEncode = _chunkOLNIPTB3cjs.srgbEncode; exports.standardBlendMode = _chunkOLNIPTB3cjs.standardBlendMode; exports.surfaceBytes = _chunk474IQG74cjs.surfaceBytes; exports.surfaceDepth = _chunkOLNIPTB3cjs.surfaceDepth; exports.surfaceFromDeepPixels = _chunkOLNIPTB3cjs.surfaceFromDeepPixels; exports.surfaceFromPixels = _chunk474IQG74cjs.surfaceFromPixels; exports.surfaceMipLevel = surfaceMipLevel; exports.surfaceResolutionForZoom = surfaceResolutionForZoom; exports.surfaceToWorld = surfaceToWorld; exports.surfacesEqual = _chunk474IQG74cjs.surfacesEqual; exports.tileCoord = _chunk474IQG74cjs.tileCoord; exports.tileKey = _chunk474IQG74cjs.tileKey; exports.tileRect = _chunk474IQG74cjs.tileRect; exports.tileSamples = _chunkOLNIPTB3cjs.tileSamples; exports.tileSamples16 = _chunkOLNIPTB3cjs.tileSamples16; exports.tileSamples32 = _chunkOLNIPTB3cjs.tileSamples32; exports.tilesInRect = _chunk474IQG74cjs.tilesInRect; exports.to16From32 = _chunkOLNIPTB3cjs.to16From32; exports.to16From8 = _chunkOLNIPTB3cjs.to16From8; exports.to32From16 = _chunkOLNIPTB3cjs.to32From16; exports.to32From8 = _chunkOLNIPTB3cjs.to32From8; exports.to8From16 = _chunkOLNIPTB3cjs.to8From16; exports.to8From32 = _chunkOLNIPTB3cjs.to8From32; exports.transformSurface = _chunkUOGKSVRQcjs.transformSurface; exports.transformedBounds = _chunkUOGKSVRQcjs.transformedBounds; exports.translateSurface = _chunk474IQG74cjs.translateSurface; exports.uniformTile = _chunk474IQG74cjs.uniformTile; exports.validateEffectGradient = _chunkUOGKSVRQcjs.validateEffectGradient; exports.validateLayerEffect = _chunkUOGKSVRQcjs.validateLayerEffect; exports.validateLayerEffects = _chunkUOGKSVRQcjs.validateLayerEffects; exports.visibleSurfaceRect = visibleSurfaceRect; exports.visibleWorldRect = visibleWorldRect; exports.warpSurface = _chunkUOGKSVRQcjs.warpSurface; exports.workingToSamples = _chunkUOGKSVRQcjs.workingToSamples; exports.worldRectToSurface = worldRectToSurface; exports.worldToSurface = worldToSurface; exports.writeDeepRegion = _chunkOLNIPTB3cjs.writeDeepRegion; exports.writeRegion = _chunk474IQG74cjs.writeRegion;
+
+exports.BIT_DEPTHS = _chunkOLNIPTB3cjs.BIT_DEPTHS; exports.BLEND_MODES = _chunkOLNIPTB3cjs.BLEND_MODES; exports.CURVE_LUT_SIZE = _chunkB46UQUDCcjs.CURVE_LUT_SIZE; exports.DEFAULT_GLOBAL_LIGHT = _chunkB46UQUDCcjs.DEFAULT_GLOBAL_LIGHT; exports.DIRECT_GAUSSIAN_MAX_SIGMA = _chunkK6PXS6DOcjs.DIRECT_GAUSSIAN_MAX_SIGMA; exports.DeepCompositor = _chunkB46UQUDCcjs.DeepCompositor; exports.INTERPOLATIONS = _chunkB46UQUDCcjs.INTERPOLATIONS; exports.LAYER_EFFECT_KINDS = _chunkB46UQUDCcjs.LAYER_EFFECT_KINDS; exports.LayerEffectError = _chunkB46UQUDCcjs.LayerEffectError; exports.MAX_EFFECT_REACH = _chunkB46UQUDCcjs.MAX_EFFECT_REACH; exports.MAX_TRANSFORM_PIXELS = _chunkB46UQUDCcjs.MAX_TRANSFORM_PIXELS; exports.PAINTERLY_BLEND_MODES = _chunkOLNIPTB3cjs.PAINTERLY_BLEND_MODES; exports.PatternPlacement = _chunkB46UQUDCcjs.PatternPlacement; exports.PatternTile = _chunkB46UQUDCcjs.PatternTile; exports.RasterCompositor = _chunkB46UQUDCcjs.RasterCompositor; exports.SHADOW_AMBIENT = _chunkOLNIPTB3cjs.SHADOW_AMBIENT; exports.STROKE_CHAMFER_MAX = _chunkB46UQUDCcjs.STROKE_CHAMFER_MAX; exports.SurfaceDraft = _chunk474IQG74cjs.SurfaceDraft; exports.SurfaceViewportRenderer = SurfaceViewportRenderer; exports.TILE = _chunk474IQG74cjs.TILE; exports.TILE_SHIFT = _chunk474IQG74cjs.TILE_SHIFT; exports.TiledSurface = _chunk474IQG74cjs.TiledSurface; exports.TransformTooLargeError = _chunkB46UQUDCcjs.TransformTooLargeError; exports.ZlibError = _chunkXFM3OCHUcjs.ZlibError; exports.activeEffectItems = _chunkB46UQUDCcjs.activeEffectItems; exports.adler32 = _chunkXFM3OCHUcjs.adler32; exports.applyEdgeAmbient = _chunkB46UQUDCcjs.applyEdgeAmbient; exports.base64ToBytes = _chunkOLNIPTB3cjs.base64ToBytes; exports.blendChannel = _chunkOLNIPTB3cjs.blendChannel; exports.blendImageData = _chunkOLNIPTB3cjs.blendImageData; exports.blendLum = _chunkOLNIPTB3cjs.blendLum; exports.blendPixel = _chunkOLNIPTB3cjs.blendPixel; exports.blendRgb = _chunkOLNIPTB3cjs.blendRgb; exports.blendTile = _chunkB46UQUDCcjs.blendTile; exports.buildEffectMaps = _chunkB46UQUDCcjs.buildEffectMaps; exports.builtinPattern = _chunkB46UQUDCcjs.builtinPattern; exports.builtinPatternIds = _chunkB46UQUDCcjs.builtinPatternIds; exports.bytesToBase64 = _chunkOLNIPTB3cjs.bytesToBase64; exports.canvasCompositeOperation = _chunkOLNIPTB3cjs.canvasCompositeOperation; exports.changedTiles = _chunkB46UQUDCcjs.changedTiles; exports.collectTiles = _chunk474IQG74cjs.collectTiles; exports.compositeLayerEffects = _chunkB46UQUDCcjs.compositeLayerEffects; exports.compositeSurfaceOver = _chunkB46UQUDCcjs.compositeSurfaceOver; exports.contentBounds = _chunk474IQG74cjs.contentBounds; exports.contourLut = _chunkB46UQUDCcjs.contourLut; exports.convertSurfaceDepth = _chunkOLNIPTB3cjs.convertSurfaceDepth; exports.curveLut = _chunkB46UQUDCcjs.curveLut; exports.decodePng = _chunkOLNIPTB3cjs.decodePng; exports.deepBytes = _chunkOLNIPTB3cjs.deepBytes; exports.deepTile = _chunkOLNIPTB3cjs.deepTile; exports.defaultEffectGradient = _chunkB46UQUDCcjs.defaultEffectGradient; exports.defaultLayerEffect = _chunkB46UQUDCcjs.defaultLayerEffect; exports.deflate = _chunkXFM3OCHUcjs.deflate; exports.deflateRaw = _chunkXFM3OCHUcjs.deflateRaw; exports.depthOf = _chunkOLNIPTB3cjs.depthOf; exports.drawSurfaceToViewport = drawSurfaceToViewport; exports.effectColorHex = _chunkB46UQUDCcjs.effectColorHex; exports.effectFillColors = _chunkB46UQUDCcjs.effectFillColors; exports.effectReach = _chunkB46UQUDCcjs.effectReach; exports.effectsAreLocal = _chunkB46UQUDCcjs.effectsAreLocal; exports.effectsFingerprint = _chunkB46UQUDCcjs.effectsFingerprint; exports.effectsMargin = _chunkB46UQUDCcjs.effectsMargin; exports.effectsScale = _chunkB46UQUDCcjs.effectsScale; exports.emptySurface = _chunk474IQG74cjs.emptySurface; exports.encodePng = _chunkOLNIPTB3cjs.encodePng; exports.fillRect = _chunk474IQG74cjs.fillRect; exports.findLayer = _chunkB46UQUDCcjs.findLayer; exports.finishTile = _chunk474IQG74cjs.finishTile; exports.flattenLayers = _chunkB46UQUDCcjs.flattenLayers; exports.gaussianBlur = _chunkK6PXS6DOcjs.gaussianBlur; exports.gradientT = _chunkB46UQUDCcjs.gradientT; exports.hasActiveEffects = _chunkB46UQUDCcjs.hasActiveEffects; exports.hashNoise = _chunkB46UQUDCcjs.hashNoise; exports.inflate = _chunkXFM3OCHUcjs.inflate; exports.inflateRaw = _chunkXFM3OCHUcjs.inflateRaw; exports.insertLayer = _chunkB46UQUDCcjs.insertLayer; exports.isBitDepth = _chunkOLNIPTB3cjs.isBitDepth; exports.isBlendMode = _chunkOLNIPTB3cjs.isBlendMode; exports.isInterpolation = _chunkB46UQUDCcjs.isInterpolation; exports.isLayerEffectKind = _chunkB46UQUDCcjs.isLayerEffectKind; exports.isLayerLocked = _chunkB46UQUDCcjs.isLayerLocked; exports.isPainterlyBlendMode = _chunkOLNIPTB3cjs.isPainterlyBlendMode; exports.isPng = _chunkOLNIPTB3cjs.isPng; exports.isSeparableBlendMode = _chunkOLNIPTB3cjs.isSeparableBlendMode; exports.keepDeepSamples = _chunkOLNIPTB3cjs.keepDeepSamples; exports.keysWeight = _chunkB46UQUDCcjs.keysWeight; exports.layerEffectFields = _chunkB46UQUDCcjs.layerEffectFields; exports.layerEffectLabel = _chunkB46UQUDCcjs.layerEffectLabel; exports.mapLayer = _chunkB46UQUDCcjs.mapLayer; exports.mergeLayerEffect = _chunkB46UQUDCcjs.mergeLayerEffect; exports.mixPigment8 = _chunkOLNIPTB3cjs.mixPigment8; exports.mixPigmentRgb = _chunkOLNIPTB3cjs.mixPigmentRgb; exports.newEffectId = _chunkB46UQUDCcjs.newEffectId; exports.normalizeBlendMode = _chunkOLNIPTB3cjs.normalizeBlendMode; exports.normalizeLayerEffects = _chunkB46UQUDCcjs.normalizeLayerEffects; exports.packRgba = _chunk474IQG74cjs.packRgba; exports.parseDataUrl = _chunkOLNIPTB3cjs.parseDataUrl; exports.parseEffectColor = _chunkB46UQUDCcjs.parseEffectColor; exports.patchEffectMaps = _chunkB46UQUDCcjs.patchEffectMaps; exports.pigment8 = _chunkOLNIPTB3cjs.pigment8; exports.pngDataUrl = _chunkOLNIPTB3cjs.pngDataUrl; exports.proxyOf = _chunkOLNIPTB3cjs.proxyOf; exports.readDeepRegion = _chunkOLNIPTB3cjs.readDeepRegion; exports.readPixel = _chunk474IQG74cjs.readPixel; exports.readRegion = _chunk474IQG74cjs.readRegion; exports.reduceSurface = _chunkB46UQUDCcjs.reduceSurface; exports.renderLayerEffects = _chunkB46UQUDCcjs.renderLayerEffects; exports.scaleLayerEffect = _chunkB46UQUDCcjs.scaleLayerEffect; exports.screenToWorld = screenToWorld; exports.setLum = _chunkOLNIPTB3cjs.setLum; exports.solidSurface = _chunk474IQG74cjs.solidSurface; exports.srgbDecode = _chunkOLNIPTB3cjs.srgbDecode; exports.srgbEncode = _chunkOLNIPTB3cjs.srgbEncode; exports.standardBlendMode = _chunkOLNIPTB3cjs.standardBlendMode; exports.surfaceBytes = _chunk474IQG74cjs.surfaceBytes; exports.surfaceDepth = _chunkOLNIPTB3cjs.surfaceDepth; exports.surfaceFromDeepPixels = _chunkOLNIPTB3cjs.surfaceFromDeepPixels; exports.surfaceFromPixels = _chunk474IQG74cjs.surfaceFromPixels; exports.surfaceMipLevel = surfaceMipLevel; exports.surfaceResolutionForZoom = surfaceResolutionForZoom; exports.surfaceToWorld = surfaceToWorld; exports.surfacesEqual = _chunk474IQG74cjs.surfacesEqual; exports.tileCoord = _chunk474IQG74cjs.tileCoord; exports.tileKey = _chunk474IQG74cjs.tileKey; exports.tileRect = _chunk474IQG74cjs.tileRect; exports.tileSamples = _chunkOLNIPTB3cjs.tileSamples; exports.tileSamples16 = _chunkOLNIPTB3cjs.tileSamples16; exports.tileSamples32 = _chunkOLNIPTB3cjs.tileSamples32; exports.tilesInRect = _chunk474IQG74cjs.tilesInRect; exports.to16From32 = _chunkOLNIPTB3cjs.to16From32; exports.to16From8 = _chunkOLNIPTB3cjs.to16From8; exports.to32From16 = _chunkOLNIPTB3cjs.to32From16; exports.to32From8 = _chunkOLNIPTB3cjs.to32From8; exports.to8From16 = _chunkOLNIPTB3cjs.to8From16; exports.to8From32 = _chunkOLNIPTB3cjs.to8From32; exports.transformSurface = _chunkB46UQUDCcjs.transformSurface; exports.transformedBounds = _chunkB46UQUDCcjs.transformedBounds; exports.translateSurface = _chunk474IQG74cjs.translateSurface; exports.uniformTile = _chunk474IQG74cjs.uniformTile; exports.validateEffectGradient = _chunkB46UQUDCcjs.validateEffectGradient; exports.validateLayerEffect = _chunkB46UQUDCcjs.validateLayerEffect; exports.validateLayerEffects = _chunkB46UQUDCcjs.validateLayerEffects; exports.visibleSurfaceRect = visibleSurfaceRect; exports.visibleWorldRect = visibleWorldRect; exports.warpSurface = _chunkB46UQUDCcjs.warpSurface; exports.workingToSamples = _chunkB46UQUDCcjs.workingToSamples; exports.worldRectToSurface = worldRectToSurface; exports.worldToSurface = worldToSurface; exports.writeDeepRegion = _chunkOLNIPTB3cjs.writeDeepRegion; exports.writeRegion = _chunk474IQG74cjs.writeRegion;

package/dist/raster/index.js

@@ -13,6 +13,7 @@ import {
   STROKE_CHAMFER_MAX,
   TransformTooLargeError,
   activeEffectItems,
+  applyEdgeAmbient,
   blendTile,
   buildEffectMaps,
   builtinPattern,
@@ -59,7 +60,7 @@ import {
   validateLayerEffects,
   warpSurface,
   workingToSamples
-} from "../chunk-YBJXCQTR.js";
+} from "../chunk-QXY4YTRI.js";
 import "../chunk-OHKOFKBY.js";
 import {
   DIRECT_GAUSSIAN_MAX_SIGMA,
@@ -391,6 +392,7 @@ export {
   ZlibError,
   activeEffectItems,
   adler32,
+  applyEdgeAmbient,
   base64ToBytes,
   blendChannel,
   blendImageData,

package/dist/raster/layers.d.cts

@@ -44,6 +44,20 @@ export interface RasterMask<Source = unknown> {
     linked?: boolean;
     source?: Source;
 }
+/**
+ * Colour corrections at a layer's soft edge, applied when compositing (nothing is baked). Amounts
+ * are 0..1; missing or 0 is off.
+ */
+export interface LayerEdgeColor {
+    /** Replaces edge colour with the subject's own, unmixed from the old background (the pixels the layer's mask hides). */
+    decontaminate?: number;
+    /** Limits how much of the old background's hue the edge carries (a heuristic; bounced light is not removed). */
+    despill?: number;
+    /** Pulls edge colour toward what is behind the layer now, more where the edge is more transparent. */
+    ambient?: number;
+    /** sRGB 0..255 for `ambient`; missing: the composite behind the layer, sampled live. */
+    ambientColor?: [number, number, number];
+}
 export interface RasterLayerBase {
     id: string;
     name: string;
@@ -57,6 +71,8 @@ export interface RasterLayerBase {
     locks?: LayerLocks;
     /** Live layer effects (drop shadow, stroke, …), rendered between the content and its blend. */
     effects?: LayerEffects;
+    /** Colour corrections at the layer's soft edge (see `LayerEdgeColor`). */
+    edge?: LayerEdgeColor;
 }
 export interface RasterPixelLayer extends RasterLayerBase {
     type: 'pixel';

package/dist/raster/layers.d.ts

@@ -44,6 +44,20 @@ export interface RasterMask<Source = unknown> {
     linked?: boolean;
     source?: Source;
 }
+/**
+ * Colour corrections at a layer's soft edge, applied when compositing (nothing is baked). Amounts
+ * are 0..1; missing or 0 is off.
+ */
+export interface LayerEdgeColor {
+    /** Replaces edge colour with the subject's own, unmixed from the old background (the pixels the layer's mask hides). */
+    decontaminate?: number;
+    /** Limits how much of the old background's hue the edge carries (a heuristic; bounced light is not removed). */
+    despill?: number;
+    /** Pulls edge colour toward what is behind the layer now, more where the edge is more transparent. */
+    ambient?: number;
+    /** sRGB 0..255 for `ambient`; missing: the composite behind the layer, sampled live. */
+    ambientColor?: [number, number, number];
+}
 export interface RasterLayerBase {
     id: string;
     name: string;
@@ -57,6 +71,8 @@ export interface RasterLayerBase {
     locks?: LayerLocks;
     /** Live layer effects (drop shadow, stroke, …), rendered between the content and its blend. */
     effects?: LayerEffects;
+    /** Colour corrections at the layer's soft edge (see `LayerEdgeColor`). */
+    edge?: LayerEdgeColor;
 }
 export interface RasterPixelLayer extends RasterLayerBase {
     type: 'pixel';

package/package.json

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

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

@@ -98,13 +98,11 @@ drawing or editing either.
 
 Live per-layer effects (shadows, glows, bevel, overlays, strokes): see `references/layer-effects.md`.
 
-### Paths
+### Paths and cutout edges
 
-1. **Keep outlines as paths**: `make_work_path` turns the selection into the Work Path (the next
-   one replaces it; `rename_path` saves it), `add_path` adds one from geometry.
-2. **Use them**: `path_to_selection` / `add_vector_mask` with `pathId`, `fill_path`, `stroke_path`.
-3. **Edit anchors** as the Pen and Direct Selection tools do: `get_path` → change anchors and handles
-   → `set_path_geometry` (one undo step); shapes `set_shape_component`, vector masks `set_vector_mask_path`.
+Keep outlines as paths (`make_work_path`, `add_path`) and edit their anchors: see
+[references/paths.md](references/paths.md). Fix a cutout's fringe live with `set_edge_decontamination`,
+`set_edge_despill` and `set_edge_ambient` (see `pixerate-image-selection-masking`).
 
 ### Painting
 
@@ -210,6 +208,7 @@ in the source frame at the document's bit depth, colour mode and profile. Read
 | `get_adjustments` | Read the current state: `values` by control id, `process` version (1 or 2), and `layers` bottom to top with id, kind, params, opacity, blend, enabled and mask. Call first, and to find layer ids. |
 | `list_controls` | Get every base control (id, label, section, min, max, step, default, `requiresProcess`), each layer kind's settable controls (plus `opacity`), the blend mode ids and the `layers.<layerId>.<controlId>` path format. Call once per session before writing. |
 | `get_selection` | Read the active selection: `empty`, `bounds` (natural pixels), `area` in pixels, `percent` of the image and a description. Check it after every select or modify step and before masking: a wand that covered 90% of the image is the wrong selection. |
+| `inspect_mask_edge` | Measure an edge without looking: the selection (default) or a layer's `layer-mask` / `vector-mask` (`layerId`). Returns `haloScore`, `edgeAlignment`, `jaggedness`, `softFraction`, `holes`, `islands`, `worst` regions for `capture_view` and `issues` with fixes. Inspect, fix, inspect again (see `pixerate-image-selection-masking`). |
 | `list_channels` | Read the alpha channels (saved selections): id, name, bounds, percent, overlay and visibility, and whether Quick Mask mode is on. |
 | `select_subject` | Select › Subject. With a host segmentation model, `target` describes what to select ("the dog", "the sky") and the model's outlines are selected (`maxSegments` 1 for one). Without one, the subject that stands out most is found classically; `target` can't choose it (`method: "saliency"`, `note`). Combined by `mode`. Returns the selection, `found` (label, bounds) and `method`; nothing found leaves the selection unchanged. |
 | `list_layers` | Read the layer stack bottom to top as a tree: id, type (`pixel`, `adjustment`, `group`, `shape`, `annotation`, `smart`; smart objects add their `contents`, `smartFilters` and `filterMask`; shapes a `shape` summary of component ops and kinds and paint types, and `annotation` when migrated from one), name, document `bounds` of pixel layers, visibility, opacity, `fillOpacity`, blend, `clipped`, locks, a `mask` summary, an `effects` summary (master switch, scale, effect ids and kinds), pixel-layer `filters` (the Background's `develop` filter is the base adjustments), adjustment `kind` and `params`, group `children`, and which layer is `active`. Call it to understand a document with more than the Background before changing it; adjustment layer ids work with every adjustment-layer tool. |
@@ -292,6 +291,10 @@ in the source frame at the document's bit depth, colour mode and profile. Read
 | `set_layer_mask_properties` | Change any layer mask's `density`, `feather`, `enabled` or `linked` (false: the mask stays put when the layer moves or transforms) without touching its pixels. |
 | `apply_layer_mask` | Bake a pixel layer's mask into its alpha and remove it. Destructive. |
 | `set_mask_view` | Show a layer's mask to check it (`view` `gray` alone, `overlay` red tint over what it hides, `off`; `layerId`, default active). View state only; look with `capture_view` `includeOverlays: true`, then `off`. Returns `{view, layerId}`. |
+| `get_edge_color` | A layer's edge colour: `decontaminate`, `despill`, `ambient` (percent) and `ambientSource` (`auto` or `#rrggbb`). |
+| `set_edge_decontamination` | Unmix the old background from a cutout's soft mask edge at composite time (`amount` %; 0 off; nothing baked). Needs a pixel layer whose mask has a soft band. Check with `inspect_mask_edge` `haloScore`. Returns the settings. |
+| `set_edge_despill` | Take the old background's hue out of a soft edge (`amount` %), luminance kept; never changes fully covered pixels. A heuristic: bounced light stays. Same mask needs. Returns the settings. |
+| `set_edge_ambient` | Tint a soft edge with what is behind the layer, live (`source` `auto`) or a fixed `#rrggbb` (`amount` %). For a subject moved onto a new background. Returns the settings. |
 | `remove_layer_mask` | Delete a mask without applying it; disable it instead to keep it. |
 | `layer_via_copy` | Copy the selected pixels of a pixel layer (default the active one) to a new layer above it; `cut: true` removes them from the source. Needs a selection. Returns the new layer. |
 | `rasterize_layer` | Turn a shape layer into a pixel layer showing the same pixels (same id, mask, effects, opacity, blend; the paths are gone), an annotation layer into pixels (browser only), a smart object into a pixel layer (as `rasterize_smart_object`), or bake a pixel layer's develop / blur filters into its pixels. Do it before painting over a shape or annotation, or when the user wants the filters fixed. Destructive. |

package/skills/pixerate-image-editor/references/paths.md

@@ -0,0 +1,12 @@
+# Paths
+
+Document paths are vector outlines kept with the document but on no layer (Photoshop's Paths
+panel). The Work Path is the scratch path; saved paths stay until deleted.
+
+1. **Keep outlines as paths**: `make_work_path` turns the selection into the Work Path (the next
+   one replaces it; `rename_path` saves it), `add_path` adds one from geometry.
+2. **Use them**: `path_to_selection` / `add_vector_mask` with `pathId`, `fill_path`, `stroke_path`.
+3. **Edit anchors** as the Pen and Direct Selection tools do: `get_path` → change anchors and
+   handles → `set_path_geometry` (one undo step); shapes `set_shape_component`, vector masks
+   `set_vector_mask_path`.
+4. **Read first**: `list_paths` for ids, names and bounds; `get_path` for the `components` to edit.

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

@@ -44,10 +44,10 @@ This skill is the method. `pixerate-image-editor` has the full tool reference.
    what leaked, and `intersect` to limit it to a region (for example `select_rect` around the
    subject).
    **Check:** `bounds` hug the subject. A bounds as large as the image means a leak.
-3. **Look at the edge.** Use `capture_view` with `region: "selection"` and `includeOverlays: true`,
-   or `set_selection_display` `quickMask`, to see soft edges as a tint.
-   **Check:** no holes in the subject, no islands in the background, and edges on the subject's
-   outline.
+3. **Measure the edge, then look.** `inspect_mask_edge` scores it: `haloScore` ≥ 0.35 is old
+   background inside the edge, `edgeAlignment` < 0.5 is off the image's edges, `jaggedness` ≥ 15
+   zigzags; it counts `holes` and `islands`, `issues` names fixes, `worst` gives `capture_view` rects.
+   **Check:** `issues` is empty, or each one is intended (a deliberately soft edge or a second piece).
 4. **Clean it up.**
    - `modify_selection` `smooth` (2–4 px) removes wand speckle.
    - `grow_selection` (tolerance 10–30) picks up the shades a wand click missed;
@@ -89,7 +89,8 @@ This skill is the method. `pixerate-image-editor` has the full tool reference.
    writes the selection, a channel or a layer mask as a greyscale PNG; a matte that comes
    back goes into a channel with `load_channel_from_image` (or straight to the selection with
    `load_selection_from_image`).
-7. **Verify.** `render_preview` at 1024 px or more, and `capture_view` on the edge at 2–8×.
+7. **Verify.** `inspect_mask_edge` again (`target: "layer-mask"` and `layerId` for a mask),
+   `render_preview` at 1024 px or more, and `capture_view` on `worst` regions at 2–8×.
    **Check:** no fringe of the old background colour, no stair-steps, no visible line where an
    adjustment ends. To judge a layer mask itself, `set_mask_view` `gray` (or `overlay`) and
    `capture_view` with `includeOverlays: true`; holes and stray grey show plainly there. Set it
@@ -120,12 +121,11 @@ This skill is the method. `pixerate-image-editor` has the full tool reference.
 
 ## Recipes
 
-- **Cut out a subject onto a new background:** select (table), then `refine_selection` with
-  `output: "new-layer-with-mask"` (revisable) and, for hair or fur, `decontaminate` 50–100 so
-  the old background's colour leaves the soft edge. 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, raise `decontaminate`, or load the mask as a selection, `contract`
-  1 px, and output again.
+- **Cut out a subject onto a new background:** select (table), `refine_selection` with `output:
+  "new-layer-with-mask"`, put the new background under it (`add_pixel_layer`, `move_layer`). Fix
+  the fringe live on the masked layer: `set_edge_decontamination` 80–100, `set_edge_despill` 50–100
+  for a coloured backdrop, `set_edge_ambient` 20–50 to take on the new scene's colour. Re-run
+  `inspect_mask_edge`; if `haloScore` stays high, `contract` the mask 1 px.
 - **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`).
@@ -184,8 +184,8 @@ This skill is the method. `pixerate-image-editor` has the full tool reference.
   background, and drop `snapToEdges` where the edge is too faint.
 - **Over-feathering hard objects:** a 10 px feather on a product looks like a glow. Keep hard
   edges at 0–2 px and refine soft ones instead.
-- **Halo:** the old background shows as a light or dark fringe. `decontaminate` on a
-  new-layer output for soft edges; for hard ones `contract` 1–2 px or
+- **Halo:** the old background shows as a light or dark fringe. `set_edge_decontamination` on the
+  masked layer (live) for soft edges; for hard ones `contract` 1–2 px or
   `shiftEdge` negative before masking.
 - **Baking too early:** `apply_layer_mask`, `merge_down` and `layer_via_copy` with `cut: true`
   are hard to revise. Keep masks until the user is happy.
@@ -220,8 +220,7 @@ This skill is the method. `pixerate-image-editor` has the full tool reference.
 - `select_layer_transparency`: a layer's own pixels
 - `grow_selection`, `select_similar`: add similar colour, connected or anywhere
 - `reselect`: undo a deselect
-- `save_selection`, `load_selection_from_channel`, `list_channels`: keep selections as alpha channels
-- `set_channel_properties`, `duplicate_channel`, `delete_channel`: manage channels
+- `save_selection`, `load_selection_from_channel`, `list_channels`, `set_channel_properties`, `duplicate_channel`, `delete_channel`: keep and manage selections as alpha channels
 - `export_mask_image`: a selection, channel or layer mask as a greyscale PNG
 - `load_channel_from_image`: a mask image into a new channel
 - `set_quick_mask`: paint the selection
@@ -240,8 +239,9 @@ This skill is the method. `pixerate-image-editor` has the full tool reference.
 - `modify_selection`: expand, contract, feather, border, smooth
 - `refine_selection`: snap the edge to the image
 - `transform_selection`: move or scale the outline only
-- `capture_view`: inspect the edge at pixel level
-- `render_preview`: check the result
+- `inspect_mask_edge`: measured halo, alignment, jaggedness, softness, holes and islands of an edge
+- `set_edge_decontamination`, `set_edge_despill`, `set_edge_ambient`, `get_edge_color`: live edge colour on a masked cutout
+- `capture_view`, `render_preview`: look at the edge at pixel level; check the result
 - `apply_selection_as_mask`: a masked adjustment layer in one step
 - `add_layer_mask`, `set_layer_mask_properties`, `apply_layer_mask`, `remove_layer_mask`: layer masks
 - `set_smart_filter_mask`: limit smart filters