@shotstack/schemas 1.6.0 → 1.7.1

package/dist/json-schema/caption-asset.json

@@ -0,0 +1,285 @@
+{
+  "name": "CaptionAsset",
+  "strict": true,
+  "schema": {
+    "description": "The CaptionAsset is used to add captions (subtitles) to a video. It uses a supplied SRT or VTT file which will\nbe read and burnt to the video.\n\nCaptions can be applied independently from a video or audio file for greater\nflexibility with styling and layout. For example you can scale, position or crop a video without modifying the\ncaptions.\n\nTo sync captions with a video or audio file use a [Video](#tocs_videoasset\") or [Audio](#tocs_audioasset\") with\nmatching start and end time.\n",
+    "type": "object",
+    "properties": {
+      "type": {
+        "enum": [
+          "caption"
+        ],
+        "description": "The type of asset - set to `caption` for captions.",
+        "type": "string"
+      },
+      "src": {
+        "description": "The URL to an SRT or VTT subtitles file, or an alias reference to auto-generate captions from an audio or video clip. For file URLs, the URL must be publicly accessible or include credentials. For auto-captioning, use the format `alias://clip-name` where clip-name is the alias of an audio, video, or text-to-speech clip. The system will automatically transcribe the audio and detect the language.",
+        "type": "string"
+      },
+      "font": {
+        "anyOf": [
+          {
+            "description": "Font styling properties.",
+            "$ref": "#/$defs/CaptionFont"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "background": {
+        "anyOf": [
+          {
+            "description": "Background styling properties.",
+            "$ref": "#/$defs/CaptionBackground"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "margin": {
+        "anyOf": [
+          {
+            "description": "Margin properties.",
+            "$ref": "#/$defs/CaptionMargin"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "trim": {
+        "anyOf": [
+          {
+            "type": "number",
+            "description": "The start trim point of the captions, in seconds (defaults to 0). Remove the trim length from the start of the captions and allow it to be synced with video or audio. The captions will play until the file ends or the Clip length is reached."
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "speed": {
+        "anyOf": [
+          {
+            "type": "number",
+            "description": "Adjust the playback speed of the captions between 0 (paused) and 10 (10x normal speed) where 1 is normal speed (defaults to 1). Adjusting the speed will also adjust the duration of the clip and may require you to  adjust the Clip length. For example, if you set speed to 0.5, the clip will need to be 2x as long to play the entire captions (i.e. original length / 0.5). If you set speed to 2, the clip will need to be half as long to play the entire captions (i.e. original length / 2).",
+            "minimum": 0,
+            "maximum": 10
+          },
+          {
+            "type": "null"
+          }
+        ]
+      }
+    },
+    "additionalProperties": false,
+    "required": [
+      "type",
+      "src",
+      "font",
+      "background",
+      "margin",
+      "trim",
+      "speed"
+    ],
+    "$defs": {
+      "CaptionFont": {
+        "description": "Font properties for captions text.",
+        "properties": {
+          "family": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The font family name. This must be Family name embedded in the font, i.e. \"Open Sans\"."
+              },
+              {
+                "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."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "size": {
+            "anyOf": [
+              {
+                "type": "integer",
+                "description": "The size of the font in pixels (px)."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "lineHeight": {
+            "anyOf": [
+              {
+                "type": "number",
+                "description": "The line height of the font as a ratio of the font size."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "stroke": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "The stroke color of the font using hexadecimal color notation."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "strokeWidth": {
+            "anyOf": [
+              {
+                "type": "number",
+                "description": "The width of the stroke in pixels."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "additionalProperties": false,
+        "type": "object",
+        "required": [
+          "family",
+          "color",
+          "opacity",
+          "size",
+          "lineHeight",
+          "stroke",
+          "strokeWidth"
+        ]
+      },
+      "CaptionBackground": {
+        "description": "Displays a background box behind the caption text.",
+        "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 color."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "padding": {
+            "anyOf": [
+              {
+                "type": "integer",
+                "description": "The padding inside the background box in pixels."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "borderRadius": {
+            "anyOf": [
+              {
+                "type": "integer",
+                "description": "The border radius of the background box in pixels."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "additionalProperties": false,
+        "type": "object",
+        "required": [
+          "color",
+          "opacity",
+          "padding",
+          "borderRadius"
+        ]
+      },
+      "CaptionMargin": {
+        "description": "The margin properties for captions. Margins are used to position the caption text and background on the screen.",
+        "properties": {
+          "top": {
+            "anyOf": [
+              {
+                "type": "number",
+                "description": "The margin above the text. Pushes captions down the screen."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "left": {
+            "anyOf": [
+              {
+                "type": "number",
+                "description": "The margin to the left of the text. Pushes captions to the right."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "right": {
+            "anyOf": [
+              {
+                "type": "number",
+                "description": "The margin to the right of the text. Pushes captions to the left."
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "additionalProperties": false,
+        "type": "object",
+        "required": [
+          "top",
+          "left",
+          "right"
+        ]
+      }
+    }
+  }
+}

package/dist/json-schema/caption-background.json

@@ -0,0 +1,61 @@
+{
+  "name": "CaptionBackground",
+  "strict": true,
+  "schema": {
+    "description": "Displays a background box behind the caption text.",
+    "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 color."
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "padding": {
+        "anyOf": [
+          {
+            "type": "integer",
+            "description": "The padding inside the background box in pixels."
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "borderRadius": {
+        "anyOf": [
+          {
+            "type": "integer",
+            "description": "The border radius of the background box in pixels."
+          },
+          {
+            "type": "null"
+          }
+        ]
+      }
+    },
+    "additionalProperties": false,
+    "type": "object",
+    "required": [
+      "color",
+      "opacity",
+      "padding",
+      "borderRadius"
+    ]
+  }
+}

package/dist/json-schema/caption-detailer.json

@@ -0,0 +1,275 @@
+{
+  "name": "CaptionDetails",
+  "strict": true,
+  "schema": {
+    "type": "object",
+    "properties": {
+      "assets": {
+        "type": "array",
+        "items": {
+          "$ref": "#/$defs/CaptionAsset"
+        }
+      }
+    },
+    "additionalProperties": false,
+    "required": [
+      "assets"
+    ],
+    "$defs": {
+      "CaptionAsset": {
+        "type": "object",
+        "properties": {
+          "type": {
+            "enum": [
+              "caption"
+            ],
+            "type": "string"
+          },
+          "src": {
+            "type": "string"
+          },
+          "font": {
+            "anyOf": [
+              {
+                "$ref": "#/$defs/CaptionFont"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "background": {
+            "anyOf": [
+              {
+                "$ref": "#/$defs/CaptionBackground"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "margin": {
+            "anyOf": [
+              {
+                "$ref": "#/$defs/CaptionMargin"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "trim": {
+            "anyOf": [
+              {
+                "type": "number"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "speed": {
+            "anyOf": [
+              {
+                "type": "number",
+                "minimum": 0,
+                "maximum": 10
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "type",
+          "src",
+          "font",
+          "background",
+          "margin",
+          "trim",
+          "speed"
+        ]
+      },
+      "CaptionFont": {
+        "properties": {
+          "family": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "color": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "opacity": {
+            "anyOf": [
+              {
+                "type": "number"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "size": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "lineHeight": {
+            "anyOf": [
+              {
+                "type": "number"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "stroke": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "strokeWidth": {
+            "anyOf": [
+              {
+                "type": "number"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "additionalProperties": false,
+        "type": "object",
+        "required": [
+          "family",
+          "color",
+          "opacity",
+          "size",
+          "lineHeight",
+          "stroke",
+          "strokeWidth"
+        ]
+      },
+      "CaptionBackground": {
+        "properties": {
+          "color": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "opacity": {
+            "anyOf": [
+              {
+                "type": "number"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "padding": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "borderRadius": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "additionalProperties": false,
+        "type": "object",
+        "required": [
+          "color",
+          "opacity",
+          "padding",
+          "borderRadius"
+        ]
+      },
+      "CaptionMargin": {
+        "properties": {
+          "top": {
+            "anyOf": [
+              {
+                "type": "number"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "left": {
+            "anyOf": [
+              {
+                "type": "number"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "right": {
+            "anyOf": [
+              {
+                "type": "number"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "additionalProperties": false,
+        "type": "object",
+        "required": [
+          "top",
+          "left",
+          "right"
+        ]
+      }
+    }
+  }
+}

package/dist/json-schema/caption-font.json

@@ -0,0 +1,97 @@
+{
+  "name": "CaptionFont",
+  "strict": true,
+  "schema": {
+    "description": "Font properties for captions text.",
+    "properties": {
+      "family": {
+        "anyOf": [
+          {
+            "type": "string",
+            "description": "The font family name. This must be Family name embedded in the font, i.e. \"Open Sans\"."
+          },
+          {
+            "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."
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "size": {
+        "anyOf": [
+          {
+            "type": "integer",
+            "description": "The size of the font in pixels (px)."
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "lineHeight": {
+        "anyOf": [
+          {
+            "type": "number",
+            "description": "The line height of the font as a ratio of the font size."
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "stroke": {
+        "anyOf": [
+          {
+            "type": "string",
+            "description": "The stroke color of the font using hexadecimal color notation."
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "strokeWidth": {
+        "anyOf": [
+          {
+            "type": "number",
+            "description": "The width of the stroke in pixels."
+          },
+          {
+            "type": "null"
+          }
+        ]
+      }
+    },
+    "additionalProperties": false,
+    "type": "object",
+    "required": [
+      "family",
+      "color",
+      "opacity",
+      "size",
+      "lineHeight",
+      "stroke",
+      "strokeWidth"
+    ]
+  }
+}