@pixerate/editor 0.262.1 → 0.264.0

package/dist/image-editor/index.js

@@ -8,7 +8,7 @@ import {
   parseOpenTypeFont,
   removeAnchorsKeepingShape,
   traceField
-} from "../chunk-CQVTGBQI.js";
+} from "../chunk-CECCP2V7.js";
 import {
   ADJUSTMENT_KEYS,
   ADJUSTMENT_KINDS,
@@ -410,7 +410,7 @@ import {
   writePsd,
   xyToTempTint,
   xyToUv
-} from "../chunk-D4TE5JNW.js";
+} from "../chunk-HAUDEVMC.js";
 import {
   ColorGmm,
   DEFAULT_REFINE_EDGE_PARAMS,
@@ -770,15 +770,15 @@ import {
   warpMeshParamAt,
   warpMeshRows,
   warpPresetMesh
-} from "../chunk-6NZL24W4.js";
+} from "../chunk-WWI6FLH2.js";
 import {
   IMAGE_PROFILE,
   checkBrush,
   closest,
   createBrushLibrary,
   resolveBrush
-} from "../chunk-5IW65VQ6.js";
-import "../chunk-APX63ILU.js";
+} from "../chunk-EE7SAYBF.js";
+import "../chunk-ACFSFUQH.js";
 import "../chunk-M6DNZNVY.js";
 import {
   bezierPathToSvg,
@@ -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 });
@@ -21482,10 +21485,11 @@ var ContentAwareFillSession = class _ContentAwareFillSession {
 };
 
 // src/image-editor/stickers.ts
-function createImageStickerHost(controller) {
+function createImageStickerHost(controller, options = {}) {
   return {
     noun: "pixel layer",
     format: "png",
+    ...options.dark ? { dark: options.dark } : {},
     defaultCentre: () => {
       const { width, height } = controller.getCanvasSize();
       return { x: width / 2, y: height / 2 };

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

@@ -5,5 +5,10 @@
  */
 import type { StickerInsertHost } from '../stickers/tools.cjs';
 import type { ImageEditorController } from './controller.cjs';
-/** `insert_sticker` for an image editor: a new pixel layer named after the sticker, one undo step. */
-export declare function createImageStickerHost(controller: ImageEditorController): StickerInsertHost;
+/**
+ * `insert_sticker` for an image editor: a new pixel layer named after the sticker, one undo step.
+ * With `dark` (the host's dark theme or picture), stickers that have a dark variant use it.
+ */
+export declare function createImageStickerHost(controller: ImageEditorController, options?: {
+    dark?: () => boolean;
+}): StickerInsertHost;

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

@@ -5,5 +5,10 @@
  */
 import type { StickerInsertHost } from '../stickers/tools.js';
 import type { ImageEditorController } from './controller.js';
-/** `insert_sticker` for an image editor: a new pixel layer named after the sticker, one undo step. */
-export declare function createImageStickerHost(controller: ImageEditorController): StickerInsertHost;
+/**
+ * `insert_sticker` for an image editor: a new pixel layer named after the sticker, one undo step.
+ * With `dark` (the host's dark theme or picture), stickers that have a dark variant use it.
+ */
+export declare function createImageStickerHost(controller: ImageEditorController, options?: {
+    dark?: () => boolean;
+}): StickerInsertHost;

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

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

@@ -1289,15 +1289,20 @@ export declare class PaintEditorController {
     setStickersProvider(provider: StickerProvider | null): void;
     /**
      * Loads the art of `refs` (provider stickers; editor stamps need none) so sprays and placements
-     * can draw them. Rejects with a `PaintEditorError` naming an unknown ref and the closest known
+     * can draw them: their dark variants when the colour scheme is dark and they have one. Rejects with a `PaintEditorError` naming an unknown ref and the closest known
      * ones, or a sticker whose art failed. Emits when art arrives, so views redraw.
      */
     prepareStickers(refs: readonly StickerRef[]): Promise<void>;
-    /** Whether a sticker's art is ready to draw: `ready` (always for editor stamps), `loading`, `failed` (with why) or `none`. */
+    /** Whether a sticker's art is ready to draw in the variant the colour scheme picks: `ready` (always for editor stamps), `loading`, `failed` (with why) or `none`. */
     stickerArtStatus(ref: StickerRef): {
         status: 'ready' | 'loading' | 'failed' | 'none';
         error?: string;
     };
+    /**
+     * A sticker whose ref is new (placed or restamped) in the variant the colour scheme picks: `dark`
+     * on a dark scheme when its sticker has one (known once its art was asked for).
+     */
+    private withStickerVariant;
     private readStickerRef;
     /** Refuses to redraw stickers whose art has not loaded (they would vanish), naming them and what to call. */
     private requireStickerArt;

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

@@ -1289,15 +1289,20 @@ export declare class PaintEditorController {
     setStickersProvider(provider: StickerProvider | null): void;
     /**
      * Loads the art of `refs` (provider stickers; editor stamps need none) so sprays and placements
-     * can draw them. Rejects with a `PaintEditorError` naming an unknown ref and the closest known
+     * can draw them: their dark variants when the colour scheme is dark and they have one. Rejects with a `PaintEditorError` naming an unknown ref and the closest known
      * ones, or a sticker whose art failed. Emits when art arrives, so views redraw.
      */
     prepareStickers(refs: readonly StickerRef[]): Promise<void>;
-    /** Whether a sticker's art is ready to draw: `ready` (always for editor stamps), `loading`, `failed` (with why) or `none`. */
+    /** Whether a sticker's art is ready to draw in the variant the colour scheme picks: `ready` (always for editor stamps), `loading`, `failed` (with why) or `none`. */
     stickerArtStatus(ref: StickerRef): {
         status: 'ready' | 'loading' | 'failed' | 'none';
         error?: string;
     };
+    /**
+     * A sticker whose ref is new (placed or restamped) in the variant the colour scheme picks: `dark`
+     * on a dark scheme when its sticker has one (known once its art was asked for).
+     */
+    private withStickerVariant;
     private readStickerRef;
     /** Refuses to redraw stickers whose art has not loaded (they would vanish), naming them and what to call. */
     private requireStickerArt;