@pixerate/editor 0.106.0 → 0.108.0

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

@@ -1,9 +1,10 @@
-import { R as RasterLayer, a as RasterGroupLayer, b as RasterPixelLayer, C as CompositorLayer, c as RasterCompositor, d as RasterSources, L as LayerLocks } from '../compositor-Bc3PNP3C.cjs';
-import { B as BrushSettings, M as MixerSettings, C as CoverageMap, D as Dab, S as StrokePoint, a as MixerLoad } from '../mixer-C1M1Nua_.cjs';
-export { b as MAX_BRUSH_SIZE } from '../mixer-C1M1Nua_.cjs';
-import { R as RasterRect, a as TiledSurface, B as BlendMode } from '../surface-BBJN9wxg.cjs';
-export { b as BLEND_MODES, c as Tile, i as isBlendMode } from '../surface-BBJN9wxg.cjs';
-import { I as ImageEditorAssetStore, S as SerializedLayer, P as PsdExportResult } from '../export-_m3Es4ru.cjs';
+import { R as RasterLayer, a as RasterGroupLayer, b as RasterPixelLayer, C as CompositorLayer, c as RasterCompositor, d as RasterSources, L as LayerLocks } from '../compositor-D92URMlm.cjs';
+import { B as BrushSettings, M as MixerSettings, C as CoverageMap, D as Dab, S as StrokePoint, a as MixerLoad } from '../mixer-5ziHU8OS.cjs';
+export { b as MAX_BRUSH_SIZE } from '../mixer-5ziHU8OS.cjs';
+import { R as RasterRect, a as TiledSurface, B as BlendMode, b as BlendModeInfo } from '../surface-CkKOHGPm.cjs';
+export { c as BLEND_MODES, d as PAINTERLY_BLEND_MODES, e as Tile, i as isBlendMode, f as isPainterlyBlendMode, s as standardBlendMode } from '../surface-CkKOHGPm.cjs';
+import { I as ImageEditorAssetStore, S as SerializedLayer, P as PsdExportResult } from '../export-JGWQEPJn.cjs';
+import { g as PresenceStore, e as PresenceClock, d as PresenceActorInfo, c as PresenceActor, f as PresenceState } from '../presence-Cb6WhcrQ.cjs';
 import { a as AgentToolProvider } from '../registry-BqA1AZt0.cjs';
 import '../types-CwMPoRMU.cjs';
 import '../warp-D5jz_tN7.cjs';
@@ -1385,7 +1386,8 @@ declare class PaintEditorController {
     paintStroke(init: PaintStrokeInit & {
         points: readonly PenPoint[];
     }): PaintStrokeResult;
-    private checkPoints;
+    /** Checks stroke samples (finite x and y, pressure 0..1) and returns them; throws a sentence naming the bad point. */
+    checkPoints(points: readonly PenPoint[]): PenPoint[];
     /** Every recorded stroke, oldest first. */
     getStrokes(): readonly RecordedStroke[];
     /**
@@ -1533,6 +1535,91 @@ declare class PaintEditorController {
 /** Largest tracing or reference image side, in pixels. */
 declare const MAX_IMAGE_SIDE = 8192;
 
+type PaintPresenceActor = PresenceActor;
+type PaintPresenceState = PresenceState;
+/** Cursor positions (document pixels) and notes of agents painting, for an overlay. */
+declare class PaintPresence extends PresenceStore {
+}
+/** What an agent asks for. Each command that paints commits as one undo step. */
+type PaintAgentCommand = {
+    kind: 'stroke';
+    stroke: PaintStrokeInit & {
+        points: readonly PenPoint[];
+    };
+    note?: string;
+} | {
+    kind: 'fill';
+    fill: FillLayerOptions;
+    note?: string;
+} | {
+    kind: 'replay';
+    replay: ReplayOptions;
+    note?: string;
+} | {
+    kind: 'point';
+    at: {
+        x: number;
+        y: number;
+    };
+    note?: string;
+} | {
+    kind: 'say';
+    text: string;
+};
+type PaintPerformanceResult = {
+    ok: true;
+    command: PaintAgentCommand;
+    result?: unknown;
+} | {
+    ok: false;
+    command: PaintAgentCommand;
+    message: string;
+};
+interface PaintDirectorOptions {
+    clock?: PresenceClock;
+    /** 1 = natural speed; 2 = twice as fast. */
+    speed?: number;
+    /** Hide each actor's cursor this long after its last command (ms, default 1500; 0 keeps it). */
+    linger?: number;
+    /** Longest a stroke takes to paint at speed 1 (ms, default 1800); longer strokes are sped up. */
+    maxStrokeMs?: number;
+}
+/** Where along a stroke each point is reached, 0..1: by its time `t` when the points have times, else by distance. */
+declare function strokeSchedule(points: readonly PenPoint[]): number[];
+/** How long a stroke takes to paint at speed 1 (ms): its recorded duration, else ~1.5 px/ms, between 250 ms and `max`. */
+declare function strokeDuration(points: readonly PenPoint[], max?: number): number;
+/** A zig-zag across `rect` (for a fill rubbed over the sheet), `rows` passes from the top. */
+declare function sweepPath(rect: RasterRect, rows?: number): Array<{
+    x: number;
+    y: number;
+}>;
+/**
+ * Acts out agent commands on a paint canvas: the actor's cursor glides to the stroke's start and
+ * paints it live along its points (paced by their times, or evenly), the stroke committing as
+ * one undo step; fills are rubbed across the sheet first; replays start from the strokes they
+ * copy and end on what they painted. Commands queue per actor. A command that cannot apply (an
+ * unknown or locked layer, a stroke the user is still painting) fails with the controller's
+ * sentence before anything is painted.
+ */
+declare class PaintDirector {
+    private readonly controller;
+    readonly presence: PaintPresence;
+    private readonly options;
+    private readonly clock;
+    private readonly queue;
+    constructor(controller: PaintEditorController, presence: PaintPresence, options?: PaintDirectorOptions);
+    /** Acts out `commands` in order for `actor`. Resolves with one result per command. */
+    perform(actor: PresenceActorInfo, commands: readonly PaintAgentCommand[]): Promise<PaintPerformanceResult[]>;
+    private ms;
+    private where;
+    /** Glides to `to`; an actor that just appeared starts there instead of the corner. */
+    private glide;
+    private say;
+    private performOne;
+    /** Paints a stroke live: begins it, pushes its points frame by frame as the cursor reaches them, then ends it (one undo step). */
+    private stroke;
+}
+
 /**
  * Agent tools for the paint editor (`createPaintEditorToolProvider`). Strict schemas, every
  * argument described, all four annotations. Each write is one undo step (or editor state, said so)
@@ -1545,6 +1632,13 @@ interface PaintEditorToolProviderOptions {
     id?: string;
     /** Always prefix tool names with `<namespace>__`. */
     namespace?: string;
+    /**
+     * Acts out strokes, fills and replays with an agent cursor on the canvas (see `PaintDirector`):
+     * strokes paint live along their points. Each call is still one undo step. Without it, they apply at once.
+     */
+    director?: PaintDirector;
+    /** The agent's cursor (default `{ id: 'agent', name: 'Agent' }`). */
+    actor?: PresenceActorInfo;
 }
 /** Agent tools for one paint editor. */
 declare function createPaintEditorToolProvider(controller: PaintEditorController, options?: PaintEditorToolProviderOptions): AgentToolProvider;
@@ -1676,5 +1770,16 @@ declare function renderColorWheel(size: number, wheel: ColorWheel, inner?: numbe
 };
 /** The colour for a click on the wheel ring at (dx, dy) from its centre, keeping `color`'s saturation and value. */
 declare function wheelPick(dx: number, dy: number, wheel: ColorWheel, color: string): string;
+/** A group of the blend menu: the Photoshop modes, then pigment and the painterly modes. */
+interface BlendMenuGroup {
+    label: string;
+    modes: readonly BlendModeInfo[];
+}
+/**
+ * The layer and brush blend menus as groups: the 26 standard modes, then the paint modes
+ * (`pigment` and the painterly `watercolor`, `tint`, `highlight`, `shadow`), each with its
+ * description as a tooltip. Both bindings render this as `<optgroup>`s.
+ */
+declare const BLEND_MENU_GROUPS: readonly BlendMenuGroup[];
 
-export { type Affine, BRUSH_ID, BRUSH_ROTATIONS, BRUSH_SLIDERS, BUILTIN_BRUSHES, BlendMode, type BrushDynamics, type BrushLibraryFile, type BrushRotation, type BrushThumbnail, type ColorWheel, DEFAULT_BRUSH_ID, DEFAULT_DPI, DEFAULT_DYNAMICS, DEFAULT_PAPER, DEFAULT_SWATCHES, DEFAULT_VIEW, DryStroke, type DryStrokeOptions, type FillLayerOptions, GRAIN_PATTERNS, GRAIN_TILE, type GrainPattern, type GrainTuning, HARMONY_KINDS, type Hand, type HarmonyColor, type HarmonyKind, IDENTITY_AFFINE, IDENTITY_COPY, type ImageEncoder, type ImageFormat, type ImageNode, type LayerUpdate, type Linear2, type LoadedPaintDocument, MAX_CANVAS_SIDE, MAX_COORDINATE, MAX_IMAGE_SIDE, MAX_ZOOM, MIN_CANVAS_SIDE, MIN_ZOOM, MIXING_PAD_HEIGHT, MIXING_PAD_WIDTH, MixingPad, type MixingPadTool, PAINT_BRUSH_CATEGORIES, PAINT_BRUSH_ENGINES, PAINT_FORMAT, PAINT_SCHEMA_VERSION, PAINT_TOOLS, PAPER_FAMILIES, PAPER_LIBRARY, PAPER_NODE_ID, PAPER_SLIDERS, type Paint2DContext, type PaintAssetStore, type PaintBrush, type PaintBrushCategory, type PaintBrushEngine, type PaintBrushInput, type PaintCanvas, PaintCanvasPresenter, PaintDocumentError, type PaintDocumentExtensions, type PaintDocumentState, PaintEditorController, PaintEditorError, type PaintEditorOptions, type PaintEditorState, type PaintEditorToolProviderOptions, PaintGesture, type PaintGroupLayer, type PaintGuides, type PaintLayer, type PaintLayerInfo, type PaintPixelLayer, type PaintPointerEvent, type PaintStrokeInit, type PaintStrokeResult, PaintStrokeSession, type PaintTool, type PaintView, type PaperFamily, PaperGrain, type PaperNode, type PaperSettings, type PaperTiling, type PenDab, PenDabWalker, type PenPoint, PenSmoother, type PerspectiveGuide, PerspectiveSnapper, type PixelImage, type Point2, type PointerSample, type RecordedStroke, type ReferenceImage, type RenderOptions, type ReplayOptions, type Rgb255, SNAP_DECIDE_DISTANCE, SYMMETRY_MODES, type SerializeOptions, type SerializedPaintDocument, type SliderControl, type StrokeCopy, type StrokeSessionHost, type StrokeSessionInit, type StrokeVariation, type Swatch, type SymmetryGuide, type SymmetryMode, TRACING_NODE_ID, TileableNoise, type TracingImage, type ViewLayer, type ViewportBox, affineCopy, applyAffine, brushToJSON, clonePaper, colorHarmony, composeAffine, createPaintCompositor, createPaintDocument, createPaintEditorToolProvider, createPaintLayer, decodeImageBlob, defaultGuides, defaultImageEncoder, deserializePaintDocument, deserializePaintDocumentAsync, documentExtensions, documentToScreen, downloadBytes, downsampleRgba, fitZoom, grainCatch, grainHeights, guideOverlay, handlePaintShortcut, hash2, hexToRgb8, hslToRgb, hsvToRgb, hueToWheel, invertAffine, isPalmTouch, mapPenPoint, mix32, mixerLoadForStroke, mixerTip, newPaintLayerId, normalizeBrushStroke, normalizeCanvas, normalizeDynamics, normalizePaintBrush, normalizePaper, normalizePerspective, normalizeRotation, normalizeSymmetry, normalizeView, paperGrain, paperKey, paperNode, paperPreset, parseBrushLibrary, parseHexColor, patchPath, penOrientation, perspectiveDirections, perspectiveGuideLines, pointerToPenPoint, rand01, randSigned, readPath, renderBrushThumbnail, renderColorWheel, renderPaper, rgbToHexColor, rgbToHsl, rgbToHsv, samplePressure, screenToDocument, seedFromString, serializePaintDocument, serializePaintDocumentExternal, strokeBounds, symmetryAxisAngles, symmetryAxisSegments, symmetryCopies, thumbnailStroke, tiltToOrientation, toStrokePoint, variationAffine, varyStroke, viewCssTransform, viewMatrix, viewPenToDocument, wheelAngle, wheelPick, wheelPoint, wheelToHue };
+export { type Affine, BLEND_MENU_GROUPS, BRUSH_ID, BRUSH_ROTATIONS, BRUSH_SLIDERS, BUILTIN_BRUSHES, type BlendMenuGroup, BlendMode, BlendModeInfo, type BrushDynamics, type BrushLibraryFile, type BrushRotation, type BrushThumbnail, type ColorWheel, DEFAULT_BRUSH_ID, DEFAULT_DPI, DEFAULT_DYNAMICS, DEFAULT_PAPER, DEFAULT_SWATCHES, DEFAULT_VIEW, DryStroke, type DryStrokeOptions, type FillLayerOptions, GRAIN_PATTERNS, GRAIN_TILE, type GrainPattern, type GrainTuning, HARMONY_KINDS, type Hand, type HarmonyColor, type HarmonyKind, IDENTITY_AFFINE, IDENTITY_COPY, type ImageEncoder, type ImageFormat, type ImageNode, type LayerUpdate, type Linear2, type LoadedPaintDocument, MAX_CANVAS_SIDE, MAX_COORDINATE, MAX_IMAGE_SIDE, MAX_ZOOM, MIN_CANVAS_SIDE, MIN_ZOOM, MIXING_PAD_HEIGHT, MIXING_PAD_WIDTH, MixingPad, type MixingPadTool, PAINT_BRUSH_CATEGORIES, PAINT_BRUSH_ENGINES, PAINT_FORMAT, PAINT_SCHEMA_VERSION, PAINT_TOOLS, PAPER_FAMILIES, PAPER_LIBRARY, PAPER_NODE_ID, PAPER_SLIDERS, type Paint2DContext, type PaintAgentCommand, type PaintAssetStore, type PaintBrush, type PaintBrushCategory, type PaintBrushEngine, type PaintBrushInput, type PaintCanvas, PaintCanvasPresenter, PaintDirector, type PaintDirectorOptions, PaintDocumentError, type PaintDocumentExtensions, type PaintDocumentState, PaintEditorController, PaintEditorError, type PaintEditorOptions, type PaintEditorState, type PaintEditorToolProviderOptions, PaintGesture, type PaintGroupLayer, type PaintGuides, type PaintLayer, type PaintLayerInfo, type PaintPerformanceResult, type PaintPixelLayer, type PaintPointerEvent, PaintPresence, type PaintPresenceActor, type PaintPresenceState, type PaintStrokeInit, type PaintStrokeResult, PaintStrokeSession, type PaintTool, type PaintView, type PaperFamily, PaperGrain, type PaperNode, type PaperSettings, type PaperTiling, type PenDab, PenDabWalker, type PenPoint, PenSmoother, type PerspectiveGuide, PerspectiveSnapper, type PixelImage, type Point2, type PointerSample, type RecordedStroke, type ReferenceImage, type RenderOptions, type ReplayOptions, type Rgb255, SNAP_DECIDE_DISTANCE, SYMMETRY_MODES, type SerializeOptions, type SerializedPaintDocument, type SliderControl, type StrokeCopy, type StrokeSessionHost, type StrokeSessionInit, type StrokeVariation, type Swatch, type SymmetryGuide, type SymmetryMode, TRACING_NODE_ID, TileableNoise, type TracingImage, type ViewLayer, type ViewportBox, affineCopy, applyAffine, brushToJSON, clonePaper, colorHarmony, composeAffine, createPaintCompositor, createPaintDocument, createPaintEditorToolProvider, createPaintLayer, decodeImageBlob, defaultGuides, defaultImageEncoder, deserializePaintDocument, deserializePaintDocumentAsync, documentExtensions, documentToScreen, downloadBytes, downsampleRgba, fitZoom, grainCatch, grainHeights, guideOverlay, handlePaintShortcut, hash2, hexToRgb8, hslToRgb, hsvToRgb, hueToWheel, invertAffine, isPalmTouch, mapPenPoint, mix32, mixerLoadForStroke, mixerTip, newPaintLayerId, normalizeBrushStroke, normalizeCanvas, normalizeDynamics, normalizePaintBrush, normalizePaper, normalizePerspective, normalizeRotation, normalizeSymmetry, normalizeView, paperGrain, paperKey, paperNode, paperPreset, parseBrushLibrary, parseHexColor, patchPath, penOrientation, perspectiveDirections, perspectiveGuideLines, pointerToPenPoint, rand01, randSigned, readPath, renderBrushThumbnail, renderColorWheel, renderPaper, rgbToHexColor, rgbToHsl, rgbToHsv, samplePressure, screenToDocument, seedFromString, serializePaintDocument, serializePaintDocumentExternal, strokeBounds, strokeDuration, strokeSchedule, sweepPath, symmetryAxisAngles, symmetryAxisSegments, symmetryCopies, thumbnailStroke, tiltToOrientation, toStrokePoint, variationAffine, varyStroke, viewCssTransform, viewMatrix, viewPenToDocument, wheelAngle, wheelPick, wheelPoint, wheelToHue };

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

@@ -1,9 +1,10 @@
-import { R as RasterLayer, a as RasterGroupLayer, b as RasterPixelLayer, C as CompositorLayer, c as RasterCompositor, d as RasterSources, L as LayerLocks } from '../compositor-BsYYllvR.js';
-import { B as BrushSettings, M as MixerSettings, C as CoverageMap, D as Dab, S as StrokePoint, a as MixerLoad } from '../mixer-Cu5a9Bzd.js';
-export { b as MAX_BRUSH_SIZE } from '../mixer-Cu5a9Bzd.js';
-import { R as RasterRect, a as TiledSurface, B as BlendMode } from '../surface-BBJN9wxg.js';
-export { b as BLEND_MODES, c as Tile, i as isBlendMode } from '../surface-BBJN9wxg.js';
-import { I as ImageEditorAssetStore, S as SerializedLayer, P as PsdExportResult } from '../export-iMrop3Jm.js';
+import { R as RasterLayer, a as RasterGroupLayer, b as RasterPixelLayer, C as CompositorLayer, c as RasterCompositor, d as RasterSources, L as LayerLocks } from '../compositor-Kt_M4ruo.js';
+import { B as BrushSettings, M as MixerSettings, C as CoverageMap, D as Dab, S as StrokePoint, a as MixerLoad } from '../mixer-DNqiYXYQ.js';
+export { b as MAX_BRUSH_SIZE } from '../mixer-DNqiYXYQ.js';
+import { R as RasterRect, a as TiledSurface, B as BlendMode, b as BlendModeInfo } from '../surface-CkKOHGPm.js';
+export { c as BLEND_MODES, d as PAINTERLY_BLEND_MODES, e as Tile, i as isBlendMode, f as isPainterlyBlendMode, s as standardBlendMode } from '../surface-CkKOHGPm.js';
+import { I as ImageEditorAssetStore, S as SerializedLayer, P as PsdExportResult } from '../export-a9bnF7Cl.js';
+import { g as PresenceStore, e as PresenceClock, d as PresenceActorInfo, c as PresenceActor, f as PresenceState } from '../presence-Cb6WhcrQ.js';
 import { a as AgentToolProvider } from '../registry-D-4fit9C.js';
 import '../types-CwMPoRMU.js';
 import '../warp-CWHZzE3x.js';
@@ -1385,7 +1386,8 @@ declare class PaintEditorController {
     paintStroke(init: PaintStrokeInit & {
         points: readonly PenPoint[];
     }): PaintStrokeResult;
-    private checkPoints;
+    /** Checks stroke samples (finite x and y, pressure 0..1) and returns them; throws a sentence naming the bad point. */
+    checkPoints(points: readonly PenPoint[]): PenPoint[];
     /** Every recorded stroke, oldest first. */
     getStrokes(): readonly RecordedStroke[];
     /**
@@ -1533,6 +1535,91 @@ declare class PaintEditorController {
 /** Largest tracing or reference image side, in pixels. */
 declare const MAX_IMAGE_SIDE = 8192;
 
+type PaintPresenceActor = PresenceActor;
+type PaintPresenceState = PresenceState;
+/** Cursor positions (document pixels) and notes of agents painting, for an overlay. */
+declare class PaintPresence extends PresenceStore {
+}
+/** What an agent asks for. Each command that paints commits as one undo step. */
+type PaintAgentCommand = {
+    kind: 'stroke';
+    stroke: PaintStrokeInit & {
+        points: readonly PenPoint[];
+    };
+    note?: string;
+} | {
+    kind: 'fill';
+    fill: FillLayerOptions;
+    note?: string;
+} | {
+    kind: 'replay';
+    replay: ReplayOptions;
+    note?: string;
+} | {
+    kind: 'point';
+    at: {
+        x: number;
+        y: number;
+    };
+    note?: string;
+} | {
+    kind: 'say';
+    text: string;
+};
+type PaintPerformanceResult = {
+    ok: true;
+    command: PaintAgentCommand;
+    result?: unknown;
+} | {
+    ok: false;
+    command: PaintAgentCommand;
+    message: string;
+};
+interface PaintDirectorOptions {
+    clock?: PresenceClock;
+    /** 1 = natural speed; 2 = twice as fast. */
+    speed?: number;
+    /** Hide each actor's cursor this long after its last command (ms, default 1500; 0 keeps it). */
+    linger?: number;
+    /** Longest a stroke takes to paint at speed 1 (ms, default 1800); longer strokes are sped up. */
+    maxStrokeMs?: number;
+}
+/** Where along a stroke each point is reached, 0..1: by its time `t` when the points have times, else by distance. */
+declare function strokeSchedule(points: readonly PenPoint[]): number[];
+/** How long a stroke takes to paint at speed 1 (ms): its recorded duration, else ~1.5 px/ms, between 250 ms and `max`. */
+declare function strokeDuration(points: readonly PenPoint[], max?: number): number;
+/** A zig-zag across `rect` (for a fill rubbed over the sheet), `rows` passes from the top. */
+declare function sweepPath(rect: RasterRect, rows?: number): Array<{
+    x: number;
+    y: number;
+}>;
+/**
+ * Acts out agent commands on a paint canvas: the actor's cursor glides to the stroke's start and
+ * paints it live along its points (paced by their times, or evenly), the stroke committing as
+ * one undo step; fills are rubbed across the sheet first; replays start from the strokes they
+ * copy and end on what they painted. Commands queue per actor. A command that cannot apply (an
+ * unknown or locked layer, a stroke the user is still painting) fails with the controller's
+ * sentence before anything is painted.
+ */
+declare class PaintDirector {
+    private readonly controller;
+    readonly presence: PaintPresence;
+    private readonly options;
+    private readonly clock;
+    private readonly queue;
+    constructor(controller: PaintEditorController, presence: PaintPresence, options?: PaintDirectorOptions);
+    /** Acts out `commands` in order for `actor`. Resolves with one result per command. */
+    perform(actor: PresenceActorInfo, commands: readonly PaintAgentCommand[]): Promise<PaintPerformanceResult[]>;
+    private ms;
+    private where;
+    /** Glides to `to`; an actor that just appeared starts there instead of the corner. */
+    private glide;
+    private say;
+    private performOne;
+    /** Paints a stroke live: begins it, pushes its points frame by frame as the cursor reaches them, then ends it (one undo step). */
+    private stroke;
+}
+
 /**
  * Agent tools for the paint editor (`createPaintEditorToolProvider`). Strict schemas, every
  * argument described, all four annotations. Each write is one undo step (or editor state, said so)
@@ -1545,6 +1632,13 @@ interface PaintEditorToolProviderOptions {
     id?: string;
     /** Always prefix tool names with `<namespace>__`. */
     namespace?: string;
+    /**
+     * Acts out strokes, fills and replays with an agent cursor on the canvas (see `PaintDirector`):
+     * strokes paint live along their points. Each call is still one undo step. Without it, they apply at once.
+     */
+    director?: PaintDirector;
+    /** The agent's cursor (default `{ id: 'agent', name: 'Agent' }`). */
+    actor?: PresenceActorInfo;
 }
 /** Agent tools for one paint editor. */
 declare function createPaintEditorToolProvider(controller: PaintEditorController, options?: PaintEditorToolProviderOptions): AgentToolProvider;
@@ -1676,5 +1770,16 @@ declare function renderColorWheel(size: number, wheel: ColorWheel, inner?: numbe
 };
 /** The colour for a click on the wheel ring at (dx, dy) from its centre, keeping `color`'s saturation and value. */
 declare function wheelPick(dx: number, dy: number, wheel: ColorWheel, color: string): string;
+/** A group of the blend menu: the Photoshop modes, then pigment and the painterly modes. */
+interface BlendMenuGroup {
+    label: string;
+    modes: readonly BlendModeInfo[];
+}
+/**
+ * The layer and brush blend menus as groups: the 26 standard modes, then the paint modes
+ * (`pigment` and the painterly `watercolor`, `tint`, `highlight`, `shadow`), each with its
+ * description as a tooltip. Both bindings render this as `<optgroup>`s.
+ */
+declare const BLEND_MENU_GROUPS: readonly BlendMenuGroup[];
 
-export { type Affine, BRUSH_ID, BRUSH_ROTATIONS, BRUSH_SLIDERS, BUILTIN_BRUSHES, BlendMode, type BrushDynamics, type BrushLibraryFile, type BrushRotation, type BrushThumbnail, type ColorWheel, DEFAULT_BRUSH_ID, DEFAULT_DPI, DEFAULT_DYNAMICS, DEFAULT_PAPER, DEFAULT_SWATCHES, DEFAULT_VIEW, DryStroke, type DryStrokeOptions, type FillLayerOptions, GRAIN_PATTERNS, GRAIN_TILE, type GrainPattern, type GrainTuning, HARMONY_KINDS, type Hand, type HarmonyColor, type HarmonyKind, IDENTITY_AFFINE, IDENTITY_COPY, type ImageEncoder, type ImageFormat, type ImageNode, type LayerUpdate, type Linear2, type LoadedPaintDocument, MAX_CANVAS_SIDE, MAX_COORDINATE, MAX_IMAGE_SIDE, MAX_ZOOM, MIN_CANVAS_SIDE, MIN_ZOOM, MIXING_PAD_HEIGHT, MIXING_PAD_WIDTH, MixingPad, type MixingPadTool, PAINT_BRUSH_CATEGORIES, PAINT_BRUSH_ENGINES, PAINT_FORMAT, PAINT_SCHEMA_VERSION, PAINT_TOOLS, PAPER_FAMILIES, PAPER_LIBRARY, PAPER_NODE_ID, PAPER_SLIDERS, type Paint2DContext, type PaintAssetStore, type PaintBrush, type PaintBrushCategory, type PaintBrushEngine, type PaintBrushInput, type PaintCanvas, PaintCanvasPresenter, PaintDocumentError, type PaintDocumentExtensions, type PaintDocumentState, PaintEditorController, PaintEditorError, type PaintEditorOptions, type PaintEditorState, type PaintEditorToolProviderOptions, PaintGesture, type PaintGroupLayer, type PaintGuides, type PaintLayer, type PaintLayerInfo, type PaintPixelLayer, type PaintPointerEvent, type PaintStrokeInit, type PaintStrokeResult, PaintStrokeSession, type PaintTool, type PaintView, type PaperFamily, PaperGrain, type PaperNode, type PaperSettings, type PaperTiling, type PenDab, PenDabWalker, type PenPoint, PenSmoother, type PerspectiveGuide, PerspectiveSnapper, type PixelImage, type Point2, type PointerSample, type RecordedStroke, type ReferenceImage, type RenderOptions, type ReplayOptions, type Rgb255, SNAP_DECIDE_DISTANCE, SYMMETRY_MODES, type SerializeOptions, type SerializedPaintDocument, type SliderControl, type StrokeCopy, type StrokeSessionHost, type StrokeSessionInit, type StrokeVariation, type Swatch, type SymmetryGuide, type SymmetryMode, TRACING_NODE_ID, TileableNoise, type TracingImage, type ViewLayer, type ViewportBox, affineCopy, applyAffine, brushToJSON, clonePaper, colorHarmony, composeAffine, createPaintCompositor, createPaintDocument, createPaintEditorToolProvider, createPaintLayer, decodeImageBlob, defaultGuides, defaultImageEncoder, deserializePaintDocument, deserializePaintDocumentAsync, documentExtensions, documentToScreen, downloadBytes, downsampleRgba, fitZoom, grainCatch, grainHeights, guideOverlay, handlePaintShortcut, hash2, hexToRgb8, hslToRgb, hsvToRgb, hueToWheel, invertAffine, isPalmTouch, mapPenPoint, mix32, mixerLoadForStroke, mixerTip, newPaintLayerId, normalizeBrushStroke, normalizeCanvas, normalizeDynamics, normalizePaintBrush, normalizePaper, normalizePerspective, normalizeRotation, normalizeSymmetry, normalizeView, paperGrain, paperKey, paperNode, paperPreset, parseBrushLibrary, parseHexColor, patchPath, penOrientation, perspectiveDirections, perspectiveGuideLines, pointerToPenPoint, rand01, randSigned, readPath, renderBrushThumbnail, renderColorWheel, renderPaper, rgbToHexColor, rgbToHsl, rgbToHsv, samplePressure, screenToDocument, seedFromString, serializePaintDocument, serializePaintDocumentExternal, strokeBounds, symmetryAxisAngles, symmetryAxisSegments, symmetryCopies, thumbnailStroke, tiltToOrientation, toStrokePoint, variationAffine, varyStroke, viewCssTransform, viewMatrix, viewPenToDocument, wheelAngle, wheelPick, wheelPoint, wheelToHue };
+export { type Affine, BLEND_MENU_GROUPS, BRUSH_ID, BRUSH_ROTATIONS, BRUSH_SLIDERS, BUILTIN_BRUSHES, type BlendMenuGroup, BlendMode, BlendModeInfo, type BrushDynamics, type BrushLibraryFile, type BrushRotation, type BrushThumbnail, type ColorWheel, DEFAULT_BRUSH_ID, DEFAULT_DPI, DEFAULT_DYNAMICS, DEFAULT_PAPER, DEFAULT_SWATCHES, DEFAULT_VIEW, DryStroke, type DryStrokeOptions, type FillLayerOptions, GRAIN_PATTERNS, GRAIN_TILE, type GrainPattern, type GrainTuning, HARMONY_KINDS, type Hand, type HarmonyColor, type HarmonyKind, IDENTITY_AFFINE, IDENTITY_COPY, type ImageEncoder, type ImageFormat, type ImageNode, type LayerUpdate, type Linear2, type LoadedPaintDocument, MAX_CANVAS_SIDE, MAX_COORDINATE, MAX_IMAGE_SIDE, MAX_ZOOM, MIN_CANVAS_SIDE, MIN_ZOOM, MIXING_PAD_HEIGHT, MIXING_PAD_WIDTH, MixingPad, type MixingPadTool, PAINT_BRUSH_CATEGORIES, PAINT_BRUSH_ENGINES, PAINT_FORMAT, PAINT_SCHEMA_VERSION, PAINT_TOOLS, PAPER_FAMILIES, PAPER_LIBRARY, PAPER_NODE_ID, PAPER_SLIDERS, type Paint2DContext, type PaintAgentCommand, type PaintAssetStore, type PaintBrush, type PaintBrushCategory, type PaintBrushEngine, type PaintBrushInput, type PaintCanvas, PaintCanvasPresenter, PaintDirector, type PaintDirectorOptions, PaintDocumentError, type PaintDocumentExtensions, type PaintDocumentState, PaintEditorController, PaintEditorError, type PaintEditorOptions, type PaintEditorState, type PaintEditorToolProviderOptions, PaintGesture, type PaintGroupLayer, type PaintGuides, type PaintLayer, type PaintLayerInfo, type PaintPerformanceResult, type PaintPixelLayer, type PaintPointerEvent, PaintPresence, type PaintPresenceActor, type PaintPresenceState, type PaintStrokeInit, type PaintStrokeResult, PaintStrokeSession, type PaintTool, type PaintView, type PaperFamily, PaperGrain, type PaperNode, type PaperSettings, type PaperTiling, type PenDab, PenDabWalker, type PenPoint, PenSmoother, type PerspectiveGuide, PerspectiveSnapper, type PixelImage, type Point2, type PointerSample, type RecordedStroke, type ReferenceImage, type RenderOptions, type ReplayOptions, type Rgb255, SNAP_DECIDE_DISTANCE, SYMMETRY_MODES, type SerializeOptions, type SerializedPaintDocument, type SliderControl, type StrokeCopy, type StrokeSessionHost, type StrokeSessionInit, type StrokeVariation, type Swatch, type SymmetryGuide, type SymmetryMode, TRACING_NODE_ID, TileableNoise, type TracingImage, type ViewLayer, type ViewportBox, affineCopy, applyAffine, brushToJSON, clonePaper, colorHarmony, composeAffine, createPaintCompositor, createPaintDocument, createPaintEditorToolProvider, createPaintLayer, decodeImageBlob, defaultGuides, defaultImageEncoder, deserializePaintDocument, deserializePaintDocumentAsync, documentExtensions, documentToScreen, downloadBytes, downsampleRgba, fitZoom, grainCatch, grainHeights, guideOverlay, handlePaintShortcut, hash2, hexToRgb8, hslToRgb, hsvToRgb, hueToWheel, invertAffine, isPalmTouch, mapPenPoint, mix32, mixerLoadForStroke, mixerTip, newPaintLayerId, normalizeBrushStroke, normalizeCanvas, normalizeDynamics, normalizePaintBrush, normalizePaper, normalizePerspective, normalizeRotation, normalizeSymmetry, normalizeView, paperGrain, paperKey, paperNode, paperPreset, parseBrushLibrary, parseHexColor, patchPath, penOrientation, perspectiveDirections, perspectiveGuideLines, pointerToPenPoint, rand01, randSigned, readPath, renderBrushThumbnail, renderColorWheel, renderPaper, rgbToHexColor, rgbToHsl, rgbToHsv, samplePressure, screenToDocument, seedFromString, serializePaintDocument, serializePaintDocumentExternal, strokeBounds, strokeDuration, strokeSchedule, sweepPath, symmetryAxisAngles, symmetryAxisSegments, symmetryCopies, thumbnailStroke, tiltToOrientation, toStrokePoint, variationAffine, varyStroke, viewCssTransform, viewMatrix, viewPenToDocument, wheelAngle, wheelPick, wheelPoint, wheelToHue };