@lvl99dotcom/paintcanvas 0.0.0-stage → 0.2.0

package/dist/lib/messages/schema.d.ts

@@ -0,0 +1,1775 @@
+import { ImageEncoding, type BoundingBox } from "../image/index.ts";
+import type { BrushConfig, BrushStrokePoint } from "../brushes/types/index.ts";
+/** Version of the drawing message protocol, sent in every message */
+export declare const PROTOCOL_VERSION = 1;
+/** Kinds of drawing message */
+export declare const CanvasMessageType: {
+    /** Pixels of the sender's whole drawing (all their layers, flattened) within an area */
+    readonly Patch: "patch";
+    /** A finished brush or eraser stroke */
+    readonly Stroke: "stroke";
+    /** The sender undid a step */
+    readonly Undo: "undo";
+    /** The sender redid a step */
+    readonly Redo: "redo";
+};
+export type CanvasMessageType = (typeof CanvasMessageType)[keyof typeof CanvasMessageType];
+/** Largest canvas width or height a message may refer to */
+export declare const MAX_MESSAGE_CANVAS_SIZE = 10000;
+/** Most points in one stroke message */
+export declare const MAX_STROKE_POINTS = 100000;
+/** Longest encoded image data in a patch (characters): a whole 10000 × 10000 canvas as base64 RGBA */
+export declare const MAX_PATCH_DATA_LENGTH: number;
+interface BaseCanvasMessage {
+    /** Protocol version (`PROTOCOL_VERSION`) */
+    protocol: typeof PROTOCOL_VERSION;
+}
+/** Pixels of the sender's whole drawing within an area, replacing what was there */
+export interface PatchMessage extends BaseCanvasMessage {
+    type: typeof CanvasMessageType.Patch;
+    /** Area the pixels cover */
+    coords: BoundingBox;
+    encoding: ImageEncoding;
+    /** Encoded image data (base64) */
+    data: string;
+}
+/** A stroke point with the time it was recorded */
+export interface TimedStrokePoint extends BrushStrokePoint {
+    /** Milliseconds, from the same clock as the stroke's other points (e.g. `PointerEvent.timeStamp`) */
+    time: number;
+}
+/** A finished brush or eraser stroke, with everything needed to draw it again */
+export interface StrokeMessage extends BaseCanvasMessage {
+    type: typeof CanvasMessageType.Stroke;
+    /** The history step the stroke made (see undo and redo messages) */
+    step: string;
+    /** ID of the sender's layer it was drawn on */
+    layer: string;
+    mode: "paint" | "erase";
+    /** Brush settings */
+    preset: BrushConfig;
+    /** Size chosen by the user */
+    size: {
+        width: number;
+        height: number;
+    };
+    /** Paint colour as `#rrggbb` */
+    colour: string;
+    /** Whether input came from a pen (pressure and tilt apply) */
+    isPen: boolean;
+    /** Seed for the stroke's random variation, so it draws the same again */
+    seed: number;
+    /** Input points, in order */
+    points: TimedStrokePoint[];
+}
+/** The sender undid or redid a step */
+export interface HistoryMessage extends BaseCanvasMessage {
+    type: typeof CanvasMessageType.Undo | typeof CanvasMessageType.Redo;
+    /** The step undone or redone */
+    step: string;
+}
+/** Any drawing message */
+export type CanvasMessage = PatchMessage | StrokeMessage | HistoryMessage;
+/** JSON schema for the brush settings in a stroke message: a brush preset whose ID can be any name (built-in presets
+ * have names like `round1`, not UUIDs) */
+export declare const strokePresetSchema: {
+    readonly $id: "paintcanvas/stroke-preset";
+    readonly properties: {
+        readonly id: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 100;
+        };
+        readonly name: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 100;
+        };
+        readonly group: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 100;
+        };
+        readonly version: {
+            readonly type: "string";
+            readonly maxLength: 20;
+        };
+        readonly author: {
+            readonly anyOf: readonly [{
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 100;
+            }, {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["name"];
+                readonly properties: {
+                    readonly name: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 100;
+                    };
+                    readonly handle: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 100;
+                    };
+                    readonly email: {
+                        readonly type: "string";
+                        readonly maxLength: 254;
+                    };
+                    readonly website: {
+                        readonly type: "string";
+                        readonly maxLength: 2048;
+                    };
+                };
+            }];
+        };
+        readonly image: {
+            readonly type: "string";
+            readonly pattern: "^data:image/png;base64,[A-Za-z0-9+/]+={0,2}$";
+            readonly maxLength: number;
+        };
+        readonly colourMode: {
+            readonly enum: readonly [0, 1];
+        };
+        readonly hue: {
+            readonly anyOf: readonly [{
+                readonly type: "number";
+            }, {
+                readonly type: "string";
+                readonly maxLength: 20;
+            }];
+        };
+        readonly hueConfig: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly useRandomise: {
+                    readonly type: "boolean";
+                };
+                readonly minRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly usePressure: {
+                    readonly type: "boolean";
+                };
+                readonly minPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly useTilt: {
+                    readonly type: "boolean";
+                };
+                readonly minTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+            };
+        };
+        readonly saturation: {
+            readonly anyOf: readonly [{
+                readonly type: "number";
+            }, {
+                readonly type: "string";
+                readonly maxLength: 20;
+            }];
+        };
+        readonly saturationConfig: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly useRandomise: {
+                    readonly type: "boolean";
+                };
+                readonly minRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly usePressure: {
+                    readonly type: "boolean";
+                };
+                readonly minPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly useTilt: {
+                    readonly type: "boolean";
+                };
+                readonly minTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+            };
+        };
+        readonly lightness: {
+            readonly anyOf: readonly [{
+                readonly type: "number";
+            }, {
+                readonly type: "string";
+                readonly maxLength: 20;
+            }];
+        };
+        readonly lightnessConfig: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly useRandomise: {
+                    readonly type: "boolean";
+                };
+                readonly minRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly usePressure: {
+                    readonly type: "boolean";
+                };
+                readonly minPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly useTilt: {
+                    readonly type: "boolean";
+                };
+                readonly minTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+            };
+        };
+        readonly red: {
+            readonly anyOf: readonly [{
+                readonly type: "number";
+            }, {
+                readonly type: "string";
+                readonly maxLength: 20;
+            }];
+        };
+        readonly redConfig: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly useRandomise: {
+                    readonly type: "boolean";
+                };
+                readonly minRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly usePressure: {
+                    readonly type: "boolean";
+                };
+                readonly minPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly useTilt: {
+                    readonly type: "boolean";
+                };
+                readonly minTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+            };
+        };
+        readonly green: {
+            readonly anyOf: readonly [{
+                readonly type: "number";
+            }, {
+                readonly type: "string";
+                readonly maxLength: 20;
+            }];
+        };
+        readonly greenConfig: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly useRandomise: {
+                    readonly type: "boolean";
+                };
+                readonly minRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly usePressure: {
+                    readonly type: "boolean";
+                };
+                readonly minPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly useTilt: {
+                    readonly type: "boolean";
+                };
+                readonly minTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+            };
+        };
+        readonly blue: {
+            readonly anyOf: readonly [{
+                readonly type: "number";
+            }, {
+                readonly type: "string";
+                readonly maxLength: 20;
+            }];
+        };
+        readonly blueConfig: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly useRandomise: {
+                    readonly type: "boolean";
+                };
+                readonly minRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly usePressure: {
+                    readonly type: "boolean";
+                };
+                readonly minPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly useTilt: {
+                    readonly type: "boolean";
+                };
+                readonly minTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+            };
+        };
+        readonly alpha: {
+            readonly type: "number";
+            readonly minimum: 0;
+            readonly maximum: 1;
+        };
+        readonly alphaConfig: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly useRandomise: {
+                    readonly type: "boolean";
+                };
+                readonly minRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly usePressure: {
+                    readonly type: "boolean";
+                };
+                readonly minPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly useTilt: {
+                    readonly type: "boolean";
+                };
+                readonly minTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+            };
+        };
+        readonly width: {
+            readonly type: "number";
+            readonly minimum: 1;
+            readonly maximum: 256;
+        };
+        readonly widthConfig: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly useRandomise: {
+                    readonly type: "boolean";
+                };
+                readonly minRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly usePressure: {
+                    readonly type: "boolean";
+                };
+                readonly minPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly useTilt: {
+                    readonly type: "boolean";
+                };
+                readonly minTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+            };
+        };
+        readonly height: {
+            readonly type: "number";
+            readonly minimum: 1;
+            readonly maximum: 256;
+        };
+        readonly heightConfig: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly useRandomise: {
+                    readonly type: "boolean";
+                };
+                readonly minRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly usePressure: {
+                    readonly type: "boolean";
+                };
+                readonly minPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly useTilt: {
+                    readonly type: "boolean";
+                };
+                readonly minTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+            };
+        };
+        readonly constrainProportions: {
+            readonly type: "boolean";
+        };
+        readonly rotation: {
+            readonly type: "number";
+            readonly minimum: -360;
+            readonly maximum: 360;
+        };
+        readonly rotationConfig: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly useRandomise: {
+                    readonly type: "boolean";
+                };
+                readonly minRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly usePressure: {
+                    readonly type: "boolean";
+                };
+                readonly minPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly useTilt: {
+                    readonly type: "boolean";
+                };
+                readonly minTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+            };
+        };
+        readonly offsetX: {
+            readonly type: "number";
+            readonly minimum: -256;
+            readonly maximum: 256;
+        };
+        readonly offsetXConfig: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly useRandomise: {
+                    readonly type: "boolean";
+                };
+                readonly minRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly usePressure: {
+                    readonly type: "boolean";
+                };
+                readonly minPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly useTilt: {
+                    readonly type: "boolean";
+                };
+                readonly minTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+            };
+        };
+        readonly offsetY: {
+            readonly type: "number";
+            readonly minimum: -256;
+            readonly maximum: 256;
+        };
+        readonly offsetYConfig: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly useRandomise: {
+                    readonly type: "boolean";
+                };
+                readonly minRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly usePressure: {
+                    readonly type: "boolean";
+                };
+                readonly minPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly useTilt: {
+                    readonly type: "boolean";
+                };
+                readonly minTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+            };
+        };
+        readonly sampleRate: {
+            readonly type: "number";
+            readonly minimum: 5;
+            readonly maximum: 400;
+        };
+        readonly smoothingType: {
+            readonly enum: readonly [0, 1, 2, 3];
+        };
+        readonly spacing: {
+            readonly type: "number";
+            readonly minimum: 0;
+            readonly maximum: 200;
+        };
+        readonly snapToPixelGrid: {
+            readonly type: "boolean";
+        };
+    };
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["id"];
+};
+/** JSON schema for a patch message */
+export declare const patchMessageSchema: {
+    readonly $id: "paintcanvas/message/patch";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["protocol", "type", "coords", "encoding", "data"];
+    readonly properties: {
+        readonly protocol: {
+            readonly const: 1;
+        };
+        readonly type: {
+            readonly const: "patch";
+        };
+        readonly coords: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "integer";
+                readonly minimum: 0;
+                readonly maximum: 10000;
+            };
+            readonly minItems: 4;
+            readonly maxItems: 4;
+        };
+        readonly encoding: {
+            readonly enum: ("rgba-deflate" | "png")[];
+        };
+        readonly data: {
+            readonly type: "string";
+            readonly pattern: "^[A-Za-z0-9+/]*={0,2}$";
+            readonly maxLength: number;
+        };
+    };
+};
+/** JSON schema for a stroke message */
+export declare const strokeMessageSchema: {
+    readonly $id: "paintcanvas/message/stroke";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["protocol", "type", "step", "layer", "mode", "preset", "size", "colour", "isPen", "seed", "points"];
+    readonly properties: {
+        readonly protocol: {
+            readonly const: 1;
+        };
+        readonly type: {
+            readonly const: "stroke";
+        };
+        readonly step: {
+            readonly type: "string";
+            readonly pattern: "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$";
+        };
+        readonly layer: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 100;
+        };
+        readonly mode: {
+            readonly enum: readonly ["paint", "erase"];
+        };
+        readonly preset: {
+            readonly $ref: "../stroke-preset";
+        };
+        readonly size: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["width", "height"];
+            readonly properties: {
+                readonly width: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 10000;
+                };
+                readonly height: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 10000;
+                };
+            };
+        };
+        readonly colour: {
+            readonly type: "string";
+            readonly pattern: "^#[0-9a-fA-F]{6}$";
+        };
+        readonly isPen: {
+            readonly type: "boolean";
+        };
+        readonly seed: {
+            readonly type: "integer";
+            readonly minimum: 0;
+            readonly maximum: 4294967295;
+        };
+        readonly points: {
+            readonly type: "array";
+            readonly minItems: 1;
+            readonly maxItems: 100000;
+            readonly items: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["x", "y", "time"];
+                readonly properties: {
+                    readonly x: {
+                        readonly type: "number";
+                    };
+                    readonly y: {
+                        readonly type: "number";
+                    };
+                    readonly time: {
+                        readonly type: "number";
+                    };
+                    readonly rotation: {
+                        readonly type: "number";
+                    };
+                    readonly pressure: {
+                        readonly type: "number";
+                        readonly minimum: 0;
+                        readonly maximum: 1;
+                    };
+                    readonly tiltX: {
+                        readonly type: "number";
+                        readonly minimum: -90;
+                        readonly maximum: 90;
+                    };
+                    readonly tiltY: {
+                        readonly type: "number";
+                        readonly minimum: -90;
+                        readonly maximum: 90;
+                    };
+                };
+            };
+        };
+    };
+};
+/** JSON schema for an undo or redo message */
+export declare const historyMessageSchema: {
+    readonly $id: "paintcanvas/message/history";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["protocol", "type", "step"];
+    readonly properties: {
+        readonly protocol: {
+            readonly const: 1;
+        };
+        readonly type: {
+            readonly enum: readonly ["undo", "redo"];
+        };
+        readonly step: {
+            readonly type: "string";
+            readonly pattern: "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$";
+        };
+    };
+};
+export declare const messageSchemas: readonly [{
+    readonly $id: "paintcanvas/stroke-preset";
+    readonly properties: {
+        readonly id: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 100;
+        };
+        readonly name: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 100;
+        };
+        readonly group: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 100;
+        };
+        readonly version: {
+            readonly type: "string";
+            readonly maxLength: 20;
+        };
+        readonly author: {
+            readonly anyOf: readonly [{
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 100;
+            }, {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["name"];
+                readonly properties: {
+                    readonly name: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 100;
+                    };
+                    readonly handle: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 100;
+                    };
+                    readonly email: {
+                        readonly type: "string";
+                        readonly maxLength: 254;
+                    };
+                    readonly website: {
+                        readonly type: "string";
+                        readonly maxLength: 2048;
+                    };
+                };
+            }];
+        };
+        readonly image: {
+            readonly type: "string";
+            readonly pattern: "^data:image/png;base64,[A-Za-z0-9+/]+={0,2}$";
+            readonly maxLength: number;
+        };
+        readonly colourMode: {
+            readonly enum: readonly [0, 1];
+        };
+        readonly hue: {
+            readonly anyOf: readonly [{
+                readonly type: "number";
+            }, {
+                readonly type: "string";
+                readonly maxLength: 20;
+            }];
+        };
+        readonly hueConfig: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly useRandomise: {
+                    readonly type: "boolean";
+                };
+                readonly minRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly usePressure: {
+                    readonly type: "boolean";
+                };
+                readonly minPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly useTilt: {
+                    readonly type: "boolean";
+                };
+                readonly minTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+            };
+        };
+        readonly saturation: {
+            readonly anyOf: readonly [{
+                readonly type: "number";
+            }, {
+                readonly type: "string";
+                readonly maxLength: 20;
+            }];
+        };
+        readonly saturationConfig: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly useRandomise: {
+                    readonly type: "boolean";
+                };
+                readonly minRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly usePressure: {
+                    readonly type: "boolean";
+                };
+                readonly minPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly useTilt: {
+                    readonly type: "boolean";
+                };
+                readonly minTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+            };
+        };
+        readonly lightness: {
+            readonly anyOf: readonly [{
+                readonly type: "number";
+            }, {
+                readonly type: "string";
+                readonly maxLength: 20;
+            }];
+        };
+        readonly lightnessConfig: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly useRandomise: {
+                    readonly type: "boolean";
+                };
+                readonly minRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly usePressure: {
+                    readonly type: "boolean";
+                };
+                readonly minPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly useTilt: {
+                    readonly type: "boolean";
+                };
+                readonly minTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+            };
+        };
+        readonly red: {
+            readonly anyOf: readonly [{
+                readonly type: "number";
+            }, {
+                readonly type: "string";
+                readonly maxLength: 20;
+            }];
+        };
+        readonly redConfig: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly useRandomise: {
+                    readonly type: "boolean";
+                };
+                readonly minRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly usePressure: {
+                    readonly type: "boolean";
+                };
+                readonly minPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly useTilt: {
+                    readonly type: "boolean";
+                };
+                readonly minTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+            };
+        };
+        readonly green: {
+            readonly anyOf: readonly [{
+                readonly type: "number";
+            }, {
+                readonly type: "string";
+                readonly maxLength: 20;
+            }];
+        };
+        readonly greenConfig: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly useRandomise: {
+                    readonly type: "boolean";
+                };
+                readonly minRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly usePressure: {
+                    readonly type: "boolean";
+                };
+                readonly minPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly useTilt: {
+                    readonly type: "boolean";
+                };
+                readonly minTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+            };
+        };
+        readonly blue: {
+            readonly anyOf: readonly [{
+                readonly type: "number";
+            }, {
+                readonly type: "string";
+                readonly maxLength: 20;
+            }];
+        };
+        readonly blueConfig: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly useRandomise: {
+                    readonly type: "boolean";
+                };
+                readonly minRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly usePressure: {
+                    readonly type: "boolean";
+                };
+                readonly minPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly useTilt: {
+                    readonly type: "boolean";
+                };
+                readonly minTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+            };
+        };
+        readonly alpha: {
+            readonly type: "number";
+            readonly minimum: 0;
+            readonly maximum: 1;
+        };
+        readonly alphaConfig: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly useRandomise: {
+                    readonly type: "boolean";
+                };
+                readonly minRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly usePressure: {
+                    readonly type: "boolean";
+                };
+                readonly minPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly useTilt: {
+                    readonly type: "boolean";
+                };
+                readonly minTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+            };
+        };
+        readonly width: {
+            readonly type: "number";
+            readonly minimum: 1;
+            readonly maximum: 256;
+        };
+        readonly widthConfig: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly useRandomise: {
+                    readonly type: "boolean";
+                };
+                readonly minRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly usePressure: {
+                    readonly type: "boolean";
+                };
+                readonly minPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly useTilt: {
+                    readonly type: "boolean";
+                };
+                readonly minTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+            };
+        };
+        readonly height: {
+            readonly type: "number";
+            readonly minimum: 1;
+            readonly maximum: 256;
+        };
+        readonly heightConfig: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly useRandomise: {
+                    readonly type: "boolean";
+                };
+                readonly minRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly usePressure: {
+                    readonly type: "boolean";
+                };
+                readonly minPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly useTilt: {
+                    readonly type: "boolean";
+                };
+                readonly minTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+            };
+        };
+        readonly constrainProportions: {
+            readonly type: "boolean";
+        };
+        readonly rotation: {
+            readonly type: "number";
+            readonly minimum: -360;
+            readonly maximum: 360;
+        };
+        readonly rotationConfig: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly useRandomise: {
+                    readonly type: "boolean";
+                };
+                readonly minRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly usePressure: {
+                    readonly type: "boolean";
+                };
+                readonly minPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly useTilt: {
+                    readonly type: "boolean";
+                };
+                readonly minTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+            };
+        };
+        readonly offsetX: {
+            readonly type: "number";
+            readonly minimum: -256;
+            readonly maximum: 256;
+        };
+        readonly offsetXConfig: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly useRandomise: {
+                    readonly type: "boolean";
+                };
+                readonly minRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly usePressure: {
+                    readonly type: "boolean";
+                };
+                readonly minPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly useTilt: {
+                    readonly type: "boolean";
+                };
+                readonly minTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+            };
+        };
+        readonly offsetY: {
+            readonly type: "number";
+            readonly minimum: -256;
+            readonly maximum: 256;
+        };
+        readonly offsetYConfig: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly properties: {
+                readonly useRandomise: {
+                    readonly type: "boolean";
+                };
+                readonly minRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxRandomise: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly usePressure: {
+                    readonly type: "boolean";
+                };
+                readonly minPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxPressure: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly useTilt: {
+                    readonly type: "boolean";
+                };
+                readonly minTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+                readonly maxTilt: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 1;
+                };
+            };
+        };
+        readonly sampleRate: {
+            readonly type: "number";
+            readonly minimum: 5;
+            readonly maximum: 400;
+        };
+        readonly smoothingType: {
+            readonly enum: readonly [0, 1, 2, 3];
+        };
+        readonly spacing: {
+            readonly type: "number";
+            readonly minimum: 0;
+            readonly maximum: 200;
+        };
+        readonly snapToPixelGrid: {
+            readonly type: "boolean";
+        };
+    };
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["id"];
+}, {
+    readonly $id: "paintcanvas/message/patch";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["protocol", "type", "coords", "encoding", "data"];
+    readonly properties: {
+        readonly protocol: {
+            readonly const: 1;
+        };
+        readonly type: {
+            readonly const: "patch";
+        };
+        readonly coords: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "integer";
+                readonly minimum: 0;
+                readonly maximum: 10000;
+            };
+            readonly minItems: 4;
+            readonly maxItems: 4;
+        };
+        readonly encoding: {
+            readonly enum: ("rgba-deflate" | "png")[];
+        };
+        readonly data: {
+            readonly type: "string";
+            readonly pattern: "^[A-Za-z0-9+/]*={0,2}$";
+            readonly maxLength: number;
+        };
+    };
+}, {
+    readonly $id: "paintcanvas/message/stroke";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["protocol", "type", "step", "layer", "mode", "preset", "size", "colour", "isPen", "seed", "points"];
+    readonly properties: {
+        readonly protocol: {
+            readonly const: 1;
+        };
+        readonly type: {
+            readonly const: "stroke";
+        };
+        readonly step: {
+            readonly type: "string";
+            readonly pattern: "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$";
+        };
+        readonly layer: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 100;
+        };
+        readonly mode: {
+            readonly enum: readonly ["paint", "erase"];
+        };
+        readonly preset: {
+            readonly $ref: "../stroke-preset";
+        };
+        readonly size: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["width", "height"];
+            readonly properties: {
+                readonly width: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 10000;
+                };
+                readonly height: {
+                    readonly type: "number";
+                    readonly minimum: 0;
+                    readonly maximum: 10000;
+                };
+            };
+        };
+        readonly colour: {
+            readonly type: "string";
+            readonly pattern: "^#[0-9a-fA-F]{6}$";
+        };
+        readonly isPen: {
+            readonly type: "boolean";
+        };
+        readonly seed: {
+            readonly type: "integer";
+            readonly minimum: 0;
+            readonly maximum: 4294967295;
+        };
+        readonly points: {
+            readonly type: "array";
+            readonly minItems: 1;
+            readonly maxItems: 100000;
+            readonly items: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["x", "y", "time"];
+                readonly properties: {
+                    readonly x: {
+                        readonly type: "number";
+                    };
+                    readonly y: {
+                        readonly type: "number";
+                    };
+                    readonly time: {
+                        readonly type: "number";
+                    };
+                    readonly rotation: {
+                        readonly type: "number";
+                    };
+                    readonly pressure: {
+                        readonly type: "number";
+                        readonly minimum: 0;
+                        readonly maximum: 1;
+                    };
+                    readonly tiltX: {
+                        readonly type: "number";
+                        readonly minimum: -90;
+                        readonly maximum: 90;
+                    };
+                    readonly tiltY: {
+                        readonly type: "number";
+                        readonly minimum: -90;
+                        readonly maximum: 90;
+                    };
+                };
+            };
+        };
+    };
+}, {
+    readonly $id: "paintcanvas/message/history";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["protocol", "type", "step"];
+    readonly properties: {
+        readonly protocol: {
+            readonly const: 1;
+        };
+        readonly type: {
+            readonly enum: readonly ["undo", "redo"];
+        };
+        readonly step: {
+            readonly type: "string";
+            readonly pattern: "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$";
+        };
+    };
+}];
+export {};