@radialapps/memories-vips-editor 0.1.3 → 0.1.6

package/dist/transforms/highlights.js

@@ -0,0 +1,49 @@
+// highlights.ts — boost/recover the bright end, weighted by brightness.
+//
+// weight w = clamp(avg,0,1)^2 (0 in blacks, 1 in whites, quadratic falloff),
+// then rgb += (amount * 0.5) * w. The 0.5 keeps the gray curve monotonic over
+// the whole slider range (a full-strength recovery would push white below
+// near-white). Same formula in src/transforms/highlights.h and
+// math.ts applyHighlights, so the canvas preview is WYSIWYG.
+import { clampf } from '../math.js';
+import { isNumInRange, setFloatUniform, } from './transform.js';
+const FRAG = `
+precision mediump float;
+uniform sampler2D texture;
+uniform float amount;
+varying vec2 texCoord;
+void main() {
+  vec4 color = texture2D(texture, texCoord);
+  float avg = (color.r + color.g + color.b) / 3.0;
+  float l = clamp(avg, 0.0, 1.0);
+  float w = l * l;
+  color.rgb += (amount * 0.5) * w;
+  gl_FragColor = color;
+}
+`;
+export class HighlightsTransform {
+    constructor() {
+        this.edit = 'highlights';
+        this.controls = [
+            { key: 'amount', label: 'amount', min: -1, max: 1, step: 0.01, def: 0 },
+        ];
+    }
+    defaults() {
+        return { edit: 'highlights', amount: 0 };
+    }
+    validate(params) {
+        if (params.amount !== undefined && !isNumInRange(params.amount, -1, 1))
+            return ['amount must be a number in [-1,1]'];
+        return [];
+    }
+    normalize(params) {
+        return { edit: 'highlights', amount: clampf(-1, params.amount ?? 0, 1) };
+    }
+    apply(ctx, from, to, params) {
+        ctx.pass(FRAG, from, to, (gl, p) => {
+            setFloatUniform(gl, p, 'amount', params.amount);
+        });
+        return to;
+    }
+}
+//# sourceMappingURL=highlights.js.map

package/dist/transforms/highlights.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"highlights.js","sourceRoot":"","sources":["../../src/transforms/highlights.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,EAAE;AACF,6EAA6E;AAC7E,8EAA8E;AAC9E,0EAA0E;AAC1E,+DAA+D;AAC/D,6DAA6D;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACpC,OAAO,EACL,YAAY,EACZ,eAAe,GAKhB,MAAM,gBAAgB,CAAC;AAUxB,MAAM,IAAI,GAAG;;;;;;;;;;;;;CAaZ,CAAC;AAEF,MAAM,OAAO,mBAAmB;IAAhC;QACkB,SAAI,GAAG,YAAqB,CAAC;QACtC,aAAQ,GAAmB;YAChC,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE;SACxE,CAAC;IAsBJ,CAAC;IApBQ,QAAQ;QACb,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IAC3C,CAAC;IAEM,QAAQ,CAAC,MAAsB;QACpC,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YACpE,OAAO,CAAC,mCAAmC,CAAC,CAAC;QAC/C,OAAO,EAAE,CAAC;IACZ,CAAC;IAEM,SAAS,CAAC,MAAsB;QACrC,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IAC3E,CAAC;IAEM,KAAK,CAAC,GAAkB,EAAE,IAAY,EAAE,EAAU,EAAE,MAAY;QACrE,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE;YACjC,eAAe,CAAC,EAAE,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;QACH,OAAO,EAAE,CAAC;IACZ,CAAC;CACF"}

package/dist/transforms/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transforms/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAU,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAcxD,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAalE,CAAC;AAEF,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,CAKjD;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAI9C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transforms/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAU,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAkBxD,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAiBlE,CAAC;AAEF,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,CAKjD;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAI9C"}

package/dist/transforms/index.js

@@ -3,14 +3,18 @@ import { BlurTransform } from './blur.js';
 import { BrightnessContrastTransform } from './brightnessContrast.js';
 import { CropTransform } from './crop.js';
 import { ExposureTransform } from './exposure.js';
+import { FlipTransform } from './flip.js';
 import { GrayscaleTransform } from './grayscale.js';
+import { HighlightsTransform } from './highlights.js';
 import { HueSaturationTransform } from './hueSaturation.js';
 import { InvertTransform } from './invert.js';
 import { RotateTransform } from './rotate.js';
 import { SepiaTransform } from './sepia.js';
+import { ShadowsTransform } from './shadows.js';
 import { SharpenTransform } from './sharpen.js';
 import { VibranceTransform } from './vibrance.js';
 import { VignetteTransform } from './vignette.js';
+import { WarmthTransform } from './warmth.js';
 export const TRANSFORMS = {
     brightnessContrast: new BrightnessContrastTransform(),
     exposure: new ExposureTransform(),
@@ -20,10 +24,14 @@ export const TRANSFORMS = {
     blur: new BlurTransform(),
     sharpen: new SharpenTransform(),
     vignette: new VignetteTransform(),
+    shadows: new ShadowsTransform(),
+    highlights: new HighlightsTransform(),
+    warmth: new WarmthTransform(),
     invert: new InvertTransform(),
     grayscale: new GrayscaleTransform(),
     crop: new CropTransform(),
     rotate: new RotateTransform(),
+    flip: new FlipTransform(),
 };
 /** Human-readable problems; empty means the edit is VIPS-appliable. */
 export function validateEdit(edit) {

package/dist/transforms/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transforms/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,EAAkB,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,MAAM,CAAC,MAAM,UAAU,GAAgD;IACrE,kBAAkB,EAAE,IAAI,2BAA2B,EAAE;IACrD,QAAQ,EAAE,IAAI,iBAAiB,EAAE;IACjC,aAAa,EAAE,IAAI,sBAAsB,EAAE;IAC3C,KAAK,EAAE,IAAI,cAAc,EAAE;IAC3B,QAAQ,EAAE,IAAI,iBAAiB,EAAE;IACjC,IAAI,EAAE,IAAI,aAAa,EAAE;IACzB,OAAO,EAAE,IAAI,gBAAgB,EAAE;IAC/B,QAAQ,EAAE,IAAI,iBAAiB,EAAE;IACjC,MAAM,EAAE,IAAI,eAAe,EAAE;IAC7B,SAAS,EAAE,IAAI,kBAAkB,EAAE;IACnC,IAAI,EAAE,IAAI,aAAa,EAAE;IACzB,MAAM,EAAE,IAAI,eAAe,EAAE;CAC9B,CAAC;AAEF,uEAAuE;AACvE,MAAM,UAAU,YAAY,CAAC,IAAU;IACrC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACjF,MAAM,CAAC,GAAG,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,CAAC;QAAE,OAAO,CAAC,gBAAgB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACrD,OAAO,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,aAAa,CAAC,IAAU;IACtC,MAAM,CAAC,GAAG,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7D,OAAO,CAAC,CAAC,SAAS,CAAC,IAAI,CAAS,CAAC;AACnC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transforms/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,EAAkB,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,CAAC,MAAM,UAAU,GAAgD;IACrE,kBAAkB,EAAE,IAAI,2BAA2B,EAAE;IACrD,QAAQ,EAAE,IAAI,iBAAiB,EAAE;IACjC,aAAa,EAAE,IAAI,sBAAsB,EAAE;IAC3C,KAAK,EAAE,IAAI,cAAc,EAAE;IAC3B,QAAQ,EAAE,IAAI,iBAAiB,EAAE;IACjC,IAAI,EAAE,IAAI,aAAa,EAAE;IACzB,OAAO,EAAE,IAAI,gBAAgB,EAAE;IAC/B,QAAQ,EAAE,IAAI,iBAAiB,EAAE;IACjC,OAAO,EAAE,IAAI,gBAAgB,EAAE;IAC/B,UAAU,EAAE,IAAI,mBAAmB,EAAE;IACrC,MAAM,EAAE,IAAI,eAAe,EAAE;IAC7B,MAAM,EAAE,IAAI,eAAe,EAAE;IAC7B,SAAS,EAAE,IAAI,kBAAkB,EAAE;IACnC,IAAI,EAAE,IAAI,aAAa,EAAE;IACzB,MAAM,EAAE,IAAI,eAAe,EAAE;IAC7B,IAAI,EAAE,IAAI,aAAa,EAAE;CAC1B,CAAC;AAEF,uEAAuE;AACvE,MAAM,UAAU,YAAY,CAAC,IAAU;IACrC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACjF,MAAM,CAAC,GAAG,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,CAAC;QAAE,OAAO,CAAC,gBAAgB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACrD,OAAO,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,aAAa,CAAC,IAAU;IACtC,MAAM,CAAC,GAAG,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7D,OAAO,CAAC,CAAC,SAAS,CAAC,IAAI,CAAS,CAAC;AACnC,CAAC"}

package/dist/transforms/shadows.d.ts

@@ -0,0 +1,17 @@
+import { type ParamControl, type RenderContext, type Target, type Transform } from './transform.js';
+export interface ShadowsEdit {
+    edit: 'shadows';
+    /** -1 (crush shadows) .. 1 (lift shadows). Default 0. */
+    amount?: number;
+}
+type Full = Required<ShadowsEdit>;
+export declare class ShadowsTransform implements Transform<'shadows', ShadowsEdit> {
+    readonly edit: "shadows";
+    controls: ParamControl[];
+    defaults(): Full;
+    validate(params: ShadowsEdit): string[];
+    normalize(params: ShadowsEdit): Full;
+    apply(ctx: RenderContext, from: Target, to: Target, params: Full): Target;
+}
+export {};
+//# sourceMappingURL=shadows.d.ts.map

package/dist/transforms/shadows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadows.d.ts","sourceRoot":"","sources":["../../src/transforms/shadows.ts"],"names":[],"mappings":"AAQA,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,MAAM,EACX,KAAK,SAAS,EACf,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,CAAC;IAChB,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,KAAK,IAAI,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;AAiBlC,qBAAa,gBAAiB,YAAW,SAAS,CAAC,SAAS,EAAE,WAAW,CAAC;IACxE,SAAgB,IAAI,EAAG,SAAS,CAAU;IACnC,QAAQ,EAAE,YAAY,EAAE,CAE7B;IAEK,QAAQ,IAAI,IAAI;IAIhB,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,EAAE;IAMvC,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAIpC,KAAK,CAAC,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,GAAG,MAAM;CAMjF"}

package/dist/transforms/shadows.js

@@ -0,0 +1,49 @@
+// shadows.ts — lift/crush the dark end, weighted by darkness.
+//
+// weight w = (1 - clamp(avg,0,1))^2 (1 in blacks, 0 in whites, quadratic
+// falloff), then rgb += (amount * 0.5) * w. The 0.5 keeps the gray curve
+// monotonic over the whole slider range (a full-strength lift would reverse
+// deep shadows past mid-gray). Same formula in src/transforms/shadows.h
+// and math.ts applyShadows, so the canvas preview is WYSIWYG.
+import { clampf } from '../math.js';
+import { isNumInRange, setFloatUniform, } from './transform.js';
+const FRAG = `
+precision mediump float;
+uniform sampler2D texture;
+uniform float amount;
+varying vec2 texCoord;
+void main() {
+  vec4 color = texture2D(texture, texCoord);
+  float avg = (color.r + color.g + color.b) / 3.0;
+  float l = clamp(avg, 0.0, 1.0);
+  float w = (1.0 - l) * (1.0 - l);
+  color.rgb += (amount * 0.5) * w;
+  gl_FragColor = color;
+}
+`;
+export class ShadowsTransform {
+    constructor() {
+        this.edit = 'shadows';
+        this.controls = [
+            { key: 'amount', label: 'amount', min: -1, max: 1, step: 0.01, def: 0 },
+        ];
+    }
+    defaults() {
+        return { edit: 'shadows', amount: 0 };
+    }
+    validate(params) {
+        if (params.amount !== undefined && !isNumInRange(params.amount, -1, 1))
+            return ['amount must be a number in [-1,1]'];
+        return [];
+    }
+    normalize(params) {
+        return { edit: 'shadows', amount: clampf(-1, params.amount ?? 0, 1) };
+    }
+    apply(ctx, from, to, params) {
+        ctx.pass(FRAG, from, to, (gl, p) => {
+            setFloatUniform(gl, p, 'amount', params.amount);
+        });
+        return to;
+    }
+}
+//# sourceMappingURL=shadows.js.map

package/dist/transforms/shadows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadows.js","sourceRoot":"","sources":["../../src/transforms/shadows.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,EAAE;AACF,yEAAyE;AACzE,yEAAyE;AACzE,4EAA4E;AAC5E,wEAAwE;AACxE,8DAA8D;AAC9D,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACpC,OAAO,EACL,YAAY,EACZ,eAAe,GAKhB,MAAM,gBAAgB,CAAC;AAUxB,MAAM,IAAI,GAAG;;;;;;;;;;;;;CAaZ,CAAC;AAEF,MAAM,OAAO,gBAAgB;IAA7B;QACkB,SAAI,GAAG,SAAkB,CAAC;QACnC,aAAQ,GAAmB;YAChC,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE;SACxE,CAAC;IAsBJ,CAAC;IApBQ,QAAQ;QACb,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IACxC,CAAC;IAEM,QAAQ,CAAC,MAAmB;QACjC,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YACpE,OAAO,CAAC,mCAAmC,CAAC,CAAC;QAC/C,OAAO,EAAE,CAAC;IACZ,CAAC;IAEM,SAAS,CAAC,MAAmB;QAClC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IACxE,CAAC;IAEM,KAAK,CAAC,GAAkB,EAAE,IAAY,EAAE,EAAU,EAAE,MAAY;QACrE,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE;YACjC,eAAe,CAAC,EAAE,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;QACH,OAAO,EAAE,CAAC;IACZ,CAAC;CACF"}

package/dist/transforms/warmth.d.ts

@@ -0,0 +1,17 @@
+import { type ParamControl, type RenderContext, type Target, type Transform } from './transform.js';
+export interface WarmthEdit {
+    edit: 'warmth';
+    /** -1 (cool) .. 1 (warm). Default 0. */
+    amount?: number;
+}
+type Full = Required<WarmthEdit>;
+export declare class WarmthTransform implements Transform<'warmth', WarmthEdit> {
+    readonly edit: "warmth";
+    controls: ParamControl[];
+    defaults(): Full;
+    validate(params: WarmthEdit): string[];
+    normalize(params: WarmthEdit): Full;
+    apply(ctx: RenderContext, from: Target, to: Target, params: Full): Target;
+}
+export {};
+//# sourceMappingURL=warmth.d.ts.map

package/dist/transforms/warmth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warmth.d.ts","sourceRoot":"","sources":["../../src/transforms/warmth.ts"],"names":[],"mappings":"AAOA,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,MAAM,EACX,KAAK,SAAS,EACf,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,CAAC;IACf,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,KAAK,IAAI,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;AAejC,qBAAa,eAAgB,YAAW,SAAS,CAAC,QAAQ,EAAE,UAAU,CAAC;IACrE,SAAgB,IAAI,EAAG,QAAQ,CAAU;IAClC,QAAQ,EAAE,YAAY,EAAE,CAE7B;IAEK,QAAQ,IAAI,IAAI;IAIhB,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,EAAE;IAMtC,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAInC,KAAK,CAAC,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,GAAG,MAAM;CAMjF"}

package/dist/transforms/warmth.js

@@ -0,0 +1,46 @@
+// warmth.ts — white-balance-style temperature shift (red/blue gains).
+//
+// r *= 1 + 0.3*amount, b *= 1 - 0.3*amount, g unchanged: +1 is warm
+// (amber), -1 is cool (blue). Blacks stay black (multiplicative, like a
+// white-balance gain). Same factors in src/transforms/warmth.h and
+// math.ts warmthGains, so the canvas preview is WYSIWYG.
+import { clampf } from '../math.js';
+import { isNumInRange, setFloatUniform, } from './transform.js';
+const FRAG = `
+precision mediump float;
+uniform sampler2D texture;
+uniform float amount;
+varying vec2 texCoord;
+void main() {
+  vec4 color = texture2D(texture, texCoord);
+  color.r *= 1.0 + amount * 0.3;
+  color.b *= 1.0 - amount * 0.3;
+  gl_FragColor = color;
+}
+`;
+export class WarmthTransform {
+    constructor() {
+        this.edit = 'warmth';
+        this.controls = [
+            { key: 'amount', label: 'amount', min: -1, max: 1, step: 0.01, def: 0 },
+        ];
+    }
+    defaults() {
+        return { edit: 'warmth', amount: 0 };
+    }
+    validate(params) {
+        if (params.amount !== undefined && !isNumInRange(params.amount, -1, 1))
+            return ['amount must be a number in [-1,1]'];
+        return [];
+    }
+    normalize(params) {
+        return { edit: 'warmth', amount: clampf(-1, params.amount ?? 0, 1) };
+    }
+    apply(ctx, from, to, params) {
+        ctx.pass(FRAG, from, to, (gl, p) => {
+            setFloatUniform(gl, p, 'amount', params.amount);
+        });
+        return to;
+    }
+}
+//# sourceMappingURL=warmth.js.map

package/dist/transforms/warmth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"warmth.js","sourceRoot":"","sources":["../../src/transforms/warmth.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,EAAE;AACF,oEAAoE;AACpE,wEAAwE;AACxE,mEAAmE;AACnE,yDAAyD;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACpC,OAAO,EACL,YAAY,EACZ,eAAe,GAKhB,MAAM,gBAAgB,CAAC;AAUxB,MAAM,IAAI,GAAG;;;;;;;;;;;CAWZ,CAAC;AAEF,MAAM,OAAO,eAAe;IAA5B;QACkB,SAAI,GAAG,QAAiB,CAAC;QAClC,aAAQ,GAAmB;YAChC,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE;SACxE,CAAC;IAsBJ,CAAC;IApBQ,QAAQ;QACb,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IACvC,CAAC;IAEM,QAAQ,CAAC,MAAkB;QAChC,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YACpE,OAAO,CAAC,mCAAmC,CAAC,CAAC;QAC/C,OAAO,EAAE,CAAC;IACZ,CAAC;IAEM,SAAS,CAAC,MAAkB;QACjC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IACvE,CAAC;IAEM,KAAK,CAAC,GAAkB,EAAE,IAAY,EAAE,EAAU,EAAE,MAAY;QACrE,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE;YACjC,eAAe,CAAC,EAAE,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;QACH,OAAO,EAAE,CAAC;IACZ,CAAC;CACF"}

package/dist/types.d.ts

@@ -2,16 +2,20 @@ import type { BlurEdit } from './transforms/blur.js';
 import type { BrightnessContrastEdit } from './transforms/brightnessContrast.js';
 import type { CropEdit } from './transforms/crop.js';
 import type { ExposureEdit } from './transforms/exposure.js';
+import type { FlipEdit } from './transforms/flip.js';
 import type { GrayscaleEdit } from './transforms/grayscale.js';
+import type { HighlightsEdit } from './transforms/highlights.js';
 import type { HueSaturationEdit } from './transforms/hueSaturation.js';
 import type { InvertEdit } from './transforms/invert.js';
 import type { RotateEdit } from './transforms/rotate.js';
 import type { SepiaEdit } from './transforms/sepia.js';
+import type { ShadowsEdit } from './transforms/shadows.js';
 import type { SharpenEdit } from './transforms/sharpen.js';
 import type { VibranceEdit } from './transforms/vibrance.js';
 import type { VignetteEdit } from './transforms/vignette.js';
-export type EditName = 'brightnessContrast' | 'exposure' | 'hueSaturation' | 'sepia' | 'vibrance' | 'blur' | 'sharpen' | 'vignette' | 'invert' | 'grayscale' | 'crop' | 'rotate';
-export type Edit = BrightnessContrastEdit | ExposureEdit | HueSaturationEdit | SepiaEdit | VibranceEdit | BlurEdit | SharpenEdit | VignetteEdit | InvertEdit | GrayscaleEdit | CropEdit | RotateEdit;
+import type { WarmthEdit } from './transforms/warmth.js';
+export type EditName = 'brightnessContrast' | 'exposure' | 'hueSaturation' | 'sepia' | 'vibrance' | 'blur' | 'sharpen' | 'vignette' | 'shadows' | 'highlights' | 'warmth' | 'invert' | 'grayscale' | 'crop' | 'rotate' | 'flip';
+export type Edit = BrightnessContrastEdit | ExposureEdit | HueSaturationEdit | SepiaEdit | VibranceEdit | BlurEdit | SharpenEdit | VignetteEdit | ShadowsEdit | HighlightsEdit | WarmthEdit | InvertEdit | GrayscaleEdit | CropEdit | RotateEdit | FlipEdit;
 export declare const EDIT_STATE_VERSION: 1;
 export interface EditState {
     version: typeof EDIT_STATE_VERSION;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AACjF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,MAAM,MAAM,QAAQ,GAChB,oBAAoB,GACpB,UAAU,GACV,eAAe,GACf,OAAO,GACP,UAAU,GACV,MAAM,GACN,SAAS,GACT,UAAU,GACV,QAAQ,GACR,WAAW,GACX,MAAM,GACN,QAAQ,CAAC;AAEb,MAAM,MAAM,IAAI,GACZ,sBAAsB,GACtB,YAAY,GACZ,iBAAiB,GACjB,SAAS,GACT,YAAY,GACZ,QAAQ,GACR,WAAW,GACX,YAAY,GACZ,UAAU,GACV,aAAa,GACb,QAAQ,GACR,UAAU,CAAC;AAEf,eAAO,MAAM,kBAAkB,EAAG,CAAU,CAAC;AAE7C,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,kBAAkB,CAAC;IACnC,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AAED,wBAAgB,UAAU,IAAI,SAAS,CAEtC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AACjF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,MAAM,QAAQ,GAChB,oBAAoB,GACpB,UAAU,GACV,eAAe,GACf,OAAO,GACP,UAAU,GACV,MAAM,GACN,SAAS,GACT,UAAU,GACV,SAAS,GACT,YAAY,GACZ,QAAQ,GACR,QAAQ,GACR,WAAW,GACX,MAAM,GACN,QAAQ,GACR,MAAM,CAAC;AAEX,MAAM,MAAM,IAAI,GACZ,sBAAsB,GACtB,YAAY,GACZ,iBAAiB,GACjB,SAAS,GACT,YAAY,GACZ,QAAQ,GACR,WAAW,GACX,YAAY,GACZ,WAAW,GACX,cAAc,GACd,UAAU,GACV,UAAU,GACV,aAAa,GACb,QAAQ,GACR,UAAU,GACV,QAAQ,CAAC;AAEb,eAAO,MAAM,kBAAkB,EAAG,CAAU,CAAC;AAE7C,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,kBAAkB,CAAC;IACnC,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AAED,wBAAgB,UAAU,IAAI,SAAS,CAEtC"}

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAgDA,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAU,CAAC;AAO7C,MAAM,UAAU,UAAU;IACxB,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AACpD,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AA4DA,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAU,CAAC;AAO7C,MAAM,UAAU,UAAU;IACxB,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AACpD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@radialapps/memories-vips-editor",
-  "version": "0.1.3",
+  "version": "0.1.6",
   "description": "Headless WebGL preview library for vips-static edits. Renders an ordered edit list on a caller-provided canvas; serializes the same list as JSON for the vips-preview CLI (convert/thumbnail ... \"edits\": [...]).",
   "type": "module",
   "main": "./dist/index.js",

package/src/index.ts

@@ -1,9 +1,10 @@
-// index.ts — minimal public surface: the pipeline, the registry, state
-// helpers, and the types needed to consume them (including writing a
-// custom Transform). Internal helpers (lookup, isNumInRange,
+// index.ts — minimal public surface: the pipeline, small previews, the
+// registry, state helpers, and the types needed to consume them (including
+// writing a custom Transform). Internal helpers (lookup, isNumInRange,
 // setFloatUniform, math utils, per-transform types) live in their own
 // modules — import those directly.
 export { EditPipeline } from './pipeline.js';
+export { SmallPreview } from './smallPreview.js';
 export { TRANSFORMS, validateEdit, normalizeEdit } from './transforms/index.js';
 export { validateState, stateToJSON, stateFromJSON } from './transforms/state.js';
 export type { Transform, ParamControl, RenderContext, Target } from './transforms/transform.js';

package/src/math.ts

@@ -18,6 +18,46 @@ export function exposureMult(stops: number): number {
   return Math.pow(2, clampf(-5, stops, 5));
 }
 
+/** Shadows weight for a clamped 0..1 luma: (1-l)^2 (dark-localized). */
+export function shadowsWeight(luma01: number): number {
+  const l = clampf(0, luma01, 1);
+  return (1 - l) * (1 - l);
+}
+
+/** Highlights weight for a clamped 0..1 luma: l^2 (bright-localized). */
+export function highlightsWeight(luma01: number): number {
+  const l = clampf(0, luma01, 1);
+  return l * l;
+}
+
+/** Gray-pixel output of the shadows edit: v + (a*0.5)*(1-v)^2.
+ *
+ * The 0.5 keeps the curve monotonic increasing over the whole amount range
+ * (d/dv = 1-2k(1-v) >= 0 for k <= 0.5): without it black would lift past
+ * mid-gray at high amounts. Reference for the GLSL in shadows.ts and the
+ * loop in src/transforms/shadows.h.
+ */
+export function applyShadowsGray(v: number, amount: number): number {
+  return v + clampf(-1, amount, 1) * 0.5 * shadowsWeight(v);
+}
+
+/** Gray-pixel output of the highlights edit: v + (a*0.5)*v^2.
+ *
+ * The 0.5 keeps the curve monotonic increasing over the whole amount range
+ * (d/dv = 1+2kv >= 0 for k >= -0.5): without it white would recover below
+ * near-white at high negative amounts. Reference for the GLSL in
+ * highlights.ts and the loop in src/transforms/highlights.h.
+ */
+export function applyHighlightsGray(v: number, amount: number): number {
+  return v + clampf(-1, amount, 1) * 0.5 * highlightsWeight(v);
+}
+
+/** Red/blue white-balance gains for a warmth amount in [-1,1]. */
+export function warmthGains(amount: number): { r: number; b: number } {
+  const a = clampf(-1, amount, 1);
+  return { r: 1 + a * 0.3, b: 1 - a * 0.3 };
+}
+
 /** 1D gaussian kernel for a blur radius (sigma = radius/2). Preview + docs.
  *
  * Single source of truth, ported term-for-term to src/transforms/gaussian.h:

package/src/pipeline.ts

@@ -183,7 +183,7 @@ export class EditPipeline {
       const g = scratch.getContext('2d');
       if (!g) throw new Error('setImage: 2D context unavailable for downscale');
       g.imageSmoothingQuality = 'high';
-      g.drawImage(source as CanvasImageSource, 0, 0, w, h);
+      g.drawImage(EditPipeline.toDrawableSource(source), 0, 0, w, h);
       upload = scratch;
     }
     this.imgW = w;
@@ -487,4 +487,28 @@ export class EditPipeline {
     }
     this.draw(BLIT_FRAG, from, null, this.outW, this.outH);
   }
+
+  /**
+   * drawImage() rejects ImageData — a valid TexImageSource that texImage2D
+   * accepts — so stage ImageData through a 2D canvas first. Everything else
+   * passes through untouched. Duck-types ({width,height,data}) instead of
+   * instanceof so cross-realm ImageData works too.
+   */
+  public static toDrawableSource(source: TexImageSource): CanvasImageSource {
+    const o = source as unknown as { data?: unknown; width?: unknown; height?: unknown };
+    if (
+      typeof o.width !== 'number' ||
+      typeof o.height !== 'number' ||
+      !(o.data instanceof Uint8ClampedArray)
+    ) {
+      return source as unknown as CanvasImageSource;
+    }
+    const staged = document.createElement('canvas');
+    staged.width = o.width;
+    staged.height = o.height;
+    const g = staged.getContext('2d');
+    if (!g) throw new Error('toDrawableSource: 2D context unavailable for ImageData upload');
+    g.putImageData(source as ImageData, 0, 0);
+    return staged;
+  }
 }

package/src/smallPreview.ts

@@ -0,0 +1,120 @@
+// smallPreview.ts — cheap small previews for an edit list.
+//
+// A SmallPreview owns one hidden WebGL canvas + EditPipeline plus a
+// downscaled 2D copy of the source (longest side <= maxDim, default 512).
+// setSource() downscales and uploads once; each render() then only re-runs
+// the edit passes and snapshots the result into a fresh caller-owned 2D
+// canvas — no re-upload, no shader recompile, no disturbance of any main
+// preview canvas. Returning a snapshot (not the live canvas) keeps repeated
+// renders safe to hold (e.g. a filmstrip of edit variants).
+//
+// Pixel radii (blur/sharpen) are in preview pixels here, so large radii look
+// relatively stronger than at full res; everything else matches the main
+// preview. Each instance holds one WebGL context: call dispose() when done
+// (browsers cap live contexts at ~16 per page).
+import { EditPipeline } from './pipeline.js';
+import type { Edit } from './types.js';
+
+export class SmallPreview {
+  /** Default longest side of the downscaled working copy. */
+  public static readonly MAX_DIM = 512;
+
+  private pipe: EditPipeline | null = null;
+  private view: HTMLCanvasElement | null = null;
+  private hasSource = false;
+  private readonly maxDim: number;
+
+  public constructor(maxDim: number = SmallPreview.MAX_DIM) {
+    if (!Number.isFinite(maxDim) || maxDim < 1)
+      throw new Error('SmallPreview: maxDim must be a number >= 1');
+    this.maxDim = Math.floor(maxDim);
+  }
+
+  /** Last render output size (downscaled source size when no geometric edit applies). */
+  public get width(): number {
+    return this.pipe?.width ?? 0;
+  }
+  public get height(): number {
+    return this.pipe?.height ?? 0;
+  }
+
+  /**
+   * Downscale `source` to <= maxDim (aspect-fit, never upscaled) through a
+   * 2D canvas and upload it once to the hidden pipeline. Replaces any
+   * previous source. Throws when WebGL/2D is unavailable.
+   */
+  public setSource(source: TexImageSource): void {
+    const dims = this.sourceDims(source);
+    if (!dims.w || !dims.h) throw new Error('setSource: source has no width/height');
+    // drawImage() rejects ImageData: stage it through a 2D canvas first.
+    const drawable = EditPipeline.toDrawableSource(source);
+    const longest = Math.max(dims.w, dims.h);
+    const scale = longest > this.maxDim ? this.maxDim / longest : 1;
+    const w = Math.max(1, Math.round(dims.w * scale));
+    const h = Math.max(1, Math.round(dims.h * scale));
+    const base = document.createElement('canvas');
+    base.width = w;
+    base.height = h;
+    const g = base.getContext('2d');
+    if (!g) throw new Error('setSource: 2D context unavailable for downscale');
+    g.imageSmoothingQuality = 'high';
+    g.drawImage(drawable, 0, 0, w, h);
+    if (!this.pipe || !this.view) {
+      const view = document.createElement('canvas');
+      this.view = view;
+      this.pipe = new EditPipeline(view);
+    }
+    this.pipe.setImage(base);
+    this.hasSource = true;
+  }
+
+  /**
+   * Render `edits` over the downscaled source and return the result as a
+   * fresh caller-owned 2D canvas (sized to the rendered output area).
+   * The hidden pipeline keeps its compiled programs between calls, so
+   * repeated renders only pay for the edit passes plus a small copy.
+   */
+  public render(edits: Edit[]): HTMLCanvasElement {
+    const pipe = this.pipe;
+    const view = this.view;
+    if (!pipe || !view || !this.hasSource)
+      throw new Error('render: no source (call setSource first)');
+    pipe.setEdits(edits);
+    const out = document.createElement('canvas');
+    out.width = pipe.width;
+    out.height = pipe.height;
+    const g = out.getContext('2d');
+    if (!g) throw new Error('render: 2D context unavailable for snapshot');
+    // preserveDrawingBuffer (set by EditPipeline) keeps this reliable.
+    g.drawImage(view, 0, 0);
+    return out;
+  }
+
+  /** Release the hidden WebGL context; render() throws until setSource again. */
+  public dispose(): void {
+    const view = this.view;
+    this.pipe = null;
+    this.view = null;
+    this.hasSource = false;
+    if (!view) return;
+    try {
+      // getContext('webgl') returns the existing context for this canvas.
+      view.getContext('webgl')?.getExtension('WEBGL_lose_context')?.loseContext();
+    } catch {
+      // Context already gone — nothing to release.
+    }
+  }
+
+  /** Pixel size of any TexImageSource upload (mirrors EditPipeline). */
+  private sourceDims(source: TexImageSource): { w: number; h: number } {
+    const anySrc = source as unknown as Record<string, unknown>;
+    const num = (v: unknown): number => (typeof v === 'number' && Number.isFinite(v) ? v : 0);
+    const nw = num(anySrc['naturalWidth']);
+    const nh = num(anySrc['naturalHeight']);
+    if (nw > 0 && nh > 0) return { w: nw, h: nh };
+    const vw = num(anySrc['videoWidth']);
+    const vh = num(anySrc['videoHeight']);
+    if (vw > 0 && vh > 0) return { w: vw, h: vh };
+    return { w: num(anySrc['width']), h: num(anySrc['height']) };
+  }
+}

package/src/transforms/flip.ts

@@ -0,0 +1,64 @@
+// flip.ts — mirror left-right (horizontal) or top-bottom (vertical).
+//
+// Pure UV swizzle (like rotate's quarter-turn path): exact under any
+// precision, dims unchanged, alpha mirrors along untouched. The VIPS side
+// (src/transforms/flip.h) uses fliphor()/flipver() and marks the edit
+// geometric so the gainmap mirrors with the base image.
+import type { ParamControl, RenderContext, Target, Transform } from './transform.js';
+
+export type FlipDirection = 'horizontal' | 'vertical';
+
+export interface FlipEdit {
+  edit: 'flip';
+  /** Mirror axis: 'horizontal' mirrors left-right. Default 'horizontal'. */
+  direction?: FlipDirection;
+}
+
+type Full = Required<FlipEdit>;
+
+const FRAG = `
+precision mediump float;
+uniform sampler2D texture;
+uniform int vertical;
+varying vec2 texCoord;
+void main() {
+  vec2 uv = vertical == 1
+    ? vec2(texCoord.x, 1.0 - texCoord.y)
+    : vec2(1.0 - texCoord.x, texCoord.y);
+  gl_FragColor = texture2D(texture, uv);
+}
+`;
+
+export class FlipTransform implements Transform<'flip', FlipEdit> {
+  public readonly edit = 'flip' as const;
+  public controls: ParamControl[] = [];
+
+  public defaults(): Full {
+    return { edit: 'flip', direction: 'horizontal' };
+  }
+
+  public validate(params: FlipEdit): string[] {
+    if (
+      params.direction !== undefined &&
+      params.direction !== 'horizontal' &&
+      params.direction !== 'vertical'
+    )
+      return ['direction must be "horizontal" or "vertical"'];
+    return [];
+  }
+
+  public normalize(params: FlipEdit): Full {
+    return {
+      edit: 'flip',
+      direction: params.direction === 'vertical' ? 'vertical' : 'horizontal',
+    };
+  }
+
+  public apply(ctx: RenderContext, from: Target, to: Target, params: Full): Target {
+    ctx.pass(FRAG, from, to, (gl, p) => {
+      const uV = gl.getUniformLocation(p, 'vertical');
+      if (uV) gl.uniform1i(uV, params.direction === 'vertical' ? 1 : 0);
+    });
+    return to;
+  }
+}