@pixerate/editor 0.263.0 → 0.264.0

package/dist/image-editor/index.js

@@ -8,7 +8,7 @@ import {
   parseOpenTypeFont,
   removeAnchorsKeepingShape,
   traceField
-} from "../chunk-JGI4PZWO.js";
+} from "../chunk-CECCP2V7.js";
 import {
   ADJUSTMENT_KEYS,
   ADJUSTMENT_KINDS,
@@ -410,7 +410,7 @@ import {
   writePsd,
   xyToTempTint,
   xyToUv
-} from "../chunk-QW7LKWKE.js";
+} from "../chunk-HAUDEVMC.js";
 import {
   ColorGmm,
   DEFAULT_REFINE_EDGE_PARAMS,
@@ -770,14 +770,14 @@ import {
   warpMeshParamAt,
   warpMeshRows,
   warpPresetMesh
-} from "../chunk-34HIZXFX.js";
+} from "../chunk-WWI6FLH2.js";
 import {
   IMAGE_PROFILE,
   checkBrush,
   closest,
   createBrushLibrary,
   resolveBrush
-} from "../chunk-P5343XZO.js";
+} from "../chunk-EE7SAYBF.js";
 import "../chunk-ACFSFUQH.js";
 import "../chunk-M6DNZNVY.js";
 import {
@@ -5993,6 +5993,7 @@ var ImageEditorController = class {
   effectRefresh = "none";
   constructor(options = {}) {
     this.brushLibrary = options.brushLibrary ?? createBrushLibrary();
+    this.brushPreview = options.brushPreview ?? null;
     this.effects.subscribe(() => this.queueEffectRefresh("all"));
     this.effectsEngine.subscribe(() => this.queueEffectRefresh("incomplete"));
     if (options.effects) this.effects.set(options.effects);
@@ -8773,6 +8774,8 @@ var ImageEditorController = class {
   // --- Painting ---
   /** The brush library the brush presets come from (shared with other editors when the host passes one). */
   brushLibrary;
+  /** The `brushPreview` option: draws the brush editor's preview stroke, or `null`. */
+  brushPreview;
   /** The brushes this editor can paint with (`IMAGE_PROFILE`): built-in presets, then saved brushes. */
   async listBrushPresets() {
     return this.brushLibrary.list({ profile: IMAGE_PROFILE });

package/dist/image-editor/types.d.cts

@@ -10,6 +10,7 @@ import type { SerializedLayeredImageEditorState } from './layers/serialize.cjs';
 import type { PaintOptions } from './controller.cjs';
 import type { TextShaper } from './layers/text.cjs';
 import type { BrushLibrary } from '../brushes/library.cjs';
+import type { BrushPreviewRenderer } from '../brushes/tools.cjs';
 export interface ImageDimensions {
     width: number;
     height: number;
@@ -459,6 +460,12 @@ export interface ImageEditorOptions {
      * paints here (default: a library in memory).
      */
     brushLibrary?: BrushLibrary;
+    /**
+     * Draws a brush's preview stroke for the brush editor ("Edit brush…"), e.g. the paint engine's
+     * `paintBrushPreviewRenderer()` from `@pixerate/editor/paint-editor` (not bundled here, so the
+     * image editor stays free of the paint editor). Without it the brush editor has no preview.
+     */
+    brushPreview?: BrushPreviewRenderer;
     /**
      * What lays out and draws type layers. Default: the browser's fonts through Canvas 2D
      * (`createCanvasTextShaper`) where there is a 2D canvas; `null` (or no canvas) keeps type layers'

package/dist/image-editor/types.d.ts

@@ -10,6 +10,7 @@ import type { SerializedLayeredImageEditorState } from './layers/serialize.js';
 import type { PaintOptions } from './controller.js';
 import type { TextShaper } from './layers/text.js';
 import type { BrushLibrary } from '../brushes/library.js';
+import type { BrushPreviewRenderer } from '../brushes/tools.js';
 export interface ImageDimensions {
     width: number;
     height: number;
@@ -459,6 +460,12 @@ export interface ImageEditorOptions {
      * paints here (default: a library in memory).
      */
     brushLibrary?: BrushLibrary;
+    /**
+     * Draws a brush's preview stroke for the brush editor ("Edit brush…"), e.g. the paint engine's
+     * `paintBrushPreviewRenderer()` from `@pixerate/editor/paint-editor` (not bundled here, so the
+     * image editor stays free of the paint editor). Without it the brush editor has no preview.
+     */
+    brushPreview?: BrushPreviewRenderer;
     /**
      * What lays out and draws type layers. Default: the browser's fonts through Canvas 2D
      * (`createCanvasTextShaper`) where there is a 2D canvas; `null` (or no canvas) keeps type layers'

package/dist/paint-editor/brush-library-tools.d.cts

@@ -2,10 +2,17 @@
  * The shared brush library's agent tools for a paint editor (`createPaintBrushLibraryToolProvider`),
  * with `preview_brush` painted by this editor.
  */
-import { type BrushLibraryToolProviderOptions } from '../brushes/tools.cjs';
+import { type BrushLibraryToolProviderOptions, type BrushPreviewRenderer } from '../brushes/tools.cjs';
 import type { AgentToolProvider } from '../tools/registry.cjs';
 import type { PaintEditorController } from './controller.cjs';
+import { type PaperSettings } from './paper.cjs';
 export type PaintBrushLibraryToolProviderOptions = Omit<BrushLibraryToolProviderOptions, 'renderPreview'>;
+/**
+ * A brush preview renderer (`BrushPreviewRenderer`, as `preview_brush` and `BrushLibraryEditor`
+ * take) that paints the test stroke with the paint engine on `paper` (read on every call; default
+ * the default paper). Any brush the paint editor renders, so also the image editor's.
+ */
+export declare function paintBrushPreviewRenderer(paper?: () => PaperSettings): BrushPreviewRenderer;
 /**
  * The brush library tools for a paint editor (`@pixerate/editor/brushes`' provider on the
  * editor's `brushLibrary`, `PAINT_PROFILE`), with `preview_brush` painting the test stroke on the

package/dist/paint-editor/brush-library-tools.d.ts

@@ -2,10 +2,17 @@
  * The shared brush library's agent tools for a paint editor (`createPaintBrushLibraryToolProvider`),
  * with `preview_brush` painted by this editor.
  */
-import { type BrushLibraryToolProviderOptions } from '../brushes/tools.js';
+import { type BrushLibraryToolProviderOptions, type BrushPreviewRenderer } from '../brushes/tools.js';
 import type { AgentToolProvider } from '../tools/registry.js';
 import type { PaintEditorController } from './controller.js';
+import { type PaperSettings } from './paper.js';
 export type PaintBrushLibraryToolProviderOptions = Omit<BrushLibraryToolProviderOptions, 'renderPreview'>;
+/**
+ * A brush preview renderer (`BrushPreviewRenderer`, as `preview_brush` and `BrushLibraryEditor`
+ * take) that paints the test stroke with the paint engine on `paper` (read on every call; default
+ * the default paper). Any brush the paint editor renders, so also the image editor's.
+ */
+export declare function paintBrushPreviewRenderer(paper?: () => PaperSettings): BrushPreviewRenderer;
 /**
  * The brush library tools for a paint editor (`@pixerate/editor/brushes`' provider on the
  * editor's `brushLibrary`, `PAINT_PROFILE`), with `preview_brush` painting the test stroke on the