@transloadit/zod 6.0.0 → 7.1.0

package/dist/v3/robots/video-subtitle.js

@@ -2,53 +2,44 @@ import { z } from 'zod/v3';
 import { zodInputPreservingTransform } from "../lib/zodInputSemantics.js";
 import { stackVersions } from "../stackVersions.js";
 import { color_with_alpha, color_without_alpha, defineRobot, positionSchema, robotBase, robotFFmpegVideo, robotUse, robotVideoEncodingMeta, } from "./_instructions-primitives.js";
+const subtitleColorSchema = z.union([color_without_alpha, color_with_alpha]);
+const subtitleColorDescription = `Use \`"rgb"\`, \`"rrggbb"\`, or \`"aarrggbb"\` format, optionally prefixed with \`#\`. Three-digit colors are expanded to six digits. Colors without alpha are fully opaque. For eight-digit colors, the first two digits specify transparency (\`"00"\` is fully opaque, \`"ff"\` is fully transparent).`;
+/** Appearance defaults for the social caption preset, before customer overrides. */
+export const videoSubtitleSocialStyle = {
+    // Static Poppins faces are included by API2's shared fontsConf google-fonts package.
+    font: 'Poppins',
+    // ASS includes the font's ascent and descent; Poppins capitals occupy about 40% of it.
+    font_size: 54,
+    bold: true,
+    outline_width: 2,
+};
 export const meta = {
     ...robotVideoEncodingMeta,
     example_code: {
         steps: {
-            add_english_subtitles: {
-                robot: '/video/subtitle',
-                use: {
-                    steps: [
-                        {
-                            name: ':original',
-                            fields: 'input_video',
-                            as: 'video',
-                        },
-                        {
-                            name: ':original',
-                            fields: 'input_srt_en',
-                            as: 'subtitles',
-                        },
-                    ],
-                },
-                language: 'eng',
-                name: 'English',
-                ffmpeg_stack: stackVersions.ffmpeg.recommendedVersion,
+            transcript: {
+                robot: '/speech/transcribe',
+                use: ':original',
+                provider: 'aws',
+                format: 'json',
+                source_language: 'en-US',
             },
-            add_german_subtitles: {
+            captioned: {
                 robot: '/video/subtitle',
                 use: {
                     steps: [
-                        {
-                            name: 'add_english_subtitles',
-                            as: 'video',
-                        },
-                        {
-                            name: ':original',
-                            fields: 'input_srt_de',
-                            as: 'subtitles',
-                        },
+                        { name: ':original', as: 'video' },
+                        { name: 'transcript', as: 'subtitles' },
                     ],
                 },
-                language: 'deu',
-                name: 'Deutsch',
-                keep_subtitles: true,
+                subtitles_type: 'burned',
+                preset: 'empty',
+                style: 'social',
                 ffmpeg_stack: stackVersions.ffmpeg.recommendedVersion,
             },
         },
     },
-    example_code_description: 'If you have file input fields in a form — one for a video and one for each subtitle language (named `input_video`, `input_srt_en`, and `input_srt_de` via the HTML `name` attribute) — here’s how to add multiple subtitle streams with language tags to the video. Chain multiple `/video/subtitle` Steps with `keep_subtitles` set to `true` so each new stream is added alongside existing ones:',
+    example_code_description: 'Transcribe an uploaded video into timestamped words, then burn in uppercase social captions with the spoken word highlighted. Captions normally contain up to three words, breaking at sentence endings and pauses longer than 0.4 seconds. Social phrasing can use one extra word to keep a short phrase together or avoid a sentence-final orphan:',
     purpose_sentence: 'adds subtitles and closed captions to videos',
     purpose_verb: 'subtitle',
     purpose_word: 'subtitle',
@@ -62,12 +53,33 @@ export const robotVideoSubtitleInstructionsSchema = robotBase
     .merge(robotFFmpegVideo)
     .extend({
     robot: z.literal('/video/subtitle').describe(`
-This <dfn>Robot</dfn> supports both SRT and VTT subtitle files.
+This <dfn>Robot</dfn> supports SRT, VTT, ASS, and the timestamped JSON output of \`/speech/transcribe\` with \`"format": "json"\`. Pass the video as \`"video"\` and the transcript as \`"subtitles"\` in the \`use\` parameter. JSON words are grouped into captions and converted to ASS for burned word highlighting, or plain SRT cues for external subtitle streams. External JSON cues preserve casing and punctuation. Provider segments do not control caption breaks. SRT and VTT timing is preserved.
+
+Without a \`preset\` or custom \`ffmpeg\` options, the legacy \`"flash"\` preset produces FLV output. With this default, burned subtitles use MP3 audio; external subtitles copy the input audio. Set \`"preset": "empty"\` to keep the input container, such as MP4 for an MP4 input.
 `),
     subtitles_type: zodInputPreservingTransform(z.enum(['burned', 'external', 'burn']), (val) => val === 'burn' ? 'burned' : val)
         .default('external')
         .describe(`
 Determines if subtitles are added as a separate stream to the video (value \`"external"\`) that then can be switched on and off in your video player, or if they should be burned directly into the video (value \`"burned"\` or \`"burn"\`) so that they become part of the video stream.
+`),
+    style: z
+        .enum(['social'])
+        .optional()
+        .describe(`
+Applies a ready-made appearance for burned subtitles: heavy Poppins text, a thick outline, and a soft black shadow. JSON captions render in uppercase in the lower third. By default, JSON font sizing uses the shorter side of the video and fits each caption within the safe width, preferring one line and using at most two. Words are never split. Each caption grows from 85% to full size over 120 milliseconds, then its words stay in place while the highlight changes color. The transcript file is preserved. Existing styling parameters override the preset; an explicit \`font_size\` disables automatic fitting. ASS files retain their own styles. With timestamped JSON from \`/speech/transcribe\`, the active word is highlighted until the next word or caption starts; other words use \`font_color\`. Trailing commas and periods are omitted from social JSON captions; question marks and exclamation marks are preserved. Word highlighting and grouping require JSON input.
+`),
+    highlight_color: subtitleColorSchema.default('FFD60A').describe(`
+The accent color of the active word in JSON subtitles. Only applies to burned JSON subtitles. With \`"style": "social"\`, the previous word stays highlighted through short gaps until the next word or caption starts. Without the social style, gaps use \`font_color\` for the entire caption.
+
+${subtitleColorDescription}
+`),
+    max_words_per_caption: z
+        .number()
+        .int()
+        .min(1)
+        .default(3)
+        .describe(`
+The target maximum number of timestamped JSON words shown in a caption. Captions break earlier at sentence-ending punctuation or pauses longer than 0.4 seconds. With \`"style": "social"\`, a trailing English function word such as “by,” “to,” or “the” moves to the next caption when possible. Short phrases such as “line of code” can stay together, and a sentence-final single word can join the previous caption. These adjustments allow at most one extra word per caption, without crossing sentence endings or long pauses. Single-word captions are preserved when the limit is 1. A caption stays visible until the next caption starts when the pause is at most 0.4 seconds, and disappears at its last word’s end during longer pauses. Does not change SRT, VTT, or ASS cues.
 `),
     border_style: z
         .enum(['box', 'outline', 'shadow'])
@@ -75,37 +87,39 @@ Determines if subtitles are added as a separate stream to the video (value \`"ex
         .describe(`
 Specifies the style of the subtitle. Use the \`border_color\` parameter to specify the color of the border.
 `),
-    border_color: color_with_alpha.default('40000000').describe(`
-The color for the subtitle border. The first two hex digits specify the alpha value of the color.
+    border_color: subtitleColorSchema.default('000000').describe(`
+The color for the subtitle border. The default is opaque black. Only applies to burned subtitles.
+
+${subtitleColorDescription}
 `),
+    // Preserve omitted appearance fields so parsing cannot override the selected style's defaults.
     // TODO: Make font an enum
     font: z
         .string()
-        .default('Arial')
+        .optional()
         .describe(`
-The font family to use. Also includes boldness and style of the font.
+The font family to use. Also includes boldness and style of the font. The default is Arial. With \`"style": "social"\`, the default is ${videoSubtitleSocialStyle.font}, using its ExtraBold weight for JSON captions. An explicit font overrides the style.
 
 [Here](/docs/supported-formats/fonts/) is a list of all supported fonts.
 `),
-    font_color: z
-        .union([color_without_alpha, color_with_alpha])
-        .default('FFFFFF')
-        .describe(`
-The color of the subtitle text in \`"rgb"\`, \`"rrggbb"\`, or \`"aarrggbb"\` format. If 8 hex digits are provided, the first two specify the alpha value of the color (\`"00"\` is fully opaque, \`"ff"\` is fully transparent).
+    font_color: subtitleColorSchema.default('FFFFFF').describe(`
+The color of the subtitle text. Only applies to burned subtitles.
+
+${subtitleColorDescription}
 `),
     font_size: z
         .number()
         .int()
         .min(1)
-        .default(16)
+        .optional()
         .describe(`
-Specifies the size of the text.
+Specifies the size of the text in the 288-pixel subtitle coordinate space, scaled with the video height. The default is 16. With \`"style": "social"\`, the default is ${videoSubtitleSocialStyle.font_size}. For social JSON captions, an omitted value scales this default with the shorter side of the video, increases it by 18% for portrait video, and shrinks captions as needed to fit at most two lines. Poppins capital letters are about 7.5% of the shorter side before fitting, or about 9% for portrait video. An explicit value keeps height-relative sizing and disables automatic fitting.
 `),
     bold: z
         .boolean()
-        .default(false)
+        .optional()
         .describe(`
-Specifies whether the subtitle text should be bold. Only applies to burned subtitles.
+Specifies whether the subtitle text should be bold. Only applies to burned subtitles. The default is \`false\`. With \`"style": "social"\`, the default is \`${videoSubtitleSocialStyle.bold}\`; an explicit \`false\` overrides the style.
 `),
     italic: z
         .boolean()
@@ -121,10 +135,10 @@ Specifies whether the subtitle text should be italic. Only applies to burned sub
         .optional()
         .nullable()
         .describe(`
-Specifies the width of the text outline in pixels. Only applies to burned subtitles with \`"outline"\` or \`"box"\` border styles. If not specified, the default width is used.
+Specifies the width of the text outline in the 288-pixel subtitle coordinate space, scaled with the video height. Numeric strings such as \`"4"\` are also accepted. Only applies to burned subtitles with \`"outline"\` or \`"box"\` border styles. If omitted or \`null\`, the default width is used (2 with \`"style": "social"\`, proportional to the final fitted font size for social JSON captions).
 `),
     position: positionSchema.default('bottom').describe(`
-Specifies the position of the subtitles.
+Specifies the position of the subtitles. With \`"style": "social"\`, the default bottom position places JSON captions in the lower third, with extra bottom clearance on portrait video. An explicit value overrides the style.
 `),
     language: z
         .string()

package/dist/v3/robots/video-thumbs.d.ts

@@ -434,10 +434,10 @@ export declare const robotVideoThumbsInstructionsSchema: z.ZodObject<{
 } & {
     robot: z.ZodLiteral<"/video/thumbs">;
     count: z.ZodDefault<z.ZodNumber>;
-    offsets: z.ZodDefault<z.ZodUnion<[z.ZodArray<z.ZodNumber, "many">, z.ZodArray<z.ZodString, "many">]>>;
+    offsets: z.ZodDefault<z.ZodNullable<z.ZodUnion<[z.ZodArray<z.ZodNumber, "many">, z.ZodArray<z.ZodString, "many">]>>>;
     format: z.ZodDefault<z.ZodEnum<["jpeg", "jpg", "png"]>>;
-    width: z.ZodOptional<z.ZodNumber>;
-    height: z.ZodOptional<z.ZodNumber>;
+    width: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    height: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     resize_strategy: z.ZodDefault<z.ZodEnum<["crop", "fit", "fillcrop", "min_fit", "pad", "stretch"]>>;
     background: z.ZodDefault<z.ZodString>;
     rotate: z.ZodDefault<z.ZodUnion<[z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>, z.ZodLiteral<360>]>>;
@@ -458,7 +458,7 @@ export declare const robotVideoThumbsInstructionsSchema: z.ZodObject<{
     count: number;
     smart: boolean;
     smart_max_candidates: number;
-    offsets: string[] | number[];
+    offsets: string[] | number[] | null;
     ffmpeg?: z.objectOutputType<{
         af: z.ZodOptional<z.ZodString>;
         'b:a': z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
@@ -597,8 +597,8 @@ export declare const robotVideoThumbsInstructionsSchema: z.ZodObject<{
     interpolate?: boolean | Record<string, boolean> | undefined;
     output_meta?: boolean | string[] | Record<string, boolean> | undefined;
     queue?: "batch" | undefined;
-    width?: number | undefined;
-    height?: number | undefined;
+    width?: number | null | undefined;
+    height?: number | null | undefined;
     input_codec?: string | undefined;
 }, {
     robot: "/video/thumbs";
@@ -745,8 +745,8 @@ export declare const robotVideoThumbsInstructionsSchema: z.ZodObject<{
     force_accept?: boolean | undefined;
     ignore_errors?: boolean | ("meta" | "execute")[] | undefined;
     ffmpeg_stack?: string | undefined;
-    width?: number | undefined;
-    height?: number | undefined;
+    width?: number | null | undefined;
+    height?: number | null | undefined;
     resize_strategy?: "crop" | "fit" | "fillcrop" | "min_fit" | "pad" | "stretch" | undefined;
     background?: string | undefined;
     rotate?: 0 | 90 | 180 | 270 | 360 | undefined;
@@ -754,7 +754,7 @@ export declare const robotVideoThumbsInstructionsSchema: z.ZodObject<{
     count?: number | undefined;
     smart?: boolean | undefined;
     smart_max_candidates?: number | undefined;
-    offsets?: string[] | number[] | undefined;
+    offsets?: string[] | number[] | null | undefined;
     input_codec?: string | undefined;
 }>;
 export declare const robotDefinition: RobotDefinition<typeof robotVideoThumbsInstructionsSchema.shape>;
@@ -1177,10 +1177,10 @@ export declare const robotVideoThumbsInstructionsWithHiddenFieldsSchema: z.ZodOb
     ffmpeg_stack: z.ZodDefault<z.ZodUnion<[z.ZodEnum<["v6", "v7", "v8"]>, z.ZodString]>>;
     robot: z.ZodLiteral<"/video/thumbs">;
     count: z.ZodDefault<z.ZodNumber>;
-    offsets: z.ZodDefault<z.ZodUnion<[z.ZodArray<z.ZodNumber, "many">, z.ZodArray<z.ZodString, "many">]>>;
+    offsets: z.ZodDefault<z.ZodNullable<z.ZodUnion<[z.ZodArray<z.ZodNumber, "many">, z.ZodArray<z.ZodString, "many">]>>>;
     format: z.ZodDefault<z.ZodEnum<["jpeg", "jpg", "png"]>>;
-    width: z.ZodOptional<z.ZodNumber>;
-    height: z.ZodOptional<z.ZodNumber>;
+    width: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    height: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     resize_strategy: z.ZodDefault<z.ZodEnum<["crop", "fit", "fillcrop", "min_fit", "pad", "stretch"]>>;
     background: z.ZodDefault<z.ZodString>;
     rotate: z.ZodDefault<z.ZodUnion<[z.ZodLiteral<0>, z.ZodLiteral<90>, z.ZodLiteral<180>, z.ZodLiteral<270>, z.ZodLiteral<360>]>>;
@@ -1202,7 +1202,7 @@ export declare const robotVideoThumbsInstructionsWithHiddenFieldsSchema: z.ZodOb
     count: number;
     smart: boolean;
     smart_max_candidates: number;
-    offsets: string[] | number[];
+    offsets: string[] | number[] | null;
     result?: boolean | "debug" | undefined;
     ffmpeg?: z.objectOutputType<{
         af: z.ZodOptional<z.ZodString>;
@@ -1342,8 +1342,8 @@ export declare const robotVideoThumbsInstructionsWithHiddenFieldsSchema: z.ZodOb
     interpolate?: boolean | Record<string, boolean> | undefined;
     output_meta?: boolean | string[] | Record<string, boolean> | undefined;
     queue?: "batch" | undefined;
-    width?: number | undefined;
-    height?: number | undefined;
+    width?: number | null | undefined;
+    height?: number | null | undefined;
     input_codec?: string | undefined;
 }, {
     robot: "/video/thumbs";
@@ -1490,8 +1490,8 @@ export declare const robotVideoThumbsInstructionsWithHiddenFieldsSchema: z.ZodOb
     force_accept?: boolean | undefined;
     ignore_errors?: boolean | ("meta" | "execute")[] | undefined;
     ffmpeg_stack?: string | undefined;
-    width?: number | undefined;
-    height?: number | undefined;
+    width?: number | null | undefined;
+    height?: number | null | undefined;
     resize_strategy?: "crop" | "fit" | "fillcrop" | "min_fit" | "pad" | "stretch" | undefined;
     background?: string | undefined;
     rotate?: 0 | 90 | 180 | 270 | 360 | undefined;
@@ -1499,7 +1499,7 @@ export declare const robotVideoThumbsInstructionsWithHiddenFieldsSchema: z.ZodOb
     count?: number | undefined;
     smart?: boolean | undefined;
     smart_max_candidates?: number | undefined;
-    offsets?: string[] | number[] | undefined;
+    offsets?: string[] | number[] | null | undefined;
     input_codec?: string | undefined;
 }>, interpolatableRobotVideoThumbsInstructionsSchema: z.ZodObject<{
     interpolate: z.ZodOptional<z.ZodUnion<[z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">, z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>]>>;
@@ -1921,10 +1921,10 @@ export declare const robotVideoThumbsInstructionsWithHiddenFieldsSchema: z.ZodOb
     ffmpeg_stack: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodUnion<[z.ZodString, z.ZodEnum<["v6", "v7", "v8"]>]>, z.ZodString]>>;
     robot: z.ZodLiteral<"/video/thumbs">;
     count: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
-    offsets: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">]>, z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>]>>;
+    offsets: z.ZodDefault<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">]>, z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>]>>>;
     format: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodEnum<["jpeg", "jpg", "png"]>]>>;
-    width: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
-    height: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    width: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+    height: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
     resize_strategy: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodEnum<["crop", "fit", "fillcrop", "min_fit", "pad", "stretch"]>]>>;
     background: z.ZodDefault<z.ZodString>;
     rotate: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodUnion<[z.ZodString, z.ZodLiteral<0>]>, z.ZodUnion<[z.ZodString, z.ZodLiteral<90>]>, z.ZodUnion<[z.ZodString, z.ZodLiteral<180>]>, z.ZodUnion<[z.ZodString, z.ZodLiteral<270>]>, z.ZodUnion<[z.ZodString, z.ZodLiteral<360>]>]>>;
@@ -1945,7 +1945,7 @@ export declare const robotVideoThumbsInstructionsWithHiddenFieldsSchema: z.ZodOb
     count: string | number;
     smart: string | boolean;
     smart_max_candidates: string | number;
-    offsets: string | (string | number)[] | string[];
+    offsets: string | (string | number)[] | string[] | null;
     ffmpeg?: string | z.objectOutputType<{
         af: z.ZodOptional<z.ZodString>;
         'b:a': z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber]>]>>;
@@ -2084,8 +2084,8 @@ export declare const robotVideoThumbsInstructionsWithHiddenFieldsSchema: z.ZodOb
     interpolate?: boolean | Record<string, boolean> | undefined;
     output_meta?: string | boolean | string[] | Record<string, string | boolean> | undefined;
     queue?: string | undefined;
-    width?: string | number | undefined;
-    height?: string | number | undefined;
+    width?: string | number | null | undefined;
+    height?: string | number | null | undefined;
     input_codec?: string | undefined;
 }, {
     robot: "/video/thumbs";
@@ -2232,8 +2232,8 @@ export declare const robotVideoThumbsInstructionsWithHiddenFieldsSchema: z.ZodOb
     force_accept?: string | boolean | undefined;
     ignore_errors?: string | boolean | ("meta" | "execute")[] | undefined;
     ffmpeg_stack?: string | undefined;
-    width?: string | number | undefined;
-    height?: string | number | undefined;
+    width?: string | number | null | undefined;
+    height?: string | number | null | undefined;
     resize_strategy?: string | undefined;
     background?: string | undefined;
     rotate?: string | 0 | 90 | 180 | 270 | 360 | undefined;
@@ -2241,7 +2241,7 @@ export declare const robotVideoThumbsInstructionsWithHiddenFieldsSchema: z.ZodOb
     count?: string | number | undefined;
     smart?: string | boolean | undefined;
     smart_max_candidates?: string | number | undefined;
-    offsets?: string | (string | number)[] | string[] | undefined;
+    offsets?: string | (string | number)[] | string[] | null | undefined;
     input_codec?: string | undefined;
 }>, interpolatableRobotVideoThumbsInstructionsWithHiddenFieldsSchema: z.ZodObject<{
     interpolate: z.ZodOptional<z.ZodUnion<[z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">, z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodUnion<[z.ZodBoolean, z.ZodEnum<["true", "false"]>]>, boolean, boolean | "true" | "false">>]>>;
@@ -2662,10 +2662,10 @@ export declare const robotVideoThumbsInstructionsWithHiddenFieldsSchema: z.ZodOb
     ffmpeg_stack: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodUnion<[z.ZodString, z.ZodEnum<["v6", "v7", "v8"]>]>, z.ZodString]>>;
     robot: z.ZodLiteral<"/video/thumbs">;
     count: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
-    offsets: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">]>, z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>]>>;
+    offsets: z.ZodDefault<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber]>, "many">]>, z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>]>>>;
     format: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodEnum<["jpeg", "jpg", "png"]>]>>;
-    width: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
-    height: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+    width: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
+    height: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodNumber]>>>;
     resize_strategy: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodEnum<["crop", "fit", "fillcrop", "min_fit", "pad", "stretch"]>]>>;
     background: z.ZodDefault<z.ZodString>;
     rotate: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodUnion<[z.ZodString, z.ZodLiteral<0>]>, z.ZodUnion<[z.ZodString, z.ZodLiteral<90>]>, z.ZodUnion<[z.ZodString, z.ZodLiteral<180>]>, z.ZodUnion<[z.ZodString, z.ZodLiteral<270>]>, z.ZodUnion<[z.ZodString, z.ZodLiteral<360>]>]>>;
@@ -2686,7 +2686,7 @@ export declare const robotVideoThumbsInstructionsWithHiddenFieldsSchema: z.ZodOb
     count: string | number;
     smart: string | boolean;
     smart_max_candidates: string | number;
-    offsets: string | (string | number)[] | string[];
+    offsets: string | (string | number)[] | string[] | null;
     result?: string | boolean | undefined;
     ffmpeg?: string | z.objectOutputType<{
         af: z.ZodOptional<z.ZodString>;
@@ -2826,8 +2826,8 @@ export declare const robotVideoThumbsInstructionsWithHiddenFieldsSchema: z.ZodOb
     interpolate?: boolean | Record<string, boolean> | undefined;
     output_meta?: string | boolean | string[] | Record<string, string | boolean> | undefined;
     queue?: string | undefined;
-    width?: string | number | undefined;
-    height?: string | number | undefined;
+    width?: string | number | null | undefined;
+    height?: string | number | null | undefined;
     input_codec?: string | undefined;
 }, {
     robot: "/video/thumbs";
@@ -2974,8 +2974,8 @@ export declare const robotVideoThumbsInstructionsWithHiddenFieldsSchema: z.ZodOb
     force_accept?: string | boolean | undefined;
     ignore_errors?: string | boolean | ("meta" | "execute")[] | undefined;
     ffmpeg_stack?: string | undefined;
-    width?: string | number | undefined;
-    height?: string | number | undefined;
+    width?: string | number | null | undefined;
+    height?: string | number | null | undefined;
     resize_strategy?: string | undefined;
     background?: string | undefined;
     rotate?: string | 0 | 90 | 180 | 270 | 360 | undefined;
@@ -2983,7 +2983,7 @@ export declare const robotVideoThumbsInstructionsWithHiddenFieldsSchema: z.ZodOb
     count?: string | number | undefined;
     smart?: string | boolean | undefined;
     smart_max_candidates?: string | number | undefined;
-    offsets?: string | (string | number)[] | string[] | undefined;
+    offsets?: string | (string | number)[] | string[] | null | undefined;
     input_codec?: string | undefined;
 }>;
 type Instructions = RobotSchemaVariantTypes<typeof robotDefinition>;

package/dist/v3/robots/video-thumbs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"video-thumbs.d.ts","sourceRoot":"","sources":["../../../src/v3/robots/video-thumbs.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"video-thumbs.d.ts","sourceRoot":"","sources":["../../../src/v3/robots/video-thumbs.ts"],"names":[],"mappings":"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"}

package/dist/v3/robots/video-thumbs.js

@@ -67,7 +67,8 @@ The thumbnails are taken at regular intervals, determined by dividing the video
 To extract thumbnails for specific timestamps, use the \`offsets\` parameter.
 `),
     offsets: z
-        .union([z.array(z.number()), z.array(percentageSchema)])
+        .union([z.array(z.number().finite()), z.array(percentageSchema)])
+        .nullable()
         .default([])
         .describe(`
 An array of offsets representing seconds of the file duration, such as \`[ 2, 45, 120 ]\`. Millisecond durations of a file can also be used by using decimal place values. For example, an offset from 1250 milliseconds would be represented with \`1.25\`. Offsets can also be percentage values such as \`[ "2%", "50%", "75%" ]\`.
@@ -75,6 +76,8 @@ An array of offsets representing seconds of the file duration, such as \`[ 2, 45
 This option cannot be used with the \`count\` parameter, and takes precedence if both are specified. Out-of-range offsets are silently ignored.
 
 When \`smart\` is \`true\`, smart selection ignores \`offsets\` and uses \`count\` to select from its own candidate timestamps. If no smart candidates can be extracted, the Robot falls back to standard extraction, where \`offsets\` takes precedence. Use \`smart: false\` to consistently extract the specified timestamps.
+
+Use \`null\` to leave timestamp selection to \`count\` and \`smart\`.
 `),
     format: z
         .enum(['jpeg', 'jpg', 'png'])
@@ -87,18 +90,20 @@ The format of the extracted thumbnail. Supported values are \`"jpg"\`, \`"jpeg"\
         .int()
         .min(1)
         .max(1920)
+        .nullable()
         .optional()
         .describe(`
-The width of the thumbnail, in pixels. Defaults to the original width of the video.
+The width of the thumbnail, in pixels. Omit or use \`null\` for the original width of the video.
 `),
     height: z
         .number()
         .int()
         .min(1)
         .max(1080)
+        .nullable()
         .optional()
         .describe(`
-The height of the thumbnail, in pixels. Defaults to the original height of the video.
+The height of the thumbnail, in pixels. Omit or use \`null\` for the original height of the video.
 `),
     resize_strategy: resize_strategy.describe(`
 One of the [available resize strategies](/docs/topics/resize-strategies/).

package/dist/v3/robots/vimeo-import.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vimeo-import.d.ts","sourceRoot":"","sources":["../../../src/v3/robots/vimeo-import.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAEpF,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAW1B,eAAO,MAAM,IAAI,EAAE,cAwBlB,CAAA;AAED,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmCpC,CAAA;AAEX,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAA;AAC7F,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAA;AAElG,eAAO,MAAM,gDAAgD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE5D,CAAA;AACD,MAAM,MAAM,0CAA0C,GACpD,+CAA+C,CAAA;AAEjD,MAAM,MAAM,+CAA+C,GAAG,CAAC,CAAC,KAAK,CACnE,OAAO,gDAAgD,CACxD,CAAA;AAED,eAAO,MAAM,kDAAkD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAY3D,CAAA;AAEJ,eAAO,MAAM,gEAAgE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE5E,CAAA;AACD,MAAM,MAAM,0DAA0D,GAAG,CAAC,CAAC,KAAK,CAC9E,OAAO,gEAAgE,CACxE,CAAA;AACD,MAAM,MAAM,+DAA+D,GAAG,CAAC,CAAC,KAAK,CACnF,OAAO,gEAAgE,CACxE,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,eAAe,CAC3C,OAAO,gDAAgD,EACvD,OAAO,gEAAgE,CAKxE,CAAA"}
+{"version":3,"file":"vimeo-import.d.ts","sourceRoot":"","sources":["../../../src/v3/robots/vimeo-import.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAEpF,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAW1B,eAAO,MAAM,IAAI,EAAE,cAwBlB,CAAA;AAED,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqCpC,CAAA;AAEX,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAA;AAC7F,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAA;AAElG,eAAO,MAAM,gDAAgD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE5D,CAAA;AACD,MAAM,MAAM,0CAA0C,GACpD,+CAA+C,CAAA;AAEjD,MAAM,MAAM,+CAA+C,GAAG,CAAC,CAAC,KAAK,CACnE,OAAO,gDAAgD,CACxD,CAAA;AAED,eAAO,MAAM,kDAAkD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAY3D,CAAA;AAEJ,eAAO,MAAM,gEAAgE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE5E,CAAA;AACD,MAAM,MAAM,0DAA0D,GAAG,CAAC,CAAC,KAAK,CAC9E,OAAO,gEAAgE,CACxE,CAAA;AACD,MAAM,MAAM,+DAA+D,GAAG,CAAC,CAAC,KAAK,CACnF,OAAO,gEAAgE,CACxE,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,eAAe,CAC3C,OAAO,gDAAgD,EACvD,OAAO,gEAAgE,CAKxE,CAAA"}

package/dist/v3/robots/vimeo-import.js

@@ -58,7 +58,7 @@ You can also use an array of path strings here to import multiple paths in the s
     rendition: z
         .enum(['240p', '360p', '540p', '720p', '1080p', 'source'])
         .default('720p')
-        .describe('The quality of the video to import.'),
+        .describe('The quality of the video to import. Use `source` for the original upload. Source availability depends on video permissions, your Vimeo account, the access token’s `video_files` scope, and whether Vimeo has retained the source file. The import fails with an error if the source file is unavailable.'),
 })
     .strict();
 export const interpolatableRobotVimeoImportInstructionsSchema = interpolateRobot(robotVimeoImportInstructionsSchema);