@pixerate/editor 0.239.0 → 0.241.0

package/dist/paint-editor/live-strokes.d.cts

@@ -0,0 +1,24 @@
+/**
+ * Live stroke layers: a paint layer whose pixels are always drawn from its recorded strokes, so a
+ * stroke's brush, colour, paint, seed and points can be changed after it is painted
+ * (`PaintEditorController.updateStroke` and the rest). The document keeps the strokes
+ * (`liveStrokes`), and the layer's surface is a cache of them drawn bottom first.
+ *
+ * Only brushes whose result depends on the stroke itself can be redrawn exactly: dab, particle and
+ * bristle brushes, and the Mixer Brush, none of them picking up paint. Wet paint needs the
+ * simulation's history, thick paint has relief channels, stickers are their own objects, and
+ * smudges, blenders, pick-up brushes and erasers read the paint under them.
+ */
+import type { PaintBrush, PaintBrushEngine } from './brushes.cjs';
+import { type RecordedStroke } from './strokes.cjs';
+/** The engines a live stroke layer takes. */
+export declare const LIVE_STROKE_ENGINES: readonly PaintBrushEngine[];
+/** Why a brush can't paint on a live stroke layer, or `null` when it can. */
+export declare function liveStrokeRefusal(brush: PaintBrush): string | null;
+/** A stroke's extent in document pixels: its points and symmetry copies, padded by the brush. */
+export declare function liveStrokeBounds(stroke: RecordedStroke): {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};

package/dist/paint-editor/live-strokes.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Live stroke layers: a paint layer whose pixels are always drawn from its recorded strokes, so a
+ * stroke's brush, colour, paint, seed and points can be changed after it is painted
+ * (`PaintEditorController.updateStroke` and the rest). The document keeps the strokes
+ * (`liveStrokes`), and the layer's surface is a cache of them drawn bottom first.
+ *
+ * Only brushes whose result depends on the stroke itself can be redrawn exactly: dab, particle and
+ * bristle brushes, and the Mixer Brush, none of them picking up paint. Wet paint needs the
+ * simulation's history, thick paint has relief channels, stickers are their own objects, and
+ * smudges, blenders, pick-up brushes and erasers read the paint under them.
+ */
+import type { PaintBrush, PaintBrushEngine } from './brushes.js';
+import { type RecordedStroke } from './strokes.js';
+/** The engines a live stroke layer takes. */
+export declare const LIVE_STROKE_ENGINES: readonly PaintBrushEngine[];
+/** Why a brush can't paint on a live stroke layer, or `null` when it can. */
+export declare function liveStrokeRefusal(brush: PaintBrush): string | null;
+/** A stroke's extent in document pixels: its points and symmetry copies, padded by the brush. */
+export declare function liveStrokeBounds(stroke: RecordedStroke): {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};

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

@@ -14,6 +14,7 @@ import { TileMedium, type PaintTileTarget } from '../paint/exchange.cjs';
 import { type PaintGradientSource } from '../paint/gradient-paint.cjs';
 import type { PaintBrush } from './brushes.cjs';
 import { type PenPoint, type StrokeCopy } from './engine.cjs';
+import { type EffectPaintPixels } from './effect-paint.cjs';
 export type StampKind = 'dot' | 'star' | 'heart' | 'leaf' | 'flower' | 'confetti' | 'splat' | 'sparkle' | 'ring';
 export declare const STAMP_KINDS: readonly StampKind[];
 /** One sticker (document pixels). */
@@ -73,6 +74,11 @@ export interface StickerSprayInit {
     nextId: number;
     /** Gradient paint (resolved): each sticker takes its dab's colour (across the tip: by its offset). */
     paint?: PaintGradientSource | null;
+    /**
+     * Effect paint: each sticker takes the effect's colour at its centre (it keeps one colour, so it
+     * stays recolourable); none lands where the effect is transparent.
+     */
+    effect?: EffectPaintPixels | null;
 }
 /** A sticker-spray stroke: drops stickers along the path and draws them as it goes. */
 export declare class StickerSpray {

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

@@ -14,6 +14,7 @@ import { TileMedium, type PaintTileTarget } from '../paint/exchange.js';
 import { type PaintGradientSource } from '../paint/gradient-paint.js';
 import type { PaintBrush } from './brushes.js';
 import { type PenPoint, type StrokeCopy } from './engine.js';
+import { type EffectPaintPixels } from './effect-paint.js';
 export type StampKind = 'dot' | 'star' | 'heart' | 'leaf' | 'flower' | 'confetti' | 'splat' | 'sparkle' | 'ring';
 export declare const STAMP_KINDS: readonly StampKind[];
 /** One sticker (document pixels). */
@@ -73,6 +74,11 @@ export interface StickerSprayInit {
     nextId: number;
     /** Gradient paint (resolved): each sticker takes its dab's colour (across the tip: by its offset). */
     paint?: PaintGradientSource | null;
+    /**
+     * Effect paint: each sticker takes the effect's colour at its centre (it keeps one colour, so it
+     * stays recolourable); none lands where the effect is transparent.
+     */
+    effect?: EffectPaintPixels | null;
 }
 /** A sticker-spray stroke: drops stickers along the path and draws them as it goes. */
 export declare class StickerSpray {

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

@@ -15,6 +15,7 @@
  */
 import { type MixerLoad, type PaintTileTarget, type RgbTriple } from '../paint/exchange.cjs';
 import { type PaintGradientSource } from '../paint/gradient-paint.cjs';
+import { type EffectPaintPixels } from './effect-paint.cjs';
 import { TiledSurface, type RasterRect } from '../raster/surface.cjs';
 import type { PaintBrush } from './brushes.cjs';
 import { type PenPoint, type StrokeCopy } from './engine.cjs';
@@ -63,6 +64,8 @@ export interface ThickStrokeInit {
     copies: readonly StrokeCopy[];
     /** Gradient paint (resolved): the colour varies along the impasto. */
     paint?: PaintGradientSource | null;
+    /** Effect paint: each pixel's colour is the effect's there (its alpha scales the coverage); the relief is unchanged. */
+    effect?: EffectPaintPixels | null;
 }
 /** One impasto stroke: colour through the exchange, height and material into live channel tiles. */
 export declare class ThickStrokeDriver {
@@ -74,6 +77,7 @@ export declare class ThickStrokeDriver {
     private readonly height;
     private readonly material;
     private readonly paint;
+    private readonly centre;
     private tip;
     private lastRaw;
     private lastFed;

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

@@ -15,6 +15,7 @@
  */
 import { type MixerLoad, type PaintTileTarget, type RgbTriple } from '../paint/exchange.js';
 import { type PaintGradientSource } from '../paint/gradient-paint.js';
+import { type EffectPaintPixels } from './effect-paint.js';
 import { TiledSurface, type RasterRect } from '../raster/surface.js';
 import type { PaintBrush } from './brushes.js';
 import { type PenPoint, type StrokeCopy } from './engine.js';
@@ -63,6 +64,8 @@ export interface ThickStrokeInit {
     copies: readonly StrokeCopy[];
     /** Gradient paint (resolved): the colour varies along the impasto. */
     paint?: PaintGradientSource | null;
+    /** Effect paint: each pixel's colour is the effect's there (its alpha scales the coverage); the relief is unchanged. */
+    effect?: EffectPaintPixels | null;
 }
 /** One impasto stroke: colour through the exchange, height and material into live channel tiles. */
 export declare class ThickStrokeDriver {
@@ -74,6 +77,7 @@ export declare class ThickStrokeDriver {
     private readonly height;
     private readonly material;
     private readonly paint;
+    private readonly centre;
     private tip;
     private lastRaw;
     private lastFed;

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

@@ -34,7 +34,7 @@ export interface PaintPointerEvent extends PointerSample {
     getCoalescedEvents?(): PaintPointerEvent[];
     getPredictedEvents?(): PaintPointerEvent[];
 }
-export type PaintTool = 'brush' | 'eyedropper' | 'pan' | 'rotate' | 'sticker';
+export type PaintTool = 'brush' | 'eyedropper' | 'pan' | 'rotate' | 'sticker' | 'stroke';
 export declare const PAINT_TOOLS: ReadonlyArray<{
     id: PaintTool;
     label: string;
@@ -63,6 +63,17 @@ export declare class PaintGesture {
     private pen;
     /** Pointer down; returns true when the gesture took the pointer (capture it). */
     down(e: PaintPointerEvent): boolean;
+    /**
+     * The Select stroke tool, on a stroke layer: pressing a stroke picks it and dragging moves it
+     * (one undo step at the drop); pressing where no stroke painted clears the pick.
+     */
+    private strokeDown;
+    /** While a stroke is dragged: how far it has moved (document pixels), to draw its outline there. */
+    get strokeDrag(): {
+        id: string;
+        dx: number;
+        dy: number;
+    } | null;
     /**
      * The Stickers tool: pressing a sticker picks it and dragging moves it (one undo step at the
      * drop); pressing anywhere else places the active brush's first stamp there, at its tip size and
@@ -107,9 +118,16 @@ export declare class PaintCanvasPresenter {
     /** Draws what changed into `ctx` (a canvas the size of the document); returns the tiles drawn. */
     render(ctx: Paint2DContext): number;
 }
-export type GuideOverlayKind = 'symmetry' | 'perspective' | 'snap' | 'stencil' | 'sticker';
-/** Lines to draw over the canvas for the guides and the picked sticker, in document pixels, with a style key. */
-export declare function guideOverlay(controller: PaintEditorController): Array<{
+export type GuideOverlayKind = 'symmetry' | 'perspective' | 'snap' | 'stencil' | 'sticker' | 'stroke';
+/**
+ * Lines to draw over the canvas for the guides, the picked sticker and the picked stroke of a stroke layer (moved by
+ * `drag` while it is dragged), in document pixels, with a style key.
+ */
+export declare function guideOverlay(controller: PaintEditorController, drag?: {
+    id: string;
+    dx: number;
+    dy: number;
+} | null): Array<{
     from: Point2;
     to: Point2;
     kind: GuideOverlayKind;
@@ -238,6 +256,8 @@ export declare const STAMP_LABELS: Readonly<Record<StampKind, string>>;
 /** Toggles one stamp in a sticker brush's set (never leaving it empty). */
 export declare function toggleStamp(stamps: readonly StampKind[], stamp: StampKind): StampKind[];
 /** The sticker panel's sliders for the selected sticker. */
+/** The brush sliders of a picked stroke on a stroke layer (paths into its brush; see `updateStroke`). */
+export declare const STROKE_SLIDERS: readonly SliderControl[];
 export declare const STICKER_SLIDERS: readonly SliderControl[];
 /** Stencils a toolbar can lay with one click, centred on the canvas. */
 export declare function quickStencil(kind: 'ruler' | 'circle' | 'ellipse-mask' | 'edge-mask', canvas: {

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

@@ -34,7 +34,7 @@ export interface PaintPointerEvent extends PointerSample {
     getCoalescedEvents?(): PaintPointerEvent[];
     getPredictedEvents?(): PaintPointerEvent[];
 }
-export type PaintTool = 'brush' | 'eyedropper' | 'pan' | 'rotate' | 'sticker';
+export type PaintTool = 'brush' | 'eyedropper' | 'pan' | 'rotate' | 'sticker' | 'stroke';
 export declare const PAINT_TOOLS: ReadonlyArray<{
     id: PaintTool;
     label: string;
@@ -63,6 +63,17 @@ export declare class PaintGesture {
     private pen;
     /** Pointer down; returns true when the gesture took the pointer (capture it). */
     down(e: PaintPointerEvent): boolean;
+    /**
+     * The Select stroke tool, on a stroke layer: pressing a stroke picks it and dragging moves it
+     * (one undo step at the drop); pressing where no stroke painted clears the pick.
+     */
+    private strokeDown;
+    /** While a stroke is dragged: how far it has moved (document pixels), to draw its outline there. */
+    get strokeDrag(): {
+        id: string;
+        dx: number;
+        dy: number;
+    } | null;
     /**
      * The Stickers tool: pressing a sticker picks it and dragging moves it (one undo step at the
      * drop); pressing anywhere else places the active brush's first stamp there, at its tip size and
@@ -107,9 +118,16 @@ export declare class PaintCanvasPresenter {
     /** Draws what changed into `ctx` (a canvas the size of the document); returns the tiles drawn. */
     render(ctx: Paint2DContext): number;
 }
-export type GuideOverlayKind = 'symmetry' | 'perspective' | 'snap' | 'stencil' | 'sticker';
-/** Lines to draw over the canvas for the guides and the picked sticker, in document pixels, with a style key. */
-export declare function guideOverlay(controller: PaintEditorController): Array<{
+export type GuideOverlayKind = 'symmetry' | 'perspective' | 'snap' | 'stencil' | 'sticker' | 'stroke';
+/**
+ * Lines to draw over the canvas for the guides, the picked sticker and the picked stroke of a stroke layer (moved by
+ * `drag` while it is dragged), in document pixels, with a style key.
+ */
+export declare function guideOverlay(controller: PaintEditorController, drag?: {
+    id: string;
+    dx: number;
+    dy: number;
+} | null): Array<{
     from: Point2;
     to: Point2;
     kind: GuideOverlayKind;
@@ -238,6 +256,8 @@ export declare const STAMP_LABELS: Readonly<Record<StampKind, string>>;
 /** Toggles one stamp in a sticker brush's set (never leaving it empty). */
 export declare function toggleStamp(stamps: readonly StampKind[], stamp: StampKind): StampKind[];
 /** The sticker panel's sliders for the selected sticker. */
+/** The brush sliders of a picked stroke on a stroke layer (paths into its brush; see `updateStroke`). */
+export declare const STROKE_SLIDERS: readonly SliderControl[];
 export declare const STICKER_SLIDERS: readonly SliderControl[];
 /** Stencils a toolbar can lay with one click, centred on the canvas. */
 export declare function quickStencil(kind: 'ruler' | 'circle' | 'ellipse-mask' | 'edge-mask', canvas: {

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

@@ -24,6 +24,7 @@
 import { type MixerLoad, type RgbTriple } from '../paint/exchange.cjs';
 import { type WetFlowSpec } from '../paint/wet/flow.cjs';
 import { type PaintGradientSource } from '../paint/gradient-paint.cjs';
+import { type EffectPaintPixels } from './effect-paint.cjs';
 import { type WetParams, type WetTilt } from '../paint/wet/model.cjs';
 import { type WetGpuProvider } from '../paint/wet/gpu.cjs';
 import { WetWorld, type WetBackendInfo, type WetPaperInput, type WetSnapshot, type WetWorldOptions } from '../paint/wet/world.cjs';
@@ -53,6 +54,12 @@ export interface WetStrokeInit {
     } | null;
     /** Gradient paint (resolved): each dab's pigment comes from it. */
     paint?: PaintGradientSource | null;
+    /**
+     * Effect paint: each pixel's pigment is the effect's colour there (its alpha scales the
+     * coverage), shifted by the paint the brush picks up. It then flows, blooms and granulates with
+     * the water like any pigment.
+     */
+    effect?: EffectPaintPixels | null;
 }
 /**
  * One wet-brush stroke: pen samples → dabs → wet tool edits. Points are applied only while the
@@ -75,6 +82,7 @@ export declare class WetStrokeDriver {
     private tip;
     private cov;
     private readonly paint;
+    private readonly centre;
     private readonly depth;
     constructor(init: WetStrokeInit);
     private readonly sampler;

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

@@ -24,6 +24,7 @@
 import { type MixerLoad, type RgbTriple } from '../paint/exchange.js';
 import { type WetFlowSpec } from '../paint/wet/flow.js';
 import { type PaintGradientSource } from '../paint/gradient-paint.js';
+import { type EffectPaintPixels } from './effect-paint.js';
 import { type WetParams, type WetTilt } from '../paint/wet/model.js';
 import { type WetGpuProvider } from '../paint/wet/gpu.js';
 import { WetWorld, type WetBackendInfo, type WetPaperInput, type WetSnapshot, type WetWorldOptions } from '../paint/wet/world.js';
@@ -53,6 +54,12 @@ export interface WetStrokeInit {
     } | null;
     /** Gradient paint (resolved): each dab's pigment comes from it. */
     paint?: PaintGradientSource | null;
+    /**
+     * Effect paint: each pixel's pigment is the effect's colour there (its alpha scales the
+     * coverage), shifted by the paint the brush picks up. It then flows, blooms and granulates with
+     * the water like any pigment.
+     */
+    effect?: EffectPaintPixels | null;
 }
 /**
  * One wet-brush stroke: pen samples → dabs → wet tool edits. Points are applied only while the
@@ -75,6 +82,7 @@ export declare class WetStrokeDriver {
     private tip;
     private cov;
     private readonly paint;
+    private readonly centre;
     private readonly depth;
     constructor(init: WetStrokeInit);
     private readonly sampler;