@shotstack/schemas 1.5.9 → 1.7.0

package/dist/json-schema/rich-text-background.json

@@ -0,0 +1,52 @@
+{
+  "name": "RichTextBackground",
+  "strict": true,
+  "schema": {
+    "description": "Background styling properties for the text bounding box.",
+    "properties": {
+      "color": {
+        "anyOf": [
+          {
+            "type": "string",
+            "description": "The background color using hexadecimal color notation."
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "opacity": {
+        "anyOf": [
+          {
+            "type": "number",
+            "description": "The opacity of the background where 1 is opaque and 0 is transparent.",
+            "minimum": 0,
+            "maximum": 1
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "borderRadius": {
+        "anyOf": [
+          {
+            "type": "number",
+            "description": "The border radius of the background box in pixels. Must be 0 or greater.",
+            "minimum": 0
+          },
+          {
+            "type": "null"
+          }
+        ]
+      }
+    },
+    "additionalProperties": false,
+    "type": "object",
+    "required": [
+      "color",
+      "opacity",
+      "borderRadius"
+    ]
+  }
+}

package/dist/json-schema/rich-text-font.json

@@ -0,0 +1,157 @@
+{
+  "name": "RichTextFont",
+  "strict": true,
+  "schema": {
+    "description": "Font properties for rich text.",
+    "properties": {
+      "family": {
+        "anyOf": [
+          {
+            "type": "string",
+            "description": "The font family name. This must be the Family name embedded in the font, i.e. \"Open Sans\".",
+            "enum": [
+              "Open Sans"
+            ]
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "size": {
+        "anyOf": [
+          {
+            "type": "integer",
+            "description": "The size of the font in pixels (px). Must be between 1 and 500.",
+            "minimum": 1,
+            "maximum": 500
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "weight": {
+        "anyOf": [
+          {
+            "type": "string",
+            "description": "The weight of the font. Can be a number (100-900) or a string ('normal', 'bold', etc.). 100 is lightest, 900 is heaviest (boldest)."
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "color": {
+        "anyOf": [
+          {
+            "type": "string",
+            "description": "The text color using hexadecimal color notation."
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "opacity": {
+        "anyOf": [
+          {
+            "type": "number",
+            "description": "The opacity of the text where 1 is opaque and 0 is transparent.",
+            "minimum": 0,
+            "maximum": 1
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "background": {
+        "anyOf": [
+          {
+            "type": "string",
+            "description": "The background color behind the text using hexadecimal color notation."
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "stroke": {
+        "anyOf": [
+          {
+            "description": "Text stroke (outline) properties.",
+            "$ref": "#/$defs/RichTextStroke"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      }
+    },
+    "additionalProperties": false,
+    "type": "object",
+    "required": [
+      "family",
+      "size",
+      "weight",
+      "color",
+      "opacity",
+      "background",
+      "stroke"
+    ],
+    "$defs": {
+      "RichTextStroke": {
+        "description": "Text stroke (outline) properties.",
+        "properties": {
+          "width": {
+            "anyOf": [
+              {
+                "type": "number",
+                "description": "The width of the stroke in pixels. Must be 0 or greater.",
+                "minimum": 0
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "color": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The stroke color using hexadecimal color notation.",
+                "enum": [
+                  "#000000"
+                ]
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "opacity": {
+            "anyOf": [
+              {
+                "type": "number",
+                "description": "The opacity of the stroke where 1 is opaque and 0 is transparent.",
+                "minimum": 0,
+                "maximum": 1
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "additionalProperties": false,
+        "type": "object",
+        "required": [
+          "width",
+          "color",
+          "opacity"
+        ]
+      }
+    }
+  }
+}

package/dist/json-schema/rich-text-gradient.json

@@ -0,0 +1,68 @@
+{
+  "name": "RichTextGradient",
+  "strict": true,
+  "schema": {
+    "description": "Gradient properties for text fill.",
+    "properties": {
+      "type": {
+        "anyOf": [
+          {
+            "type": "string",
+            "description": "The type of gradient.",
+            "enum": [
+              "linear",
+              "radial"
+            ]
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "angle": {
+        "anyOf": [
+          {
+            "type": "number",
+            "description": "The angle of the gradient in degrees (for linear gradients). Must be between 0 and 360.",
+            "minimum": 0,
+            "maximum": 360
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "stops": {
+        "description": "Gradient color stops. Must have at least 2 stops.",
+        "type": "array",
+        "items": {
+          "type": "object",
+          "properties": {
+            "offset": {
+              "description": "Position of the color stop between 0 (start) and 1 (end).",
+              "type": "number",
+              "minimum": 0,
+              "maximum": 1
+            },
+            "color": {
+              "description": "Color at this stop using hexadecimal color notation.",
+              "type": "string"
+            }
+          },
+          "required": [
+            "offset",
+            "color"
+          ],
+          "additionalProperties": false
+        }
+      }
+    },
+    "required": [
+      "type",
+      "angle",
+      "stops"
+    ],
+    "additionalProperties": false,
+    "type": "object"
+  }
+}

package/dist/json-schema/rich-text-shadow.json

@@ -0,0 +1,79 @@
+{
+  "name": "RichTextShadow",
+  "strict": true,
+  "schema": {
+    "description": "Text shadow properties.",
+    "properties": {
+      "offsetX": {
+        "anyOf": [
+          {
+            "type": "number",
+            "description": "Horizontal offset of the shadow in pixels. Positive values move right, negative left."
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "offsetY": {
+        "anyOf": [
+          {
+            "type": "number",
+            "description": "Vertical offset of the shadow in pixels. Positive values move down, negative up."
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "blur": {
+        "anyOf": [
+          {
+            "type": "number",
+            "description": "The blur radius of the shadow in pixels. Must be 0 or greater.",
+            "minimum": 0
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "color": {
+        "anyOf": [
+          {
+            "type": "string",
+            "description": "The shadow color using hexadecimal color notation.",
+            "enum": [
+              "#000000"
+            ]
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "opacity": {
+        "anyOf": [
+          {
+            "type": "number",
+            "description": "The opacity of the shadow where 1 is opaque and 0 is transparent.",
+            "minimum": 0,
+            "maximum": 1
+          },
+          {
+            "type": "null"
+          }
+        ]
+      }
+    },
+    "additionalProperties": false,
+    "type": "object",
+    "required": [
+      "offsetX",
+      "offsetY",
+      "blur",
+      "color",
+      "opacity"
+    ]
+  }
+}

package/dist/json-schema/rich-text-stroke.json

@@ -0,0 +1,55 @@
+{
+  "name": "RichTextStroke",
+  "strict": true,
+  "schema": {
+    "description": "Text stroke (outline) properties.",
+    "properties": {
+      "width": {
+        "anyOf": [
+          {
+            "type": "number",
+            "description": "The width of the stroke in pixels. Must be 0 or greater.",
+            "minimum": 0
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "color": {
+        "anyOf": [
+          {
+            "type": "string",
+            "description": "The stroke color using hexadecimal color notation.",
+            "enum": [
+              "#000000"
+            ]
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "opacity": {
+        "anyOf": [
+          {
+            "type": "number",
+            "description": "The opacity of the stroke where 1 is opaque and 0 is transparent.",
+            "minimum": 0,
+            "maximum": 1
+          },
+          {
+            "type": "null"
+          }
+        ]
+      }
+    },
+    "additionalProperties": false,
+    "type": "object",
+    "required": [
+      "width",
+      "color",
+      "opacity"
+    ]
+  }
+}

package/dist/json-schema/rich-text-style.json

@@ -0,0 +1,165 @@
+{
+  "name": "RichTextStyle",
+  "strict": true,
+  "schema": {
+    "description": "Text style properties including spacing, line height, and transformations.",
+    "properties": {
+      "letterSpacing": {
+        "anyOf": [
+          {
+            "type": "number",
+            "description": "Additional spacing between letters in pixels. Can be negative for tighter spacing."
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "wordSpacing": {
+        "anyOf": [
+          {
+            "type": "number",
+            "description": "Additional spacing between words in pixels. A value of 0 uses the font's natural space width.",
+            "minimum": 0
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "lineHeight": {
+        "anyOf": [
+          {
+            "type": "number",
+            "description": "The line height as a multiplier of the font size. Must be between 0 and 10.",
+            "minimum": 0,
+            "maximum": 10
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "textTransform": {
+        "anyOf": [
+          {
+            "type": "string",
+            "description": "Text transformation to apply.",
+            "enum": [
+              "none",
+              "uppercase",
+              "lowercase",
+              "capitalize"
+            ]
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "textDecoration": {
+        "anyOf": [
+          {
+            "type": "string",
+            "description": "Text decoration to apply.",
+            "enum": [
+              "none",
+              "underline",
+              "line-through"
+            ]
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "gradient": {
+        "anyOf": [
+          {
+            "description": "Gradient fill for text instead of solid color.",
+            "$ref": "#/$defs/RichTextGradient"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      }
+    },
+    "additionalProperties": false,
+    "type": "object",
+    "required": [
+      "letterSpacing",
+      "wordSpacing",
+      "lineHeight",
+      "textTransform",
+      "textDecoration",
+      "gradient"
+    ],
+    "$defs": {
+      "RichTextGradient": {
+        "description": "Gradient properties for text fill.",
+        "properties": {
+          "type": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The type of gradient.",
+                "enum": [
+                  "linear",
+                  "radial"
+                ]
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "angle": {
+            "anyOf": [
+              {
+                "type": "number",
+                "description": "The angle of the gradient in degrees (for linear gradients). Must be between 0 and 360.",
+                "minimum": 0,
+                "maximum": 360
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "stops": {
+            "description": "Gradient color stops. Must have at least 2 stops.",
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "offset": {
+                  "description": "Position of the color stop between 0 (start) and 1 (end).",
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 1
+                },
+                "color": {
+                  "description": "Color at this stop using hexadecimal color notation.",
+                  "type": "string"
+                }
+              },
+              "required": [
+                "offset",
+                "color"
+              ],
+              "additionalProperties": false
+            }
+          }
+        },
+        "required": [
+          "type",
+          "angle",
+          "stops"
+        ],
+        "additionalProperties": false,
+        "type": "object"
+      }
+    }
+  }
+}

package/dist/json-schema/rotate-transformation.json

@@ -0,0 +1,123 @@
+{
+  "name": "RotateTransformation",
+  "strict": true,
+  "schema": {
+    "description": "Rotate a clip by the specified angle in degrees. Rotation origin is set based on the clips `position`.",
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "angle": {
+        "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.",
+        "anyOf": [
+          {
+            "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.",
+            "minimum": -360,
+            "maximum": 360
+          },
+          {
+            "type": "array",
+            "description": "An array of [Tween](./#tocs_tween) objects used to create a custom animation. Animate the rotation of an asset over time.",
+            "items": {
+              "$ref": "#/$defs/Tween"
+            }
+          },
+          {
+            "type": "null"
+          }
+        ]
+      }
+    },
+    "required": [
+      "angle"
+    ],
+    "$defs": {
+      "Tween": {
+        "description": "Use a Tween to [animate properties over time](/docs/guide/architecting-an-application/animations/). The following properties are currently supported and can be animated:\n  <ul>\n    <li>Opacity - animate the transparency of a clip.</li>\n    <li>Offset - animate the x and y position of a clip.</li>\n    <li>Rotation - animate the rotation of a clip.</li>\n    <li>Skew - animate the horizontal and vertical shearing effect.</li>\n    <li>Volume - animate the audio volume of a clip.</li>\n  </ul>",
+        "properties": {
+          "from": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The initial property value at the start of the animation."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "to": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The final property value at the end of the animation."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "start": {
+            "anyOf": [
+              {
+                "type": "number",
+                "description": "The time in seconds when the animation starts, relative to the clip, not the timeline."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "length": {
+            "anyOf": [
+              {
+                "type": "number",
+                "description": "The duration of the animation in seconds."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "interpolation": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The interpolation method to use for the animation. Available options are: <ul>\n  <li>`linear` - a linear interpolation between the start and end values.</li>\n  <li>`bezier` - a bezier curve interpolation between the start and end values.</li>\n  <li>`constant` - an interpolation where the property instantly jumps from the start to the end value, without any gradual transition.</li>\n</ul>",
+                "enum": [
+                  "linear",
+                  "bezier",
+                  "constant"
+                ]
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "easing": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The easing function to use for the animation. Easing controls the rate of change of the animated value, allowing for more natural motion by speeding up or slowing down the animation at different points. Only applicable if interpolation is set to `bezier`."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "additionalProperties": false,
+        "type": "object",
+        "required": [
+          "from",
+          "to",
+          "start",
+          "length",
+          "interpolation",
+          "easing"
+        ]
+      }
+    }
+  }
+}