From 1a67bca39ddd7fc9c0b28996777629ad45ccfe9b Mon Sep 17 00:00:00 2001
From: Swarnim Doegar <swarnim@imagekit.io>
Date: Fri, 16 Jan 2026 16:39:14 +0530
Subject: [PATCH] Support negative values in position x and y for image and
 text layer

---
 packages/imagekit-editor-dev/src/schema/index.ts | 16 ++++++++--------
 .../src/schema/transformation.ts                 | 16 ++++++----------
 2 files changed, 14 insertions(+), 18 deletions(-)

diff --git a/packages/imagekit-editor-dev/src/schema/index.ts b/packages/imagekit-editor-dev/src/schema/index.ts
index 94fec2b..3bbe634 100644
--- a/packages/imagekit-editor-dev/src/schema/index.ts
+++ b/packages/imagekit-editor-dev/src/schema/index.ts
@@ -2199,7 +2199,7 @@ export const transformationSchema: TransformationSchema[] = [
             transformationKey: "x",
             transformationGroup: "textLayer",
             helpText: "Specify horizontal offset for the text.",
-            examples: ["10", "bw_div_2"],
+            examples: ["10", "-20", "N30", "bw_div_2"],
           },
           {
             label: "Position Y",
@@ -2209,7 +2209,7 @@ export const transformationSchema: TransformationSchema[] = [
             transformationKey: "y",
             transformationGroup: "textLayer",
             helpText: "Specify vertical offset for the text.",
-            examples: ["10", "bh_div_2"],
+            examples: ["10", "-20", "N30", "bh_div_2"],
           },
           {
             label: "Font Size",
@@ -2517,7 +2517,7 @@ export const transformationSchema: TransformationSchema[] = [
             transformationKey: "x",
             transformationGroup: "imageLayer",
             helpText: "Specify the horizontal offset for the overlay image.",
-            examples: ["10"],
+            examples: ["10", "-20", "N30", "bw_div_2"],
           },
           {
             label: "Position Y",
@@ -2527,7 +2527,7 @@ export const transformationSchema: TransformationSchema[] = [
             transformationKey: "y",
             transformationGroup: "imageLayer",
             helpText: "Specify the vertical offset for the overlay image.",
-            examples: ["10"],
+            examples: ["10", "-20", "N30", "bh_div_2"],
           },
           {
             label: "Opacity",
@@ -2926,13 +2926,13 @@ export const transformationFormatters: Record<
       typeof values.positionX === "number" ||
       typeof values.positionX === "string"
     ) {
-      position.x = values.positionX
+      position.x = values.positionX.toString().replace(/^-/,"N")
     }
     if (
       typeof values.positionY === "number" ||
       typeof values.positionY === "string"
     ) {
-      position.y = values.positionY
+      position.y = values.positionY.toString().replace(/^-/,"N")
     }
     if (Object.keys(position).length > 0) {
       overlay.position = position
@@ -3032,10 +3032,10 @@ export const transformationFormatters: Record<
     // Positioning via x/y or focus anchor
     const position: Record<string, unknown> = {}
     if (values.positionX) {
-      position.x = values.positionX
+      position.x = values.positionX.toString().replace(/^-/,"N")
     }
     if (values.positionY) {
-      position.y = values.positionY
+      position.y = values.positionY.toString().replace(/^-/,"N")
     }
 
     if (Object.keys(position).length > 0) {
diff --git a/packages/imagekit-editor-dev/src/schema/transformation.ts b/packages/imagekit-editor-dev/src/schema/transformation.ts
index 78eb69c..8a798d4 100644
--- a/packages/imagekit-editor-dev/src/schema/transformation.ts
+++ b/packages/imagekit-editor-dev/src/schema/transformation.ts
@@ -78,10 +78,8 @@ export const aspectRatioValidator = z.any().superRefine((val, ctx) => {
 })
 
 const layerXNumber = z.coerce
-  .number({ invalid_type_error: "Should be a number." })
-  .min(0, {
-    message: "Layer X must be a positive number.",
-  })
+  .string()
+  .regex(/^[N-]?\d+(\.\d{1,2})?$/)
 
 const layerXExpr = z
   .string()
@@ -97,15 +95,13 @@ export const layerXValidator = z.any().superRefine((val, ctx) => {
   }
   ctx.addIssue({
     code: z.ZodIssueCode.custom,
-    message: "Layer X must be a positive number or a valid expression string.",
+    message: "Layer X must be a number or a valid expression string.",
   })
 })
 
 const layerYNumber = z.coerce
-  .number({ invalid_type_error: "Should be a number." })
-  .min(0, {
-    message: "Layer Y must be a positive number.",
-  })
+  .string()
+  .regex(/^[N-]?\d+(\.\d{1,2})?$/)
 
 const layerYExpr = z
   .string()
@@ -121,6 +117,6 @@ export const layerYValidator = z.any().superRefine((val, ctx) => {
   }
   ctx.addIssue({
     code: z.ZodIssueCode.custom,
-    message: "Layer Y must be a positive number or a valid expression string.",
+    message: "Layer Y must be a number or a valid expression string.",
   })
 })