@pixerate/editor 0.226.0 → 0.227.1

package/dist/image-editor/index.js

@@ -4,7 +4,7 @@ import {
   parseOpenTypeFont,
   removeAnchorsKeepingShape,
   traceField
-} from "../chunk-DJBYJOHM.js";
+} from "../chunk-XSVUNSDJ.js";
 import {
   ColorGmm,
   GAMMA,
@@ -405,7 +405,7 @@ import {
   writePsd,
   xyToTempTint,
   xyToUv
-} from "../chunk-5YLOU7VF.js";
+} from "../chunk-KN3Y3FRY.js";
 import {
   parseCssColor
 } from "../chunk-3CI7FRMK.js";
@@ -727,8 +727,8 @@ import {
   warpMeshParamAt,
   warpMeshRows,
   warpPresetMesh
-} from "../chunk-NDMXB4PR.js";
-import "../chunk-F7YA3MMC.js";
+} from "../chunk-CU6ANS5L.js";
+import "../chunk-TQOL6CF7.js";
 import "../chunk-M6DNZNVY.js";
 import {
   bezierPathToSvg,
@@ -743,7 +743,7 @@ import {
   createEffectToolProvider,
   linearToSrgb,
   resolveEffectValues
-} from "../chunk-7DZ55AIE.js";
+} from "../chunk-UGYUGZE2.js";
 import "../chunk-V2ZCJRDM.js";
 import {
   BrushstrokeCache,

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

@@ -40,6 +40,7 @@ import { type WetBackendInfo } from '../paint/wet/world.cjs';
 import { type TimeLapse, type TimeLapseOptions } from './replay.cjs';
 import { EffectsSlot } from '../effects/helpers.cjs';
 import type { EffectDescription, EffectProvider, EffectValue } from '../effects/types.cjs';
+import { type PaintEffectPaint } from './effect-paint.cjs';
 import { type PaintEffectPlace, type PaintEffectSource, type PaintPaperEffect, type PaperEffectBlend } from './effects.cjs';
 import { type PaintLighting } from './thick.cjs';
 /** A refusal with a message that says what is wrong and how to fix it. */
@@ -100,6 +101,13 @@ export interface PaintEditorState {
      * own gradient (`brush.paint`) paints that instead.
      */
     paint: PaintSource;
+    /**
+     * Effect paint (`setEffectPaint`): a provider effect strokes take each pixel's colour from,
+     * instead of `paint`; `null` when they paint `paint`. `setColor` and `setPaint` clear it.
+     */
+    effectPaint: PaintEffectPaint | null;
+    /** The effect paint is still rendering: strokes that would paint with it wait (they throw). */
+    effectPaintRendering: boolean;
     /** What the Mixer Brush carries between strokes. */
     mixerLoad: MixerLoad;
     view: PaintView;
@@ -145,10 +153,11 @@ export interface PaintStrokeInit {
     /** Default the editor colour. */
     color?: string;
     /**
-     * What this stroke paints with, instead of the editor's paint: a colour, or gradient paint
-     * (`@pixerate/editor/paint` `PaintSource`). A colour here is the same as `color`.
+     * What this stroke paints with, instead of the editor's paint: a colour, gradient paint
+     * (`@pixerate/editor/paint` `PaintSource`), or effect paint (render it first with
+     * `prepareEffectPaints`). A colour here is the same as `color`.
      */
-    paint?: PaintSource | string;
+    paint?: PaintSource | PaintEffectPaint | string;
     /** Default the active brush. */
     brushId?: string;
     /** Changes to the brush for this stroke only. */
@@ -256,6 +265,13 @@ export declare class PaintEditorController {
     private secondaryColor;
     /** Gradient paint chosen with `setPaint` (`null`: the paint colour). */
     private gradient;
+    /** Effect paint chosen with `setEffectPaint` (rendered), and one still rendering. */
+    private effectPaint;
+    private effectPaintPending;
+    /** Changes whenever the paint is chosen, so an effect paint that finishes rendering late does not take over. */
+    private paintEpoch;
+    /** Rendered effect paints by `effectPaintKey` (most recently used last). */
+    private readonly effectPaintPixels;
     private mixerLoad;
     private view;
     private hand;
@@ -508,6 +524,41 @@ export declare class PaintEditorController {
         layerId: string;
         source: PaintEffectSource;
     }>;
+    /** At most this many rendered effect paints are kept (each is canvas-sized). */
+    private static readonly EFFECT_PAINT_CACHE;
+    /** The effect paint strokes use (or the one rendering), or `null`. */
+    getEffectPaint(): PaintEffectPaint | null;
+    /**
+     * Paints with a provider generator, overlay or title effect: it is rendered once at the canvas
+     * size, and brushes then take each pixel's colour (and alpha) from it, fixed to the canvas, as if
+     * painting a hidden picture into view. `setColor` and `setPaint` go back to colour. Editor state,
+     * not an undo step. Strokes that would paint with it throw while it renders. Returns the paint.
+     */
+    setEffectPaint(source: {
+        effect: string;
+        values?: Record<string, EffectValue | null>;
+        time?: number;
+    }): Promise<PaintEffectPaint>;
+    /** The rendered pixels of an effect paint at the current canvas size, or `null` when it has not been rendered. */
+    private effectPaintImage;
+    /** Renders an effect paint at the canvas size into the cache (nothing when it is there already). */
+    private renderEffectPaint;
+    /**
+     * Renders effect paints that are not rendered yet (strokes and replays need them rendered
+     * first, since strokes are synchronous). Throws naming the effect and provider when one cannot be.
+     */
+    prepareEffectPaints(paints: Iterable<PaintEffectPaint>): Promise<void>;
+    /** Renders the effect paints of recorded strokes (default all of them) before a replay. */
+    prepareStrokeEffects(strokeIds?: readonly string[]): Promise<void>;
+    /** A small preview of the effect paint (a PNG data URL `size` px wide), or `null` without a rendered one. */
+    effectPaintThumbnail(size?: number): string | null;
+    /**
+     * The effect paint a stroke paints with and its pixels, or `null`: the stroke's own effect
+     * `paint`, else (without its own `paint` or `color`, and with no brush gradient) the editor's.
+     * Throws while the editor's is still rendering, for an engine that cannot paint with it, or when
+     * its pixels are not rendered.
+     */
+    private strokeEffect;
     /**
      * Runs a filter effect (light, glow, colour grade …) on a layer's dried paint and bakes it in, at
      * `amount` strength (0..1, default 1). Transparent areas stay transparent; thick paint keeps its

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

@@ -40,6 +40,7 @@ import { type WetBackendInfo } from '../paint/wet/world.js';
 import { type TimeLapse, type TimeLapseOptions } from './replay.js';
 import { EffectsSlot } from '../effects/helpers.js';
 import type { EffectDescription, EffectProvider, EffectValue } from '../effects/types.js';
+import { type PaintEffectPaint } from './effect-paint.js';
 import { type PaintEffectPlace, type PaintEffectSource, type PaintPaperEffect, type PaperEffectBlend } from './effects.js';
 import { type PaintLighting } from './thick.js';
 /** A refusal with a message that says what is wrong and how to fix it. */
@@ -100,6 +101,13 @@ export interface PaintEditorState {
      * own gradient (`brush.paint`) paints that instead.
      */
     paint: PaintSource;
+    /**
+     * Effect paint (`setEffectPaint`): a provider effect strokes take each pixel's colour from,
+     * instead of `paint`; `null` when they paint `paint`. `setColor` and `setPaint` clear it.
+     */
+    effectPaint: PaintEffectPaint | null;
+    /** The effect paint is still rendering: strokes that would paint with it wait (they throw). */
+    effectPaintRendering: boolean;
     /** What the Mixer Brush carries between strokes. */
     mixerLoad: MixerLoad;
     view: PaintView;
@@ -145,10 +153,11 @@ export interface PaintStrokeInit {
     /** Default the editor colour. */
     color?: string;
     /**
-     * What this stroke paints with, instead of the editor's paint: a colour, or gradient paint
-     * (`@pixerate/editor/paint` `PaintSource`). A colour here is the same as `color`.
+     * What this stroke paints with, instead of the editor's paint: a colour, gradient paint
+     * (`@pixerate/editor/paint` `PaintSource`), or effect paint (render it first with
+     * `prepareEffectPaints`). A colour here is the same as `color`.
      */
-    paint?: PaintSource | string;
+    paint?: PaintSource | PaintEffectPaint | string;
     /** Default the active brush. */
     brushId?: string;
     /** Changes to the brush for this stroke only. */
@@ -256,6 +265,13 @@ export declare class PaintEditorController {
     private secondaryColor;
     /** Gradient paint chosen with `setPaint` (`null`: the paint colour). */
     private gradient;
+    /** Effect paint chosen with `setEffectPaint` (rendered), and one still rendering. */
+    private effectPaint;
+    private effectPaintPending;
+    /** Changes whenever the paint is chosen, so an effect paint that finishes rendering late does not take over. */
+    private paintEpoch;
+    /** Rendered effect paints by `effectPaintKey` (most recently used last). */
+    private readonly effectPaintPixels;
     private mixerLoad;
     private view;
     private hand;
@@ -508,6 +524,41 @@ export declare class PaintEditorController {
         layerId: string;
         source: PaintEffectSource;
     }>;
+    /** At most this many rendered effect paints are kept (each is canvas-sized). */
+    private static readonly EFFECT_PAINT_CACHE;
+    /** The effect paint strokes use (or the one rendering), or `null`. */
+    getEffectPaint(): PaintEffectPaint | null;
+    /**
+     * Paints with a provider generator, overlay or title effect: it is rendered once at the canvas
+     * size, and brushes then take each pixel's colour (and alpha) from it, fixed to the canvas, as if
+     * painting a hidden picture into view. `setColor` and `setPaint` go back to colour. Editor state,
+     * not an undo step. Strokes that would paint with it throw while it renders. Returns the paint.
+     */
+    setEffectPaint(source: {
+        effect: string;
+        values?: Record<string, EffectValue | null>;
+        time?: number;
+    }): Promise<PaintEffectPaint>;
+    /** The rendered pixels of an effect paint at the current canvas size, or `null` when it has not been rendered. */
+    private effectPaintImage;
+    /** Renders an effect paint at the canvas size into the cache (nothing when it is there already). */
+    private renderEffectPaint;
+    /**
+     * Renders effect paints that are not rendered yet (strokes and replays need them rendered
+     * first, since strokes are synchronous). Throws naming the effect and provider when one cannot be.
+     */
+    prepareEffectPaints(paints: Iterable<PaintEffectPaint>): Promise<void>;
+    /** Renders the effect paints of recorded strokes (default all of them) before a replay. */
+    prepareStrokeEffects(strokeIds?: readonly string[]): Promise<void>;
+    /** A small preview of the effect paint (a PNG data URL `size` px wide), or `null` without a rendered one. */
+    effectPaintThumbnail(size?: number): string | null;
+    /**
+     * The effect paint a stroke paints with and its pixels, or `null`: the stroke's own effect
+     * `paint`, else (without its own `paint` or `color`, and with no brush gradient) the editor's.
+     * Throws while the editor's is still rendering, for an engine that cannot paint with it, or when
+     * its pixels are not rendered.
+     */
+    private strokeEffect;
     /**
      * Runs a filter effect (light, glow, colour grade …) on a layer's dried paint and bakes it in, at
      * `amount` strength (0..1, default 1). Transparent areas stay transparent; thick paint keeps its

package/dist/paint-editor/dab-stroke.d.cts

@@ -19,6 +19,7 @@ import { type MixerLoad, type MixingModel, type PaintTileTarget, type RgbTriple
 import type { RasterRect } from '../raster/surface.cjs';
 import { type PaintGradientSource } from '../paint/gradient-paint.cjs';
 import type { MultiColorSettings, PaintBrush } from './brushes.cjs';
+import { type EffectPaintPixels } from './effect-paint.cjs';
 import { type PenPoint, type StrokeCopy } from './engine.cjs';
 import { type PaperGrain } from './paper.cjs';
 export interface PaintDabStrokeOptions {
@@ -36,6 +37,8 @@ export interface PaintDabStrokeOptions {
     copies?: readonly StrokeCopy[];
     /** Gradient paint (resolved: no `paint` / `secondary` stops): each dab's colour comes from it. */
     paint?: PaintGradientSource | null;
+    /** Effect paint: each dab's colour (and flow, by alpha) is the effect's at the dab's centre. */
+    effect?: EffectPaintPixels | null;
 }
 /** Colours of a multi-colour brush, resolved against the paint and secondary colours. */
 export declare function multiColorPalette(mc: MultiColorSettings, color: RgbTriple, secondary: RgbTriple): RgbTriple[];

package/dist/paint-editor/dab-stroke.d.ts

@@ -19,6 +19,7 @@ import { type MixerLoad, type MixingModel, type PaintTileTarget, type RgbTriple
 import type { RasterRect } from '../raster/surface.js';
 import { type PaintGradientSource } from '../paint/gradient-paint.js';
 import type { MultiColorSettings, PaintBrush } from './brushes.js';
+import { type EffectPaintPixels } from './effect-paint.js';
 import { type PenPoint, type StrokeCopy } from './engine.js';
 import { type PaperGrain } from './paper.js';
 export interface PaintDabStrokeOptions {
@@ -36,6 +37,8 @@ export interface PaintDabStrokeOptions {
     copies?: readonly StrokeCopy[];
     /** Gradient paint (resolved: no `paint` / `secondary` stops): each dab's colour comes from it. */
     paint?: PaintGradientSource | null;
+    /** Effect paint: each dab's colour (and flow, by alpha) is the effect's at the dab's centre. */
+    effect?: EffectPaintPixels | null;
 }
 /** Colours of a multi-colour brush, resolved against the paint and secondary colours. */
 export declare function multiColorPalette(mc: MultiColorSettings, color: RgbTriple, secondary: RgbTriple): RgbTriple[];

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

@@ -0,0 +1,47 @@
+/**
+ * Effect paint: a provider generator, overlay or title effect that brushes paint with. The effect
+ * is rendered once at the canvas size when it is chosen; strokes then take each pixel's colour
+ * from that image, fixed to the canvas, as if painting a hidden picture into view. The effect's
+ * alpha multiplies the brush coverage, so a transparent part of an overlay paints nothing.
+ *
+ * Strokes are synchronous and effect renders are not, so the pixels are rendered (and cached by
+ * source) before a stroke can use them; a stroke records the source, and replays render any
+ * missing source before they paint.
+ *
+ * Kept out of the shared `PaintSource` union (`@pixerate/editor/paint`), which the image editor
+ * shares: only the paint editor paints with effects.
+ */
+import type { EffectValue } from '../effects/types.cjs';
+import type { RasterRect } from '../raster/surface.cjs';
+/** What strokes paint with when they paint with a provider effect. */
+export interface PaintEffectPaint {
+    type: 'effect';
+    /** The effect id (search_effects). */
+    effect: string;
+    /** The provider's id when it was chosen. */
+    provider: string;
+    /** Every control value. */
+    values: Record<string, EffectValue>;
+    /** Which moment of an animated effect, in ms. */
+    time: number;
+}
+/** Canvas-sized straight-alpha RGBA an effect paint was rendered to. */
+export interface EffectPaintPixels {
+    width: number;
+    height: number;
+    data: ArrayLike<number>;
+}
+/** The cache key of an effect paint (the same source renders the same pixels). */
+export declare function effectPaintKey(p: PaintEffectPaint): string;
+/** Whether a value is an effect paint (`{ type: 'effect', effect, … }`). */
+export declare function isPaintEffectPaint(raw: unknown): raw is PaintEffectPaint;
+/** A saved effect paint, or `null` when it is not one. */
+export declare function readPaintEffectPaint(raw: unknown): PaintEffectPaint | null;
+/**
+ * Takes a dab's colours from the effect: fills `field` (sRGB 0..1, 3 per pixel of `rect`, a
+ * document rectangle) with the effect's colour at each pixel and multiplies `vals` by its alpha.
+ * Pixels off the canvas paint nothing.
+ */
+export declare function sampleEffectField(img: EffectPaintPixels, rect: RasterRect, vals: Float32Array, field: Float32Array): void;
+/** The effect's colour (sRGB 0..1 into `out`) at a document point; returns its alpha 0..1 (0 off the canvas). */
+export declare function sampleEffectAt(img: EffectPaintPixels, x: number, y: number, out: [number, number, number]): number;

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

@@ -0,0 +1,47 @@
+/**
+ * Effect paint: a provider generator, overlay or title effect that brushes paint with. The effect
+ * is rendered once at the canvas size when it is chosen; strokes then take each pixel's colour
+ * from that image, fixed to the canvas, as if painting a hidden picture into view. The effect's
+ * alpha multiplies the brush coverage, so a transparent part of an overlay paints nothing.
+ *
+ * Strokes are synchronous and effect renders are not, so the pixels are rendered (and cached by
+ * source) before a stroke can use them; a stroke records the source, and replays render any
+ * missing source before they paint.
+ *
+ * Kept out of the shared `PaintSource` union (`@pixerate/editor/paint`), which the image editor
+ * shares: only the paint editor paints with effects.
+ */
+import type { EffectValue } from '../effects/types.js';
+import type { RasterRect } from '../raster/surface.js';
+/** What strokes paint with when they paint with a provider effect. */
+export interface PaintEffectPaint {
+    type: 'effect';
+    /** The effect id (search_effects). */
+    effect: string;
+    /** The provider's id when it was chosen. */
+    provider: string;
+    /** Every control value. */
+    values: Record<string, EffectValue>;
+    /** Which moment of an animated effect, in ms. */
+    time: number;
+}
+/** Canvas-sized straight-alpha RGBA an effect paint was rendered to. */
+export interface EffectPaintPixels {
+    width: number;
+    height: number;
+    data: ArrayLike<number>;
+}
+/** The cache key of an effect paint (the same source renders the same pixels). */
+export declare function effectPaintKey(p: PaintEffectPaint): string;
+/** Whether a value is an effect paint (`{ type: 'effect', effect, … }`). */
+export declare function isPaintEffectPaint(raw: unknown): raw is PaintEffectPaint;
+/** A saved effect paint, or `null` when it is not one. */
+export declare function readPaintEffectPaint(raw: unknown): PaintEffectPaint | null;
+/**
+ * Takes a dab's colours from the effect: fills `field` (sRGB 0..1, 3 per pixel of `rect`, a
+ * document rectangle) with the effect's colour at each pixel and multiplies `vals` by its alpha.
+ * Pixels off the canvas paint nothing.
+ */
+export declare function sampleEffectField(img: EffectPaintPixels, rect: RasterRect, vals: Float32Array, field: Float32Array): void;
+/** The effect's colour (sRGB 0..1 into `out`) at a document point; returns its alpha 0..1 (0 off the canvas). */
+export declare function sampleEffectAt(img: EffectPaintPixels, x: number, y: number, out: [number, number, number]): number;

package/dist/paint-editor/effect-tools.d.cts

@@ -1,8 +1,8 @@
 /**
  * Agent tools for provider effects in the paint editor: the shared effect tools, where
  * `apply_effect` runs a filter (light, glow, grade) on a layer's dried paint and bakes it in, and
- * the target `paper` is the effect paper; plus `set_paper_effect`, `add_effect_layer` and
- * `fill_layer_with_effect`.
+ * the target `paper` is the effect paper and the target `paint` the effect paint; plus
+ * `set_paper_effect`, `add_effect_layer`, `fill_layer_with_effect` and `set_effect_paint`.
  */
 import type { AgentToolProvider } from '../tools/registry.cjs';
 import type { PaintEditorController } from './controller.cjs';
@@ -21,5 +21,7 @@ export interface PaintEffectsToolProviderOptions {
 }
 /** The target id of the effect paper. */
 export declare const PAPER_TARGET = "paper";
+/** The target id of the effect paint (what brushes paint with). */
+export declare const PAINT_TARGET = "paint";
 /** The effect tools for a paint editor (see the module comment). */
 export declare function createPaintEffectsToolProvider(controller: PaintEditorController, options?: PaintEffectsToolProviderOptions): AgentToolProvider;

package/dist/paint-editor/effect-tools.d.ts

@@ -1,8 +1,8 @@
 /**
  * Agent tools for provider effects in the paint editor: the shared effect tools, where
  * `apply_effect` runs a filter (light, glow, grade) on a layer's dried paint and bakes it in, and
- * the target `paper` is the effect paper; plus `set_paper_effect`, `add_effect_layer` and
- * `fill_layer_with_effect`.
+ * the target `paper` is the effect paper and the target `paint` the effect paint; plus
+ * `set_paper_effect`, `add_effect_layer`, `fill_layer_with_effect` and `set_effect_paint`.
  */
 import type { AgentToolProvider } from '../tools/registry.js';
 import type { PaintEditorController } from './controller.js';
@@ -21,5 +21,7 @@ export interface PaintEffectsToolProviderOptions {
 }
 /** The target id of the effect paper. */
 export declare const PAPER_TARGET = "paper";
+/** The target id of the effect paint (what brushes paint with). */
+export declare const PAINT_TARGET = "paint";
 /** The effect tools for a paint editor (see the module comment). */
 export declare function createPaintEffectsToolProvider(controller: PaintEditorController, options?: PaintEffectsToolProviderOptions): AgentToolProvider;

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

@@ -8,6 +8,7 @@
  * - **Effect fills**: a generator, overlay or title effect composited onto a layer's pixels.
  * - **Light on dried paint**: a filter effect (light, glow, grade) run on a layer's paint and baked
  *   in. Wet paint is dried first, in the same undo step; thick paint keeps its relief.
+ * - **Effect paint**: a generator, overlay or title effect brushes paint with (see `effect-paint.ts`).
  *
  * Effects render asynchronously, so each change renders first and commits after (one undo step).
  */
@@ -22,6 +23,8 @@ export declare const PAINT_EFFECT_PLACES: {
     readonly fill: readonly ["generator", "overlay", "title"];
     /** Light (or any filter) on a layer's dried paint. */
     readonly light: readonly ["filter"];
+    /** Effect paint: brushes take each pixel's colour from it. */
+    readonly paint: readonly ["generator", "overlay", "title"];
 };
 export type PaintEffectPlace = keyof typeof PAINT_EFFECT_PLACES;
 /** Refuses an effect that cannot go in `place`, saying what to use instead. */

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

@@ -8,6 +8,7 @@
  * - **Effect fills**: a generator, overlay or title effect composited onto a layer's pixels.
  * - **Light on dried paint**: a filter effect (light, glow, grade) run on a layer's paint and baked
  *   in. Wet paint is dried first, in the same undo step; thick paint keeps its relief.
+ * - **Effect paint**: a generator, overlay or title effect brushes paint with (see `effect-paint.ts`).
  *
  * Effects render asynchronously, so each change renders first and commits after (one undo step).
  */
@@ -22,6 +23,8 @@ export declare const PAINT_EFFECT_PLACES: {
     readonly fill: readonly ["generator", "overlay", "title"];
     /** Light (or any filter) on a layer's dried paint. */
     readonly light: readonly ["filter"];
+    /** Effect paint: brushes take each pixel's colour from it. */
+    readonly paint: readonly ["generator", "overlay", "title"];
 };
 export type PaintEffectPlace = keyof typeof PAINT_EFFECT_PLACES;
 /** Refuses an effect that cannot go in `place`, saying what to use instead. */

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

@@ -17,6 +17,7 @@
 import { CoverageMap, type BrushSettings, type Dab, type StrokePoint } from '../paint/brush.cjs';
 import type { RasterRect } from '../raster/surface.cjs';
 import type { PaintBrush } from './brushes.cjs';
+import { type EffectPaintPixels } from './effect-paint.cjs';
 import { type PaperGrain } from './paper.cjs';
 /** One pen sample in document pixels. Every channel but x and y is optional. */
 export interface PenPoint {
@@ -123,6 +124,8 @@ export interface DryStrokeOptions {
     seed?: number;
     /** Copies of the stroke (symmetry); default one identity copy. */
     copies?: readonly StrokeCopy[];
+    /** Effect paint: each pixel takes its colour (and alpha) from these canvas-sized pixels. */
+    effect?: EffectPaintPixels | null;
 }
 /**
  * One dab-engine stroke (dab and eraser brushes): smoothing, the dab walk of every copy, grain and
@@ -138,6 +141,7 @@ export declare class DryStroke {
     private readonly copies;
     private readonly depth;
     private buf;
+    private field;
     private lastRaw;
     private lastFed;
     constructor(brush: PaintBrush, options: DryStrokeOptions);

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

@@ -17,6 +17,7 @@
 import { CoverageMap, type BrushSettings, type Dab, type StrokePoint } from '../paint/brush.js';
 import type { RasterRect } from '../raster/surface.js';
 import type { PaintBrush } from './brushes.js';
+import { type EffectPaintPixels } from './effect-paint.js';
 import { type PaperGrain } from './paper.js';
 /** One pen sample in document pixels. Every channel but x and y is optional. */
 export interface PenPoint {
@@ -123,6 +124,8 @@ export interface DryStrokeOptions {
     seed?: number;
     /** Copies of the stroke (symmetry); default one identity copy. */
     copies?: readonly StrokeCopy[];
+    /** Effect paint: each pixel takes its colour (and alpha) from these canvas-sized pixels. */
+    effect?: EffectPaintPixels | null;
 }
 /**
  * One dab-engine stroke (dab and eraser brushes): smoothing, the dab walk of every copy, grain and
@@ -138,6 +141,7 @@ export declare class DryStroke {
     private readonly copies;
     private readonly depth;
     private buf;
+    private field;
     private lastRaw;
     private lastFed;
     constructor(brush: PaintBrush, options: DryStrokeOptions);