transloadit 4.13.1 → 5.0.0

package/src/alphalib/types/robots/wasabi-import.ts

@@ -1,57 +1,37 @@
-import type { RobotMetaInput } from './_instructions-primitives.ts'
+import type {
+  RobotDefinition,
+  RobotMetaInput,
+  RobotSchemaVariantTypes,
+} from './_instructions-primitives.ts'
 
 import { z } from 'zod'
 
 import {
-  files_per_page,
-  interpolateRobot,
-  page_number,
-  path,
+  bucketImportPath,
+  createStorageImportExample,
+  defineRobot,
   recursive,
+  recursiveImportPageNumber,
+  recursiveImportPageSize,
   return_file_stubs,
   robotBase,
   robotImport,
+  robotImportMeta,
   wasabiBase,
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  bytescount: 10,
-  discount_factor: 0.1,
-  discount_pct: 90,
-  example_code: {
-    steps: {
-      imported: {
-        robot: '/wasabi/import',
-        credentials: 'YOUR_WASABI_CREDENTIALS',
-        path: 'path/to/files/',
-        recursive: true,
-      },
-    },
-  },
+  ...robotImportMeta,
+  example_code: createStorageImportExample('/wasabi/import', 'YOUR_WASABI_CREDENTIALS'),
   example_code_description:
     'Import files from the `path/to/files` directory and its subdirectories:',
   has_small_icon: true,
-  minimum_charge: 0,
-  output_factor: 1,
-  override_lvl1: 'File Importing',
-  purpose_sentence: 'imports whole directories of files from your wasabi bucket',
-  purpose_verb: 'import',
+  purpose_sentence: 'imports whole directories of files from your Wasabi bucket',
   purpose_word: 'Wasabi',
   purpose_words: 'Import files from Wasabi',
   requires_credentials: true,
-  service_slug: 'file-importing',
-  slot_count: 20,
   title: 'Import files from Wasabi',
-  typical_file_size_mb: 1.2,
-  typical_file_type: 'file',
   name: 'WasabiImportRobot',
-  priceFactor: 6.6666,
-  queueSlotCount: 20,
-  isAllowedForUrlTransform: true,
-  trackOutputFileSize: false,
-  isInternal: false,
-  removeJobResultFilesFromDiskRightAfterStoringOnS3: true,
-  stage: 'ga',
 }
 
 export const robotWasabiImportInstructionsSchema = robotBase
@@ -63,62 +43,34 @@ export const robotWasabiImportInstructionsSchema = robotBase
       .optional()
       .describe('Whether the results of this Step should be present in the Assembly Status JSON'),
     robot: z.literal('/wasabi/import'),
-    path: path.describe(`
-The path in your bucket to the specific file or directory. If the path points to a file, only this file will be imported. For example: \`images/avatar.jpg\`.
-
-If it points to a directory, indicated by a trailing slash (\`/\`), then all files that are direct descendants of this directory will be imported. For example: \`images/\`.
-
-Directories are **not** imported recursively. If you want to import files from subdirectories and sub-subdirectories, enable the \`recursive\` parameter.
-
-If you want to import all files from the root directory, please use \`/\` as the value here. In this case, make sure all your objects belong to a path. If you have objects in the root of your bucket that aren't prefixed with \`/\`, you'll receive an error: \`A client error (NoSuchKey) occurred when calling the GetObject operation: The specified key does not exist.\`
-
-You can also use an array of path strings here to import multiple paths in the same <dfn>Robot</dfn>'s <dfn>Step</dfn>.
-`),
+    path: bucketImportPath,
     recursive: recursive.describe(`
 Setting this to \`true\` will enable importing files from subfolders and sub-subfolders, etc. of the given path.
 
 Please use the pagination parameters \`page_number\` and \`files_per_page\` wisely here.
 `),
-    page_number: page_number.describe(`
-The pagination page number. For now, in order to not break backwards compatibility in non-recursive imports, this only works when recursive is set to \`true\`.
-
-When doing big imports, make sure no files are added or removed from other scripts within your path, otherwise you might get weird results with the pagination.
-`),
-    files_per_page: files_per_page.describe(`
-The pagination page size. This only works when recursive is \`true\` for now, in order to not break backwards compatibility in non-recursive imports.
-`),
+    page_number: recursiveImportPageNumber,
+    files_per_page: recursiveImportPageSize,
     return_file_stubs,
   })
   .strict()
 
-export const robotWasabiImportInstructionsWithHiddenFieldsSchema =
-  robotWasabiImportInstructionsSchema.extend({
-    result: z
-      .union([z.literal('debug'), robotWasabiImportInstructionsSchema.shape.result])
-      .optional(),
-  })
-
-export type RobotWasabiImportInstructions = z.infer<typeof robotWasabiImportInstructionsSchema>
-export type RobotWasabiImportInstructionsWithHiddenFields = z.infer<
-  typeof robotWasabiImportInstructionsWithHiddenFieldsSchema
->
+export const robotDefinition: RobotDefinition<typeof robotWasabiImportInstructionsSchema.shape> =
+  defineRobot(meta, robotWasabiImportInstructionsSchema)
 
-export const interpolatableRobotWasabiImportInstructionsSchema = interpolateRobot(
-  robotWasabiImportInstructionsSchema,
-)
-export type InterpolatableRobotWasabiImportInstructions =
-  InterpolatableRobotWasabiImportInstructionsInput
+export const {
+  withHiddenFields: robotWasabiImportInstructionsWithHiddenFieldsSchema,
+  interpolatable: interpolatableRobotWasabiImportInstructionsSchema,
+  interpolatableWithHiddenFields: interpolatableRobotWasabiImportInstructionsWithHiddenFieldsSchema,
+} = robotDefinition
 
-export type InterpolatableRobotWasabiImportInstructionsInput = z.input<
-  typeof interpolatableRobotWasabiImportInstructionsSchema
->
+type Instructions = RobotSchemaVariantTypes<typeof robotDefinition>
 
-export const interpolatableRobotWasabiImportInstructionsWithHiddenFieldsSchema = interpolateRobot(
-  robotWasabiImportInstructionsWithHiddenFieldsSchema,
-)
-export type InterpolatableRobotWasabiImportInstructionsWithHiddenFields = z.infer<
-  typeof interpolatableRobotWasabiImportInstructionsWithHiddenFieldsSchema
->
-export type InterpolatableRobotWasabiImportInstructionsWithHiddenFieldsInput = z.input<
-  typeof interpolatableRobotWasabiImportInstructionsWithHiddenFieldsSchema
->
+export type RobotWasabiImportInstructions = Instructions['output']
+export type RobotWasabiImportInstructionsWithHiddenFields = Instructions['hiddenOutput']
+export type InterpolatableRobotWasabiImportInstructions = Instructions['interpolatableInput']
+export type InterpolatableRobotWasabiImportInstructionsInput = Instructions['interpolatableInput']
+export type InterpolatableRobotWasabiImportInstructionsWithHiddenFields =
+  Instructions['interpolatableHiddenOutput']
+export type InterpolatableRobotWasabiImportInstructionsWithHiddenFieldsInput =
+  Instructions['interpolatableHiddenInput']

package/src/alphalib/types/robots/wasabi-store.ts

@@ -1,45 +1,32 @@
-import type { RobotMetaInput } from './_instructions-primitives.ts'
+import type {
+  RobotDefinition,
+  RobotMetaInput,
+  RobotSchemaVariantTypes,
+} from './_instructions-primitives.ts'
 
 import { z } from 'zod'
 
-import { interpolateRobot, robotBase, robotUse, wasabiBase } from './_instructions-primitives.ts'
+import {
+  createStorageStoreExample,
+  defineRobot,
+  robotBase,
+  robotStoreMeta,
+  robotUse,
+  signedSslUrlLifetime,
+  storeFilePath,
+  wasabiBase,
+} from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  bytescount: 6,
-  discount_factor: 0.15000150001500018,
-  discount_pct: 84.99984999849998,
-  example_code: {
-    steps: {
-      exported: {
-        robot: '/wasabi/store',
-        use: ':original',
-        credentials: 'YOUR_WASABI_CREDENTIALS',
-        path: 'my_target_folder/${unique_prefix}/${file.url_name}',
-      },
-    },
-  },
+  ...robotStoreMeta,
+  example_code: createStorageStoreExample('/wasabi/store', 'YOUR_WASABI_CREDENTIALS'),
   example_code_description: 'Export uploaded files to `my_target_folder` on Wasabi:',
   has_small_icon: true,
-  minimum_charge: 0,
-  output_factor: 1,
-  override_lvl1: 'File Exporting',
   purpose_sentence: 'exports encoding results to Wasabi buckets',
-  purpose_verb: 'export',
   purpose_word: 'Wasabi',
   purpose_words: 'Export files to Wasabi',
-  service_slug: 'file-exporting',
-  slot_count: 10,
   title: 'Export files to Wasabi',
-  typical_file_size_mb: 1.2,
-  typical_file_type: 'file',
   name: 'WasabiStoreRobot',
-  priceFactor: 6.6666,
-  queueSlotCount: 10,
-  isAllowedForUrlTransform: true,
-  trackOutputFileSize: false,
-  isInternal: false,
-  removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
-  stage: 'ga',
 }
 
 export const robotWasabiStoreInstructionsSchema = robotBase
@@ -49,15 +36,11 @@ export const robotWasabiStoreInstructionsSchema = robotBase
     robot: z.literal('/wasabi/store').describe(`
 The URL to the result file will be returned in the <dfn>Assembly Status JSON</dfn>.
 `),
-    path: z
-      .string()
-      .default('${unique_prefix}/${file.url_name}')
-      .describe(`
-The path at which the file is to be stored. This may include any available [Assembly variables](/docs/topics/assembly-instructions/#assembly-variables). The path must not be a directory.
-`),
+    path: storeFilePath,
     acl: z
       .enum(['private', 'public-read'])
-      .default('public-read')
+      // API2 already treats an omitted ACL as private; consumer copies follow after this source lands.
+      .default('private')
       .describe(`
 The permissions used for this file.
 `),
@@ -65,49 +48,30 @@ The permissions used for this file.
       .record(z.string())
       .default({ 'Content-Type': '${file.mime}' })
       .describe(`
-An object containing a list of headers to be set for this file on Wasabi Spaces, such as \`{ FileURL: "\${file.url_name}" }\`. This can also include any available [Assembly Variables](/docs/topics/assembly-instructions/#assembly-variables).
+An object containing a list of headers to be set for this file in your Wasabi bucket, such as \`{ FileURL: "\${file.url_name}" }\`. This can also include any available [Assembly Variables](/docs/topics/assembly-instructions/#assembly-variables).
 
 Object Metadata can be specified using \`x-amz-meta-*\` headers. Note that these headers [do not support non-ASCII metadata values](https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMetadata.html#UserMetadata).
 `),
-    sign_urls_for: z
-      .number()
-      .int()
-      .min(0)
-      .optional()
-      .describe(`
-This parameter provides signed URLs in the result JSON (in the \`signed_ssl_url\` property). The number that you set this parameter to is the URL expiry time in seconds. If this parameter is not used, no URL signing is done.
-`),
+    sign_urls_for: signedSslUrlLifetime,
   })
   .strict()
 
-export const robotWasabiStoreInstructionsWithHiddenFieldsSchema =
-  robotWasabiStoreInstructionsSchema.extend({
-    result: z
-      .union([z.literal('debug'), robotWasabiStoreInstructionsSchema.shape.result])
-      .optional(),
-  })
-
-export type RobotWasabiStoreInstructions = z.infer<typeof robotWasabiStoreInstructionsSchema>
-export type RobotWasabiStoreInstructionsWithHiddenFields = z.infer<
-  typeof robotWasabiStoreInstructionsWithHiddenFieldsSchema
->
+export const robotDefinition: RobotDefinition<typeof robotWasabiStoreInstructionsSchema.shape> =
+  defineRobot(meta, robotWasabiStoreInstructionsSchema)
 
-export const interpolatableRobotWasabiStoreInstructionsSchema = interpolateRobot(
-  robotWasabiStoreInstructionsSchema,
-)
-export type InterpolatableRobotWasabiStoreInstructions =
-  InterpolatableRobotWasabiStoreInstructionsInput
+export const {
+  withHiddenFields: robotWasabiStoreInstructionsWithHiddenFieldsSchema,
+  interpolatable: interpolatableRobotWasabiStoreInstructionsSchema,
+  interpolatableWithHiddenFields: interpolatableRobotWasabiStoreInstructionsWithHiddenFieldsSchema,
+} = robotDefinition
 
-export type InterpolatableRobotWasabiStoreInstructionsInput = z.input<
-  typeof interpolatableRobotWasabiStoreInstructionsSchema
->
+type Instructions = RobotSchemaVariantTypes<typeof robotDefinition>
 
-export const interpolatableRobotWasabiStoreInstructionsWithHiddenFieldsSchema = interpolateRobot(
-  robotWasabiStoreInstructionsWithHiddenFieldsSchema,
-)
-export type InterpolatableRobotWasabiStoreInstructionsWithHiddenFields = z.infer<
-  typeof interpolatableRobotWasabiStoreInstructionsWithHiddenFieldsSchema
->
-export type InterpolatableRobotWasabiStoreInstructionsWithHiddenFieldsInput = z.input<
-  typeof interpolatableRobotWasabiStoreInstructionsWithHiddenFieldsSchema
->
+export type RobotWasabiStoreInstructions = Instructions['output']
+export type RobotWasabiStoreInstructionsWithHiddenFields = Instructions['hiddenOutput']
+export type InterpolatableRobotWasabiStoreInstructions = Instructions['interpolatableInput']
+export type InterpolatableRobotWasabiStoreInstructionsInput = Instructions['interpolatableInput']
+export type InterpolatableRobotWasabiStoreInstructionsWithHiddenFields =
+  Instructions['interpolatableHiddenOutput']
+export type InterpolatableRobotWasabiStoreInstructionsWithHiddenFieldsInput =
+  Instructions['interpolatableHiddenInput']

package/src/alphalib/types/robots/youtube-store.ts

@@ -1,49 +1,74 @@
-import type { RobotMetaInput } from './_instructions-primitives.ts'
+import type {
+  RobotDefinition,
+  RobotMetaInput,
+  RobotSchemaVariantTypes,
+} from './_instructions-primitives.ts'
 
 import { z } from 'zod'
 
-import { interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
+import { zodCodePointLength, zodWithJsonInputSchema } from '../../lib/zodInputSemantics.ts'
+import {
+  createProcessingExample,
+  defineRobot,
+  robotBase,
+  robotStoreMeta,
+  robotUse,
+} from './_instructions-primitives.ts'
+
+const youtubeCategories = [
+  'autos & vehicles',
+  'comedy',
+  'education',
+  'entertainment',
+  'film & animation',
+  'gaming',
+  'howto & style',
+  'music',
+  'news & politics',
+  'people & blogs',
+  'pets & animals',
+  'science & technology',
+  'sports',
+  'travel & events',
+] as const
+
+function asciiCaseInsensitiveLiteral(value: string): string {
+  return [...value]
+    .map((character) =>
+      character >= 'a' && character <= 'z' ? `[${character}${character.toUpperCase()}]` : character,
+    )
+    .join('')
+}
+
+const youtubeCategoryValueSchema = z.enum(youtubeCategories)
+const youtubeCategoryInputSchema = z
+  .string()
+  .regex(new RegExp(`^(?:${youtubeCategories.map(asciiCaseInsensitiveLiteral).join('|')})$`, 'u'))
+const youtubeCategorySchema = zodWithJsonInputSchema(
+  z.preprocess(
+    (value) => (typeof value === 'string' ? value.toLowerCase() : value),
+    youtubeCategoryValueSchema,
+  ),
+  youtubeCategoryInputSchema,
+)
 
 export const meta: RobotMetaInput = {
-  bytescount: 6,
-  discount_factor: 0.15000150001500018,
-  discount_pct: 84.99984999849998,
+  ...robotStoreMeta,
   hideCredentialsWarning: true,
-  example_code: {
-    steps: {
-      exported: {
-        robot: '/youtube/store',
-        use: ':original',
-        credentials: 'YOUR_YOUTUBE_CREDENTIALS',
-        title: 'Transloadit: Video Example',
-        description: 'Some nice description',
-        category: 'science & technology',
-        keywords: 'transloadit, robots, botty',
-        visibility: 'private',
-      },
-    },
-  },
+  example_code: createProcessingExample('exported', '/youtube/store', {
+    credentials: 'YOUR_YOUTUBE_CREDENTIALS',
+    title: 'Transloadit: Video Example',
+    description: 'Some nice description',
+    category: 'science & technology',
+    keywords: 'transloadit, robots, botty',
+    visibility: 'private',
+  }),
   example_code_description: 'Export an uploaded video to YouTube and set some basic parameters:',
-  minimum_charge: 0,
-  output_factor: 1,
-  override_lvl1: 'File Exporting',
   purpose_sentence: 'exports encoding results to YouTube',
-  purpose_verb: 'export',
   purpose_word: 'YouTube',
   purpose_words: 'Export files to YouTube',
-  service_slug: 'file-exporting',
-  slot_count: 10,
   title: 'Export files to YouTube',
-  typical_file_size_mb: 1.2,
-  typical_file_type: 'file',
   name: 'YoutubeStoreRobot',
-  priceFactor: 6.6666,
-  queueSlotCount: 10,
-  isAllowedForUrlTransform: true,
-  trackOutputFileSize: false,
-  isInternal: false,
-  removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
-  stage: 'ga',
 }
 
 export const robotYoutubeStoreInstructionsSchema = robotBase
@@ -72,15 +97,12 @@ You can add a custom thumbnail to your video on YouTube by using our \`"as"\` sy
 },
 \`\`\`
 
-If you encounter an error such as "The authenticated user doesnʼt have permissions to upload and set custom video thumbnails", you should go to your YouTube account and try adding a custom thumbnail to one of your existing videos. Youʼll be prompted to add your phone number. Once youʼve added it, the error should go away.
+If you encounter an error such as "The authenticated user doesn’t have permissions to upload and set custom video thumbnails", you should go to your YouTube account and try adding a custom thumbnail to one of your existing videos. You’ll be prompted to add your phone number. Once you’ve added it, the error should go away.
 `),
     credentials: z.string().describe(`
 The authentication Template credentials used for your YouTube account. You can generate them on the [Template Credentials page](/c/template-credentials/). Simply add the name of your YouTube channel, and you will be redirected to a Google verification page. Accept the presented permissions and you will be good to go.
 `),
-    title: z
-      .string()
-      .max(80)
-      .describe(`
+    title: zodCodePointLength(z.string(), { max: 80 }).describe(`
 The title of the video to be displayed on YouTube.
 
 Note that since the YouTube API requires titles to be within 80 characters, longer titles may be truncated.
@@ -88,27 +110,7 @@ Note that since the YouTube API requires titles to be within 80 characters, long
     description: z.string().describe(`
 The description of the video to be displayed on YouTube. This can be up to 5000 characters, including \`\\n\` for new-lines.
 `),
-    category: z
-      .preprocess(
-        (val) => (typeof val === 'string' ? val.toLowerCase() : val),
-        z.enum([
-          'autos & vehicles',
-          'comedy',
-          'education',
-          'entertainment',
-          'film & animation',
-          'gaming',
-          'howto & style',
-          'music',
-          'news & politics',
-          'people & blogs',
-          'pets & animals',
-          'science & technology',
-          'sports',
-          'travel & events',
-        ]),
-      )
-      .describe(`
+    category: youtubeCategorySchema.describe(`
 The category to which this video will be assigned.
 `),
     keywords: z.string().describe(`
@@ -120,34 +122,22 @@ Defines the visibility of the uploaded video.
   })
   .strict()
 
-export const robotYoutubeStoreInstructionsWithHiddenFieldsSchema =
-  robotYoutubeStoreInstructionsSchema.extend({
-    result: z
-      .union([z.literal('debug'), robotYoutubeStoreInstructionsSchema.shape.result])
-      .optional(),
-  })
-
-export type RobotYoutubeStoreInstructions = z.infer<typeof robotYoutubeStoreInstructionsSchema>
-export type RobotYoutubeStoreInstructionsWithHiddenFields = z.infer<
-  typeof robotYoutubeStoreInstructionsWithHiddenFieldsSchema
->
-
-export const interpolatableRobotYoutubeStoreInstructionsSchema = interpolateRobot(
-  robotYoutubeStoreInstructionsSchema,
-)
-export type InterpolatableRobotYoutubeStoreInstructions =
-  InterpolatableRobotYoutubeStoreInstructionsInput
-
-export type InterpolatableRobotYoutubeStoreInstructionsInput = z.input<
-  typeof interpolatableRobotYoutubeStoreInstructionsSchema
->
-
-export const interpolatableRobotYoutubeStoreInstructionsWithHiddenFieldsSchema = interpolateRobot(
-  robotYoutubeStoreInstructionsWithHiddenFieldsSchema,
-)
-export type InterpolatableRobotYoutubeStoreInstructionsWithHiddenFields = z.infer<
-  typeof interpolatableRobotYoutubeStoreInstructionsWithHiddenFieldsSchema
->
-export type InterpolatableRobotYoutubeStoreInstructionsWithHiddenFieldsInput = z.input<
-  typeof interpolatableRobotYoutubeStoreInstructionsWithHiddenFieldsSchema
->
+export const robotDefinition: RobotDefinition<typeof robotYoutubeStoreInstructionsSchema.shape> =
+  defineRobot(meta, robotYoutubeStoreInstructionsSchema)
+
+export const {
+  withHiddenFields: robotYoutubeStoreInstructionsWithHiddenFieldsSchema,
+  interpolatable: interpolatableRobotYoutubeStoreInstructionsSchema,
+  interpolatableWithHiddenFields: interpolatableRobotYoutubeStoreInstructionsWithHiddenFieldsSchema,
+} = robotDefinition
+
+type Instructions = RobotSchemaVariantTypes<typeof robotDefinition>
+
+export type RobotYoutubeStoreInstructions = Instructions['output']
+export type RobotYoutubeStoreInstructionsWithHiddenFields = Instructions['hiddenOutput']
+export type InterpolatableRobotYoutubeStoreInstructions = Instructions['interpolatableInput']
+export type InterpolatableRobotYoutubeStoreInstructionsInput = Instructions['interpolatableInput']
+export type InterpolatableRobotYoutubeStoreInstructionsWithHiddenFields =
+  Instructions['interpolatableHiddenOutput']
+export type InterpolatableRobotYoutubeStoreInstructionsWithHiddenFieldsInput =
+  Instructions['interpolatableHiddenInput']

package/src/alphalib/types/stackVersions.ts

@@ -1,12 +1,35 @@
+/** Runtime stack selection, ordered oldest to newest; stack IDs are not tool version numbers. */
+export const runtimeStackVersions = {
+  exiftool: { default: 'v13.36', valid: ['v13.36'] },
+  mplayer: { default: 'v1.5.0', valid: ['v1.5.0'] },
+  mediainfo: { default: 'v23.10', valid: ['v23.10'] },
+  imagemagick: {
+    default: 'v2.0.10',
+    // Normalizers upgrade these versions; AssemblyValidator supplies deprecation warnings.
+    deprecated: { 'v2.0.9': 'v2.0.10', 'v3.0.0': 'v3.0.1' },
+    valid: ['v2.0.10', 'v3.0.1'],
+  },
+  ffmpeg: {
+    default: 'v6.0.0',
+    // v5 remains accepted input but its binary has been retired after this cutoff.
+    deprecated: { 'v5.0.0': 'v6.0.0' },
+    autoUpgradeAfter: { 'v5.0.0': '2026-04-30T00:00:00.000Z' },
+    valid: ['v6.0.0', 'v7.0.0', 'v8.0.0'],
+    highest: 'v8.0.0',
+  },
+  file: { default: 'v5.46', valid: ['v5.46'] },
+} as const
+
+/** Public authoring recommendations, deliberately distinct from applied runtime defaults. */
 export const stackVersions = {
   ffmpeg: {
-    recommendedVersion: 'v6' as const,
-    test: /^v?[5-8](\.\d+)?(\.\d+)?$/,
+    recommendedVersion: 'v7' as const,
+    test: /^v?[5-8](\.[0-9]+)?(\.[0-9]+)?$/u,
     suggestedValues: ['v6', 'v7', 'v8'] as const,
   },
   imagemagick: {
     recommendedVersion: 'v3' as const,
-    test: /^v?[23](\.\d+)?(\.\d+)?$/,
+    test: /^v?[23](\.[0-9]+)?(\.[0-9]+)?$/u,
     suggestedValues: ['v2', 'v3'] as const,
   },
 }