@cloudflare/workers-types 4.20250321.0 → 4.20250401.0

package/2021-11-03/index.d.ts

@@ -4518,8 +4518,10 @@ interface BasicImageTransformations {
    *    (white by default). Use of this mode is not recommended, as the same
    *    effect can be more efficiently achieved with the contain mode and the
    *    CSS object-fit: contain property.
+   *  - squeeze: Stretches and deforms to the width and height given, even if it
+   *    breaks aspect ratio
    */
-  fit?: "scale-down" | "contain" | "cover" | "crop" | "pad";
+  fit?: "scale-down" | "contain" | "cover" | "crop" | "pad" | "squeeze";
   /**
    * When cropping with fit: "cover", this defines the side or point that should
    * be left uncropped. The value is either a string
@@ -4539,6 +4541,7 @@ interface BasicImageTransformations {
     | "bottom"
     | "center"
     | "auto"
+    | "entropy"
     | BasicImageTransformationsGravityCoordinates;
   /**
    * Background color to add underneath the image. Applies only to images with
@@ -4553,8 +4556,9 @@ interface BasicImageTransformations {
   rotate?: 0 | 90 | 180 | 270 | 360;
 }
 interface BasicImageTransformationsGravityCoordinates {
-  x: number;
-  y: number;
+  x?: number;
+  y?: number;
+  mode?: "remainder" | "box-center";
 }
 /**
  * In addition to the properties you can set in the RequestInit dict
@@ -4660,23 +4664,43 @@ interface RequestInitCfPropertiesImage extends BasicImageTransformations {
    */
   dpr?: number;
   /**
-   * An object with four properties {left, top, right, bottom} that specify
-   * a number of pixels to cut off on each side. Allows removal of borders
-   * or cutting out a specific fragment of an image. Trimming is performed
-   * before resizing or rotation. Takes dpr into account.
-   */
-  trim?: {
-    left?: number;
-    top?: number;
-    right?: number;
-    bottom?: number;
-  };
+   * Allows you to trim your image. Takes dpr into account and is performed before
+   * resizing or rotation.
+   *
+   * It can be used as:
+   * - left, top, right, bottom - it will specify the number of pixels to cut
+   *   off each side
+   * - width, height - the width/height you'd like to end up with - can be used
+   *   in combination with the properties above
+   * - border - this will automatically trim the surroundings of an image based on
+   *   it's color. It consists of three properties:
+   *    - color: rgb or hex representation of the color you wish to trim (todo: verify the rgba bit)
+   *    - tolerance: difference from color to treat as color
+   *    - keep: the number of pixels of border to keep
+   */
+  trim?:
+    | "border"
+    | {
+        top?: number;
+        bottom?: number;
+        left?: number;
+        right?: number;
+        width?: number;
+        height?: number;
+        border?:
+          | boolean
+          | {
+              color?: string;
+              tolerance?: number;
+              keep?: number;
+            };
+      };
   /**
    * Quality setting from 1-100 (useful values are in 60-90 range). Lower values
    * make images look worse, but load faster. The default is 85. It applies only
    * to JPEG and WebP images. It doesn’t have any effect on PNG.
    */
-  quality?: number;
+  quality?: number | "low" | "medium-low" | "medium-high" | "high";
   /**
    * Output format to generate. It can be:
    *  - avif: generate images in AVIF format.
@@ -4688,7 +4712,15 @@ interface RequestInitCfPropertiesImage extends BasicImageTransformations {
    * - jpeg: generate images in JPEG format.
    * - png: generate images in PNG format.
    */
-  format?: "avif" | "webp" | "json" | "jpeg" | "png";
+  format?:
+    | "avif"
+    | "webp"
+    | "json"
+    | "jpeg"
+    | "png"
+    | "baseline-jpeg"
+    | "png-force"
+    | "svg";
   /**
    * Whether to preserve animation frames from input files. Default is true.
    * Setting it to false reduces animations to still images. This setting is
@@ -4768,6 +4800,18 @@ interface RequestInitCfPropertiesImage extends BasicImageTransformations {
    * 0.5 darkens the image, and a value of 2.0 lightens the image. 0 is ignored.
    */
   gamma?: number;
+  /**
+   * Increase contrast by a factor. A value of 1.0 equals no change, a value of
+   * 0.5 equals low contrast, and a value of 2.0 equals high contrast. 0 is
+   * ignored.
+   */
+  saturation?: number;
+  /**
+   * Flips the images horizontally, vertically, or both. Flipping is applied before
+   * rotation, so if you apply flip=h,rotate=90 then the image will be flipped
+   * horizontally, then rotated by 90 degrees.
+   */
+  flip?: "h" | "v" | "hv";
   /**
    * Slightly reduces latency on a cache miss by selecting a
    * quickest-to-compress file format, at a cost of increased file size and
@@ -5681,7 +5725,26 @@ type ImageInfoResponse =
       height: number;
     };
 type ImageTransform = {
+  width?: number;
+  height?: number;
+  background?: string;
+  blur?: number;
+  border?:
+    | {
+        color?: string;
+        width?: number;
+      }
+    | {
+        top?: number;
+        bottom?: number;
+        left?: number;
+        right?: number;
+      };
+  brightness?: number;
+  contrast?: number;
   fit?: "scale-down" | "contain" | "pad" | "squeeze" | "cover" | "crop";
+  flip?: "h" | "v" | "hv";
+  gamma?: number;
   gravity?:
     | "left"
     | "right"
@@ -5690,45 +5753,31 @@ type ImageTransform = {
     | "center"
     | "auto"
     | "entropy"
-    | "face"
     | {
         x?: number;
         y?: number;
         mode: "remainder" | "box-center";
       };
-  trim?: {
-    top?: number;
-    bottom?: number;
-    left?: number;
-    right?: number;
-    width?: number;
-    height?: number;
-    border?:
-      | boolean
-      | {
-          color?: string;
-          tolerance?: number;
-          keep?: number;
-        };
-  };
-  width?: number;
-  height?: number;
-  background?: string;
-  rotate?: number;
+  rotate?: 0 | 90 | 180 | 270;
+  saturation?: number;
   sharpen?: number;
-  blur?: number;
-  contrast?: number;
-  brightness?: number;
-  gamma?: number;
-  border?: {
-    color?: string;
-    width?: number;
-    top?: number;
-    bottom?: number;
-    left?: number;
-    right?: number;
-  };
-  zoom?: number;
+  trim?:
+    | "border"
+    | {
+        top?: number;
+        bottom?: number;
+        left?: number;
+        right?: number;
+        width?: number;
+        height?: number;
+        border?:
+          | boolean
+          | {
+              color?: string;
+              tolerance?: number;
+              keep?: number;
+            };
+      };
 };
 type ImageDrawOptions = {
   opacity?: number;

package/2021-11-03/index.ts

@@ -4532,8 +4532,10 @@ export interface BasicImageTransformations {
    *    (white by default). Use of this mode is not recommended, as the same
    *    effect can be more efficiently achieved with the contain mode and the
    *    CSS object-fit: contain property.
+   *  - squeeze: Stretches and deforms to the width and height given, even if it
+   *    breaks aspect ratio
    */
-  fit?: "scale-down" | "contain" | "cover" | "crop" | "pad";
+  fit?: "scale-down" | "contain" | "cover" | "crop" | "pad" | "squeeze";
   /**
    * When cropping with fit: "cover", this defines the side or point that should
    * be left uncropped. The value is either a string
@@ -4553,6 +4555,7 @@ export interface BasicImageTransformations {
     | "bottom"
     | "center"
     | "auto"
+    | "entropy"
     | BasicImageTransformationsGravityCoordinates;
   /**
    * Background color to add underneath the image. Applies only to images with
@@ -4567,8 +4570,9 @@ export interface BasicImageTransformations {
   rotate?: 0 | 90 | 180 | 270 | 360;
 }
 export interface BasicImageTransformationsGravityCoordinates {
-  x: number;
-  y: number;
+  x?: number;
+  y?: number;
+  mode?: "remainder" | "box-center";
 }
 /**
  * In addition to the properties you can set in the RequestInit dict
@@ -4676,23 +4680,43 @@ export interface RequestInitCfPropertiesImage
    */
   dpr?: number;
   /**
-   * An object with four properties {left, top, right, bottom} that specify
-   * a number of pixels to cut off on each side. Allows removal of borders
-   * or cutting out a specific fragment of an image. Trimming is performed
-   * before resizing or rotation. Takes dpr into account.
-   */
-  trim?: {
-    left?: number;
-    top?: number;
-    right?: number;
-    bottom?: number;
-  };
+   * Allows you to trim your image. Takes dpr into account and is performed before
+   * resizing or rotation.
+   *
+   * It can be used as:
+   * - left, top, right, bottom - it will specify the number of pixels to cut
+   *   off each side
+   * - width, height - the width/height you'd like to end up with - can be used
+   *   in combination with the properties above
+   * - border - this will automatically trim the surroundings of an image based on
+   *   it's color. It consists of three properties:
+   *    - color: rgb or hex representation of the color you wish to trim (todo: verify the rgba bit)
+   *    - tolerance: difference from color to treat as color
+   *    - keep: the number of pixels of border to keep
+   */
+  trim?:
+    | "border"
+    | {
+        top?: number;
+        bottom?: number;
+        left?: number;
+        right?: number;
+        width?: number;
+        height?: number;
+        border?:
+          | boolean
+          | {
+              color?: string;
+              tolerance?: number;
+              keep?: number;
+            };
+      };
   /**
    * Quality setting from 1-100 (useful values are in 60-90 range). Lower values
    * make images look worse, but load faster. The default is 85. It applies only
    * to JPEG and WebP images. It doesn’t have any effect on PNG.
    */
-  quality?: number;
+  quality?: number | "low" | "medium-low" | "medium-high" | "high";
   /**
    * Output format to generate. It can be:
    *  - avif: generate images in AVIF format.
@@ -4704,7 +4728,15 @@ export interface RequestInitCfPropertiesImage
    * - jpeg: generate images in JPEG format.
    * - png: generate images in PNG format.
    */
-  format?: "avif" | "webp" | "json" | "jpeg" | "png";
+  format?:
+    | "avif"
+    | "webp"
+    | "json"
+    | "jpeg"
+    | "png"
+    | "baseline-jpeg"
+    | "png-force"
+    | "svg";
   /**
    * Whether to preserve animation frames from input files. Default is true.
    * Setting it to false reduces animations to still images. This setting is
@@ -4784,6 +4816,18 @@ export interface RequestInitCfPropertiesImage
    * 0.5 darkens the image, and a value of 2.0 lightens the image. 0 is ignored.
    */
   gamma?: number;
+  /**
+   * Increase contrast by a factor. A value of 1.0 equals no change, a value of
+   * 0.5 equals low contrast, and a value of 2.0 equals high contrast. 0 is
+   * ignored.
+   */
+  saturation?: number;
+  /**
+   * Flips the images horizontally, vertically, or both. Flipping is applied before
+   * rotation, so if you apply flip=h,rotate=90 then the image will be flipped
+   * horizontally, then rotated by 90 degrees.
+   */
+  flip?: "h" | "v" | "hv";
   /**
    * Slightly reduces latency on a cache miss by selecting a
    * quickest-to-compress file format, at a cost of increased file size and
@@ -5700,7 +5744,26 @@ export type ImageInfoResponse =
       height: number;
     };
 export type ImageTransform = {
+  width?: number;
+  height?: number;
+  background?: string;
+  blur?: number;
+  border?:
+    | {
+        color?: string;
+        width?: number;
+      }
+    | {
+        top?: number;
+        bottom?: number;
+        left?: number;
+        right?: number;
+      };
+  brightness?: number;
+  contrast?: number;
   fit?: "scale-down" | "contain" | "pad" | "squeeze" | "cover" | "crop";
+  flip?: "h" | "v" | "hv";
+  gamma?: number;
   gravity?:
     | "left"
     | "right"
@@ -5709,45 +5772,31 @@ export type ImageTransform = {
     | "center"
     | "auto"
     | "entropy"
-    | "face"
     | {
         x?: number;
         y?: number;
         mode: "remainder" | "box-center";
       };
-  trim?: {
-    top?: number;
-    bottom?: number;
-    left?: number;
-    right?: number;
-    width?: number;
-    height?: number;
-    border?:
-      | boolean
-      | {
-          color?: string;
-          tolerance?: number;
-          keep?: number;
-        };
-  };
-  width?: number;
-  height?: number;
-  background?: string;
-  rotate?: number;
+  rotate?: 0 | 90 | 180 | 270;
+  saturation?: number;
   sharpen?: number;
-  blur?: number;
-  contrast?: number;
-  brightness?: number;
-  gamma?: number;
-  border?: {
-    color?: string;
-    width?: number;
-    top?: number;
-    bottom?: number;
-    left?: number;
-    right?: number;
-  };
-  zoom?: number;
+  trim?:
+    | "border"
+    | {
+        top?: number;
+        bottom?: number;
+        left?: number;
+        right?: number;
+        width?: number;
+        height?: number;
+        border?:
+          | boolean
+          | {
+              color?: string;
+              tolerance?: number;
+              keep?: number;
+            };
+      };
 };
 export type ImageDrawOptions = {
   opacity?: number;

package/2022-01-31/index.d.ts

@@ -4544,8 +4544,10 @@ interface BasicImageTransformations {
    *    (white by default). Use of this mode is not recommended, as the same
    *    effect can be more efficiently achieved with the contain mode and the
    *    CSS object-fit: contain property.
+   *  - squeeze: Stretches and deforms to the width and height given, even if it
+   *    breaks aspect ratio
    */
-  fit?: "scale-down" | "contain" | "cover" | "crop" | "pad";
+  fit?: "scale-down" | "contain" | "cover" | "crop" | "pad" | "squeeze";
   /**
    * When cropping with fit: "cover", this defines the side or point that should
    * be left uncropped. The value is either a string
@@ -4565,6 +4567,7 @@ interface BasicImageTransformations {
     | "bottom"
     | "center"
     | "auto"
+    | "entropy"
     | BasicImageTransformationsGravityCoordinates;
   /**
    * Background color to add underneath the image. Applies only to images with
@@ -4579,8 +4582,9 @@ interface BasicImageTransformations {
   rotate?: 0 | 90 | 180 | 270 | 360;
 }
 interface BasicImageTransformationsGravityCoordinates {
-  x: number;
-  y: number;
+  x?: number;
+  y?: number;
+  mode?: "remainder" | "box-center";
 }
 /**
  * In addition to the properties you can set in the RequestInit dict
@@ -4686,23 +4690,43 @@ interface RequestInitCfPropertiesImage extends BasicImageTransformations {
    */
   dpr?: number;
   /**
-   * An object with four properties {left, top, right, bottom} that specify
-   * a number of pixels to cut off on each side. Allows removal of borders
-   * or cutting out a specific fragment of an image. Trimming is performed
-   * before resizing or rotation. Takes dpr into account.
-   */
-  trim?: {
-    left?: number;
-    top?: number;
-    right?: number;
-    bottom?: number;
-  };
+   * Allows you to trim your image. Takes dpr into account and is performed before
+   * resizing or rotation.
+   *
+   * It can be used as:
+   * - left, top, right, bottom - it will specify the number of pixels to cut
+   *   off each side
+   * - width, height - the width/height you'd like to end up with - can be used
+   *   in combination with the properties above
+   * - border - this will automatically trim the surroundings of an image based on
+   *   it's color. It consists of three properties:
+   *    - color: rgb or hex representation of the color you wish to trim (todo: verify the rgba bit)
+   *    - tolerance: difference from color to treat as color
+   *    - keep: the number of pixels of border to keep
+   */
+  trim?:
+    | "border"
+    | {
+        top?: number;
+        bottom?: number;
+        left?: number;
+        right?: number;
+        width?: number;
+        height?: number;
+        border?:
+          | boolean
+          | {
+              color?: string;
+              tolerance?: number;
+              keep?: number;
+            };
+      };
   /**
    * Quality setting from 1-100 (useful values are in 60-90 range). Lower values
    * make images look worse, but load faster. The default is 85. It applies only
    * to JPEG and WebP images. It doesn’t have any effect on PNG.
    */
-  quality?: number;
+  quality?: number | "low" | "medium-low" | "medium-high" | "high";
   /**
    * Output format to generate. It can be:
    *  - avif: generate images in AVIF format.
@@ -4714,7 +4738,15 @@ interface RequestInitCfPropertiesImage extends BasicImageTransformations {
    * - jpeg: generate images in JPEG format.
    * - png: generate images in PNG format.
    */
-  format?: "avif" | "webp" | "json" | "jpeg" | "png";
+  format?:
+    | "avif"
+    | "webp"
+    | "json"
+    | "jpeg"
+    | "png"
+    | "baseline-jpeg"
+    | "png-force"
+    | "svg";
   /**
    * Whether to preserve animation frames from input files. Default is true.
    * Setting it to false reduces animations to still images. This setting is
@@ -4794,6 +4826,18 @@ interface RequestInitCfPropertiesImage extends BasicImageTransformations {
    * 0.5 darkens the image, and a value of 2.0 lightens the image. 0 is ignored.
    */
   gamma?: number;
+  /**
+   * Increase contrast by a factor. A value of 1.0 equals no change, a value of
+   * 0.5 equals low contrast, and a value of 2.0 equals high contrast. 0 is
+   * ignored.
+   */
+  saturation?: number;
+  /**
+   * Flips the images horizontally, vertically, or both. Flipping is applied before
+   * rotation, so if you apply flip=h,rotate=90 then the image will be flipped
+   * horizontally, then rotated by 90 degrees.
+   */
+  flip?: "h" | "v" | "hv";
   /**
    * Slightly reduces latency on a cache miss by selecting a
    * quickest-to-compress file format, at a cost of increased file size and
@@ -5707,7 +5751,26 @@ type ImageInfoResponse =
       height: number;
     };
 type ImageTransform = {
+  width?: number;
+  height?: number;
+  background?: string;
+  blur?: number;
+  border?:
+    | {
+        color?: string;
+        width?: number;
+      }
+    | {
+        top?: number;
+        bottom?: number;
+        left?: number;
+        right?: number;
+      };
+  brightness?: number;
+  contrast?: number;
   fit?: "scale-down" | "contain" | "pad" | "squeeze" | "cover" | "crop";
+  flip?: "h" | "v" | "hv";
+  gamma?: number;
   gravity?:
     | "left"
     | "right"
@@ -5716,45 +5779,31 @@ type ImageTransform = {
     | "center"
     | "auto"
     | "entropy"
-    | "face"
     | {
         x?: number;
         y?: number;
         mode: "remainder" | "box-center";
       };
-  trim?: {
-    top?: number;
-    bottom?: number;
-    left?: number;
-    right?: number;
-    width?: number;
-    height?: number;
-    border?:
-      | boolean
-      | {
-          color?: string;
-          tolerance?: number;
-          keep?: number;
-        };
-  };
-  width?: number;
-  height?: number;
-  background?: string;
-  rotate?: number;
+  rotate?: 0 | 90 | 180 | 270;
+  saturation?: number;
   sharpen?: number;
-  blur?: number;
-  contrast?: number;
-  brightness?: number;
-  gamma?: number;
-  border?: {
-    color?: string;
-    width?: number;
-    top?: number;
-    bottom?: number;
-    left?: number;
-    right?: number;
-  };
-  zoom?: number;
+  trim?:
+    | "border"
+    | {
+        top?: number;
+        bottom?: number;
+        left?: number;
+        right?: number;
+        width?: number;
+        height?: number;
+        border?:
+          | boolean
+          | {
+              color?: string;
+              tolerance?: number;
+              keep?: number;
+            };
+      };
 };
 type ImageDrawOptions = {
   opacity?: number;