@pixerate/editor 0.93.0 → 0.95.0

package/dist/{surface-fJhkmNQn.d.cts → surface-CgAiXVI3.d.cts}

@@ -1,11 +1,4 @@
-/**
- * Photoshop blend modes on straight (non-premultiplied) 0..1 colours.
- *
- * Formulas follow the W3C Compositing / ISO 32000 definitions, with Photoshop's variants where
- * they differ (Soft Light, Vivid / Linear / Pin Light, Hard Mix, Linear Burn / Dodge, Subtract,
- * Divide, Darker / Lighter Color), and the hardened `ClipColor` for the non-separable modes.
- */
-type BlendMode = 'normal' | 'darken' | 'multiply' | 'color-burn' | 'linear-burn' | 'darker-color' | 'lighten' | 'screen' | 'color-dodge' | 'linear-dodge' | 'lighter-color' | 'overlay' | 'soft-light' | 'hard-light' | 'vivid-light' | 'linear-light' | 'pin-light' | 'hard-mix' | 'difference' | 'exclusion' | 'subtract' | 'divide' | 'hue' | 'saturation' | 'color' | 'luminosity';
+type BlendMode = 'normal' | 'darken' | 'multiply' | 'color-burn' | 'linear-burn' | 'darker-color' | 'lighten' | 'screen' | 'color-dodge' | 'linear-dodge' | 'lighter-color' | 'overlay' | 'soft-light' | 'hard-light' | 'vivid-light' | 'linear-light' | 'pin-light' | 'hard-mix' | 'difference' | 'exclusion' | 'subtract' | 'divide' | 'hue' | 'saturation' | 'color' | 'luminosity' | 'pigment';
 interface BlendModeInfo {
     id: BlendMode;
     label: string;
@@ -22,7 +15,10 @@ declare function normalizeBlendMode(value: unknown): BlendMode;
  * none (draw through {@link blendImageData} instead).
  */
 declare function canvasCompositeOperation(mode: BlendMode | undefined): GlobalCompositeOperation | null;
-/** Whether a mode works on whole colours (hue, saturation, colour, luminosity, darker / lighter colour). */
+/**
+ * Whether a mode works channel by channel. The non-separable ones work on whole colours (hue,
+ * saturation, colour, luminosity, darker / lighter colour, pigment).
+ */
 declare function isSeparableBlendMode(mode: BlendMode): boolean;
 /** Separable blend function `B(cb, cs)` of one channel. Non-separable modes return `cs`. */
 declare function blendChannel(mode: BlendMode, cb: number, cs: number): number;
@@ -32,12 +28,28 @@ type Rgba = [number, number, number, number];
 declare function blendLum(c: readonly number[]): number;
 /** `c` with its luminosity moved to `l`, clipped back into gamut towards grey (SetLum + ClipColor). */
 declare function setLum(c: readonly number[], l: number): Rgb;
-/** `B(Cb, Cs)` of a whole colour, including the non-separable modes. */
+/**
+ * `B(Cb, Cs)` of a whole colour, including the non-separable modes. `pigment` has no `B` and
+ * returns `Cs`; composite it with {@link blendPixel} or {@link mixPigmentRgb}.
+ */
 declare function blendRgb(mode: BlendMode, cb: readonly number[], cs: readonly number[]): Rgb;
+/**
+ * The `pigment` mode's colour: `t` of `cs` mixed into `cb` like paint (`lerpPigment`), written to
+ * `out[0..2]`. `t ≥ 1` (or equal colours) is `cs` exactly. Colours are 0..1.
+ */
+declare function mixPigmentRgb(cb: readonly number[], cs: readonly number[], t: number, out?: number[]): number[];
+/**
+ * {@link mixPigmentRgb} on 8-bit channels, with each colour's spectrum cached: writes the 0..1
+ * result to `out[0..2]`. The compositor's and {@link blendImageData}'s per-pixel path.
+ */
+declare function mixPigment8(b0: number, b1: number, b2: number, s0: number, s1: number, s2: number, t: number, out: number[]): void;
 /**
  * Composites a straight-alpha `source` over a straight-alpha `backdrop` (both RGBA in 0..1) with a
  * blend mode and an extra `alpha` (opacity), using the W3C general formula:
  * `αo = αs + αb(1 − αs)`, `αo·Co = (1 − αs)·αb·Cb + (1 − αb)·αs·Cs + αs·αb·B(Cb, Cs)`.
+ *
+ * `pigment` mixes the colours like paint instead, by amount: `Co = lerpPigment(Cb, Cs, αs / αo)`
+ * (over an opaque backdrop that is `lerpPigment(Cb, Cs, αs)`), with the same `αo`.
  */
 declare function blendPixel(mode: BlendMode, backdrop: readonly number[], source: readonly number[], alpha?: number): Rgba;
 /**
@@ -178,4 +190,4 @@ declare function collectTiles(surface: TiledSurface, into: Set<Tile>): void;
 /** True when two surfaces hold the same pixels (cheap when they share tiles). */
 declare function surfacesEqual(a: TiledSurface, b: TiledSurface): boolean;
 
-export { solidSurface as A, type BlendMode as B, surfaceBytes as C, surfaceFromPixels as D, surfacesEqual as E, tileCoord as F, tileKey as G, tileRect as H, tilesInRect as I, translateSurface as J, uniformTile as K, writeRegion as L, type MaskSurface as M, type PixelSurface as P, type RasterRect as R, SurfaceDraft as S, TiledSurface as T, BLEND_MODES as a, type BlendModeInfo as b, type Rgb as c, type Rgba as d, TILE as e, TILE_SHIFT as f, type Tile as g, type TileKey as h, blendChannel as i, blendImageData as j, blendLum as k, blendPixel as l, blendRgb as m, canvasCompositeOperation as n, collectTiles as o, contentBounds as p, emptySurface as q, fillRect as r, finishTile as s, isBlendMode as t, isSeparableBlendMode as u, normalizeBlendMode as v, packRgba as w, readPixel as x, readRegion as y, setLum as z };
+export { readRegion as A, type BlendMode as B, setLum as C, solidSurface as D, surfaceBytes as E, surfaceFromPixels as F, surfacesEqual as G, tileCoord as H, tileKey as I, tileRect as J, tilesInRect as K, translateSurface as L, type MaskSurface as M, uniformTile as N, writeRegion as O, type PixelSurface as P, type RasterRect as R, SurfaceDraft as S, TILE as T, BLEND_MODES as a, type BlendModeInfo as b, type Rgb as c, type Rgba as d, TILE_SHIFT as e, type Tile as f, type TileKey as g, TiledSurface as h, blendChannel as i, blendImageData as j, blendLum as k, blendPixel as l, blendRgb as m, canvasCompositeOperation as n, collectTiles as o, contentBounds as p, emptySurface as q, fillRect as r, finishTile as s, isBlendMode as t, isSeparableBlendMode as u, mixPigment8 as v, mixPigmentRgb as w, normalizeBlendMode as x, packRgba as y, readPixel as z };

package/dist/{surface-fJhkmNQn.d.ts → surface-CgAiXVI3.d.ts}

@@ -1,11 +1,4 @@
-/**
- * Photoshop blend modes on straight (non-premultiplied) 0..1 colours.
- *
- * Formulas follow the W3C Compositing / ISO 32000 definitions, with Photoshop's variants where
- * they differ (Soft Light, Vivid / Linear / Pin Light, Hard Mix, Linear Burn / Dodge, Subtract,
- * Divide, Darker / Lighter Color), and the hardened `ClipColor` for the non-separable modes.
- */
-type BlendMode = 'normal' | 'darken' | 'multiply' | 'color-burn' | 'linear-burn' | 'darker-color' | 'lighten' | 'screen' | 'color-dodge' | 'linear-dodge' | 'lighter-color' | 'overlay' | 'soft-light' | 'hard-light' | 'vivid-light' | 'linear-light' | 'pin-light' | 'hard-mix' | 'difference' | 'exclusion' | 'subtract' | 'divide' | 'hue' | 'saturation' | 'color' | 'luminosity';
+type BlendMode = 'normal' | 'darken' | 'multiply' | 'color-burn' | 'linear-burn' | 'darker-color' | 'lighten' | 'screen' | 'color-dodge' | 'linear-dodge' | 'lighter-color' | 'overlay' | 'soft-light' | 'hard-light' | 'vivid-light' | 'linear-light' | 'pin-light' | 'hard-mix' | 'difference' | 'exclusion' | 'subtract' | 'divide' | 'hue' | 'saturation' | 'color' | 'luminosity' | 'pigment';
 interface BlendModeInfo {
     id: BlendMode;
     label: string;
@@ -22,7 +15,10 @@ declare function normalizeBlendMode(value: unknown): BlendMode;
  * none (draw through {@link blendImageData} instead).
  */
 declare function canvasCompositeOperation(mode: BlendMode | undefined): GlobalCompositeOperation | null;
-/** Whether a mode works on whole colours (hue, saturation, colour, luminosity, darker / lighter colour). */
+/**
+ * Whether a mode works channel by channel. The non-separable ones work on whole colours (hue,
+ * saturation, colour, luminosity, darker / lighter colour, pigment).
+ */
 declare function isSeparableBlendMode(mode: BlendMode): boolean;
 /** Separable blend function `B(cb, cs)` of one channel. Non-separable modes return `cs`. */
 declare function blendChannel(mode: BlendMode, cb: number, cs: number): number;
@@ -32,12 +28,28 @@ type Rgba = [number, number, number, number];
 declare function blendLum(c: readonly number[]): number;
 /** `c` with its luminosity moved to `l`, clipped back into gamut towards grey (SetLum + ClipColor). */
 declare function setLum(c: readonly number[], l: number): Rgb;
-/** `B(Cb, Cs)` of a whole colour, including the non-separable modes. */
+/**
+ * `B(Cb, Cs)` of a whole colour, including the non-separable modes. `pigment` has no `B` and
+ * returns `Cs`; composite it with {@link blendPixel} or {@link mixPigmentRgb}.
+ */
 declare function blendRgb(mode: BlendMode, cb: readonly number[], cs: readonly number[]): Rgb;
+/**
+ * The `pigment` mode's colour: `t` of `cs` mixed into `cb` like paint (`lerpPigment`), written to
+ * `out[0..2]`. `t ≥ 1` (or equal colours) is `cs` exactly. Colours are 0..1.
+ */
+declare function mixPigmentRgb(cb: readonly number[], cs: readonly number[], t: number, out?: number[]): number[];
+/**
+ * {@link mixPigmentRgb} on 8-bit channels, with each colour's spectrum cached: writes the 0..1
+ * result to `out[0..2]`. The compositor's and {@link blendImageData}'s per-pixel path.
+ */
+declare function mixPigment8(b0: number, b1: number, b2: number, s0: number, s1: number, s2: number, t: number, out: number[]): void;
 /**
  * Composites a straight-alpha `source` over a straight-alpha `backdrop` (both RGBA in 0..1) with a
  * blend mode and an extra `alpha` (opacity), using the W3C general formula:
  * `αo = αs + αb(1 − αs)`, `αo·Co = (1 − αs)·αb·Cb + (1 − αb)·αs·Cs + αs·αb·B(Cb, Cs)`.
+ *
+ * `pigment` mixes the colours like paint instead, by amount: `Co = lerpPigment(Cb, Cs, αs / αo)`
+ * (over an opaque backdrop that is `lerpPigment(Cb, Cs, αs)`), with the same `αo`.
  */
 declare function blendPixel(mode: BlendMode, backdrop: readonly number[], source: readonly number[], alpha?: number): Rgba;
 /**
@@ -178,4 +190,4 @@ declare function collectTiles(surface: TiledSurface, into: Set<Tile>): void;
 /** True when two surfaces hold the same pixels (cheap when they share tiles). */
 declare function surfacesEqual(a: TiledSurface, b: TiledSurface): boolean;
 
-export { solidSurface as A, type BlendMode as B, surfaceBytes as C, surfaceFromPixels as D, surfacesEqual as E, tileCoord as F, tileKey as G, tileRect as H, tilesInRect as I, translateSurface as J, uniformTile as K, writeRegion as L, type MaskSurface as M, type PixelSurface as P, type RasterRect as R, SurfaceDraft as S, TiledSurface as T, BLEND_MODES as a, type BlendModeInfo as b, type Rgb as c, type Rgba as d, TILE as e, TILE_SHIFT as f, type Tile as g, type TileKey as h, blendChannel as i, blendImageData as j, blendLum as k, blendPixel as l, blendRgb as m, canvasCompositeOperation as n, collectTiles as o, contentBounds as p, emptySurface as q, fillRect as r, finishTile as s, isBlendMode as t, isSeparableBlendMode as u, normalizeBlendMode as v, packRgba as w, readPixel as x, readRegion as y, setLum as z };
+export { readRegion as A, type BlendMode as B, setLum as C, solidSurface as D, surfaceBytes as E, surfaceFromPixels as F, surfacesEqual as G, tileCoord as H, tileKey as I, tileRect as J, tilesInRect as K, translateSurface as L, type MaskSurface as M, uniformTile as N, writeRegion as O, type PixelSurface as P, type RasterRect as R, SurfaceDraft as S, TILE as T, BLEND_MODES as a, type BlendModeInfo as b, type Rgb as c, type Rgba as d, TILE_SHIFT as e, type Tile as f, type TileKey as g, TiledSurface as h, blendChannel as i, blendImageData as j, blendLum as k, blendPixel as l, blendRgb as m, canvasCompositeOperation as n, collectTiles as o, contentBounds as p, emptySurface as q, fillRect as r, finishTile as s, isBlendMode as t, isSeparableBlendMode as u, mixPigment8 as v, mixPigmentRgb as w, normalizeBlendMode as x, packRgba as y, readPixel as z };