@pixerate/editor 0.263.0 → 0.264.1

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,
@@ -5579,7 +5579,8 @@ async function replayPainting(source, target, options = {}) {
   const maxStrokes = options.strokes ?? source.strokes.length;
   const chunk = Math.max(1, options.wetChunk ?? 0) || Infinity;
   let strokes = 0;
-  await target.prepareEffectPaints(source.strokes.slice(0, maxStrokes).flatMap((st) => st.paint?.type === "effect" ? [st.paint] : []));
+  const scaled = source.strokes.slice(0, maxStrokes).map((st) => s === 1 ? st : varyStroke(st, scaleM, { scale: s }));
+  await target.prepareEffectPaints(scaled.flatMap((st) => st.paint?.type === "effect" ? [st.paint] : []));
   const advanceTo = async (clock) => {
     const now = target.getState().wet.clock;
     let left = clock - now;
@@ -9588,11 +9589,11 @@ var PaintEditorController = class _PaintEditorController {
     if (!layers.length) return null;
     return { layerIds: layers.map((x) => x.layer.id), strokes: layers.reduce((n, x) => n + x.strokes.filter(isLiveEffect).length, 0), sources: sources.length };
   }
-  /** Plays or pauses live effect paint, and caps its frame rate (1..60). Editor state, not an undo step. */
+  /** Plays or pauses live effect paint, and caps its frame rate (1..60); a setting left out keeps its value. Editor state, not an undo step. */
   setEffectPlayback(update) {
     if (update.playing !== void 0 && typeof update.playing !== "boolean") throw new PaintEditorError("playing must be true or false.");
     if (update.fps !== void 0 && !(Number.isInteger(update.fps) && update.fps >= 1 && update.fps <= 60)) throw new PaintEditorError(`fps ${update.fps} is out of range; use a whole number 1..60.`);
-    this.effectPlaybackState = { ...this.effectPlaybackState, ...update };
+    this.effectPlaybackState = { playing: update.playing ?? this.effectPlaybackState.playing, fps: update.fps ?? this.effectPlaybackState.fps };
     this.emit([]);
     return { ...this.effectPlaybackState, time: this.effectTime };
   }
@@ -12150,15 +12151,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 +13784,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). */