@pixerate/editor 0.267.0 → 0.268.0

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

@@ -26,7 +26,9 @@ export * from './mixing-pad.cjs';
 export * from './controller.cjs';
 export * from './presence.cjs';
 export * from './tools.cjs';
-export { createPaintBrushLibraryToolProvider, paintBrushPreviewRenderer, type PaintBrushLibraryToolProviderOptions } from './brush-library-tools.cjs';
+export { createPaintBrushLibraryToolProvider, paintBrushPreviewRenderer, type PaintBrushLibraryToolProviderOptions, type PaintBrushPreviewOptions } from './brush-library-tools.cjs';
+export { BrushSourceArtCache, engineBrushSourceIds } from './brush-source-art.cjs';
+export { TipGrain, type TipGrainDab } from './tip-grain.cjs';
 export type { PaintAgentTool, PaintOrigin, PaintToolCoordinates } from './hosted.cjs';
 export * from './ui.cjs';
 export { BLEND_MODES, PAINTERLY_BLEND_MODES, isBlendMode, isPainterlyBlendMode, standardBlendMode, type BlendMode, type BlendModeInfo } from '../raster/blend.cjs';

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

@@ -26,7 +26,9 @@ export * from './mixing-pad.js';
 export * from './controller.js';
 export * from './presence.js';
 export * from './tools.js';
-export { createPaintBrushLibraryToolProvider, paintBrushPreviewRenderer, type PaintBrushLibraryToolProviderOptions } from './brush-library-tools.js';
+export { createPaintBrushLibraryToolProvider, paintBrushPreviewRenderer, type PaintBrushLibraryToolProviderOptions, type PaintBrushPreviewOptions } from './brush-library-tools.js';
+export { BrushSourceArtCache, engineBrushSourceIds } from './brush-source-art.js';
+export { TipGrain, type TipGrainDab } from './tip-grain.js';
 export type { PaintAgentTool, PaintOrigin, PaintToolCoordinates } from './hosted.js';
 export * from './ui.js';
 export { BLEND_MODES, PAINTERLY_BLEND_MODES, isBlendMode, isPainterlyBlendMode, standardBlendMode, type BlendMode, type BlendModeInfo } from '../raster/blend.js';

package/dist/paint-editor/index.js

@@ -11,7 +11,7 @@ import {
   mergeBrushPatch,
   multiColorSliders,
   patchBrushValue
-} from "../chunk-JGWVZPT6.js";
+} from "../chunk-3XDSNIGF.js";
 import {
   createStickerTools,
   describeStickerRef
@@ -19,7 +19,7 @@ import {
 import {
   BRUSH_PREVIEW_DARK_PAPER,
   brushPreviewsOnDark
-} from "../chunk-EYSHTYLG.js";
+} from "../chunk-LETF75CA.js";
 import {
   toVideoFfmpeg
 } from "../chunk-MWUZCEFT.js";
@@ -34,7 +34,7 @@ import {
   resolveExternalAssets,
   serializeLayers,
   serializeLayersExternal
-} from "../chunk-FGJHJIMN.js";
+} from "../chunk-74ODPZLX.js";
 import "../chunk-ADMRNWR7.js";
 import "../chunk-WJ4WQJCC.js";
 import {
@@ -60,7 +60,7 @@ import "../chunk-ZIF4UJJ6.js";
 import {
   createPigmentTools,
   pointerPressure
-} from "../chunk-7UKFXXWL.js";
+} from "../chunk-HVO6XCI4.js";
 import "../chunk-VWEWY4FY.js";
 import "../chunk-HVQVHUTV.js";
 import {
@@ -85,6 +85,7 @@ import {
   PaintWetLayers,
   PenDabWalker,
   PenSmoother,
+  TipGrain,
   WET_GPU_MODES,
   WET_MEDIUM_PARAMS,
   WetStrokeDriver,
@@ -112,13 +113,14 @@ import {
   toStrokePoint,
   wetPaperInput,
   wetPigmentOf
-} from "../chunk-4IDUYB45.js";
+} from "../chunk-UVTO3D4E.js";
 import {
   BRUSH_ID,
   BRUSH_PRESETS,
   BRUSH_ROTATIONS,
   BUILTIN_BRUSHES,
   BrushLibraryError,
+  DAB_FLIPS,
   DEFAULT_BEHAVIOR,
   DEFAULT_BRISTLE,
   DEFAULT_BRUSH_ID,
@@ -129,6 +131,7 @@ import {
   DEFAULT_PARTICLE,
   DEFAULT_SPRAY,
   DEFAULT_STICKER,
+  DEFAULT_TIP_GRAIN,
   DEFAULT_WET_BRUSH,
   DOT_ROTATIONS,
   DOT_TEXTURE_ORDERS,
@@ -142,12 +145,17 @@ import {
   PARTICLE_KINDS,
   PARTICLE_RENDERS,
   RIBBON_PAIRS,
+  TIP_GRAIN_MODES,
   WET_MEDIA,
   WET_TOOLS,
+  brushSourceIdOf,
+  brushSourceIds,
   brushTakesPaint,
   brushToJSON,
   closest,
   createBrushLibrary,
+  decodeBrushSource,
+  isBrushSourceRef,
   isWetBrush,
   isWetCapable,
   migrateBrushV1,
@@ -165,9 +173,10 @@ import {
   normalizeWetBrush,
   paintToMultiColor,
   parseBrushLibrary,
+  readBrushSource,
   resolveBrush,
   usesPaintExchange
-} from "../chunk-AGNUD5BI.js";
+} from "../chunk-KZI3YWKW.js";
 import {
   STAMP_KINDS,
   StickersSlot,
@@ -215,18 +224,14 @@ import {
   pigmentOf,
   wetSupport
 } from "../chunk-GSTSZPSR.js";
-import {
-  GRAIN_PATTERNS,
-  GRAIN_TILE,
-  PaperGrain,
-  grainCatch,
-  grainHeights
-} from "../chunk-TXFWZ5ZJ.js";
+import "../chunk-W6JDUXP3.js";
 import {
   CoverageMap,
   DEFAULT_PAINT_GRADIENT,
   DEFAULT_PAINT_GRADIENT_MAPPING,
   EMPTY_MIXER_LOAD,
+  GRAIN_PATTERNS,
+  GRAIN_TILE,
   MAX_BRUSH_SIZE,
   PAINT_COLOR_JSON_SCHEMA,
   PAINT_GRADIENT_FULL_SPEED,
@@ -243,6 +248,7 @@ import {
   PaintExchange,
   PaintGradientSampler,
   PaintSourceError,
+  PaperGrain,
   SmudgeTip,
   TIP_GRADIENT_STEPS,
   TileMedium,
@@ -251,6 +257,8 @@ import {
   cleanMixer,
   dabRect,
   exchangeRates,
+  grainCatch,
+  grainHeights,
   hexToPaintRgb,
   isGradientPaint,
   loadMixer,
@@ -267,7 +275,7 @@ import {
   scalePaintGradient,
   solidPaint,
   updatePaintGradientStop
-} from "../chunk-GCVFEPJG.js";
+} from "../chunk-ACTHSQOI.js";
 import {
   TileableNoise,
   hash2,
@@ -277,6 +285,14 @@ import {
   seedFromString
 } from "../chunk-4D6KP5BV.js";
 import "../chunk-ODBT55Q7.js";
+import {
+  BLEND_MODES,
+  PAINTERLY_BLEND_MODES,
+  isBlendMode,
+  isPainterlyBlendMode,
+  mixPigments,
+  standardBlendMode
+} from "../chunk-IRSTHLQQ.js";
 import {
   base64ToBytes,
   bytesToBase64,
@@ -286,14 +302,6 @@ import {
   parseDataUrl,
   pngDataUrl
 } from "../chunk-OTTT5N3K.js";
-import {
-  BLEND_MODES,
-  PAINTERLY_BLEND_MODES,
-  isBlendMode,
-  isPainterlyBlendMode,
-  mixPigments,
-  standardBlendMode
-} from "../chunk-IRSTHLQQ.js";
 import {
   TILE,
   TiledSurface,
@@ -3089,7 +3097,7 @@ function thumbnailStroke(width, height) {
   }
   return pts;
 }
-function paintTestStroke(surface, brush, paper, color, width, height) {
+function paintTestStroke(surface, brush, paper, color, width, height, stampArt) {
   const [r, g, b] = hexToRgb8(color);
   let result = surface;
   let thick = null;
@@ -3121,7 +3129,8 @@ function paintTestStroke(surface, brush, paper, color, width, height) {
       mixerLoad: brushLoadForStroke(brush, EMPTY_MIXER_LOAD, [r / 255, g / 255, b / 255]),
       thick: brush.engine === "impasto" ? { channels: emptyThickChannels() } : void 0,
       sticker: brush.engine === "sticker" ? { nextId: 1 } : void 0,
-      light: brush.light.amount > 0 && brush.engine !== "wet" && brush.engine !== "sticker" ? { surface: emptyLight() } : null
+      light: brush.light.amount > 0 && brush.engine !== "wet" && brush.engine !== "sticker" ? { surface: emptyLight() } : null,
+      stampArt
     }
   );
   session.push(thumbnailStroke(width, height));
@@ -3146,7 +3155,7 @@ function renderBrushThumbnail(brush, options) {
   }
   let light = null;
   if (b.engine === "wet") surface = paintWetTestStroke(b, options.paper, options.color, width, height);
-  else ({ surface, light } = paintTestStroke(surface, b, options.paper, options.color, width, height));
+  else ({ surface, light } = paintTestStroke(surface, b, options.paper, options.color, width, height, options.stampArt));
   const layer = { type: "pixel", id: "thumbnail", name: "thumbnail", visible: true, opacity: 1, blend: "normal", surface, offset: { x: 0, y: 0 } };
   const paper = light && brushPreviewsOnDark(b) ? { ...options.paper, color: BRUSH_PREVIEW_DARK_PAPER } : options.paper;
   const spill = light ? computeSpill(surface, light, { radius: Math.max(4, height / 6), strength: 1 }) : null;
@@ -3736,6 +3745,59 @@ function samplePath(d, options = {}) {
   return out;
 }
 
+// src/paint-editor/brush-source-art.ts
+var BrushSourceArtCache = class {
+  sources = /* @__PURE__ */ new Map();
+  art = /* @__PURE__ */ new Map();
+  /** Adds or replaces sources (a replaced image is decoded again). */
+  set(sources) {
+    for (const s of sources) {
+      const was = this.sources.get(s.id);
+      if (was && was.image === s.image) continue;
+      this.sources.set(s.id, s);
+      this.art.delete(s.id);
+    }
+  }
+  /** The source of an id, if known. */
+  source(id) {
+    return this.sources.get(id);
+  }
+  /** Every known source. */
+  all() {
+    return [...this.sources.values()];
+  }
+  /** The art of a `source:<id>` ref (alpha = the mask), or `undefined` when the source is unknown or its image can't be read. */
+  get = (ref2) => {
+    const id = brushSourceIdOf(ref2);
+    if (id === null) return void 0;
+    if (this.art.has(id)) return this.art.get(id) ?? void 0;
+    const source = this.sources.get(id);
+    if (!source) return void 0;
+    let art = null;
+    try {
+      const { width, height, mask } = decodeBrushSource(source);
+      const data = new Uint8ClampedArray(width * height * 4);
+      for (let i = 0; i < mask.length; i++) {
+        data[i * 4] = data[i * 4 + 1] = data[i * 4 + 2] = 255;
+        data[i * 4 + 3] = mask[i];
+      }
+      art = { width, height, data, tintable: true };
+    } catch {
+      art = null;
+    }
+    this.art.set(id, art);
+    return art ?? void 0;
+  };
+  /** A lookup that reads sources from here and every other ref from `stickers`. */
+  with(stickers) {
+    return (ref2, variant) => isBrushSourceRef(ref2) ? this.get(ref2) : stickers(ref2, variant);
+  }
+};
+function engineBrushSourceIds(brush) {
+  const refs = [brush.stamp, brush.tipGrain?.source, ...brush.particle?.dotTextures ?? []];
+  return [...new Set(refs.filter((r) => !!r && isBrushSourceRef(r)).map((r) => brushSourceIdOf(r)))];
+}
+
 // src/paint-editor/live-strokes.ts
 var LIVE_STROKE_ENGINES = ["dab", "particle", "bristle", "mixer"];
 function liveStrokeRefusal(brush) {
@@ -4445,6 +4507,10 @@ var PaintEditorController = class _PaintEditorController {
   /** The sticker library slot (see `setStickersProvider`). */
   stickers = new StickersSlot(editorStickers());
   stickerArt = new StickerArtCache();
+  /** Image sources strokes draw with: the brush library's and the open painting's (saved with it). */
+  brushSources = new BrushSourceArtCache();
+  /** Art for stamp tips and tip grain: image sources from `brushSources`, stickers from the sticker library. */
+  stampArt = (ref2, variant) => isBrushSourceRef(ref2) ? this.brushSources.get(ref2) : this.stickerArt.get(ref2, variant);
   rasterizeSticker;
   effectsRenderer = new PaintEffectsRenderer();
   paperEffectNodeCache = null;
@@ -5808,7 +5874,10 @@ var PaintEditorController = class _PaintEditorController {
   }
   /** Reads the library again (after a change anywhere it is shared). */
   refreshBrushes() {
-    const run = this.brushLibrary.list().then((entries) => {
+    const library = this.brushLibrary;
+    const sources = typeof library.listSources === "function" ? library.listSources().catch(() => []) : Promise.resolve([]);
+    const run = Promise.all([library.list(), sources]).then(([entries, list]) => {
+      this.brushSources.set(list);
       this.brushEntries = entries.map((e) => libraryBrush(e.brush, e.builtin));
       this.library = null;
       const pending = this.pendingBrushId;
@@ -5955,7 +6024,7 @@ var PaintEditorController = class _PaintEditorController {
   /** A thumbnail of a brush: a test stroke on the current paper. */
   brushThumbnail(id, options = {}) {
     const b = id === this.brush.id ? this.brush : this.requireBrush(id);
-    return renderBrushThumbnail(b, { paper: this.doc.paper, width: options.width, height: options.height, color: options.color ? parseColor(options.color) : this.color });
+    return renderBrushThumbnail(b, { paper: this.doc.paper, width: options.width, height: options.height, color: options.color ? parseColor(options.color) : this.color, stampArt: this.stampArt });
   }
   // --- Colour --------------------------------------------------------------------
   colorScheme;
@@ -6258,7 +6327,7 @@ var PaintEditorController = class _PaintEditorController {
       // Light paint: a twin of the stroke paints the light channel (laying, dimming, moving light).
       light: !wet && brush.engine !== "sticker" && (brush.light.amount > 0 || doc.light?.[layer.id]) ? { surface: doc.light?.[layer.id] ?? emptyLight() } : null,
       sticker: brush.engine === "sticker" ? { nextId: this.nextStickerNumber(doc), art: this.stickerArt.get, variant: (ref2) => this.stickerArt.variantFor(ref2, this.colorScheme === "dark") } : void 0,
-      stampArt: this.stickerArt.get,
+      stampArt: this.stampArt,
       paint: effect ? null : this.strokeGradient(init, brush, color),
       effect
     });
@@ -6636,6 +6705,7 @@ var PaintEditorController = class _PaintEditorController {
     if (w > 16384 || h > 16384) throw new PaintEditorError(`At scale ${scale} the canvas would be ${w}\xD7${h}; the limit is 16384 px per side. Use a smaller scale.`);
     const target = new _PaintEditorController({ width: w, height: h, dpi: dpi * scale, brushLibrary: this.brushLibrary, wet: this.wetOptions });
     target.brushEntries = this.brushEntries;
+    target.brushSources.set(this.brushSources.all());
     const paper = { ...this.doc.paper, scale: Math.min(8, this.doc.paper.scale * scale) };
     target.adopt({ state: { canvas: target.doc.canvas, paper, layers: emptiedLayers(this.doc.layers), activeLayerId: this.doc.activeLayerId, strokes: [] }, extensions: {}, problems: [] });
     target.lighting = { ...this.lighting };
@@ -7074,6 +7144,11 @@ var PaintEditorController = class _PaintEditorController {
     for (const [id, list] of Object.entries(this.doc.liveStrokes ?? {})) if (findLayer(this.doc.layers, id)) liveStrokes[id] = list.map(strokeToJSON);
     if (Object.keys(liveStrokes).length) ext.liveStrokes = liveStrokes;
     else delete ext.liveStrokes;
+    const strokes = [...this.doc.strokes, ...Object.values(this.doc.liveStrokes ?? {}).flat()];
+    const sourceIds = [...new Set(strokes.flatMap((st) => engineBrushSourceIds(st.brush)))];
+    const sources = sourceIds.map((id) => this.brushSources.source(id)).filter((x) => x !== void 0);
+    if (sources.length) ext.brushSources = sources.map((x) => ({ ...x }));
+    else delete ext.brushSources;
     const light = {};
     for (const [id, t] of Object.entries(this.doc.light ?? {})) {
       if (!findLayer(this.doc.layers, id)) continue;
@@ -7096,6 +7171,7 @@ var PaintEditorController = class _PaintEditorController {
   }
   /** Reads `layerChannels` and `lighting` from loaded extensions into the document. */
   readThick(state, ext, problems) {
+    if (Array.isArray(ext.brushSources)) this.brushSources.set(ext.brushSources.map((x, i) => readBrushSource(x, `brushSources[${i}]`, problems)).filter((x) => x !== null));
     this.lighting = normalizeLighting(ext.lighting ?? {}, DEFAULT_LIGHTING);
     this.litCaches.clear();
     if (ext.stickers && typeof ext.stickers === "object") {
@@ -7214,6 +7290,7 @@ var PaintEditorController = class _PaintEditorController {
     delete this.extensions.lighting;
     delete this.extensions.stickers;
     delete this.extensions.liveStrokes;
+    delete this.extensions.brushSources;
     delete this.extensions.effectLayers;
     delete this.extensions.paperEffect;
     this.viewCompositor.clear();
@@ -10691,11 +10768,23 @@ function strokeSummary(s, withPoints, live) {
 }
 
 // src/paint-editor/brush-library-tools.ts
-function paintBrushPreviewRenderer(paper = () => DEFAULT_PAPER) {
-  const render = (brush, { width, height, color }) => {
-    const t = renderBrushThumbnail(resolveBrush(brush), { paper: paper(), width, height, color: color.toLowerCase() });
+function paintBrushPreviewRenderer(paper = () => DEFAULT_PAPER, options = {}) {
+  const sources = new BrushSourceArtCache();
+  const draw = (brush, { width, height, color }) => {
+    const stickers = options.stampArt?.();
+    const stampArt = sources.with(stickers ?? (() => void 0));
+    const t = renderBrushThumbnail(resolveBrush(brush), { paper: paper(), width, height, color: color.toLowerCase(), stampArt });
     return { data: bytesToBase64(encodePng(t.width, t.height, t.data)), mimeType: "image/png" };
   };
+  const render = (brush, size) => {
+    const ids = brushSourceIds(brush);
+    if (!ids.length || !options.library) return draw(brush, size);
+    const library = options.library;
+    return Promise.all(ids.map((id) => library.getSource(id))).then((found) => {
+      sources.set(found.filter((s) => s !== null));
+      return draw(brush, size);
+    });
+  };
   return Object.defineProperty(render, "paper", { get: () => paper().color, enumerable: true });
 }
 function createPaintBrushLibraryToolProvider(controller, options = {}) {
@@ -10703,7 +10792,7 @@ function createPaintBrushLibraryToolProvider(controller, options = {}) {
     profile: PAINT_PROFILE,
     stickers: () => controller.stickers.provider,
     ...options,
-    renderPreview: paintBrushPreviewRenderer(() => controller.getState().document.paper)
+    renderPreview: paintBrushPreviewRenderer(() => controller.getState().document.paper, { library: controller.brushLibrary, stampArt: () => controller.stampArt })
   });
 }
 
@@ -12074,6 +12163,8 @@ export {
   BRUSH_SLIDERS,
   BUILTIN_BRUSHES,
   BristleStroke,
+  BrushSourceArtCache,
+  DAB_FLIPS,
   DEFAULT_BACKLIGHT_COLOR,
   DEFAULT_BEHAVIOR,
   DEFAULT_BRISTLE,
@@ -12092,6 +12183,7 @@ export {
   DEFAULT_SPRAY,
   DEFAULT_STICKER,
   DEFAULT_SWATCHES,
+  DEFAULT_TIP_GRAIN,
   DEFAULT_VIEW,
   DEFAULT_WET_BRUSH,
   DEFAULT_WET_PARAMS,
@@ -12197,9 +12289,11 @@ export {
   StickerArtCache,
   StickerBrowser,
   StickerSpray,
+  TIP_GRAIN_MODES,
   TRACING_NODE_ID,
   ThickStrokeDriver,
   TileableNoise,
+  TipGrain,
   WET_FLOW_KINDS,
   WET_GPU_MODES,
   WET_GPU_OPTIONS,
@@ -12264,6 +12358,7 @@ export {
   effectPaintSize,
   emptiedLayers,
   emptyThickChannels,
+  engineBrushSourceIds,
   fitZoom,
   grainCatch,
   grainHeights,

package/dist/paint-editor/stamp-tip.d.cts

@@ -10,11 +10,12 @@ import type { StickerArtLookup } from './sticker-art.cjs';
 /** Coverage 0..1 of a stamp at (u, v) of its unit square (−1..1, y down); `seed` varies shapes with random parts. */
 export type StampSampler = (u: number, v: number, seed: number) => number;
 /**
- * The sampler of a stamp ref: an editor stamp's coverage, or the alpha of a sticker's loaded art
- * (bilinear, centred in the unit square, aspect kept). `null` when the art is not loaded (or the
- * ref is not a sticker): the caller paints the round tip instead.
+ * The sampler of a stamp ref: an editor stamp's coverage, or the alpha of a sticker's or an image
+ * source's loaded art (bilinear, centred in the unit square, aspect kept). `null` when the art is
+ * not loaded (or the ref is not a sticker): the caller paints the round tip instead. `hardness`
+ * below 1 softens an image source's edges.
  */
-export declare function stampSampler(ref: string, art?: StickerArtLookup): StampSampler | null;
+export declare function stampSampler(ref: string, art?: StickerArtLookup, hardness?: number): StampSampler | null;
 /** A dab of a stamp tip: centre, radius (px), roundness squashing it across, angle (radians, counter-clockwise) and flow. */
 export interface StampDab {
     x: number;
@@ -23,6 +24,8 @@ export interface StampDab {
     roundness: number;
     angle: number;
     alpha: number;
+    /** Mirrored across the tip's x axis (bit 1) and y axis (bit 2). */
+    flip?: number;
 }
 /** The pixel rectangle a stamp dab can touch. */
 export declare function stampDabRect(d: StampDab): CropBox;
@@ -32,7 +35,7 @@ export declare function stampDabRect(d: StampDab): CropBox;
  * Small dabs are supersampled.
  */
 export declare function rasterizeStampDab(d: StampDab, sample: StampSampler, seed: number, rect: CropBox, out: Float32Array): void;
-/** The sticker refs a brush lays that need loaded art (provider stickers; editor stamps need none). */
+/** The sticker refs a brush lays that need loaded art (provider stickers; editor stamps and image sources need none). */
 export declare function brushStickerRefs(brush: {
     engine: string;
     stamp: string | null;

package/dist/paint-editor/stamp-tip.d.ts

@@ -10,11 +10,12 @@ import type { StickerArtLookup } from './sticker-art.js';
 /** Coverage 0..1 of a stamp at (u, v) of its unit square (−1..1, y down); `seed` varies shapes with random parts. */
 export type StampSampler = (u: number, v: number, seed: number) => number;
 /**
- * The sampler of a stamp ref: an editor stamp's coverage, or the alpha of a sticker's loaded art
- * (bilinear, centred in the unit square, aspect kept). `null` when the art is not loaded (or the
- * ref is not a sticker): the caller paints the round tip instead.
+ * The sampler of a stamp ref: an editor stamp's coverage, or the alpha of a sticker's or an image
+ * source's loaded art (bilinear, centred in the unit square, aspect kept). `null` when the art is
+ * not loaded (or the ref is not a sticker): the caller paints the round tip instead. `hardness`
+ * below 1 softens an image source's edges.
  */
-export declare function stampSampler(ref: string, art?: StickerArtLookup): StampSampler | null;
+export declare function stampSampler(ref: string, art?: StickerArtLookup, hardness?: number): StampSampler | null;
 /** A dab of a stamp tip: centre, radius (px), roundness squashing it across, angle (radians, counter-clockwise) and flow. */
 export interface StampDab {
     x: number;
@@ -23,6 +24,8 @@ export interface StampDab {
     roundness: number;
     angle: number;
     alpha: number;
+    /** Mirrored across the tip's x axis (bit 1) and y axis (bit 2). */
+    flip?: number;
 }
 /** The pixel rectangle a stamp dab can touch. */
 export declare function stampDabRect(d: StampDab): CropBox;
@@ -32,7 +35,7 @@ export declare function stampDabRect(d: StampDab): CropBox;
  * Small dabs are supersampled.
  */
 export declare function rasterizeStampDab(d: StampDab, sample: StampSampler, seed: number, rect: CropBox, out: Float32Array): void;
-/** The sticker refs a brush lays that need loaded art (provider stickers; editor stamps need none). */
+/** The sticker refs a brush lays that need loaded art (provider stickers; editor stamps and image sources need none). */
 export declare function brushStickerRefs(brush: {
     engine: string;
     stamp: string | null;

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

@@ -6,6 +6,7 @@
 import { type PaintBrush } from './brushes.cjs';
 import type { PenPoint } from './engine.cjs';
 import { type PaperSettings } from './paper.cjs';
+import type { StickerArtLookup } from './sticker-art.cjs';
 export interface BrushThumbnail {
     width: number;
     height: number;
@@ -14,9 +15,14 @@ export interface BrushThumbnail {
 }
 /** The test stroke's samples for a `width × height` thumbnail. */
 export declare function thumbnailStroke(width: number, height: number): PenPoint[];
+/**
+ * A sample stroke with `brush` on `paper`. `stampArt` draws stamp tips of stickers and image
+ * sources, and image tip grain (without it they paint round, and without the grain).
+ */
 export declare function renderBrushThumbnail(brush: PaintBrush, options: {
     paper: PaperSettings;
     width?: number;
     height?: number;
     color: string;
+    stampArt?: StickerArtLookup;
 }): BrushThumbnail;

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

@@ -6,6 +6,7 @@
 import { type PaintBrush } from './brushes.js';
 import type { PenPoint } from './engine.js';
 import { type PaperSettings } from './paper.js';
+import type { StickerArtLookup } from './sticker-art.js';
 export interface BrushThumbnail {
     width: number;
     height: number;
@@ -14,9 +15,14 @@ export interface BrushThumbnail {
 }
 /** The test stroke's samples for a `width × height` thumbnail. */
 export declare function thumbnailStroke(width: number, height: number): PenPoint[];
+/**
+ * A sample stroke with `brush` on `paper`. `stampArt` draws stamp tips of stickers and image
+ * sources, and image tip grain (without it they paint round, and without the grain).
+ */
 export declare function renderBrushThumbnail(brush: PaintBrush, options: {
     paper: PaperSettings;
     width?: number;
     height?: number;
     color: string;
+    stampArt?: StickerArtLookup;
 }): BrushThumbnail;

package/dist/paint-editor/tip-grain.d.cts

@@ -0,0 +1,34 @@
+/**
+ * Tip grain: texture inside each dab (Procreate's grain source), separate from the paper's grain.
+ * The texture is a built-in grain pattern or an image source (`source:<id>`, light parts are
+ * peaks), tiled. `texturised` grain stays put on the canvas; `moving` grain is read in the tip's
+ * own frame, offset by the distance travelled, so it rolls along the stroke and turns with the tip.
+ *
+ * A dab's coverage is multiplied by `1 − depth × (1 − height)`. Everything is a function of the
+ * dab (position, angle, travel), so replays and repaints at another scale lay the same grain.
+ */
+import type { RasterRect } from '../raster/surface.cjs';
+import type { TipGrainSettings } from './brush-model.cjs';
+import type { StickerArtLookup } from './sticker-art.cjs';
+/** What the grain needs of a dab. */
+export interface TipGrainDab {
+    x: number;
+    y: number;
+    /** Radians, counter-clockwise with y up. */
+    angle: number;
+    /** Path length travelled to the dab (px). */
+    travel: number;
+}
+/** A brush's tip grain, ready to apply to dabs. */
+export declare class TipGrain {
+    private readonly field;
+    private readonly settings;
+    private constructor();
+    /**
+     * The grain for `settings`, or `null` when there is none to apply: no depth, or an image source
+     * whose art is not loaded (the dabs then paint without it).
+     */
+    static create(settings: TipGrainSettings | undefined, art?: StickerArtLookup): TipGrain | null;
+    /** Multiplies the dab's coverage `vals` (over `rect`) by the grain. */
+    apply(vals: Float32Array, rect: RasterRect, d: TipGrainDab): void;
+}

package/dist/paint-editor/tip-grain.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Tip grain: texture inside each dab (Procreate's grain source), separate from the paper's grain.
+ * The texture is a built-in grain pattern or an image source (`source:<id>`, light parts are
+ * peaks), tiled. `texturised` grain stays put on the canvas; `moving` grain is read in the tip's
+ * own frame, offset by the distance travelled, so it rolls along the stroke and turns with the tip.
+ *
+ * A dab's coverage is multiplied by `1 − depth × (1 − height)`. Everything is a function of the
+ * dab (position, angle, travel), so replays and repaints at another scale lay the same grain.
+ */
+import type { RasterRect } from '../raster/surface.js';
+import type { TipGrainSettings } from './brush-model.js';
+import type { StickerArtLookup } from './sticker-art.js';
+/** What the grain needs of a dab. */
+export interface TipGrainDab {
+    x: number;
+    y: number;
+    /** Radians, counter-clockwise with y up. */
+    angle: number;
+    /** Path length travelled to the dab (px). */
+    travel: number;
+}
+/** A brush's tip grain, ready to apply to dabs. */
+export declare class TipGrain {
+    private readonly field;
+    private readonly settings;
+    private constructor();
+    /**
+     * The grain for `settings`, or `null` when there is none to apply: no depth, or an image source
+     * whose art is not loaded (the dabs then paint without it).
+     */
+    static create(settings: TipGrainSettings | undefined, art?: StickerArtLookup): TipGrain | null;
+    /** Multiplies the dab's coverage `vals` (over `rect`) by the grain. */
+    apply(vals: Float32Array, rect: RasterRect, d: TipGrainDab): void;
+}

package/dist/raster/index.cjs

@@ -79,7 +79,6 @@ var _chunkK6PXS6DOcjs = require('../chunk-K6PXS6DO.cjs');
 
 
 
-var _chunkW5M3J7PVcjs = require('../chunk-W5M3J7PV.cjs');
 
 
 
@@ -114,6 +113,7 @@ var _chunkW5M3J7PVcjs = require('../chunk-W5M3J7PV.cjs');
 
 
 
+var _chunk2VX55NFMcjs = require('../chunk-2VX55NFM.cjs');
 
 
 
@@ -122,7 +122,7 @@ var _chunkW5M3J7PVcjs = require('../chunk-W5M3J7PV.cjs');
 
 
 
-var _chunk2VX55NFMcjs = require('../chunk-2VX55NFM.cjs');
+var _chunkW5M3J7PVcjs = require('../chunk-W5M3J7PV.cjs');
 
 
 

package/dist/raster/index.js

@@ -71,15 +71,6 @@ import {
   DIRECT_GAUSSIAN_MAX_SIGMA,
   gaussianBlur
 } from "../chunk-ZIF4UJJ6.js";
-import {
-  base64ToBytes,
-  bytesToBase64,
-  decodePng,
-  encodePng,
-  isPng,
-  parseDataUrl,
-  pngDataUrl
-} from "../chunk-OTTT5N3K.js";
 import {
   BIT_DEPTHS,
   BLEND_MODES,
@@ -123,6 +114,15 @@ import {
   to8From32,
   writeDeepRegion
 } from "../chunk-IRSTHLQQ.js";
+import {
+  base64ToBytes,
+  bytesToBase64,
+  decodePng,
+  encodePng,
+  isPng,
+  parseDataUrl,
+  pngDataUrl
+} from "../chunk-OTTT5N3K.js";
 import {
   SurfaceDraft,
   TILE,