wasm-vips 0.0.4 → 0.0.6

package/lib/vips.d.ts

@@ -21,6 +21,9 @@ interface EmscriptenModule {
     ): WebAssembly.Exports;
     locateFile(url: string, scriptDirectory: string): string;
     mainScriptUrlOrBlob: Blob | File | string;
+
+    // https://github.com/kleisauke/wasm-vips/issues/12
+    workaroundCors: boolean;
 }
 
 declare module Vips {
@@ -103,9 +106,9 @@ declare module Vips {
     function operationBlock(name: string, state: boolean): void;
 
     /**
-     * Call this to shutdown libvips and the runtime of Emscripten.
-     * This is only needed on Node.js, as the thread pool of
-     * Emscripten prevents the event loop from exiting.
+     * Call this to drop caches, close plugins, terminate background threads, and finalize any internal library testing.
+     * Calling this is optional. If you don't call it, your platform will clean up for you.
+     * The only negative consequences are that the leak checker and the profiler will not work.
      */
     function shutdown(): void;
 
@@ -260,23 +263,6 @@ declare module Vips {
         static files(): number;
     }
 
-    /**
-     * An abstract class for error messages and error handling.
-     */
-    abstract class Error {
-        /**
-         * Get the error buffer as a string.
-         * @return The error buffer as a string.
-         */
-        static buffer(): string;
-
-        /**
-         * Clear and reset the error buffer.
-         * This is typically called after presenting an error to the user.
-         */
-        static clear(): void;
-    }
-
     /**
      * Handy utilities.
      */
@@ -590,6 +576,10 @@ declare module Vips {
              * loaders are permissive, that is, [[FailOn.none]].
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
         }): Image;
 
         /**
@@ -655,6 +645,10 @@ declare module Vips {
              * loaders are permissive, that is, [[FailOn.none]].
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
         }): Image;
 
         /**
@@ -677,6 +671,10 @@ declare module Vips {
              * loaders are permissive, that is, [[FailOn.none]].
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
         }): Image;
 
         /**
@@ -980,6 +978,10 @@ declare module Vips {
              * Color for background pixels.
              */
             background?: ArrayConstant
+            /**
+             * Enable line art mode.
+             */
+            line_art?: boolean
         }): {
             /**
              * Output left edge.
@@ -1460,7 +1462,7 @@ declare module Vips {
 
     /**
      * The format used for each band element.
-     * 
+     *
      * Each corresponds to a native C type for the current machine. For example,
      * #VIPS_FORMAT_USHORT is <type>unsigned short</type>.
      */
@@ -1510,11 +1512,11 @@ declare module Vips {
     /**
      * The various Porter-Duff and PDF blend modes. See vips_composite(),
      * for example.
-     * 
+     *
      * The Cairo docs have a nice explanation of all the blend modes:
-     * 
+     *
      * https://www.cairographics.org/operators
-     * 
+     *
      * The non-separable modes are not implemented.
      */
     enum BlendMode {
@@ -1622,11 +1624,11 @@ declare module Vips {
 
     /**
      * How pixels are coded.
-     * 
+     *
      * Normally, pixels are uncoded and can be manipulated as you would expect.
      * However some file formats code pixels for compression, and sometimes it's
      * useful to be able to manipulate images in the coded format.
-     * 
+     *
      * The gaps in the numbering are historical and must be maintained. Allocate
      * new numbers from the end.
      */
@@ -1649,10 +1651,10 @@ declare module Vips {
      * How the values in an image should be interpreted. For example, a
      * three-band float image of type #VIPS_INTERPRETATION_LAB should have its
      * pixels interpreted as coordinates in CIE Lab space.
-     * 
+     *
      * RGB and sRGB are treated in the same way. Use the colourspace functions if
      * you want some other behaviour.
-     * 
+     *
      * The gaps in numbering are historical and must be maintained. Allocate
      * new numbers from the end.
      */
@@ -1736,44 +1738,42 @@ declare module Vips {
     }
 
     /**
-     * See vips_image_pipelinev(). Operations can hint to the VIPS image IO
-     * system about the kind of demand geometry they prefer.
-     * 
+     * See vips_image_pipelinev(). Operations can hint
+     * the kind of demand geometry they prefer
+     * to the VIPS image IO system.
+     *
      * These demand styles are given below in order of increasing
-     * restrictiveness.  When demanding output from a pipeline,
+     * specialisation.  When demanding output from a pipeline,
      * vips_image_generate()
-     * will use the most restrictive of the styles requested by the operations
+     * will use the most general style requested by the operations
      * in the pipeline.
-     * 
-     * #VIPS_DEMAND_STYLE_THINSTRIP --- This operation would like to output strips
-     * the width of the image and a few pels high. This is option suitable for
-     * point-to-point operations, such as those in the arithmetic package.
-     * 
-     * This option is only efficient for cases where each output pel depends
-     * upon the pel in the corresponding position in the input image.
-     * 
+     *
+     * #VIPS_DEMAND_STYLE_SMALLTILE --- This is the most general demand format.
+     * Output is demanded in small (around 100x100 pel) sections. This style works
+     * reasonably efficiently, even for bizarre operations like 45 degree rotate.
+     *
      * #VIPS_DEMAND_STYLE_FATSTRIP --- This operation would like to output strips
      * the width of the image and as high as possible. This option is suitable
      * for area operations which do not violently transform coordinates, such
      * as vips_conv().
-     * 
-     * #VIPS_DEMAND_STYLE_SMALLTILE --- This is the most general demand format.
-     * Output is demanded in small (around 100x100 pel) sections. This style works
-     * reasonably efficiently, even for bizzare operations like 45 degree rotate.
-     * 
+     *
+     * #VIPS_DEMAND_STYLE_THINSTRIP --- This operation would like to output strips
+     * the width of the image and a few pels high. This option is suitable for
+     * point-to-point operations, such as those in the arithmetic package.
+     *
      * #VIPS_DEMAND_STYLE_ANY --- This image is not being demand-read from a disc
      * file (even indirectly) so any demand style is OK. It's used for things like
      * vips_black() where the pixels are calculated.
-     * 
+     *
      * See also: vips_image_pipelinev().
      */
     enum DemandStyle {
         /**
-         * Demand in small (typically 64x64 pixel) tiles
+         * Demand in small (typically 128x128 pixel) tiles
          */
         smalltile = 'smalltile',
         /**
-         * Demand in fat (typically 10 pixel high) strips
+         * Demand in fat (typically 16 pixel high) strips
          */
         fatstrip = 'fatstrip',
         /**
@@ -1843,15 +1843,15 @@ declare module Vips {
      */
     enum OperationMath2 {
         /**
-         * Pow( left, right )
+         * Pow(left, right)
          */
         pow = 'pow',
         /**
-         * Pow( right, left )
+         * Pow(right, left)
          */
         wop = 'wop',
         /**
-         * Atan2( left, right )
+         * Atan2(left, right)
          */
         atan2 = 'atan2'
     }
@@ -2007,9 +2007,9 @@ declare module Vips {
     /**
      * The type of access an operation has to supply. See vips_tilecache()
      * and #VipsForeign.
-     * 
+     *
      * @VIPS_ACCESS_RANDOM means requests can come in any order.
-     * 
+     *
      * @VIPS_ACCESS_SEQUENTIAL means requests will be top-to-bottom, but with some
      * amount of buffering behind the read point for small non-local accesses.
      */
@@ -2027,27 +2027,27 @@ declare module Vips {
 
     /**
      * See vips_embed(), vips_conv(), vips_affine() and so on.
-     * 
+     *
      * When the edges of an image are extended, you can specify
      * how you want the extension done.
-     * 
+     *
      * #VIPS_EXTEND_BLACK --- new pixels are black, ie. all bits are zero.
-     * 
+     *
      * #VIPS_EXTEND_COPY --- each new pixel takes the value of the nearest edge
      * pixel
-     * 
+     *
      * #VIPS_EXTEND_REPEAT --- the image is tiled to fill the new area
-     * 
+     *
      * #VIPS_EXTEND_MIRROR --- the image is reflected and tiled to reduce hash
      * edges
-     * 
+     *
      * #VIPS_EXTEND_WHITE --- new pixels are white, ie. all bits are set
-     * 
+     *
      * #VIPS_EXTEND_BACKGROUND --- colour set from the @background property
-     * 
+     *
      * We have to specify the exact value of each enum member since we have to
      * keep these frozen for back compat with vips7.
-     * 
+     *
      * See also: vips_embed().
      */
     enum Extend {
@@ -2121,10 +2121,10 @@ declare module Vips {
 
     /**
      * See vips_flip(), vips_join() and so on.
-     * 
+     *
      * Operations like vips_flip() need to be told whether to flip left-right or
      * top-bottom.
-     * 
+     *
      * See also: vips_flip(), vips_join().
      */
     enum Direction {
@@ -2140,10 +2140,10 @@ declare module Vips {
 
     /**
      * See vips_join() and so on.
-     * 
+     *
      * Operations like vips_join() need to be told whether to align images on the
      * low or high coordinate edge, or centre.
-     * 
+     *
      * See also: vips_join().
      */
     enum Align {
@@ -2165,11 +2165,11 @@ declare module Vips {
      * Pick the algorithm vips uses to decide image "interestingness". This is used
      * by vips_smartcrop(), for example, to decide what parts of the image to
      * keep.
-     * 
+     *
      * #VIPS_INTERESTING_NONE and #VIPS_INTERESTING_LOW mean the same -- the
      * crop is positioned at the top or left. #VIPS_INTERESTING_HIGH positions at
      * the bottom or right.
-     * 
+     *
      * See also: vips_smartcrop().
      */
     enum Interesting {
@@ -2205,9 +2205,9 @@ declare module Vips {
 
     /**
      * See vips_rot() and so on.
-     * 
+     *
      * Fixed rotate angles.
-     * 
+     *
      * See also: vips_rot().
      */
     enum Angle {
@@ -2231,9 +2231,9 @@ declare module Vips {
 
     /**
      * See vips_rot45() and so on.
-     * 
+     *
      * Fixed rotate angles.
-     * 
+     *
      * See also: vips_rot45().
      */
     enum Angle45 {
@@ -2289,10 +2289,35 @@ declare module Vips {
         approximate = 'approximate'
     }
 
+    /**
+     * Sets the word wrapping style for vips_text() when used with a maximum
+     * width.
+     *
+     * See also: vips_text().
+     */
+    enum TextWrap {
+        /**
+         * Wrap at word boundaries
+         */
+        word = 'word',
+        /**
+         * Wrap at character boundaries
+         */
+        char = 'char',
+        /**
+         * Wrap at word boundaries, but fall back to character boundaries if there is not enough space for a full word
+         */
+        word_char = 'word-char',
+        /**
+         * No wrapping
+         */
+        none = 'none'
+    }
+
     /**
      * How sensitive loaders are to errors, from never stop (very insensitive), to
      * stop on the smallest warning (very sensitive).
-     * 
+     *
      * Each one implies the ones before it, so #VIPS_FAIL_ON_ERROR implies
      * #VIPS_FAIL_ON_TRUNCATED.
      */
@@ -2317,14 +2342,17 @@ declare module Vips {
 
     /**
      * The netpbm file format to save as.
-     * 
+     *
      * #VIPS_FOREIGN_PPM_FORMAT_PBM images are single bit.
-     * 
+     *
      * #VIPS_FOREIGN_PPM_FORMAT_PGM images are 8, 16, or 32-bits, one band.
-     * 
+     *
      * #VIPS_FOREIGN_PPM_FORMAT_PPM images are 8, 16, or 32-bits, three bands.
-     * 
+     *
      * #VIPS_FOREIGN_PPM_FORMAT_PFM images are 32-bit float pixels.
+     *
+     * #VIPS_FOREIGN_PPM_FORMAT_PNM images are anymap images -- the image format
+     * is used to pick the saver.
      */
     enum ForeignPpmFormat {
         /**
@@ -2342,7 +2370,11 @@ declare module Vips {
         /**
          * Portable float map
          */
-        pfm = 'pfm'
+        pfm = 'pfm',
+        /**
+         * Portable anymap
+         */
+        pnm = 'pnm'
     }
 
     /**
@@ -2487,13 +2519,13 @@ declare module Vips {
 
     /**
      * The compression types supported by the tiff writer.
-     * 
+     *
      * Use @Q to set the jpeg compression level, default 75.
-     * 
+     *
      * Use @predictor to set the lzw or deflate prediction, default horizontal.
-     * 
+     *
      * Use @lossless to set WEBP lossless compression.
-     * 
+     *
      * Use @level to set webp and zstd compression level.
      */
     enum ForeignTiffCompression {
@@ -2570,7 +2602,7 @@ declare module Vips {
 
     /**
      * The compression format to use inside a HEIF container.
-     * 
+     *
      * This is assumed to use the same numbering as %heif_compression_format.
      */
     enum ForeignHeifCompression {
@@ -2592,10 +2624,38 @@ declare module Vips {
         av1 = 'av1'
     }
 
+    /**
+     * The selected encoder to use.
+     * If libheif hasn't been compiled with the selected encoder,
+     * we will fallback to the default encoder for the compression format.
+     */
+    enum ForeignHeifEncoder {
+        /**
+         * Auto
+         */
+        auto = 'auto',
+        /**
+         * Aom
+         */
+        aom = 'aom',
+        /**
+         * RAV1E
+         */
+        rav1e = 'rav1e',
+        /**
+         * SVT-AV1
+         */
+        svt = 'svt',
+        /**
+         * X265
+         */
+        x265 = 'x265'
+    }
+
     /**
      * Controls whether an operation should upsize, downsize, both up and
      * downsize, or force a size.
-     * 
+     *
      * See also: vips_thumbnail().
      */
     enum Size {
@@ -2689,7 +2749,7 @@ declare module Vips {
 
     /**
      * More like hit-miss, really.
-     * 
+     *
      * See also: vips_morph().
      */
     enum OperationMorphology {
@@ -2705,10 +2765,10 @@ declare module Vips {
 
     /**
      * See vips_draw_image() and so on.
-     * 
+     *
      * Operations like vips_draw_image() need to be told how to combine images
      * from two sources.
-     * 
+     *
      * See also: vips_join().
      */
     enum CombineMode {
@@ -2722,6 +2782,40 @@ declare module Vips {
         add = 'add'
     }
 
+    /**
+     * Which metadata to retain.
+     */
+    enum ForeignKeep {
+        /**
+         * Don't attach metadata
+         */
+        none = 'none',
+        /**
+         * Keep Exif metadata
+         */
+        exif = 'exif',
+        /**
+         * Keep XMP metadata
+         */
+        xmp = 'xmp',
+        /**
+         * Keep IPTC metadata
+         */
+        iptc = 'iptc',
+        /**
+         * Keep ICC metadata
+         */
+        icc = 'icc',
+        /**
+         * Keep other metadata (e.g. PNG comments and some TIFF tags)
+         */
+        other = 'other',
+        /**
+         * Keep all metadata
+         */
+        all = 'all'
+    }
+
     /**
      * http://www.w3.org/TR/PNG-Filters.html
      * The values mirror those of png.h in libpng.
@@ -2779,6 +2873,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -2891,6 +2989,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -2932,6 +3034,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -2975,6 +3081,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -3000,6 +3110,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -3063,11 +3177,11 @@ declare module Vips {
          */
         static gifload(filename: string, options?: {
             /**
-             * Load this many pages.
+             * Number of pages to load, -1 for all.
              */
             n?: number
             /**
-             * Load this page from the file.
+             * First page to load.
              */
             page?: number
             /**
@@ -3082,6 +3196,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -3096,11 +3214,11 @@ declare module Vips {
          */
         static gifloadBuffer(buffer: Blob, options?: {
             /**
-             * Load this many pages.
+             * Number of pages to load, -1 for all.
              */
             n?: number
             /**
-             * Load this page from the file.
+             * First page to load.
              */
             page?: number
             /**
@@ -3115,6 +3233,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -3129,11 +3251,11 @@ declare module Vips {
          */
         static gifloadSource(source: Source, options?: {
             /**
-             * Load this many pages.
+             * Number of pages to load, -1 for all.
              */
             n?: number
             /**
-             * Load this page from the file.
+             * First page to load.
              */
             page?: number
             /**
@@ -3148,6 +3270,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -3176,11 +3302,11 @@ declare module Vips {
          */
         static heifload(filename: string, options?: {
             /**
-             * Load this page from the file.
+             * First page to load.
              */
             page?: number
             /**
-             * Load this many pages.
+             * Number of pages to load, -1 for all.
              */
             n?: number
             /**
@@ -3203,6 +3329,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -3217,11 +3347,11 @@ declare module Vips {
          */
         static heifloadBuffer(buffer: Blob, options?: {
             /**
-             * Load this page from the file.
+             * First page to load.
              */
             page?: number
             /**
-             * Load this many pages.
+             * Number of pages to load, -1 for all.
              */
             n?: number
             /**
@@ -3244,6 +3374,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -3258,11 +3392,11 @@ declare module Vips {
          */
         static heifloadSource(source: Source, options?: {
             /**
-             * Load this page from the file.
+             * First page to load.
              */
             page?: number
             /**
-             * Load this many pages.
+             * Number of pages to load, -1 for all.
              */
             n?: number
             /**
@@ -3285,6 +3419,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -3334,6 +3472,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -3363,6 +3505,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -3392,6 +3538,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -3429,6 +3579,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -3466,6 +3620,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -3503,6 +3661,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -3528,6 +3690,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -3553,6 +3719,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -3578,6 +3748,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -3614,11 +3788,11 @@ declare module Vips {
              */
             density?: string
             /**
-             * Load this page from the file.
+             * First page to load.
              */
             page?: number
             /**
-             * Load this many pages.
+             * Number of pages to load, -1 for all.
              */
             n?: number
             /**
@@ -3633,6 +3807,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -3651,11 +3829,11 @@ declare module Vips {
              */
             density?: string
             /**
-             * Load this page from the file.
+             * First page to load.
              */
             page?: number
             /**
-             * Load this many pages.
+             * Number of pages to load, -1 for all.
              */
             n?: number
             /**
@@ -3670,6 +3848,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -3983,6 +4165,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -4008,6 +4194,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -4033,6 +4223,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -4058,6 +4252,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -4083,6 +4281,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -4108,6 +4310,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -4121,10 +4327,6 @@ declare module Vips {
          * @return Output image.
          */
         static openslideload(filename: string, options?: {
-            /**
-             * Attach all associated images.
-             */
-            attach_associated?: boolean
             /**
              * Load this level from the file.
              */
@@ -4137,6 +4339,14 @@ declare module Vips {
              * Load this associated image.
              */
             associated?: string
+            /**
+             * Attach all associated images.
+             */
+            attach_associated?: boolean
+            /**
+             * Output rgb (not rgba).
+             */
+            rgb?: boolean
             /**
              * Force open via memory.
              */
@@ -4149,6 +4359,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -4162,10 +4376,6 @@ declare module Vips {
          * @return Output image.
          */
         static openslideloadSource(source: Source, options?: {
-            /**
-             * Attach all associated images.
-             */
-            attach_associated?: boolean
             /**
              * Load this level from the file.
              */
@@ -4178,6 +4388,14 @@ declare module Vips {
              * Load this associated image.
              */
             associated?: string
+            /**
+             * Attach all associated images.
+             */
+            attach_associated?: boolean
+            /**
+             * Output rgb (not rgba).
+             */
+            rgb?: boolean
             /**
              * Force open via memory.
              */
@@ -4190,6 +4408,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -4204,27 +4426,27 @@ declare module Vips {
          */
         static pdfload(filename: string, options?: {
             /**
-             * Load this page from the file.
+             * First page to load.
              */
             page?: number
             /**
-             * Load this many pages.
+             * Number of pages to load, -1 for all.
              */
             n?: number
             /**
-             * Render at this dpi.
+             * Dpi to render at.
              */
             dpi?: number
             /**
-             * Scale output by this factor.
+             * Factor to scale by.
              */
             scale?: number
             /**
-             * Background value.
+             * Background colour.
              */
             background?: ArrayConstant
             /**
-             * Decrypt with this password.
+             * Password to decrypt with.
              */
             password?: string
             /**
@@ -4239,6 +4461,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -4253,27 +4479,27 @@ declare module Vips {
          */
         static pdfloadBuffer(buffer: Blob, options?: {
             /**
-             * Load this page from the file.
+             * First page to load.
              */
             page?: number
             /**
-             * Load this many pages.
+             * Number of pages to load, -1 for all.
              */
             n?: number
             /**
-             * Render at this dpi.
+             * Dpi to render at.
              */
             dpi?: number
             /**
-             * Scale output by this factor.
+             * Factor to scale by.
              */
             scale?: number
             /**
-             * Background value.
+             * Background colour.
              */
             background?: ArrayConstant
             /**
-             * Decrypt with this password.
+             * Password to decrypt with.
              */
             password?: string
             /**
@@ -4288,6 +4514,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -4302,27 +4532,27 @@ declare module Vips {
          */
         static pdfloadSource(source: Source, options?: {
             /**
-             * Load this page from the file.
+             * First page to load.
              */
             page?: number
             /**
-             * Load this many pages.
+             * Number of pages to load, -1 for all.
              */
             n?: number
             /**
-             * Render at this dpi.
+             * Dpi to render at.
              */
             dpi?: number
             /**
-             * Scale output by this factor.
+             * Factor to scale by.
              */
             scale?: number
             /**
-             * Background value.
+             * Background colour.
              */
             background?: ArrayConstant
             /**
-             * Decrypt with this password.
+             * Password to decrypt with.
              */
             password?: string
             /**
@@ -4337,6 +4567,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -4388,6 +4622,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -4417,6 +4655,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -4446,6 +4688,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -4471,6 +4717,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -4496,6 +4746,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -4528,6 +4782,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -4553,6 +4811,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -4578,6 +4840,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -4618,6 +4884,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -4684,6 +4954,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -4721,6 +4995,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -4758,6 +5036,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -4823,17 +5105,13 @@ declare module Vips {
              */
             align?: Align | Enum
             /**
-             * Enable rgba output.
+             * Justify lines.
              */
-            rgba?: boolean
+            justify?: boolean
             /**
              * Dpi to render at.
              */
             dpi?: number
-            /**
-             * Justify lines.
-             */
-            justify?: boolean
             /**
              * Line spacing.
              */
@@ -4842,6 +5120,14 @@ declare module Vips {
              * Load this font file.
              */
             fontfile?: string
+            /**
+             * Enable rgba output.
+             */
+            rgba?: boolean
+            /**
+             * Wrap lines on word or character boundaries.
+             */
+            wrap?: TextWrap | Enum
             /**
              * Dpi selected by autofit (output).
              */
@@ -5002,15 +5288,15 @@ declare module Vips {
          */
         static tiffload(filename: string, options?: {
             /**
-             * Load this page from the image.
+             * First page to load.
              */
             page?: number
             /**
-             * Select subifd index.
+             * Subifd index.
              */
             subifd?: number
             /**
-             * Load this many pages.
+             * Number of pages to load, -1 for all.
              */
             n?: number
             /**
@@ -5029,6 +5315,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -5043,15 +5333,15 @@ declare module Vips {
          */
         static tiffloadBuffer(buffer: Blob, options?: {
             /**
-             * Load this page from the image.
+             * First page to load.
              */
             page?: number
             /**
-             * Select subifd index.
+             * Subifd index.
              */
             subifd?: number
             /**
-             * Load this many pages.
+             * Number of pages to load, -1 for all.
              */
             n?: number
             /**
@@ -5070,6 +5360,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -5084,15 +5378,15 @@ declare module Vips {
          */
         static tiffloadSource(source: Source, options?: {
             /**
-             * Load this page from the image.
+             * First page to load.
              */
             page?: number
             /**
-             * Select subifd index.
+             * Subifd index.
              */
             subifd?: number
             /**
-             * Load this many pages.
+             * Number of pages to load, -1 for all.
              */
             n?: number
             /**
@@ -5111,6 +5405,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -5184,6 +5482,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -5209,6 +5511,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -5223,15 +5529,15 @@ declare module Vips {
          */
         static webpload(filename: string, options?: {
             /**
-             * Load this page from the file.
+             * First page to load.
              */
             page?: number
             /**
-             * Load this many pages.
+             * Number of pages to load, -1 for all.
              */
             n?: number
             /**
-             * Scale factor on load.
+             * Factor to scale by.
              */
             scale?: number
             /**
@@ -5246,6 +5552,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -5260,15 +5570,15 @@ declare module Vips {
          */
         static webploadBuffer(buffer: Blob, options?: {
             /**
-             * Load this page from the file.
+             * First page to load.
              */
             page?: number
             /**
-             * Load this many pages.
+             * Number of pages to load, -1 for all.
              */
             n?: number
             /**
-             * Scale factor on load.
+             * Factor to scale by.
              */
             scale?: number
             /**
@@ -5283,6 +5593,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -5297,15 +5611,15 @@ declare module Vips {
          */
         static webploadSource(source: Source, options?: {
             /**
-             * Load this page from the file.
+             * First page to load.
              */
             page?: number
             /**
-             * Load this many pages.
+             * Number of pages to load, -1 for all.
              */
             n?: number
             /**
-             * Scale factor on load.
+             * Factor to scale by.
              */
             scale?: number
             /**
@@ -5320,6 +5634,10 @@ declare module Vips {
              * Error level to fail on.
              */
             fail_on?: FailOn | Enum
+            /**
+             * Don't use a cached result for this operation.
+             */
+            revalidate?: boolean
             /**
              * Flags for this file (output).
              */
@@ -5866,7 +6184,7 @@ declare module Vips {
         convi(mask: Image | ArrayConstant): Image;
 
         /**
-         * Seperable convolution operation.
+         * Separable convolution operation.
          * @param mask Input matrix image.
          * @param options Optional options.
          * @return Output image.
@@ -5962,9 +6280,9 @@ declare module Vips {
              */
             separator?: string
             /**
-             * Strip all metadata from image.
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -5973,6 +6291,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): void;
 
         /**
@@ -5986,9 +6308,9 @@ declare module Vips {
              */
             separator?: string
             /**
-             * Strip all metadata from image.
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -5997,6 +6319,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): void;
 
         /**
@@ -6147,9 +6473,9 @@ declare module Vips {
          */
         dzsave(filename: string, options?: {
             /**
-             * Base name to save to.
+             * Image name.
              */
-            basename?: string
+            imagename?: string
             /**
              * Directory layout.
              */
@@ -6194,18 +6520,18 @@ declare module Vips {
              * Skip tiles which are nearly equal to the background.
              */
             skip_blanks?: number
-            /**
-             * Don't strip tile metadata.
-             */
-            no_strip?: boolean
             /**
              * Resource id.
              */
             id?: string
             /**
-             * Strip all metadata from image.
+             * Q factor.
+             */
+            Q?: number
+            /**
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -6214,6 +6540,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): void;
 
         /**
@@ -6223,9 +6553,9 @@ declare module Vips {
          */
         dzsaveBuffer(options?: {
             /**
-             * Base name to save to.
+             * Image name.
              */
-            basename?: string
+            imagename?: string
             /**
              * Directory layout.
              */
@@ -6270,18 +6600,18 @@ declare module Vips {
              * Skip tiles which are nearly equal to the background.
              */
             skip_blanks?: number
-            /**
-             * Don't strip tile metadata.
-             */
-            no_strip?: boolean
             /**
              * Resource id.
              */
             id?: string
             /**
-             * Strip all metadata from image.
+             * Q factor.
+             */
+            Q?: number
+            /**
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -6290,8 +6620,12 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
-        }): Uint8Array;
-
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
+        }): Uint8Array;
+
         /**
          * Save image to deepzoom target.
          * @param target Target to save to.
@@ -6299,9 +6633,9 @@ declare module Vips {
          */
         dzsaveTarget(target: Target, options?: {
             /**
-             * Base name to save to.
+             * Image name.
              */
-            basename?: string
+            imagename?: string
             /**
              * Directory layout.
              */
@@ -6346,18 +6680,18 @@ declare module Vips {
              * Skip tiles which are nearly equal to the background.
              */
             skip_blanks?: number
-            /**
-             * Don't strip tile metadata.
-             */
-            no_strip?: boolean
             /**
              * Resource id.
              */
             id?: string
             /**
-             * Strip all metadata from image.
+             * Q factor.
              */
-            strip?: boolean
+            Q?: number
+            /**
+             * Which metadata to retain.
+             */
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -6366,6 +6700,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): void;
 
         /**
@@ -6443,9 +6781,9 @@ declare module Vips {
          */
         fitssave(filename: string, options?: {
             /**
-             * Strip all metadata from image.
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -6454,6 +6792,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): void;
 
         /**
@@ -6558,17 +6900,21 @@ declare module Vips {
              */
             interframe_maxerror?: number
             /**
-             * Reoptimise colour palettes.
+             * Reuse palette from input.
              */
-            reoptimise?: boolean
+            reuse?: boolean
             /**
              * Maximum inter-palette error for palette reusage.
              */
             interpalette_maxerror?: number
             /**
-             * Strip all metadata from image.
+             * Generate an interlaced (progressive) gif.
              */
-            strip?: boolean
+            interlace?: boolean
+            /**
+             * Which metadata to retain.
+             */
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -6577,6 +6923,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): void;
 
         /**
@@ -6602,17 +6952,21 @@ declare module Vips {
              */
             interframe_maxerror?: number
             /**
-             * Reoptimise colour palettes.
+             * Reuse palette from input.
              */
-            reoptimise?: boolean
+            reuse?: boolean
             /**
              * Maximum inter-palette error for palette reusage.
              */
             interpalette_maxerror?: number
             /**
-             * Strip all metadata from image.
+             * Generate an interlaced (progressive) gif.
+             */
+            interlace?: boolean
+            /**
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -6621,6 +6975,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): Uint8Array;
 
         /**
@@ -6646,17 +7004,21 @@ declare module Vips {
              */
             interframe_maxerror?: number
             /**
-             * Reoptimise colour palettes.
+             * Reuse palette from input.
              */
-            reoptimise?: boolean
+            reuse?: boolean
             /**
              * Maximum inter-palette error for palette reusage.
              */
             interpalette_maxerror?: number
             /**
-             * Strip all metadata from image.
+             * Generate an interlaced (progressive) gif.
              */
-            strip?: boolean
+            interlace?: boolean
+            /**
+             * Which metadata to retain.
+             */
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -6665,6 +7027,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): void;
 
         /**
@@ -6742,9 +7108,13 @@ declare module Vips {
              */
             subsample_mode?: ForeignSubsample | Enum
             /**
-             * Strip all metadata from image.
+             * Select encoder to use.
              */
-            strip?: boolean
+            encoder?: ForeignHeifEncoder | Enum
+            /**
+             * Which metadata to retain.
+             */
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -6753,6 +7123,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): void;
 
         /**
@@ -6786,9 +7160,13 @@ declare module Vips {
              */
             subsample_mode?: ForeignSubsample | Enum
             /**
-             * Strip all metadata from image.
+             * Select encoder to use.
+             */
+            encoder?: ForeignHeifEncoder | Enum
+            /**
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -6797,6 +7175,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): Uint8Array;
 
         /**
@@ -6830,9 +7212,13 @@ declare module Vips {
              */
             subsample_mode?: ForeignSubsample | Enum
             /**
-             * Strip all metadata from image.
+             * Select encoder to use.
+             */
+            encoder?: ForeignHeifEncoder | Enum
+            /**
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -6841,6 +7227,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): void;
 
         /**
@@ -7184,9 +7574,9 @@ declare module Vips {
              */
             subsample_mode?: ForeignSubsample | Enum
             /**
-             * Strip all metadata from image.
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -7195,6 +7585,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): void;
 
         /**
@@ -7224,9 +7618,9 @@ declare module Vips {
              */
             subsample_mode?: ForeignSubsample | Enum
             /**
-             * Strip all metadata from image.
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -7235,6 +7629,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): Uint8Array;
 
         /**
@@ -7264,9 +7662,9 @@ declare module Vips {
              */
             subsample_mode?: ForeignSubsample | Enum
             /**
-             * Strip all metadata from image.
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -7275,6 +7673,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): void;
 
         /**
@@ -7287,10 +7689,6 @@ declare module Vips {
              * Q factor.
              */
             Q?: number
-            /**
-             * Icc profile to embed.
-             */
-            profile?: string
             /**
              * Compute optimal huffman coding tables.
              */
@@ -7324,9 +7722,9 @@ declare module Vips {
              */
             restart_interval?: number
             /**
-             * Strip all metadata from image.
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -7335,6 +7733,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): void;
 
         /**
@@ -7347,10 +7749,6 @@ declare module Vips {
              * Q factor.
              */
             Q?: number
-            /**
-             * Icc profile to embed.
-             */
-            profile?: string
             /**
              * Compute optimal huffman coding tables.
              */
@@ -7384,9 +7782,9 @@ declare module Vips {
              */
             restart_interval?: number
             /**
-             * Strip all metadata from image.
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -7395,6 +7793,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): Uint8Array;
 
         /**
@@ -7406,10 +7808,6 @@ declare module Vips {
              * Q factor.
              */
             Q?: number
-            /**
-             * Icc profile to embed.
-             */
-            profile?: string
             /**
              * Compute optimal huffman coding tables.
              */
@@ -7443,9 +7841,9 @@ declare module Vips {
              */
             restart_interval?: number
             /**
-             * Strip all metadata from image.
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -7454,6 +7852,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): void;
 
         /**
@@ -7466,10 +7868,6 @@ declare module Vips {
              * Q factor.
              */
             Q?: number
-            /**
-             * Icc profile to embed.
-             */
-            profile?: string
             /**
              * Compute optimal huffman coding tables.
              */
@@ -7503,9 +7901,9 @@ declare module Vips {
              */
             restart_interval?: number
             /**
-             * Strip all metadata from image.
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -7514,6 +7912,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): void;
 
         /**
@@ -7543,9 +7945,9 @@ declare module Vips {
              */
             Q?: number
             /**
-             * Strip all metadata from image.
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -7554,6 +7956,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): void;
 
         /**
@@ -7583,9 +7989,9 @@ declare module Vips {
              */
             Q?: number
             /**
-             * Strip all metadata from image.
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -7594,6 +8000,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): Uint8Array;
 
         /**
@@ -7623,9 +8033,9 @@ declare module Vips {
              */
             Q?: number
             /**
-             * Strip all metadata from image.
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -7634,6 +8044,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): void;
 
         /**
@@ -7713,9 +8127,9 @@ declare module Vips {
              */
             bitdepth?: number
             /**
-             * Strip all metadata from image.
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -7724,6 +8138,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): void;
 
         /**
@@ -7753,9 +8171,9 @@ declare module Vips {
              */
             bitdepth?: number
             /**
-             * Strip all metadata from image.
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -7764,6 +8182,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): Uint8Array;
 
         /**
@@ -7864,9 +8286,9 @@ declare module Vips {
          */
         matrixprint(options?: {
             /**
-             * Strip all metadata from image.
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -7875,6 +8297,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): void;
 
         /**
@@ -7884,9 +8310,9 @@ declare module Vips {
          */
         matrixsave(filename: string, options?: {
             /**
-             * Strip all metadata from image.
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -7895,6 +8321,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): void;
 
         /**
@@ -7904,9 +8334,9 @@ declare module Vips {
          */
         matrixsaveTarget(target: Target, options?: {
             /**
-             * Strip all metadata from image.
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -7915,6 +8345,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): void;
 
         /**
@@ -8149,9 +8583,9 @@ declare module Vips {
          */
         niftisave(filename: string, options?: {
             /**
-             * Strip all metadata from image.
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -8160,6 +8594,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): void;
 
         /**
@@ -8190,10 +8628,6 @@ declare module Vips {
              * Interlace image.
              */
             interlace?: boolean
-            /**
-             * Icc profile to embed.
-             */
-            profile?: string
             /**
              * Libspng row filter flag(s).
              */
@@ -8219,9 +8653,9 @@ declare module Vips {
              */
             effort?: number
             /**
-             * Strip all metadata from image.
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -8230,6 +8664,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): void;
 
         /**
@@ -8246,10 +8684,6 @@ declare module Vips {
              * Interlace image.
              */
             interlace?: boolean
-            /**
-             * Icc profile to embed.
-             */
-            profile?: string
             /**
              * Libspng row filter flag(s).
              */
@@ -8275,9 +8709,9 @@ declare module Vips {
              */
             effort?: number
             /**
-             * Strip all metadata from image.
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -8286,6 +8720,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): Uint8Array;
 
         /**
@@ -8302,10 +8740,6 @@ declare module Vips {
              * Interlace image.
              */
             interlace?: boolean
-            /**
-             * Icc profile to embed.
-             */
-            profile?: string
             /**
              * Libspng row filter flag(s).
              */
@@ -8331,9 +8765,9 @@ declare module Vips {
              */
             effort?: number
             /**
-             * Strip all metadata from image.
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -8342,6 +8776,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): void;
 
         /**
@@ -8363,9 +8801,9 @@ declare module Vips {
              */
             bitdepth?: number
             /**
-             * Strip all metadata from image.
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -8374,6 +8812,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): void;
 
         /**
@@ -8395,9 +8837,9 @@ declare module Vips {
              */
             bitdepth?: number
             /**
-             * Strip all metadata from image.
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -8406,6 +8848,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): void;
 
         /**
@@ -8420,6 +8866,12 @@ declare module Vips {
             max_alpha?: number
         }): Image;
 
+        /**
+         * Prewitt edge detector.
+         * @return Output image.
+         */
+        prewitt(): Image;
+
         /**
          * Resample an image with a quadratic transform.
          * @param coeff Coefficient matrix.
@@ -8446,9 +8898,9 @@ declare module Vips {
          */
         radsave(filename: string, options?: {
             /**
-             * Strip all metadata from image.
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -8457,6 +8909,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): void;
 
         /**
@@ -8466,9 +8922,9 @@ declare module Vips {
          */
         radsaveBuffer(options?: {
             /**
-             * Strip all metadata from image.
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -8477,6 +8933,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): Uint8Array;
 
         /**
@@ -8486,9 +8946,9 @@ declare module Vips {
          */
         radsaveTarget(target: Target, options?: {
             /**
-             * Strip all metadata from image.
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -8497,6 +8957,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): void;
 
         /**
@@ -8515,9 +8979,9 @@ declare module Vips {
          */
         rawsave(filename: string, options?: {
             /**
-             * Strip all metadata from image.
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -8526,6 +8990,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): void;
 
         /**
@@ -8535,9 +9003,9 @@ declare module Vips {
          */
         rawsaveFd(fd: number, options?: {
             /**
-             * Strip all metadata from image.
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -8546,6 +9014,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): void;
 
         /**
@@ -8768,6 +9240,12 @@ declare module Vips {
             log?: boolean
         }): Image;
 
+        /**
+         * Scharr edge detector.
+         * @return Output image.
+         */
+        scharr(): Image;
+
         /**
          * Check sequential access.
          * @param options Optional options.
@@ -8910,6 +9388,18 @@ declare module Vips {
              * How to measure interestingness.
              */
             interesting?: Interesting | Enum
+            /**
+             * Input image already has premultiplied alpha.
+             */
+            premultiplied?: boolean
+            /**
+             * Horizontal position of attention centre (output).
+             */
+            attention_x?: number | undefined
+            /**
+             * Vertical position of attention centre (output).
+             */
+            attention_y?: number | undefined
         }): Image;
 
         /**
@@ -9047,10 +9537,6 @@ declare module Vips {
              * Compression prediction.
              */
             predictor?: ForeignTiffPredictor | Enum
-            /**
-             * Icc profile to embed.
-             */
-            profile?: string
             /**
              * Write a tiled tiff.
              */
@@ -9120,9 +9606,9 @@ declare module Vips {
              */
             premultiply?: boolean
             /**
-             * Strip all metadata from image.
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -9131,6 +9617,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): void;
 
         /**
@@ -9151,10 +9641,6 @@ declare module Vips {
              * Compression prediction.
              */
             predictor?: ForeignTiffPredictor | Enum
-            /**
-             * Icc profile to embed.
-             */
-            profile?: string
             /**
              * Write a tiled tiff.
              */
@@ -9224,9 +9710,9 @@ declare module Vips {
              */
             premultiply?: boolean
             /**
-             * Strip all metadata from image.
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -9235,6 +9721,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): Uint8Array;
 
         /**
@@ -9255,10 +9745,6 @@ declare module Vips {
              * Compression prediction.
              */
             predictor?: ForeignTiffPredictor | Enum
-            /**
-             * Icc profile to embed.
-             */
-            profile?: string
             /**
              * Write a tiled tiff.
              */
@@ -9328,9 +9814,9 @@ declare module Vips {
              */
             premultiply?: boolean
             /**
-             * Strip all metadata from image.
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -9339,6 +9825,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): void;
 
         /**
@@ -9408,9 +9898,9 @@ declare module Vips {
          */
         vipssave(filename: string, options?: {
             /**
-             * Strip all metadata from image.
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -9419,6 +9909,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): void;
 
         /**
@@ -9428,9 +9922,9 @@ declare module Vips {
          */
         vipssaveTarget(target: Target, options?: {
             /**
-             * Strip all metadata from image.
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -9439,10 +9933,14 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): void;
 
         /**
-         * Save image to webp file.
+         * Save as webp.
          * @param filename Filename to save to.
          * @param options Optional options.
          */
@@ -9487,18 +9985,14 @@ declare module Vips {
              * Level of cpu effort to reduce file size.
              */
             effort?: number
-            /**
-             * Icc profile to embed.
-             */
-            profile?: string
             /**
              * Allow mixed encoding (might reduce file size).
              */
             mixed?: boolean
             /**
-             * Strip all metadata from image.
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -9507,10 +10001,14 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): void;
 
         /**
-         * Save image to webp buffer.
+         * Save as webp.
          * @param options Optional options.
          * @return Buffer to save to.
          */
@@ -9556,17 +10054,80 @@ declare module Vips {
              */
             effort?: number
             /**
-             * Icc profile to embed.
+             * Allow mixed encoding (might reduce file size).
+             */
+            mixed?: boolean
+            /**
+             * Which metadata to retain.
+             */
+            keep?: ForeignKeep | Flag
+            /**
+             * Background value.
+             */
+            background?: ArrayConstant
+            /**
+             * Set page height for multipage save.
+             */
+            page_height?: number
+            /**
+             * Filename of icc profile to embed.
              */
             profile?: string
+        }): Uint8Array;
+
+        /**
+         * Save image to webp mime.
+         * @param options Optional options.
+         */
+        webpsaveMime(options?: {
+            /**
+             * Q factor.
+             */
+            Q?: number
+            /**
+             * Enable lossless compression.
+             */
+            lossless?: boolean
+            /**
+             * Preset for lossy compression.
+             */
+            preset?: ForeignWebpPreset | Enum
+            /**
+             * Enable high quality chroma subsampling.
+             */
+            smart_subsample?: boolean
+            /**
+             * Enable preprocessing in lossless mode (uses q).
+             */
+            near_lossless?: boolean
+            /**
+             * Change alpha plane fidelity for lossy compression.
+             */
+            alpha_q?: number
+            /**
+             * Optimise for minimum size.
+             */
+            min_size?: boolean
+            /**
+             * Minimum number of frames between key frames.
+             */
+            kmin?: number
+            /**
+             * Maximum number of frames between key frames.
+             */
+            kmax?: number
+            /**
+             * Level of cpu effort to reduce file size.
+             */
+            effort?: number
             /**
              * Allow mixed encoding (might reduce file size).
              */
             mixed?: boolean
             /**
-             * Strip all metadata from image.
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -9575,10 +10136,14 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
-        }): Uint8Array;
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
+        }): void;
 
         /**
-         * Save image to webp target.
+         * Save as webp.
          * @param target Target to save to.
          * @param options Optional options.
          */
@@ -9623,18 +10188,14 @@ declare module Vips {
              * Level of cpu effort to reduce file size.
              */
             effort?: number
-            /**
-             * Icc profile to embed.
-             */
-            profile?: string
             /**
              * Allow mixed encoding (might reduce file size).
              */
             mixed?: boolean
             /**
-             * Strip all metadata from image.
+             * Which metadata to retain.
              */
-            strip?: boolean
+            keep?: ForeignKeep | Flag
             /**
              * Background value.
              */
@@ -9643,6 +10204,10 @@ declare module Vips {
              * Set page height for multipage save.
              */
             page_height?: number
+            /**
+             * Filename of icc profile to embed.
+             */
+            profile?: string
         }): void;
 
         /**