@pixerate/editor 0.264.1 → 0.266.0

package/dist/brushes/index.cjs

@@ -8,7 +8,7 @@
 
 
 
-var _chunkF3KKR6DDcjs = require('../chunk-F3KKR6DD.cjs');
+var _chunk5OE4ZZ6Vcjs = require('../chunk-5OE4ZZ6V.cjs');
 require('../chunk-PE6YJMQT.cjs');
 
 
@@ -17,6 +17,7 @@ require('../chunk-PE6YJMQT.cjs');
 
 
 
+var _chunkDEBIFWY6cjs = require('../chunk-DEBIFWY6.cjs');
 
 
 
@@ -61,14 +62,20 @@ require('../chunk-PE6YJMQT.cjs');
 
 
 
-var _chunkBY5EBP26cjs = require('../chunk-BY5EBP26.cjs');
+
+
+
+
+
+
+
+var _chunk677777GHcjs = require('../chunk-677777GH.cjs');
 
 
 var _chunkOTN6VB5Scjs = require('../chunk-OTN6VB5S.cjs');
 
 
-var _chunkLRTR4ASZcjs = require('../chunk-LRTR4ASZ.cjs');
-require('../chunk-A2IS7EHE.cjs');
+var _chunkJBZRVLXVcjs = require('../chunk-JBZRVLXV.cjs');
 require('../chunk-U67EN7GG.cjs');
 require('../chunk-WOFXZ3XU.cjs');
 
@@ -115,20 +122,20 @@ var ARIA = {
   "light.pressure": "Light follows pressure"
 };
 var aria = (path, label) => _nullishCoalesce(ARIA[path], () => ( `Brush ${label.toLowerCase()}`));
-function brushEditorSections(brush, profile = _chunkBY5EBP26cjs.PAINT_PROFILE) {
-  const resolved = _chunkBY5EBP26cjs.resolveBrush.call(void 0, brush);
-  const engine = _chunkBY5EBP26cjs.resolveEngine.call(void 0, brush);
-  const fieldOf = (facet) => _chunkBY5EBP26cjs.BRUSH_FIELDS.find((f) => f.facet === facet && f.engines.includes(engine));
-  const facetOf = (enginePath) => _optionalChain([(_nullishCoalesce(_chunkBY5EBP26cjs.BRUSH_FIELDS.find((f) => f.engine === enginePath && f.engines.includes(engine)), () => ( _chunkBY5EBP26cjs.BRUSH_FIELDS.find((f) => f.engine === enginePath)))), 'optionalAccess', _ => _.facet]);
+function brushEditorSections(brush, profile = _chunk677777GHcjs.PAINT_PROFILE) {
+  const resolved = _chunk677777GHcjs.resolveBrush.call(void 0, brush);
+  const engine = _chunk677777GHcjs.resolveEngine.call(void 0, brush);
+  const fieldOf = (facet) => _chunk677777GHcjs.BRUSH_FIELDS.find((f) => f.facet === facet && f.engines.includes(engine));
+  const facetOf = (enginePath) => _optionalChain([(_nullishCoalesce(_chunk677777GHcjs.BRUSH_FIELDS.find((f) => f.engine === enginePath && f.engines.includes(engine)), () => ( _chunk677777GHcjs.BRUSH_FIELDS.find((f) => f.engine === enginePath)))), 'optionalAccess', _ => _.facet]);
   const value = (path) => {
-    const own = _chunkBY5EBP26cjs.getPath.call(void 0, brush, path);
+    const own = _chunk677777GHcjs.getPath.call(void 0, brush, path);
     if (own !== void 0) return own;
     const field = fieldOf(path);
     if (!field) return void 0;
-    const v = _chunkBY5EBP26cjs.getPath.call(void 0, resolved, field.engine);
+    const v = _chunk677777GHcjs.getPath.call(void 0, resolved, field.engine);
     return field.map ? field.map.toFacet(v) : v;
   };
-  const issues = _chunkBY5EBP26cjs.checkBrush.call(void 0, brush, profile).issues;
+  const issues = _chunk677777GHcjs.checkBrush.call(void 0, brush, profile).issues;
   const warned = new Map(issues.filter((i) => i.severity === "warning").map((i) => [i.facet, i.reason]));
   const refused = new Set(issues.filter((i) => i.severity === "error").map((i) => i.facet));
   const full = (s) => s === "full";
@@ -157,18 +164,18 @@ function brushEditorSections(brush, profile = _chunkBY5EBP26cjs.PAINT_PROFILE) {
   const exchangeFull = full(_optionalChain([brush, 'access', _9 => _9.behaviour, 'optionalAccess', _10 => _10.exchange, 'optionalAccess', _11 => _11.reservoir]) ? profile.reservoir : profile.exchange);
   add("medium", "Medium", [
     profile.kinds.length > 1 && profile.kinds.includes(brush.kind) && choice("kind", "Kind", options(profile.kinds, { mark: "Lays a material", tool: "Works on paint" })),
-    !isTool && choice("medium", "Medium", [{ value: "", label: "Any" }, ...options(_chunkBY5EBP26cjs.BRUSH_MEDIA, MEDIUM_LABELS)], ""),
+    !isTool && choice("medium", "Medium", [{ value: "", label: "Any" }, ...options(_chunk677777GHcjs.BRUSH_MEDIA, MEDIUM_LABELS)], ""),
     !isTool && withNote({ kind: "text", path: "variety", label: "Variety", ariaLabel: "Brush variety", value: _nullishCoalesce(brush.variety, () => ( "")), placeholder: "pencil, oil, highlighter\u2026" }),
     isTool && !!brush.tool && profile.tools.includes(brush.tool) && choice("tool", "Tool", options(profile.tools, TOOL_LABELS))
   ]);
-  const engineControls = _chunkF3KKR6DDcjs.brushEngineControls.call(void 0, resolved);
-  const tipSliders = _chunkF3KKR6DDcjs.BRUSH_SLIDERS.filter((c) => c.path.startsWith("tip.") && c.path !== "tip.smoothing");
+  const engineControls = _chunk5OE4ZZ6Vcjs.brushEngineControls.call(void 0, resolved);
+  const tipSliders = _chunk5OE4ZZ6Vcjs.BRUSH_SLIDERS.filter((c) => c.path.startsWith("tip.") && c.path !== "tip.smoothing");
   add("shape", "Shape", [
     !refused.has("tip.shape") && choice("tip.shape", "Tip", options(profile.tipShapes.filter((s) => !isTool || s !== "stamp"), SHAPE_LABELS)),
     ...tipSliders.map((c) => slider(c)),
     engine === "dab" && choice("tip.blend", "Blend", _chunk2VX55NFMcjs.BLEND_MODES.map((m) => ({ value: m.id, label: m.label })), "normal"),
     ...shape === "bristle" && engineOk && engineControls ? engineControls.sliders.filter((c) => c.path.startsWith("bristle.")).map((c) => slider(c)) : [],
-    shape === "stamp" && engineOk && withNote({ kind: "stamps", path: "tip.stamps", label: "Stamps", ariaLabel: "Brush stamps", value: [..._nullishCoalesce(value("tip.stamps"), () => ( []))], max: marks === "particles" ? _chunkBY5EBP26cjs.MAX_DOT_TEXTURES : _chunkBY5EBP26cjs.MAX_STICKER_STAMPS, options: STAMP_OPTIONS })
+    shape === "stamp" && engineOk && withNote({ kind: "stamps", path: "tip.stamps", label: "Stamps", ariaLabel: "Brush stamps", value: [..._nullishCoalesce(value("tip.stamps"), () => ( []))], max: marks === "particles" ? _chunk677777GHcjs.MAX_DOT_TEXTURES : _chunk677777GHcjs.MAX_STICKER_STAMPS, options: STAMP_OPTIONS })
   ]);
   if (!isTool && profile.marks.length > 1 && engineOk) {
     const particles = marks === "particles" && engineControls ? engineControls.sliders.filter((c) => c.path.startsWith("particle.") && c.path !== "particle.waveSpeed") : [];
@@ -176,21 +183,21 @@ function brushEditorSections(brush, profile = _chunkBY5EBP26cjs.PAINT_PROFILE) {
     const render = value("marks.render");
     add("marks", "Marks", [
       choice("marks.kind", "Laid as", options(profile.marks, MARKS_LABELS), "continuous"),
-      marks === "particles" && choice("marks.physics", "Particles", options(_chunkBY5EBP26cjs.PARTICLE_KINDS, PHYSICS_LABELS)),
-      marks === "particles" && choice("marks.render", "Drawn as", options(_chunkBY5EBP26cjs.PARTICLE_RENDERS, RENDER_LABELS)),
-      marks === "particles" && render === "ribbon" && choice("marks.ribbonPairs", "Ribbon joins", options(_chunkBY5EBP26cjs.RIBBON_PAIRS, { adjacent: "Neighbours", "first-last": "Outermost" })),
-      marks === "particles" && shape === "stamp" && choice("marks.stampOrder", "Texture order", options(_chunkBY5EBP26cjs.DOT_TEXTURE_ORDERS, { sequence: "In turn", random: "Random" })),
-      marks === "particles" && shape === "stamp" && choice("marks.stampRotation", "Texture turn", options(_chunkBY5EBP26cjs.DOT_ROTATIONS, { follow: "Follow motion", random: "Random", fixed: "Tip angle" })),
+      marks === "particles" && choice("marks.physics", "Particles", options(_chunk677777GHcjs.PARTICLE_KINDS, PHYSICS_LABELS)),
+      marks === "particles" && choice("marks.render", "Drawn as", options(_chunk677777GHcjs.PARTICLE_RENDERS, RENDER_LABELS)),
+      marks === "particles" && render === "ribbon" && choice("marks.ribbonPairs", "Ribbon joins", options(_chunk677777GHcjs.RIBBON_PAIRS, { adjacent: "Neighbours", "first-last": "Outermost" })),
+      marks === "particles" && shape === "stamp" && choice("marks.stampOrder", "Texture order", options(_chunk677777GHcjs.DOT_TEXTURE_ORDERS, { sequence: "In turn", random: "Random" })),
+      marks === "particles" && shape === "stamp" && choice("marks.stampRotation", "Texture turn", options(_chunk677777GHcjs.DOT_ROTATIONS, { follow: "Follow motion", random: "Random", fixed: "Tip angle" })),
       ...particles.map((c) => slider(c)),
       ...objects.map((c) => slider(c))
     ]);
   }
-  const feel = _chunkF3KKR6DDcjs.BRUSH_SLIDERS.filter((c) => ["tip.smoothing", "pressureSmoothing", "dynamics.minSize", "dynamics.tiltSize", "dynamics.velocitySize"].includes(c.path)).filter((c) => !(c.path === "dynamics.tiltSize" && !full(profile.tilt)) && !(c.path === "dynamics.velocitySize" && !full(profile.velocity)));
+  const feel = _chunk5OE4ZZ6Vcjs.BRUSH_SLIDERS.filter((c) => ["tip.smoothing", "pressureSmoothing", "dynamics.minSize", "dynamics.tiltSize", "dynamics.velocitySize"].includes(c.path)).filter((c) => !(c.path === "dynamics.tiltSize" && !full(profile.tilt)) && !(c.path === "dynamics.velocitySize" && !full(profile.velocity)));
   add("feel", "Feel", [
     ...feel.map((c) => slider(c)),
     toggle("dynamics.pressureSize", "Pressure \u2192 size"),
     toggle("dynamics.pressureOpacity", "Pressure \u2192 opacity"),
-    choice("dynamics.rotation", "Rotation", options(_chunkBY5EBP26cjs.BRUSH_ROTATIONS, ROTATION_LABELS))
+    choice("dynamics.rotation", "Rotation", options(_chunk677777GHcjs.BRUSH_ROTATIONS, ROTATION_LABELS))
   ]);
   const surfaces = profile.surfaces;
   const engineSliders = (engineOk ? _nullishCoalesce(_optionalChain([engineControls, 'optionalAccess', _12 => _12.sliders]), () => ( [])) : []).filter((c) => !/^(bristle|particle|sticker)\./.test(c.path) && c.path !== "light.amount" && c.path !== "impasto.rim" && c.path !== "impasto.clarity");
@@ -198,8 +205,8 @@ function brushEditorSections(brush, profile = _chunkBY5EBP26cjs.PAINT_PROFILE) {
   add("behaviour", _nullishCoalesce(_optionalChain([engineControls, 'optionalAccess', _15 => _15.title]), () => ( "Behaviour")), [
     !isTool && surfaces.length > 1 && !refused.has("behaviour.surface") && choice("behaviour.surface", "Surface", options(surfaces, SURFACE_LABELS), "dry"),
     full(profile.grain) && slider({ path: "grain", label: "Grain", min: 0, max: 1, step: 0.01 }, "behaviour.grain"),
-    engine === "wet" && engineOk && !isTool && choice("behaviour.wet.medium", "Medium", options(_chunkBY5EBP26cjs.WET_MEDIA, WET_MEDIUM_LABELS), "watercolor"),
-    engine === "impasto" && engineOk && choice("behaviour.thick.applicator", "Tool", options(_chunkBY5EBP26cjs.IMPASTO_TOOLS, APPLICATOR_LABELS), "brush"),
+    engine === "wet" && engineOk && !isTool && choice("behaviour.wet.medium", "Medium", options(_chunk677777GHcjs.WET_MEDIA, WET_MEDIUM_LABELS), "watercolor"),
+    engine === "impasto" && engineOk && choice("behaviour.thick.applicator", "Tool", options(_chunk677777GHcjs.IMPASTO_TOOLS, APPLICATOR_LABELS), "brush"),
     ...engineSliders.map((c) => exchangeOk(facetOf(c.path)) ? slider(c) : null),
     engineOk && _optionalChain([engineControls, 'optionalAccess', _16 => _16.mixingPath]) && (engine === "wet" || exchangeFull) && fieldOf("behaviour.mixing") && choice("behaviour.mixing", "Mixing", options(["pigment", "rgb"], { pigment: "Pigment", rgb: "RGB" })),
     engineOk && _optionalChain([engineControls, 'optionalAccess', _17 => _17.dirty]) && exchangeFull && fieldOf("behaviour.exchange.dirty") && toggle("behaviour.exchange.dirty", "Dirty brush"),
@@ -217,17 +224,17 @@ function brushEditorSections(brush, profile = _chunkBY5EBP26cjs.PAINT_PROFILE) {
   if (full(profile.motion) && engineOk && marks === "particles") add("motion", "Motion", [slider({ path: "particle.waveSpeed", label: "Wave speed", min: 0, max: 1, step: 0.01 })]);
   if (!isTool) {
     const own = _optionalChain([brush, 'access', _22 => _22.colour, 'optionalAccess', _23 => _23.default]);
-    const hex = (c) => typeof c === "string" ? _nullishCoalesce(_chunkLRTR4ASZcjs.brushColourHex.call(void 0, c, "light"), () => ( null)) : null;
+    const hex = (c) => typeof c === "string" ? _nullishCoalesce(_chunkJBZRVLXVcjs.brushColourHex.call(void 0, c, "light"), () => ( null)) : null;
     const pair = _chunkMLLTWAXHcjs.isDualColor.call(void 0, own) ? own : null;
     add("colour", "Colour", [
-      !refused.has("colour.default") && withNote({ kind: "colour", path: "colour.default", label: "Default colour", ariaLabel: "Brush default colour", value: pair ? _nullishCoalesce(_chunkLRTR4ASZcjs.brushColourHex.call(void 0, pair, "light"), () => ( null)) : hex(own), dark: pair ? _nullishCoalesce(_chunkLRTR4ASZcjs.brushColourHex.call(void 0, pair, "dark"), () => ( null)) : null, gradient: own !== void 0 && typeof own === "object" && !pair }),
+      !refused.has("colour.default") && withNote({ kind: "colour", path: "colour.default", label: "Default colour", ariaLabel: "Brush default colour", value: pair ? _nullishCoalesce(_chunkJBZRVLXVcjs.brushColourHex.call(void 0, pair, "light"), () => ( null)) : hex(own), dark: pair ? _nullishCoalesce(_chunkJBZRVLXVcjs.brushColourHex.call(void 0, pair, "dark"), () => ( null)) : null, gradient: own !== void 0 && typeof own === "object" && !pair }),
       withNote({
         kind: "palette",
         path: "colour.palette",
         label: "Palette",
         ariaLabel: "Brush palette",
-        value: (_nullishCoalesce(_optionalChain([brush, 'access', _24 => _24.colour, 'optionalAccess', _25 => _25.palette]), () => ( []))).flatMap((c) => _chunkMLLTWAXHcjs.isDualColor.call(void 0, c) ? [{ light: _chunkLRTR4ASZcjs.brushColourHex.call(void 0, c, "light"), dark: _chunkLRTR4ASZcjs.brushColourHex.call(void 0, c, "dark") }] : hex(c) ? [hex(c)] : []),
-        max: _chunkBY5EBP26cjs.MAX_BRUSH_PALETTE
+        value: (_nullishCoalesce(_optionalChain([brush, 'access', _24 => _24.colour, 'optionalAccess', _25 => _25.palette]), () => ( []))).flatMap((c) => _chunkMLLTWAXHcjs.isDualColor.call(void 0, c) ? [{ light: _chunkJBZRVLXVcjs.brushColourHex.call(void 0, c, "light"), dark: _chunkJBZRVLXVcjs.brushColourHex.call(void 0, c, "dark") }] : hex(c) ? [hex(c)] : []),
+        max: _chunk677777GHcjs.MAX_BRUSH_PALETTE
       }),
       toggle("colour.own", "Always its own colour")
     ]);
@@ -261,15 +268,15 @@ function hiddenLabel(issue, b) {
     case "dynamics.tilt":
       return "tilt dynamics";
     case "colour.default":
-      return `a ${_chunkBY5EBP26cjs.brushColourKind.call(void 0, b.colour.default)} default colour`;
+      return `a ${_chunk677777GHcjs.brushColourKind.call(void 0, b.colour.default)} default colour`;
     default:
       return null;
   }
 }
 var sentence = (words) => words.length < 2 ? _nullishCoalesce(words[0], () => ( "")) : `${words.slice(0, -1).join(", ")} and ${words.at(-1)}`;
-function brushEditorScope(brush, profile = _chunkBY5EBP26cjs.PAINT_PROFILE) {
+function brushEditorScope(brush, profile = _chunk677777GHcjs.PAINT_PROFILE) {
   const hidden = [];
-  for (const issue of _chunkBY5EBP26cjs.checkBrush.call(void 0, brush, profile).issues) {
+  for (const issue of _chunk677777GHcjs.checkBrush.call(void 0, brush, profile).issues) {
     const label = hiddenLabel(issue, brush);
     if (label && !hidden.some((h) => h.label === label)) hidden.push({ facet: issue.facet, label });
   }
@@ -282,17 +289,17 @@ function newBrushFor(profile, from, name = "New brush") {
   const id = brushIdFromName(name);
   const base = { id, name, kind: profile.kinds.includes("mark") ? "mark" : profile.kinds[0], ...profile.kinds.includes("mark") ? {} : { tool: profile.tools[0] }, tip: { shape: profile.tipShapes.includes("round") ? "round" : profile.tipShapes[0] } };
   if (from) {
-    const stripped = _chunkBY5EBP26cjs.degrade.call(void 0, from, profile, { ignored: true });
+    const stripped = _chunk677777GHcjs.degrade.call(void 0, from, profile, { ignored: true });
     if (!stripped.issues.length) return { ...stripped.brush, id, name };
   }
   return base;
 }
 async function saveBrushEdit(library, options2) {
   const { original, profile } = options2;
-  const check = _chunkBY5EBP26cjs.checkBrushEdit.call(void 0, original, options2.brush, profile);
+  const check = _chunk677777GHcjs.checkBrushEdit.call(void 0, original, options2.brush, profile);
   if (!check.ok) {
     const errors = check.issues.filter((i) => i.severity === "error").map((i) => `${i.facet}: ${i.reason} ${i.fix}`);
-    throw new (0, _chunkBY5EBP26cjs.BrushLibraryError)("invalid", `${profile.name} can't use this brush: ${errors.join(" ")} Nothing was saved.`);
+    throw new (0, _chunk677777GHcjs.BrushLibraryError)("invalid", `${profile.name} can't use this brush: ${errors.join(" ")} Nothing was saved.`);
   }
   const inPlace = !!original && options2.name === void 0 && !library.isBuiltin(original.id) && original.id === options2.brush.id && !!await library.get(original.id);
   let brush = options2.brush;
@@ -328,13 +335,13 @@ function setBrushEditorValue(brush, path, value) {
     if (value !== "bristle") delete next.tip.bristle;
   } else if (value === void 0 || value === "") {
     const keys = path.split(".");
-    const parent = _chunkBY5EBP26cjs.getPath.call(void 0, next, keys.slice(0, -1).join("."));
+    const parent = _chunk677777GHcjs.getPath.call(void 0, next, keys.slice(0, -1).join("."));
     if (keys.length === 1) delete next[keys[0]];
     else if (parent) delete parent[keys[keys.length - 1]];
-  } else _chunkBY5EBP26cjs.setPath.call(void 0, next, path, value);
+  } else _chunk677777GHcjs.setPath.call(void 0, next, path, value);
   const problems = [];
   try {
-    return { brush: _chunkBY5EBP26cjs.normalizeBrushSpec.call(void 0, JSON.parse(JSON.stringify(next)), problems), problems };
+    return { brush: _chunk677777GHcjs.normalizeBrushSpec.call(void 0, JSON.parse(JSON.stringify(next)), problems), problems };
   } catch (e) {
     return { brush, problems: [e.message] };
   }
@@ -350,7 +357,7 @@ function brushLibraryGroups(entries, filter = {}) {
       const text = words([b.id, b.name, _nullishCoalesce(b.variety, () => ( "")), _nullishCoalesce(b.medium, () => ( "")), _nullishCoalesce(b.tool, () => ( "")), ..._nullishCoalesce(b.tags, () => ( []))].join(" "));
       if (!wanted.every((w) => text.some((t) => t.startsWith(w)))) continue;
     }
-    if (filter.profile && !_chunkBY5EBP26cjs.checkBrush.call(void 0, b, filter.profile).ok) continue;
+    if (filter.profile && !_chunk677777GHcjs.checkBrush.call(void 0, b, filter.profile).ok) continue;
     const id = b.kind === "tool" ? "tools" : _nullishCoalesce(b.medium, () => ( "other"));
     let g = groups.get(id);
     if (!g) groups.set(id, g = { id, title: id === "tools" ? "Tools" : id === "other" ? "Other" : MEDIUM_LABELS[id], varieties: [] });
@@ -372,11 +379,11 @@ var BRUSH_PROFILE_JSON_SCHEMA = {
   properties: {
     id: { type: "string", description: "paint, image, canvas, vector\u2026" },
     name: { type: "string", description: "Display name, used in messages." },
-    kinds: { type: "array", items: { type: "string", enum: [..._chunkBY5EBP26cjs.BRUSH_KINDS] }, description: "Brush kinds it has." },
-    tools: { type: "array", items: { type: "string", enum: [..._chunkBY5EBP26cjs.BRUSH_TOOLS] }, description: "Tools it has (kind tool)." },
-    tipShapes: { type: "array", items: { type: "string", enum: [..._chunkBY5EBP26cjs.BRUSH_TIP_SHAPES] }, description: "Tip shapes it renders." },
-    marks: { type: "array", items: { type: "string", enum: [..._chunkBY5EBP26cjs.BRUSH_MARKS_KINDS] }, description: "Marks kinds it renders." },
-    surfaces: { type: "array", items: { type: "string", enum: [..._chunkBY5EBP26cjs.BRUSH_SURFACES] }, description: "Surfaces it renders." },
+    kinds: { type: "array", items: { type: "string", enum: [..._chunk677777GHcjs.BRUSH_KINDS] }, description: "Brush kinds it has." },
+    tools: { type: "array", items: { type: "string", enum: [..._chunk677777GHcjs.BRUSH_TOOLS] }, description: "Tools it has (kind tool)." },
+    tipShapes: { type: "array", items: { type: "string", enum: [..._chunk677777GHcjs.BRUSH_TIP_SHAPES] }, description: "Tip shapes it renders." },
+    marks: { type: "array", items: { type: "string", enum: [..._chunk677777GHcjs.BRUSH_MARKS_KINDS] }, description: "Marks kinds it renders." },
+    surfaces: { type: "array", items: { type: "string", enum: [..._chunk677777GHcjs.BRUSH_SURFACES] }, description: "Surfaces it renders." },
     exchange: { ...SUPPORT, description: "Picking paint up and mixing it in." },
     reservoir: { ...SUPPORT, description: "The Mixer Brush reservoir." },
     grain: { ...SUPPORT, description: "Paper grain response." },
@@ -401,7 +408,7 @@ var BRUSH_LIBRARY_FILE_JSON_SCHEMA = {
   additionalProperties: false
 };
 function migrationInputs() {
-  const pick = (id) => _chunkBY5EBP26cjs.brushToJSON.call(void 0, _chunkBY5EBP26cjs.BUILTIN_BRUSHES.find((b) => b.id === id));
+  const pick = (id) => _chunk677777GHcjs.brushToJSON.call(void 0, _chunk677777GHcjs.BUILTIN_BRUSHES.find((b) => b.id === id));
   return [
     { id: "plain", name: "Plain" },
     pick("pencil-6b"),
@@ -423,34 +430,34 @@ function migrationInputs() {
 function editorSectionFixtures() {
   const ids = ["highlighter", "chalk", "watercolor-wash", "hair-strands", "mixer-brush", "blender", "spray-can"];
   return ids.flatMap(
-    (id) => Object.keys(_chunkBY5EBP26cjs.BRUSH_HOST_PROFILES).map((host) => {
-      const brush = _chunkBY5EBP26cjs.BRUSH_PRESETS.find((b) => b.id === id);
-      return { brush: id, host, sections: brushEditorSections(brush, _chunkBY5EBP26cjs.BRUSH_HOST_PROFILES[host]) };
+    (id) => Object.keys(_chunk677777GHcjs.BRUSH_HOST_PROFILES).map((host) => {
+      const brush = _chunk677777GHcjs.BRUSH_PRESETS.find((b) => b.id === id);
+      return { brush: id, host, sections: brushEditorSections(brush, _chunk677777GHcjs.BRUSH_HOST_PROFILES[host]) };
     })
   );
 }
 function toolDefinitions() {
-  const library = _chunkBY5EBP26cjs.createBrushLibrary.call(void 0, );
-  const toolsFor = (host) => _chunkF3KKR6DDcjs.createBrushLibraryTools.call(void 0, library, { profile: _chunkBY5EBP26cjs.BRUSH_HOST_PROFILES[host], renderPreview: () => ({ data: "", mimeType: "image/png" }) });
+  const library = _chunk677777GHcjs.createBrushLibrary.call(void 0, );
+  const toolsFor = (host) => _chunk5OE4ZZ6Vcjs.createBrushLibraryTools.call(void 0, library, { profile: _chunk677777GHcjs.BRUSH_HOST_PROFILES[host], renderPreview: () => ({ data: "", mimeType: "image/png" }) });
   return {
     tools: toolsFor("paint").map((t) => ({ name: t.name, title: t.title, description: t.description, inputSchema: t.inputSchema, annotations: t.annotations })),
-    hosts: Object.fromEntries(Object.keys(_chunkBY5EBP26cjs.BRUSH_HOST_PROFILES).map((host) => [host, toolsFor(host).map((t) => t.name)]))
+    hosts: Object.fromEntries(Object.keys(_chunk677777GHcjs.BRUSH_HOST_PROFILES).map((host) => [host, toolsFor(host).map((t) => t.name)]))
   };
 }
 function brushContracts() {
-  const presets = _chunkBY5EBP26cjs.BRUSH_PRESETS.map((b) => JSON.parse(JSON.stringify(b)));
-  const resolved = _chunkBY5EBP26cjs.BRUSH_PRESETS.map((b) => ({ id: b.id, engine: _chunkBY5EBP26cjs.resolveEngine.call(void 0, b), category: _chunkBY5EBP26cjs.resolveCategory.call(void 0, b), brush: _chunkBY5EBP26cjs.brushToJSON.call(void 0, _chunkBY5EBP26cjs.resolveBrush.call(void 0, b)) }));
-  const profiles = Object.values(_chunkBY5EBP26cjs.BRUSH_HOST_PROFILES);
-  const checks = _chunkBY5EBP26cjs.BRUSH_PRESETS.map((b) => ({
+  const presets = _chunk677777GHcjs.BRUSH_PRESETS.map((b) => JSON.parse(JSON.stringify(b)));
+  const resolved = _chunk677777GHcjs.BRUSH_PRESETS.map((b) => ({ id: b.id, engine: _chunk677777GHcjs.resolveEngine.call(void 0, b), category: _chunk677777GHcjs.resolveCategory.call(void 0, b), brush: _chunk677777GHcjs.brushToJSON.call(void 0, _chunk677777GHcjs.resolveBrush.call(void 0, b)) }));
+  const profiles = Object.values(_chunk677777GHcjs.BRUSH_HOST_PROFILES);
+  const checks = _chunk677777GHcjs.BRUSH_PRESETS.map((b) => ({
     id: b.id,
     hosts: Object.fromEntries(profiles.map((p) => {
-      const c = _chunkBY5EBP26cjs.checkBrush.call(void 0, b, p);
+      const c = _chunk677777GHcjs.checkBrush.call(void 0, b, p);
       return [p.id, { ok: c.ok, issues: c.issues.map(({ facet, severity }) => ({ facet, severity })) }];
     }))
   }));
-  const migrations = migrationInputs().map((input) => ({ input, output: _chunkBY5EBP26cjs.migrateBrushV1.call(void 0, input), resolved: _chunkBY5EBP26cjs.brushToJSON.call(void 0, _chunkBY5EBP26cjs.resolveBrush.call(void 0, _chunkBY5EBP26cjs.migrateBrushV1.call(void 0, input))), engine: _chunkBY5EBP26cjs.normalizePaintBrush.call(void 0, input).engine }));
+  const migrations = migrationInputs().map((input) => ({ input, output: _chunk677777GHcjs.migrateBrushV1.call(void 0, input), resolved: _chunk677777GHcjs.brushToJSON.call(void 0, _chunk677777GHcjs.resolveBrush.call(void 0, _chunk677777GHcjs.migrateBrushV1.call(void 0, input))), engine: _chunk677777GHcjs.normalizePaintBrush.call(void 0, input).engine }));
   const files = {
-    "brush.schema.json": { $schema: "https://json-schema.org/draft/2020-12/schema", $id: "brush.schema.json", ..._chunkBY5EBP26cjs.BRUSH_JSON_SCHEMA },
+    "brush.schema.json": { $schema: "https://json-schema.org/draft/2020-12/schema", $id: "brush.schema.json", ..._chunk677777GHcjs.BRUSH_JSON_SCHEMA },
     "profile.schema.json": { $schema: "https://json-schema.org/draft/2020-12/schema", $id: "profile.schema.json", ...BRUSH_PROFILE_JSON_SCHEMA },
     "library-file.schema.json": { $schema: "https://json-schema.org/draft/2020-12/schema", $id: "library-file.schema.json", ...BRUSH_LIBRARY_FILE_JSON_SCHEMA },
     "presets.json": presets,
@@ -464,7 +471,7 @@ function brushContracts() {
   files["manifest.json"] = {
     domain: "brushes",
     formatVersion: BRUSH_CONTRACT_FORMAT_VERSION,
-    limits: { maxPalette: _chunkBY5EBP26cjs.MAX_BRUSH_PALETTE },
+    limits: { maxPalette: _chunk677777GHcjs.MAX_BRUSH_PALETTE },
     counts: { presets: presets.length, profiles: profiles.length, migrations: migrations.length, editorSections: files["editor-sections.json"].length },
     files: Object.keys(files).sort()
   };
@@ -524,4 +531,10 @@ function brushContracts() {
 
 
 
-exports.BRUSH_CONTRACT_FORMAT_VERSION = BRUSH_CONTRACT_FORMAT_VERSION; exports.BRUSH_FACET_SCHEMAS = _chunkBY5EBP26cjs.BRUSH_FACET_SCHEMAS; exports.BRUSH_HOST_PROFILES = _chunkBY5EBP26cjs.BRUSH_HOST_PROFILES; exports.BRUSH_JSON_SCHEMA = _chunkBY5EBP26cjs.BRUSH_JSON_SCHEMA; exports.BRUSH_KINDS = _chunkBY5EBP26cjs.BRUSH_KINDS; exports.BRUSH_LIBRARY_FILE_JSON_SCHEMA = BRUSH_LIBRARY_FILE_JSON_SCHEMA; exports.BRUSH_MARKS_KINDS = _chunkBY5EBP26cjs.BRUSH_MARKS_KINDS; exports.BRUSH_MEDIA = _chunkBY5EBP26cjs.BRUSH_MEDIA; exports.BRUSH_PATCH_PROPERTIES = _chunkF3KKR6DDcjs.BRUSH_PATCH_PROPERTIES; exports.BRUSH_PRESETS = _chunkBY5EBP26cjs.BRUSH_PRESETS; exports.BRUSH_PROFILE_JSON_SCHEMA = BRUSH_PROFILE_JSON_SCHEMA; exports.BRUSH_SURFACES = _chunkBY5EBP26cjs.BRUSH_SURFACES; exports.BRUSH_TIP_SHAPES = _chunkBY5EBP26cjs.BRUSH_TIP_SHAPES; exports.BRUSH_TOOLS = _chunkBY5EBP26cjs.BRUSH_TOOLS; exports.BRUSH_UNSET_PROPERTY = _chunkF3KKR6DDcjs.BRUSH_UNSET_PROPERTY; exports.BRUSH_WORD = _chunkBY5EBP26cjs.BRUSH_WORD; exports.BrushLibraryError = _chunkBY5EBP26cjs.BrushLibraryError; exports.CANVAS_PROFILE = _chunkBY5EBP26cjs.CANVAS_PROFILE; exports.IMAGE_PROFILE = _chunkBY5EBP26cjs.IMAGE_PROFILE; exports.MAX_BRUSH_PALETTE = _chunkBY5EBP26cjs.MAX_BRUSH_PALETTE; exports.PAINT_PROFILE = _chunkBY5EBP26cjs.PAINT_PROFILE; exports.UNSETTABLE_BRUSH_FACETS = _chunkF3KKR6DDcjs.UNSETTABLE_BRUSH_FACETS; exports.VECTOR_PROFILE = _chunkBY5EBP26cjs.VECTOR_PROFILE; exports.WET_BRUSH_TOOLS = _chunkBY5EBP26cjs.WET_BRUSH_TOOLS; exports.brushColourHex = _chunkLRTR4ASZcjs.brushColourHex; exports.brushColourKind = _chunkBY5EBP26cjs.brushColourKind; exports.brushContracts = brushContracts; exports.brushEditorScope = brushEditorScope; exports.brushEditorSections = brushEditorSections; exports.brushIdFromName = brushIdFromName; exports.brushLibraryGroups = brushLibraryGroups; exports.changedBrushPaths = _chunkF3KKR6DDcjs.changedBrushPaths; exports.checkBrush = _chunkBY5EBP26cjs.checkBrush; exports.checkBrushEdit = _chunkBY5EBP26cjs.checkBrushEdit; exports.createBrushLibrary = _chunkBY5EBP26cjs.createBrushLibrary; exports.createBrushLibraryToolProvider = _chunkF3KKR6DDcjs.createBrushLibraryToolProvider; exports.createBrushLibraryTools = _chunkF3KKR6DDcjs.createBrushLibraryTools; exports.degrade = _chunkBY5EBP26cjs.degrade; exports.isBrushLibrary = _chunkBY5EBP26cjs.isBrushLibrary; exports.listPresets = _chunkBY5EBP26cjs.listPresets; exports.mergeBrushPatch = _chunkF3KKR6DDcjs.mergeBrushPatch; exports.migrateBrushV1 = _chunkBY5EBP26cjs.migrateBrushV1; exports.newBrushFor = newBrushFor; exports.normalizeBrushSpec = _chunkBY5EBP26cjs.normalizeBrushSpec; exports.parseBrushLibrary = _chunkBY5EBP26cjs.parseBrushLibrary2; exports.resolveBrush = _chunkBY5EBP26cjs.resolveBrush; exports.resolveCategory = _chunkBY5EBP26cjs.resolveCategory; exports.resolveEngine = _chunkBY5EBP26cjs.resolveEngine; exports.resolveWetMedium = _chunkBY5EBP26cjs.resolveWetMedium; exports.saveBrushEdit = saveBrushEdit; exports.setBrushEditorValue = setBrushEditorValue; exports.snapshotBrushLibrary = _chunkBY5EBP26cjs.snapshotBrushLibrary; exports.withKeptIssues = _chunkBY5EBP26cjs.withKeptIssues;
+
+
+
+
+
+
+exports.BRUSH_CONTRACT_FORMAT_VERSION = BRUSH_CONTRACT_FORMAT_VERSION; exports.BRUSH_FACET_SCHEMAS = _chunk677777GHcjs.BRUSH_FACET_SCHEMAS; exports.BRUSH_HOST_PROFILES = _chunk677777GHcjs.BRUSH_HOST_PROFILES; exports.BRUSH_JSON_SCHEMA = _chunk677777GHcjs.BRUSH_JSON_SCHEMA; exports.BRUSH_KINDS = _chunk677777GHcjs.BRUSH_KINDS; exports.BRUSH_LIBRARY_FILE_JSON_SCHEMA = BRUSH_LIBRARY_FILE_JSON_SCHEMA; exports.BRUSH_MARKS_KINDS = _chunk677777GHcjs.BRUSH_MARKS_KINDS; exports.BRUSH_MEDIA = _chunk677777GHcjs.BRUSH_MEDIA; exports.BRUSH_PATCH_PROPERTIES = _chunk5OE4ZZ6Vcjs.BRUSH_PATCH_PROPERTIES; exports.BRUSH_PRESETS = _chunk677777GHcjs.BRUSH_PRESETS; exports.BRUSH_PREVIEW_DARK_PAPER = _chunkDEBIFWY6cjs.BRUSH_PREVIEW_DARK_PAPER; exports.BRUSH_PREVIEW_FALLBACKS = _chunkDEBIFWY6cjs.BRUSH_PREVIEW_FALLBACKS; exports.BRUSH_PREVIEW_MIN_CONTRAST = _chunkDEBIFWY6cjs.BRUSH_PREVIEW_MIN_CONTRAST; exports.BRUSH_PROFILE_JSON_SCHEMA = BRUSH_PROFILE_JSON_SCHEMA; exports.BRUSH_SURFACES = _chunk677777GHcjs.BRUSH_SURFACES; exports.BRUSH_TIP_SHAPES = _chunk677777GHcjs.BRUSH_TIP_SHAPES; exports.BRUSH_TOOLS = _chunk677777GHcjs.BRUSH_TOOLS; exports.BRUSH_UNSET_PROPERTY = _chunk5OE4ZZ6Vcjs.BRUSH_UNSET_PROPERTY; exports.BRUSH_WORD = _chunk677777GHcjs.BRUSH_WORD; exports.BrushLibraryError = _chunk677777GHcjs.BrushLibraryError; exports.CANVAS_PROFILE = _chunk677777GHcjs.CANVAS_PROFILE; exports.IMAGE_PROFILE = _chunk677777GHcjs.IMAGE_PROFILE; exports.MAX_BRUSH_PALETTE = _chunk677777GHcjs.MAX_BRUSH_PALETTE; exports.PAINT_PROFILE = _chunk677777GHcjs.PAINT_PROFILE; exports.UNSETTABLE_BRUSH_FACETS = _chunk5OE4ZZ6Vcjs.UNSETTABLE_BRUSH_FACETS; exports.VECTOR_PROFILE = _chunk677777GHcjs.VECTOR_PROFILE; exports.WET_BRUSH_TOOLS = _chunk677777GHcjs.WET_BRUSH_TOOLS; exports.brushColourHex = _chunkJBZRVLXVcjs.brushColourHex; exports.brushColourKind = _chunk677777GHcjs.brushColourKind; exports.brushContracts = brushContracts; exports.brushEditorScope = brushEditorScope; exports.brushEditorSections = brushEditorSections; exports.brushIdFromName = brushIdFromName; exports.brushLibraryGroups = brushLibraryGroups; exports.brushPreviewColours = _chunkDEBIFWY6cjs.brushPreviewColours; exports.brushPreviewStrength = _chunkDEBIFWY6cjs.brushPreviewStrength; exports.brushPreviewsOnDark = _chunkDEBIFWY6cjs.brushPreviewsOnDark; exports.changedBrushPaths = _chunk5OE4ZZ6Vcjs.changedBrushPaths; exports.checkBrush = _chunk677777GHcjs.checkBrush; exports.checkBrushEdit = _chunk677777GHcjs.checkBrushEdit; exports.createBrushLibrary = _chunk677777GHcjs.createBrushLibrary; exports.createBrushLibraryToolProvider = _chunk5OE4ZZ6Vcjs.createBrushLibraryToolProvider; exports.createBrushLibraryTools = _chunk5OE4ZZ6Vcjs.createBrushLibraryTools; exports.degrade = _chunk677777GHcjs.degrade; exports.isBrushLibrary = _chunk677777GHcjs.isBrushLibrary; exports.listPresets = _chunk677777GHcjs.listPresets; exports.mergeBrushPatch = _chunk5OE4ZZ6Vcjs.mergeBrushPatch; exports.migrateBrushV1 = _chunk677777GHcjs.migrateBrushV1; exports.newBrushFor = newBrushFor; exports.normalizeBrushSpec = _chunk677777GHcjs.normalizeBrushSpec; exports.parseBrushLibrary = _chunk677777GHcjs.parseBrushLibrary2; exports.resolveBrush = _chunk677777GHcjs.resolveBrush; exports.resolveCategory = _chunk677777GHcjs.resolveCategory; exports.resolveEngine = _chunk677777GHcjs.resolveEngine; exports.resolveWetMedium = _chunk677777GHcjs.resolveWetMedium; exports.saveBrushEdit = saveBrushEdit; exports.setBrushEditorValue = setBrushEditorValue; exports.snapshotBrushLibrary = _chunk677777GHcjs.snapshotBrushLibrary; exports.withKeptIssues = _chunk677777GHcjs.withKeptIssues;

package/dist/brushes/index.d.cts

@@ -15,6 +15,7 @@ export { resolveBrush, resolveCategory, resolveEngine, resolveWetMedium, type Re
 export { migrateBrushV1 } from './migrate.cjs';
 export { BRUSH_PRESETS } from './presets.cjs';
 export { brushColourHex } from './colour.cjs';
+export { BRUSH_PREVIEW_DARK_PAPER, BRUSH_PREVIEW_FALLBACKS, BRUSH_PREVIEW_MIN_CONTRAST, brushPreviewColours, brushPreviewsOnDark, brushPreviewStrength, type BrushPreviewColours, type BrushPreviewColoursOptions } from './preview.cjs';
 export { BRUSH_CONTRACT_FORMAT_VERSION, BRUSH_LIBRARY_FILE_JSON_SCHEMA, BRUSH_PROFILE_JSON_SCHEMA, brushContracts } from './contract.cjs';
 export { BRUSH_HOST_PROFILES, brushColourKind, CANVAS_PROFILE, checkBrush, checkBrushEdit, degrade, withKeptIssues, IMAGE_PROFILE, listPresets, PAINT_PROFILE, VECTOR_PROFILE, type BrushCheck, type BrushEditCheck, type BrushColourKind, type BrushHostProfile, type BrushIssue, type BrushSupport, type DegradedBrush } from './profiles.cjs';
 export { BrushLibraryError, createBrushLibrary, isBrushLibrary, parseBrushLibrary, snapshotBrushLibrary, type BrushFilter, type BrushLibrary, type BrushLibraryEntry, type BrushLibraryErrorCode, type BrushLibraryFile, type BrushLibrarySnapshot, type BrushLibraryOptions, type ImportBrushesResult, type SaveBrushResult, } from './library.cjs';

package/dist/brushes/index.d.ts

@@ -15,6 +15,7 @@ export { resolveBrush, resolveCategory, resolveEngine, resolveWetMedium, type Re
 export { migrateBrushV1 } from './migrate.js';
 export { BRUSH_PRESETS } from './presets.js';
 export { brushColourHex } from './colour.js';
+export { BRUSH_PREVIEW_DARK_PAPER, BRUSH_PREVIEW_FALLBACKS, BRUSH_PREVIEW_MIN_CONTRAST, brushPreviewColours, brushPreviewsOnDark, brushPreviewStrength, type BrushPreviewColours, type BrushPreviewColoursOptions } from './preview.js';
 export { BRUSH_CONTRACT_FORMAT_VERSION, BRUSH_LIBRARY_FILE_JSON_SCHEMA, BRUSH_PROFILE_JSON_SCHEMA, brushContracts } from './contract.js';
 export { BRUSH_HOST_PROFILES, brushColourKind, CANVAS_PROFILE, checkBrush, checkBrushEdit, degrade, withKeptIssues, IMAGE_PROFILE, listPresets, PAINT_PROFILE, VECTOR_PROFILE, type BrushCheck, type BrushEditCheck, type BrushColourKind, type BrushHostProfile, type BrushIssue, type BrushSupport, type DegradedBrush } from './profiles.js';
 export { BrushLibraryError, createBrushLibrary, isBrushLibrary, parseBrushLibrary, snapshotBrushLibrary, type BrushFilter, type BrushLibrary, type BrushLibraryEntry, type BrushLibraryErrorCode, type BrushLibraryFile, type BrushLibrarySnapshot, type BrushLibraryOptions, type ImportBrushesResult, type SaveBrushResult, } from './library.js';

package/dist/brushes/index.js

@@ -8,8 +8,16 @@ import {
   createBrushLibraryToolProvider,
   createBrushLibraryTools,
   mergeBrushPatch
-} from "../chunk-4OJC4MCD.js";
+} from "../chunk-Q6RVVJW6.js";
 import "../chunk-6JL2D5SG.js";
+import {
+  BRUSH_PREVIEW_DARK_PAPER,
+  BRUSH_PREVIEW_FALLBACKS,
+  BRUSH_PREVIEW_MIN_CONTRAST,
+  brushPreviewColours,
+  brushPreviewStrength,
+  brushPreviewsOnDark
+} from "../chunk-ZS7LB2MV.js";
 import {
   BRUSH_FACET_SCHEMAS,
   BRUSH_FIELDS,
@@ -61,14 +69,13 @@ import {
   setPath,
   snapshotBrushLibrary,
   withKeptIssues
-} from "../chunk-EE7SAYBF.js";
+} from "../chunk-J4SGJCPW.js";
 import {
   STAMP_KINDS
 } from "../chunk-ACFSFUQH.js";
 import {
   brushColourHex
-} from "../chunk-FJBQTZS4.js";
-import "../chunk-3CI7FRMK.js";
+} from "../chunk-DVPQFMH6.js";
 import "../chunk-SZTI6EER.js";
 import "../chunk-V2ZCJRDM.js";
 import {
@@ -481,6 +488,9 @@ export {
   BRUSH_MEDIA,
   BRUSH_PATCH_PROPERTIES,
   BRUSH_PRESETS,
+  BRUSH_PREVIEW_DARK_PAPER,
+  BRUSH_PREVIEW_FALLBACKS,
+  BRUSH_PREVIEW_MIN_CONTRAST,
   BRUSH_PROFILE_JSON_SCHEMA,
   BRUSH_SURFACES,
   BRUSH_TIP_SHAPES,
@@ -502,6 +512,9 @@ export {
   brushEditorSections,
   brushIdFromName,
   brushLibraryGroups,
+  brushPreviewColours,
+  brushPreviewStrength,
+  brushPreviewsOnDark,
   changedBrushPaths,
   checkBrush,
   checkBrushEdit,

package/dist/brushes/preview.d.cts

@@ -0,0 +1,59 @@
+/**
+ * Preview colours for brushes: what a preview is drawn on and the colour that reads on it.
+ * `brushPreviewColours` picks the background (the renderer's paper, or dark paper for brushes
+ * that give off light) and a stroke colour with at least 3:1 contrast against it: the brush's
+ * default colour, resolved for that background (a light / dark pair takes its side), else a
+ * colour for the medium. Multiply brushes preview on white rather than a dark surface. Previews
+ * only: it never sets anyone's paint colour.
+ */
+import { type ColorScheme, type DualColor } from '../color/dual.cjs';
+import { type BrushHostProfile } from './profiles.cjs';
+import type { Brush } from './types.cjs';
+/** The paper behind brushes that give off light, so their glow reads. */
+export declare const BRUSH_PREVIEW_DARK_PAPER = "#141414";
+/** The contrast a preview colour keeps against its background (WCAG large-text / graphics). */
+export declare const BRUSH_PREVIEW_MIN_CONTRAST = 3;
+/** Preview colours for brushes with no solid default, by medium (`tools` for tool brushes). */
+export declare const BRUSH_PREVIEW_FALLBACKS: Readonly<Record<string, DualColor>>;
+/**
+ * Whether a brush that gives off `light` previews on dark paper: light paint glows on dark, but a
+ * multiply light brush (a highlighter) is a tint on paper and previews on light paper.
+ */
+export declare function brushPreviewsOnDark(brush: {
+    light?: {
+        amount?: number;
+    };
+    tip?: {
+        blend?: string;
+    };
+}): boolean;
+export interface BrushPreviewColours {
+    /** The colour the preview is drawn on (#rrggbb): the renderer's paper, or dark paper for light paint. */
+    background: string;
+    /** The stroke colour (#rrggbb), at least `BRUSH_PREVIEW_MIN_CONTRAST` against `background`. */
+    color: string;
+    /** The background's scheme: which side of a light / dark colour was used. */
+    scheme: ColorScheme;
+}
+export interface BrushPreviewColoursOptions {
+    /**
+     * What the renderer draws on (#rrggbb, default white): the paper for the paint engine
+     * (`DEFAULT_PAPER.color`), or the surface behind a transparent preview (the canvas renderer's).
+     */
+    paper?: string;
+    /** The host (default the paint editor): only a host that renders light previews light brushes on dark paper. */
+    profile?: BrushHostProfile;
+    /** The preview can't change what is behind it (a swatch in a menu): `paper` is kept, even for multiply brushes. */
+    keepPaper?: boolean;
+}
+/**
+ * How much of its colour a brush lays in one pass, roughly: tip opacity, flow (soft brushes build
+ * up) and paper grain (dry media skip the paper's dips) all thin it.
+ */
+export declare function brushPreviewStrength(brush: Brush): number;
+/**
+ * The background and stroke colour for a preview of `brush` (see the module comment). A
+ * highlighter's own colour (a multiply brush that gives off light) is kept as it is: a tint reads
+ * by its colour, not its lightness.
+ */
+export declare function brushPreviewColours(brush: Brush, options?: BrushPreviewColoursOptions): BrushPreviewColours;

package/dist/brushes/preview.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Preview colours for brushes: what a preview is drawn on and the colour that reads on it.
+ * `brushPreviewColours` picks the background (the renderer's paper, or dark paper for brushes
+ * that give off light) and a stroke colour with at least 3:1 contrast against it: the brush's
+ * default colour, resolved for that background (a light / dark pair takes its side), else a
+ * colour for the medium. Multiply brushes preview on white rather than a dark surface. Previews
+ * only: it never sets anyone's paint colour.
+ */
+import { type ColorScheme, type DualColor } from '../color/dual.js';
+import { type BrushHostProfile } from './profiles.js';
+import type { Brush } from './types.js';
+/** The paper behind brushes that give off light, so their glow reads. */
+export declare const BRUSH_PREVIEW_DARK_PAPER = "#141414";
+/** The contrast a preview colour keeps against its background (WCAG large-text / graphics). */
+export declare const BRUSH_PREVIEW_MIN_CONTRAST = 3;
+/** Preview colours for brushes with no solid default, by medium (`tools` for tool brushes). */
+export declare const BRUSH_PREVIEW_FALLBACKS: Readonly<Record<string, DualColor>>;
+/**
+ * Whether a brush that gives off `light` previews on dark paper: light paint glows on dark, but a
+ * multiply light brush (a highlighter) is a tint on paper and previews on light paper.
+ */
+export declare function brushPreviewsOnDark(brush: {
+    light?: {
+        amount?: number;
+    };
+    tip?: {
+        blend?: string;
+    };
+}): boolean;
+export interface BrushPreviewColours {
+    /** The colour the preview is drawn on (#rrggbb): the renderer's paper, or dark paper for light paint. */
+    background: string;
+    /** The stroke colour (#rrggbb), at least `BRUSH_PREVIEW_MIN_CONTRAST` against `background`. */
+    color: string;
+    /** The background's scheme: which side of a light / dark colour was used. */
+    scheme: ColorScheme;
+}
+export interface BrushPreviewColoursOptions {
+    /**
+     * What the renderer draws on (#rrggbb, default white): the paper for the paint engine
+     * (`DEFAULT_PAPER.color`), or the surface behind a transparent preview (the canvas renderer's).
+     */
+    paper?: string;
+    /** The host (default the paint editor): only a host that renders light previews light brushes on dark paper. */
+    profile?: BrushHostProfile;
+    /** The preview can't change what is behind it (a swatch in a menu): `paper` is kept, even for multiply brushes. */
+    keepPaper?: boolean;
+}
+/**
+ * How much of its colour a brush lays in one pass, roughly: tip opacity, flow (soft brushes build
+ * up) and paper grain (dry media skip the paper's dips) all thin it.
+ */
+export declare function brushPreviewStrength(brush: Brush): number;
+/**
+ * The background and stroke colour for a preview of `brush` (see the module comment). A
+ * highlighter's own colour (a multiply brush that gives off light) is kept as it is: a tint reads
+ * by its colour, not its lightness.
+ */
+export declare function brushPreviewColours(brush: Brush, options?: BrushPreviewColoursOptions): BrushPreviewColours;

package/dist/brushes/tools.d.cts

@@ -16,11 +16,18 @@ export interface BrushPreviewImage {
     mimeType: string;
 }
 /** Draws a sample stroke with a brush (the host's renderer: the paint engine, a canvas…). */
-export type BrushPreviewRenderer = (brush: Brush, options: {
-    width: number;
-    height: number;
-    color: string;
-}) => BrushPreviewImage | Promise<BrushPreviewImage>;
+export interface BrushPreviewRenderer {
+    (brush: Brush, options: {
+        width: number;
+        height: number;
+        color: string;
+    }): BrushPreviewImage | Promise<BrushPreviewImage>;
+    /**
+     * What it draws on (#rrggbb), for `brushPreviewColours`: the paint engine's paper. Unset for a
+     * transparent preview, which shows whatever the UI puts behind it.
+     */
+    readonly paper?: string;
+}
 export interface BrushLibraryToolProviderOptions {
     /** What this host can render (default `PAINT_PROFILE`): lists are filtered by it and writes checked against it. */
     profile?: BrushHostProfile;

package/dist/brushes/tools.d.ts

@@ -16,11 +16,18 @@ export interface BrushPreviewImage {
     mimeType: string;
 }
 /** Draws a sample stroke with a brush (the host's renderer: the paint engine, a canvas…). */
-export type BrushPreviewRenderer = (brush: Brush, options: {
-    width: number;
-    height: number;
-    color: string;
-}) => BrushPreviewImage | Promise<BrushPreviewImage>;
+export interface BrushPreviewRenderer {
+    (brush: Brush, options: {
+        width: number;
+        height: number;
+        color: string;
+    }): BrushPreviewImage | Promise<BrushPreviewImage>;
+    /**
+     * What it draws on (#rrggbb), for `brushPreviewColours`: the paint engine's paper. Unset for a
+     * transparent preview, which shows whatever the UI puts behind it.
+     */
+    readonly paper?: string;
+}
 export interface BrushLibraryToolProviderOptions {
     /** What this host can render (default `PAINT_PROFILE`): lists are filtered by it and writes checked against it. */
     profile?: BrushHostProfile;

package/dist/{brushstrokeRender-3MOI7PH4.js → brushstrokeRender-4UB6NRJW.js}

@@ -1,6 +1,9 @@
+import {
+  brushPreviewColours
+} from "./chunk-ZS7LB2MV.js";
 import {
   pathDataToPolyline
-} from "./chunk-JEML4FSA.js";
+} from "./chunk-XDNWQMHY.js";
 import {
   BRUSH_PRESETS,
   BUILTIN_BRUSHES,
@@ -11,7 +14,7 @@ import {
   normalizeBrushSpec,
   resolveBrush,
   resolveCategory
-} from "./chunk-EE7SAYBF.js";
+} from "./chunk-J4SGJCPW.js";
 import "./chunk-ACFSFUQH.js";
 import {
   formatNumber,
@@ -20,7 +23,7 @@ import {
 } from "./chunk-PWBZH3FK.js";
 import {
   parseCssColor
-} from "./chunk-3CI7FRMK.js";
+} from "./chunk-DVPQFMH6.js";
 import "./chunk-SZTI6EER.js";
 import "./chunk-V2ZCJRDM.js";
 import {
@@ -160,6 +163,10 @@ function brushedShapeSvgNow(shape, size, scale, place = {}) {
   const content = svg.transform && body ? `<g transform="${svg.transform}">${body}</g>` : body;
   return `<svg xmlns="http://www.w3.org/2000/svg" width="${f(size.width)}" height="${f(size.height)}" viewBox="0 0 ${f(size.width)} ${f(size.height)}">${content}</svg>`;
 }
+function swatchColour(brush, background, spec) {
+  const facets = typeof brush !== "string" ? null : spec ? readCanvasBrushSpec(spec) : BRUSH_PRESETS.find((b) => b.id === brush);
+  return background && facets ? brushPreviewColours(facets, { paper: background, profile: CANVAS_PROFILE, keepPaper: true }).color : "#1f2937";
+}
 function brushSwatchNow(brush, options, spec) {
   const w = options.width && options.width > 8 ? options.width : 96;
   const h = options.height && options.height > 4 ? options.height : 24;
@@ -170,7 +177,7 @@ function brushSwatchNow(brush, options, spec) {
   const pts = Array.from({ length: 9 }, (_, i) => [pad + (w - 2 * pad) * i / 8, h / 2 + Math.sin(i / 8 * Math.PI * 2) * (h / 2 - pad) * 0.6]);
   const d = pts.map(([x, y], i) => `${i ? "L" : "M"}${x.toFixed(2)} ${y.toFixed(2)}`).join(" ");
   const image = renderShapeBrushstrokeNow(
-    { kind: "path", d, stroke: options.color ?? "#1f2937", strokeWidth: size, brush: { brush, ...spec ? { spec } : {}, seed: 7, size, pressure: [0.35, 1, 0.5] } },
+    { kind: "path", d, stroke: options.color ?? swatchColour(brush, options.background, spec), strokeWidth: size, brush: { brush, ...spec ? { spec } : {}, seed: 7, size, pressure: [0.35, 1, 0.5] } },
     options.scale && options.scale > 0 ? options.scale : 2
   );
   return image?.href ?? "";