feat(overlay): support camelCase and snake_case for position properties in overlays

Author: manu4543

src/imagekitio/lib/helper.py

@@ -317,12 +317,12 @@ def _process_overlay(overlay: Overlay) -> str:
 
         parsed_overlay.append(f"bg-{color}")
 
-    # Handle layer_mode property
-    layer_mode = overlay.get("layer_mode")
+    # Handle layerMode and layer_mode (both camelCase and snake_case)
+    layer_mode = overlay.get("layerMode") or overlay.get("layer_mode")
     if layer_mode:
         parsed_overlay.append(f"lm-{layer_mode}")
 
-    # Handle position properties (x, y, focus)
+    # Handle position properties (x, y, focus, x_center, y_center, anchor_point)
     # Node.js uses if (x) which skips falsy values like 0, '', false, null, undefined
     x = position.get("x")
     if x:
@@ -332,6 +332,21 @@ def _process_overlay(overlay: Overlay) -> str:
     if y:
         parsed_overlay.append(f"ly-{y}")
 
+    # Handle xCenter and x_center (both snake_case and camelCase)
+    x_center = position.get("xCenter") or position.get("x_center")
+    if x_center:
+        parsed_overlay.append(f"lxc-{x_center}")
+
+    # Handle yCenter and y_center (both snake_case and camelCase)
+    y_center = position.get("yCenter") or position.get("y_center")
+    if y_center:
+        parsed_overlay.append(f"lyc-{y_center}")
+
+    # Handle anchorPoint and anchor_point (both snake_case and camelCase)
+    anchor_point = position.get("anchorPoint") or position.get("anchor_point")
+    if anchor_point:
+        parsed_overlay.append(f"lap-{anchor_point}")
+
     focus = position.get("focus")
     if focus:
         parsed_overlay.append(f"lfo-{focus}")

tests/custom/url_generation/test_overlay.py

@@ -481,3 +481,26 @@ def test_should_handle_layer_mode_displace_in_overlay(self):
         expected = "https://ik.imagekit.io/test_url_endpoint/tr:l-image,i-overlay.png,lm-displace,l-end/base-image.jpg"
         assert url == expected
 
+    def test_should_handle_x_center_y_center_and_anchor_point_in_overlay_position(self):
+        """Test xCenter, yCenter and anchorPoint in overlay position."""
+        url = self.client.helper.build_url(
+            src="/base-image.jpg",
+            url_endpoint="https://ik.imagekit.io/test_url_endpoint",
+            transformation_position="path",
+            transformation=[
+                {
+                    "overlay": {
+                        "type": "text",
+                        "text": "Centered Text",
+                        "position": {
+                            "x_center": "bw_mul_0.5",
+                            "y_center": "bh_mul_0.5",
+                            "anchor_point": "top_left",
+                        },
+                    }
+                }
+            ],
+        )
+        expected = "https://ik.imagekit.io/test_url_endpoint/tr:l-text,i-Centered%20Text,lxc-bw_mul_0.5,lyc-bh_mul_0.5,lap-top_left,l-end/base-image.jpg"
+        assert url == expected
+