@pixerate/editor 0.267.0 → 0.268.1

package/dist/{chunk-XVOP3CGQ.cjs → chunk-EU2ZZA6L.cjs}

@@ -18,11 +18,17 @@ var _chunkWOFXZ3XUcjs = require('./chunk-WOFXZ3XU.cjs');
 
 
 
-var _chunkFQPUF2W2cjs = require('./chunk-FQPUF2W2.cjs');
+
+var _chunkNIBFKXMDcjs = require('./chunk-NIBFKXMD.cjs');
 
 
 var _chunk2VX55NFMcjs = require('./chunk-2VX55NFM.cjs');
 
+
+
+
+var _chunkW5M3J7PVcjs = require('./chunk-W5M3J7PV.cjs');
+
 // src/brushes/presets.ts
 var BRUSH_PRESETS = [
   {
@@ -908,6 +914,9 @@ var MULTI_COLOR_MODES = ["off", "tip", "dab"];
 var DEFAULT_MULTI_COLOR = { mode: "off", colors: [], order: "sequence", length: 12, softness: 1 };
 var DEFAULT_BEHAVIOR = { pickup: 0, mix: 0.5, dirty: false, mixing: "pigment", multicolor: DEFAULT_MULTI_COLOR };
 var BRUSH_ROTATIONS = ["fixed", "stroke", "barrel"];
+var DAB_FLIPS = ["none", "x", "y", "xy"];
+var TIP_GRAIN_MODES = ["moving", "texturised"];
+var DEFAULT_TIP_GRAIN = { mode: "texturised", scale: 1, depth: 0.6, contrast: 1, invert: false };
 var DEFAULT_DYNAMICS = {
   minSize: 0,
   pressureFlow: 0,
@@ -935,7 +944,8 @@ function normalizeDynamics(raw = {}, base = DEFAULT_DYNAMICS) {
     sizeJitter: unit2(raw.sizeJitter, base.sizeJitter),
     angleJitter: unit2(raw.angleJitter, base.angleJitter),
     opacityJitter: unit2(raw.opacityJitter, base.opacityJitter),
-    scatter: range(raw.scatter, 0, 4, base.scatter)
+    scatter: range(raw.scatter, 0, 4, base.scatter),
+    ...countAndFlip(raw, base)
   };
 }
 var BRUSH_ID = /^[a-z0-9][a-z0-9-]{0,63}$/;
@@ -959,6 +969,28 @@ function normalizeBehavior(raw = {}, base = DEFAULT_BEHAVIOR) {
     multicolor: normalizeMultiColor(_nullishCoalesce(raw.multicolor, () => ( {})), base.multicolor)
   };
 }
+function countAndFlip(raw, base) {
+  const n = typeof raw.count === "number" && Number.isFinite(raw.count) ? Math.min(16, Math.max(1, Math.round(raw.count))) : _nullishCoalesce(base.count, () => ( 1));
+  const flip = DAB_FLIPS.includes(raw.flip) ? raw.flip : _nullishCoalesce(base.flip, () => ( "none"));
+  return { ...n > 1 ? { count: n } : {}, ...flip !== "none" ? { flip } : {} };
+}
+var withTipGrain = (g) => g ? { tipGrain: g } : {};
+function readTipGrain(raw, base) {
+  if (raw === null) return null;
+  if (!raw || typeof raw !== "object") return base;
+  const r = raw;
+  const source = typeof r.source === "string" && /^\S{1,200}$/.test(r.source) ? r.source : _optionalChain([base, 'optionalAccess', _2 => _2.source]);
+  if (!source) return base;
+  const b = _nullishCoalesce(base, () => ( { source, ...DEFAULT_TIP_GRAIN }));
+  return {
+    source,
+    mode: TIP_GRAIN_MODES.includes(r.mode) ? r.mode : b.mode,
+    scale: range(r.scale, 0.05, 20, b.scale),
+    depth: unit2(r.depth, b.depth),
+    contrast: range(r.contrast, 0, 3, b.contrast),
+    invert: typeof r.invert === "boolean" ? r.invert : b.invert
+  };
+}
 var DEFAULT_SPRAY = { density: 0.5, size: 0.12 };
 function readStamp(raw, base) {
   if (raw === null) return null;
@@ -1041,12 +1073,12 @@ function normalizePaintBrush(raw = {}, base) {
     if (rb.dirty !== void 0) mixerIn.cleanEachStroke = !rb.dirty;
     if (rb.mixing !== void 0) mixerIn.mixing = rb.mixing;
   }
-  const mixer = _chunkFQPUF2W2cjs.normalizeMixer.call(void 0, mixerIn);
+  const mixer = _chunkNIBFKXMDcjs.normalizeMixer.call(void 0, mixerIn);
   let behavior = normalizeBehavior(rb, b.behavior);
   if (engine === "mixer") behavior = { ...behavior, pickup: mixer.wet, mix: mixer.mix, dirty: !mixer.cleanEachStroke, mixing: mixer.mixing };
   let paint = _nullishCoalesce(b.paint, () => ( null));
   if (raw.paint !== void 0) {
-    const p = _chunkFQPUF2W2cjs.readPaintSource.call(void 0, raw.paint);
+    const p = _chunkNIBFKXMDcjs.readPaintSource.call(void 0, raw.paint);
     paint = p && p.type === "gradient" ? p : null;
   } else if (rb.multicolor !== void 0) {
     const mc = normalizeMultiColor(rb.multicolor, _nullishCoalesce(paintToMultiColor(paint), () => ( DEFAULT_MULTI_COLOR)));
@@ -1058,7 +1090,7 @@ function normalizePaintBrush(raw = {}, base) {
     name: typeof raw.name === "string" && raw.name.trim() ? raw.name.trim().slice(0, 80) : b.name,
     category: PAINT_BRUSH_CATEGORIES.includes(raw.category) ? raw.category : b.category,
     engine,
-    tip: _chunkFQPUF2W2cjs.normalizeBrush.call(void 0, { ...b.tip, ..._nullishCoalesce(raw.tip, () => ( {})) }),
+    tip: _chunkNIBFKXMDcjs.normalizeBrush.call(void 0, { ...b.tip, ..._nullishCoalesce(raw.tip, () => ( {})) }),
     grain: unit2(raw.grain, b.grain),
     pressureSmoothing: range(raw.pressureSmoothing, 0, 0.95, b.pressureSmoothing),
     rotation: BRUSH_ROTATIONS.includes(raw.rotation) ? raw.rotation : b.rotation,
@@ -1066,8 +1098,8 @@ function normalizePaintBrush(raw = {}, base) {
     mixer,
     loadsColor: typeof raw.loadsColor === "boolean" ? raw.loadsColor : b.loadsColor,
     behavior,
-    blender: _chunkFQPUF2W2cjs.normalizeBlender.call(void 0, _nullishCoalesce(raw.blender, () => ( {})), b.blender),
-    smudge: _chunkFQPUF2W2cjs.normalizeSmudge.call(void 0, _nullishCoalesce(raw.smudge, () => ( {})), b.smudge),
+    blender: _chunkNIBFKXMDcjs.normalizeBlender.call(void 0, _nullishCoalesce(raw.blender, () => ( {})), b.blender),
+    smudge: _chunkNIBFKXMDcjs.normalizeSmudge.call(void 0, _nullishCoalesce(raw.smudge, () => ( {})), b.smudge),
     wet: normalizeWetBrush(_nullishCoalesce(raw.wet, () => ( {})), _nullishCoalesce(b.wet, () => ( DEFAULT_WET_BRUSH))),
     impasto: normalizeImpasto(_nullishCoalesce(raw.impasto, () => ( {})), _nullishCoalesce(b.impasto, () => ( DEFAULT_IMPASTO))),
     particle: normalizeParticle(_nullishCoalesce(raw.particle, () => ( {})), _nullishCoalesce(b.particle, () => ( DEFAULT_PARTICLE))),
@@ -1076,6 +1108,7 @@ function normalizePaintBrush(raw = {}, base) {
     light: normalizeLight(_nullishCoalesce(raw.light, () => ( {})), _nullishCoalesce(b.light, () => ( DEFAULT_LIGHT))),
     stamp: readStamp(raw.stamp, _nullishCoalesce(b.stamp, () => ( null))),
     spray: readSpray(raw.spray, _nullishCoalesce(b.spray, () => ( null))),
+    ...withTipGrain(readTipGrain(raw.tipGrain, _nullishCoalesce(b.tipGrain, () => ( null)))),
     paint,
     ...raw.builtin ? { builtin: true } : {}
   };
@@ -1085,16 +1118,16 @@ var BASE_BRUSH = {
   name: "Round",
   category: "custom",
   engine: "dab",
-  tip: { ..._chunkFQPUF2W2cjs.DEFAULT_BRUSH },
+  tip: { ..._chunkNIBFKXMDcjs.DEFAULT_BRUSH },
   grain: 0,
   pressureSmoothing: 0,
   rotation: "fixed",
   dynamics: { ...DEFAULT_DYNAMICS },
-  mixer: { ..._chunkFQPUF2W2cjs.DEFAULT_MIXER },
+  mixer: { ..._chunkNIBFKXMDcjs.DEFAULT_MIXER },
   loadsColor: true,
   behavior: { ...DEFAULT_BEHAVIOR, multicolor: { ...DEFAULT_MULTI_COLOR, colors: [] } },
-  blender: { ..._chunkFQPUF2W2cjs.DEFAULT_BLENDER },
-  smudge: { ..._chunkFQPUF2W2cjs.DEFAULT_SMUDGE },
+  blender: { ..._chunkNIBFKXMDcjs.DEFAULT_BLENDER },
+  smudge: { ..._chunkNIBFKXMDcjs.DEFAULT_SMUDGE },
   wet: { ...DEFAULT_WET_BRUSH },
   impasto: { ...DEFAULT_IMPASTO },
   particle: { ...DEFAULT_PARTICLE },
@@ -1109,6 +1142,7 @@ var BASE_BRUSH = {
 // src/brushes/resolve.ts
 var ALL = ["dab", "eraser", "mixer", "blender", "smudge", "wet", "impasto", "particle", "bristle", "sticker"];
 var EXCHANGE = ["dab", "wet", "impasto"];
+var DABS = ["dab", "eraser", "mixer", "blender", "smudge"];
 var NOT = { toEngine: (v) => !v, toFacet: (v) => !v };
 var EDITOR_STAMPS = {
   toEngine: (v) => v.flatMap((ref) => {
@@ -1133,6 +1167,9 @@ var BRUSH_FIELDS = [
   f("dynamics.pressureSmoothing", "pressureSmoothing"),
   f("dynamics.rotation", "rotation"),
   ...each("dynamics", "dynamics", ["minSize", "pressureFlow", "tiltSize", "tiltRoundness", "tiltOpacity", "velocitySize", "velocityOpacity", "sizeJitter", "angleJitter", "opacityJitter", "scatter"]),
+  f("dynamics.count", "dynamics.count", DABS),
+  f("dynamics.flip", "dynamics.flip", DABS),
+  f("tip.grain", "tipGrain", DABS),
   f("behaviour.grain", "grain"),
   ...each("light", "light", ["amount", "pressure"]),
   // Paint exchange: the dab, wet and impasto engines' behaviour, or the Mixer Brush's settings.
@@ -1195,13 +1232,13 @@ function setPath(o, path, value) {
 var copy = (v) => v !== null && typeof v === "object" ? JSON.parse(JSON.stringify(v)) : v;
 function resolveEngine(brush) {
   if (brush.kind === "tool") return brush.tool === "eraser" || brush.tool === "blender" || brush.tool === "smudge" ? brush.tool : "wet";
-  if (_optionalChain([brush, 'access', _2 => _2.marks, 'optionalAccess', _3 => _3.kind]) === "particles") return "particle";
-  if (_optionalChain([brush, 'access', _4 => _4.marks, 'optionalAccess', _5 => _5.kind]) === "objects") return "sticker";
+  if (_optionalChain([brush, 'access', _3 => _3.marks, 'optionalAccess', _4 => _4.kind]) === "particles") return "particle";
+  if (_optionalChain([brush, 'access', _5 => _5.marks, 'optionalAccess', _6 => _6.kind]) === "objects") return "sticker";
   if (brush.tip.shape === "bristle") return "bristle";
-  const surface = _optionalChain([brush, 'access', _6 => _6.behaviour, 'optionalAccess', _7 => _7.surface]);
+  const surface = _optionalChain([brush, 'access', _7 => _7.behaviour, 'optionalAccess', _8 => _8.surface]);
   if (surface === "thick") return "impasto";
   if (surface === "wet") return "wet";
-  if (_optionalChain([brush, 'access', _8 => _8.behaviour, 'optionalAccess', _9 => _9.exchange, 'optionalAccess', _10 => _10.reservoir])) return "mixer";
+  if (_optionalChain([brush, 'access', _9 => _9.behaviour, 'optionalAccess', _10 => _10.exchange, 'optionalAccess', _11 => _11.reservoir])) return "mixer";
   return "dab";
 }
 var VARIETY_CATEGORY = {
@@ -1217,11 +1254,11 @@ var VARIETY_CATEGORY = {
 };
 var MEDIUM_CATEGORY = { paint: "paint", ink: "ink", dry: "pencil", spray: "airbrush" };
 function resolveWetMedium(brush) {
-  return _nullishCoalesce(_optionalChain([brush, 'access', _11 => _11.behaviour, 'optionalAccess', _12 => _12.wet, 'optionalAccess', _13 => _13.medium]), () => ( (WET_MEDIA.includes(brush.variety) ? brush.variety : void 0)));
+  return _nullishCoalesce(_optionalChain([brush, 'access', _12 => _12.behaviour, 'optionalAccess', _13 => _13.wet, 'optionalAccess', _14 => _14.medium]), () => ( (WET_MEDIA.includes(brush.variety) ? brush.variety : void 0)));
 }
 function resolveCategory(brush, engine = resolveEngine(brush)) {
   if (brush.kind === "tool") return brush.tool === "eraser" || brush.tool === "blender" || brush.tool === "smudge" ? brush.tool : "wet-tool";
-  if ((_nullishCoalesce(_optionalChain([brush, 'access', _14 => _14.light, 'optionalAccess', _15 => _15.amount]), () => ( 0))) > 0) return "light";
+  if ((_nullishCoalesce(_optionalChain([brush, 'access', _15 => _15.light, 'optionalAccess', _16 => _16.amount]), () => ( 0))) > 0) return "light";
   switch (engine) {
     case "particle":
       return "procedural";
@@ -1243,18 +1280,18 @@ function resolveBrush(brush, options = {}) {
   const engine = resolveEngine(brush);
   const input = { id: brush.id, name: brush.name, category: resolveCategory(brush, engine), engine };
   for (const field of BRUSH_FIELDS) {
-    if (!field.engines.includes(engine) || field.shapes && !field.shapes.includes(brush.tip.shape) || field.marks && !field.marks.includes(_nullishCoalesce(_optionalChain([brush, 'access', _16 => _16.marks, 'optionalAccess', _17 => _17.kind]), () => ( "continuous")))) continue;
+    if (!field.engines.includes(engine) || field.shapes && !field.shapes.includes(brush.tip.shape) || field.marks && !field.marks.includes(_nullishCoalesce(_optionalChain([brush, 'access', _17 => _17.marks, 'optionalAccess', _18 => _18.kind]), () => ( "continuous")))) continue;
     const v = getPath(brush, field.facet);
     if (v !== void 0) setPath(input, field.engine, field.map ? field.map.toEngine(v) : copy(v));
   }
-  if (engine === "dab" && _optionalChain([brush, 'access', _18 => _18.marks, 'optionalAccess', _19 => _19.kind]) === "scatter") input.spray = { ..._nullishCoalesce(input.spray, () => ( {})) };
+  if (engine === "dab" && _optionalChain([brush, 'access', _19 => _19.marks, 'optionalAccess', _20 => _20.kind]) === "scatter") input.spray = { ..._nullishCoalesce(input.spray, () => ( {})) };
   if (engine === "wet") {
     setPath(input, "wet.tool", brush.kind === "tool" ? WET_TOOL_OF[brush.tool] : "paint");
     const medium = resolveWetMedium(brush);
     if (medium) setPath(input, "wet.medium", medium);
   }
   if (engine === "blender" || engine === "smudge") input.loadsColor = false;
-  const paint = _optionalChain([brush, 'access', _20 => _20.colour, 'optionalAccess', _21 => _21.default]);
+  const paint = _optionalChain([brush, 'access', _21 => _21.colour, 'optionalAccess', _22 => _22.default]);
   if (paint && typeof paint === "object" && "type" in paint && paint.type === "gradient") input.paint = copy(paint);
   return normalizePaintBrush({ ...input, ...options.builtin ? { builtin: true } : {} });
 }
@@ -1340,7 +1377,7 @@ function migrateBrushV1(raw) {
   const brush = skeleton(b);
   const defaults = resolveBrush(brush);
   for (const field of BRUSH_FIELDS) {
-    if (!field.engines.includes(b.engine) || field.shapes && !field.shapes.includes(brush.tip.shape) || field.marks && !field.marks.includes(_nullishCoalesce(_optionalChain([brush, 'access', _22 => _22.marks, 'optionalAccess', _23 => _23.kind]), () => ( "continuous")))) continue;
+    if (!field.engines.includes(b.engine) || field.shapes && !field.shapes.includes(brush.tip.shape) || field.marks && !field.marks.includes(_nullishCoalesce(_optionalChain([brush, 'access', _23 => _23.marks, 'optionalAccess', _24 => _24.kind]), () => ( "continuous")))) continue;
     const v = getPath(b, field.engine);
     if (!equal(v, getPath(defaults, field.engine))) setPath(brush, field.facet, field.map ? field.map.toFacet(v) : copy2(v));
   }
@@ -1355,6 +1392,8 @@ var BRUSH_TOOLS = ["eraser", "blender", "smudge", "water", "dryer", "blow", "blo
 var BRUSH_TIP_SHAPES = ["round", "flat", "chisel", "bristle", "stamp"];
 var BRUSH_MARKS_KINDS = ["continuous", "scatter", "particles", "objects"];
 var BRUSH_SURFACES = ["dry", "wet", "thick"];
+var BRUSH_GRAIN_MODES = ["moving", "texturised"];
+var BRUSH_FLIPS = ["none", "x", "y", "xy"];
 
 // src/brushes/schema.ts
 var MAX_BRUSH_PALETTE = 16;
@@ -1376,8 +1415,22 @@ var BRUSH_STAMP_PATTERN = `^(?:[^:\\s]+:\\S+|${_chunkRDFHWAHLcjs.STAMP_KINDS.joi
 var STAMP = {
   type: "string",
   pattern: BRUSH_STAMP_PATTERN,
-  description: `A sticker ref provider:id (find_stickers lists them; the editor's own are ${_chunkRDFHWAHLcjs.STAMP_KINDS.map((k) => `editor:${k}`).join(", ")}). A bare editor stamp (star) means editor:star.`
+  description: `A sticker ref provider:id (find_stickers lists them; the editor's own are ${_chunkRDFHWAHLcjs.STAMP_KINDS.map((k) => `editor:${k}`).join(", ")}), or an image source source:<id> (list_brush_sources lists them; add_brush_source makes one from an image). A bare editor stamp (star) means editor:star.`
 };
+var TIP_GRAIN_PATTERNS = _chunkNIBFKXMDcjs.GRAIN_PATTERNS.filter((p) => p !== "smooth");
+var BRUSH_GRAIN_SOURCE_PATTERN = `^(?:source:[a-z0-9][a-z0-9-]{0,63}|${TIP_GRAIN_PATTERNS.join("|")})$`;
+var TIP_GRAIN = object(
+  "Texture inside the tip (a grain source), separate from the paper's grain: each dab is multiplied by it. Continuous and scatter marks of round and stamp tips.",
+  {
+    source: { type: "string", pattern: BRUSH_GRAIN_SOURCE_PATTERN, description: `The texture: a built-in pattern (${TIP_GRAIN_PATTERNS.join(", ")}) or an image source source:<id> (list_brush_sources); light parts are peaks, which paint.` },
+    mode: oneOf2(BRUSH_GRAIN_MODES, "texturised (default): the grain stays put on the canvas, a texture under the paint; moving: it rolls along with the tip, turning with it."),
+    scale: num(0.05, 20, "Grain size: 1 is the pattern's or image's own size, 2 twice as coarse (default 1)."),
+    depth: unit3("How much the grain takes out of each dab: 0 none, 1 only the peaks paint (default 0.6)."),
+    contrast: num(0, 3, "Height contrast around the middle: below 1 softer, above 1 harsher (default 1)."),
+    invert: bool("Swap peaks and valleys (default false).")
+  },
+  ["source"]
+);
 var BRISTLES = object("Bristle tips: the tuft. Missing fields take their defaults.", {
   count: int(3, 128, "Bristles in the tuft (default 32)."),
   stiffness: unit3("Stiff bristles follow the tip; soft ones lag and bend into curves at turns (default 0.5)."),
@@ -1389,9 +1442,9 @@ var BRISTLES = object("Bristle tips: the tuft. Missing fields take their default
 var TIP = object(
   "The tip: its shape and the dab it lays.",
   {
-    shape: oneOf2(BRUSH_TIP_SHAPES, "round, flat, chisel: an ellipse set by roundness and angle (the name is for people); bristle: a tuft of bristles (see bristle); stamp: textured stamps (see stamps), laid as objects or particles."),
-    size: num(1, _chunkFQPUF2W2cjs.MAX_BRUSH_SIZE, "Diameter in px (default 20)."),
-    hardness: unit3("Edge hardness, 0 soft .. 1 hard (default 1)."),
+    shape: oneOf2(BRUSH_TIP_SHAPES, "round, flat, chisel: an ellipse set by roundness and angle (the name is for people); bristle: a tuft of bristles (see bristle); stamp: dabs shaped like a stamp, a sticker or an image source (see stamps), also laid as sprays, objects or particles."),
+    size: num(1, _chunkNIBFKXMDcjs.MAX_BRUSH_SIZE, "Diameter in px (default 20)."),
+    hardness: unit3("Edge hardness, 0 soft .. 1 hard (default 1). Image-source stamps fade towards their edges below 1."),
     spacing: num(0.01, 10, "Dab spacing as a fraction of the diameter: 0.05 smooth, 1 dotted (default 0.1)."),
     angle: num(-360, 360, "Tip angle in degrees, counter-clockwise; added to the stroke direction or barrel with dynamics.rotation (default 0)."),
     roundness: num(0.01, 1, "Roundness: 1 round (default), lower a flat ellipse (pastel, chisel)."),
@@ -1407,8 +1460,9 @@ var TIP = object(
       minItems: 1,
       maxItems: MAX_STICKER_STAMPS,
       items: STAMP,
-      description: `Stamp tips: the stickers. Objects take any sticker and pick one at random per mark (default editor:star; repeats count once); particles take only the editor's stamps, use the first ${MAX_DOT_TEXTURES} in marks.stampOrder, and repeats weight the order.`
-    }
+      description: `Stamp tips: stickers or image sources (source:<id>). Continuous dabs and sprays lay the first; objects take only stickers and pick one at random per mark (default editor:star; repeats count once); particles use the first ${MAX_DOT_TEXTURES} in marks.stampOrder, and repeats weight the order.`
+    },
+    grain: TIP_GRAIN
   },
   ["shape"]
 );
@@ -1478,7 +1532,9 @@ var DYNAMICS = object("Pen feel: pressure, tilt, velocity, jitter, rotation and
   sizeJitter: unit3("Random size change per dab (default 0)."),
   angleJitter: unit3("Random angle per dab, as a fraction of \xB1180\xB0 (default 0)."),
   opacityJitter: unit3("Random opacity drop per dab (default 0)."),
-  scatter: num(0, 4, "Random offset across the stroke, in diameters (default 0).")
+  scatter: num(0, 4, "Random offset across the stroke, in diameters (default 0)."),
+  count: int(1, 16, "Dabs laid at each spacing step, each with its own jitter and scatter (default 1). Dab brushes."),
+  flip: oneOf2(BRUSH_FLIPS, "Mirror each dab at random across x, y or both (default none): variety for image and stamp tips.")
 });
 var EXCHANGE2 = object("Paint exchange with the canvas: picking up paint and mixing it into what the brush lays. Paint brushes on a dry, wet or thick surface and Mixer Brushes.", {
   pickup: unit3("Pick-up ratio: how much of the paint under each dab the brush lifts and carries (default 0; with a reservoir 0.5)."),
@@ -1564,7 +1620,7 @@ var EFFECT = object(
 );
 var PAINT = {
   description: "A colour a brush can carry: a solid colour, a light / dark pair, a gradient or effect paint.",
-  anyOf: [SOLID, DUAL, _chunkFQPUF2W2cjs.PAINT_GRADIENT_JSON_SCHEMA, EFFECT]
+  anyOf: [SOLID, DUAL, _chunkNIBFKXMDcjs.PAINT_GRADIENT_JSON_SCHEMA, EFFECT]
 };
 var COLOUR = object("The brush's colours. The user's colour still wins unless own is set.", {
   default: {
@@ -1600,6 +1656,7 @@ var BRUSH_JSON_SCHEMA = object(
 );
 var BRUSH_FACET_SCHEMAS = {
   tip: TIP,
+  tipGrain: TIP_GRAIN,
   marks: { continuous: CONTINUOUS, scatter: SCATTER, particles: PARTICLES, objects: OBJECTS },
   dynamics: DYNAMICS,
   behaviour: BEHAVIOUR,
@@ -1609,6 +1666,139 @@ var BRUSH_FACET_SCHEMAS = {
   paint: PAINT
 };
 
+// src/brushes/sources.ts
+var BRUSH_SOURCE_PROVIDER = "source";
+var MAX_BRUSH_SOURCE_SIZE = 512;
+var MAX_BRUSH_SOURCE_INPUT_PIXELS = 4096 * 4096;
+var MAX_BRUSH_SOURCES = 500;
+var BRUSH_SOURCE_CHANNELS = ["auto", "alpha", "darkness", "lightness"];
+var BrushSourceError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "BrushSourceError";
+  }
+};
+function brushSourceRef(id) {
+  return `${BRUSH_SOURCE_PROVIDER}:${id}`;
+}
+function isBrushSourceRef(ref) {
+  return typeof ref === "string" && ref.startsWith(`${BRUSH_SOURCE_PROVIDER}:`);
+}
+function brushSourceIdOf(ref) {
+  return isBrushSourceRef(ref) ? ref.slice(BRUSH_SOURCE_PROVIDER.length + 1) : null;
+}
+function brushSourceIds(brush) {
+  const refs = [..._nullishCoalesce(brush.tip.stamps, () => ( [])), ...brush.tip.grain ? [brush.tip.grain.source] : []];
+  return [...new Set(refs.map(brushSourceIdOf).filter((id) => id !== null))];
+}
+function summarizeBrushSource(s) {
+  const { image: _i, ...rest } = s;
+  return { ...rest, ref: brushSourceRef(s.id) };
+}
+function brushSourceIdFromName(name) {
+  return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 60) || "source";
+}
+var text = (v, max) => typeof v === "string" && v.trim() ? v.trim().slice(0, max) : void 0;
+function fit(width, height, mask, max) {
+  const scale = Math.min(1, max / Math.max(width, height));
+  if (scale >= 1) return { width, height, mask: Uint8Array.from(mask) };
+  const w = Math.max(1, Math.round(width * scale));
+  const h = Math.max(1, Math.round(height * scale));
+  const out = new Uint8Array(w * h);
+  for (let y = 0; y < h; y++) {
+    const y0 = Math.floor(y * height / h);
+    const y1 = Math.max(y0 + 1, Math.floor((y + 1) * height / h));
+    for (let x = 0; x < w; x++) {
+      const x0 = Math.floor(x * width / w);
+      const x1 = Math.max(x0 + 1, Math.floor((x + 1) * width / w));
+      let sum = 0;
+      for (let yy = y0; yy < y1; yy++) for (let xx = x0; xx < x1; xx++) sum += mask[yy * width + xx];
+      out[y * w + x] = Math.round(sum / ((y1 - y0) * (x1 - x0)));
+    }
+  }
+  return { width: w, height: h, mask: out };
+}
+function brushSourceFromMask(meta, width, height, mask) {
+  if (!BRUSH_ID.test(meta.id)) throw new BrushSourceError(`Source id ${JSON.stringify(meta.id)} is not valid: use lowercase letters, digits and dashes (up to 64).`);
+  if (!(Number.isInteger(width) && Number.isInteger(height) && width > 0 && height > 0) || mask.length !== width * height) throw new BrushSourceError("The mask is not width \xD7 height bytes.");
+  let any = false;
+  for (let i = 0; i < mask.length && !any; i++) any = mask[i] > 0;
+  if (!any) throw new BrushSourceError(`"${meta.name}" has no marks: every pixel is empty. Pick another channel (alpha, darkness or lightness) or set invert.`);
+  const f2 = fit(width, height, mask, MAX_BRUSH_SOURCE_SIZE);
+  const name = _nullishCoalesce(text(meta.name, 80), () => ( meta.id));
+  const licence = text(meta.licence, 2e3);
+  const origin = text(meta.origin, 200);
+  return { id: meta.id, name, width: f2.width, height: f2.height, image: _chunkW5M3J7PVcjs.pngDataUrl.call(void 0, f2.width, f2.height, f2.mask, 1), ...licence ? { licence } : {}, ...origin ? { origin } : {} };
+}
+function makeBrushSource(input, problems = []) {
+  const name = text(input.name, 80);
+  if (!name) throw new BrushSourceError("A brush source needs a name.");
+  const id = _nullishCoalesce(input.id, () => ( brushSourceIdFromName(name)));
+  if (!BRUSH_ID.test(id)) throw new BrushSourceError(`Source id ${JSON.stringify(id)} is not valid: use lowercase letters, digits and dashes (up to 64), starting with a letter or digit.`);
+  let bytes;
+  if (typeof input.image === "string") {
+    const parsed = _chunkW5M3J7PVcjs.parseDataUrl.call(void 0, input.image);
+    if (!parsed) throw new BrushSourceError("image must be a data: URL (data:image/png;base64,\u2026) or PNG bytes.");
+    bytes = parsed.bytes;
+  } else bytes = input.image;
+  let png;
+  try {
+    png = _chunkW5M3J7PVcjs.decodePng.call(void 0, bytes, { maxPixels: MAX_BRUSH_SOURCE_INPUT_PIXELS });
+  } catch (e) {
+    throw new BrushSourceError(`The image can't be read as a PNG (${e.message}); convert it to PNG, at most ${MAX_BRUSH_SOURCE_INPUT_PIXELS} pixels.`);
+  }
+  const { width, height, data } = png;
+  const n = width * height;
+  let channel = _nullishCoalesce(input.channel, () => ( "auto"));
+  if (channel === "auto") {
+    let transparent = false;
+    for (let i = 0; i < n && !transparent; i++) transparent = data[i * 4 + 3] < 250;
+    channel = transparent ? "alpha" : "darkness";
+    problems.push(`channel auto read the marks from ${channel === "alpha" ? "the transparency" : "the dark parts (dark marks on a light background)"}.`);
+  }
+  const mask = new Uint8Array(n);
+  for (let i = 0; i < n; i++) {
+    const a = data[i * 4 + 3];
+    const lum = (0.2126 * data[i * 4] + 0.7152 * data[i * 4 + 1] + 0.0722 * data[i * 4 + 2]) * (a / 255) + 255 * (1 - a / 255);
+    const v = channel === "alpha" ? a : channel === "darkness" ? 255 - lum : lum;
+    mask[i] = Math.round(input.invert ? 255 - v : v);
+  }
+  const source = brushSourceFromMask({ id, name, licence: input.licence, origin: input.origin }, width, height, mask);
+  if (source.width !== width) problems.push(`The image was scaled from ${width}\xD7${height} to ${source.width}\xD7${source.height} (sources are kept at most ${MAX_BRUSH_SOURCE_SIZE} px).`);
+  return source;
+}
+var GREY_PNG = /^data:image\/png;base64,[A-Za-z0-9+/]+=*$/;
+function readBrushSource(raw, at, problems) {
+  const r = raw;
+  if (!r || typeof r !== "object" || Array.isArray(r)) return void problems.push(`${at} is not a brush source; skipped.`), null;
+  if (typeof r.id !== "string" || !BRUSH_ID.test(r.id)) return void problems.push(`${at} has no valid id; skipped.`), null;
+  const ok = (v) => Number.isInteger(v) && v >= 1 && v <= MAX_BRUSH_SOURCE_SIZE;
+  if (!ok(r.width) || !ok(r.height)) return void problems.push(`${at} ("${r.id}") has no valid width and height (1..${MAX_BRUSH_SOURCE_SIZE}); skipped.`), null;
+  if (typeof r.image !== "string" || !GREY_PNG.test(r.image)) return void problems.push(`${at} ("${r.id}") has no PNG data: URL image; skipped.`), null;
+  const name = _nullishCoalesce(text(r.name, 80), () => ( r.id));
+  const licence = text(r.licence, 2e3);
+  const origin = text(r.origin, 200);
+  return { id: r.id, name, width: r.width, height: r.height, image: r.image, ...licence ? { licence } : {}, ...origin ? { origin } : {} };
+}
+var decoded = /* @__PURE__ */ new Map();
+function decodeBrushSource(source) {
+  const hit = decoded.get(source.image);
+  if (hit) return hit;
+  const parsed = _chunkW5M3J7PVcjs.parseDataUrl.call(void 0, source.image);
+  if (!parsed) throw new BrushSourceError("The source image is not a data: URL.");
+  const png = _chunkW5M3J7PVcjs.decodePng.call(void 0, parsed.bytes, { keepGray: true, maxPixels: MAX_BRUSH_SOURCE_SIZE * MAX_BRUSH_SOURCE_SIZE });
+  let mask;
+  if (png.channels === 1) mask = png.data;
+  else {
+    mask = new Uint8ClampedArray(png.width * png.height);
+    for (let i = 0; i < mask.length; i++) mask[i] = Math.round(png.data[i * 4] * png.data[i * 4 + 3] / 255);
+  }
+  const out = { width: png.width, height: png.height, mask };
+  if (decoded.size > 256) decoded.delete(decoded.keys().next().value);
+  decoded.set(source.image, out);
+  return out;
+}
+
 // src/brushes/normalize.ts
 var WET_BRUSH_TOOLS = ["water", "dryer", "blow", "blot", "wet-blend", "wet-drag"];
 var isObject = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
@@ -1676,7 +1866,7 @@ function readObject(value, schema, path, problems) {
   const out = {};
   for (const [key, v] of Object.entries(value)) {
     if (v === void 0) continue;
-    const child = _optionalChain([schema, 'access', _24 => _24.properties, 'optionalAccess', _25 => _25[key]]);
+    const child = _optionalChain([schema, 'access', _25 => _25.properties, 'optionalAccess', _26 => _26[key]]);
     if (!child) {
       problems.push(`${path}.${key} is not a brush field; dropped.`);
       continue;
@@ -1690,7 +1880,7 @@ function readPaint(value, path, problems) {
   if (typeof value === "string") {
     if (SOLID2.test(value.trim())) return value.trim().toLowerCase();
   } else if (isObject(value) && value.type === "gradient") {
-    const g = _chunkFQPUF2W2cjs.readPaintSource.call(void 0, value);
+    const g = _chunkNIBFKXMDcjs.readPaintSource.call(void 0, value);
     if (g && g.type === "gradient") return g;
   } else if (isObject(value) && value.type === "effect") {
     if (!_chunkWOFXZ3XUcjs.validateJsonSchema.call(void 0, value, BRUSH_FACET_SCHEMAS.paint.anyOf[3]).length) return clone(value);
@@ -1766,15 +1956,15 @@ function normalizeBrushSpec(raw, problems = []) {
       delete brush.marks;
     }
   }
-  if (_optionalChain([brush, 'access', _26 => _26.marks, 'optionalAccess', _27 => _27.kind]) === "scatter") {
-    const surface = _optionalChain([brush, 'access', _28 => _28.behaviour, 'optionalAccess', _29 => _29.surface]);
-    const why = brush.tip.shape === "bristle" ? "bristle tips lay their own marks" : surface === "wet" || surface === "thick" ? `${surface} paint is not sprayed` : _optionalChain([brush, 'access', _30 => _30.behaviour, 'optionalAccess', _31 => _31.exchange, 'optionalAccess', _32 => _32.reservoir]) ? "the Mixer Brush is not sprayed" : null;
+  if (_optionalChain([brush, 'access', _27 => _27.marks, 'optionalAccess', _28 => _28.kind]) === "scatter") {
+    const surface = _optionalChain([brush, 'access', _29 => _29.behaviour, 'optionalAccess', _30 => _30.surface]);
+    const why = brush.tip.shape === "bristle" ? "bristle tips lay their own marks" : surface === "wet" || surface === "thick" ? `${surface} paint is not sprayed` : _optionalChain([brush, 'access', _31 => _31.behaviour, 'optionalAccess', _32 => _32.exchange, 'optionalAccess', _33 => _33.reservoir]) ? "the Mixer Brush is not sprayed" : null;
     if (why) {
       drop("marks", why);
       delete brush.marks;
     }
   }
-  if (_optionalChain([brush, 'access', _33 => _33.marks, 'optionalAccess', _34 => _34.kind]) === "objects" && brush.tip.shape !== "stamp") {
+  if (_optionalChain([brush, 'access', _34 => _34.marks, 'optionalAccess', _35 => _35.kind]) === "objects" && brush.tip.shape !== "stamp") {
     problems.push("marks objects lay stamps: tip.shape set to stamp.");
     brush.tip.shape = "stamp";
   }
@@ -1787,13 +1977,26 @@ function normalizeBrushSpec(raw, problems = []) {
     delete brush.tip.stamps;
   }
   if (brush.tip.stamps) {
-    const stamps = brush.tip.stamps.map((s) => _chunkRDFHWAHLcjs.normalizeStickerRef.call(void 0, s));
+    let stamps = brush.tip.stamps.map((s) => _chunkRDFHWAHLcjs.normalizeStickerRef.call(void 0, s));
+    if (_optionalChain([brush, 'access', _36 => _36.marks, 'optionalAccess', _37 => _37.kind]) === "objects" && stamps.some(isBrushSourceRef)) {
+      problems.push("tip.stamps: image sources (source:\u2026) dropped: objects marks lay stickers; use continuous, scatter or particles marks for an image tip.");
+      stamps = stamps.filter((s) => !isBrushSourceRef(s));
+    }
     if (stamps.length) brush.tip.stamps = stamps;
     else {
       drop("tip.stamps", "none of the stamps can be laid");
       delete brush.tip.stamps;
     }
   }
+  if (brush.tip.grain) {
+    const surface = _optionalChain([brush, 'access', _38 => _38.behaviour, 'optionalAccess', _39 => _39.surface]);
+    const marks = _optionalChain([brush, 'access', _40 => _40.marks, 'optionalAccess', _41 => _41.kind]);
+    const why = !brush.tip.grain.source ? "it needs a source (a grain pattern or source:<id>)" : brush.tip.shape === "bristle" ? "bristle tips lay their own marks" : marks === "particles" || marks === "objects" ? `${marks} marks are not dabs` : surface === "wet" || surface === "thick" ? `${surface} paint lays its own texture` : kind === "tool" && WET_BRUSH_TOOLS.includes(brush.tool) ? "the wet tools work on the wet layer" : null;
+    if (why) {
+      drop("tip.grain", why);
+      delete brush.tip.grain;
+    }
+  }
   const b = brush.behaviour;
   if (b) {
     const wetTool = kind === "tool" && WET_BRUSH_TOOLS.includes(brush.tool);
@@ -1824,7 +2027,7 @@ function normalizeBrushSpec(raw, problems = []) {
     if (b.exchange && kind === "tool" && !wetTool) {
       drop("behaviour.exchange", `the ${brush.tool} does not pick paint up`);
       delete b.exchange;
-    } else if (b.exchange && (_optionalChain([brush, 'access', _35 => _35.marks, 'optionalAccess', _36 => _36.kind]) === "particles" || _optionalChain([brush, 'access', _37 => _37.marks, 'optionalAccess', _38 => _38.kind]) === "objects" || brush.tip.shape === "bristle")) {
+    } else if (b.exchange && (_optionalChain([brush, 'access', _42 => _42.marks, 'optionalAccess', _43 => _43.kind]) === "particles" || _optionalChain([brush, 'access', _44 => _44.marks, 'optionalAccess', _45 => _45.kind]) === "objects" || brush.tip.shape === "bristle")) {
       drop("behaviour.exchange", "particle, object and bristle marks do not pick paint up");
       delete b.exchange;
     }
@@ -1850,7 +2053,9 @@ var PAINT_PROFILE = {
   motion: "full",
   colours: ALL_COLOURS,
   velocity: "full",
-  tilt: "full"
+  tilt: "full",
+  tipGrain: "full",
+  dabCount: "full"
 };
 var IMAGE_PROFILE = {
   id: "image",
@@ -1867,7 +2072,9 @@ var IMAGE_PROFILE = {
   motion: "none",
   colours: ["solid", "dual", "gradient"],
   velocity: "ignored",
-  tilt: "ignored"
+  tilt: "ignored",
+  tipGrain: "ignored",
+  dabCount: "ignored"
 };
 var CANVAS_PROFILE = {
   id: "canvas",
@@ -1884,7 +2091,9 @@ var CANVAS_PROFILE = {
   motion: "none",
   colours: ["solid", "dual", "gradient"],
   velocity: "ignored",
-  tilt: "full"
+  tilt: "full",
+  tipGrain: "ignored",
+  dabCount: "ignored"
 };
 var VECTOR_PROFILE = { ...CANVAS_PROFILE, id: "vector", name: "Vector editor", kinds: ["mark", "tool"], tools: ["blender", "smudge"], surfaces: ["dry", "wet"], reservoir: "full", light: "ignored" };
 var BRUSH_HOST_PROFILES = { paint: PAINT_PROFILE, image: IMAGE_PROFILE, canvas: CANVAS_PROFILE, vector: VECTOR_PROFILE };
@@ -1908,32 +2117,37 @@ function checkBrush(brush, profile) {
   else if (brush.kind === "tool" && brush.tool && !profile.tools.includes(brush.tool)) {
     add("tool", "error", `${host} has no ${brush.tool} tool.`, profile.tools.length ? `Use one of: ${list(profile.tools)}.` : `${host} has no tools; use a mark brush.`);
   }
-  if (!profile.tipShapes.includes(brush.tip.shape)) add("tip.shape", "error", `${host} can't lay a ${brush.tip.shape} tip.`, `Set tip.shape to one of: ${list(profile.tipShapes)}.`);
-  const marks = _nullishCoalesce(_optionalChain([brush, 'access', _39 => _39.marks, 'optionalAccess', _40 => _40.kind]), () => ( "continuous"));
+  if (!profile.tipShapes.includes(brush.tip.shape)) {
+    const image = brush.tip.shape === "stamp" && (_nullishCoalesce(brush.tip.stamps, () => ( []))).some(isBrushSourceRef);
+    add("tip.shape", "error", `${host} can't lay a ${image ? "stamp tip (image tips are stamps)" : `${brush.tip.shape} tip`}.`, `Set tip.shape to one of: ${list(profile.tipShapes)}.`);
+  }
+  const marks = _nullishCoalesce(_optionalChain([brush, 'access', _46 => _46.marks, 'optionalAccess', _47 => _47.kind]), () => ( "continuous"));
   if (!profile.marks.includes(marks)) add("marks", "error", `${host} can't lay ${marks} marks.`, `Use marks ${list(profile.marks)} (remove marks for continuous dabs).`);
-  const surface = _nullishCoalesce(_optionalChain([brush, 'access', _41 => _41.behaviour, 'optionalAccess', _42 => _42.surface]), () => ( "dry"));
+  const surface = _nullishCoalesce(_optionalChain([brush, 'access', _48 => _48.behaviour, 'optionalAccess', _49 => _49.surface]), () => ( "dry"));
   if (brush.kind === "mark" && !profile.surfaces.includes(surface)) add("behaviour.surface", "error", `${host} has no ${surface} surface.`, `Set behaviour.surface to ${list(profile.surfaces)}.`);
-  const ex = _optionalChain([brush, 'access', _43 => _43.behaviour, 'optionalAccess', _44 => _44.exchange]);
-  feature(profile.reservoir, !!_optionalChain([ex, 'optionalAccess', _45 => _45.reservoir]), "behaviour.exchange.reservoir", "a Mixer Brush reservoir", "Remove behaviour.exchange.reservoir.");
-  feature(profile.exchange, !_optionalChain([ex, 'optionalAccess', _46 => _46.reservoir]) && (nonZero(_optionalChain([ex, 'optionalAccess', _47 => _47.pickup])) || !!_optionalChain([ex, 'optionalAccess', _48 => _48.dirty])), "behaviour.exchange", "picking paint up", "Remove behaviour.exchange.");
-  feature(profile.grain, nonZero(_optionalChain([brush, 'access', _49 => _49.behaviour, 'optionalAccess', _50 => _50.grain])), "behaviour.grain", "paper grain", "Set behaviour.grain to 0.");
-  feature(profile.light, nonZero(_optionalChain([brush, 'access', _51 => _51.light, 'optionalAccess', _52 => _52.amount])), "light", "light paint (glow and spill)", "Remove light (or set light.amount to 0).");
+  const ex = _optionalChain([brush, 'access', _50 => _50.behaviour, 'optionalAccess', _51 => _51.exchange]);
+  feature(profile.reservoir, !!_optionalChain([ex, 'optionalAccess', _52 => _52.reservoir]), "behaviour.exchange.reservoir", "a Mixer Brush reservoir", "Remove behaviour.exchange.reservoir.");
+  feature(profile.exchange, !_optionalChain([ex, 'optionalAccess', _53 => _53.reservoir]) && (nonZero(_optionalChain([ex, 'optionalAccess', _54 => _54.pickup])) || !!_optionalChain([ex, 'optionalAccess', _55 => _55.dirty])), "behaviour.exchange", "picking paint up", "Remove behaviour.exchange.");
+  feature(profile.grain, nonZero(_optionalChain([brush, 'access', _56 => _56.behaviour, 'optionalAccess', _57 => _57.grain])), "behaviour.grain", "paper grain", "Set behaviour.grain to 0.");
+  feature(profile.light, nonZero(_optionalChain([brush, 'access', _58 => _58.light, 'optionalAccess', _59 => _59.amount])), "light", "light paint (glow and spill)", "Remove light (or set light.amount to 0).");
   const m = brush.motion;
   feature(profile.motion, !!m && (!!m.live || nonZero(m.waveSpeed) || m.fps !== void 0), "motion", "animation", "Remove motion.");
   const d = _nullishCoalesce(brush.dynamics, () => ( {}));
+  feature(_nullishCoalesce(profile.tipGrain, () => ( "none")), !!brush.tip.grain, "tip.grain", "tip grain", "Remove tip.grain (behaviour.grain textures with the paper instead).");
+  feature(_nullishCoalesce(profile.dabCount, () => ( "none")), (_nullishCoalesce(d.count, () => ( 1))) > 1, "dynamics.count", "several dabs per step", "Set dynamics.count to 1.");
   feature(profile.velocity, nonZero(d.velocitySize) || nonZero(d.velocityOpacity), "dynamics.velocity", "velocity dynamics (its strokes carry no timing)", "Set dynamics.velocitySize and velocityOpacity to 0.");
   feature(profile.tilt, nonZero(d.tiltSize) || nonZero(d.tiltRoundness) || nonZero(d.tiltOpacity), "dynamics.tilt", "tilt dynamics", "Set dynamics.tiltSize, tiltRoundness and tiltOpacity to 0.");
   const colour = brush.colour;
-  if (_optionalChain([colour, 'optionalAccess', _53 => _53.default]) !== void 0) {
+  if (_optionalChain([colour, 'optionalAccess', _60 => _60.default]) !== void 0) {
     const kind = brushColourKind(colour.default);
     if (!profile.colours.includes(kind)) add("colour.default", "error", `${host} can't paint ${kind} colours.`, `Use a ${list(profile.colours)} colour, or remove colour.default.`);
   }
-  const foreign = [...new Set((_nullishCoalesce(_optionalChain([colour, 'optionalAccess', _54 => _54.palette]), () => ( []))).map(brushColourKind).filter((k) => !profile.colours.includes(k)))];
+  const foreign = [...new Set((_nullishCoalesce(_optionalChain([colour, 'optionalAccess', _61 => _61.palette]), () => ( []))).map(brushColourKind).filter((k) => !profile.colours.includes(k)))];
   if (foreign.length) add("colour.palette", "warning", `${host} skips the palette's ${list(foreign)} colours.`, `Nothing to do; or keep to ${list(profile.colours)} colours.`);
   return { ok: !issues.some((i) => i.severity === "error"), issues };
 }
 function withKeptIssues(check, before) {
-  const had = new Set((_nullishCoalesce(_optionalChain([before, 'optionalAccess', _55 => _55.issues]), () => ( []))).filter((i) => i.severity === "error").map((i) => i.facet));
+  const had = new Set((_nullishCoalesce(_optionalChain([before, 'optionalAccess', _62 => _62.issues]), () => ( []))).filter((i) => i.severity === "error").map((i) => i.facet));
   const kept = check.issues.filter((i) => i.severity === "error" && had.has(i.facet));
   const issues = check.issues.filter((i) => !kept.includes(i));
   return { ok: !issues.some((i) => i.severity === "error"), issues, kept };
@@ -1976,6 +2190,12 @@ function degrade(brush, profile, options = {}) {
       case "behaviour.grain":
         delete b.behaviour.grain;
         break;
+      case "tip.grain":
+        delete b.tip.grain;
+        break;
+      case "dynamics.count":
+        delete b.dynamics.count;
+        break;
       case "light":
         delete b.light;
         break;
@@ -2003,7 +2223,7 @@ function degrade(brush, profile, options = {}) {
     }
     dropped.push(issue);
   }
-  if (_optionalChain([b, 'access', _56 => _56.behaviour, 'optionalAccess', _57 => _57.exchange]) && !Object.keys(b.behaviour.exchange).length) delete b.behaviour.exchange;
+  if (_optionalChain([b, 'access', _63 => _63.behaviour, 'optionalAccess', _64 => _64.exchange]) && !Object.keys(b.behaviour.exchange).length) delete b.behaviour.exchange;
   if (b.colour && !Object.keys(b.colour).length) delete b.colour;
   const after = checkBrush(b, profile).issues.filter((i) => i.severity === "error");
   return { brush: b, dropped, issues: after };
@@ -2024,6 +2244,15 @@ function isBrushLibrary(library) {
 }
 var isObject2 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
 var isV1 = (item) => "engine" in item || "category" in item || !("kind" in item);
+function parseBrushLibrarySources(raw, problems = []) {
+  const file = isObject2(raw) ? raw : null;
+  if (!file || file.sources === void 0) return [];
+  if (!Array.isArray(file.sources)) {
+    problems.push("sources is not a list; skipped.");
+    return [];
+  }
+  return file.sources.map((s, i) => readBrushSource(s, `sources[${i}]`, problems)).filter((s) => s !== null);
+}
 function parseBrushLibrary2(raw, problems = []) {
   if (typeof raw === "string") {
     try {
@@ -2038,7 +2267,7 @@ function parseBrushLibrary2(raw, problems = []) {
   if (file && file.version !== void 0 && file.version !== 1 && file.version !== 2) {
     throw new BrushLibraryError("invalid", `Brush library version ${JSON.stringify(file.version)} is not supported; this library reads versions 1 and 2.`);
   }
-  const v1File = _optionalChain([file, 'optionalAccess', _58 => _58.version]) === 1;
+  const v1File = _optionalChain([file, 'optionalAccess', _65 => _65.version]) === 1;
   const out = [];
   items.forEach((item, i) => {
     const at = `brushes[${i}]`;
@@ -2066,8 +2295,8 @@ function matches(entry, f2) {
   if (f2.tool && b.tool !== f2.tool) return false;
   if (f2.tag && !(_nullishCoalesce(b.tags, () => ( []))).includes(f2.tag)) return false;
   if (f2.text) {
-    const text = words([b.id, b.name, _nullishCoalesce(b.description, () => ( "")), _nullishCoalesce(b.variety, () => ( "")), _nullishCoalesce(b.medium, () => ( "")), _nullishCoalesce(b.tool, () => ( "")), ..._nullishCoalesce(b.tags, () => ( []))].join(" "));
-    if (!words(f2.text).every((w) => text.some((t) => t.startsWith(w)))) return false;
+    const text2 = words([b.id, b.name, _nullishCoalesce(b.description, () => ( "")), _nullishCoalesce(b.variety, () => ( "")), _nullishCoalesce(b.medium, () => ( "")), _nullishCoalesce(b.tool, () => ( "")), ..._nullishCoalesce(b.tags, () => ( []))].join(" "));
+    if (!words(f2.text).every((w) => text2.some((t) => t.startsWith(w)))) return false;
   }
   if (f2.profile && !checkBrush(b, f2.profile).ok) return false;
   return true;
@@ -2077,8 +2306,10 @@ function createBrushLibrary(options = {}) {
   const presets = (_nullishCoalesce(options.presets, () => ( BRUSH_PRESETS))).map(copy3);
   const builtinIds = new Set(presets.map((b) => b.id));
   const key = `${_nullishCoalesce(options.namespace, () => ( "pixerate.brushes"))}:user`;
+  const sourcesKey = `${_nullishCoalesce(options.namespace, () => ( "pixerate.brushes"))}:sources`;
   const listeners = /* @__PURE__ */ new Set();
   let user = null;
+  let sources = null;
   let queue = Promise.resolve();
   const run = (task) => {
     const result = queue.then(task, task);
@@ -2104,6 +2335,44 @@ function createBrushLibrary(options = {}) {
     if (options.storage) await options.storage.set(key, JSON.stringify(file));
     user = brushes;
   };
+  const loadSources = async () => {
+    if (sources) return sources;
+    const raw = options.storage ? await options.storage.get(sourcesKey) : null;
+    let list2 = [];
+    if (raw) {
+      try {
+        list2 = parseBrushLibrarySources(JSON.parse(raw));
+      } catch (e6) {
+      }
+    }
+    sources = list2;
+    return sources;
+  };
+  const storeSources = async (list2) => {
+    if (options.storage) await options.storage.set(sourcesKey, JSON.stringify({ format: "pixerate-brush-sources", version: 1, sources: list2 }));
+    sources = list2;
+  };
+  const putSources = async (incoming, overwrite, problems) => {
+    let list2 = [...await loadSources()];
+    const changed = [];
+    for (const src of incoming) {
+      const at = list2.findIndex((x) => x.id === src.id);
+      if (at === -1) {
+        if (list2.length >= MAX_BRUSH_SOURCES) {
+          problems.push(`Source "${src.id}" skipped: the library holds at most ${MAX_BRUSH_SOURCES} sources.`);
+          continue;
+        }
+        list2.push(src);
+        changed.push(src.id);
+      } else if (list2[at].image === src.image) continue;
+      else if (overwrite) {
+        list2 = list2.map((x, i) => i === at ? src : x);
+        changed.push(src.id);
+      } else problems.push(`Source "${src.id}" exists already with another image; skipped (pass overwrite to replace it).`);
+    }
+    if (changed.length) await storeSources(list2);
+    return changed;
+  };
   const entries = async () => [...presets.map((brush) => ({ brush, builtin: true })), ...(await load()).map((brush) => ({ brush, builtin: false }))];
   const find = async (id) => {
     const entry = (await entries()).find((e) => e.brush.id === id);
@@ -2165,12 +2434,17 @@ function createBrushLibrary(options = {}) {
     }),
     exportFile: (ids) => run(async () => {
       const brushes = ids ? await Promise.all(ids.map(async (id) => (await find(id)).brush)) : await load();
-      return { format: "pixerate-brushes", version: 2, brushes: brushes.map(copy3) };
+      const used = new Set(brushes.flatMap(brushSourceIds));
+      const withSources = (await loadSources()).filter((s) => used.has(s.id));
+      return { format: "pixerate-brushes", version: 2, brushes: brushes.map(copy3), ...withSources.length ? { sources: withSources.map(copy3) } : {} };
     }),
     importFile: (raw, o = {}) => run(async () => {
       const problems = [];
       const incoming = parseBrushLibrary2(raw, problems);
       const result = { added: [], replaced: [], skipped: [], problems };
+      const fileSources = parseBrushLibrarySources(typeof raw === "string" ? JSON.parse(raw) : raw, problems);
+      const changedSources = fileSources.length ? await putSources(fileSources, !!o.overwrite, problems) : [];
+      if (changedSources.length) result.sources = changedSources;
       let brushes = [...await load()];
       for (const brush of incoming) {
         if (builtinIds.has(brush.id)) {
@@ -2190,12 +2464,45 @@ function createBrushLibrary(options = {}) {
           problems.push(`"${brush.id}" exists already; skipped (pass overwrite to replace it).`);
         }
       }
-      if (result.added.length || result.replaced.length) {
-        await store(brushes);
-        notify();
-      }
+      if (result.added.length || result.replaced.length) await store(brushes);
+      if (result.added.length || result.replaced.length || changedSources.length) notify();
       return result;
     }),
+    listSources: () => run(async () => (await loadSources()).map(copy3)),
+    getSource: (id) => run(async () => {
+      const s = (await loadSources()).find((x) => x.id === id);
+      return s ? copy3(s) : null;
+    }),
+    addSource: (input, o = {}) => run(async () => {
+      const problems = [];
+      let source;
+      if (isObject2(input) && "width" in input) {
+        const read2 = readBrushSource(input, "source", problems);
+        if (!read2) throw new BrushLibraryError("invalid", problems.join(" "));
+        source = read2;
+      } else {
+        const given = input;
+        const taken = new Set((await loadSources()).map((x) => x.id));
+        let id = given.id;
+        if (id === void 0 && typeof given.name === "string") {
+          const stem = brushSourceIdFromName(given.name);
+          id = stem;
+          for (let n = 2; taken.has(id); n++) id = `${stem}-${n}`;
+        }
+        try {
+          source = makeBrushSource({ ...given, id }, problems);
+        } catch (e) {
+          throw new BrushLibraryError("invalid", e.message);
+        }
+      }
+      const list2 = await loadSources();
+      const at = list2.findIndex((x) => x.id === source.id);
+      if (at !== -1 && !o.overwrite) throw new BrushLibraryError("exists", `A source "${source.id}" exists already; pick another id, or pass overwrite to replace its image (brushes using it change too).`);
+      if (at === -1 && list2.length >= MAX_BRUSH_SOURCES) throw new BrushLibraryError("invalid", `The library holds at most ${MAX_BRUSH_SOURCES} sources.`);
+      await storeSources(at === -1 ? [...list2, source] : list2.map((x, i) => i === at ? source : x));
+      notify();
+      return { source: copy3(source), problems, replaced: at !== -1 };
+    }),
     subscribe(listener) {
       listeners.add(listener);
       return () => {
@@ -2221,7 +2528,7 @@ function snapshotBrushLibrary(library, onChange) {
     (list2) => {
       entries = list2;
       user = list2.filter((e) => !e.builtin).map((e) => e.brush);
-      _optionalChain([onChange, 'optionalCall', _59 => _59()]);
+      _optionalChain([onChange, 'optionalCall', _66 => _66()]);
     },
     () => void 0
   );
@@ -2328,4 +2635,28 @@ function snapshotBrushLibrary(library, onChange) {
 
 
 
-exports.BRUSH_PRESETS = BRUSH_PRESETS; exports.MAX_STICKER_STAMPS = MAX_STICKER_STAMPS; exports.DEFAULT_STICKER = DEFAULT_STICKER; exports.normalizeStickerSettings = normalizeStickerSettings; exports.PARTICLE_KINDS = PARTICLE_KINDS; exports.PARTICLE_RENDERS = PARTICLE_RENDERS; exports.RIBBON_PAIRS = RIBBON_PAIRS; exports.DOT_TEXTURE_ORDERS = DOT_TEXTURE_ORDERS; exports.DOT_ROTATIONS = DOT_ROTATIONS; exports.MAX_DOT_TEXTURES = MAX_DOT_TEXTURES; exports.DEFAULT_PARTICLE = DEFAULT_PARTICLE; exports.normalizeParticle = normalizeParticle; exports.DEFAULT_BRISTLE = DEFAULT_BRISTLE; exports.normalizeBristle = normalizeBristle; exports.PAINT_BRUSH_ENGINES = PAINT_BRUSH_ENGINES; exports.PAINT_BRUSH_CATEGORIES = PAINT_BRUSH_CATEGORIES; exports.WET_TOOLS = WET_TOOLS; exports.WET_MEDIA = WET_MEDIA; exports.DEFAULT_WET_BRUSH = DEFAULT_WET_BRUSH; exports.normalizeWetBrush = normalizeWetBrush; exports.IMPASTO_TOOLS = IMPASTO_TOOLS; exports.DEFAULT_IMPASTO = DEFAULT_IMPASTO; exports.DEFAULT_LIGHT = DEFAULT_LIGHT; exports.normalizeLight = normalizeLight; exports.normalizeImpasto = normalizeImpasto; exports.MULTI_COLOR_MODES = MULTI_COLOR_MODES; exports.DEFAULT_MULTI_COLOR = DEFAULT_MULTI_COLOR; exports.DEFAULT_BEHAVIOR = DEFAULT_BEHAVIOR; exports.BRUSH_ROTATIONS = BRUSH_ROTATIONS; exports.DEFAULT_DYNAMICS = DEFAULT_DYNAMICS; exports.normalizeDynamics = normalizeDynamics; exports.BRUSH_ID = BRUSH_ID; exports.normalizeMultiColor = normalizeMultiColor; exports.normalizeBehavior = normalizeBehavior; exports.DEFAULT_SPRAY = DEFAULT_SPRAY; exports.isWetCapable = isWetCapable; exports.isWetBrush = isWetBrush; exports.usesPaintExchange = usesPaintExchange; exports.brushTakesPaint = brushTakesPaint; exports.paintToMultiColor = paintToMultiColor; exports.multiColorToPaint = multiColorToPaint; exports.normalizePaintBrush = normalizePaintBrush; exports.BRUSH_FIELDS = BRUSH_FIELDS; exports.getPath = getPath; exports.setPath = setPath; exports.resolveEngine = resolveEngine; exports.resolveWetMedium = resolveWetMedium; exports.resolveCategory = resolveCategory; exports.resolveBrush = resolveBrush; exports.BUILTIN_BRUSHES = BUILTIN_BRUSHES; exports.DEFAULT_BRUSH_ID = DEFAULT_BRUSH_ID; exports.brushToJSON = brushToJSON; exports.parseBrushLibrary = parseBrushLibrary; exports.migrateBrushV1 = migrateBrushV1; exports.BRUSH_KINDS = BRUSH_KINDS; exports.BRUSH_MEDIA = BRUSH_MEDIA; exports.BRUSH_TOOLS = BRUSH_TOOLS; exports.BRUSH_TIP_SHAPES = BRUSH_TIP_SHAPES; exports.BRUSH_MARKS_KINDS = BRUSH_MARKS_KINDS; exports.BRUSH_SURFACES = BRUSH_SURFACES; exports.MAX_BRUSH_PALETTE = MAX_BRUSH_PALETTE; exports.BRUSH_WORD = BRUSH_WORD; exports.BRUSH_JSON_SCHEMA = BRUSH_JSON_SCHEMA; exports.BRUSH_FACET_SCHEMAS = BRUSH_FACET_SCHEMAS; exports.WET_BRUSH_TOOLS = WET_BRUSH_TOOLS; exports.normalizeBrushSpec = normalizeBrushSpec; exports.PAINT_PROFILE = PAINT_PROFILE; exports.IMAGE_PROFILE = IMAGE_PROFILE; exports.CANVAS_PROFILE = CANVAS_PROFILE; exports.VECTOR_PROFILE = VECTOR_PROFILE; exports.BRUSH_HOST_PROFILES = BRUSH_HOST_PROFILES; exports.brushColourKind = brushColourKind; exports.checkBrush = checkBrush; exports.withKeptIssues = withKeptIssues; exports.checkBrushEdit = checkBrushEdit; exports.listPresets = listPresets; exports.degrade = degrade; exports.BrushLibraryError = BrushLibraryError; exports.isBrushLibrary = isBrushLibrary; exports.parseBrushLibrary2 = parseBrushLibrary2; exports.createBrushLibrary = createBrushLibrary; exports.closest = closest; exports.snapshotBrushLibrary = snapshotBrushLibrary;
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.BRUSH_PRESETS = BRUSH_PRESETS; exports.MAX_STICKER_STAMPS = MAX_STICKER_STAMPS; exports.DEFAULT_STICKER = DEFAULT_STICKER; exports.normalizeStickerSettings = normalizeStickerSettings; exports.PARTICLE_KINDS = PARTICLE_KINDS; exports.PARTICLE_RENDERS = PARTICLE_RENDERS; exports.RIBBON_PAIRS = RIBBON_PAIRS; exports.DOT_TEXTURE_ORDERS = DOT_TEXTURE_ORDERS; exports.DOT_ROTATIONS = DOT_ROTATIONS; exports.MAX_DOT_TEXTURES = MAX_DOT_TEXTURES; exports.DEFAULT_PARTICLE = DEFAULT_PARTICLE; exports.normalizeParticle = normalizeParticle; exports.DEFAULT_BRISTLE = DEFAULT_BRISTLE; exports.normalizeBristle = normalizeBristle; exports.PAINT_BRUSH_ENGINES = PAINT_BRUSH_ENGINES; exports.PAINT_BRUSH_CATEGORIES = PAINT_BRUSH_CATEGORIES; exports.WET_TOOLS = WET_TOOLS; exports.WET_MEDIA = WET_MEDIA; exports.DEFAULT_WET_BRUSH = DEFAULT_WET_BRUSH; exports.normalizeWetBrush = normalizeWetBrush; exports.IMPASTO_TOOLS = IMPASTO_TOOLS; exports.DEFAULT_IMPASTO = DEFAULT_IMPASTO; exports.DEFAULT_LIGHT = DEFAULT_LIGHT; exports.normalizeLight = normalizeLight; exports.normalizeImpasto = normalizeImpasto; exports.MULTI_COLOR_MODES = MULTI_COLOR_MODES; exports.DEFAULT_MULTI_COLOR = DEFAULT_MULTI_COLOR; exports.DEFAULT_BEHAVIOR = DEFAULT_BEHAVIOR; exports.BRUSH_ROTATIONS = BRUSH_ROTATIONS; exports.DAB_FLIPS = DAB_FLIPS; exports.TIP_GRAIN_MODES = TIP_GRAIN_MODES; exports.DEFAULT_TIP_GRAIN = DEFAULT_TIP_GRAIN; exports.DEFAULT_DYNAMICS = DEFAULT_DYNAMICS; exports.normalizeDynamics = normalizeDynamics; exports.BRUSH_ID = BRUSH_ID; exports.normalizeMultiColor = normalizeMultiColor; exports.normalizeBehavior = normalizeBehavior; exports.DEFAULT_SPRAY = DEFAULT_SPRAY; exports.isWetCapable = isWetCapable; exports.isWetBrush = isWetBrush; exports.usesPaintExchange = usesPaintExchange; exports.brushTakesPaint = brushTakesPaint; exports.paintToMultiColor = paintToMultiColor; exports.multiColorToPaint = multiColorToPaint; exports.normalizePaintBrush = normalizePaintBrush; exports.BRUSH_FIELDS = BRUSH_FIELDS; exports.getPath = getPath; exports.setPath = setPath; exports.resolveEngine = resolveEngine; exports.resolveWetMedium = resolveWetMedium; exports.resolveCategory = resolveCategory; exports.resolveBrush = resolveBrush; exports.BUILTIN_BRUSHES = BUILTIN_BRUSHES; exports.DEFAULT_BRUSH_ID = DEFAULT_BRUSH_ID; exports.brushToJSON = brushToJSON; exports.parseBrushLibrary = parseBrushLibrary; exports.migrateBrushV1 = migrateBrushV1; exports.BRUSH_KINDS = BRUSH_KINDS; exports.BRUSH_MEDIA = BRUSH_MEDIA; exports.BRUSH_TOOLS = BRUSH_TOOLS; exports.BRUSH_TIP_SHAPES = BRUSH_TIP_SHAPES; exports.BRUSH_MARKS_KINDS = BRUSH_MARKS_KINDS; exports.BRUSH_SURFACES = BRUSH_SURFACES; exports.BRUSH_GRAIN_MODES = BRUSH_GRAIN_MODES; exports.BRUSH_FLIPS = BRUSH_FLIPS; exports.MAX_BRUSH_PALETTE = MAX_BRUSH_PALETTE; exports.BRUSH_WORD = BRUSH_WORD; exports.TIP_GRAIN_PATTERNS = TIP_GRAIN_PATTERNS; exports.BRUSH_GRAIN_SOURCE_PATTERN = BRUSH_GRAIN_SOURCE_PATTERN; exports.BRUSH_JSON_SCHEMA = BRUSH_JSON_SCHEMA; exports.BRUSH_FACET_SCHEMAS = BRUSH_FACET_SCHEMAS; exports.BRUSH_SOURCE_PROVIDER = BRUSH_SOURCE_PROVIDER; exports.MAX_BRUSH_SOURCE_SIZE = MAX_BRUSH_SOURCE_SIZE; exports.MAX_BRUSH_SOURCE_INPUT_PIXELS = MAX_BRUSH_SOURCE_INPUT_PIXELS; exports.MAX_BRUSH_SOURCES = MAX_BRUSH_SOURCES; exports.BRUSH_SOURCE_CHANNELS = BRUSH_SOURCE_CHANNELS; exports.BrushSourceError = BrushSourceError; exports.brushSourceRef = brushSourceRef; exports.isBrushSourceRef = isBrushSourceRef; exports.brushSourceIdOf = brushSourceIdOf; exports.brushSourceIds = brushSourceIds; exports.summarizeBrushSource = summarizeBrushSource; exports.brushSourceIdFromName = brushSourceIdFromName; exports.brushSourceFromMask = brushSourceFromMask; exports.makeBrushSource = makeBrushSource; exports.readBrushSource = readBrushSource; exports.decodeBrushSource = decodeBrushSource; exports.WET_BRUSH_TOOLS = WET_BRUSH_TOOLS; exports.normalizeBrushSpec = normalizeBrushSpec; exports.PAINT_PROFILE = PAINT_PROFILE; exports.IMAGE_PROFILE = IMAGE_PROFILE; exports.CANVAS_PROFILE = CANVAS_PROFILE; exports.VECTOR_PROFILE = VECTOR_PROFILE; exports.BRUSH_HOST_PROFILES = BRUSH_HOST_PROFILES; exports.brushColourKind = brushColourKind; exports.checkBrush = checkBrush; exports.withKeptIssues = withKeptIssues; exports.checkBrushEdit = checkBrushEdit; exports.listPresets = listPresets; exports.degrade = degrade; exports.BrushLibraryError = BrushLibraryError; exports.isBrushLibrary = isBrushLibrary; exports.parseBrushLibrarySources = parseBrushLibrarySources; exports.parseBrushLibrary2 = parseBrushLibrary2; exports.createBrushLibrary = createBrushLibrary; exports.closest = closest; exports.snapshotBrushLibrary = snapshotBrushLibrary;