@pixerate/editor 0.263.0 → 0.264.0

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

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

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

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

package/dist/paint-editor/index.js

@@ -11,7 +11,7 @@ import {
   mergeBrushPatch,
   multiColorSliders,
   patchBrushValue
-} from "../chunk-CNLO6E2K.js";
+} from "../chunk-4OJC4MCD.js";
 import {
   createStickerTools,
   describeStickerRef
@@ -30,7 +30,7 @@ import {
   resolveExternalAssets,
   serializeLayers,
   serializeLayersExternal
-} from "../chunk-QW7LKWKE.js";
+} from "../chunk-HAUDEVMC.js";
 import "../chunk-WJ4WQJCC.js";
 import {
   LAYER_EFFECT_KINDS,
@@ -88,7 +88,7 @@ import {
   realPresenceClock,
   tweenPresenceCursor
 } from "../chunk-IVSWRVB4.js";
-import "../chunk-34HIZXFX.js";
+import "../chunk-WWI6FLH2.js";
 import {
   BRUSH_ID,
   BRUSH_PRESETS,
@@ -143,7 +143,7 @@ import {
   parseBrushLibrary,
   resolveBrush,
   usesPaintExchange
-} from "../chunk-P5343XZO.js";
+} from "../chunk-EE7SAYBF.js";
 import {
   STAMP_KINDS,
   StickersSlot,
@@ -12150,15 +12150,18 @@ function strokeSummary(s, withPoints, live) {
 }
 
 // src/paint-editor/brush-library-tools.ts
+function paintBrushPreviewRenderer(paper = () => DEFAULT_PAPER) {
+  return (brush, { width, height, color }) => {
+    const t = renderBrushThumbnail(resolveBrush(brush), { paper: paper(), width, height, color: color.toLowerCase() });
+    return { data: bytesToBase64(encodePng(t.width, t.height, t.data)), mimeType: "image/png" };
+  };
+}
 function createPaintBrushLibraryToolProvider(controller, options = {}) {
   return createBrushLibraryToolProvider(controller.brushLibrary, {
     profile: PAINT_PROFILE,
     stickers: () => controller.stickers.provider,
     ...options,
-    renderPreview: (brush, { width, height, color }) => {
-      const t = renderBrushThumbnail(resolveBrush(brush), { paper: controller.getState().document.paper, width, height, color: color.toLowerCase() });
-      return { data: bytesToBase64(encodePng(t.width, t.height, t.data)), mimeType: "image/png" };
-    }
+    renderPreview: paintBrushPreviewRenderer(() => controller.getState().document.paper)
   });
 }
 
@@ -13780,6 +13783,7 @@ export {
   overPixels,
   padSampleRadius,
   paintAgentStrokePoints,
+  paintBrushPreviewRenderer,
   paintContracts,
   paintGradientMappingFor,
   paintPlaybackPanel,

package/dist/vector/controller.d.cts

@@ -1,4 +1,5 @@
 import { type BrushLibrary } from '../brushes/library.cjs';
+import type { BrushPreviewRenderer } from '../brushes/tools.cjs';
 import type { PaintBrush } from '../paint-editor/brushes.cjs';
 import { type VectorStylizeOptions, type VectorStylizeStyle } from './stylize.cjs';
 import { type VectorDistortBrushMode } from './distortBrush.cjs';
@@ -104,6 +105,12 @@ export interface VectorEditorOptions {
      * profile decides which). Share one with the paint editor so a brush saved there paints here.
      */
     brushLibrary?: Pick<BrushLibrary, 'list' | 'subscribe'>;
+    /**
+     * Draws a brush's preview stroke for the brush editor ("Edit brush…"), e.g.
+     * `renderCanvasBrushPreview` from `@pixerate/editor/canvas` (the renderer brushstrokes paint
+     * with; not bundled here). Without it the brush editor has no preview.
+     */
+    brushPreview?: BrushPreviewRenderer;
     /** The app's colour scheme, which picks the side of a brush's light / dark default colour (default light). */
     colorScheme?: 'light' | 'dark';
     /** History to record into, e.g. one shared with the rest of the app (default: a new one). */
@@ -802,6 +809,12 @@ export declare class VectorEditorController {
      */
     /** The saved brushes of the brush library as last read (empty without one). */
     private brushes;
+    /** The brush library brushstrokes use (`brushLibrary` option), or `null`. A full `BrushLibrary` lets the UI edit brushes (`isBrushLibrary`). */
+    readonly brushLibrary: Pick<BrushLibrary, 'list' | 'subscribe'> | null;
+    /** The `brushPreview` option: draws the brush editor's preview stroke, or `null`. */
+    readonly brushPreview: BrushPreviewRenderer | null;
+    /** Reads the brush library again now (it is also read after every change to it); resolves once read. */
+    refreshBrushes(): Promise<void>;
     /** The brushes a brushstroke can use: the presets, then the brush library's saved brushes the vector profile admits. */
     listBrushstrokeBrushes(): PaintBrush[];
     /** Resolves once the brush library has been read (its saved brushes can be used from then on). */

package/dist/vector/controller.d.ts

@@ -1,4 +1,5 @@
 import { type BrushLibrary } from '../brushes/library.js';
+import type { BrushPreviewRenderer } from '../brushes/tools.js';
 import type { PaintBrush } from '../paint-editor/brushes.js';
 import { type VectorStylizeOptions, type VectorStylizeStyle } from './stylize.js';
 import { type VectorDistortBrushMode } from './distortBrush.js';
@@ -104,6 +105,12 @@ export interface VectorEditorOptions {
      * profile decides which). Share one with the paint editor so a brush saved there paints here.
      */
     brushLibrary?: Pick<BrushLibrary, 'list' | 'subscribe'>;
+    /**
+     * Draws a brush's preview stroke for the brush editor ("Edit brush…"), e.g.
+     * `renderCanvasBrushPreview` from `@pixerate/editor/canvas` (the renderer brushstrokes paint
+     * with; not bundled here). Without it the brush editor has no preview.
+     */
+    brushPreview?: BrushPreviewRenderer;
     /** The app's colour scheme, which picks the side of a brush's light / dark default colour (default light). */
     colorScheme?: 'light' | 'dark';
     /** History to record into, e.g. one shared with the rest of the app (default: a new one). */
@@ -802,6 +809,12 @@ export declare class VectorEditorController {
      */
     /** The saved brushes of the brush library as last read (empty without one). */
     private brushes;
+    /** The brush library brushstrokes use (`brushLibrary` option), or `null`. A full `BrushLibrary` lets the UI edit brushes (`isBrushLibrary`). */
+    readonly brushLibrary: Pick<BrushLibrary, 'list' | 'subscribe'> | null;
+    /** The `brushPreview` option: draws the brush editor's preview stroke, or `null`. */
+    readonly brushPreview: BrushPreviewRenderer | null;
+    /** Reads the brush library again now (it is also read after every change to it); resolves once read. */
+    refreshBrushes(): Promise<void>;
     /** The brushes a brushstroke can use: the presets, then the brush library's saved brushes the vector profile admits. */
     listBrushstrokeBrushes(): PaintBrush[];
     /** Resolves once the brush library has been read (its saved brushes can be used from then on). */