@pixerate/editor 0.104.0 → 0.106.0

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

@@ -1,9 +1,9 @@
-import { R as RasterLayer, a as RasterGroupLayer, b as RasterPixelLayer, C as CompositorLayer, c as RasterCompositor, d as RasterSources, L as LayerLocks } from '../compositor-CTMU-B1t.cjs';
-import { B as BrushSettings, M as MixerSettings, C as CoverageMap, D as Dab, S as StrokePoint, a as MixerLoad } from '../mixer-DGcH6HLu.cjs';
-export { b as MAX_BRUSH_SIZE } from '../mixer-DGcH6HLu.cjs';
-import { R as RasterRect, a as TiledSurface, B as BlendMode } from '../surface-AfHCH7BR.cjs';
-export { b as Tile } from '../surface-AfHCH7BR.cjs';
-import { I as ImageEditorAssetStore, S as SerializedLayer, P as PsdExportResult } from '../export-X9rY79p0.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-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 { a as AgentToolProvider } from '../registry-BqA1AZt0.cjs';
 import '../types-CwMPoRMU.cjs';
 import '../warp-D5jz_tN7.cjs';
@@ -203,12 +203,14 @@ interface PaintBrush {
 }
 declare function normalizeDynamics(raw?: Partial<BrushDynamics>, base?: BrushDynamics): BrushDynamics;
 declare const BRUSH_ID: RegExp;
-/** A brush with every field in range; missing fields come from `base` (default: a plain round dab brush). */
-declare function normalizePaintBrush(raw?: Partial<Omit<PaintBrush, 'tip' | 'dynamics' | 'mixer'>> & {
+/** Brush settings to change or read: any subset of a brush, its tip, dynamics and mixer. */
+type PaintBrushInput = Partial<Omit<PaintBrush, 'tip' | 'dynamics' | 'mixer'>> & {
     tip?: Partial<BrushSettings>;
     dynamics?: Partial<BrushDynamics>;
     mixer?: Partial<MixerSettings>;
-}, base?: PaintBrush): PaintBrush;
+};
+/** A brush with every field in range; missing fields come from `base` (default: a plain round dab brush). */
+declare function normalizePaintBrush(raw?: PaintBrushInput, base?: PaintBrush): PaintBrush;
 /** The built-in brush library. */
 declare const BUILTIN_BRUSHES: readonly PaintBrush[];
 declare const DEFAULT_BRUSH_ID = "pencil-6b";
@@ -823,6 +825,17 @@ type ImageEncoder = (image: {
 }, format: 'image/jpeg' | 'image/webp', quality: number) => Promise<Uint8Array>;
 /** An encoder through `OffscreenCanvas`, or `null` where there is none (Node, tests). */
 declare function defaultImageEncoder(): ImageEncoder | null;
+/**
+ * Decodes an image file (PNG, JPEG, WebP, … whatever the browser reads) into RGBA pixels through
+ * `createImageBitmap` and an `OffscreenCanvas`. Browser and Worker only.
+ */
+declare function decodeImageBlob(blob: Blob): Promise<{
+    width: number;
+    height: number;
+    data: Uint8ClampedArray;
+}>;
+/** Saves bytes as a file through a temporary link. Browser only. */
+declare function downloadBytes(bytes: Uint8Array | string, fileName: string, mimeType: string): void;
 
 /**
  * Brush thumbnails: a test stroke (an S-curve with pressure swelling and fading, at a steady
@@ -1137,7 +1150,7 @@ interface PaintStrokeInit {
     /** Default the active brush. */
     brushId?: string;
     /** Changes to the brush for this stroke only. */
-    brush?: Parameters<typeof normalizePaintBrush>[0];
+    brush?: PaintBrushInput;
     /** Jitter seed (default: a new one per stroke). */
     seed?: number;
     /** Extra copies of the stroke as affine maps (default: the symmetry guide's). */
@@ -1307,12 +1320,12 @@ declare class PaintEditorController {
      */
     setBrush(update?: {
         id?: string;
-    } & Omit<Parameters<typeof normalizePaintBrush>[0], 'id'>): PaintBrush;
+    } & Omit<PaintBrushInput, 'id'>): PaintBrush;
     /** Saves the active brush (or `brush`) into the user library under `id` / `name`. */
     saveBrush(options: {
         id: string;
         name?: string;
-        brush?: Parameters<typeof normalizePaintBrush>[0];
+        brush?: PaintBrushInput;
     }): PaintBrush;
     removeBrush(id: string): void;
     /** The user's saved brushes. */
@@ -1536,4 +1549,132 @@ interface PaintEditorToolProviderOptions {
 /** Agent tools for one paint editor. */
 declare function createPaintEditorToolProvider(controller: PaintEditorController, options?: PaintEditorToolProviderOptions): AgentToolProvider;
 
-export { type Affine, BRUSH_ID, BRUSH_ROTATIONS, BUILTIN_BRUSHES, 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, PAPER_FAMILIES, PAPER_LIBRARY, PAPER_NODE_ID, type PaintAssetStore, type PaintBrush, type PaintBrushCategory, type PaintBrushEngine, type PaintCanvas, PaintDocumentError, type PaintDocumentExtensions, type PaintDocumentState, PaintEditorController, PaintEditorError, type PaintEditorOptions, type PaintEditorState, type PaintEditorToolProviderOptions, type PaintGroupLayer, type PaintGuides, type PaintLayer, type PaintLayerInfo, type PaintPixelLayer, type PaintStrokeInit, type PaintStrokeResult, PaintStrokeSession, 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 StrokeCopy, type StrokeSessionHost, type StrokeSessionInit, type StrokeVariation, type Swatch, type SymmetryGuide, type SymmetryMode, TRACING_NODE_ID, TileableNoise, type TracingImage, type ViewLayer, affineCopy, applyAffine, brushToJSON, clonePaper, colorHarmony, composeAffine, createPaintCompositor, createPaintDocument, createPaintEditorToolProvider, createPaintLayer, defaultGuides, defaultImageEncoder, deserializePaintDocument, deserializePaintDocumentAsync, documentExtensions, documentToScreen, downsampleRgba, fitZoom, grainCatch, grainHeights, 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, penOrientation, perspectiveDirections, perspectiveGuideLines, pointerToPenPoint, rand01, randSigned, renderBrushThumbnail, renderPaper, rgbToHexColor, rgbToHsl, rgbToHsv, samplePressure, screenToDocument, seedFromString, serializePaintDocument, serializePaintDocumentExternal, strokeBounds, symmetryAxisAngles, symmetryAxisSegments, symmetryCopies, thumbnailStroke, tiltToOrientation, toStrokePoint, variationAffine, varyStroke, viewCssTransform, viewMatrix, viewPenToDocument, wheelToHue };
+/**
+ * Framework-free UI logic shared by the React and Svelte paint editors, so both behave the same:
+ *
+ * - `PaintGesture` turns pointer events (structurally typed, no DOM import) into strokes (with
+ *   coalesced samples and a predicted tail), colour picks, pans, view rotation and zoom, with palm
+ *   rejection while a pen is down.
+ * - `PaintCanvasPresenter` keeps a document-sized 2D canvas up to date from the compositor,
+ *   uploading only the tiles that changed.
+ * - Guide overlays as line segments, and the slider tables of the brush and paper panels.
+ */
+
+/** The Pointer Event fields the gesture reads. */
+interface PaintPointerEvent extends PointerSample {
+    pointerId: number;
+    clientX: number;
+    clientY: number;
+    button?: number;
+    buttons?: number;
+    shiftKey?: boolean;
+    altKey?: boolean;
+    ctrlKey?: boolean;
+    metaKey?: boolean;
+    getCoalescedEvents?(): PaintPointerEvent[];
+    getPredictedEvents?(): PaintPointerEvent[];
+}
+type PaintTool = 'brush' | 'eyedropper' | 'pan' | 'rotate';
+declare const PAINT_TOOLS: ReadonlyArray<{
+    id: PaintTool;
+    label: string;
+    key: string;
+}>;
+/** Where the viewport element is on screen and how big it is (CSS pixels). */
+interface ViewportBox {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+declare class PaintGesture {
+    private readonly controller;
+    private readonly box;
+    tool: PaintTool;
+    /** The last refusal (a hidden or locked layer), for the editor to show. */
+    error: string | null;
+    /** The predicted tail of the current stroke in document pixels (draw it as a thin preview). */
+    predicted: PenPoint[];
+    private mode;
+    private penAt;
+    private penDown;
+    constructor(controller: PaintEditorController, box: () => ViewportBox);
+    private doc;
+    private pen;
+    /** Pointer down; returns true when the gesture took the pointer (capture it). */
+    down(e: PaintPointerEvent): boolean;
+    private pick;
+    move(e: PaintPointerEvent): void;
+    up(e: PaintPointerEvent): void;
+    cancel(): void;
+    get active(): boolean;
+    /** Wheel: zoom about the pointer (Ctrl / pinch or plain wheel), Shift+wheel rotates the view. */
+    wheel(e: {
+        clientX: number;
+        clientY: number;
+        deltaY: number;
+        shiftKey?: boolean;
+    }): void;
+}
+/** Keyboard shortcuts shared by both editors; returns true when it handled the key. */
+declare function handlePaintShortcut(controller: PaintEditorController, gesture: PaintGesture, e: {
+    key: string;
+    ctrlKey?: boolean;
+    metaKey?: boolean;
+    shiftKey?: boolean;
+    target?: unknown;
+}): boolean;
+/** The 2D context methods the presenter uses (a `CanvasRenderingContext2D`). */
+interface Paint2DContext {
+    createImageData(width: number, height: number): {
+        data: Uint8ClampedArray;
+    };
+    putImageData(image: never, dx: number, dy: number, sx?: number, sy?: number, sw?: number, sh?: number): void;
+}
+/** Keeps a document-sized canvas in step with the controller, tile by tile. */
+declare class PaintCanvasPresenter {
+    private readonly controller;
+    private readonly uploaded;
+    private scratch;
+    private size;
+    constructor(controller: PaintEditorController);
+    /** Draws what changed into `ctx` (a canvas the size of the document); returns the tiles drawn. */
+    render(ctx: Paint2DContext): number;
+}
+/** Lines to draw over the canvas for the guides, in document pixels, with a style key. */
+declare function guideOverlay(controller: PaintEditorController): Array<{
+    from: Point2;
+    to: Point2;
+    kind: 'symmetry' | 'perspective' | 'snap';
+}>;
+/** One slider of a panel: a path into the brush (or paper) settings. */
+interface SliderControl {
+    path: string;
+    label: string;
+    min: number;
+    max: number;
+    step: number;
+}
+declare const BRUSH_SLIDERS: readonly SliderControl[];
+declare const PAPER_SLIDERS: readonly SliderControl[];
+/** Reads `a.b` from an object. */
+declare function readPath(obj: unknown, path: string): number;
+/** `{a: {b: value}}` for `a.b`, keeping the rest of `obj`'s `a`. */
+declare function patchPath(obj: Record<string, unknown>, path: string, value: number): Record<string, unknown>;
+/** The point on a colour wheel of `radius` (centre 0, 0) for a wheel angle in degrees, red at the top. */
+declare function wheelPoint(angle: number, radius: number): Point2;
+/** The wheel angle (degrees, red at the top, clockwise) of a point relative to the wheel centre. */
+declare function wheelAngle(x: number, y: number): number;
+/**
+ * A hue ring for a colour wheel, `size × size` RGBA: hues at full saturation and value between
+ * `inner` and 1 of the radius, red at the top, laid out on the RYB or RGB wheel.
+ */
+declare function renderColorWheel(size: number, wheel: ColorWheel, inner?: number): {
+    width: number;
+    height: number;
+    data: Uint8ClampedArray;
+};
+/** 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;
+
+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 };

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

@@ -1,9 +1,9 @@
-import { R as RasterLayer, a as RasterGroupLayer, b as RasterPixelLayer, C as CompositorLayer, c as RasterCompositor, d as RasterSources, L as LayerLocks } from '../compositor-B1ZrKR89.js';
-import { B as BrushSettings, M as MixerSettings, C as CoverageMap, D as Dab, S as StrokePoint, a as MixerLoad } from '../mixer-DG_9Yu2W.js';
-export { b as MAX_BRUSH_SIZE } from '../mixer-DG_9Yu2W.js';
-import { R as RasterRect, a as TiledSurface, B as BlendMode } from '../surface-AfHCH7BR.js';
-export { b as Tile } from '../surface-AfHCH7BR.js';
-import { I as ImageEditorAssetStore, S as SerializedLayer, P as PsdExportResult } from '../export-BLpMyCYg.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-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 { a as AgentToolProvider } from '../registry-D-4fit9C.js';
 import '../types-CwMPoRMU.js';
 import '../warp-CWHZzE3x.js';
@@ -203,12 +203,14 @@ interface PaintBrush {
 }
 declare function normalizeDynamics(raw?: Partial<BrushDynamics>, base?: BrushDynamics): BrushDynamics;
 declare const BRUSH_ID: RegExp;
-/** A brush with every field in range; missing fields come from `base` (default: a plain round dab brush). */
-declare function normalizePaintBrush(raw?: Partial<Omit<PaintBrush, 'tip' | 'dynamics' | 'mixer'>> & {
+/** Brush settings to change or read: any subset of a brush, its tip, dynamics and mixer. */
+type PaintBrushInput = Partial<Omit<PaintBrush, 'tip' | 'dynamics' | 'mixer'>> & {
     tip?: Partial<BrushSettings>;
     dynamics?: Partial<BrushDynamics>;
     mixer?: Partial<MixerSettings>;
-}, base?: PaintBrush): PaintBrush;
+};
+/** A brush with every field in range; missing fields come from `base` (default: a plain round dab brush). */
+declare function normalizePaintBrush(raw?: PaintBrushInput, base?: PaintBrush): PaintBrush;
 /** The built-in brush library. */
 declare const BUILTIN_BRUSHES: readonly PaintBrush[];
 declare const DEFAULT_BRUSH_ID = "pencil-6b";
@@ -823,6 +825,17 @@ type ImageEncoder = (image: {
 }, format: 'image/jpeg' | 'image/webp', quality: number) => Promise<Uint8Array>;
 /** An encoder through `OffscreenCanvas`, or `null` where there is none (Node, tests). */
 declare function defaultImageEncoder(): ImageEncoder | null;
+/**
+ * Decodes an image file (PNG, JPEG, WebP, … whatever the browser reads) into RGBA pixels through
+ * `createImageBitmap` and an `OffscreenCanvas`. Browser and Worker only.
+ */
+declare function decodeImageBlob(blob: Blob): Promise<{
+    width: number;
+    height: number;
+    data: Uint8ClampedArray;
+}>;
+/** Saves bytes as a file through a temporary link. Browser only. */
+declare function downloadBytes(bytes: Uint8Array | string, fileName: string, mimeType: string): void;
 
 /**
  * Brush thumbnails: a test stroke (an S-curve with pressure swelling and fading, at a steady
@@ -1137,7 +1150,7 @@ interface PaintStrokeInit {
     /** Default the active brush. */
     brushId?: string;
     /** Changes to the brush for this stroke only. */
-    brush?: Parameters<typeof normalizePaintBrush>[0];
+    brush?: PaintBrushInput;
     /** Jitter seed (default: a new one per stroke). */
     seed?: number;
     /** Extra copies of the stroke as affine maps (default: the symmetry guide's). */
@@ -1307,12 +1320,12 @@ declare class PaintEditorController {
      */
     setBrush(update?: {
         id?: string;
-    } & Omit<Parameters<typeof normalizePaintBrush>[0], 'id'>): PaintBrush;
+    } & Omit<PaintBrushInput, 'id'>): PaintBrush;
     /** Saves the active brush (or `brush`) into the user library under `id` / `name`. */
     saveBrush(options: {
         id: string;
         name?: string;
-        brush?: Parameters<typeof normalizePaintBrush>[0];
+        brush?: PaintBrushInput;
     }): PaintBrush;
     removeBrush(id: string): void;
     /** The user's saved brushes. */
@@ -1536,4 +1549,132 @@ interface PaintEditorToolProviderOptions {
 /** Agent tools for one paint editor. */
 declare function createPaintEditorToolProvider(controller: PaintEditorController, options?: PaintEditorToolProviderOptions): AgentToolProvider;
 
-export { type Affine, BRUSH_ID, BRUSH_ROTATIONS, BUILTIN_BRUSHES, 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, PAPER_FAMILIES, PAPER_LIBRARY, PAPER_NODE_ID, type PaintAssetStore, type PaintBrush, type PaintBrushCategory, type PaintBrushEngine, type PaintCanvas, PaintDocumentError, type PaintDocumentExtensions, type PaintDocumentState, PaintEditorController, PaintEditorError, type PaintEditorOptions, type PaintEditorState, type PaintEditorToolProviderOptions, type PaintGroupLayer, type PaintGuides, type PaintLayer, type PaintLayerInfo, type PaintPixelLayer, type PaintStrokeInit, type PaintStrokeResult, PaintStrokeSession, 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 StrokeCopy, type StrokeSessionHost, type StrokeSessionInit, type StrokeVariation, type Swatch, type SymmetryGuide, type SymmetryMode, TRACING_NODE_ID, TileableNoise, type TracingImage, type ViewLayer, affineCopy, applyAffine, brushToJSON, clonePaper, colorHarmony, composeAffine, createPaintCompositor, createPaintDocument, createPaintEditorToolProvider, createPaintLayer, defaultGuides, defaultImageEncoder, deserializePaintDocument, deserializePaintDocumentAsync, documentExtensions, documentToScreen, downsampleRgba, fitZoom, grainCatch, grainHeights, 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, penOrientation, perspectiveDirections, perspectiveGuideLines, pointerToPenPoint, rand01, randSigned, renderBrushThumbnail, renderPaper, rgbToHexColor, rgbToHsl, rgbToHsv, samplePressure, screenToDocument, seedFromString, serializePaintDocument, serializePaintDocumentExternal, strokeBounds, symmetryAxisAngles, symmetryAxisSegments, symmetryCopies, thumbnailStroke, tiltToOrientation, toStrokePoint, variationAffine, varyStroke, viewCssTransform, viewMatrix, viewPenToDocument, wheelToHue };
+/**
+ * Framework-free UI logic shared by the React and Svelte paint editors, so both behave the same:
+ *
+ * - `PaintGesture` turns pointer events (structurally typed, no DOM import) into strokes (with
+ *   coalesced samples and a predicted tail), colour picks, pans, view rotation and zoom, with palm
+ *   rejection while a pen is down.
+ * - `PaintCanvasPresenter` keeps a document-sized 2D canvas up to date from the compositor,
+ *   uploading only the tiles that changed.
+ * - Guide overlays as line segments, and the slider tables of the brush and paper panels.
+ */
+
+/** The Pointer Event fields the gesture reads. */
+interface PaintPointerEvent extends PointerSample {
+    pointerId: number;
+    clientX: number;
+    clientY: number;
+    button?: number;
+    buttons?: number;
+    shiftKey?: boolean;
+    altKey?: boolean;
+    ctrlKey?: boolean;
+    metaKey?: boolean;
+    getCoalescedEvents?(): PaintPointerEvent[];
+    getPredictedEvents?(): PaintPointerEvent[];
+}
+type PaintTool = 'brush' | 'eyedropper' | 'pan' | 'rotate';
+declare const PAINT_TOOLS: ReadonlyArray<{
+    id: PaintTool;
+    label: string;
+    key: string;
+}>;
+/** Where the viewport element is on screen and how big it is (CSS pixels). */
+interface ViewportBox {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+declare class PaintGesture {
+    private readonly controller;
+    private readonly box;
+    tool: PaintTool;
+    /** The last refusal (a hidden or locked layer), for the editor to show. */
+    error: string | null;
+    /** The predicted tail of the current stroke in document pixels (draw it as a thin preview). */
+    predicted: PenPoint[];
+    private mode;
+    private penAt;
+    private penDown;
+    constructor(controller: PaintEditorController, box: () => ViewportBox);
+    private doc;
+    private pen;
+    /** Pointer down; returns true when the gesture took the pointer (capture it). */
+    down(e: PaintPointerEvent): boolean;
+    private pick;
+    move(e: PaintPointerEvent): void;
+    up(e: PaintPointerEvent): void;
+    cancel(): void;
+    get active(): boolean;
+    /** Wheel: zoom about the pointer (Ctrl / pinch or plain wheel), Shift+wheel rotates the view. */
+    wheel(e: {
+        clientX: number;
+        clientY: number;
+        deltaY: number;
+        shiftKey?: boolean;
+    }): void;
+}
+/** Keyboard shortcuts shared by both editors; returns true when it handled the key. */
+declare function handlePaintShortcut(controller: PaintEditorController, gesture: PaintGesture, e: {
+    key: string;
+    ctrlKey?: boolean;
+    metaKey?: boolean;
+    shiftKey?: boolean;
+    target?: unknown;
+}): boolean;
+/** The 2D context methods the presenter uses (a `CanvasRenderingContext2D`). */
+interface Paint2DContext {
+    createImageData(width: number, height: number): {
+        data: Uint8ClampedArray;
+    };
+    putImageData(image: never, dx: number, dy: number, sx?: number, sy?: number, sw?: number, sh?: number): void;
+}
+/** Keeps a document-sized canvas in step with the controller, tile by tile. */
+declare class PaintCanvasPresenter {
+    private readonly controller;
+    private readonly uploaded;
+    private scratch;
+    private size;
+    constructor(controller: PaintEditorController);
+    /** Draws what changed into `ctx` (a canvas the size of the document); returns the tiles drawn. */
+    render(ctx: Paint2DContext): number;
+}
+/** Lines to draw over the canvas for the guides, in document pixels, with a style key. */
+declare function guideOverlay(controller: PaintEditorController): Array<{
+    from: Point2;
+    to: Point2;
+    kind: 'symmetry' | 'perspective' | 'snap';
+}>;
+/** One slider of a panel: a path into the brush (or paper) settings. */
+interface SliderControl {
+    path: string;
+    label: string;
+    min: number;
+    max: number;
+    step: number;
+}
+declare const BRUSH_SLIDERS: readonly SliderControl[];
+declare const PAPER_SLIDERS: readonly SliderControl[];
+/** Reads `a.b` from an object. */
+declare function readPath(obj: unknown, path: string): number;
+/** `{a: {b: value}}` for `a.b`, keeping the rest of `obj`'s `a`. */
+declare function patchPath(obj: Record<string, unknown>, path: string, value: number): Record<string, unknown>;
+/** The point on a colour wheel of `radius` (centre 0, 0) for a wheel angle in degrees, red at the top. */
+declare function wheelPoint(angle: number, radius: number): Point2;
+/** The wheel angle (degrees, red at the top, clockwise) of a point relative to the wheel centre. */
+declare function wheelAngle(x: number, y: number): number;
+/**
+ * A hue ring for a colour wheel, `size × size` RGBA: hues at full saturation and value between
+ * `inner` and 1 of the radius, red at the top, laid out on the RYB or RGB wheel.
+ */
+declare function renderColorWheel(size: number, wheel: ColorWheel, inner?: number): {
+    width: number;
+    height: number;
+    data: Uint8ClampedArray;
+};
+/** 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;
+
+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 };