@pixerate/editor 0.252.0 → 0.254.0

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

@@ -9,11 +9,14 @@
  * as new assets keyed by layer id without breaking older readers (see `PaintDocumentExtensions`).
  */
 import { type ImageEditorAssetStore, type SerializedLayer } from '../image-editor/layers/serialize.cjs';
-import { type RecordedStroke } from './strokes.cjs';
+import { strokeToJSON } from './strokes.cjs';
 import { type PaintDocumentState } from './document.cjs';
 import { type PaperSettings } from './paper.cjs';
 export declare const PAINT_FORMAT: "pixerate-paint";
-export declare const PAINT_SCHEMA_VERSION: 1;
+/** 2: recorded strokes keep facet brushes (version 1 documents, with flat engine brushes, still load). */
+export declare const PAINT_SCHEMA_VERSION: 2;
+/** A recorded stroke as a document stores it (`strokeToJSON`). */
+export type SerializedStroke = ReturnType<typeof strokeToJSON>;
 /** Where a host keeps layer PNGs outside the JSON (the image editor's asset store contract). */
 export type PaintAssetStore = ImageEditorAssetStore;
 /**
@@ -34,8 +37,8 @@ export interface SerializedPaintDocument {
     /** Asset id → PNG data URL (or an external reference). */
     assets: Record<string, string>;
     activeLayerId: string | null;
-    /** Recorded strokes (strokes are data), oldest first; missing when saved without them. */
-    strokes?: RecordedStroke[];
+    /** Recorded strokes (strokes are data), oldest first, each brush a facet `Brush`; missing when saved without them. */
+    strokes?: SerializedStroke[];
     /** Everything else (document-level state of later phases), written back as read. */
     [extension: string]: unknown;
 }

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

@@ -9,11 +9,14 @@
  * as new assets keyed by layer id without breaking older readers (see `PaintDocumentExtensions`).
  */
 import { type ImageEditorAssetStore, type SerializedLayer } from '../image-editor/layers/serialize.js';
-import { type RecordedStroke } from './strokes.js';
+import { strokeToJSON } from './strokes.js';
 import { type PaintDocumentState } from './document.js';
 import { type PaperSettings } from './paper.js';
 export declare const PAINT_FORMAT: "pixerate-paint";
-export declare const PAINT_SCHEMA_VERSION: 1;
+/** 2: recorded strokes keep facet brushes (version 1 documents, with flat engine brushes, still load). */
+export declare const PAINT_SCHEMA_VERSION: 2;
+/** A recorded stroke as a document stores it (`strokeToJSON`). */
+export type SerializedStroke = ReturnType<typeof strokeToJSON>;
 /** Where a host keeps layer PNGs outside the JSON (the image editor's asset store contract). */
 export type PaintAssetStore = ImageEditorAssetStore;
 /**
@@ -34,8 +37,8 @@ export interface SerializedPaintDocument {
     /** Asset id → PNG data URL (or an external reference). */
     assets: Record<string, string>;
     activeLayerId: string | null;
-    /** Recorded strokes (strokes are data), oldest first; missing when saved without them. */
-    strokes?: RecordedStroke[];
+    /** Recorded strokes (strokes are data), oldest first, each brush a facet `Brush`; missing when saved without them. */
+    strokes?: SerializedStroke[];
     /** Everything else (document-level state of later phases), written back as read. */
     [extension: string]: unknown;
 }

package/dist/paint-editor/sticker-tools.d.cts

@@ -1,5 +1,5 @@
 /**
- * Agent tools for stickers: stamps sprayed with a sticker brush (`paint_stroke`, list_brushes
+ * Agent tools for stickers: stamps sprayed with a sticker brush (`paint_stroke`, list_brush_presets
  * category sticker) stay objects on their layer, which these tools list, move, turn, resize,
  * recolour, reorder and delete, find by point (`sticker_at`), and places new ones exactly (`add_stickers`). Each change is one undo step and redraws the layer.
  */

package/dist/paint-editor/sticker-tools.d.ts

@@ -1,5 +1,5 @@
 /**
- * Agent tools for stickers: stamps sprayed with a sticker brush (`paint_stroke`, list_brushes
+ * Agent tools for stickers: stamps sprayed with a sticker brush (`paint_stroke`, list_brush_presets
  * category sticker) stay objects on their layer, which these tools list, move, turn, resize,
  * recolour, reorder and delete, find by point (`sticker_at`), and places new ones exactly (`add_stickers`). Each change is one undo step and redraws the layer.
  */

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

@@ -2,8 +2,13 @@
  * Strokes as data. Every committed stroke is recorded with the brush, colour, raw pen samples,
  * jitter seed and symmetry copies it was painted with, so it replays to the same pixels, and can
  * be replayed moved, scaled, rotated, recoloured or with another brush (`replay_strokes`).
+ *
+ * In memory a stroke keeps its brush as the engine painted it. Saved, the brush is a facet brush
+ * (`strokeToJSON`, documents of version 2); strokes saved with the flat engine brush (version 1)
+ * still read, and both replay to the same pixels.
  */
 import { type PaintBrush } from './brushes.cjs';
+import type { Brush } from '../brushes/types.cjs';
 import type { PenPoint, StrokeCopy } from './engine.cjs';
 import type { MixerLoad } from '../paint/exchange.cjs';
 import { type Stencil } from './stencils.cjs';
@@ -46,7 +51,11 @@ export declare function invertAffine(m: Affine): Affine;
 export declare function mapPenPoint(m: Affine, p: PenPoint): PenPoint;
 /** An affine copy as the engine's `StrokeCopy`. */
 export declare function affineCopy(m: Affine): StrokeCopy;
-/** A recorded stroke read from JSON, or `null` when it is not one. */
+/** A recorded stroke as saved: plain JSON with its brush as a facet brush. */
+export declare function strokeToJSON(stroke: RecordedStroke): Omit<RecordedStroke, 'brush'> & {
+    brush: Brush;
+};
+/** A recorded stroke read from JSON (its brush version 1 or 2), or `null` when it is not one. */
 export declare function normalizeBrushStroke(raw: unknown): RecordedStroke | null;
 /** The bounding box of a stroke's points. */
 export declare function strokeBounds(points: readonly PenPoint[]): {

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

@@ -2,8 +2,13 @@
  * Strokes as data. Every committed stroke is recorded with the brush, colour, raw pen samples,
  * jitter seed and symmetry copies it was painted with, so it replays to the same pixels, and can
  * be replayed moved, scaled, rotated, recoloured or with another brush (`replay_strokes`).
+ *
+ * In memory a stroke keeps its brush as the engine painted it. Saved, the brush is a facet brush
+ * (`strokeToJSON`, documents of version 2); strokes saved with the flat engine brush (version 1)
+ * still read, and both replay to the same pixels.
  */
 import { type PaintBrush } from './brushes.js';
+import type { Brush } from '../brushes/types.js';
 import type { PenPoint, StrokeCopy } from './engine.js';
 import type { MixerLoad } from '../paint/exchange.js';
 import { type Stencil } from './stencils.js';
@@ -46,7 +51,11 @@ export declare function invertAffine(m: Affine): Affine;
 export declare function mapPenPoint(m: Affine, p: PenPoint): PenPoint;
 /** An affine copy as the engine's `StrokeCopy`. */
 export declare function affineCopy(m: Affine): StrokeCopy;
-/** A recorded stroke read from JSON, or `null` when it is not one. */
+/** A recorded stroke as saved: plain JSON with its brush as a facet brush. */
+export declare function strokeToJSON(stroke: RecordedStroke): Omit<RecordedStroke, 'brush'> & {
+    brush: Brush;
+};
+/** A recorded stroke read from JSON (its brush version 1 or 2), or `null` when it is not one. */
 export declare function normalizeBrushStroke(raw: unknown): RecordedStroke | null;
 /** The bounding box of a stroke's points. */
 export declare function strokeBounds(points: readonly PenPoint[]): {

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

@@ -1,7 +1,7 @@
 /**
  * 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)
- * and returns what it changed; ids come from the read tools (`list_layers`, `list_brushes`,
+ * and returns what it changed; ids come from the read tools (`list_layers`, the brush library's `list_brush_presets`,
  * `list_papers`, `list_strokes`).
  */
 import type { AgentToolProvider } from '../tools/registry.cjs';

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

@@ -1,7 +1,7 @@
 /**
  * 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)
- * and returns what it changed; ids come from the read tools (`list_layers`, `list_brushes`,
+ * and returns what it changed; ids come from the read tools (`list_layers`, the brush library's `list_brush_presets`,
  * `list_papers`, `list_strokes`).
  */
 import type { AgentToolProvider } from '../tools/registry.js';

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

@@ -10,7 +10,7 @@
  */
 import type { MixerLoad } from '../paint/exchange.cjs';
 import { type BlendModeInfo } from '../raster/blend.cjs';
-import type { ImpastoTool, PaintBrush, PaintBrushInput, WetMediumKind, WetTool } from './brushes.cjs';
+import type { ImpastoTool, WetMediumKind, WetTool } from './brushes.cjs';
 import type { PaintEditorController } from './controller.cjs';
 import type { PenPoint } from './engine.cjs';
 import { type Point2 } from './guides.cjs';
@@ -133,15 +133,8 @@ export declare function guideOverlay(controller: PaintEditorController, drag?: {
     to: Point2;
     kind: GuideOverlayKind;
 }>;
-/** One slider of a panel: a path into the brush (or paper) settings. */
-export interface SliderControl {
-    path: string;
-    label: string;
-    min: number;
-    max: number;
-    step: number;
-}
-export declare const BRUSH_SLIDERS: readonly SliderControl[];
+export { BRUSH_SLIDERS, brushEngineControls, multiColorSliders, patchBrushValue, type BrushEngineControls, type SliderControl } from './brush-controls.cjs';
+import type { SliderControl } from './brush-controls.cjs';
 export declare const PAPER_SLIDERS: readonly SliderControl[];
 /** Reads `a.b` from an object. */
 export declare function readPath(obj: unknown, path: string): number;
@@ -174,47 +167,6 @@ export interface BlendMenuGroup {
  */
 export declare const BLEND_MENU_GROUPS: readonly BlendMenuGroup[];
 /** The engine-specific part of the brush panel: which sliders and toggles the active brush has. */
-export interface BrushEngineControls {
-    /** Section heading. */
-    title: string;
-    sliders: readonly SliderControl[];
-    /** Where the RGB / pigment choice is stored, or `null` when the engine has none. */
-    mixingPath: 'behavior.mixing' | 'blender.mixing' | 'smudge.mixing' | null;
-    /** The dirty-brush toggle (`behavior.dirty`). */
-    dirty: boolean;
-    /** The multi-colour controls (`behavior.multicolor`; the panels show the brush gradient, `brush.paint`, instead). */
-    multicolor: boolean;
-    /** Load / Clean buttons and a swatch of what the brush carries. */
-    load: boolean;
-    /** The wet tool menu (`wet.tool`, `WET_TOOLS`) and medium menu (`wet.medium`, `WET_MEDIA`). */
-    wetTool?: boolean;
-    /** The impasto tool menu (`impasto.tool`, `IMPASTO_TOOLS`). */
-    impastoTool?: boolean;
-    /**
-     * The particle menus: kind and render (`particle.kind`, `particle.render`), ribbon pairs
-     * (`particle.ribbonPairs`), and the textured-dot stamps, order and rotation
-     * (`particle.dotTextures` up to `MAX_DOT_TEXTURES` of `STAMP_KINDS`, `dotTextureOrder`, `dotRotation`).
-     */
-    particleMenus?: boolean;
-    /** The sticker picker for the brush's stickers (`sticker.stamps`, refs from the sticker library; `toggleStickerRef`). */
-    stickerStamps?: boolean;
-    /** Light paint: the "light follows pressure" toggle (`light.pressure`); the Light slider is in `sliders`. */
-    light?: boolean;
-}
-/**
- * The controls the active brush's engine adds to the brush panel (`null` for the eraser):
- * blender strength and blend distance; smudge strength and length; the Mixer Brush's pick-up,
- * mix and load; a dab brush's pick-up and mix ratios. Every engine but the eraser has an RGB /
- * pigment choice; dab and mixer brushes also have the dirty and multi-colour controls. Pick-up
- * and mix always go through `behavior`, which keeps a Mixer Brush's `mixer` block in sync.
- */
-export declare function brushEngineControls(brush: Pick<PaintBrush, 'engine'> & {
-    wet?: PaintBrush['wet'];
-}): BrushEngineControls | null;
-/** The multi-colour sliders for a mode: softness, and dabs per colour in `dab` mode. */
-export declare function multiColorSliders(mode: string): readonly SliderControl[];
-/** A brush change setting `path` (e.g. `smudge.mixing`, `behavior.dirty`) to any value, keeping the rest of its block. */
-export declare function patchBrushValue(brush: PaintBrush, path: string, value: unknown): PaintBrushInput;
 /** What the brush carries (picked-up paint, else loaded paint) as #rrggbb, or `null` when it is clean and empty. */
 export declare function brushLoadColor(load: MixerLoad): string | null;
 /** Sample sizes (square, in pad pixels) for picking from the mixing pad. */

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

@@ -10,7 +10,7 @@
  */
 import type { MixerLoad } from '../paint/exchange.js';
 import { type BlendModeInfo } from '../raster/blend.js';
-import type { ImpastoTool, PaintBrush, PaintBrushInput, WetMediumKind, WetTool } from './brushes.js';
+import type { ImpastoTool, WetMediumKind, WetTool } from './brushes.js';
 import type { PaintEditorController } from './controller.js';
 import type { PenPoint } from './engine.js';
 import { type Point2 } from './guides.js';
@@ -133,15 +133,8 @@ export declare function guideOverlay(controller: PaintEditorController, drag?: {
     to: Point2;
     kind: GuideOverlayKind;
 }>;
-/** One slider of a panel: a path into the brush (or paper) settings. */
-export interface SliderControl {
-    path: string;
-    label: string;
-    min: number;
-    max: number;
-    step: number;
-}
-export declare const BRUSH_SLIDERS: readonly SliderControl[];
+export { BRUSH_SLIDERS, brushEngineControls, multiColorSliders, patchBrushValue, type BrushEngineControls, type SliderControl } from './brush-controls.js';
+import type { SliderControl } from './brush-controls.js';
 export declare const PAPER_SLIDERS: readonly SliderControl[];
 /** Reads `a.b` from an object. */
 export declare function readPath(obj: unknown, path: string): number;
@@ -174,47 +167,6 @@ export interface BlendMenuGroup {
  */
 export declare const BLEND_MENU_GROUPS: readonly BlendMenuGroup[];
 /** The engine-specific part of the brush panel: which sliders and toggles the active brush has. */
-export interface BrushEngineControls {
-    /** Section heading. */
-    title: string;
-    sliders: readonly SliderControl[];
-    /** Where the RGB / pigment choice is stored, or `null` when the engine has none. */
-    mixingPath: 'behavior.mixing' | 'blender.mixing' | 'smudge.mixing' | null;
-    /** The dirty-brush toggle (`behavior.dirty`). */
-    dirty: boolean;
-    /** The multi-colour controls (`behavior.multicolor`; the panels show the brush gradient, `brush.paint`, instead). */
-    multicolor: boolean;
-    /** Load / Clean buttons and a swatch of what the brush carries. */
-    load: boolean;
-    /** The wet tool menu (`wet.tool`, `WET_TOOLS`) and medium menu (`wet.medium`, `WET_MEDIA`). */
-    wetTool?: boolean;
-    /** The impasto tool menu (`impasto.tool`, `IMPASTO_TOOLS`). */
-    impastoTool?: boolean;
-    /**
-     * The particle menus: kind and render (`particle.kind`, `particle.render`), ribbon pairs
-     * (`particle.ribbonPairs`), and the textured-dot stamps, order and rotation
-     * (`particle.dotTextures` up to `MAX_DOT_TEXTURES` of `STAMP_KINDS`, `dotTextureOrder`, `dotRotation`).
-     */
-    particleMenus?: boolean;
-    /** The sticker picker for the brush's stickers (`sticker.stamps`, refs from the sticker library; `toggleStickerRef`). */
-    stickerStamps?: boolean;
-    /** Light paint: the "light follows pressure" toggle (`light.pressure`); the Light slider is in `sliders`. */
-    light?: boolean;
-}
-/**
- * The controls the active brush's engine adds to the brush panel (`null` for the eraser):
- * blender strength and blend distance; smudge strength and length; the Mixer Brush's pick-up,
- * mix and load; a dab brush's pick-up and mix ratios. Every engine but the eraser has an RGB /
- * pigment choice; dab and mixer brushes also have the dirty and multi-colour controls. Pick-up
- * and mix always go through `behavior`, which keeps a Mixer Brush's `mixer` block in sync.
- */
-export declare function brushEngineControls(brush: Pick<PaintBrush, 'engine'> & {
-    wet?: PaintBrush['wet'];
-}): BrushEngineControls | null;
-/** The multi-colour sliders for a mode: softness, and dabs per colour in `dab` mode. */
-export declare function multiColorSliders(mode: string): readonly SliderControl[];
-/** A brush change setting `path` (e.g. `smudge.mixing`, `behavior.dirty`) to any value, keeping the rest of its block. */
-export declare function patchBrushValue(brush: PaintBrush, path: string, value: unknown): PaintBrushInput;
 /** What the brush carries (picked-up paint, else loaded paint) as #rrggbb, or `null` when it is clean and empty. */
 export declare function brushLoadColor(load: MixerLoad): string | null;
 /** Sample sizes (square, in pad pixels) for picking from the mixing pad. */

package/dist/paint-editor/wet-tools.d.cts

@@ -1,6 +1,6 @@
 /**
  * Agent tools for wet media (watercolour and gouache on a simulated wet layer). Wet strokes are
- * painted with `paint_stroke` and a wet brush (`list_brushes` category `watercolor` or
+ * painted with `paint_stroke` and a wet brush (`list_brush_presets` variety `watercolor` or
  * `wet-tool`); these tools read and steer the wet paint. Every result says whether paint is still
  * wet. Settings (wet parameters, flow maps, tilt) are saved with the document but are not undo
  * steps; drying and wetting the paper are.

package/dist/paint-editor/wet-tools.d.ts

@@ -1,6 +1,6 @@
 /**
  * Agent tools for wet media (watercolour and gouache on a simulated wet layer). Wet strokes are
- * painted with `paint_stroke` and a wet brush (`list_brushes` category `watercolor` or
+ * painted with `paint_stroke` and a wet brush (`list_brush_presets` variety `watercolor` or
  * `wet-tool`); these tools read and steer the wet paint. Every result says whether paint is still
  * wet. Settings (wet parameters, flow maps, tilt) are saved with the document but are not undo
  * steps; drying and wetting the paper are.

package/dist/vector/index.cjs

@@ -562,7 +562,7 @@ var _chunkU67EN7GGcjs = require('../chunk-U67EN7GG.cjs');
 
 
 
-var _chunkISIO63Q5cjs = require('../chunk-ISIO63Q5.cjs');
+var _chunkL2JTLW6Bcjs = require('../chunk-L2JTLW6B.cjs');
 require('../chunk-WOFXZ3XU.cjs');
 
 
@@ -7335,7 +7335,7 @@ var VectorEditorController = (_class7 = class _VectorEditorController {
   }
   // --- Provider effects ---
   /** The effects provider slot (see `setEffectsProvider`). */
-  __init59() {this.effects = new (0, _chunkISIO63Q5cjs.EffectsSlot)()}
+  __init59() {this.effects = new (0, _chunkL2JTLW6Bcjs.EffectsSlot)()}
   /** The registered effects provider, or `null`. */
   get effectsProvider() {
     return this.effects.provider;
@@ -7359,10 +7359,10 @@ var VectorEditorController = (_class7 = class _VectorEditorController {
   /** The effect's picture as group children, scaled into `box` (an affine fit). */
   async vectorEffectPicture(effect, values) {
     const provider = this.effects.require();
-    if (!provider.applyVectorEffect) throw new (0, _chunkISIO63Q5cjs.EffectUnsupportedError)(`${provider.name} has no vector effects.`);
+    if (!provider.applyVectorEffect) throw new (0, _chunkL2JTLW6Bcjs.EffectUnsupportedError)(`${provider.name} has no vector effects.`);
     const d = await provider.describe(effect);
-    if (d.kind !== "vector") throw new (0, _chunkISIO63Q5cjs.EffectUnsupportedError)(`"${d.id}" (${d.name}) is a ${d.kind} effect; the vector editor adds vector effects, which bring their own picture${d.kind === "motion" ? " (apply motion in the animation editor)" : ""}.`, d.id);
-    const resolved = _chunkISIO63Q5cjs.resolveEffectValues.call(void 0, d, values);
+    if (d.kind !== "vector") throw new (0, _chunkL2JTLW6Bcjs.EffectUnsupportedError)(`"${d.id}" (${d.name}) is a ${d.kind} effect; the vector editor adds vector effects, which bring their own picture${d.kind === "motion" ? " (apply motion in the animation editor)" : ""}.`, d.id);
+    const resolved = _chunkL2JTLW6Bcjs.resolveEffectValues.call(void 0, d, values);
     const motion = await provider.applyVectorEffect(d.id, this.toSvg(), resolved);
     const parsed = _chunkJPEHXIB5cjs.parseVectorSvg.call(void 0, motion.svg);
     if (!parsed.nodes.length) throw new Error(`"${d.name}" drew no shapes the editor can read.`);
@@ -18179,7 +18179,7 @@ function createVectorEffectsToolProvider(controller, options = {}) {
     const effects = _optionalChain([g, 'optionalAccess', _765 => _765.providerEffect]) ? [info(g)] : [];
     return { target: id, effect: _nullishCoalesce(removed, () => ( effects[0])), effects };
   };
-  return _chunkISIO63Q5cjs.createEffectToolProvider.call(void 0, {
+  return _chunkL2JTLW6Bcjs.createEffectToolProvider.call(void 0, {
     id: _nullishCoalesce(options.id, () => ( "vector-effects")),
     namespace: options.namespace,
     title: "Vector effects",

package/dist/vector/index.js

@@ -562,7 +562,7 @@ import {
   EffectsSlot,
   createEffectToolProvider,
   resolveEffectValues
-} from "../chunk-JA57JIT5.js";
+} from "../chunk-MV7CYFMJ.js";
 import "../chunk-V2ZCJRDM.js";
 import {
   GRAIN_PATTERNS