@shotstack/schemas 1.3.8 → 1.4.0

package/dist/api.bundled.json

@@ -2056,7 +2056,7 @@
         ]
       },
       "SvgAsset": {
-        "description": "The SvgAsset is used to add scalable vector graphics (SVG) shapes to a video.\nIt provides a comprehensive set of primitive shapes and custom paths with full\nstyling support including fills, strokes, gradients, and shadows.\n\n**Available Shapes:**\n- `rectangle` - Rectangles with optional rounded corners\n- `circle` - Perfect circles\n- `ellipse` - Ellipses/ovals with separate x and y radii\n- `line` - Straight lines with configurable thickness\n- `polygon` - Regular polygons (triangle, pentagon, hexagon, etc.)\n- `star` - Multi-pointed stars\n- `arrow` - Directional arrows\n- `heart` - Heart shapes\n- `cross` - Plus/cross shapes\n- `ring` - Donut/ring shapes\n- `path` - Custom shapes using SVG path data\n\n**Styling Options:**\n- Fill with solid colors or linear/radial gradients\n- Stroke with configurable width, color, dash patterns, and line caps/joins\n- Drop shadows with blur, offset, and opacity\n- Transform properties for positioning, rotation, and scaling\n\nSee [W3C SVG 2 Specification](https://www.w3.org/TR/SVG2/) for path data syntax.\n",
+        "description": "The SvgAsset is used to add scalable vector graphics (SVG) shapes to a video.\nIt provides two mutually exclusive ways to define shapes:\n\n**Option 1: Import SVG markup using `src`**\n```json\n{\n  \"type\": \"svg\",\n  \"src\": \"<svg width=\\\"100\\\" height=\\\"100\\\"><circle cx=\\\"50\\\" cy=\\\"50\\\" r=\\\"40\\\" fill=\\\"#FF0000\\\"/></svg>\"\n}\n```\nWhen using `src`, no other properties are allowed. The fill, stroke, and dimensions\nare automatically extracted from the SVG markup.\n\n**Option 2: Define shapes programmatically using `shape`**\n```json\n{\n  \"type\": \"svg\",\n  \"shape\": { \"type\": \"circle\", \"radius\": 50 },\n  \"fill\": { \"type\": \"solid\", \"color\": \"#FF0000\" }\n}\n```\nWhen using `shape`, you can customize fill, stroke, shadow, transform, and other properties.\nThe `src` property is not allowed in this mode.\n\n**Important:** You must provide either `src` OR `shape`, but not both.\nThese two modes are mutually exclusive.\n\n**Available Shapes (Option 2 only):**\n- `rectangle` - Rectangles with optional rounded corners\n- `circle` - Perfect circles\n- `ellipse` - Ellipses/ovals with separate x and y radii\n- `line` - Straight lines with configurable thickness\n- `polygon` - Regular polygons (triangle, pentagon, hexagon, etc.)\n- `star` - Multi-pointed stars\n- `arrow` - Directional arrows\n- `heart` - Heart shapes\n- `cross` - Plus/cross shapes\n- `ring` - Donut/ring shapes\n- `path` - Custom shapes using SVG path data\n\nSee [W3C SVG 2 Specification](https://www.w3.org/TR/SVG2/) for path data syntax.\n",
         "type": "object",
         "properties": {
           "type": {
@@ -2068,28 +2068,35 @@
             "default": "svg",
             "example": "svg"
           },
+          "src": {
+            "description": "Raw SVG markup string to import. When provided, the shape is extracted\nautomatically from the SVG content.\n\n**Supported elements:** `<path>`, `<rect>`, `<circle>`, `<ellipse>`,\n`<line>`, `<polygon>`, `<polyline>`\n\n**Automatically extracted:**\n- Path data (converted to a single combined path)\n- Fill color (from `fill` attribute or `style`)\n- Stroke color and width (from attributes or `style`)\n- Dimensions (from `width`/`height` or `viewBox`)\n- Opacity (from `opacity` attribute)\n\n**Important:** When using `src`, no other properties (shape, fill, stroke, etc.)\nare allowed. All styling must be defined within the SVG markup itself.\n",
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 500000,
+            "example": "<svg width=\"100\" height=\"100\"><circle cx=\"50\" cy=\"50\" r=\"40\" fill=\"#3498db\"/></svg>"
+          },
           "shape": {
-            "description": "The shape definition. The `type` property within determines the shape kind\nand its specific properties. See individual shape documentation for details.\n",
+            "description": "The shape definition using primitives. The `type` property within determines\nthe shape kind and its specific properties.\n\n**Important:** When using `shape`, the `src` property is not allowed.\n",
             "$ref": "#/components/schemas/SvgShape"
           },
           "fill": {
-            "description": "Fill properties for the shape interior.\nCan be a solid color or a gradient (linear/radial).\nIf omitted, the shape will have no fill (transparent interior).\n",
+            "description": "Fill properties for the shape interior.\nCan be a solid color or a gradient (linear/radial).\nIf omitted, the shape will have no fill (transparent interior).\n\n**Note:** Only allowed when using `shape`, not with `src`.\n",
             "$ref": "#/components/schemas/SvgFill"
           },
           "stroke": {
-            "description": "Stroke (outline) properties for the shape.\nIf omitted, the shape will have no stroke (no outline).\n",
+            "description": "Stroke (outline) properties for the shape.\nIf omitted, the shape will have no stroke (no outline).\n\n**Note:** Only allowed when using `shape`, not with `src`.\n",
             "$ref": "#/components/schemas/SvgStroke"
           },
           "shadow": {
-            "description": "Drop shadow properties for the shape.\nCreates a shadow effect behind the shape.\n",
+            "description": "Drop shadow properties for the shape.\nCreates a shadow effect behind the shape.\n\n**Note:** Only allowed when using `shape`, not with `src`.\n",
             "$ref": "#/components/schemas/SvgShadow"
           },
           "transform": {
-            "description": "Transform properties for positioning, rotating, and scaling the shape.\nThe transform is applied relative to the transformation origin.\n",
+            "description": "Transform properties for positioning, rotating, and scaling the shape.\nThe transform is applied relative to the transformation origin.\n\n**Note:** Only allowed when using `shape`, not with `src`.\n",
             "$ref": "#/components/schemas/SvgTransform"
           },
           "opacity": {
-            "description": "The overall opacity of the entire shape (including fill, stroke, and shadow).\n`1` is fully opaque, `0` is fully transparent.\nThis is applied on top of individual fill/stroke/shadow opacity values.\n",
+            "description": "The overall opacity of the entire shape (including fill, stroke, and shadow).\n`1` is fully opaque, `0` is fully transparent.\nThis is applied on top of individual fill/stroke/shadow opacity values.\n\n**Note:** Only allowed when using `shape`, not with `src`.\n",
             "type": "number",
             "minimum": 0,
             "maximum": 1,
@@ -2097,14 +2104,14 @@
             "example": 1
           },
           "width": {
-            "description": "The width of the bounding box in pixels.\nIf specified, the shape may be scaled to fit within this width.\nIf omitted, the shape uses its natural dimensions.\n",
+            "description": "The width of the bounding box in pixels.\nIf specified, the shape may be scaled to fit within this width.\nIf omitted, the shape uses its natural dimensions.\n\n**Note:** Only allowed when using `shape`, not with `src`.\n",
             "type": "integer",
             "minimum": 1,
             "maximum": 4096,
             "example": 400
           },
           "height": {
-            "description": "The height of the bounding box in pixels.\nIf specified, the shape may be scaled to fit within this height.\nIf omitted, the shape uses its natural dimensions.\n",
+            "description": "The height of the bounding box in pixels.\nIf specified, the shape may be scaled to fit within this height.\nIf omitted, the shape uses its natural dimensions.\n\n**Note:** Only allowed when using `shape`, not with `src`.\n",
             "type": "integer",
             "minimum": 1,
             "maximum": 4096,
@@ -2112,8 +2119,7 @@
           }
         },
         "required": [
-          "type",
-          "shape"
+          "type"
         ],
         "example": {
           "type": "svg",
@@ -3134,7 +3140,7 @@
             "description": "Rotate a clip by the specified angle in degrees. Use a number or an array of [Tween](./#tocs_tween) objects to create a custom animation.",
             "oneOf": [
               {
-                "type": "integer",
+                "type": "number",
                 "description": "The angle to rotate the clip. Can be 0 to 360, or 0 to -360. Using a positive number rotates the clip clockwise, negative numbers counter-clockwise.",
                 "format": "float",
                 "minimum": -360,
@@ -6223,7 +6229,7 @@
           },
           "height": {
             "description": "The height in pixels of the ingested source file, if a video or image.",
-            "type": "string",
+            "type": "integer",
             "example": 1080
           },
           "duration": {

package/dist/schema.d.ts

@@ -1149,10 +1149,33 @@ export interface components {
         };
         /**
          * @description The SvgAsset is used to add scalable vector graphics (SVG) shapes to a video.
-         *     It provides a comprehensive set of primitive shapes and custom paths with full
-         *     styling support including fills, strokes, gradients, and shadows.
+         *     It provides two mutually exclusive ways to define shapes:
          *
-         *     **Available Shapes:**
+         *     **Option 1: Import SVG markup using `src`**
+         *     ```json
+         *     {
+         *       "type": "svg",
+         *       "src": "<svg width=\"100\" height=\"100\"><circle cx=\"50\" cy=\"50\" r=\"40\" fill=\"#FF0000\"/></svg>"
+         *     }
+         *     ```
+         *     When using `src`, no other properties are allowed. The fill, stroke, and dimensions
+         *     are automatically extracted from the SVG markup.
+         *
+         *     **Option 2: Define shapes programmatically using `shape`**
+         *     ```json
+         *     {
+         *       "type": "svg",
+         *       "shape": { "type": "circle", "radius": 50 },
+         *       "fill": { "type": "solid", "color": "#FF0000" }
+         *     }
+         *     ```
+         *     When using `shape`, you can customize fill, stroke, shadow, transform, and other properties.
+         *     The `src` property is not allowed in this mode.
+         *
+         *     **Important:** You must provide either `src` OR `shape`, but not both.
+         *     These two modes are mutually exclusive.
+         *
+         *     **Available Shapes (Option 2 only):**
          *     - `rectangle` - Rectangles with optional rounded corners
          *     - `circle` - Perfect circles
          *     - `ellipse` - Ellipses/ovals with separate x and y radii
@@ -1165,12 +1188,6 @@ export interface components {
          *     - `ring` - Donut/ring shapes
          *     - `path` - Custom shapes using SVG path data
          *
-         *     **Styling Options:**
-         *     - Fill with solid colors or linear/radial gradients
-         *     - Stroke with configurable width, color, dash patterns, and line caps/joins
-         *     - Drop shadows with blur, offset, and opacity
-         *     - Transform properties for positioning, rotation, and scaling
-         *
          *     See [W3C SVG 2 Specification](https://www.w3.org/TR/SVG2/) for path data syntax.
          * @example {
          *       "type": "svg",
@@ -1218,35 +1235,66 @@ export interface components {
              */
             type: "svg";
             /**
-             * @description The shape definition. The `type` property within determines the shape kind
-             *     and its specific properties. See individual shape documentation for details.
+             * @description Raw SVG markup string to import. When provided, the shape is extracted
+             *     automatically from the SVG content.
+             *
+             *     **Supported elements:** `<path>`, `<rect>`, `<circle>`, `<ellipse>`,
+             *     `<line>`, `<polygon>`, `<polyline>`
+             *
+             *     **Automatically extracted:**
+             *     - Path data (converted to a single combined path)
+             *     - Fill color (from `fill` attribute or `style`)
+             *     - Stroke color and width (from attributes or `style`)
+             *     - Dimensions (from `width`/`height` or `viewBox`)
+             *     - Opacity (from `opacity` attribute)
+             *
+             *     **Important:** When using `src`, no other properties (shape, fill, stroke, etc.)
+             *     are allowed. All styling must be defined within the SVG markup itself.
+             * @example <svg width="100" height="100"><circle cx="50" cy="50" r="40" fill="#3498db"/></svg>
              */
-            shape: components["schemas"]["SvgShape"];
+            src?: string;
+            /**
+             * @description The shape definition using primitives. The `type` property within determines
+             *     the shape kind and its specific properties.
+             *
+             *     **Important:** When using `shape`, the `src` property is not allowed.
+             */
+            shape?: components["schemas"]["SvgShape"];
             /**
              * @description Fill properties for the shape interior.
              *     Can be a solid color or a gradient (linear/radial).
              *     If omitted, the shape will have no fill (transparent interior).
+             *
+             *     **Note:** Only allowed when using `shape`, not with `src`.
              */
             fill?: components["schemas"]["SvgFill"];
             /**
              * @description Stroke (outline) properties for the shape.
              *     If omitted, the shape will have no stroke (no outline).
+             *
+             *     **Note:** Only allowed when using `shape`, not with `src`.
              */
             stroke?: components["schemas"]["SvgStroke"];
             /**
              * @description Drop shadow properties for the shape.
              *     Creates a shadow effect behind the shape.
+             *
+             *     **Note:** Only allowed when using `shape`, not with `src`.
              */
             shadow?: components["schemas"]["SvgShadow"];
             /**
              * @description Transform properties for positioning, rotating, and scaling the shape.
              *     The transform is applied relative to the transformation origin.
+             *
+             *     **Note:** Only allowed when using `shape`, not with `src`.
              */
             transform?: components["schemas"]["SvgTransform"];
             /**
              * @description The overall opacity of the entire shape (including fill, stroke, and shadow).
              *     `1` is fully opaque, `0` is fully transparent.
              *     This is applied on top of individual fill/stroke/shadow opacity values.
+             *
+             *     **Note:** Only allowed when using `shape`, not with `src`.
              * @default 1
              * @example 1
              */
@@ -1255,6 +1303,8 @@ export interface components {
              * @description The width of the bounding box in pixels.
              *     If specified, the shape may be scaled to fit within this width.
              *     If omitted, the shape uses its natural dimensions.
+             *
+             *     **Note:** Only allowed when using `shape`, not with `src`.
              * @example 400
              */
             width?: number;
@@ -1262,6 +1312,8 @@ export interface components {
              * @description The height of the bounding box in pixels.
              *     If specified, the shape may be scaled to fit within this height.
              *     If omitted, the shape uses its natural dimensions.
+             *
+             *     **Note:** Only allowed when using `shape`, not with `src`.
              * @example 300
              */
             height?: number;
@@ -4130,7 +4182,7 @@ export interface components {
              * @description The height in pixels of the ingested source file, if a video or image.
              * @example 1080
              */
-            height?: string;
+            height?: number;
             /**
              * Format: float
              * @description The duration in seconds of the ingested source file, if a video or audio file.

package/dist/zod/zod.gen.cjs

@@ -1430,7 +1430,7 @@ exports.sourceresponseattributesSourceResponseAttributesSchema = zod_1.z.object(
     status: zod_1.z.optional(zod_1.z.enum(["queued", "importing", "ready", "failed", "deleted", "overwritten"])),
     outputs: zod_1.z.optional(exports.outputsresponseOutputsResponseSchema),
     width: zod_1.z.optional(zod_1.z.preprocess(((v) => v === '' || Array.isArray(v) ? NaN : v), zod_1.z.coerce.number().int())),
-    height: zod_1.z.optional(zod_1.z.string()),
+    height: zod_1.z.optional(zod_1.z.preprocess(((v) => v === '' || Array.isArray(v) ? NaN : v), zod_1.z.coerce.number().int())),
     duration: zod_1.z.optional(zod_1.z.preprocess(((v) => v === '' || Array.isArray(v) ? NaN : v), zod_1.z.coerce.number())),
     fps: zod_1.z.optional(zod_1.z.preprocess(((v) => v === '' || Array.isArray(v) ? NaN : v), zod_1.z.coerce.number())),
     created: zod_1.z.optional(zod_1.z.string()),
@@ -1734,10 +1734,33 @@ exports.svgshapesSvgShapeSchema = zod_1.z.discriminatedUnion("type", [
 exports.svgShapeSchema = exports.svgshapesSvgShapeSchema;
 /**
  * The SvgAsset is used to add scalable vector graphics (SVG) shapes to a video.
- * It provides a comprehensive set of primitive shapes and custom paths with full
- * styling support including fills, strokes, gradients, and shadows.
+ * It provides two mutually exclusive ways to define shapes:
+ *
+ * **Option 1: Import SVG markup using `src`**
+ * ```json
+ * {
+ * "type": "svg",
+ * "src": "<svg width=\"100\" height=\"100\"><circle cx=\"50\" cy=\"50\" r=\"40\" fill=\"#FF0000\"/></svg>"
+ * }
+ * ```
+ * When using `src`, no other properties are allowed. The fill, stroke, and dimensions
+ * are automatically extracted from the SVG markup.
+ *
+ * **Option 2: Define shapes programmatically using `shape`**
+ * ```json
+ * {
+ * "type": "svg",
+ * "shape": { "type": "circle", "radius": 50 },
+ * "fill": { "type": "solid", "color": "#FF0000" }
+ * }
+ * ```
+ * When using `shape`, you can customize fill, stroke, shadow, transform, and other properties.
+ * The `src` property is not allowed in this mode.
  *
- * **Available Shapes:**
+ * **Important:** You must provide either `src` OR `shape`, but not both.
+ * These two modes are mutually exclusive.
+ *
+ * **Available Shapes (Option 2 only):**
  * - `rectangle` - Rectangles with optional rounded corners
  * - `circle` - Perfect circles
  * - `ellipse` - Ellipses/ovals with separate x and y radii
@@ -1750,18 +1773,13 @@ exports.svgShapeSchema = exports.svgshapesSvgShapeSchema;
  * - `ring` - Donut/ring shapes
  * - `path` - Custom shapes using SVG path data
  *
- * **Styling Options:**
- * - Fill with solid colors or linear/radial gradients
- * - Stroke with configurable width, color, dash patterns, and line caps/joins
- * - Drop shadows with blur, offset, and opacity
- * - Transform properties for positioning, rotation, and scaling
- *
  * See [W3C SVG 2 Specification](https://www.w3.org/TR/SVG2/) for path data syntax.
  *
  */
 exports.svgassetSvgAssetSchema = zod_1.z.object({
     type: zod_1.z.enum(["svg"]),
-    shape: exports.svgshapesSvgShapeSchema,
+    src: zod_1.z.optional(zod_1.z.string().min(1).max(500000)),
+    shape: zod_1.z.optional(exports.svgshapesSvgShapeSchema),
     fill: zod_1.z.optional(exports.svgpropertiesSvgFillSchema),
     stroke: zod_1.z.optional(exports.svgpropertiesSvgStrokeSchema),
     shadow: zod_1.z.optional(exports.svgpropertiesSvgShadowSchema),
@@ -1769,6 +1787,35 @@ exports.svgassetSvgAssetSchema = zod_1.z.object({
     opacity: zod_1.z.optional(zod_1.z.preprocess(((v) => v === '' || Array.isArray(v) ? NaN : v), zod_1.z.coerce.number().gte(0).lte(1))).default(1),
     width: zod_1.z.optional(zod_1.z.preprocess(((v) => v === '' || Array.isArray(v) ? NaN : v), zod_1.z.coerce.number().int().gte(1).lte(4096))),
     height: zod_1.z.optional(zod_1.z.preprocess(((v) => v === '' || Array.isArray(v) ? NaN : v), zod_1.z.coerce.number().int().gte(1).lte(4096))),
+}).superRefine((data, ctx) => {
+    const hasShape = data.shape !== undefined;
+    const hasSrc = data.src !== undefined && data.src.trim() !== "";
+    if (!hasShape && !hasSrc) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            message: "Either 'src' or 'shape' must be provided",
+            path: [],
+        });
+    }
+    if (hasShape && hasSrc) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            message: "Provide either 'src' or 'shape', not both",
+            path: ["src"],
+        });
+    }
+    if (hasSrc) {
+        const disallowedProps = ["shape", "fill", "stroke", "shadow", "transform", "width", "height"];
+        for (const prop of disallowedProps) {
+            if (data[prop] !== undefined) {
+                ctx.addIssue({
+                    code: zod_1.z.ZodIssueCode.custom,
+                    message: `'${prop}' is not allowed when using 'src'. Only 'type' and 'src' are allowed in import mode`,
+                    path: [prop],
+                });
+            }
+        }
+    }
 });
 exports.svgAssetSchema = exports.svgassetSvgAssetSchema;
 /**
@@ -2097,7 +2144,7 @@ exports.offsetSchema = exports.offsetOffsetSchema;
  * Rotate a clip by the specified angle in degrees. Rotation origin is set based on the clips `position`.
  */
 exports.rotatetransformationRotateTransformationSchema = zod_1.z.object({
-    angle: zod_1.z.optional(zod_1.z.union([zod_1.z.preprocess(((v) => v === '' || Array.isArray(v) ? NaN : v), zod_1.z.coerce.number().int().gte(-360).lte(360)), zod_1.z.array(exports.tweenTweenSchema)])),
+    angle: zod_1.z.optional(zod_1.z.union([zod_1.z.preprocess(((v) => v === '' || Array.isArray(v) ? NaN : v), zod_1.z.coerce.number().gte(-360).lte(360)), zod_1.z.array(exports.tweenTweenSchema)])),
 });
 exports.rotateTransformationSchema = exports.rotatetransformationRotateTransformationSchema;
 /**

package/dist/zod/zod.gen.d.ts

@@ -6107,7 +6107,7 @@ export declare const sourceresponseattributesSourceResponseAttributesSchema: z.Z
         }, z.core.$strip>>>;
     }, z.core.$strip>>;
     width: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
-    height: z.ZodOptional<z.ZodString>;
+    height: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
     duration: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
     fps: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
     created: z.ZodOptional<z.ZodString>;
@@ -6211,7 +6211,7 @@ export declare const sourceResponseAttributesSchema: z.ZodObject<{
         }, z.core.$strip>>>;
     }, z.core.$strip>>;
     width: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
-    height: z.ZodOptional<z.ZodString>;
+    height: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
     duration: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
     fps: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
     created: z.ZodOptional<z.ZodString>;
@@ -6321,7 +6321,7 @@ export declare const sourceresponsedataSourceResponseDataSchema: z.ZodObject<{
             }, z.core.$strip>>>;
         }, z.core.$strip>>;
         width: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
-        height: z.ZodOptional<z.ZodString>;
+        height: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
         duration: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
         fps: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
         created: z.ZodOptional<z.ZodString>;
@@ -6429,7 +6429,7 @@ export declare const sourceResponseDataSchema: z.ZodObject<{
             }, z.core.$strip>>>;
         }, z.core.$strip>>;
         width: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
-        height: z.ZodOptional<z.ZodString>;
+        height: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
         duration: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
         fps: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
         created: z.ZodOptional<z.ZodString>;
@@ -6541,7 +6541,7 @@ export declare const sourcelistresponseSourceListResponseSchema: z.ZodObject<{
                 }, z.core.$strip>>>;
             }, z.core.$strip>>;
             width: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
-            height: z.ZodOptional<z.ZodString>;
+            height: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
             duration: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
             fps: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
             created: z.ZodOptional<z.ZodString>;
@@ -6651,7 +6651,7 @@ export declare const sourceListResponseSchema: z.ZodObject<{
                 }, z.core.$strip>>>;
             }, z.core.$strip>>;
             width: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
-            height: z.ZodOptional<z.ZodString>;
+            height: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
             duration: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
             fps: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
             created: z.ZodOptional<z.ZodString>;
@@ -6764,7 +6764,7 @@ export declare const sourceresponseSourceResponseSchema: z.ZodObject<{
                 }, z.core.$strip>>>;
             }, z.core.$strip>>;
             width: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
-            height: z.ZodOptional<z.ZodString>;
+            height: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
             duration: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
             fps: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
             created: z.ZodOptional<z.ZodString>;
@@ -6874,7 +6874,7 @@ export declare const sourceResponseSchema: z.ZodObject<{
                 }, z.core.$strip>>>;
             }, z.core.$strip>>;
             width: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
-            height: z.ZodOptional<z.ZodString>;
+            height: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
             duration: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
             fps: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
             created: z.ZodOptional<z.ZodString>;
@@ -7825,10 +7825,33 @@ export declare const svgShapeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>], "type">;
 /**
  * The SvgAsset is used to add scalable vector graphics (SVG) shapes to a video.
- * It provides a comprehensive set of primitive shapes and custom paths with full
- * styling support including fills, strokes, gradients, and shadows.
+ * It provides two mutually exclusive ways to define shapes:
+ *
+ * **Option 1: Import SVG markup using `src`**
+ * ```json
+ * {
+ * "type": "svg",
+ * "src": "<svg width=\"100\" height=\"100\"><circle cx=\"50\" cy=\"50\" r=\"40\" fill=\"#FF0000\"/></svg>"
+ * }
+ * ```
+ * When using `src`, no other properties are allowed. The fill, stroke, and dimensions
+ * are automatically extracted from the SVG markup.
+ *
+ * **Option 2: Define shapes programmatically using `shape`**
+ * ```json
+ * {
+ * "type": "svg",
+ * "shape": { "type": "circle", "radius": 50 },
+ * "fill": { "type": "solid", "color": "#FF0000" }
+ * }
+ * ```
+ * When using `shape`, you can customize fill, stroke, shadow, transform, and other properties.
+ * The `src` property is not allowed in this mode.
+ *
+ * **Important:** You must provide either `src` OR `shape`, but not both.
+ * These two modes are mutually exclusive.
  *
- * **Available Shapes:**
+ * **Available Shapes (Option 2 only):**
  * - `rectangle` - Rectangles with optional rounded corners
  * - `circle` - Perfect circles
  * - `ellipse` - Ellipses/ovals with separate x and y radii
@@ -7841,12 +7864,6 @@ export declare const svgShapeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
  * - `ring` - Donut/ring shapes
  * - `path` - Custom shapes using SVG path data
  *
- * **Styling Options:**
- * - Fill with solid colors or linear/radial gradients
- * - Stroke with configurable width, color, dash patterns, and line caps/joins
- * - Drop shadows with blur, offset, and opacity
- * - Transform properties for positioning, rotation, and scaling
- *
  * See [W3C SVG 2 Specification](https://www.w3.org/TR/SVG2/) for path data syntax.
  *
  */
@@ -7854,7 +7871,8 @@ export declare const svgassetSvgAssetSchema: z.ZodObject<{
     type: z.ZodEnum<{
         svg: "svg";
     }>;
-    shape: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    src: z.ZodOptional<z.ZodString>;
+    shape: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodEnum<{
             rectangle: "rectangle";
         }>;
@@ -7922,7 +7940,7 @@ export declare const svgassetSvgAssetSchema: z.ZodObject<{
             path: "path";
         }>;
         d: z.ZodString;
-    }, z.core.$strip>], "type">;
+    }, z.core.$strip>], "type">>;
     fill: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodEnum<{
             solid: "solid";
@@ -7989,7 +8007,8 @@ export declare const svgAssetSchema: z.ZodObject<{
     type: z.ZodEnum<{
         svg: "svg";
     }>;
-    shape: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    src: z.ZodOptional<z.ZodString>;
+    shape: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodEnum<{
             rectangle: "rectangle";
         }>;
@@ -8057,7 +8076,7 @@ export declare const svgAssetSchema: z.ZodObject<{
             path: "path";
         }>;
         d: z.ZodString;
-    }, z.core.$strip>], "type">;
+    }, z.core.$strip>], "type">>;
     fill: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodEnum<{
             solid: "solid";
@@ -10698,7 +10717,8 @@ export declare const assetAssetSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodEnum<{
         svg: "svg";
     }>;
-    shape: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    src: z.ZodOptional<z.ZodString>;
+    shape: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodEnum<{
             rectangle: "rectangle";
         }>;
@@ -10766,7 +10786,7 @@ export declare const assetAssetSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             path: "path";
         }>;
         d: z.ZodString;
-    }, z.core.$strip>], "type">;
+    }, z.core.$strip>], "type">>;
     fill: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodEnum<{
             solid: "solid";
@@ -11352,7 +11372,8 @@ export declare const assetSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodEnum<{
         svg: "svg";
     }>;
-    shape: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    src: z.ZodOptional<z.ZodString>;
+    shape: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodEnum<{
             rectangle: "rectangle";
         }>;
@@ -11420,7 +11441,7 @@ export declare const assetSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             path: "path";
         }>;
         d: z.ZodString;
-    }, z.core.$strip>], "type">;
+    }, z.core.$strip>], "type">>;
     fill: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodEnum<{
             solid: "solid";
@@ -12010,7 +12031,8 @@ export declare const clipClipSchema: z.ZodObject<{
         type: z.ZodEnum<{
             svg: "svg";
         }>;
-        shape: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        src: z.ZodOptional<z.ZodString>;
+        shape: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
             type: z.ZodEnum<{
                 rectangle: "rectangle";
             }>;
@@ -12078,7 +12100,7 @@ export declare const clipClipSchema: z.ZodObject<{
                 path: "path";
             }>;
             d: z.ZodString;
-        }, z.core.$strip>], "type">;
+        }, z.core.$strip>], "type">>;
         fill: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
             type: z.ZodEnum<{
                 solid: "solid";
@@ -13110,7 +13132,8 @@ export declare const clipSchema: z.ZodObject<{
         type: z.ZodEnum<{
             svg: "svg";
         }>;
-        shape: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        src: z.ZodOptional<z.ZodString>;
+        shape: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
             type: z.ZodEnum<{
                 rectangle: "rectangle";
             }>;
@@ -13178,7 +13201,7 @@ export declare const clipSchema: z.ZodObject<{
                 path: "path";
             }>;
             d: z.ZodString;
-        }, z.core.$strip>], "type">;
+        }, z.core.$strip>], "type">>;
         fill: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
             type: z.ZodEnum<{
                 solid: "solid";
@@ -14214,7 +14237,8 @@ export declare const trackTrackSchema: z.ZodObject<{
             type: z.ZodEnum<{
                 svg: "svg";
             }>;
-            shape: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            src: z.ZodOptional<z.ZodString>;
+            shape: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 type: z.ZodEnum<{
                     rectangle: "rectangle";
                 }>;
@@ -14282,7 +14306,7 @@ export declare const trackTrackSchema: z.ZodObject<{
                     path: "path";
                 }>;
                 d: z.ZodString;
-            }, z.core.$strip>], "type">;
+            }, z.core.$strip>], "type">>;
             fill: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 type: z.ZodEnum<{
                     solid: "solid";
@@ -15316,7 +15340,8 @@ export declare const trackSchema: z.ZodObject<{
             type: z.ZodEnum<{
                 svg: "svg";
             }>;
-            shape: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            src: z.ZodOptional<z.ZodString>;
+            shape: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 type: z.ZodEnum<{
                     rectangle: "rectangle";
                 }>;
@@ -15384,7 +15409,7 @@ export declare const trackSchema: z.ZodObject<{
                     path: "path";
                 }>;
                 d: z.ZodString;
-            }, z.core.$strip>], "type">;
+            }, z.core.$strip>], "type">>;
             fill: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 type: z.ZodEnum<{
                     solid: "solid";
@@ -16435,7 +16460,8 @@ export declare const timelineTimelineSchema: z.ZodObject<{
                 type: z.ZodEnum<{
                     svg: "svg";
                 }>;
-                shape: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                src: z.ZodOptional<z.ZodString>;
+                shape: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                     type: z.ZodEnum<{
                         rectangle: "rectangle";
                     }>;
@@ -16503,7 +16529,7 @@ export declare const timelineTimelineSchema: z.ZodObject<{
                         path: "path";
                     }>;
                     d: z.ZodString;
-                }, z.core.$strip>], "type">;
+                }, z.core.$strip>], "type">>;
                 fill: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                     type: z.ZodEnum<{
                         solid: "solid";
@@ -17553,7 +17579,8 @@ export declare const timelineSchema: z.ZodObject<{
                 type: z.ZodEnum<{
                     svg: "svg";
                 }>;
-                shape: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                src: z.ZodOptional<z.ZodString>;
+                shape: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                     type: z.ZodEnum<{
                         rectangle: "rectangle";
                     }>;
@@ -17621,7 +17648,7 @@ export declare const timelineSchema: z.ZodObject<{
                         path: "path";
                     }>;
                     d: z.ZodString;
-                }, z.core.$strip>], "type">;
+                }, z.core.$strip>], "type">>;
                 fill: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                     type: z.ZodEnum<{
                         solid: "solid";
@@ -18675,7 +18702,8 @@ export declare const editEditSchema: z.ZodObject<{
                     type: z.ZodEnum<{
                         svg: "svg";
                     }>;
-                    shape: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    src: z.ZodOptional<z.ZodString>;
+                    shape: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                         type: z.ZodEnum<{
                             rectangle: "rectangle";
                         }>;
@@ -18743,7 +18771,7 @@ export declare const editEditSchema: z.ZodObject<{
                             path: "path";
                         }>;
                         d: z.ZodString;
-                    }, z.core.$strip>], "type">;
+                    }, z.core.$strip>], "type">>;
                     fill: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                         type: z.ZodEnum<{
                             solid: "solid";
@@ -19950,7 +19978,8 @@ export declare const editSchema: z.ZodObject<{
                     type: z.ZodEnum<{
                         svg: "svg";
                     }>;
-                    shape: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    src: z.ZodOptional<z.ZodString>;
+                    shape: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                         type: z.ZodEnum<{
                             rectangle: "rectangle";
                         }>;
@@ -20018,7 +20047,7 @@ export declare const editSchema: z.ZodObject<{
                             path: "path";
                         }>;
                         d: z.ZodString;
-                    }, z.core.$strip>], "type">;
+                    }, z.core.$strip>], "type">>;
                     fill: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                         type: z.ZodEnum<{
                             solid: "solid";
@@ -21247,7 +21276,8 @@ export declare const renderresponsedataRenderResponseDataSchema: z.ZodObject<{
                         type: z.ZodEnum<{
                             svg: "svg";
                         }>;
-                        shape: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        src: z.ZodOptional<z.ZodString>;
+                        shape: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                             type: z.ZodEnum<{
                                 rectangle: "rectangle";
                             }>;
@@ -21315,7 +21345,7 @@ export declare const renderresponsedataRenderResponseDataSchema: z.ZodObject<{
                                 path: "path";
                             }>;
                             d: z.ZodString;
-                        }, z.core.$strip>], "type">;
+                        }, z.core.$strip>], "type">>;
                         fill: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                             type: z.ZodEnum<{
                                 solid: "solid";
@@ -22544,7 +22574,8 @@ export declare const renderResponseDataSchema: z.ZodObject<{
                         type: z.ZodEnum<{
                             svg: "svg";
                         }>;
-                        shape: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        src: z.ZodOptional<z.ZodString>;
+                        shape: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                             type: z.ZodEnum<{
                                 rectangle: "rectangle";
                             }>;
@@ -22612,7 +22643,7 @@ export declare const renderResponseDataSchema: z.ZodObject<{
                                 path: "path";
                             }>;
                             d: z.ZodString;
-                        }, z.core.$strip>], "type">;
+                        }, z.core.$strip>], "type">>;
                         fill: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                             type: z.ZodEnum<{
                                 solid: "solid";
@@ -23847,7 +23878,8 @@ export declare const renderresponseRenderResponseSchema: z.ZodObject<{
                             type: z.ZodEnum<{
                                 svg: "svg";
                             }>;
-                            shape: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                            src: z.ZodOptional<z.ZodString>;
+                            shape: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                                 type: z.ZodEnum<{
                                     rectangle: "rectangle";
                                 }>;
@@ -23915,7 +23947,7 @@ export declare const renderresponseRenderResponseSchema: z.ZodObject<{
                                     path: "path";
                                 }>;
                                 d: z.ZodString;
-                            }, z.core.$strip>], "type">;
+                            }, z.core.$strip>], "type">>;
                             fill: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                                 type: z.ZodEnum<{
                                     solid: "solid";
@@ -25148,7 +25180,8 @@ export declare const renderResponseSchema: z.ZodObject<{
                             type: z.ZodEnum<{
                                 svg: "svg";
                             }>;
-                            shape: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                            src: z.ZodOptional<z.ZodString>;
+                            shape: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                                 type: z.ZodEnum<{
                                     rectangle: "rectangle";
                                 }>;
@@ -25216,7 +25249,7 @@ export declare const renderResponseSchema: z.ZodObject<{
                                     path: "path";
                                 }>;
                                 d: z.ZodString;
-                            }, z.core.$strip>], "type">;
+                            }, z.core.$strip>], "type">>;
                             fill: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                                 type: z.ZodEnum<{
                                     solid: "solid";
@@ -26434,7 +26467,8 @@ export declare const templatedataresponsedataTemplateDataResponseDataSchema: z.Z
                         type: z.ZodEnum<{
                             svg: "svg";
                         }>;
-                        shape: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        src: z.ZodOptional<z.ZodString>;
+                        shape: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                             type: z.ZodEnum<{
                                 rectangle: "rectangle";
                             }>;
@@ -26502,7 +26536,7 @@ export declare const templatedataresponsedataTemplateDataResponseDataSchema: z.Z
                                 path: "path";
                             }>;
                             d: z.ZodString;
-                        }, z.core.$strip>], "type">;
+                        }, z.core.$strip>], "type">>;
                         fill: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                             type: z.ZodEnum<{
                                 solid: "solid";
@@ -27714,7 +27748,8 @@ export declare const templateDataResponseDataSchema: z.ZodObject<{
                         type: z.ZodEnum<{
                             svg: "svg";
                         }>;
-                        shape: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        src: z.ZodOptional<z.ZodString>;
+                        shape: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                             type: z.ZodEnum<{
                                 rectangle: "rectangle";
                             }>;
@@ -27782,7 +27817,7 @@ export declare const templateDataResponseDataSchema: z.ZodObject<{
                                 path: "path";
                             }>;
                             d: z.ZodString;
-                        }, z.core.$strip>], "type">;
+                        }, z.core.$strip>], "type">>;
                         fill: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                             type: z.ZodEnum<{
                                 solid: "solid";
@@ -29000,7 +29035,8 @@ export declare const templatedataresponseTemplateDataResponseSchema: z.ZodObject
                             type: z.ZodEnum<{
                                 svg: "svg";
                             }>;
-                            shape: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                            src: z.ZodOptional<z.ZodString>;
+                            shape: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                                 type: z.ZodEnum<{
                                     rectangle: "rectangle";
                                 }>;
@@ -29068,7 +29104,7 @@ export declare const templatedataresponseTemplateDataResponseSchema: z.ZodObject
                                     path: "path";
                                 }>;
                                 d: z.ZodString;
-                            }, z.core.$strip>], "type">;
+                            }, z.core.$strip>], "type">>;
                             fill: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                                 type: z.ZodEnum<{
                                     solid: "solid";
@@ -30284,7 +30320,8 @@ export declare const templateDataResponseSchema: z.ZodObject<{
                             type: z.ZodEnum<{
                                 svg: "svg";
                             }>;
-                            shape: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                            src: z.ZodOptional<z.ZodString>;
+                            shape: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                                 type: z.ZodEnum<{
                                     rectangle: "rectangle";
                                 }>;
@@ -30352,7 +30389,7 @@ export declare const templateDataResponseSchema: z.ZodObject<{
                                     path: "path";
                                 }>;
                                 d: z.ZodString;
-                            }, z.core.$strip>], "type">;
+                            }, z.core.$strip>], "type">>;
                             fill: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                                 type: z.ZodEnum<{
                                     solid: "solid";
@@ -31566,7 +31603,8 @@ export declare const templateTemplateSchema: z.ZodObject<{
                         type: z.ZodEnum<{
                             svg: "svg";
                         }>;
-                        shape: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        src: z.ZodOptional<z.ZodString>;
+                        shape: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                             type: z.ZodEnum<{
                                 rectangle: "rectangle";
                             }>;
@@ -31634,7 +31672,7 @@ export declare const templateTemplateSchema: z.ZodObject<{
                                 path: "path";
                             }>;
                             d: z.ZodString;
-                        }, z.core.$strip>], "type">;
+                        }, z.core.$strip>], "type">>;
                         fill: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                             type: z.ZodEnum<{
                                 solid: "solid";
@@ -32844,7 +32882,8 @@ export declare const templateSchema: z.ZodObject<{
                         type: z.ZodEnum<{
                             svg: "svg";
                         }>;
-                        shape: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        src: z.ZodOptional<z.ZodString>;
+                        shape: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                             type: z.ZodEnum<{
                                 rectangle: "rectangle";
                             }>;
@@ -32912,7 +32951,7 @@ export declare const templateSchema: z.ZodObject<{
                                 path: "path";
                             }>;
                             d: z.ZodString;
-                        }, z.core.$strip>], "type">;
+                        }, z.core.$strip>], "type">>;
                         fill: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                             type: z.ZodEnum<{
                                 solid: "solid";
@@ -34121,7 +34160,8 @@ export declare const postRenderRequest: z.ZodObject<{
                         type: z.ZodEnum<{
                             svg: "svg";
                         }>;
-                        shape: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        src: z.ZodOptional<z.ZodString>;
+                        shape: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                             type: z.ZodEnum<{
                                 rectangle: "rectangle";
                             }>;
@@ -34189,7 +34229,7 @@ export declare const postRenderRequest: z.ZodObject<{
                                 path: "path";
                             }>;
                             d: z.ZodString;
-                        }, z.core.$strip>], "type">;
+                        }, z.core.$strip>], "type">>;
                         fill: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                             type: z.ZodEnum<{
                                 solid: "solid";
@@ -35445,7 +35485,8 @@ export declare const getRenderResponse: z.ZodObject<{
                             type: z.ZodEnum<{
                                 svg: "svg";
                             }>;
-                            shape: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                            src: z.ZodOptional<z.ZodString>;
+                            shape: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                                 type: z.ZodEnum<{
                                     rectangle: "rectangle";
                                 }>;
@@ -35513,7 +35554,7 @@ export declare const getRenderResponse: z.ZodObject<{
                                     path: "path";
                                 }>;
                                 d: z.ZodString;
-                            }, z.core.$strip>], "type">;
+                            }, z.core.$strip>], "type">>;
                             fill: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                                 type: z.ZodEnum<{
                                     solid: "solid";
@@ -36748,7 +36789,8 @@ export declare const postTemplateRequest: z.ZodObject<{
                             type: z.ZodEnum<{
                                 svg: "svg";
                             }>;
-                            shape: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                            src: z.ZodOptional<z.ZodString>;
+                            shape: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                                 type: z.ZodEnum<{
                                     rectangle: "rectangle";
                                 }>;
@@ -36816,7 +36858,7 @@ export declare const postTemplateRequest: z.ZodObject<{
                                     path: "path";
                                 }>;
                                 d: z.ZodString;
-                            }, z.core.$strip>], "type">;
+                            }, z.core.$strip>], "type">>;
                             fill: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                                 type: z.ZodEnum<{
                                     solid: "solid";
@@ -38066,7 +38108,8 @@ export declare const getTemplateResponse: z.ZodObject<{
                             type: z.ZodEnum<{
                                 svg: "svg";
                             }>;
-                            shape: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                            src: z.ZodOptional<z.ZodString>;
+                            shape: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                                 type: z.ZodEnum<{
                                     rectangle: "rectangle";
                                 }>;
@@ -38134,7 +38177,7 @@ export declare const getTemplateResponse: z.ZodObject<{
                                     path: "path";
                                 }>;
                                 d: z.ZodString;
-                            }, z.core.$strip>], "type">;
+                            }, z.core.$strip>], "type">>;
                             fill: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                                 type: z.ZodEnum<{
                                     solid: "solid";
@@ -39346,7 +39389,8 @@ export declare const putTemplateRequest: z.ZodObject<{
                             type: z.ZodEnum<{
                                 svg: "svg";
                             }>;
-                            shape: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                            src: z.ZodOptional<z.ZodString>;
+                            shape: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                                 type: z.ZodEnum<{
                                     rectangle: "rectangle";
                                 }>;
@@ -39414,7 +39458,7 @@ export declare const putTemplateRequest: z.ZodObject<{
                                     path: "path";
                                 }>;
                                 d: z.ZodString;
-                            }, z.core.$strip>], "type">;
+                            }, z.core.$strip>], "type">>;
                             fill: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
                                 type: z.ZodEnum<{
                                     solid: "solid";
@@ -40468,7 +40512,7 @@ export declare const getSourcesResponse: z.ZodObject<{
                 }, z.core.$strip>>>;
             }, z.core.$strip>>;
             width: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
-            height: z.ZodOptional<z.ZodString>;
+            height: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
             duration: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
             fps: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
             created: z.ZodOptional<z.ZodString>;
@@ -40777,7 +40821,7 @@ export declare const getSourceResponse: z.ZodObject<{
                 }, z.core.$strip>>>;
             }, z.core.$strip>>;
             width: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
-            height: z.ZodOptional<z.ZodString>;
+            height: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
             duration: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
             fps: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>>;
             created: z.ZodOptional<z.ZodString>;

package/dist/zod/zod.gen.js

@@ -1420,7 +1420,7 @@ export const sourceresponseattributesSourceResponseAttributesSchema = z.object({
     status: z.optional(z.enum(["queued", "importing", "ready", "failed", "deleted", "overwritten"])),
     outputs: z.optional(outputsresponseOutputsResponseSchema),
     width: z.optional(z.preprocess(((v) => v === '' || Array.isArray(v) ? NaN : v), z.coerce.number().int())),
-    height: z.optional(z.string()),
+    height: z.optional(z.preprocess(((v) => v === '' || Array.isArray(v) ? NaN : v), z.coerce.number().int())),
     duration: z.optional(z.preprocess(((v) => v === '' || Array.isArray(v) ? NaN : v), z.coerce.number())),
     fps: z.optional(z.preprocess(((v) => v === '' || Array.isArray(v) ? NaN : v), z.coerce.number())),
     created: z.optional(z.string()),
@@ -1724,10 +1724,33 @@ export const svgshapesSvgShapeSchema = z.discriminatedUnion("type", [
 export const svgShapeSchema = svgshapesSvgShapeSchema;
 /**
  * The SvgAsset is used to add scalable vector graphics (SVG) shapes to a video.
- * It provides a comprehensive set of primitive shapes and custom paths with full
- * styling support including fills, strokes, gradients, and shadows.
+ * It provides two mutually exclusive ways to define shapes:
+ *
+ * **Option 1: Import SVG markup using `src`**
+ * ```json
+ * {
+ * "type": "svg",
+ * "src": "<svg width=\"100\" height=\"100\"><circle cx=\"50\" cy=\"50\" r=\"40\" fill=\"#FF0000\"/></svg>"
+ * }
+ * ```
+ * When using `src`, no other properties are allowed. The fill, stroke, and dimensions
+ * are automatically extracted from the SVG markup.
+ *
+ * **Option 2: Define shapes programmatically using `shape`**
+ * ```json
+ * {
+ * "type": "svg",
+ * "shape": { "type": "circle", "radius": 50 },
+ * "fill": { "type": "solid", "color": "#FF0000" }
+ * }
+ * ```
+ * When using `shape`, you can customize fill, stroke, shadow, transform, and other properties.
+ * The `src` property is not allowed in this mode.
  *
- * **Available Shapes:**
+ * **Important:** You must provide either `src` OR `shape`, but not both.
+ * These two modes are mutually exclusive.
+ *
+ * **Available Shapes (Option 2 only):**
  * - `rectangle` - Rectangles with optional rounded corners
  * - `circle` - Perfect circles
  * - `ellipse` - Ellipses/ovals with separate x and y radii
@@ -1740,18 +1763,13 @@ export const svgShapeSchema = svgshapesSvgShapeSchema;
  * - `ring` - Donut/ring shapes
  * - `path` - Custom shapes using SVG path data
  *
- * **Styling Options:**
- * - Fill with solid colors or linear/radial gradients
- * - Stroke with configurable width, color, dash patterns, and line caps/joins
- * - Drop shadows with blur, offset, and opacity
- * - Transform properties for positioning, rotation, and scaling
- *
  * See [W3C SVG 2 Specification](https://www.w3.org/TR/SVG2/) for path data syntax.
  *
  */
 export const svgassetSvgAssetSchema = z.object({
     type: z.enum(["svg"]),
-    shape: svgshapesSvgShapeSchema,
+    src: z.optional(z.string().min(1).max(500000)),
+    shape: z.optional(svgshapesSvgShapeSchema),
     fill: z.optional(svgpropertiesSvgFillSchema),
     stroke: z.optional(svgpropertiesSvgStrokeSchema),
     shadow: z.optional(svgpropertiesSvgShadowSchema),
@@ -1759,6 +1777,35 @@ export const svgassetSvgAssetSchema = z.object({
     opacity: z.optional(z.preprocess(((v) => v === '' || Array.isArray(v) ? NaN : v), z.coerce.number().gte(0).lte(1))).default(1),
     width: z.optional(z.preprocess(((v) => v === '' || Array.isArray(v) ? NaN : v), z.coerce.number().int().gte(1).lte(4096))),
     height: z.optional(z.preprocess(((v) => v === '' || Array.isArray(v) ? NaN : v), z.coerce.number().int().gte(1).lte(4096))),
+}).superRefine((data, ctx) => {
+    const hasShape = data.shape !== undefined;
+    const hasSrc = data.src !== undefined && data.src.trim() !== "";
+    if (!hasShape && !hasSrc) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "Either 'src' or 'shape' must be provided",
+            path: [],
+        });
+    }
+    if (hasShape && hasSrc) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "Provide either 'src' or 'shape', not both",
+            path: ["src"],
+        });
+    }
+    if (hasSrc) {
+        const disallowedProps = ["shape", "fill", "stroke", "shadow", "transform", "width", "height"];
+        for (const prop of disallowedProps) {
+            if (data[prop] !== undefined) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: `'${prop}' is not allowed when using 'src'. Only 'type' and 'src' are allowed in import mode`,
+                    path: [prop],
+                });
+            }
+        }
+    }
 });
 export const svgAssetSchema = svgassetSvgAssetSchema;
 /**
@@ -2087,7 +2134,7 @@ export const offsetSchema = offsetOffsetSchema;
  * Rotate a clip by the specified angle in degrees. Rotation origin is set based on the clips `position`.
  */
 export const rotatetransformationRotateTransformationSchema = z.object({
-    angle: z.optional(z.union([z.preprocess(((v) => v === '' || Array.isArray(v) ? NaN : v), z.coerce.number().int().gte(-360).lte(360)), z.array(tweenTweenSchema)])),
+    angle: z.optional(z.union([z.preprocess(((v) => v === '' || Array.isArray(v) ? NaN : v), z.coerce.number().gte(-360).lte(360)), z.array(tweenTweenSchema)])),
 });
 export const rotateTransformationSchema = rotatetransformationRotateTransformationSchema;
 /**

package/dist/zod/zod.gen.ts

@@ -1787,7 +1787,7 @@ export const sourceresponseattributesSourceResponseAttributesSchema = z.object({
   ),
   outputs: z.optional(outputsresponseOutputsResponseSchema),
   width: z.optional(z.preprocess(((v: unknown) => v === '' || Array.isArray(v) ? NaN : v), z.coerce.number().int())),
-  height: z.optional(z.string()),
+  height: z.optional(z.preprocess(((v: unknown) => v === '' || Array.isArray(v) ? NaN : v), z.coerce.number().int())),
   duration: z.optional(z.preprocess(((v: unknown) => v === '' || Array.isArray(v) ? NaN : v), z.coerce.number())),
   fps: z.optional(z.preprocess(((v: unknown) => v === '' || Array.isArray(v) ? NaN : v), z.coerce.number())),
   created: z.optional(z.string()),
@@ -2148,10 +2148,33 @@ export const svgShapeSchema = svgshapesSvgShapeSchema;
 
 /**
  * The SvgAsset is used to add scalable vector graphics (SVG) shapes to a video.
- * It provides a comprehensive set of primitive shapes and custom paths with full
- * styling support including fills, strokes, gradients, and shadows.
+ * It provides two mutually exclusive ways to define shapes:
+ *
+ * **Option 1: Import SVG markup using `src`**
+ * ```json
+ * {
+ * "type": "svg",
+ * "src": "<svg width=\"100\" height=\"100\"><circle cx=\"50\" cy=\"50\" r=\"40\" fill=\"#FF0000\"/></svg>"
+ * }
+ * ```
+ * When using `src`, no other properties are allowed. The fill, stroke, and dimensions
+ * are automatically extracted from the SVG markup.
+ *
+ * **Option 2: Define shapes programmatically using `shape`**
+ * ```json
+ * {
+ * "type": "svg",
+ * "shape": { "type": "circle", "radius": 50 },
+ * "fill": { "type": "solid", "color": "#FF0000" }
+ * }
+ * ```
+ * When using `shape`, you can customize fill, stroke, shadow, transform, and other properties.
+ * The `src` property is not allowed in this mode.
  *
- * **Available Shapes:**
+ * **Important:** You must provide either `src` OR `shape`, but not both.
+ * These two modes are mutually exclusive.
+ *
+ * **Available Shapes (Option 2 only):**
  * - `rectangle` - Rectangles with optional rounded corners
  * - `circle` - Perfect circles
  * - `ellipse` - Ellipses/ovals with separate x and y radii
@@ -2164,18 +2187,13 @@ export const svgShapeSchema = svgshapesSvgShapeSchema;
  * - `ring` - Donut/ring shapes
  * - `path` - Custom shapes using SVG path data
  *
- * **Styling Options:**
- * - Fill with solid colors or linear/radial gradients
- * - Stroke with configurable width, color, dash patterns, and line caps/joins
- * - Drop shadows with blur, offset, and opacity
- * - Transform properties for positioning, rotation, and scaling
- *
  * See [W3C SVG 2 Specification](https://www.w3.org/TR/SVG2/) for path data syntax.
  *
  */
 export const svgassetSvgAssetSchema = z.object({
   type: z.enum(["svg"]),
-  shape: svgshapesSvgShapeSchema,
+  src: z.optional(z.string().min(1).max(500000)),
+  shape: z.optional(svgshapesSvgShapeSchema),
   fill: z.optional(svgpropertiesSvgFillSchema),
   stroke: z.optional(svgpropertiesSvgStrokeSchema),
   shadow: z.optional(svgpropertiesSvgShadowSchema),
@@ -2183,6 +2201,38 @@ export const svgassetSvgAssetSchema = z.object({
   opacity: z.optional(z.preprocess(((v: unknown) => v === '' || Array.isArray(v) ? NaN : v), z.coerce.number().gte(0).lte(1))).default(1),
   width: z.optional(z.preprocess(((v: unknown) => v === '' || Array.isArray(v) ? NaN : v), z.coerce.number().int().gte(1).lte(4096))),
   height: z.optional(z.preprocess(((v: unknown) => v === '' || Array.isArray(v) ? NaN : v), z.coerce.number().int().gte(1).lte(4096))),
+}).superRefine((data, ctx) => {
+  const hasShape = data.shape !== undefined;
+  const hasSrc = data.src !== undefined && data.src.trim() !== "";
+
+  if (!hasShape && !hasSrc) {
+    ctx.addIssue({
+      code: z.ZodIssueCode.custom,
+      message: "Either 'src' or 'shape' must be provided",
+      path: [],
+    });
+  }
+
+  if (hasShape && hasSrc) {
+    ctx.addIssue({
+      code: z.ZodIssueCode.custom,
+      message: "Provide either 'src' or 'shape', not both",
+      path: ["src"],
+    });
+  }
+
+  if (hasSrc) {
+    const disallowedProps = ["shape", "fill", "stroke", "shadow", "transform", "width", "height"];
+    for (const prop of disallowedProps) {
+      if (data[prop] !== undefined) {
+        ctx.addIssue({
+          code: z.ZodIssueCode.custom,
+          message: `'${prop}' is not allowed when using 'src'. Only 'type' and 'src' are allowed in import mode`,
+          path: [prop],
+        });
+      }
+    }
+  }
 });
 
 export const svgAssetSchema = svgassetSvgAssetSchema;
@@ -2556,7 +2606,7 @@ export const offsetSchema = offsetOffsetSchema;
  */
 export const rotatetransformationRotateTransformationSchema = z.object({
   angle: z.optional(
-    z.union([z.preprocess(((v: unknown) => v === '' || Array.isArray(v) ? NaN : v), z.coerce.number().int().gte(-360).lte(360)), z.array(tweenTweenSchema)])
+    z.union([z.preprocess(((v: unknown) => v === '' || Array.isArray(v) ? NaN : v), z.coerce.number().gte(-360).lte(360)), z.array(tweenTweenSchema)])
   ),
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shotstack/schemas",
-  "version": "1.3.8",
+  "version": "1.4.0",
   "description": "Centralized OpenAPI schemas and TypeScript types for Shotstack API",
   "type": "module",
   "main": "dist/index.js",