imagekitio 4.0.0 → 4.1.1

data/rbi/imagekitio/models/solid_color_overlay_transformation.rbi

@@ -11,8 +11,8 @@ module Imagekitio
           )
         end
 
-      # Specifies the transparency level of the solid color overlay. Accepts integers
-      # from `1` to `9`.
+      # Specifies the transparency level of the overlaid solid color layer. Supports
+      # integers from `1` to `9`.
       sig { returns(T.nilable(Float)) }
       attr_reader :alpha
 
@@ -56,13 +56,18 @@ module Imagekitio
       end
       attr_writer :height
 
-      # Specifies the corner radius of the solid color overlay. Set to `max` for
-      # circular or oval shape. See
-      # [radius](https://imagekit.io/docs/effects-and-enhancements#radius---r).
-      sig { returns(T.nilable(T.any(Float, Symbol))) }
+      # Specifies the corner radius of the solid color overlay.
+      #
+      # - Single value (positive integer): Applied to all corners (e.g., `20`).
+      # - `max`: Creates a circular or oval shape.
+      # - Per-corner array: Provide four underscore-separated values representing
+      #   top-left, top-right, bottom-right, and bottom-left corners respectively (e.g.,
+      #   `10_20_30_40`). See
+      #   [Radius](https://imagekit.io/docs/effects-and-enhancements#radius---r).
+      sig { returns(T.nilable(T.any(Float, Symbol, String))) }
       attr_reader :radius
 
-      sig { params(radius: T.any(Float, Symbol)).void }
+      sig { params(radius: T.any(Float, Symbol, String)).void }
       attr_writer :radius
 
       # Controls the width of the solid color overlay. Accepts a numeric value or an
@@ -90,13 +95,13 @@ module Imagekitio
           background: String,
           gradient: T.any(T::Boolean, String),
           height: Imagekitio::SolidColorOverlayTransformation::Height::Variants,
-          radius: T.any(Float, Symbol),
+          radius: T.any(Float, Symbol, String),
           width: Imagekitio::SolidColorOverlayTransformation::Width::Variants
         ).returns(T.attached_class)
       end
       def self.new(
-        # Specifies the transparency level of the solid color overlay. Accepts integers
-        # from `1` to `9`.
+        # Specifies the transparency level of the overlaid solid color layer. Supports
+        # integers from `1` to `9`.
         alpha: nil,
         # Specifies the background color of the solid color overlay. Accepts an RGB hex
         # code (e.g., `FF0000`), an RGBA code (e.g., `FFAABB50`), or a color name.
@@ -110,9 +115,14 @@ module Imagekitio
         # arithmetic expression. Learn about
         # [arithmetic expressions](https://imagekit.io/docs/arithmetic-expressions-in-transformations).
         height: nil,
-        # Specifies the corner radius of the solid color overlay. Set to `max` for
-        # circular or oval shape. See
-        # [radius](https://imagekit.io/docs/effects-and-enhancements#radius---r).
+        # Specifies the corner radius of the solid color overlay.
+        #
+        # - Single value (positive integer): Applied to all corners (e.g., `20`).
+        # - `max`: Creates a circular or oval shape.
+        # - Per-corner array: Provide four underscore-separated values representing
+        #   top-left, top-right, bottom-right, and bottom-left corners respectively (e.g.,
+        #   `10_20_30_40`). See
+        #   [Radius](https://imagekit.io/docs/effects-and-enhancements#radius---r).
         radius: nil,
         # Controls the width of the solid color overlay. Accepts a numeric value or an
         # arithmetic expression (e.g., `bw_mul_0.2` or `bh_div_2`). Learn about
@@ -129,7 +139,7 @@ module Imagekitio
             gradient: T.any(T::Boolean, String),
             height:
               Imagekitio::SolidColorOverlayTransformation::Height::Variants,
-            radius: T.any(Float, Symbol),
+            radius: T.any(Float, Symbol, String),
             width: Imagekitio::SolidColorOverlayTransformation::Width::Variants
           }
         )
@@ -176,13 +186,18 @@ module Imagekitio
         end
       end
 
-      # Specifies the corner radius of the solid color overlay. Set to `max` for
-      # circular or oval shape. See
-      # [radius](https://imagekit.io/docs/effects-and-enhancements#radius---r).
+      # Specifies the corner radius of the solid color overlay.
+      #
+      # - Single value (positive integer): Applied to all corners (e.g., `20`).
+      # - `max`: Creates a circular or oval shape.
+      # - Per-corner array: Provide four underscore-separated values representing
+      #   top-left, top-right, bottom-right, and bottom-left corners respectively (e.g.,
+      #   `10_20_30_40`). See
+      #   [Radius](https://imagekit.io/docs/effects-and-enhancements#radius---r).
       module Radius
         extend Imagekitio::Internal::Type::Union
 
-        Variants = T.type_alias { T.any(Float, Symbol) }
+        Variants = T.type_alias { T.any(Float, Symbol, String) }
 
         sig do
           override.returns(

data/rbi/imagekitio/models/subtitle_overlay.rbi

@@ -20,6 +20,12 @@ module Imagekitio
       # format automatically. To always use base64 encoding (`ie-{base64}`), set this
       # parameter to `base64`. To always use plain text (`i-{input}`), set it to
       # `plain`.
+      #
+      # Regardless of the encoding method:
+      #
+      # - Leading and trailing slashes are removed.
+      # - Remaining slashes within the path are replaced with `@@` when using plain
+      #   text.
       sig do
         returns(T.nilable(Imagekitio::SubtitleOverlay::Encoding::OrSymbol))
       end
@@ -62,6 +68,12 @@ module Imagekitio
         # format automatically. To always use base64 encoding (`ie-{base64}`), set this
         # parameter to `base64`. To always use plain text (`i-{input}`), set it to
         # `plain`.
+        #
+        # Regardless of the encoding method:
+        #
+        # - Leading and trailing slashes are removed.
+        # - Remaining slashes within the path are replaced with `@@` when using plain
+        #   text.
         encoding: nil,
         # Control styling of the subtitle. See
         # [Styling subtitles](https://imagekit.io/docs/add-overlays-on-videos#styling-controls-for-subtitles-layer).
@@ -88,6 +100,12 @@ module Imagekitio
       # format automatically. To always use base64 encoding (`ie-{base64}`), set this
       # parameter to `base64`. To always use plain text (`i-{input}`), set it to
       # `plain`.
+      #
+      # Regardless of the encoding method:
+      #
+      # - Leading and trailing slashes are removed.
+      # - Remaining slashes within the path are replaced with `@@` when using plain
+      #   text.
       module Encoding
         extend Imagekitio::Internal::Type::Enum
 

data/rbi/imagekitio/models/subtitle_overlay_transformation.rbi

@@ -31,8 +31,9 @@ module Imagekitio
       sig { params(color: String).void }
       attr_writer :color
 
-      # Font family for subtitles. Refer to the
-      # [supported fonts](https://imagekit.io/docs/add-overlays-on-images#supported-text-font-list).
+      # Sets the font family of subtitle text. Refer to the
+      # [supported fonts documented](https://imagekit.io/docs/add-overlays-on-images#supported-text-font-list)
+      # in the ImageKit transformations guide.
       sig { returns(T.nilable(String)) }
       attr_reader :font_family
 
@@ -122,8 +123,9 @@ module Imagekitio
         #
         # [Subtitle styling options](https://imagekit.io/docs/add-overlays-on-videos#styling-controls-for-subtitles-layer)
         color: nil,
-        # Font family for subtitles. Refer to the
-        # [supported fonts](https://imagekit.io/docs/add-overlays-on-images#supported-text-font-list).
+        # Sets the font family of subtitle text. Refer to the
+        # [supported fonts documented](https://imagekit.io/docs/add-overlays-on-images#supported-text-font-list)
+        # in the ImageKit transformations guide.
         font_family: nil,
         # Sets the font outline of the subtitle text. Requires the outline width (an
         # integer) and the outline color (as an RGB color code, RGBA color code, or

data/rbi/imagekitio/models/text_overlay.rbi

@@ -21,6 +21,9 @@ module Imagekitio
       # appropriate format based on the input text. To always use base64
       # (`ie-{base64}`), set this parameter to `base64`. To always use plain text
       # (`i-{input}`), set it to `plain`.
+      #
+      # Regardless of the encoding method, the input text is always percent-encoded to
+      # ensure it is URL-safe.
       sig { returns(T.nilable(Imagekitio::TextOverlay::Encoding::OrSymbol)) }
       attr_reader :encoding
 
@@ -60,6 +63,9 @@ module Imagekitio
         # appropriate format based on the input text. To always use base64
         # (`ie-{base64}`), set this parameter to `base64`. To always use plain text
         # (`i-{input}`), set it to `plain`.
+        #
+        # Regardless of the encoding method, the input text is always percent-encoded to
+        # ensure it is URL-safe.
         encoding: nil,
         # Control styling of the text overlay. See
         # [Text overlays](https://imagekit.io/docs/add-overlays-on-images#text-overlay).
@@ -86,6 +92,9 @@ module Imagekitio
       # appropriate format based on the input text. To always use base64
       # (`ie-{base64}`), set this parameter to `base64`. To always use plain text
       # (`i-{input}`), set it to `plain`.
+      #
+      # Regardless of the encoding method, the input text is always percent-encoded to
+      # ensure it is URL-safe.
       module Encoding
         extend Imagekitio::Internal::Type::Enum
 

data/rbi/imagekitio/models/text_overlay_transformation.rbi

@@ -27,7 +27,9 @@ module Imagekitio
       sig { params(background: String).void }
       attr_writer :background
 
-      # Flip the text overlay horizontally, vertically, or both.
+      # Flip/mirror the text horizontally, vertically, or in both directions. Acceptable
+      # values: `h` (horizontal), `v` (vertical), `h_v` (horizontal and vertical), or
+      # `v_h`.
       sig do
         returns(
           T.nilable(Imagekitio::TextOverlayTransformation::Flip::OrSymbol)
@@ -94,10 +96,9 @@ module Imagekitio
       end
       attr_writer :inner_alignment
 
-      # Specifies the line height of the text overlay. Accepts integer values
-      # representing line height in points. It can also accept
-      # [arithmetic expressions](https://imagekit.io/docs/arithmetic-expressions-in-transformations)
-      # such as `bw_mul_0.2`, or `bh_div_20`.
+      # Specifies the line height for multi-line text overlays. It will come into effect
+      # only if the text wraps over multiple lines. Accepts either an integer value or
+      # an arithmetic expression.
       sig do
         returns(
           T.nilable(Imagekitio::TextOverlayTransformation::LineHeight::Variants)
@@ -130,12 +131,18 @@ module Imagekitio
       end
       attr_writer :padding
 
-      # Specifies the corner radius of the text overlay. Set to `max` to achieve a
-      # circular or oval shape.
-      sig { returns(T.nilable(T.any(Float, Symbol))) }
+      # Specifies the corner radius:
+      #
+      # - Single value (positive integer): Applied to all corners (e.g., `20`).
+      # - `max`: Creates a circular or oval shape.
+      # - Per-corner array: Provide four underscore-separated values representing
+      #   top-left, top-right, bottom-right, and bottom-left corners respectively (e.g.,
+      #   `10_20_30_40`). See
+      #   [Radius](https://imagekit.io/docs/effects-and-enhancements#radius---r).
+      sig { returns(T.nilable(T.any(Float, Symbol, String))) }
       attr_reader :radius
 
-      sig { params(radius: T.any(Float, Symbol)).void }
+      sig { params(radius: T.any(Float, Symbol, String)).void }
       attr_writer :radius
 
       # Specifies the rotation angle of the text overlay. Accepts a numeric value for
@@ -196,7 +203,7 @@ module Imagekitio
           line_height:
             Imagekitio::TextOverlayTransformation::LineHeight::Variants,
           padding: Imagekitio::TextOverlayTransformation::Padding::Variants,
-          radius: T.any(Float, Symbol),
+          radius: T.any(Float, Symbol, String),
           rotation: Imagekitio::TextOverlayTransformation::Rotation::Variants,
           typography: String,
           width: Imagekitio::TextOverlayTransformation::Width::Variants
@@ -209,7 +216,9 @@ module Imagekitio
         # Specifies the background color of the text overlay. Accepts an RGB hex code, an
         # RGBA code, or a color name.
         background: nil,
-        # Flip the text overlay horizontally, vertically, or both.
+        # Flip/mirror the text horizontally, vertically, or in both directions. Acceptable
+        # values: `h` (horizontal), `v` (vertical), `h_v` (horizontal and vertical), or
+        # `v_h`.
         flip: nil,
         # Specifies the font color of the overlaid text. Accepts an RGB hex code (e.g.,
         # `FF0000`), an RGBA code (e.g., `FFAABB50`), or a color name.
@@ -226,17 +235,22 @@ module Imagekitio
         # Specifies the inner alignment of the text when width is more than the text
         # length.
         inner_alignment: nil,
-        # Specifies the line height of the text overlay. Accepts integer values
-        # representing line height in points. It can also accept
-        # [arithmetic expressions](https://imagekit.io/docs/arithmetic-expressions-in-transformations)
-        # such as `bw_mul_0.2`, or `bh_div_20`.
+        # Specifies the line height for multi-line text overlays. It will come into effect
+        # only if the text wraps over multiple lines. Accepts either an integer value or
+        # an arithmetic expression.
         line_height: nil,
         # Specifies the padding around the overlaid text. Can be provided as a single
         # positive integer or multiple values separated by underscores (following CSS
         # shorthand order). Arithmetic expressions are also accepted.
         padding: nil,
-        # Specifies the corner radius of the text overlay. Set to `max` to achieve a
-        # circular or oval shape.
+        # Specifies the corner radius:
+        #
+        # - Single value (positive integer): Applied to all corners (e.g., `20`).
+        # - `max`: Creates a circular or oval shape.
+        # - Per-corner array: Provide four underscore-separated values representing
+        #   top-left, top-right, bottom-right, and bottom-left corners respectively (e.g.,
+        #   `10_20_30_40`). See
+        #   [Radius](https://imagekit.io/docs/effects-and-enhancements#radius---r).
         radius: nil,
         # Specifies the rotation angle of the text overlay. Accepts a numeric value for
         # clockwise rotation or a string prefixed with "N" for counter-clockwise rotation.
@@ -270,7 +284,7 @@ module Imagekitio
             line_height:
               Imagekitio::TextOverlayTransformation::LineHeight::Variants,
             padding: Imagekitio::TextOverlayTransformation::Padding::Variants,
-            radius: T.any(Float, Symbol),
+            radius: T.any(Float, Symbol, String),
             rotation: Imagekitio::TextOverlayTransformation::Rotation::Variants,
             typography: String,
             width: Imagekitio::TextOverlayTransformation::Width::Variants
@@ -280,7 +294,9 @@ module Imagekitio
       def to_hash
       end
 
-      # Flip the text overlay horizontally, vertically, or both.
+      # Flip/mirror the text horizontally, vertically, or in both directions. Acceptable
+      # values: `h` (horizontal), `v` (vertical), `h_v` (horizontal and vertical), or
+      # `v_h`.
       module Flip
         extend Imagekitio::Internal::Type::Enum
 
@@ -360,10 +376,9 @@ module Imagekitio
         end
       end
 
-      # Specifies the line height of the text overlay. Accepts integer values
-      # representing line height in points. It can also accept
-      # [arithmetic expressions](https://imagekit.io/docs/arithmetic-expressions-in-transformations)
-      # such as `bw_mul_0.2`, or `bh_div_20`.
+      # Specifies the line height for multi-line text overlays. It will come into effect
+      # only if the text wraps over multiple lines. Accepts either an integer value or
+      # an arithmetic expression.
       module LineHeight
         extend Imagekitio::Internal::Type::Union
 
@@ -397,12 +412,18 @@ module Imagekitio
         end
       end
 
-      # Specifies the corner radius of the text overlay. Set to `max` to achieve a
-      # circular or oval shape.
+      # Specifies the corner radius:
+      #
+      # - Single value (positive integer): Applied to all corners (e.g., `20`).
+      # - `max`: Creates a circular or oval shape.
+      # - Per-corner array: Provide four underscore-separated values representing
+      #   top-left, top-right, bottom-right, and bottom-left corners respectively (e.g.,
+      #   `10_20_30_40`). See
+      #   [Radius](https://imagekit.io/docs/effects-and-enhancements#radius---r).
       module Radius
         extend Imagekitio::Internal::Type::Union
 
-        Variants = T.type_alias { T.any(Float, Symbol) }
+        Variants = T.type_alias { T.any(Float, Symbol, String) }
 
         sig do
           override.returns(

data/rbi/imagekitio/models/transformation.rbi

@@ -160,6 +160,12 @@ module Imagekitio
       #
       # - A solid color: e.g., `red`, `F3F3F3`, `AAFF0010`. See
       #   [Solid color background](https://imagekit.io/docs/effects-and-enhancements#solid-color-background).
+      # - Dominant color: `dominant` extracts the dominant color from the image. See
+      #   [Dominant color background](https://imagekit.io/docs/effects-and-enhancements#dominant-color-background).
+      # - Gradient: `gradient_dominant` or `gradient_dominant_2` creates a gradient
+      #   using the dominant colors. Optionally specify palette size (2 or 4), e.g.,
+      #   `gradient_dominant_4`. See
+      #   [Gradient background](https://imagekit.io/docs/effects-and-enhancements#gradient-background).
       # - A blurred background: e.g., `blurred`, `blurred_25_N15`, etc. See
       #   [Blurred background](https://imagekit.io/docs/effects-and-enhancements#blurred-background).
       # - Expand the image boundaries using generative fill: `genfill`. Not supported
@@ -200,6 +206,20 @@ module Imagekitio
       sig { params(color_profile: T::Boolean).void }
       attr_writer :color_profile
 
+      # Replaces colors in the image. Supports three formats:
+      #
+      # - `toColor` - Replace dominant color with the specified color.
+      # - `toColor_tolerance` - Replace dominant color with specified tolerance (0-100).
+      # - `toColor_tolerance_fromColor` - Replace a specific color with another within
+      #   tolerance range. Colors can be hex codes (e.g., `FF0022`) or names (e.g.,
+      #   `red`, `blue`). See
+      #   [Color replacement](https://imagekit.io/docs/effects-and-enhancements#color-replace---cr).
+      sig { returns(T.nilable(String)) }
+      attr_reader :color_replace
+
+      sig { params(color_replace: String).void }
+      attr_writer :color_replace
+
       # Automatically enhances the contrast of an image (contrast stretch). See
       # [Contrast Stretch](https://imagekit.io/docs/effects-and-enhancements#contrast-stretch---e-contrast).
       sig do
@@ -244,9 +264,25 @@ module Imagekitio
       sig { params(default_image: String).void }
       attr_writer :default_image
 
+      # Distorts the shape of an image. Supports two modes:
+      #
+      # - Perspective distortion: `p-x1_y1_x2_y2_x3_y3_x4_y4` changes the position of
+      #   the four corners starting clockwise from top-left.
+      # - Arc distortion: `a-degrees` curves the image upwards (positive values) or
+      #   downwards (negative values). See
+      #   [Distort effect](https://imagekit.io/docs/effects-and-enhancements#distort---e-distort).
+      sig { returns(T.nilable(String)) }
+      attr_reader :distort
+
+      sig { params(distort: String).void }
+      attr_writer :distort
+
       # Accepts values between 0.1 and 5, or `auto` for automatic device pixel ratio
-      # (DPR) calculation. See
-      # [DPR](https://imagekit.io/docs/image-resize-and-crop#dpr---dpr).
+      # (DPR) calculation. Also accepts arithmetic expressions.
+      #
+      # - Learn about
+      #   [Arithmetic expressions](https://imagekit.io/docs/arithmetic-expressions-in-transformations).
+      # - See [DPR](https://imagekit.io/docs/image-resize-and-crop#dpr---dpr).
       sig { returns(T.nilable(Float)) }
       attr_reader :dpr
 
@@ -431,13 +467,18 @@ module Imagekitio
       sig { params(quality: Float).void }
       attr_writer :quality
 
-      # Specifies the corner radius for rounded corners (e.g., 20) or `max` for circular
-      # or oval shape. See
-      # [Radius](https://imagekit.io/docs/effects-and-enhancements#radius---r).
-      sig { returns(T.nilable(T.any(Float, Symbol))) }
+      # Specifies the corner radius for rounded corners.
+      #
+      # - Single value (positive integer): Applied to all corners (e.g., `20`).
+      # - `max`: Creates a circular or oval shape.
+      # - Per-corner array: Provide four underscore-separated values representing
+      #   top-left, top-right, bottom-right, and bottom-left corners respectively (e.g.,
+      #   `10_20_30_40`). See
+      #   [Radius](https://imagekit.io/docs/effects-and-enhancements#radius---r).
+      sig { returns(T.nilable(T.any(Float, Symbol, String))) }
       attr_reader :radius
 
-      sig { params(radius: T.any(Float, Symbol)).void }
+      sig { params(radius: T.any(Float, Symbol, String)).void }
       attr_writer :radius
 
       # Pass any transformation not directly supported by the SDK. This transformation
@@ -624,11 +665,13 @@ module Imagekitio
           blur: Float,
           border: String,
           color_profile: T::Boolean,
+          color_replace: String,
           contrast_stretch:
             Imagekitio::Transformation::ContrastStretch::OrBoolean,
           crop: Imagekitio::Transformation::Crop::OrSymbol,
           crop_mode: Imagekitio::Transformation::CropMode::OrSymbol,
           default_image: String,
+          distort: String,
           dpr: Float,
           duration: Imagekitio::Transformation::Duration::Variants,
           end_offset: Imagekitio::Transformation::EndOffset::Variants,
@@ -647,7 +690,7 @@ module Imagekitio
           page: Imagekitio::Transformation::Page::Variants,
           progressive: T::Boolean,
           quality: Float,
-          radius: T.any(Float, Symbol),
+          radius: T.any(Float, Symbol, String),
           raw: String,
           rotation: Imagekitio::Transformation::Rotation::Variants,
           shadow: T.any(T::Boolean, String),
@@ -719,6 +762,12 @@ module Imagekitio
         #
         # - A solid color: e.g., `red`, `F3F3F3`, `AAFF0010`. See
         #   [Solid color background](https://imagekit.io/docs/effects-and-enhancements#solid-color-background).
+        # - Dominant color: `dominant` extracts the dominant color from the image. See
+        #   [Dominant color background](https://imagekit.io/docs/effects-and-enhancements#dominant-color-background).
+        # - Gradient: `gradient_dominant` or `gradient_dominant_2` creates a gradient
+        #   using the dominant colors. Optionally specify palette size (2 or 4), e.g.,
+        #   `gradient_dominant_4`. See
+        #   [Gradient background](https://imagekit.io/docs/effects-and-enhancements#gradient-background).
         # - A blurred background: e.g., `blurred`, `blurred_25_N15`, etc. See
         #   [Blurred background](https://imagekit.io/docs/effects-and-enhancements#blurred-background).
         # - Expand the image boundaries using generative fill: `genfill`. Not supported
@@ -739,6 +788,15 @@ module Imagekitio
         # Indicates whether the output image should retain the original color profile. See
         # [Color profile](https://imagekit.io/docs/image-optimization#color-profile---cp).
         color_profile: nil,
+        # Replaces colors in the image. Supports three formats:
+        #
+        # - `toColor` - Replace dominant color with the specified color.
+        # - `toColor_tolerance` - Replace dominant color with specified tolerance (0-100).
+        # - `toColor_tolerance_fromColor` - Replace a specific color with another within
+        #   tolerance range. Colors can be hex codes (e.g., `FF0022`) or names (e.g.,
+        #   `red`, `blue`). See
+        #   [Color replacement](https://imagekit.io/docs/effects-and-enhancements#color-replace---cr).
+        color_replace: nil,
         # Automatically enhances the contrast of an image (contrast stretch). See
         # [Contrast Stretch](https://imagekit.io/docs/effects-and-enhancements#contrast-stretch---e-contrast).
         contrast_stretch: nil,
@@ -752,9 +810,20 @@ module Imagekitio
         # path. See
         # [Default image](https://imagekit.io/docs/image-transformation#default-image---di).
         default_image: nil,
+        # Distorts the shape of an image. Supports two modes:
+        #
+        # - Perspective distortion: `p-x1_y1_x2_y2_x3_y3_x4_y4` changes the position of
+        #   the four corners starting clockwise from top-left.
+        # - Arc distortion: `a-degrees` curves the image upwards (positive values) or
+        #   downwards (negative values). See
+        #   [Distort effect](https://imagekit.io/docs/effects-and-enhancements#distort---e-distort).
+        distort: nil,
         # Accepts values between 0.1 and 5, or `auto` for automatic device pixel ratio
-        # (DPR) calculation. See
-        # [DPR](https://imagekit.io/docs/image-resize-and-crop#dpr---dpr).
+        # (DPR) calculation. Also accepts arithmetic expressions.
+        #
+        # - Learn about
+        #   [Arithmetic expressions](https://imagekit.io/docs/arithmetic-expressions-in-transformations).
+        # - See [DPR](https://imagekit.io/docs/image-resize-and-crop#dpr---dpr).
         dpr: nil,
         # Specifies the duration (in seconds) for trimming videos, e.g., `5` or `10.5`.
         # Typically used with startOffset to indicate the length from the start offset.
@@ -839,9 +908,14 @@ module Imagekitio
         # quality, while a lower value produces a smaller file size with reduced quality.
         # See [Quality](https://imagekit.io/docs/image-optimization#quality---q).
         quality: nil,
-        # Specifies the corner radius for rounded corners (e.g., 20) or `max` for circular
-        # or oval shape. See
-        # [Radius](https://imagekit.io/docs/effects-and-enhancements#radius---r).
+        # Specifies the corner radius for rounded corners.
+        #
+        # - Single value (positive integer): Applied to all corners (e.g., `20`).
+        # - `max`: Creates a circular or oval shape.
+        # - Per-corner array: Provide four underscore-separated values representing
+        #   top-left, top-right, bottom-right, and bottom-left corners respectively (e.g.,
+        #   `10_20_30_40`). See
+        #   [Radius](https://imagekit.io/docs/effects-and-enhancements#radius---r).
         radius: nil,
         # Pass any transformation not directly supported by the SDK. This transformation
         # string is appended to the URL as provided.
@@ -925,11 +999,13 @@ module Imagekitio
             blur: Float,
             border: String,
             color_profile: T::Boolean,
+            color_replace: String,
             contrast_stretch:
               Imagekitio::Transformation::ContrastStretch::OrBoolean,
             crop: Imagekitio::Transformation::Crop::OrSymbol,
             crop_mode: Imagekitio::Transformation::CropMode::OrSymbol,
             default_image: String,
+            distort: String,
             dpr: Float,
             duration: Imagekitio::Transformation::Duration::Variants,
             end_offset: Imagekitio::Transformation::EndOffset::Variants,
@@ -948,7 +1024,7 @@ module Imagekitio
             page: Imagekitio::Transformation::Page::Variants,
             progressive: T::Boolean,
             quality: Float,
-            radius: T.any(Float, Symbol),
+            radius: T.any(Float, Symbol, String),
             raw: String,
             rotation: Imagekitio::Transformation::Rotation::Variants,
             shadow: T.any(T::Boolean, String),
@@ -1417,13 +1493,18 @@ module Imagekitio
         end
       end
 
-      # Specifies the corner radius for rounded corners (e.g., 20) or `max` for circular
-      # or oval shape. See
-      # [Radius](https://imagekit.io/docs/effects-and-enhancements#radius---r).
+      # Specifies the corner radius for rounded corners.
+      #
+      # - Single value (positive integer): Applied to all corners (e.g., `20`).
+      # - `max`: Creates a circular or oval shape.
+      # - Per-corner array: Provide four underscore-separated values representing
+      #   top-left, top-right, bottom-right, and bottom-left corners respectively (e.g.,
+      #   `10_20_30_40`). See
+      #   [Radius](https://imagekit.io/docs/effects-and-enhancements#radius---r).
       module Radius
         extend Imagekitio::Internal::Type::Union
 
-        Variants = T.type_alias { T.any(Float, Symbol) }
+        Variants = T.type_alias { T.any(Float, Symbol, String) }
 
         sig do
           override.returns(

data/rbi/imagekitio/models/update_file_request.rbi

@@ -53,6 +53,8 @@ module Imagekitio
                 T.any(
                   Imagekitio::ExtensionItem::RemoveBg,
                   Imagekitio::ExtensionItem::AIAutoDescription,
+                  Imagekitio::ExtensionItem::AITasks,
+                  Imagekitio::ExtensionItem::SavedExtension,
                   Imagekitio::ExtensionItem::AutoTaggingExtension
                 )
               ]
@@ -68,6 +70,8 @@ module Imagekitio
                 T.any(
                   Imagekitio::ExtensionItem::RemoveBg::OrHash,
                   Imagekitio::ExtensionItem::AIAutoDescription::OrHash,
+                  Imagekitio::ExtensionItem::AITasks::OrHash,
+                  Imagekitio::ExtensionItem::SavedExtension::OrHash,
                   Imagekitio::ExtensionItem::AutoTaggingExtension::OrHash
                 )
               ]
@@ -114,6 +118,8 @@ module Imagekitio
                 T.any(
                   Imagekitio::ExtensionItem::RemoveBg::OrHash,
                   Imagekitio::ExtensionItem::AIAutoDescription::OrHash,
+                  Imagekitio::ExtensionItem::AITasks::OrHash,
+                  Imagekitio::ExtensionItem::SavedExtension::OrHash,
                   Imagekitio::ExtensionItem::AutoTaggingExtension::OrHash
                 )
               ],
@@ -166,6 +172,8 @@ module Imagekitio
                   T.any(
                     Imagekitio::ExtensionItem::RemoveBg,
                     Imagekitio::ExtensionItem::AIAutoDescription,
+                    Imagekitio::ExtensionItem::AITasks,
+                    Imagekitio::ExtensionItem::SavedExtension,
                     Imagekitio::ExtensionItem::AutoTaggingExtension
                   )
                 ],