@pixerate/editor 0.242.0 → 0.243.0

package/dist/image-editor/index.js

@@ -8,7 +8,7 @@ import {
   parseOpenTypeFont,
   removeAnchorsKeepingShape,
   traceField
-} from "../chunk-UDBDYZET.js";
+} from "../chunk-H4Z72Z4Z.js";
 import {
   ColorGmm,
   GAMMA,
@@ -410,7 +410,7 @@ import {
   writePsd,
   xyToTempTint,
   xyToUv
-} from "../chunk-NE6OOKWJ.js";
+} from "../chunk-SRXWDOUI.js";
 import {
   parseCssColor
 } from "../chunk-3CI7FRMK.js";
@@ -729,8 +729,8 @@ import {
   warpMeshParamAt,
   warpMeshRows,
   warpPresetMesh
-} from "../chunk-ILM6GYAX.js";
-import "../chunk-XBZK47LV.js";
+} from "../chunk-6L3WWIDW.js";
+import "../chunk-HQZHOPNE.js";
 import "../chunk-M6DNZNVY.js";
 import {
   bezierPathToSvg,

package/dist/paint-editor/brushes.d.cts

@@ -18,7 +18,7 @@ import { type BristleSettings, type ParticleSettings } from './procedural.cjs';
  */
 export type PaintBrushEngine = 'dab' | 'eraser' | 'mixer' | 'blender' | 'smudge' | 'wet' | 'impasto' | 'particle' | 'bristle' | 'sticker';
 export declare const PAINT_BRUSH_ENGINES: readonly PaintBrushEngine[];
-export type PaintBrushCategory = 'pencil' | 'pastel' | 'charcoal' | 'airbrush' | 'marker' | 'ink' | 'paint' | 'eraser' | 'blender' | 'smudge' | 'mixer' | 'watercolor' | 'wet-tool' | 'oil' | 'impasto' | 'procedural' | 'bristle' | 'sticker' | 'custom';
+export type PaintBrushCategory = 'pencil' | 'pastel' | 'charcoal' | 'airbrush' | 'marker' | 'ink' | 'paint' | 'eraser' | 'blender' | 'smudge' | 'mixer' | 'watercolor' | 'wet-tool' | 'oil' | 'impasto' | 'procedural' | 'bristle' | 'sticker' | 'light' | 'custom';
 export declare const PAINT_BRUSH_CATEGORIES: readonly PaintBrushCategory[];
 /**
  * What a wet brush does to the wet layer: `paint` (water and pigment), `water` (clear water;
@@ -81,8 +81,21 @@ export interface ImpastoSettings {
     thinner: number;
     /** Knife and brush: how much of the paint under the tool is dragged along (0..1). */
     drag: number;
+    /** Light paint: the bead's light is stronger where its surface turns away, as on backlit glass (0..1, default 0). */
+    rim: number;
+    /** Light paint: the middle of a bead lets the layers below show through, its edges stay solid (0..1, default 0). */
+    clarity: number;
 }
 export declare const DEFAULT_IMPASTO: Readonly<ImpastoSettings>;
+/** Light paint: how much light a brush lays with its colour (see `doc.light`). */
+export interface LightSettings {
+    /** Light each dab lays, scaled by its coverage and flow (0..1, default 0: none). */
+    amount: number;
+    /** Pressure scales the light (default false). */
+    pressure: boolean;
+}
+export declare const DEFAULT_LIGHT: Readonly<LightSettings>;
+export declare function normalizeLight(raw?: Partial<LightSettings>, base?: LightSettings): LightSettings;
 export declare function normalizeImpasto(raw?: Partial<ImpastoSettings>, base?: ImpastoSettings): ImpastoSettings;
 /** Multi-coloured brush: `tip` lays the colours across the tip, `dab` changes colour from dab to dab. */
 export type MultiColorMode = 'off' | 'tip' | 'dab';
@@ -181,6 +194,8 @@ export interface PaintBrush {
     bristle: BristleSettings;
     /** Sticker engine only: the stamps and how they are sprayed. */
     sticker: StickerSettings;
+    /** Light paint: the light it lays with its colour (amount 0: none). */
+    light: LightSettings;
     /**
      * The brush's own gradient paint (`@pixerate/editor/paint` `PaintGradientSource`), used instead
      * of the editor's paint; `null` (default): the editor's paint. Stops may be `paint` / `secondary`
@@ -199,7 +214,8 @@ export type BrushBehaviorInput = Partial<Omit<BrushBehavior, 'multicolor'>> & {
 };
 export declare function normalizeBehavior(raw?: BrushBehaviorInput, base?: BrushBehavior): BrushBehavior;
 /** Brush settings to change or read: any subset of a brush and of its blocks. */
-export type PaintBrushInput = Partial<Omit<PaintBrush, 'tip' | 'dynamics' | 'mixer' | 'behavior' | 'blender' | 'smudge' | 'wet' | 'impasto' | 'particle' | 'bristle' | 'sticker' | 'paint'>> & {
+export type PaintBrushInput = Partial<Omit<PaintBrush, 'tip' | 'dynamics' | 'mixer' | 'behavior' | 'blender' | 'smudge' | 'wet' | 'impasto' | 'particle' | 'bristle' | 'sticker' | 'paint' | 'light'>> & {
+    light?: Partial<LightSettings>;
     /** A gradient (or `null` for the editor's paint); a plain colour source clears it. */
     paint?: PaintSource | null;
     tip?: Partial<BrushSettings>;

package/dist/paint-editor/brushes.d.ts

@@ -18,7 +18,7 @@ import { type BristleSettings, type ParticleSettings } from './procedural.js';
  */
 export type PaintBrushEngine = 'dab' | 'eraser' | 'mixer' | 'blender' | 'smudge' | 'wet' | 'impasto' | 'particle' | 'bristle' | 'sticker';
 export declare const PAINT_BRUSH_ENGINES: readonly PaintBrushEngine[];
-export type PaintBrushCategory = 'pencil' | 'pastel' | 'charcoal' | 'airbrush' | 'marker' | 'ink' | 'paint' | 'eraser' | 'blender' | 'smudge' | 'mixer' | 'watercolor' | 'wet-tool' | 'oil' | 'impasto' | 'procedural' | 'bristle' | 'sticker' | 'custom';
+export type PaintBrushCategory = 'pencil' | 'pastel' | 'charcoal' | 'airbrush' | 'marker' | 'ink' | 'paint' | 'eraser' | 'blender' | 'smudge' | 'mixer' | 'watercolor' | 'wet-tool' | 'oil' | 'impasto' | 'procedural' | 'bristle' | 'sticker' | 'light' | 'custom';
 export declare const PAINT_BRUSH_CATEGORIES: readonly PaintBrushCategory[];
 /**
  * What a wet brush does to the wet layer: `paint` (water and pigment), `water` (clear water;
@@ -81,8 +81,21 @@ export interface ImpastoSettings {
     thinner: number;
     /** Knife and brush: how much of the paint under the tool is dragged along (0..1). */
     drag: number;
+    /** Light paint: the bead's light is stronger where its surface turns away, as on backlit glass (0..1, default 0). */
+    rim: number;
+    /** Light paint: the middle of a bead lets the layers below show through, its edges stay solid (0..1, default 0). */
+    clarity: number;
 }
 export declare const DEFAULT_IMPASTO: Readonly<ImpastoSettings>;
+/** Light paint: how much light a brush lays with its colour (see `doc.light`). */
+export interface LightSettings {
+    /** Light each dab lays, scaled by its coverage and flow (0..1, default 0: none). */
+    amount: number;
+    /** Pressure scales the light (default false). */
+    pressure: boolean;
+}
+export declare const DEFAULT_LIGHT: Readonly<LightSettings>;
+export declare function normalizeLight(raw?: Partial<LightSettings>, base?: LightSettings): LightSettings;
 export declare function normalizeImpasto(raw?: Partial<ImpastoSettings>, base?: ImpastoSettings): ImpastoSettings;
 /** Multi-coloured brush: `tip` lays the colours across the tip, `dab` changes colour from dab to dab. */
 export type MultiColorMode = 'off' | 'tip' | 'dab';
@@ -181,6 +194,8 @@ export interface PaintBrush {
     bristle: BristleSettings;
     /** Sticker engine only: the stamps and how they are sprayed. */
     sticker: StickerSettings;
+    /** Light paint: the light it lays with its colour (amount 0: none). */
+    light: LightSettings;
     /**
      * The brush's own gradient paint (`@pixerate/editor/paint` `PaintGradientSource`), used instead
      * of the editor's paint; `null` (default): the editor's paint. Stops may be `paint` / `secondary`
@@ -199,7 +214,8 @@ export type BrushBehaviorInput = Partial<Omit<BrushBehavior, 'multicolor'>> & {
 };
 export declare function normalizeBehavior(raw?: BrushBehaviorInput, base?: BrushBehavior): BrushBehavior;
 /** Brush settings to change or read: any subset of a brush and of its blocks. */
-export type PaintBrushInput = Partial<Omit<PaintBrush, 'tip' | 'dynamics' | 'mixer' | 'behavior' | 'blender' | 'smudge' | 'wet' | 'impasto' | 'particle' | 'bristle' | 'sticker' | 'paint'>> & {
+export type PaintBrushInput = Partial<Omit<PaintBrush, 'tip' | 'dynamics' | 'mixer' | 'behavior' | 'blender' | 'smudge' | 'wet' | 'impasto' | 'particle' | 'bristle' | 'sticker' | 'paint' | 'light'>> & {
+    light?: Partial<LightSettings>;
     /** A gradient (or `null` for the editor's paint); a plain colour source clears it. */
     paint?: PaintSource | null;
     tip?: Partial<BrushSettings>;

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

@@ -32,6 +32,7 @@ import { type PaintGuides, type PerspectiveGuide, type ReferenceImage, type Symm
 import { MixingPad, type MixingPadTool, type PadMixOptions } from './mixing-pad.cjs';
 import { type Stencil, type StencilInput } from './stencils.cjs';
 import { type Sticker } from './stickers.cjs';
+import { type LightSpill } from './light.cjs';
 import { type PaintView } from './view.cjs';
 import { PaintWetLayers, type PaintWetOptions, type WetEngineInfo, type WetGpuMode, type WetLayerInfo } from './wet.cjs';
 import { type WetParams, type WetTilt } from '../paint/wet/model.cjs';
@@ -314,6 +315,9 @@ export declare class PaintEditorController {
     private dirty;
     private seedCounter;
     private strokeCounter;
+    /** Light paint: each layer's spill settings (saved with the document, not undo steps; missing = the defaults). */
+    private lightSpills;
+    private readonly lightCaches;
     /** Live effect paint: playing and the frame rate cap (editor state), and the time the view shows. */
     private effectPlaybackState;
     private effectTime;
@@ -731,6 +735,24 @@ export declare class PaintEditorController {
         bounds: RasterRect | null;
         layerIds: string[];
     };
+    /** The document's `light` without these layers (as a spread: `{}` when unchanged). */
+    private lightWithout;
+    private lightSpillOf;
+    /** A layer's light paint: whether it has any, where (document pixels), its brightest value 0..255, and its spill. */
+    lightOf(layerId?: string): {
+        layerId: string;
+        hasLight: boolean;
+        bounds: RasterRect | null;
+        peak: number;
+        spill: LightSpill;
+    };
+    /** How far a layer's light spills (px; 0 turns it off) and how strongly (0..2). Saved with the document, not an undo step; nothing is repainted. */
+    setLightSpill(layerId: string | undefined, update: Partial<LightSpill>): LightSpill;
+    /** Takes a layer's light away; its paint keeps its colour. One undo step. Returns whether there was any. */
+    clearLight(layerId?: string): {
+        layerId: string;
+        cleared: boolean;
+    };
     /** The document's `thick` without these layers (as a spread: `{}` when unchanged). */
     private thickWithout;
     /** Where the light comes from for thick paint and metallic paper. */
@@ -889,6 +911,12 @@ export declare class PaintEditorController {
     private driedLayers;
     /** The layers with thick paint lit (each thick layer's pixels replaced by its lit tiles). */
     private litLayers;
+    /**
+     * Light paint over the (lit) layers: glow, rim and clarity in each layer's pixels, and its spill
+     * as a Linear Dodge (Add) layer directly above it (from the painting as committed, so a stroke in
+     * progress does not redraw the blur every frame).
+     */
+    private lightLayers;
     private renderLayers;
     /**
      * Composites the viewport stack (paper, view-only underlays, layers with the live stroke) tile by

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

@@ -32,6 +32,7 @@ import { type PaintGuides, type PerspectiveGuide, type ReferenceImage, type Symm
 import { MixingPad, type MixingPadTool, type PadMixOptions } from './mixing-pad.js';
 import { type Stencil, type StencilInput } from './stencils.js';
 import { type Sticker } from './stickers.js';
+import { type LightSpill } from './light.js';
 import { type PaintView } from './view.js';
 import { PaintWetLayers, type PaintWetOptions, type WetEngineInfo, type WetGpuMode, type WetLayerInfo } from './wet.js';
 import { type WetParams, type WetTilt } from '../paint/wet/model.js';
@@ -314,6 +315,9 @@ export declare class PaintEditorController {
     private dirty;
     private seedCounter;
     private strokeCounter;
+    /** Light paint: each layer's spill settings (saved with the document, not undo steps; missing = the defaults). */
+    private lightSpills;
+    private readonly lightCaches;
     /** Live effect paint: playing and the frame rate cap (editor state), and the time the view shows. */
     private effectPlaybackState;
     private effectTime;
@@ -731,6 +735,24 @@ export declare class PaintEditorController {
         bounds: RasterRect | null;
         layerIds: string[];
     };
+    /** The document's `light` without these layers (as a spread: `{}` when unchanged). */
+    private lightWithout;
+    private lightSpillOf;
+    /** A layer's light paint: whether it has any, where (document pixels), its brightest value 0..255, and its spill. */
+    lightOf(layerId?: string): {
+        layerId: string;
+        hasLight: boolean;
+        bounds: RasterRect | null;
+        peak: number;
+        spill: LightSpill;
+    };
+    /** How far a layer's light spills (px; 0 turns it off) and how strongly (0..2). Saved with the document, not an undo step; nothing is repainted. */
+    setLightSpill(layerId: string | undefined, update: Partial<LightSpill>): LightSpill;
+    /** Takes a layer's light away; its paint keeps its colour. One undo step. Returns whether there was any. */
+    clearLight(layerId?: string): {
+        layerId: string;
+        cleared: boolean;
+    };
     /** The document's `thick` without these layers (as a spread: `{}` when unchanged). */
     private thickWithout;
     /** Where the light comes from for thick paint and metallic paper. */
@@ -889,6 +911,12 @@ export declare class PaintEditorController {
     private driedLayers;
     /** The layers with thick paint lit (each thick layer's pixels replaced by its lit tiles). */
     private litLayers;
+    /**
+     * Light paint over the (lit) layers: glow, rim and clarity in each layer's pixels, and its spill
+     * as a Linear Dodge (Add) layer directly above it (from the painting as committed, so a stroke in
+     * progress does not redraw the blur every frame).
+     */
+    private lightLayers;
     private renderLayers;
     /**
      * Composites the viewport stack (paper, view-only underlays, layers with the live stroke) tile by

package/dist/paint-editor/document.d.cts

@@ -8,6 +8,7 @@
  * same layer tree loads in both editors), with the paper as plain settings.
  */
 import type { RasterGroupLayer, RasterLayer, RasterPixelLayer } from '../raster/layers.cjs';
+import { type TiledSurface } from '../raster/surface.cjs';
 import { type PaperSettings } from './paper.cjs';
 import type { RecordedStroke } from './strokes.cjs';
 import type { WetEvent } from './wet.cjs';
@@ -48,6 +49,8 @@ export interface PaintDocumentState {
      * stroke's brush, colour and points stay editable (`updateStroke`).
      */
     liveStrokes?: Readonly<Record<string, RecordedStroke[]>>;
+    /** Light paint: each layer's light channel, 0..255 per pixel in layer space (layers without light are missing). See `light.ts`. */
+    light?: Readonly<Record<string, TiledSurface>>;
     /** Thick paint: each layer's height and material channels (layers without relief are missing). */
     thick?: Readonly<Record<string, ThickChannels>>;
     /** Effect layers: the provider effect each one is drawn from (layers that are gone are ignored). */

package/dist/paint-editor/document.d.ts

@@ -8,6 +8,7 @@
  * same layer tree loads in both editors), with the paper as plain settings.
  */
 import type { RasterGroupLayer, RasterLayer, RasterPixelLayer } from '../raster/layers.js';
+import { type TiledSurface } from '../raster/surface.js';
 import { type PaperSettings } from './paper.js';
 import type { RecordedStroke } from './strokes.js';
 import type { WetEvent } from './wet.js';
@@ -48,6 +49,8 @@ export interface PaintDocumentState {
      * stroke's brush, colour and points stay editable (`updateStroke`).
      */
     liveStrokes?: Readonly<Record<string, RecordedStroke[]>>;
+    /** Light paint: each layer's light channel, 0..255 per pixel in layer space (layers without light are missing). See `light.ts`. */
+    light?: Readonly<Record<string, TiledSurface>>;
     /** Thick paint: each layer's height and material channels (layers without relief are missing). */
     thick?: Readonly<Record<string, ThickChannels>>;
     /** Effect layers: the provider effect each one is drawn from (layers that are gone are ignored). */