@pixerate/editor 0.254.0 → 0.255.0

package/dist/brushes/index.d.cts

@@ -15,7 +15,7 @@ export { resolveBrush, resolveCategory, resolveEngine, resolveWetMedium, type Re
 export { migrateBrushV1 } from './migrate.cjs';
 export { BRUSH_PRESETS } from './presets.cjs';
 export { BRUSH_HOST_PROFILES, brushColourKind, CANVAS_PROFILE, checkBrush, degrade, IMAGE_PROFILE, listPresets, PAINT_PROFILE, VECTOR_PROFILE, type BrushCheck, type BrushColourKind, type BrushHostProfile, type BrushIssue, type BrushSupport, type DegradedBrush } from './profiles.cjs';
-export { BrushLibraryError, createBrushLibrary, parseBrushLibrary, type BrushFilter, type BrushLibrary, type BrushLibraryEntry, type BrushLibraryErrorCode, type BrushLibraryFile, type BrushLibraryOptions, type ImportBrushesResult, type SaveBrushResult, } from './library.cjs';
+export { BrushLibraryError, createBrushLibrary, parseBrushLibrary, snapshotBrushLibrary, type BrushFilter, type BrushLibrary, type BrushLibraryEntry, type BrushLibraryErrorCode, type BrushLibraryFile, type BrushLibrarySnapshot, type BrushLibraryOptions, type ImportBrushesResult, type SaveBrushResult, } from './library.cjs';
 export { BRUSH_PATCH_PROPERTIES, BRUSH_UNSET_PROPERTY, changedBrushPaths, mergeBrushPatch, UNSETTABLE_BRUSH_FACETS, type BrushPatch, type UnsettableBrushFacet } from './patch.cjs';
 export { brushEditorSections, brushLibraryGroups, setBrushEditorValue, type BrushEditorControl, type BrushEditorSection, type BrushEditorSectionId, type BrushLibraryGroup } from './ui.cjs';
 export { createBrushLibraryToolProvider, createBrushLibraryTools, type BrushLibraryToolProviderOptions, type BrushPreviewImage, type BrushPreviewRenderer } from './tools.cjs';

package/dist/brushes/index.d.ts

@@ -15,7 +15,7 @@ export { resolveBrush, resolveCategory, resolveEngine, resolveWetMedium, type Re
 export { migrateBrushV1 } from './migrate.js';
 export { BRUSH_PRESETS } from './presets.js';
 export { BRUSH_HOST_PROFILES, brushColourKind, CANVAS_PROFILE, checkBrush, degrade, IMAGE_PROFILE, listPresets, PAINT_PROFILE, VECTOR_PROFILE, type BrushCheck, type BrushColourKind, type BrushHostProfile, type BrushIssue, type BrushSupport, type DegradedBrush } from './profiles.js';
-export { BrushLibraryError, createBrushLibrary, parseBrushLibrary, type BrushFilter, type BrushLibrary, type BrushLibraryEntry, type BrushLibraryErrorCode, type BrushLibraryFile, type BrushLibraryOptions, type ImportBrushesResult, type SaveBrushResult, } from './library.js';
+export { BrushLibraryError, createBrushLibrary, parseBrushLibrary, snapshotBrushLibrary, type BrushFilter, type BrushLibrary, type BrushLibraryEntry, type BrushLibraryErrorCode, type BrushLibraryFile, type BrushLibrarySnapshot, type BrushLibraryOptions, type ImportBrushesResult, type SaveBrushResult, } from './library.js';
 export { BRUSH_PATCH_PROPERTIES, BRUSH_UNSET_PROPERTY, changedBrushPaths, mergeBrushPatch, UNSETTABLE_BRUSH_FACETS, type BrushPatch, type UnsettableBrushFacet } from './patch.js';
 export { brushEditorSections, brushLibraryGroups, setBrushEditorValue, type BrushEditorControl, type BrushEditorSection, type BrushEditorSectionId, type BrushLibraryGroup } from './ui.js';
 export { createBrushLibraryToolProvider, createBrushLibraryTools, type BrushLibraryToolProviderOptions, type BrushPreviewImage, type BrushPreviewRenderer } from './tools.js';

package/dist/brushes/index.js

@@ -1,3 +1,14 @@
+import {
+  BRUSH_PATCH_PROPERTIES,
+  BRUSH_SLIDERS,
+  BRUSH_UNSET_PROPERTY,
+  UNSETTABLE_BRUSH_FACETS,
+  brushEngineControls,
+  changedBrushPaths,
+  createBrushLibraryToolProvider,
+  createBrushLibraryTools,
+  mergeBrushPatch
+} from "../chunk-YHUMGBZD.js";
 import {
   BRUSH_FACET_SCHEMAS,
   BRUSH_FIELDS,
@@ -6,54 +17,44 @@ import {
   BRUSH_KINDS,
   BRUSH_MARKS_KINDS,
   BRUSH_MEDIA,
-  BRUSH_PATCH_PROPERTIES,
   BRUSH_PRESETS,
-  BRUSH_SLIDERS,
+  BRUSH_ROTATIONS,
   BRUSH_SURFACES,
   BRUSH_TIP_SHAPES,
   BRUSH_TOOLS,
-  BRUSH_UNSET_PROPERTY,
   BRUSH_WORD,
   BrushLibraryError,
   CANVAS_PROFILE,
+  DOT_ROTATIONS,
+  DOT_TEXTURE_ORDERS,
   IMAGE_PROFILE,
+  IMPASTO_TOOLS,
   MAX_BRUSH_PALETTE,
+  MAX_DOT_TEXTURES,
+  MAX_STICKER_STAMPS,
   PAINT_PROFILE,
-  UNSETTABLE_BRUSH_FACETS,
+  PARTICLE_KINDS,
+  PARTICLE_RENDERS,
+  RIBBON_PAIRS,
   VECTOR_PROFILE,
   WET_BRUSH_TOOLS,
+  WET_MEDIA,
   brushColourKind,
-  brushEngineControls,
-  changedBrushPaths,
   checkBrush,
   createBrushLibrary,
-  createBrushLibraryToolProvider,
-  createBrushLibraryTools,
   degrade,
   getPath,
   listPresets,
-  mergeBrushPatch,
   migrateBrushV1,
   normalizeBrushSpec,
-  parseBrushLibrary,
+  parseBrushLibrary2 as parseBrushLibrary,
   resolveBrush,
   resolveCategory,
   resolveEngine,
   resolveWetMedium,
-  setPath
-} from "../chunk-QPHNVZHO.js";
-import {
-  BRUSH_ROTATIONS,
-  DOT_ROTATIONS,
-  DOT_TEXTURE_ORDERS,
-  IMPASTO_TOOLS,
-  MAX_DOT_TEXTURES,
-  MAX_STICKER_STAMPS,
-  PARTICLE_KINDS,
-  PARTICLE_RENDERS,
-  RIBBON_PAIRS,
-  WET_MEDIA
-} from "../chunk-MTKY6K3Q.js";
+  setPath,
+  snapshotBrushLibrary
+} from "../chunk-JVRLGV3C.js";
 import {
   STAMP_KINDS
 } from "../chunk-APX63ILU.js";
@@ -298,5 +299,6 @@ export {
   resolveCategory,
   resolveEngine,
   resolveWetMedium,
-  setBrushEditorValue
+  setBrushEditorValue,
+  snapshotBrushLibrary
 };

package/dist/brushes/library.d.cts

@@ -102,3 +102,20 @@ export declare function parseBrushLibrary(raw: unknown, problems?: string[]): Br
 export declare function createBrushLibrary(options?: BrushLibraryOptions): BrushLibrary;
 /** "Closest: a, b. " for an unknown id (shared prefix or substring), or "" when nothing is near. */
 export declare function closest(id: string, ids: readonly string[], max?: number): string;
+/** A synchronous copy of a library's brushes, for hosts whose reads are synchronous (renderers, controllers). */
+export interface BrushLibrarySnapshot {
+    /** The brushes as last read: built-in presets, then saved brushes (empty until the first read). */
+    readonly entries: readonly BrushLibraryEntry[];
+    /** The saved brushes as last read. */
+    readonly user: readonly Brush[];
+    /** Resolves once the library has been read (again, after `refresh`). */
+    readonly ready: Promise<void>;
+    refresh(): Promise<void>;
+    /** Stops following the library. */
+    dispose(): void;
+}
+/**
+ * Follows `library`: reads it now and after every change, keeping the result for synchronous
+ * reads, and calls `onChange` after each read.
+ */
+export declare function snapshotBrushLibrary(library: Pick<BrushLibrary, 'list' | 'subscribe'>, onChange?: () => void): BrushLibrarySnapshot;

package/dist/brushes/library.d.ts

@@ -102,3 +102,20 @@ export declare function parseBrushLibrary(raw: unknown, problems?: string[]): Br
 export declare function createBrushLibrary(options?: BrushLibraryOptions): BrushLibrary;
 /** "Closest: a, b. " for an unknown id (shared prefix or substring), or "" when nothing is near. */
 export declare function closest(id: string, ids: readonly string[], max?: number): string;
+/** A synchronous copy of a library's brushes, for hosts whose reads are synchronous (renderers, controllers). */
+export interface BrushLibrarySnapshot {
+    /** The brushes as last read: built-in presets, then saved brushes (empty until the first read). */
+    readonly entries: readonly BrushLibraryEntry[];
+    /** The saved brushes as last read. */
+    readonly user: readonly Brush[];
+    /** Resolves once the library has been read (again, after `refresh`). */
+    readonly ready: Promise<void>;
+    refresh(): Promise<void>;
+    /** Stops following the library. */
+    dispose(): void;
+}
+/**
+ * Follows `library`: reads it now and after every change, keeping the result for synchronous
+ * reads, and calls `onChange` after each read.
+ */
+export declare function snapshotBrushLibrary(library: Pick<BrushLibrary, 'list' | 'subscribe'>, onChange?: () => void): BrushLibrarySnapshot;

package/dist/{brushstrokeRender-5PYSKZIJ.js → brushstrokeRender-HCOQUSWW.js}

@@ -1,12 +1,20 @@
 import {
   pathDataToPolyline
-} from "./chunk-5JNA6LLY.js";
+} from "./chunk-WYGSR3IJ.js";
 import {
   parseCssColor
 } from "./chunk-3CI7FRMK.js";
 import {
-  BUILTIN_BRUSHES
-} from "./chunk-MTKY6K3Q.js";
+  BRUSH_PRESETS,
+  BUILTIN_BRUSHES,
+  CANVAS_PROFILE,
+  checkBrush,
+  closest,
+  listPresets,
+  normalizeBrushSpec,
+  resolveBrush,
+  resolveCategory
+} from "./chunk-JVRLGV3C.js";
 import "./chunk-APX63ILU.js";
 import {
   formatNumber,
@@ -14,6 +22,7 @@ import {
   resolveCanvasGradient
 } from "./chunk-PWBZH3FK.js";
 import "./chunk-SZTI6EER.js";
+import "./chunk-V2ZCJRDM.js";
 import {
   BrushstrokeCache,
   brushstrokeDataUrl,
@@ -30,23 +39,48 @@ import "./chunk-HVVR5PZW.js";
 import "./chunk-QGHEDC7B.js";
 
 // src/canvas/brushstrokeRender.ts
-var DRY = BUILTIN_BRUSHES.filter((b) => isBrushstrokeBrush(b) && b.light.amount === 0);
-function listCanvasBrushes() {
-  return DRY.map((b) => ({ id: b.id, name: b.name, category: b.category, size: b.tip.size }));
+var PRESETS = listPresets(CANVAS_PROFILE).map((spec) => BUILTIN_BRUSHES.find((b) => b.id === spec.id));
+var presetIds = () => PRESETS.map((b) => b.id).join(", ");
+var refusal = (brush) => checkBrush(brush, CANVAS_PROFILE).issues.filter((i) => i.severity === "error").map((i) => `${i.reason} ${i.fix}`).join(" ");
+function readCanvasBrushSpec(spec) {
+  let brush;
+  try {
+    brush = normalizeBrushSpec(spec);
+  } catch (e) {
+    throw new Error(`Not a brush: ${e.message}`);
+  }
+  if (!checkBrush(brush, CANVAS_PROFILE).ok) throw new Error(`Brush '${brush.id}' (${brush.name}) can't brush a canvas stroke: ${refusal(brush)}`);
+  return brush;
+}
+function listCanvasBrushes(user = []) {
+  const out = PRESETS.map((b) => ({ id: b.id, name: b.name, category: b.category, size: b.tip.size, builtin: true }));
+  for (const raw of user) {
+    try {
+      const brush = readCanvasBrushSpec(raw);
+      if (out.some((b) => b.id === brush.id)) continue;
+      out.push({ id: brush.id, name: brush.name, category: resolveCategory(brush), size: resolveBrush(brush).tip.size, builtin: false, spec: brush });
+    } catch {
+    }
+  }
+  return out;
 }
-function resolveCanvasBrush(brush, width) {
+function resolveCanvasBrush(brush, width, spec) {
   const given = width !== void 0 && Number.isFinite(width) ? Math.max(1, width) : void 0;
+  const sized = (b) => given === void 0 ? b : { ...b, tip: { ...b.tip, size: given } };
   if (typeof brush === "string") {
-    const preset = BUILTIN_BRUSHES.find((b) => b.id === brush);
-    const ids = DRY.map((b) => b.id).join(", ");
-    if (!preset) throw new Error(`Unknown brush '${brush}'. Use one of the dry paint presets (${ids}) or tip settings ({ hardness, spacing, flow, \u2026 }).`);
-    if (!isBrushstrokeBrush(preset)) {
-      throw new Error(`Brush '${brush}' (${preset.name}) is not a dry brush: brushed canvas strokes use dry media only (wet paint needs an area to flow in; mixer, blender, smudge and eraser brushes need paint under them). Use one of: ${ids}.`);
+    if (spec !== void 0 && spec !== null) {
+      const saved = resolveBrush(readCanvasBrushSpec(spec));
+      if (!isBrushstrokeBrush(saved)) throw new Error(`Brush '${saved.id}' (${saved.name}) can't brush a canvas stroke: it is not a dry dab brush.`);
+      return sized(saved);
     }
-    return given === void 0 ? preset : { ...preset, tip: { ...preset.tip, size: given } };
+    const preset = PRESETS.find((b) => b.id === brush);
+    if (preset) return sized(preset);
+    const other = BRUSH_PRESETS.find((b) => b.id === brush);
+    if (other) throw new Error(`Brush '${brush}' (${other.name}) can't brush a canvas stroke: ${refusal(other)} Use one of: ${presetIds()}, or a saved brush the canvas can paint.`);
+    throw new Error(`Unknown brush '${brush}'. ${closest(brush, PRESETS.map((b) => b.id))}Use one of the dry presets (${presetIds()}), a saved brush from the brush library, or tip settings ({ hardness, spacing, flow, \u2026 }).`);
   }
   if (!brush || typeof brush !== "object" || Array.isArray(brush)) {
-    throw new Error("A brush is a dry paint preset id (see listCanvasBrushes / canvas.listBrushes) or an object of tip settings.");
+    throw new Error("A brush is a preset or saved brush id (see listCanvasBrushes / canvas.listBrushes) or an object of tip settings.");
   }
   return { size: given ?? 3, ...brush };
 }
@@ -78,7 +112,7 @@ function renderShapeBrushstrokeNow(shape, scale, place = {}) {
   const seed = shape.brush.seed;
   const textured = typeof seed === "number" && Number.isFinite(seed);
   const size = shape.brush.size ?? (textured ? void 0 : shape.strokeWidth ?? 3);
-  const brush = resolveCanvasBrush(shape.brush.brush, size);
+  const brush = resolveCanvasBrush(shape.brush.brush, size, shape.brush.spec);
   const points = pathDataToPolyline(shape.d);
   if (!points.length) return null;
   const { pressure, tiltX, tiltY } = shape.brush;
@@ -116,17 +150,17 @@ 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 brushSwatchNow(brush, options) {
+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;
-  const own = typeof brush === "string" ? resolveCanvasBrush(brush, void 0) : resolveCanvasBrush(brush, brush.size);
+  const own = typeof brush === "string" ? resolveCanvasBrush(brush, void 0, spec) : resolveCanvasBrush(brush, brush.size);
   const tip = "tip" in own && own.tip ? own.tip.size ?? 3 : own.size ?? 3;
   const size = Math.max(1.5, Math.min(tip, h * 0.55));
   const pad = size / 2 + 2;
   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, seed: 7, size, pressure: [0.35, 1, 0.5] } },
+    { kind: "path", d, stroke: options.color ?? "#1f2937", 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 ?? "";
@@ -135,6 +169,7 @@ export {
   brushSwatchNow,
   brushedShapeSvgNow,
   listCanvasBrushes,
+  readCanvasBrushSpec,
   renderShapeBrushstrokeNow,
   resolveCanvasBrush,
   resolveCanvasPaint

package/dist/{brushstrokeRender-7FLLSQEC.cjs → brushstrokeRender-ZZOXI5O5.cjs}

@@ -1,12 +1,20 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _chunkLFMKWGFLcjs = require('./chunk-LFMKWGFL.cjs');
+var _chunkLRNUZKWVcjs = require('./chunk-LRNUZKWV.cjs');
 
 
 var _chunkA2IS7EHEcjs = require('./chunk-A2IS7EHE.cjs');
 
 
-var _chunkHS6QDWDFcjs = require('./chunk-HS6QDWDF.cjs');
+
+
+
+
+
+
+
+
+var _chunkHIMGBZAMcjs = require('./chunk-HIMGBZAM.cjs');
 require('./chunk-JSDND7DF.cjs');
 
 
@@ -14,6 +22,7 @@ require('./chunk-JSDND7DF.cjs');
 
 var _chunkNM3G4VQTcjs = require('./chunk-NM3G4VQT.cjs');
 require('./chunk-U67EN7GG.cjs');
+require('./chunk-WOFXZ3XU.cjs');
 
 
 
@@ -30,23 +39,48 @@ require('./chunk-474IQG74.cjs');
 require('./chunk-XFM3OCHU.cjs');
 
 // src/canvas/brushstrokeRender.ts
-var DRY = _chunkHS6QDWDFcjs.BUILTIN_BRUSHES.filter((b) => _chunkPXDIAYB6cjs.isBrushstrokeBrush.call(void 0, b) && b.light.amount === 0);
-function listCanvasBrushes() {
-  return DRY.map((b) => ({ id: b.id, name: b.name, category: b.category, size: b.tip.size }));
+var PRESETS = _chunkHIMGBZAMcjs.listPresets.call(void 0, _chunkHIMGBZAMcjs.CANVAS_PROFILE).map((spec) => _chunkHIMGBZAMcjs.BUILTIN_BRUSHES.find((b) => b.id === spec.id));
+var presetIds = () => PRESETS.map((b) => b.id).join(", ");
+var refusal = (brush) => _chunkHIMGBZAMcjs.checkBrush.call(void 0, brush, _chunkHIMGBZAMcjs.CANVAS_PROFILE).issues.filter((i) => i.severity === "error").map((i) => `${i.reason} ${i.fix}`).join(" ");
+function readCanvasBrushSpec(spec) {
+  let brush;
+  try {
+    brush = _chunkHIMGBZAMcjs.normalizeBrushSpec.call(void 0, spec);
+  } catch (e) {
+    throw new Error(`Not a brush: ${e.message}`);
+  }
+  if (!_chunkHIMGBZAMcjs.checkBrush.call(void 0, brush, _chunkHIMGBZAMcjs.CANVAS_PROFILE).ok) throw new Error(`Brush '${brush.id}' (${brush.name}) can't brush a canvas stroke: ${refusal(brush)}`);
+  return brush;
+}
+function listCanvasBrushes(user = []) {
+  const out = PRESETS.map((b) => ({ id: b.id, name: b.name, category: b.category, size: b.tip.size, builtin: true }));
+  for (const raw of user) {
+    try {
+      const brush = readCanvasBrushSpec(raw);
+      if (out.some((b) => b.id === brush.id)) continue;
+      out.push({ id: brush.id, name: brush.name, category: _chunkHIMGBZAMcjs.resolveCategory.call(void 0, brush), size: _chunkHIMGBZAMcjs.resolveBrush.call(void 0, brush).tip.size, builtin: false, spec: brush });
+    } catch (e2) {
+    }
+  }
+  return out;
 }
-function resolveCanvasBrush(brush, width) {
+function resolveCanvasBrush(brush, width, spec) {
   const given = width !== void 0 && Number.isFinite(width) ? Math.max(1, width) : void 0;
+  const sized = (b) => given === void 0 ? b : { ...b, tip: { ...b.tip, size: given } };
   if (typeof brush === "string") {
-    const preset = _chunkHS6QDWDFcjs.BUILTIN_BRUSHES.find((b) => b.id === brush);
-    const ids = DRY.map((b) => b.id).join(", ");
-    if (!preset) throw new Error(`Unknown brush '${brush}'. Use one of the dry paint presets (${ids}) or tip settings ({ hardness, spacing, flow, \u2026 }).`);
-    if (!_chunkPXDIAYB6cjs.isBrushstrokeBrush.call(void 0, preset)) {
-      throw new Error(`Brush '${brush}' (${preset.name}) is not a dry brush: brushed canvas strokes use dry media only (wet paint needs an area to flow in; mixer, blender, smudge and eraser brushes need paint under them). Use one of: ${ids}.`);
+    if (spec !== void 0 && spec !== null) {
+      const saved = _chunkHIMGBZAMcjs.resolveBrush.call(void 0, readCanvasBrushSpec(spec));
+      if (!_chunkPXDIAYB6cjs.isBrushstrokeBrush.call(void 0, saved)) throw new Error(`Brush '${saved.id}' (${saved.name}) can't brush a canvas stroke: it is not a dry dab brush.`);
+      return sized(saved);
     }
-    return given === void 0 ? preset : { ...preset, tip: { ...preset.tip, size: given } };
+    const preset = PRESETS.find((b) => b.id === brush);
+    if (preset) return sized(preset);
+    const other = _chunkHIMGBZAMcjs.BRUSH_PRESETS.find((b) => b.id === brush);
+    if (other) throw new Error(`Brush '${brush}' (${other.name}) can't brush a canvas stroke: ${refusal(other)} Use one of: ${presetIds()}, or a saved brush the canvas can paint.`);
+    throw new Error(`Unknown brush '${brush}'. ${_chunkHIMGBZAMcjs.closest.call(void 0, brush, PRESETS.map((b) => b.id))}Use one of the dry presets (${presetIds()}), a saved brush from the brush library, or tip settings ({ hardness, spacing, flow, \u2026 }).`);
   }
   if (!brush || typeof brush !== "object" || Array.isArray(brush)) {
-    throw new Error("A brush is a dry paint preset id (see listCanvasBrushes / canvas.listBrushes) or an object of tip settings.");
+    throw new Error("A brush is a preset or saved brush id (see listCanvasBrushes / canvas.listBrushes) or an object of tip settings.");
   }
   return { size: _nullishCoalesce(given, () => ( 3)), ...brush };
 }
@@ -61,7 +95,7 @@ function shapePaint(shape) {
   if (shape.brush.paint === void 0 || shape.brush.paint === null) return null;
   try {
     return resolveCanvasPaint(shape.brush.paint);
-  } catch (e) {
+  } catch (e3) {
     return null;
   }
 }
@@ -78,8 +112,8 @@ function renderShapeBrushstrokeNow(shape, scale, place = {}) {
   const seed = shape.brush.seed;
   const textured = typeof seed === "number" && Number.isFinite(seed);
   const size = _nullishCoalesce(shape.brush.size, () => ( (textured ? void 0 : _nullishCoalesce(shape.strokeWidth, () => ( 3)))));
-  const brush = resolveCanvasBrush(shape.brush.brush, size);
-  const points = _chunkLFMKWGFLcjs.pathDataToPolyline.call(void 0, shape.d);
+  const brush = resolveCanvasBrush(shape.brush.brush, size, shape.brush.spec);
+  const points = _chunkLRNUZKWVcjs.pathDataToPolyline.call(void 0, shape.d);
   if (!points.length) return null;
   const { pressure, tiltX, tiltY } = shape.brush;
   const input = {
@@ -116,17 +150,17 @@ 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 brushSwatchNow(brush, options) {
+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;
-  const own = typeof brush === "string" ? resolveCanvasBrush(brush, void 0) : resolveCanvasBrush(brush, brush.size);
+  const own = typeof brush === "string" ? resolveCanvasBrush(brush, void 0, spec) : resolveCanvasBrush(brush, brush.size);
   const tip = "tip" in own && own.tip ? _nullishCoalesce(own.tip.size, () => ( 3)) : _nullishCoalesce(own.size, () => ( 3));
   const size = Math.max(1.5, Math.min(tip, h * 0.55));
   const pad = size / 2 + 2;
   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: _nullishCoalesce(options.color, () => ( "#1f2937")), strokeWidth: size, brush: { brush, seed: 7, size, pressure: [0.35, 1, 0.5] } },
+    { kind: "path", d, stroke: _nullishCoalesce(options.color, () => ( "#1f2937")), strokeWidth: size, brush: { brush, ...spec ? { spec } : {}, seed: 7, size, pressure: [0.35, 1, 0.5] } },
     options.scale && options.scale > 0 ? options.scale : 2
   );
   return _nullishCoalesce(_optionalChain([image, 'optionalAccess', _12 => _12.href]), () => ( ""));
@@ -138,4 +172,5 @@ function brushSwatchNow(brush, options) {
 
 
 
-exports.brushSwatchNow = brushSwatchNow; exports.brushedShapeSvgNow = brushedShapeSvgNow; exports.listCanvasBrushes = listCanvasBrushes; exports.renderShapeBrushstrokeNow = renderShapeBrushstrokeNow; exports.resolveCanvasBrush = resolveCanvasBrush; exports.resolveCanvasPaint = resolveCanvasPaint;
+
+exports.brushSwatchNow = brushSwatchNow; exports.brushedShapeSvgNow = brushedShapeSvgNow; exports.listCanvasBrushes = listCanvasBrushes; exports.readCanvasBrushSpec = readCanvasBrushSpec; exports.renderShapeBrushstrokeNow = renderShapeBrushstrokeNow; exports.resolveCanvasBrush = resolveCanvasBrush; exports.resolveCanvasPaint = resolveCanvasPaint;

package/dist/canvas/brushTypes.d.cts

@@ -24,11 +24,24 @@ export interface CanvasBrushSettings {
     pressureOpacity?: boolean;
 }
 /**
- * A brush for a freehand stroke: the id of a dry paint preset (`ink-pen`, `pencil-hb`, `marker`, …;
- * `listCanvasBrushes` lists them) or tip settings. The stroke width sets the brush size unless
- * tip settings give one.
+ * A brush for a freehand stroke: the id of a dry paint preset (`ink-pen`, `pencil-hb`, `marker`, …)
+ * or of a saved brush in the host's brush library (`listCanvasBrushes` lists both), or tip
+ * settings. The stroke width sets the brush size unless tip settings give one.
  */
 export type CanvasBrush = string | CanvasBrushSettings;
+/**
+ * A saved brush from a brush library, as the facet brush of `@pixerate/editor/brushes` (plain
+ * JSON, described loosely so these types stay import-free). A stroke drawn with a saved brush
+ * keeps a copy, so the document renders the same without the library.
+ */
+export type CanvasBrushSpec = {
+    id: string;
+    name: string;
+    kind: string;
+    tip: {
+        shape: string;
+    } & Record<string, unknown>;
+} & Record<string, unknown>;
 /** A gradient stop of brushed stroke paint (the paint engine's `PaintGradientStop`). */
 export interface CanvasBrushPaintStop {
     /** 0..1 along the gradient. */
@@ -88,6 +101,8 @@ export type CanvasBrushPaint = {
  */
 export interface CanvasBrushstroke {
     brush: CanvasBrush;
+    /** The saved brush `brush` names, embedded (strokes drawn with a library brush that is not a preset). */
+    spec?: CanvasBrushSpec;
     /** Gradient paint (or one colour) instead of the stroke colour. */
     paint?: CanvasBrushPaint;
     /** Pressure 0..1 along the length (default full pressure). */
@@ -126,6 +141,10 @@ export interface CanvasBrushPreset {
     id: string;
     name: string;
     category: string;
+    /** A built-in preset (false: a saved brush from the brush library). */
+    builtin?: boolean;
+    /** A saved brush's facets: set `brushSpec` to it with `brush` when picking it. */
+    spec?: CanvasBrushSpec;
     /** The preset's own tip diameter in canvas units: a new brushed stroke's default size. */
     size: number;
 }

package/dist/canvas/brushTypes.d.ts

@@ -24,11 +24,24 @@ export interface CanvasBrushSettings {
     pressureOpacity?: boolean;
 }
 /**
- * A brush for a freehand stroke: the id of a dry paint preset (`ink-pen`, `pencil-hb`, `marker`, …;
- * `listCanvasBrushes` lists them) or tip settings. The stroke width sets the brush size unless
- * tip settings give one.
+ * A brush for a freehand stroke: the id of a dry paint preset (`ink-pen`, `pencil-hb`, `marker`, …)
+ * or of a saved brush in the host's brush library (`listCanvasBrushes` lists both), or tip
+ * settings. The stroke width sets the brush size unless tip settings give one.
  */
 export type CanvasBrush = string | CanvasBrushSettings;
+/**
+ * A saved brush from a brush library, as the facet brush of `@pixerate/editor/brushes` (plain
+ * JSON, described loosely so these types stay import-free). A stroke drawn with a saved brush
+ * keeps a copy, so the document renders the same without the library.
+ */
+export type CanvasBrushSpec = {
+    id: string;
+    name: string;
+    kind: string;
+    tip: {
+        shape: string;
+    } & Record<string, unknown>;
+} & Record<string, unknown>;
 /** A gradient stop of brushed stroke paint (the paint engine's `PaintGradientStop`). */
 export interface CanvasBrushPaintStop {
     /** 0..1 along the gradient. */
@@ -88,6 +101,8 @@ export type CanvasBrushPaint = {
  */
 export interface CanvasBrushstroke {
     brush: CanvasBrush;
+    /** The saved brush `brush` names, embedded (strokes drawn with a library brush that is not a preset). */
+    spec?: CanvasBrushSpec;
     /** Gradient paint (or one colour) instead of the stroke colour. */
     paint?: CanvasBrushPaint;
     /** Pressure 0..1 along the length (default full pressure). */
@@ -126,6 +141,10 @@ export interface CanvasBrushPreset {
     id: string;
     name: string;
     category: string;
+    /** A built-in preset (false: a saved brush from the brush library). */
+    builtin?: boolean;
+    /** A saved brush's facets: set `brushSpec` to it with `brush` when picking it. */
+    spec?: CanvasBrushSpec;
     /** The preset's own tip diameter in canvas units: a new brushed stroke's default size. */
     size: number;
 }

package/dist/canvas/brushstroke.d.cts

@@ -8,8 +8,10 @@
 import { brushstrokeScaleBucket } from '../paint/brushstroke-scale.cjs';
 import { type PathShape, type ShapeDescription, type ShapeSize } from './shapeGeometry.cjs';
 import type { Point } from './types.cjs';
-import type { CanvasBrush, CanvasBrushPaint, CanvasBrushPreset, CanvasBrushstroke } from './brushTypes.cjs';
-export type { CanvasBrush, CanvasBrushPaint, CanvasBrushPaintMapping, CanvasBrushPaintStop, CanvasBrushPaper, CanvasBrushPreset, CanvasBrushSettings, CanvasBrushstroke } from './brushTypes.cjs';
+import type { CanvasBrush, CanvasBrushPaint, CanvasBrushPreset, CanvasBrushSpec, CanvasBrushstroke } from './brushTypes.cjs';
+import type { BrushLibrary } from '../brushes/library.cjs';
+import type { BrushPreviewRenderer } from '../brushes/tools.cjs';
+export type { CanvasBrush, CanvasBrushPaint, CanvasBrushPaintMapping, CanvasBrushPaintStop, CanvasBrushPaper, CanvasBrushPreset, CanvasBrushSettings, CanvasBrushSpec, CanvasBrushstroke } from './brushTypes.cjs';
 export { brushstrokeScaleBucket };
 /** A brushed stroke's image, placed in the path's coordinates (the shape's view box). */
 export interface CanvasBrushstrokeImage {
@@ -40,9 +42,12 @@ export declare function pathDataToPolyline(d: string, step?: number): Point[];
 export declare function profileAlongPolyline(points: readonly Point[], values: readonly number[], count?: number): number[];
 /** The renderer chunk (`./brushstrokeRender.ts`). */
 export interface CanvasBrushstrokeRenderer {
-    listCanvasBrushes(): CanvasBrushPreset[];
-    /** Throws for an unknown or non-dry brush; the result is the paint engine's brush. */
-    resolveCanvasBrush(brush: CanvasBrush, width: number): unknown;
+    /** The presets, then the saved brushes given (facet brushes) the canvas profile admits. */
+    listCanvasBrushes(user?: readonly unknown[]): CanvasBrushPreset[];
+    /** Throws for an unknown brush or one the canvas profile refuses; the result is the paint engine's brush. */
+    resolveCanvasBrush(brush: CanvasBrush, width: number | undefined, spec?: unknown): unknown;
+    /** A saved brush checked against the canvas profile (throws with the reason and fix). */
+    readCanvasBrushSpec(spec: unknown): unknown;
     /** Throws for paint that is not a colour or gradient paint a canvas stroke can use; the result is the paint engine's `PaintSource`. */
     resolveCanvasPaint(paint: unknown): unknown;
     renderShapeBrushstrokeNow(shape: BrushedPathShape, scale: number, place?: {
@@ -52,7 +57,7 @@ export interface CanvasBrushstrokeRenderer {
         };
         unit?: number;
     }): CanvasBrushstrokeImage | null;
-    brushSwatchNow(brush: CanvasBrush, options: CanvasBrushSwatchOptions): string;
+    brushSwatchNow(brush: CanvasBrush, options: CanvasBrushSwatchOptions, spec?: CanvasBrushSpec): string;
     brushedShapeSvgNow(shape: BrushedPathShape, size: ShapeSize, scale: number, place?: {
         origin?: {
             x: number;
@@ -66,13 +71,24 @@ export interface CanvasBrushstrokeRenderer {
  * colour parser). Called for you by the functions below; call it early to warm up.
  */
 export declare function loadCanvasBrushstrokeRenderer(): Promise<CanvasBrushstrokeRenderer>;
-/** The dry paint presets a freehand stroke can use (wet, mixer, blender, smudge and eraser presets are left out). */
-export declare function listCanvasBrushes(): Promise<CanvasBrushPreset[]>;
 /**
- * Checks a brush: an unknown preset id, a wet (or other non-dry) preset, or settings that are not
- * an object throw an error saying which presets can be used.
+ * The brushes a freehand stroke can use: the presets `CANVAS_PROFILE` admits (dry dab brushes; wet,
+ * mixer, blender, smudge, eraser and light presets are left out), then the saved brushes of
+ * `library` it admits.
  */
-export declare function validateCanvasBrush(brush: CanvasBrush): Promise<void>;
+export declare function listCanvasBrushes(library?: Pick<BrushLibrary, 'list'>): Promise<CanvasBrushPreset[]>;
+/**
+ * The saved brush a stroke should embed for `brush`: the library's brush when `brush` names a saved
+ * one (checked against the canvas profile), else undefined (a preset or tip settings). Throws
+ * saying why a saved brush can't brush a stroke.
+ */
+export declare function resolveCanvasBrushSpec(brush: CanvasBrush, library?: Pick<BrushLibrary, 'get' | 'isBuiltin'>): Promise<CanvasBrushSpec | undefined>;
+/**
+ * Checks a brush: an unknown id, a brush the canvas profile refuses (wet, a tool, light…), or
+ * settings that are not an object throw an error saying why and which brushes can be used.
+ * `spec` is the saved brush `brush` names (`resolveCanvasBrushSpec`).
+ */
+export declare function validateCanvasBrush(brush: CanvasBrush, spec?: CanvasBrushSpec): Promise<void>;
 /**
  * Checks a brushed stroke's `paint` (a colour or gradient paint): bad stops, an unknown mapping,
  * or a mapping that needs timed samples (`velocity`, `time`) throw an error saying what to use.
@@ -119,4 +135,10 @@ export interface CanvasBrushSwatchOptions {
  * and grain), its size capped to fit, as a PNG data URL ('' when nothing renders). Throws for an
  * unknown or non-dry brush.
  */
-export declare function renderCanvasBrushSwatch(brush: CanvasBrush, options?: CanvasBrushSwatchOptions): Promise<string>;
+export declare function renderCanvasBrushSwatch(brush: CanvasBrush, options?: CanvasBrushSwatchOptions, spec?: CanvasBrushSpec): Promise<string>;
+/**
+ * `preview_brush` for brushed strokes (canvas and vector): the brush library tools' renderer
+ * (`createBrushLibraryToolProvider(library, { profile: CANVAS_PROFILE, renderPreview: renderCanvasBrushPreview })`),
+ * a swatch of the brush as a canvas stroke paints it. Loads the renderer on first use.
+ */
+export declare const renderCanvasBrushPreview: BrushPreviewRenderer;