@pixerate/editor 0.249.0 → 0.251.0

package/dist/chunk-HS6QDWDF.cjs

@@ -0,0 +1,1029 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
+
+
+var _chunkJSDND7DFcjs = require('./chunk-JSDND7DF.cjs');
+
+
+
+
+
+
+
+
+
+
+var _chunkFQPUF2W2cjs = require('./chunk-FQPUF2W2.cjs');
+
+// src/paint-editor/mark-settings.ts
+var unit = (v, d) => typeof v === "number" && Number.isFinite(v) ? Math.min(1, Math.max(0, v)) : d;
+var oneOf = (v, all, d) => all.includes(v) ? v : d;
+var MAX_STICKER_STAMPS = 16;
+var DEFAULT_STICKER = { stamps: ["editor:star"], density: 0.4, sizeJitter: 0.4, rotationJitter: 1, scatter: 0.5, colorJitter: 0.2 };
+function normalizeStickerSettings(raw = {}, base = DEFAULT_STICKER) {
+  const refs = (list) => list.flatMap((s) => {
+    try {
+      return [_chunkJSDND7DFcjs.normalizeStickerRef.call(void 0, s)];
+    } catch (e) {
+      return [];
+    }
+  });
+  const stamps = Array.isArray(raw.stamps) ? refs(raw.stamps) : refs(base.stamps);
+  return {
+    stamps: stamps.length ? [...new Set(stamps)].slice(0, MAX_STICKER_STAMPS) : refs(base.stamps.length ? base.stamps : DEFAULT_STICKER.stamps),
+    density: unit(raw.density, base.density),
+    sizeJitter: unit(raw.sizeJitter, base.sizeJitter),
+    rotationJitter: unit(raw.rotationJitter, base.rotationJitter),
+    scatter: typeof raw.scatter === "number" && Number.isFinite(raw.scatter) ? Math.min(2, Math.max(0, raw.scatter)) : base.scatter,
+    colorJitter: unit(raw.colorJitter, base.colorJitter)
+  };
+}
+var PARTICLE_KINDS = ["string", "spring", "orbit", "flow", "elastic", "fuzzy"];
+var PARTICLE_RENDERS = ["dot", "line", "sequence", "ribbon"];
+var RIBBON_PAIRS = ["adjacent", "first-last"];
+var DOT_TEXTURE_ORDERS = ["sequence", "random"];
+var DOT_ROTATIONS = ["follow", "random", "fixed"];
+var MAX_DOT_TEXTURES = 4;
+var DEFAULT_PARTICLE = {
+  kind: "spring",
+  render: "line",
+  count: 12,
+  size: 0.08,
+  spread: 0.5,
+  stiffness: 0.4,
+  damping: 0.25,
+  speed: 0.5,
+  gravity: 0,
+  life: 0.5,
+  interval: 0.3,
+  ribbonFill: 0.5,
+  ribbonPairs: "adjacent",
+  waveAmplitude: 0,
+  waveLength: 60,
+  waveSpeed: 0,
+  wavePhaseJitter: 0,
+  dotTextures: [],
+  dotTextureOrder: "sequence",
+  dotRotation: "random"
+};
+function normalizeParticle(raw = {}, base = DEFAULT_PARTICLE) {
+  const textures = Array.isArray(raw.dotTextures) ? raw.dotTextures.filter((t) => _chunkJSDND7DFcjs.STAMP_KINDS.includes(t)).slice(0, MAX_DOT_TEXTURES) : [..._nullishCoalesce(base.dotTextures, () => ( []))];
+  return {
+    kind: oneOf(raw.kind, PARTICLE_KINDS, base.kind),
+    render: oneOf(raw.render, PARTICLE_RENDERS, base.render),
+    count: typeof raw.count === "number" && Number.isFinite(raw.count) ? Math.min(64, Math.max(1, Math.round(raw.count))) : base.count,
+    size: unit(raw.size, base.size),
+    spread: unit(raw.spread, base.spread),
+    stiffness: unit(raw.stiffness, base.stiffness),
+    damping: unit(raw.damping, base.damping),
+    speed: unit(raw.speed, base.speed),
+    gravity: typeof raw.gravity === "number" && Number.isFinite(raw.gravity) ? Math.min(1, Math.max(-1, raw.gravity)) : base.gravity,
+    life: unit(raw.life, base.life),
+    interval: unit(raw.interval, base.interval),
+    ribbonFill: unit(raw.ribbonFill, _nullishCoalesce(base.ribbonFill, () => ( DEFAULT_PARTICLE.ribbonFill))),
+    ribbonPairs: oneOf(raw.ribbonPairs, RIBBON_PAIRS, _nullishCoalesce(base.ribbonPairs, () => ( DEFAULT_PARTICLE.ribbonPairs))),
+    waveAmplitude: unit(raw.waveAmplitude, _nullishCoalesce(base.waveAmplitude, () => ( 0))),
+    waveLength: typeof raw.waveLength === "number" && Number.isFinite(raw.waveLength) ? Math.min(2e3, Math.max(4, raw.waveLength)) : _nullishCoalesce(base.waveLength, () => ( DEFAULT_PARTICLE.waveLength)),
+    waveSpeed: unit(raw.waveSpeed, _nullishCoalesce(base.waveSpeed, () => ( 0))),
+    wavePhaseJitter: unit(raw.wavePhaseJitter, _nullishCoalesce(base.wavePhaseJitter, () => ( 0))),
+    dotTextures: textures,
+    dotTextureOrder: oneOf(raw.dotTextureOrder, DOT_TEXTURE_ORDERS, _nullishCoalesce(base.dotTextureOrder, () => ( DEFAULT_PARTICLE.dotTextureOrder))),
+    dotRotation: oneOf(raw.dotRotation, DOT_ROTATIONS, _nullishCoalesce(base.dotRotation, () => ( DEFAULT_PARTICLE.dotRotation)))
+  };
+}
+var DEFAULT_BRISTLE = { count: 32, stiffness: 0.5, splay: 0.5, thickness: 0.06, load: 0.6, jitter: 0.4 };
+function normalizeBristle(raw = {}, base = DEFAULT_BRISTLE) {
+  return {
+    count: typeof raw.count === "number" && Number.isFinite(raw.count) ? Math.min(128, Math.max(3, Math.round(raw.count))) : base.count,
+    stiffness: unit(raw.stiffness, base.stiffness),
+    splay: unit(raw.splay, base.splay),
+    thickness: unit(raw.thickness, base.thickness),
+    load: unit(raw.load, base.load),
+    jitter: unit(raw.jitter, base.jitter)
+  };
+}
+
+// src/paint-editor/brushes.ts
+var PAINT_BRUSH_ENGINES = ["dab", "eraser", "mixer", "blender", "smudge", "wet", "impasto", "particle", "bristle", "sticker"];
+var PAINT_BRUSH_CATEGORIES = ["pencil", "pastel", "charcoal", "airbrush", "marker", "ink", "paint", "eraser", "blender", "smudge", "mixer", "watercolor", "wet-tool", "oil", "impasto", "procedural", "bristle", "sticker", "light", "custom"];
+var WET_TOOLS = ["paint", "water", "dry", "blow", "blend", "smudge", "blot"];
+var WET_MEDIA = ["watercolor", "gouache", "oil"];
+var DEFAULT_WET_BRUSH = { tool: "paint", water: 0.5, pigment: 0.5, body: 0, strength: 0.5, rewet: 0, medium: "watercolor", load: 1, thinner: 0 };
+function normalizeWetBrush(raw = {}, base = DEFAULT_WET_BRUSH) {
+  return {
+    tool: WET_TOOLS.includes(raw.tool) ? raw.tool : base.tool,
+    water: unit2(raw.water, base.water),
+    pigment: unit2(raw.pigment, base.pigment),
+    body: unit2(raw.body, base.body),
+    strength: unit2(raw.strength, base.strength),
+    rewet: unit2(raw.rewet, base.rewet),
+    medium: WET_MEDIA.includes(raw.medium) ? raw.medium : _nullishCoalesce(base.medium, () => ( "watercolor")),
+    load: unit2(raw.load, _nullishCoalesce(base.load, () => ( 1))),
+    thinner: unit2(raw.thinner, _nullishCoalesce(base.thinner, () => ( 0)))
+  };
+}
+var IMPASTO_TOOLS = ["brush", "tube", "knife", "roller", "gloop"];
+var DEFAULT_IMPASTO = { tool: "brush", thickness: 0.6, gloss: 0.4, metallic: 0, load: 0.9, thinner: 0, drag: 0.4, rim: 0, clarity: 0 };
+var DEFAULT_LIGHT = { amount: 0, pressure: false };
+function normalizeLight(raw = {}, base = DEFAULT_LIGHT) {
+  return { amount: unit2(raw.amount, base.amount), pressure: typeof raw.pressure === "boolean" ? raw.pressure : base.pressure };
+}
+function normalizeImpasto(raw = {}, base = DEFAULT_IMPASTO) {
+  return {
+    tool: IMPASTO_TOOLS.includes(raw.tool) ? raw.tool : base.tool,
+    thickness: unit2(raw.thickness, base.thickness),
+    gloss: unit2(raw.gloss, base.gloss),
+    metallic: unit2(raw.metallic, base.metallic),
+    load: unit2(raw.load, base.load),
+    thinner: unit2(raw.thinner, base.thinner),
+    drag: unit2(raw.drag, base.drag),
+    rim: unit2(raw.rim, _nullishCoalesce(base.rim, () => ( 0))),
+    clarity: unit2(raw.clarity, _nullishCoalesce(base.clarity, () => ( 0)))
+  };
+}
+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 DEFAULT_DYNAMICS = {
+  minSize: 0,
+  pressureFlow: 0,
+  tiltSize: 0,
+  tiltRoundness: 0,
+  tiltOpacity: 0,
+  velocitySize: 0,
+  velocityOpacity: 0,
+  sizeJitter: 0,
+  angleJitter: 0,
+  opacityJitter: 0,
+  scatter: 0
+};
+var unit2 = (v, d) => typeof v === "number" && Number.isFinite(v) ? Math.min(1, Math.max(0, v)) : d;
+var range = (v, lo, hi, d) => typeof v === "number" && Number.isFinite(v) ? Math.min(hi, Math.max(lo, v)) : d;
+function normalizeDynamics(raw = {}, base = DEFAULT_DYNAMICS) {
+  return {
+    minSize: unit2(raw.minSize, base.minSize),
+    pressureFlow: unit2(raw.pressureFlow, base.pressureFlow),
+    tiltSize: unit2(raw.tiltSize, base.tiltSize),
+    tiltRoundness: unit2(raw.tiltRoundness, base.tiltRoundness),
+    tiltOpacity: unit2(raw.tiltOpacity, base.tiltOpacity),
+    velocitySize: range(raw.velocitySize, -1, 1, base.velocitySize),
+    velocityOpacity: range(raw.velocityOpacity, -1, 1, base.velocityOpacity),
+    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)
+  };
+}
+var BRUSH_ID = /^[a-z0-9][a-z0-9-]{0,63}$/;
+var HEX = /^#[0-9a-f]{6}$/i;
+function normalizeMultiColor(raw = {}, base = DEFAULT_MULTI_COLOR) {
+  const colors = Array.isArray(raw.colors) ? raw.colors.filter((c) => typeof c === "string" && HEX.test(c.trim())).map((c) => c.trim().toLowerCase()).slice(0, 8) : base.colors;
+  return {
+    mode: MULTI_COLOR_MODES.includes(raw.mode) ? raw.mode : base.mode,
+    colors: [...colors],
+    order: raw.order === "random" || raw.order === "sequence" ? raw.order : base.order,
+    length: typeof raw.length === "number" && Number.isFinite(raw.length) ? Math.min(500, Math.max(1, Math.round(raw.length))) : base.length,
+    softness: unit2(raw.softness, base.softness)
+  };
+}
+function normalizeBehavior(raw = {}, base = DEFAULT_BEHAVIOR) {
+  return {
+    pickup: unit2(raw.pickup, base.pickup),
+    mix: unit2(raw.mix, base.mix),
+    dirty: typeof raw.dirty === "boolean" ? raw.dirty : base.dirty,
+    mixing: raw.mixing === "rgb" || raw.mixing === "pigment" ? raw.mixing : base.mixing,
+    multicolor: normalizeMultiColor(_nullishCoalesce(raw.multicolor, () => ( {})), base.multicolor)
+  };
+}
+function isWetCapable(brush) {
+  return brush.engine === "dab" || brush.engine === "mixer" || brush.engine === "wet" || brush.engine === "impasto";
+}
+function isWetBrush(brush) {
+  return brush.engine === "wet";
+}
+function usesPaintExchange(brush, gradient = brush.paint !== null) {
+  return brush.engine === "dab" && (brush.behavior.pickup > 0 || gradient);
+}
+function brushTakesPaint(brush) {
+  if (brush.engine === "eraser" || brush.engine === "blender" || brush.engine === "smudge") return false;
+  if (brush.engine === "wet") return brush.wet.tool === "paint";
+  if (brush.engine === "mixer") return brush.loadsColor;
+  return true;
+}
+function paintToMultiColor(g) {
+  if (!g || g.space === "oklab" || g.stops.some((s) => s.opacity !== void 0 || s.midpoint !== void 0)) return null;
+  const colors = g.stops.map((s) => s.color);
+  const own = (list) => list.length === 2 && list[0] === "paint" && list[1] === "secondary" ? [] : list.some((c) => c === "paint" || c === "secondary") ? null : list;
+  const uniform = (n) => g.stops.every((s, k) => s.offset === k / n);
+  const softness = _nullishCoalesce(g.softness, () => ( 1));
+  if (g.map.by === "across-tip" && colors.length <= 8 && uniform(colors.length - 1)) {
+    const c = own(colors);
+    return c ? { mode: "tip", colors: c, order: "sequence", length: DEFAULT_MULTI_COLOR.length, softness } : null;
+  }
+  if (g.map.by === "random" && colors.length % 2 === 0 && colors.length <= 16) {
+    const n = colors.length / 2;
+    const pairs = Array.from({ length: n }, (_, k) => colors[2 * k]);
+    const hard = g.stops.every((s, i) => s.offset === (Math.floor(i / 2) + i % 2) / n && s.color === pairs[Math.floor(i / 2)]);
+    const c = hard ? own(pairs) : null;
+    return c ? { mode: "dab", colors: c, order: "random", length: _nullishCoalesce(g.map.every, () => ( 1)), softness } : null;
+  }
+  if (g.map.by === "distance" && g.map.unit === "dabs" && g.map.repeat === "repeat" && colors.length >= 3 && colors.length <= 9 && colors[0] === colors[colors.length - 1] && uniform(colors.length - 1)) {
+    const n = colors.length - 1;
+    const c = own(colors.slice(0, n));
+    const length = g.map.length / n;
+    return c && Number.isInteger(length) ? { mode: "dab", colors: c, order: "sequence", length, softness } : null;
+  }
+  return null;
+}
+function multiColorToPaint(mc, mixing) {
+  if (mc.mode === "off") return null;
+  const colors = mc.colors.length >= 2 ? mc.colors : ["paint", "secondary"];
+  const n = colors.length;
+  const space = mixing === "rgb" ? "srgb" : "pigment";
+  const soft = mc.softness < 1 ? { softness: mc.softness } : {};
+  if (mc.mode === "tip") return { type: "gradient", stops: colors.map((color, k) => ({ offset: k / (n - 1), color })), space, map: { by: "across-tip" }, ...soft };
+  if (mc.order === "random") {
+    const stops = colors.flatMap((color, k) => [
+      { offset: k / n, color },
+      { offset: (k + 1) / n, color }
+    ]);
+    return { type: "gradient", stops, space, map: { by: "random", every: mc.length } };
+  }
+  return { type: "gradient", stops: [...colors, colors[0]].map((color, k) => ({ offset: k / n, color })), space, map: { by: "distance", length: mc.length * n, repeat: "repeat", unit: "dabs" }, ...soft };
+}
+function normalizePaintBrush(raw = {}, base) {
+  const b = _nullishCoalesce(base, () => ( BASE_BRUSH));
+  const id = typeof raw.id === "string" && BRUSH_ID.test(raw.id) ? raw.id : b.id;
+  const engine = PAINT_BRUSH_ENGINES.includes(raw.engine) ? raw.engine : b.engine;
+  const rb = _nullishCoalesce(raw.behavior, () => ( {}));
+  const mixerIn = { ...b.mixer, ..._nullishCoalesce(raw.mixer, () => ( {})) };
+  if (engine === "mixer") {
+    if (rb.pickup !== void 0) mixerIn.wet = rb.pickup;
+    if (rb.mix !== void 0) mixerIn.mix = rb.mix;
+    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);
+  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);
+    paint = p && p.type === "gradient" ? p : null;
+  } else if (rb.multicolor !== void 0) {
+    const mc = normalizeMultiColor(rb.multicolor, _nullishCoalesce(paintToMultiColor(paint), () => ( DEFAULT_MULTI_COLOR)));
+    paint = mc.mode === "off" ? paintToMultiColor(paint) ? null : paint : multiColorToPaint(mc, behavior.mixing);
+  }
+  behavior = { ...behavior, multicolor: _nullishCoalesce(paintToMultiColor(paint), () => ( { ...DEFAULT_MULTI_COLOR, colors: [] })) };
+  return {
+    id,
+    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, () => ( {})) }),
+    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,
+    dynamics: normalizeDynamics(_nullishCoalesce(raw.dynamics, () => ( {})), b.dynamics),
+    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),
+    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))),
+    bristle: normalizeBristle(_nullishCoalesce(raw.bristle, () => ( {})), _nullishCoalesce(b.bristle, () => ( DEFAULT_BRISTLE))),
+    sticker: normalizeStickerSettings(_nullishCoalesce(raw.sticker, () => ( {})), _nullishCoalesce(b.sticker, () => ( DEFAULT_STICKER))),
+    light: normalizeLight(_nullishCoalesce(raw.light, () => ( {})), _nullishCoalesce(b.light, () => ( DEFAULT_LIGHT))),
+    paint,
+    ...raw.builtin ? { builtin: true } : {}
+  };
+}
+var BASE_BRUSH = {
+  id: "round",
+  name: "Round",
+  category: "custom",
+  engine: "dab",
+  tip: { ..._chunkFQPUF2W2cjs.DEFAULT_BRUSH },
+  grain: 0,
+  pressureSmoothing: 0,
+  rotation: "fixed",
+  dynamics: { ...DEFAULT_DYNAMICS },
+  mixer: { ..._chunkFQPUF2W2cjs.DEFAULT_MIXER },
+  loadsColor: true,
+  behavior: { ...DEFAULT_BEHAVIOR, multicolor: { ...DEFAULT_MULTI_COLOR, colors: [] } },
+  blender: { ..._chunkFQPUF2W2cjs.DEFAULT_BLENDER },
+  smudge: { ..._chunkFQPUF2W2cjs.DEFAULT_SMUDGE },
+  wet: { ...DEFAULT_WET_BRUSH },
+  impasto: { ...DEFAULT_IMPASTO },
+  particle: { ...DEFAULT_PARTICLE },
+  bristle: { ...DEFAULT_BRISTLE },
+  sticker: { ...DEFAULT_STICKER, stamps: [...DEFAULT_STICKER.stamps] },
+  light: { ...DEFAULT_LIGHT },
+  paint: null
+};
+var builtin = (init) => ({ ...normalizePaintBrush(init), builtin: true });
+var BUILTIN_BRUSHES = [
+  builtin({
+    id: "pencil-hb",
+    name: "HB pencil",
+    category: "pencil",
+    tip: { size: 4, hardness: 0.7, spacing: 0.08, opacity: 0.85, flow: 0.55, smoothing: 0.25, pressureSize: true, pressureOpacity: true },
+    grain: 0.85,
+    pressureSmoothing: 0.3,
+    dynamics: { minSize: 0.55, tiltSize: 0.9, tiltRoundness: 0.7, tiltOpacity: 0.5 }
+  }),
+  builtin({
+    id: "pencil-6b",
+    name: "6B pencil",
+    category: "pencil",
+    tip: { size: 7, hardness: 0.55, spacing: 0.07, opacity: 1, flow: 0.75, smoothing: 0.2, pressureSize: true, pressureOpacity: true },
+    grain: 0.7,
+    pressureSmoothing: 0.3,
+    dynamics: { minSize: 0.5, tiltSize: 1, tiltRoundness: 0.75, tiltOpacity: 0.35 }
+  }),
+  builtin({
+    id: "soft-pastel",
+    name: "Soft pastel",
+    category: "pastel",
+    rotation: "stroke",
+    tip: { size: 32, hardness: 0.55, spacing: 0.05, angle: 90, roundness: 0.55, opacity: 1, flow: 0.7, smoothing: 0.15, pressureSize: false, pressureOpacity: true },
+    grain: 1,
+    pressureSmoothing: 0.25,
+    dynamics: { sizeJitter: 0.06, angleJitter: 0.02 }
+  }),
+  builtin({
+    id: "oil-pastel",
+    name: "Oil pastel",
+    category: "pastel",
+    rotation: "stroke",
+    tip: { size: 26, hardness: 0.8, spacing: 0.05, angle: 90, roundness: 0.7, opacity: 1, flow: 0.9, smoothing: 0.15, pressureSize: true, pressureOpacity: false, blend: "pigment" },
+    grain: 0.5,
+    pressureSmoothing: 0.25,
+    dynamics: { minSize: 0.6 }
+  }),
+  builtin({
+    id: "charcoal-stick",
+    name: "Charcoal stick",
+    category: "charcoal",
+    rotation: "stroke",
+    tip: { size: 26, hardness: 0.4, spacing: 0.05, angle: 90, roundness: 0.35, opacity: 0.95, flow: 0.5, smoothing: 0.15, pressureSize: false, pressureOpacity: true },
+    grain: 0.95,
+    pressureSmoothing: 0.2,
+    dynamics: { sizeJitter: 0.1, angleJitter: 0.03, tiltSize: 0.6 }
+  }),
+  builtin({
+    id: "vine-charcoal",
+    name: "Vine charcoal",
+    category: "charcoal",
+    tip: { size: 10, hardness: 0.3, spacing: 0.06, opacity: 0.75, flow: 0.45, smoothing: 0.2, pressureSize: true, pressureOpacity: true },
+    grain: 0.9,
+    pressureSmoothing: 0.2,
+    dynamics: { minSize: 0.4, tiltSize: 0.8, tiltRoundness: 0.5, tiltOpacity: 0.3, sizeJitter: 0.08 }
+  }),
+  builtin({
+    id: "airbrush",
+    name: "Airbrush",
+    category: "airbrush",
+    tip: { size: 90, hardness: 0, spacing: 0.04, opacity: 1, flow: 0.06, smoothing: 0.3, pressureSize: false, pressureOpacity: false },
+    grain: 0,
+    pressureSmoothing: 0.3,
+    dynamics: { pressureFlow: 1, tiltSize: 0.5, tiltRoundness: 0.6 }
+  }),
+  builtin({
+    id: "marker",
+    name: "Chisel marker",
+    category: "marker",
+    tip: { size: 24, hardness: 0.85, spacing: 0.04, angle: 45, roundness: 0.35, opacity: 0.6, flow: 1, smoothing: 0.3, pressureSize: false, pressureOpacity: false, blend: "multiply" },
+    grain: 0.1
+  }),
+  builtin({
+    id: "ink-pen",
+    name: "Ink pen",
+    category: "ink",
+    tip: { size: 4, hardness: 1, spacing: 0.05, opacity: 1, flow: 1, smoothing: 0.5, pressureSize: true, pressureOpacity: false },
+    pressureSmoothing: 0.4,
+    dynamics: { minSize: 0.25, velocitySize: -0.45 }
+  }),
+  builtin({
+    id: "brush-pen",
+    name: "Brush pen",
+    category: "ink",
+    rotation: "stroke",
+    tip: { size: 14, hardness: 0.9, spacing: 0.04, roundness: 0.8, opacity: 1, flow: 1, smoothing: 0.5, pressureSize: true, pressureOpacity: false },
+    pressureSmoothing: 0.45,
+    dynamics: { minSize: 0.05, velocitySize: -0.3 }
+  }),
+  builtin({
+    id: "eraser-soft",
+    name: "Soft eraser",
+    category: "eraser",
+    engine: "eraser",
+    tip: { size: 40, hardness: 0.2, spacing: 0.08, opacity: 1, flow: 0.6, pressureSize: false, pressureOpacity: true }
+  }),
+  builtin({
+    id: "eraser-hard",
+    name: "Hard eraser",
+    category: "eraser",
+    engine: "eraser",
+    tip: { size: 16, hardness: 0.9, spacing: 0.06, opacity: 1, flow: 1, pressureSize: true, pressureOpacity: false },
+    grain: 0.3,
+    dynamics: { minSize: 0.5 }
+  }),
+  builtin({
+    id: "blender",
+    name: "Blender",
+    category: "blender",
+    engine: "blender",
+    loadsColor: false,
+    tip: { size: 34, hardness: 0.4, spacing: 0.1, opacity: 1, flow: 1, smoothing: 0.2, pressureSize: false, pressureOpacity: true },
+    blender: { strength: 0.5, distance: 0.35, mixing: "pigment" }
+  }),
+  builtin({
+    id: "smudge",
+    name: "Smudge",
+    category: "smudge",
+    engine: "smudge",
+    loadsColor: false,
+    tip: { size: 26, hardness: 0.6, spacing: 0.06, opacity: 1, flow: 1, smoothing: 0.2, pressureSize: false, pressureOpacity: true },
+    smudge: { strength: 0.75, length: 0.85, mixing: "rgb" }
+  }),
+  builtin({
+    id: "wet-smudge",
+    name: "Pigment smudge",
+    category: "smudge",
+    engine: "smudge",
+    loadsColor: false,
+    tip: { size: 30, hardness: 0.5, spacing: 0.06, opacity: 1, flow: 1, smoothing: 0.2, pressureSize: true, pressureOpacity: true },
+    smudge: { strength: 0.7, length: 0.9, mixing: "pigment" },
+    dynamics: { minSize: 0.6 }
+  }),
+  builtin({
+    id: "dirty-round",
+    name: "Dirty round",
+    category: "paint",
+    tip: { size: 22, hardness: 0.65, spacing: 0.06, opacity: 1, flow: 0.7, smoothing: 0.2, pressureSize: true, pressureOpacity: false },
+    behavior: { pickup: 0.55, mix: 0.6, dirty: true, mixing: "pigment" },
+    dynamics: { minSize: 0.5 }
+  }),
+  builtin({
+    id: "multicolor-flat",
+    name: "Multi-colour flat",
+    category: "paint",
+    rotation: "stroke",
+    tip: { size: 30, hardness: 0.75, spacing: 0.05, angle: 90, roundness: 0.3, opacity: 1, flow: 0.85, smoothing: 0.2, pressureSize: true, pressureOpacity: false },
+    behavior: { pickup: 0.15, mix: 0.4, mixing: "pigment" },
+    // The paint and second colours side by side across the tip.
+    paint: { type: "gradient", stops: [{ offset: 0, color: "paint" }, { offset: 1, color: "secondary" }], space: "pigment", map: { by: "across-tip" }, softness: 0.7 },
+    dynamics: { minSize: 0.6 }
+  }),
+  builtin({
+    id: "palette-dabber",
+    name: "Palette dabber",
+    category: "paint",
+    tip: { size: 18, hardness: 0.7, spacing: 0.35, opacity: 1, flow: 0.9, smoothing: 0.1, pressureSize: true, pressureOpacity: false },
+    // From the paint colour to the second colour and back, every 6 dabs.
+    paint: { type: "gradient", stops: [{ offset: 0, color: "paint" }, { offset: 0.5, color: "secondary" }, { offset: 1, color: "paint" }], space: "pigment", map: { by: "distance", length: 12, repeat: "repeat", unit: "dabs" }, softness: 0.4 },
+    dynamics: { minSize: 0.5, sizeJitter: 0.15, scatter: 0.3 }
+  }),
+  builtin({
+    id: "gradient-round",
+    name: "Gradient round",
+    category: "paint",
+    tip: { size: 24, hardness: 0.8, spacing: 0.05, opacity: 1, flow: 0.9, smoothing: 0.2, pressureSize: true, pressureOpacity: false },
+    // Changes colour as it is dragged out: paint → second colour over 300 px, and back.
+    paint: { type: "gradient", stops: [{ offset: 0, color: "paint" }, { offset: 1, color: "secondary" }], space: "pigment", map: { by: "distance", length: 300, repeat: "mirror" } },
+    dynamics: { minSize: 0.5 }
+  }),
+  builtin({
+    id: "pressure-ombre",
+    name: "Pressure ombr\xE9",
+    category: "paint",
+    tip: { size: 26, hardness: 0.6, spacing: 0.05, opacity: 1, flow: 0.8, smoothing: 0.2, pressureSize: false, pressureOpacity: false },
+    // Light pressure lays the second colour, full pressure the paint colour.
+    paint: { type: "gradient", stops: [{ offset: 0, color: "secondary" }, { offset: 1, color: "paint" }], space: "pigment", map: { by: "pressure" } }
+  }),
+  builtin({
+    id: "rainbow-marker",
+    name: "Rainbow marker",
+    category: "marker",
+    rotation: "stroke",
+    tip: { size: 18, hardness: 0.9, spacing: 0.04, angle: 90, roundness: 0.4, opacity: 1, flow: 1, smoothing: 0.25, pressureSize: false, pressureOpacity: false },
+    paint: {
+      type: "gradient",
+      stops: [
+        { offset: 0, color: "#e11d48" },
+        { offset: 0.2, color: "#f59e0b" },
+        { offset: 0.4, color: "#facc15" },
+        { offset: 0.6, color: "#22c55e" },
+        { offset: 0.8, color: "#3b82f6" },
+        { offset: 1, color: "#8b5cf6" }
+      ],
+      space: "oklab",
+      map: { by: "distance", length: 600, repeat: "repeat" }
+    }
+  }),
+  builtin({
+    id: "mixer-brush",
+    name: "Mixer Brush",
+    category: "mixer",
+    engine: "mixer",
+    tip: { size: 30, hardness: 0.7, spacing: 0.1, opacity: 1, flow: 0.5, smoothing: 0.2, pressureSize: true, pressureOpacity: false },
+    mixer: { wet: 0.5, load: 0.95, mix: 0.5, loadEachStroke: true, cleanEachStroke: true, mixing: "pigment" },
+    dynamics: { minSize: 0.5 }
+  }),
+  builtin({
+    id: "watercolor-round",
+    name: "Watercolour round",
+    category: "watercolor",
+    engine: "wet",
+    tip: { size: 28, hardness: 0.6, spacing: 0.12, opacity: 1, flow: 1, smoothing: 0.25, pressureSize: true, pressureOpacity: true },
+    dynamics: { minSize: 0.35 },
+    behavior: { pickup: 0.55, mix: 0.5, mixing: "pigment" },
+    wet: { tool: "paint", water: 0.55, pigment: 0.5, body: 0, rewet: 0.2 }
+  }),
+  builtin({
+    id: "watercolor-wash",
+    name: "Wash brush",
+    category: "watercolor",
+    engine: "wet",
+    rotation: "stroke",
+    tip: { size: 90, hardness: 0.35, spacing: 0.1, angle: 90, roundness: 0.45, opacity: 1, flow: 1, smoothing: 0.3, pressureSize: false, pressureOpacity: true },
+    behavior: { pickup: 0.45, mix: 0.45, mixing: "pigment" },
+    wet: { tool: "paint", water: 0.8, pigment: 0.45, body: 0, rewet: 0.2 }
+  }),
+  builtin({
+    id: "gradient-wash",
+    name: "Gradient wash",
+    category: "watercolor",
+    engine: "wet",
+    rotation: "stroke",
+    tip: { size: 80, hardness: 0.35, spacing: 0.1, angle: 90, roundness: 0.5, opacity: 1, flow: 1, smoothing: 0.3, pressureSize: false, pressureOpacity: true },
+    behavior: { pickup: 0.4, mix: 0.4, mixing: "pigment" },
+    wet: { tool: "paint", water: 0.8, pigment: 0.45, body: 0, rewet: 0.2 },
+    // A graded wash: the paint colour runs into the second colour as the brush travels.
+    paint: { type: "gradient", stops: [{ offset: 0, color: "paint" }, { offset: 1, color: "secondary" }], space: "pigment", map: { by: "distance", length: 500, repeat: "mirror" } }
+  }),
+  builtin({
+    id: "watercolor-detail",
+    name: "Watercolour rigger",
+    category: "watercolor",
+    engine: "wet",
+    tip: { size: 7, hardness: 0.75, spacing: 0.1, opacity: 1, flow: 1, smoothing: 0.4, pressureSize: true, pressureOpacity: false },
+    dynamics: { minSize: 0.2 },
+    behavior: { pickup: 0.4, mix: 0.45, mixing: "pigment" },
+    wet: { tool: "paint", water: 0.4, pigment: 0.7, body: 0, rewet: 0.2 }
+  }),
+  builtin({
+    id: "gouache",
+    name: "Gouache",
+    category: "watercolor",
+    engine: "wet",
+    tip: { size: 26, hardness: 0.7, spacing: 0.1, opacity: 1, flow: 1, smoothing: 0.25, pressureSize: true, pressureOpacity: false },
+    dynamics: { minSize: 0.5 },
+    behavior: { pickup: 0.65, mix: 0.6, mixing: "pigment" },
+    wet: { tool: "paint", water: 0.35, pigment: 0.8, body: 1, medium: "gouache", rewet: 0.3 }
+  }),
+  builtin({
+    id: "oil-round",
+    name: "Wet oil round",
+    category: "oil",
+    engine: "wet",
+    tip: { size: 24, hardness: 0.75, spacing: 0.08, opacity: 1, flow: 1, smoothing: 0.25, pressureSize: true, pressureOpacity: false },
+    dynamics: { minSize: 0.5 },
+    behavior: { pickup: 0.6, mix: 0.55, mixing: "pigment" },
+    wet: { tool: "paint", water: 0.4, pigment: 0.9, body: 1, medium: "oil", load: 0.97 }
+  }),
+  builtin({
+    id: "oil-flat",
+    name: "Wet oil flat",
+    category: "oil",
+    engine: "wet",
+    rotation: "stroke",
+    tip: { size: 40, hardness: 0.85, spacing: 0.06, angle: 90, roundness: 0.35, opacity: 1, flow: 1, smoothing: 0.25, pressureSize: true, pressureOpacity: false },
+    dynamics: { minSize: 0.6 },
+    behavior: { pickup: 0.65, mix: 0.6, mixing: "pigment" },
+    wet: { tool: "paint", water: 0.45, pigment: 0.9, body: 1, medium: "oil", load: 0.95 }
+  }),
+  builtin({
+    id: "impasto-brush",
+    name: "Impasto brush",
+    category: "impasto",
+    engine: "impasto",
+    rotation: "stroke",
+    tip: { size: 36, hardness: 0.8, spacing: 0.06, angle: 90, roundness: 0.55, opacity: 1, flow: 1, smoothing: 0.25, pressureSize: true, pressureOpacity: false },
+    dynamics: { minSize: 0.55 },
+    behavior: { pickup: 0.4, mix: 0.5, mixing: "pigment" },
+    impasto: { tool: "brush", thickness: 0.6, gloss: 0.45, load: 0.92, drag: 0.4 }
+  }),
+  builtin({
+    id: "paint-tube",
+    name: "Paint tube",
+    category: "impasto",
+    engine: "impasto",
+    tip: { size: 22, hardness: 0.9, spacing: 0.05, opacity: 1, flow: 1, smoothing: 0.35, pressureSize: true, pressureOpacity: false },
+    dynamics: { minSize: 0.4 },
+    impasto: { tool: "tube", thickness: 0.9, gloss: 0.5, load: 1, drag: 0.1 }
+  }),
+  builtin({
+    id: "palette-knife",
+    name: "Palette knife",
+    category: "impasto",
+    engine: "impasto",
+    rotation: "stroke",
+    tip: { size: 48, hardness: 1, spacing: 0.05, angle: 90, roundness: 0.18, opacity: 1, flow: 1, smoothing: 0.3, pressureSize: false, pressureOpacity: false },
+    impasto: { tool: "knife", thickness: 0.3, gloss: 0.55, load: 1, drag: 0.85 }
+  }),
+  builtin({
+    id: "paint-roller",
+    name: "Roller",
+    category: "impasto",
+    engine: "impasto",
+    rotation: "stroke",
+    tip: { size: 70, hardness: 0.95, spacing: 0.04, angle: 90, roundness: 0.12, opacity: 1, flow: 1, smoothing: 0.4, pressureSize: false, pressureOpacity: false },
+    impasto: { tool: "roller", thickness: 0.25, gloss: 0.3, load: 0.9, drag: 0.15 }
+  }),
+  builtin({
+    id: "gloop-pen",
+    name: "Gloop pen",
+    category: "impasto",
+    engine: "impasto",
+    tip: { size: 14, hardness: 0.9, spacing: 0.05, opacity: 1, flow: 1, smoothing: 0.5, pressureSize: true, pressureOpacity: false },
+    dynamics: { minSize: 0.5 },
+    impasto: { tool: "gloop", thickness: 1, gloss: 0.9, load: 1, drag: 0 }
+  }),
+  builtin({
+    id: "metallic-paint",
+    name: "Metallic paint",
+    category: "impasto",
+    engine: "impasto",
+    rotation: "stroke",
+    tip: { size: 30, hardness: 0.8, spacing: 0.06, angle: 90, roundness: 0.6, opacity: 1, flow: 1, smoothing: 0.25, pressureSize: true, pressureOpacity: false },
+    dynamics: { minSize: 0.5 },
+    behavior: { pickup: 0.2, mix: 0.4, mixing: "pigment" },
+    impasto: { tool: "brush", thickness: 0.45, gloss: 0.8, metallic: 1, load: 0.95, drag: 0.3 }
+  }),
+  builtin({
+    id: "hair-strands",
+    name: "Hair strands",
+    category: "procedural",
+    engine: "particle",
+    tip: { size: 40, hardness: 0.8, opacity: 0.9, flow: 0.6, smoothing: 0.2, pressureSize: true, pressureOpacity: true },
+    particle: { kind: "string", render: "line", count: 22, size: 0.025, spread: 1, stiffness: 0.08, damping: 0.3 }
+  }),
+  builtin({
+    id: "spring-ink",
+    name: "Spring ink",
+    category: "procedural",
+    engine: "particle",
+    tip: { size: 30, hardness: 0.9, opacity: 1, flow: 0.8, smoothing: 0.1, pressureSize: true, pressureOpacity: false },
+    particle: { kind: "spring", render: "line", count: 5, size: 0.08, spread: 0.6, stiffness: 0.2, damping: 0.1 }
+  }),
+  builtin({
+    id: "orbit-curls",
+    name: "Orbit curls",
+    category: "procedural",
+    engine: "particle",
+    tip: { size: 36, hardness: 0.85, opacity: 0.9, flow: 0.7, smoothing: 0.2, pressureSize: true, pressureOpacity: false },
+    particle: { kind: "orbit", render: "line", count: 4, size: 0.05, spread: 0.6, speed: 0.45 }
+  }),
+  builtin({
+    id: "flow-fur",
+    name: "Flow fur",
+    category: "procedural",
+    engine: "particle",
+    tip: { size: 50, hardness: 0.7, opacity: 0.8, flow: 0.5, smoothing: 0.2, pressureSize: true, pressureOpacity: true },
+    particle: { kind: "flow", render: "line", count: 10, size: 0.03, spread: 0.6, speed: 0.5, life: 0.25 }
+  }),
+  builtin({
+    id: "bead-trail",
+    name: "Bead trail",
+    category: "procedural",
+    engine: "particle",
+    tip: { size: 34, hardness: 0.9, opacity: 1, flow: 1, smoothing: 0.25, pressureSize: true, pressureOpacity: false },
+    particle: { kind: "spring", render: "sequence", count: 3, size: 0.18, spread: 0.5, stiffness: 0.3, damping: 0.3, interval: 0.4 }
+  }),
+  builtin({
+    id: "sparkle-dust",
+    name: "Sparkle dust",
+    category: "procedural",
+    engine: "particle",
+    tip: { size: 60, hardness: 0.6, opacity: 1, flow: 0.9, smoothing: 0.1, pressureSize: true, pressureOpacity: true },
+    particle: { kind: "flow", render: "dot", count: 6, size: 0.05, spread: 0.9, speed: 0.7, life: 0.4 }
+  }),
+  builtin({
+    id: "bristle-round",
+    name: "Bristle round",
+    category: "bristle",
+    engine: "bristle",
+    rotation: "stroke",
+    tip: { size: 30, hardness: 0.85, opacity: 1, flow: 0.9, smoothing: 0.25, pressureSize: true, pressureOpacity: false },
+    dynamics: { minSize: 0.4, tiltSize: 0.6, tiltRoundness: 0.6 },
+    bristle: { count: 28, stiffness: 0.45, splay: 0.6, thickness: 0.035, load: 0.7, jitter: 0.5 }
+  }),
+  builtin({
+    id: "bristle-flat",
+    name: "Bristle flat",
+    category: "bristle",
+    engine: "bristle",
+    rotation: "stroke",
+    tip: { size: 46, hardness: 0.85, angle: 90, roundness: 0.3, opacity: 1, flow: 0.9, smoothing: 0.25, pressureSize: true, pressureOpacity: false },
+    dynamics: { minSize: 0.5, tiltSize: 0.5 },
+    bristle: { count: 40, stiffness: 0.6, splay: 0.4, thickness: 0.025, load: 0.65, jitter: 0.45 }
+  }),
+  builtin({
+    id: "dry-brush",
+    name: "Dry brush",
+    category: "bristle",
+    engine: "bristle",
+    rotation: "stroke",
+    tip: { size: 44, hardness: 0.9, angle: 90, roundness: 0.45, opacity: 1, flow: 0.8, smoothing: 0.2, pressureSize: true, pressureOpacity: false },
+    grain: 0.6,
+    bristle: { count: 48, stiffness: 0.35, splay: 0.7, thickness: 0.05, load: 0.15, jitter: 0.8 }
+  }),
+  // Light paint: brushes that lay light with their colour (glow and spill; see light.ts).
+  builtin({
+    id: "glow-gel",
+    name: "Glow gel",
+    category: "light",
+    engine: "impasto",
+    tip: { size: 16, hardness: 0.9, spacing: 0.05, opacity: 1, flow: 1, smoothing: 0.5, pressureSize: true, pressureOpacity: false },
+    dynamics: { minSize: 0.6 },
+    impasto: { tool: "gloop", thickness: 1, gloss: 0.95, load: 1, drag: 0, rim: 0.8, clarity: 0.5 },
+    light: { amount: 0.85 }
+  }),
+  builtin({
+    id: "neon-marker",
+    name: "Neon marker",
+    category: "light",
+    tip: { size: 10, hardness: 0.9, spacing: 0.04, opacity: 1, flow: 1, smoothing: 0.45, pressureSize: false, pressureOpacity: false },
+    light: { amount: 1 }
+  }),
+  builtin({
+    id: "light-airbrush",
+    name: "Light airbrush",
+    category: "light",
+    tip: { size: 90, hardness: 0, spacing: 0.04, opacity: 1, flow: 0.06, smoothing: 0.3, pressureSize: false, pressureOpacity: false },
+    pressureSmoothing: 0.3,
+    dynamics: { pressureFlow: 1 },
+    light: { amount: 0.7, pressure: true }
+  }),
+  builtin({
+    id: "spark-trail",
+    name: "Spark trail",
+    category: "light",
+    engine: "particle",
+    tip: { size: 50, hardness: 0.7, opacity: 1, flow: 1, smoothing: 0.1, pressureSize: true, pressureOpacity: false },
+    particle: { kind: "flow", render: "dot", count: 8, size: 0.06, spread: 0.7, speed: 0.9, life: 0.3 },
+    light: { amount: 1 }
+  }),
+  builtin({
+    // Silk of light: strands dragged behind the pen on slow waves, the bands between them filled.
+    id: "light-ribbon",
+    name: "Light ribbon",
+    category: "light",
+    engine: "particle",
+    tip: { size: 80, hardness: 0.8, opacity: 0.9, flow: 1, smoothing: 0.35, pressureSize: false, pressureOpacity: false },
+    particle: { kind: "string", render: "ribbon", count: 5, size: 0.015, spread: 1, stiffness: 0.05, damping: 0.3, ribbonFill: 0.45, waveAmplitude: 0.25, waveLength: 220, wavePhaseJitter: 0.25 },
+    light: { amount: 0.8 }
+  }),
+  builtin({
+    // Flames: short-lived bands thrown off the pen, rising and curling in the flow.
+    id: "flame-ribbon",
+    name: "Flame ribbon",
+    category: "light",
+    engine: "particle",
+    tip: { size: 50, hardness: 0.6, opacity: 0.85, flow: 1, smoothing: 0.25, pressureSize: true, pressureOpacity: false },
+    particle: { kind: "flow", render: "ribbon", count: 4, size: 0.012, spread: 0.5, speed: 0.6, gravity: -0.6, life: 0.2, ribbonFill: 0.5 },
+    light: { amount: 1 }
+  }),
+  builtin({
+    // A neon tube that lags and snaps back, with a slow shimmer.
+    id: "neon-strand",
+    name: "Neon strand",
+    category: "light",
+    engine: "particle",
+    tip: { size: 40, hardness: 0.9, opacity: 1, flow: 1, smoothing: 0.4, pressureSize: false, pressureOpacity: false },
+    particle: { kind: "elastic", render: "line", count: 3, size: 0.05, spread: 0.25, stiffness: 0.6, damping: 0.3, waveAmplitude: 0.06, waveLength: 120 },
+    light: { amount: 1 }
+  }),
+  builtin({
+    // Smoke lit from within: thin bands thrown into a slow, rising flow.
+    id: "smoke-ribbon",
+    name: "Smoke ribbon",
+    category: "light",
+    engine: "particle",
+    tip: { size: 70, hardness: 0.3, opacity: 0.45, flow: 1, smoothing: 0.3, pressureSize: true, pressureOpacity: false },
+    particle: { kind: "flow", render: "ribbon", count: 3, size: 5e-3, spread: 0.5, speed: 0.15, gravity: -0.15, life: 0.35, ribbonFill: 0.25, waveAmplitude: 0.1, waveLength: 140, wavePhaseJitter: 1 },
+    light: { amount: 0.3 }
+  }),
+  builtin({
+    // Out-of-focus lights: soft discs and rings spaced along springy paths.
+    id: "bokeh-dots",
+    name: "Bokeh dots",
+    category: "light",
+    engine: "particle",
+    tip: { size: 80, hardness: 0.7, opacity: 0.6, flow: 1, smoothing: 0.3, pressureSize: true, pressureOpacity: false },
+    particle: { kind: "spring", render: "sequence", count: 3, size: 0.3, spread: 1, stiffness: 0.15, damping: 0.4, interval: 1, dotTextures: ["dot", "dot", "ring"], dotTextureOrder: "random" },
+    light: { amount: 0.9 }
+  }),
+  builtin({
+    // Sparks: twinkles and stars thrown into the flow, spaced along it.
+    id: "twinkle-sparks",
+    name: "Twinkle sparks",
+    category: "light",
+    engine: "particle",
+    tip: { size: 50, hardness: 0.8, opacity: 1, flow: 1, smoothing: 0.1, pressureSize: true, pressureOpacity: false },
+    particle: { kind: "flow", render: "sequence", count: 3, size: 0.25, spread: 0.8, speed: 0.9, life: 0.35, interval: 0.6, dotTextures: ["sparkle", "sparkle", "star"], dotTextureOrder: "random", dotRotation: "random" },
+    light: { amount: 1 }
+  }),
+  builtin({
+    id: "glow-wash",
+    name: "Glow wash",
+    category: "light",
+    engine: "wet",
+    tip: { size: 40, hardness: 0.55, spacing: 0.12, opacity: 1, flow: 1, smoothing: 0.25, pressureSize: true, pressureOpacity: true },
+    dynamics: { minSize: 0.35 },
+    behavior: { pickup: 0.4, mix: 0.5, mixing: "pigment" },
+    wet: { tool: "paint", water: 0.65, pigment: 0.75, body: 0, rewet: 0.1 },
+    light: { amount: 0.7 }
+  }),
+  builtin({
+    // Fluorescent ink: a transparent chisel marker that multiplies (text under it stays dark) and
+    // glows a little brighter than the paper. Turn the layer's spill off (set_light_spill radius 0).
+    id: "highlighter",
+    name: "Highlighter",
+    category: "light",
+    tip: { size: 30, hardness: 0.85, spacing: 0.04, angle: 45, roundness: 0.35, opacity: 0.6, flow: 1, smoothing: 0.3, pressureSize: false, pressureOpacity: false, blend: "multiply" },
+    grain: 0.05,
+    light: { amount: 0.5 }
+  }),
+  builtin({
+    id: "sticker-stars",
+    name: "Star stickers",
+    category: "sticker",
+    engine: "sticker",
+    tip: { size: 36, opacity: 1, smoothing: 0.2, pressureSize: true, pressureOpacity: false },
+    dynamics: { minSize: 0.5 },
+    sticker: { stamps: ["star", "sparkle"], density: 0.35, sizeJitter: 0.5, rotationJitter: 1, scatter: 0.6, colorJitter: 0.3 }
+  }),
+  builtin({
+    id: "sticker-leaves",
+    name: "Leaf stickers",
+    category: "sticker",
+    engine: "sticker",
+    rotation: "stroke",
+    tip: { size: 40, opacity: 1, smoothing: 0.25, pressureSize: true, pressureOpacity: false },
+    dynamics: { minSize: 0.5 },
+    sticker: { stamps: ["leaf"], density: 0.5, sizeJitter: 0.4, rotationJitter: 0.35, scatter: 0.4, colorJitter: 0.35 }
+  }),
+  builtin({
+    id: "sticker-confetti",
+    name: "Confetti",
+    category: "sticker",
+    engine: "sticker",
+    tip: { size: 22, opacity: 1, smoothing: 0.1, pressureSize: false, pressureOpacity: false },
+    sticker: { stamps: ["confetti", "dot", "ring"], density: 0.7, sizeJitter: 0.5, rotationJitter: 1, scatter: 1.5, colorJitter: 1 }
+  }),
+  builtin({
+    id: "sticker-flowers",
+    name: "Flower stickers",
+    category: "sticker",
+    engine: "sticker",
+    tip: { size: 44, opacity: 1, smoothing: 0.2, pressureSize: true, pressureOpacity: false },
+    sticker: { stamps: ["flower", "heart"], density: 0.3, sizeJitter: 0.5, rotationJitter: 1, scatter: 0.7, colorJitter: 0.4 }
+  }),
+  builtin({
+    id: "sticker-splats",
+    name: "Paint splats",
+    category: "sticker",
+    engine: "sticker",
+    tip: { size: 50, opacity: 0.95, smoothing: 0.1, pressureSize: true, pressureOpacity: false },
+    sticker: { stamps: ["splat"], density: 0.25, sizeJitter: 0.6, rotationJitter: 1, scatter: 0.8, colorJitter: 0.15 }
+  }),
+  builtin({
+    id: "add-water",
+    name: "Add water",
+    category: "wet-tool",
+    engine: "wet",
+    tip: { size: 40, hardness: 0.4, spacing: 0.12, opacity: 1, flow: 1, smoothing: 0.25, pressureSize: true, pressureOpacity: true },
+    dynamics: { minSize: 0.5 },
+    wet: { tool: "water", water: 0.6, pigment: 0, rewet: 0.3 }
+  }),
+  builtin({
+    id: "hair-dryer",
+    name: "Dry",
+    category: "wet-tool",
+    engine: "wet",
+    tip: { size: 80, hardness: 0.1, spacing: 0.15, opacity: 1, flow: 1, smoothing: 0.3, pressureSize: false, pressureOpacity: true },
+    wet: { tool: "dry", strength: 0.5 }
+  }),
+  builtin({
+    id: "blow",
+    name: "Blow",
+    category: "wet-tool",
+    engine: "wet",
+    tip: { size: 50, hardness: 0.2, spacing: 0.1, opacity: 1, flow: 1, smoothing: 0.3, pressureSize: false, pressureOpacity: true },
+    wet: { tool: "blow", strength: 0.6 }
+  }),
+  builtin({
+    id: "wet-blend",
+    name: "Wet blend",
+    category: "wet-tool",
+    engine: "wet",
+    tip: { size: 36, hardness: 0.3, spacing: 0.1, opacity: 1, flow: 1, smoothing: 0.25, pressureSize: false, pressureOpacity: true },
+    wet: { tool: "blend", strength: 0.4 }
+  }),
+  builtin({
+    id: "wet-drag",
+    name: "Wet smudge",
+    category: "wet-tool",
+    engine: "wet",
+    tip: { size: 30, hardness: 0.5, spacing: 0.08, opacity: 1, flow: 1, smoothing: 0.25, pressureSize: false, pressureOpacity: true },
+    wet: { tool: "smudge", strength: 0.6 }
+  }),
+  builtin({
+    id: "blot",
+    name: "Blot (erase wet)",
+    category: "wet-tool",
+    engine: "wet",
+    tip: { size: 40, hardness: 0.5, spacing: 0.12, opacity: 1, flow: 1, smoothing: 0.2, pressureSize: false, pressureOpacity: true },
+    wet: { tool: "blot", strength: 0.7 }
+  })
+];
+var DEFAULT_BRUSH_ID = "pencil-6b";
+function brushToJSON(brush) {
+  const { builtin: _b, ...rest } = brush;
+  return JSON.parse(JSON.stringify(rest));
+}
+function parseBrushLibrary(raw, problems = []) {
+  const list = Array.isArray(raw) ? raw : raw && typeof raw === "object" && Array.isArray(raw.brushes) ? raw.brushes : null;
+  if (!list) throw new Error('Not a brush library: expected {"format":"pixerate-brushes","version":1,"brushes":[...]} or an array of brushes.');
+  const out = [];
+  list.forEach((item, i) => {
+    if (!item || typeof item !== "object") {
+      problems.push(`brushes[${i}] is not an object; skipped.`);
+      return;
+    }
+    const r = item;
+    if (typeof r.id !== "string" || !BRUSH_ID.test(r.id)) {
+      problems.push(`brushes[${i}] has no valid id (lowercase letters, digits and dashes); skipped.`);
+      return;
+    }
+    if (typeof r.name !== "string" || !r.name.trim()) {
+      problems.push(`brushes[${i}] ("${r.id}") has no name; skipped.`);
+      return;
+    }
+    const { builtin: _b, ...rest } = r;
+    out.push(normalizePaintBrush(rest));
+  });
+  return out;
+}
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+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.isWetCapable = isWetCapable; exports.isWetBrush = isWetBrush; exports.usesPaintExchange = usesPaintExchange; exports.brushTakesPaint = brushTakesPaint; exports.paintToMultiColor = paintToMultiColor; exports.multiColorToPaint = multiColorToPaint; exports.normalizePaintBrush = normalizePaintBrush; exports.BUILTIN_BRUSHES = BUILTIN_BRUSHES; exports.DEFAULT_BRUSH_ID = DEFAULT_BRUSH_ID; exports.brushToJSON = brushToJSON; exports.parseBrushLibrary = parseBrushLibrary;