@pixerate/editor 0.267.0 → 0.268.1

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

@@ -39,7 +39,8 @@ 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 StickerRasterizer } from './sticker-art.js';
+import { type StickerArtLookup, type StickerRasterizer } from './sticker-art.js';
+import { BrushSourceArtCache } from './brush-source-art.js';
 import { StickersSlot } from '../stickers/helpers.js';
 import type { StickerProvider, StickerRef } from '../stickers/types.js';
 import { type LightSpill } from './light.js';
@@ -445,6 +446,10 @@ export declare class PaintEditorController {
     /** The sticker library slot (see `setStickersProvider`). */
     readonly stickers: StickersSlot;
     private readonly stickerArt;
+    /** Image sources strokes draw with: the brush library's and the open painting's (saved with it). */
+    readonly brushSources: BrushSourceArtCache;
+    /** Art for stamp tips and tip grain: image sources from `brushSources`, stickers from the sticker library. */
+    readonly stampArt: StickerArtLookup;
     private readonly rasterizeSticker;
     private readonly effectsRenderer;
     private paperEffectNodeCache;

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

@@ -76,6 +76,8 @@ export declare class PaintDabStroke {
     private lastFed;
     /** The stamp tip's shape (dab brushes), or `null` for the round computed tip. */
     private readonly stamp;
+    /** The tip's own grain, or `null`. */
+    private readonly tipGrain;
     constructor(brush: PaintBrush, options: PaintDabStrokeOptions);
     /** What copy 0's brush carries after the dabs so far (mixer and wet-capable dab brushes). */
     get load(): MixerLoad | null;

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

@@ -76,6 +76,8 @@ export declare class PaintDabStroke {
     private lastFed;
     /** The stamp tip's shape (dab brushes), or `null` for the round computed tip. */
     private readonly stamp;
+    /** The tip's own grain, or `null`. */
+    private readonly tipGrain;
     constructor(brush: PaintBrush, options: PaintDabStrokeOptions);
     /** What copy 0's brush carries after the dabs so far (mixer and wet-capable dab brushes). */
     get load(): MixerLoad | null;

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

@@ -88,6 +88,8 @@ export interface PenDab extends Dab {
     lean: number;
     /** Pen speed (px/ms), or `null` when the samples carry no time. */
     speed: number | null;
+    /** Mirrored across the tip's x axis (bit 1) and y axis (bit 2), from `dynamics.flip`; 0 or missing: not mirrored. */
+    flip?: number;
 }
 /**
  * Walks pen samples into dabs, incrementally (any chunking gives the same dabs). Dab angles are in
@@ -115,6 +117,8 @@ export declare class PenDabWalker {
     private dab;
     push(p: PenPoint, out: PenDab[]): void;
     finish(out: PenDab[]): void;
+    /** The dabs of one spacing step: `dynamics.count` of them, each with its own index and so its own jitter. */
+    private lay;
 }
 export interface DryStrokeOptions {
     /** The paper's dry height field, or `null` for no grain. */
@@ -127,7 +131,10 @@ export interface DryStrokeOptions {
     copies?: readonly StrokeCopy[];
     /** Effect paint: each pixel takes its colour (and alpha) from these canvas-sized pixels. */
     effect?: EffectPaintPixels | null;
-    /** Loaded sticker art, for a stamp tip of a sticker from the sticker library (`brush.stamp`); without it such a tip paints round. */
+    /**
+     * Loaded art for a stamp tip of a sticker or an image source (`brush.stamp`) and for an image
+     * tip grain (`brush.tipGrain.source`); without it such a tip paints round, and the grain is left out.
+     */
     stampArt?: StickerArtLookup;
 }
 /**
@@ -149,13 +156,15 @@ export declare class DryStroke {
     private lastFed;
     /** The stamp tip's shape, or `null` for the round computed tip. */
     private readonly stamp;
+    /** The tip's own grain, or `null`. */
+    private readonly tipGrain;
     constructor(brush: PaintBrush, options: DryStrokeOptions);
     /** Feeds raw pen samples; returns the document rectangles the new dabs touched. */
     push(points: readonly PenPoint[]): RasterRect[];
     /** Ends the stroke: the smoothed path catches up with the last raw sample; a single tap paints one dab. */
     finish(): RasterRect[];
     private paint;
-    /** Lays one mark (a dab, or a spray droplet of dab `d`): the round tip or the stamp, the paper grain, effect paint. */
+    /** Lays one mark (a dab, or a spray droplet of dab `d`): the round tip or the stamp, the tip grain, the paper grain, effect paint. */
     private mark;
 }
 /** The shared engine's tip for the Mixer Brush engine (it smooths and walks by itself, so smoothing is applied before). */

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

@@ -88,6 +88,8 @@ export interface PenDab extends Dab {
     lean: number;
     /** Pen speed (px/ms), or `null` when the samples carry no time. */
     speed: number | null;
+    /** Mirrored across the tip's x axis (bit 1) and y axis (bit 2), from `dynamics.flip`; 0 or missing: not mirrored. */
+    flip?: number;
 }
 /**
  * Walks pen samples into dabs, incrementally (any chunking gives the same dabs). Dab angles are in
@@ -115,6 +117,8 @@ export declare class PenDabWalker {
     private dab;
     push(p: PenPoint, out: PenDab[]): void;
     finish(out: PenDab[]): void;
+    /** The dabs of one spacing step: `dynamics.count` of them, each with its own index and so its own jitter. */
+    private lay;
 }
 export interface DryStrokeOptions {
     /** The paper's dry height field, or `null` for no grain. */
@@ -127,7 +131,10 @@ export interface DryStrokeOptions {
     copies?: readonly StrokeCopy[];
     /** Effect paint: each pixel takes its colour (and alpha) from these canvas-sized pixels. */
     effect?: EffectPaintPixels | null;
-    /** Loaded sticker art, for a stamp tip of a sticker from the sticker library (`brush.stamp`); without it such a tip paints round. */
+    /**
+     * Loaded art for a stamp tip of a sticker or an image source (`brush.stamp`) and for an image
+     * tip grain (`brush.tipGrain.source`); without it such a tip paints round, and the grain is left out.
+     */
     stampArt?: StickerArtLookup;
 }
 /**
@@ -149,13 +156,15 @@ export declare class DryStroke {
     private lastFed;
     /** The stamp tip's shape, or `null` for the round computed tip. */
     private readonly stamp;
+    /** The tip's own grain, or `null`. */
+    private readonly tipGrain;
     constructor(brush: PaintBrush, options: DryStrokeOptions);
     /** Feeds raw pen samples; returns the document rectangles the new dabs touched. */
     push(points: readonly PenPoint[]): RasterRect[];
     /** Ends the stroke: the smoothed path catches up with the last raw sample; a single tap paints one dab. */
     finish(): RasterRect[];
     private paint;
-    /** Lays one mark (a dab, or a spray droplet of dab `d`): the round tip or the stamp, the paper grain, effect paint. */
+    /** Lays one mark (a dab, or a spray droplet of dab `d`): the round tip or the stamp, the tip grain, the paper grain, effect paint. */
     private mark;
 }
 /** The shared engine's tip for the Mixer Brush engine (it smooths and walks by itself, so smoothing is applied before). */