@lvl99dotcom/paintcanvas 0.5.0 → 0.6.0

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

@@ -139,6 +139,36 @@ export declare const brushPresetSchema: {
                     readonly minimum: 0;
                     readonly maximum: 1;
                 };
+                readonly profile: {
+                    readonly type: "array";
+                    readonly minItems: 2;
+                    readonly maxItems: 32;
+                    readonly items: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["x", "y", "i"];
+                        readonly properties: {
+                            readonly x: {
+                                readonly type: "number";
+                                readonly minimum: 0;
+                                readonly maximum: 10;
+                            };
+                            readonly y: {
+                                readonly type: "number";
+                                readonly minimum: number;
+                                readonly maximum: 0;
+                            };
+                            readonly i: {
+                                readonly enum: ("linear" | "bezier-cubic")[];
+                            };
+                        };
+                    };
+                };
+                readonly profileId: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 100;
+                };
             };
         };
         readonly saturation: {
@@ -192,6 +222,36 @@ export declare const brushPresetSchema: {
                     readonly minimum: 0;
                     readonly maximum: 1;
                 };
+                readonly profile: {
+                    readonly type: "array";
+                    readonly minItems: 2;
+                    readonly maxItems: 32;
+                    readonly items: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["x", "y", "i"];
+                        readonly properties: {
+                            readonly x: {
+                                readonly type: "number";
+                                readonly minimum: 0;
+                                readonly maximum: 10;
+                            };
+                            readonly y: {
+                                readonly type: "number";
+                                readonly minimum: number;
+                                readonly maximum: 0;
+                            };
+                            readonly i: {
+                                readonly enum: ("linear" | "bezier-cubic")[];
+                            };
+                        };
+                    };
+                };
+                readonly profileId: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 100;
+                };
             };
         };
         readonly lightness: {
@@ -245,6 +305,36 @@ export declare const brushPresetSchema: {
                     readonly minimum: 0;
                     readonly maximum: 1;
                 };
+                readonly profile: {
+                    readonly type: "array";
+                    readonly minItems: 2;
+                    readonly maxItems: 32;
+                    readonly items: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["x", "y", "i"];
+                        readonly properties: {
+                            readonly x: {
+                                readonly type: "number";
+                                readonly minimum: 0;
+                                readonly maximum: 10;
+                            };
+                            readonly y: {
+                                readonly type: "number";
+                                readonly minimum: number;
+                                readonly maximum: 0;
+                            };
+                            readonly i: {
+                                readonly enum: ("linear" | "bezier-cubic")[];
+                            };
+                        };
+                    };
+                };
+                readonly profileId: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 100;
+                };
             };
         };
         readonly red: {
@@ -298,6 +388,36 @@ export declare const brushPresetSchema: {
                     readonly minimum: 0;
                     readonly maximum: 1;
                 };
+                readonly profile: {
+                    readonly type: "array";
+                    readonly minItems: 2;
+                    readonly maxItems: 32;
+                    readonly items: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["x", "y", "i"];
+                        readonly properties: {
+                            readonly x: {
+                                readonly type: "number";
+                                readonly minimum: 0;
+                                readonly maximum: 10;
+                            };
+                            readonly y: {
+                                readonly type: "number";
+                                readonly minimum: number;
+                                readonly maximum: 0;
+                            };
+                            readonly i: {
+                                readonly enum: ("linear" | "bezier-cubic")[];
+                            };
+                        };
+                    };
+                };
+                readonly profileId: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 100;
+                };
             };
         };
         readonly green: {
@@ -351,6 +471,36 @@ export declare const brushPresetSchema: {
                     readonly minimum: 0;
                     readonly maximum: 1;
                 };
+                readonly profile: {
+                    readonly type: "array";
+                    readonly minItems: 2;
+                    readonly maxItems: 32;
+                    readonly items: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["x", "y", "i"];
+                        readonly properties: {
+                            readonly x: {
+                                readonly type: "number";
+                                readonly minimum: 0;
+                                readonly maximum: 10;
+                            };
+                            readonly y: {
+                                readonly type: "number";
+                                readonly minimum: number;
+                                readonly maximum: 0;
+                            };
+                            readonly i: {
+                                readonly enum: ("linear" | "bezier-cubic")[];
+                            };
+                        };
+                    };
+                };
+                readonly profileId: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 100;
+                };
             };
         };
         readonly blue: {
@@ -404,6 +554,36 @@ export declare const brushPresetSchema: {
                     readonly minimum: 0;
                     readonly maximum: 1;
                 };
+                readonly profile: {
+                    readonly type: "array";
+                    readonly minItems: 2;
+                    readonly maxItems: 32;
+                    readonly items: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["x", "y", "i"];
+                        readonly properties: {
+                            readonly x: {
+                                readonly type: "number";
+                                readonly minimum: 0;
+                                readonly maximum: 10;
+                            };
+                            readonly y: {
+                                readonly type: "number";
+                                readonly minimum: number;
+                                readonly maximum: 0;
+                            };
+                            readonly i: {
+                                readonly enum: ("linear" | "bezier-cubic")[];
+                            };
+                        };
+                    };
+                };
+                readonly profileId: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 100;
+                };
             };
         };
         readonly alpha: {
@@ -454,6 +634,36 @@ export declare const brushPresetSchema: {
                     readonly minimum: 0;
                     readonly maximum: 1;
                 };
+                readonly profile: {
+                    readonly type: "array";
+                    readonly minItems: 2;
+                    readonly maxItems: 32;
+                    readonly items: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["x", "y", "i"];
+                        readonly properties: {
+                            readonly x: {
+                                readonly type: "number";
+                                readonly minimum: 0;
+                                readonly maximum: 10;
+                            };
+                            readonly y: {
+                                readonly type: "number";
+                                readonly minimum: number;
+                                readonly maximum: 0;
+                            };
+                            readonly i: {
+                                readonly enum: ("linear" | "bezier-cubic")[];
+                            };
+                        };
+                    };
+                };
+                readonly profileId: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 100;
+                };
             };
         };
         readonly width: {
@@ -504,6 +714,36 @@ export declare const brushPresetSchema: {
                     readonly minimum: 0;
                     readonly maximum: 1;
                 };
+                readonly profile: {
+                    readonly type: "array";
+                    readonly minItems: 2;
+                    readonly maxItems: 32;
+                    readonly items: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["x", "y", "i"];
+                        readonly properties: {
+                            readonly x: {
+                                readonly type: "number";
+                                readonly minimum: 0;
+                                readonly maximum: 10;
+                            };
+                            readonly y: {
+                                readonly type: "number";
+                                readonly minimum: number;
+                                readonly maximum: 0;
+                            };
+                            readonly i: {
+                                readonly enum: ("linear" | "bezier-cubic")[];
+                            };
+                        };
+                    };
+                };
+                readonly profileId: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 100;
+                };
             };
         };
         readonly height: {
@@ -554,6 +794,36 @@ export declare const brushPresetSchema: {
                     readonly minimum: 0;
                     readonly maximum: 1;
                 };
+                readonly profile: {
+                    readonly type: "array";
+                    readonly minItems: 2;
+                    readonly maxItems: 32;
+                    readonly items: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["x", "y", "i"];
+                        readonly properties: {
+                            readonly x: {
+                                readonly type: "number";
+                                readonly minimum: 0;
+                                readonly maximum: 10;
+                            };
+                            readonly y: {
+                                readonly type: "number";
+                                readonly minimum: number;
+                                readonly maximum: 0;
+                            };
+                            readonly i: {
+                                readonly enum: ("linear" | "bezier-cubic")[];
+                            };
+                        };
+                    };
+                };
+                readonly profileId: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 100;
+                };
             };
         };
         readonly constrainProportions: {
@@ -607,6 +877,36 @@ export declare const brushPresetSchema: {
                     readonly minimum: 0;
                     readonly maximum: 1;
                 };
+                readonly profile: {
+                    readonly type: "array";
+                    readonly minItems: 2;
+                    readonly maxItems: 32;
+                    readonly items: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["x", "y", "i"];
+                        readonly properties: {
+                            readonly x: {
+                                readonly type: "number";
+                                readonly minimum: 0;
+                                readonly maximum: 10;
+                            };
+                            readonly y: {
+                                readonly type: "number";
+                                readonly minimum: number;
+                                readonly maximum: 0;
+                            };
+                            readonly i: {
+                                readonly enum: ("linear" | "bezier-cubic")[];
+                            };
+                        };
+                    };
+                };
+                readonly profileId: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 100;
+                };
             };
         };
         readonly offsetX: {
@@ -657,6 +957,36 @@ export declare const brushPresetSchema: {
                     readonly minimum: 0;
                     readonly maximum: 1;
                 };
+                readonly profile: {
+                    readonly type: "array";
+                    readonly minItems: 2;
+                    readonly maxItems: 32;
+                    readonly items: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["x", "y", "i"];
+                        readonly properties: {
+                            readonly x: {
+                                readonly type: "number";
+                                readonly minimum: 0;
+                                readonly maximum: 10;
+                            };
+                            readonly y: {
+                                readonly type: "number";
+                                readonly minimum: number;
+                                readonly maximum: 0;
+                            };
+                            readonly i: {
+                                readonly enum: ("linear" | "bezier-cubic")[];
+                            };
+                        };
+                    };
+                };
+                readonly profileId: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 100;
+                };
             };
         };
         readonly offsetY: {
@@ -707,6 +1037,36 @@ export declare const brushPresetSchema: {
                     readonly minimum: 0;
                     readonly maximum: 1;
                 };
+                readonly profile: {
+                    readonly type: "array";
+                    readonly minItems: 2;
+                    readonly maxItems: 32;
+                    readonly items: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["x", "y", "i"];
+                        readonly properties: {
+                            readonly x: {
+                                readonly type: "number";
+                                readonly minimum: 0;
+                                readonly maximum: 10;
+                            };
+                            readonly y: {
+                                readonly type: "number";
+                                readonly minimum: number;
+                                readonly maximum: 0;
+                            };
+                            readonly i: {
+                                readonly enum: ("linear" | "bezier-cubic")[];
+                            };
+                        };
+                    };
+                };
+                readonly profileId: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 100;
+                };
             };
         };
         readonly sampleRate: {

package/dist/lib/presets/schema.js

@@ -1,3 +1,4 @@
+import { profilePointsSchema } from "../profiles/schema.js";
 // src/lib/presets/schema.ts
 /** Matches a lowercase UUID */
 var UUID_PATTERN = "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$";
@@ -36,7 +37,13 @@ var paramConfig = {
 		maxPressure: factor,
 		useTilt: { type: "boolean" },
 		minTilt: factor,
-		maxTilt: factor
+		maxTilt: factor,
+		profile: profilePointsSchema,
+		profileId: {
+			type: "string",
+			minLength: 1,
+			maxLength: 100
+		}
 	}
 };
 /** A colour value: a number, or a number as text */

package/dist/lib/profiles/index.d.ts

@@ -0,0 +1,61 @@
+/** How the curve runs through a point (a plain object, not an enum, so schemas can use it in scripts run by Node) */
+export declare const Interpolation: {
+    /** A sharp corner: straight towards the points either side */
+    readonly Linear: "linear";
+    /** A smooth curve through the point */
+    readonly BezierCubic: "bezier-cubic";
+};
+/** How the curve runs through a point: `Interpolation.Linear` or `Interpolation.BezierCubic` */
+export type Interpolation = (typeof Interpolation)[keyof typeof Interpolation];
+/**
+ * A point on a profile graph, in grid units: `x` from 0 (no input) to 10 (full input), `y` from -10 (the setting's min)
+ * to 0 (its max), and how the curve runs through it (`i`).
+ */
+export interface ProfilePoint {
+    x: number;
+    y: number;
+    i: Interpolation;
+}
+/** A named profile graph */
+export interface ProfileGraph {
+    /** Kebab-case for presets (e.g. "overweight"), a UUID for the user's own */
+    id: string;
+    name: string;
+    /** Its points from left to right; the first is at x = 0 and the last at x = 10 */
+    points: ProfilePoint[];
+}
+/** How many grid units the graph is across and up */
+export declare const GRID_UNITS = 10;
+/** Most points a profile graph can have */
+export declare const MAX_PROFILE_POINTS = 32;
+/** The ID of the straight-line preset, which changes nothing (the default) */
+export declare const LINEAR_PROFILE_ID = "linear";
+/** The profile graphs PaintCanvas comes with: Linear, Overweight and Underweight */
+export declare const PROFILE_PRESETS: readonly ProfileGraph[];
+/**
+ * A copy of the Linear preset's points, e.g. for a new graph.
+ */
+export declare const linearPoints: () => ProfilePoint[];
+/**
+ * Whether two lists of points are the same.
+ *
+ * @example
+ * samePoints(linearPoints(), linearPoints()); // true
+ */
+export declare const samePoints: (a: readonly ProfilePoint[], b: readonly ProfilePoint[]) => boolean;
+/** Whether a list of points draws a straight line from the setting's min to its max, which changes nothing */
+export declare const isLinear: (points: readonly ProfilePoint[]) => boolean;
+/**
+ * Where the curve is (in grid units, -10 to 0) at an x in grid units (0 to 10). Between two points it's a cubic curve
+ * that leaves and reaches each with its slope (see `slopeAt`), so it's a straight line between two sharp corners.
+ */
+export declare const profileY: (points: readonly ProfilePoint[], x: number) => number;
+/**
+ * Shape an input (0–1) with a profile graph: how far between the setting's min (0) and max (1) it puts it. Without
+ * points, the input is used as it is. The result is kept within 0–1.
+ *
+ * @example
+ * applyProfile(undefined, 0.3); // 0.3
+ * applyProfile(PROFILE_PRESETS[1].points, 0.3); // 0.7 (Overweight: a light touch goes most of the way)
+ */
+export declare const applyProfile: (points: readonly ProfilePoint[] | undefined, input: number) => number;

package/dist/lib/profiles/index.js

@@ -0,0 +1,131 @@
+// src/lib/profiles/index.ts
+/** How the curve runs through a point (a plain object, not an enum, so schemas can use it in scripts run by Node) */
+var Interpolation = {
+	/** A sharp corner: straight towards the points either side */
+	Linear: "linear",
+	/** A smooth curve through the point */
+	BezierCubic: "bezier-cubic"
+};
+/** How many grid units the graph is across and up */
+var GRID_UNITS = 10;
+/** Most points a profile graph can have */
+var MAX_PROFILE_POINTS = 32;
+/** The ID of the straight-line preset, which changes nothing (the default) */
+var LINEAR_PROFILE_ID = "linear";
+/** The profile graphs PaintCanvas comes with: Linear, Overweight and Underweight */
+var PROFILE_PRESETS = [
+	{
+		id: LINEAR_PROFILE_ID,
+		name: "Linear",
+		points: [{
+			x: 0,
+			y: -10,
+			i: Interpolation.Linear
+		}, {
+			x: 10,
+			y: 0,
+			i: Interpolation.Linear
+		}]
+	},
+	{
+		id: "overweight",
+		name: "Overweight",
+		points: [
+			{
+				x: 0,
+				y: -10,
+				i: Interpolation.Linear
+			},
+			{
+				x: 3,
+				y: -3,
+				i: Interpolation.BezierCubic
+			},
+			{
+				x: 10,
+				y: 0,
+				i: Interpolation.Linear
+			}
+		]
+	},
+	{
+		id: "underweight",
+		name: "Underweight",
+		points: [
+			{
+				x: 0,
+				y: -10,
+				i: Interpolation.Linear
+			},
+			{
+				x: 7,
+				y: -7,
+				i: Interpolation.BezierCubic
+			},
+			{
+				x: 10,
+				y: 0,
+				i: Interpolation.Linear
+			}
+		]
+	}
+];
+/**
+* A copy of the Linear preset's points, e.g. for a new graph.
+*/
+var linearPoints = () => PROFILE_PRESETS[0].points.map((point) => ({ ...point }));
+/**
+* Whether two lists of points are the same.
+*
+* @example
+* samePoints(linearPoints(), linearPoints()); // true
+*/
+var samePoints = (a, b) => a.length === b.length && a.every((point, index) => point.x === b[index]?.x && point.y === b[index]?.y && point.i === b[index]?.i);
+/** Whether a list of points draws a straight line from the setting's min to its max, which changes nothing */
+var isLinear = (points) => samePoints(points, linearPoints());
+/**
+* The slope a segment of the curve leaves (or reaches) a point with: the segment's own slope at a sharp corner, or the
+* slope between the points either side at a smooth point (the slope between the segment's ends at the first and last).
+*/
+var slopeAt = (points, index, segmentSlope) => {
+	const point = points[index];
+	const before = points[index - 1];
+	const after = points[index + 1];
+	if (point.i === Interpolation.Linear || !before || !after) return segmentSlope;
+	return (after.y - before.y) / (after.x - before.x);
+};
+/**
+* Where the curve is (in grid units, -10 to 0) at an x in grid units (0 to 10). Between two points it's a cubic curve
+* that leaves and reaches each with its slope (see `slopeAt`), so it's a straight line between two sharp corners.
+*/
+var profileY = (points, x) => {
+	const last = points.length - 1;
+	let index = 0;
+	while (index < last - 1 && points[index + 1].x < x) index++;
+	const a = points[index];
+	const b = points[index + 1] ?? a;
+	const width = b.x - a.x;
+	if (width <= 0) return x < a.x ? a.y : b.y;
+	const segmentSlope = (b.y - a.y) / width;
+	const startSlope = slopeAt(points, index, segmentSlope) * width;
+	const endSlope = slopeAt(points, index + 1, segmentSlope) * width;
+	const t = Math.min(1, Math.max(0, (x - a.x) / width));
+	const t2 = t * t;
+	const t3 = t2 * t;
+	return (2 * t3 - 3 * t2 + 1) * a.y + (t3 - 2 * t2 + t) * startSlope + (-2 * t3 + 3 * t2) * b.y + (t3 - t2) * endSlope;
+};
+/**
+* Shape an input (0–1) with a profile graph: how far between the setting's min (0) and max (1) it puts it. Without
+* points, the input is used as it is. The result is kept within 0–1.
+*
+* @example
+* applyProfile(undefined, 0.3); // 0.3
+* applyProfile(PROFILE_PRESETS[1].points, 0.3); // 0.7 (Overweight: a light touch goes most of the way)
+*/
+var applyProfile = (points, input) => {
+	const amount = Math.min(1, Math.max(0, input));
+	if (!points || points.length < 2) return amount;
+	const y = profileY(points, amount * 10);
+	return Math.min(1, Math.max(0, (y + 10) / 10));
+};
+export { GRID_UNITS, Interpolation, LINEAR_PROFILE_ID, MAX_PROFILE_POINTS, PROFILE_PRESETS, applyProfile, isLinear, linearPoints, profileY, samePoints };