@pixerate/editor 0.225.0 → 0.227.0

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);