@encatch/schema 1.2.0-beta.1 → 1.2.0-beta.10

package/dist/esm/index.js

@@ -70,6 +70,51 @@ var longAnswerQuestionTranslationSchema = baseQuestionTranslationFieldsSchema.ex
   type: z.literal("long_text").describe("Question type identifier"),
   placeholder: translationEntrySchema.optional().describe("Textarea placeholder translation")
 }).describe("Translation schema for long answer questions");
+var videoAudioQuestionTranslationSchema = baseQuestionTranslationFieldsSchema.extend({
+  type: z.literal("video_audio").describe("Question type identifier"),
+  placeholder: translationEntrySchema.optional().describe("Placeholder for text/photo hints"),
+  modeTabLabelVideo: z.string().max(80).optional().describe("Translated tab label for video mode"),
+  modeTabLabelAudio: z.string().max(80).optional().describe("Translated tab label for audio mode"),
+  modeTabLabelPhoto: z.string().max(80).optional().describe("Translated tab label for photo mode"),
+  modeTabLabelText: z.string().max(80).optional().describe("Translated tab label for text mode"),
+  recordButtonLabel: z.string().max(80).optional().describe("Translated Record button label"),
+  uploadMediaButtonLabel: z.string().max(80).optional().describe("Translated upload button (video/audio)"),
+  videoIdleHint: z.string().max(200).optional().describe("Translated video idle overlay hint"),
+  photoEmptyHint: z.string().max(200).optional().describe("Translated empty photo area hint"),
+  photoUseCameraButtonLabel: z.string().max(80).optional().describe("Translated Use camera button"),
+  photoUploadImageButtonLabel: z.string().max(80).optional().describe("Translated Upload image button")
+}).describe("Translation schema for video/audio/photo/text questions");
+var dateQuestionTranslationSchema = baseQuestionTranslationFieldsSchema.extend({
+  type: z.literal("date").describe("Question type identifier"),
+  placeholder: translationEntrySchema.optional().describe("Placeholder for the date field"),
+  segmentLabelDD: z.string().max(40).optional().describe("Label above the day digits"),
+  segmentLabelMM: z.string().max(40).optional().describe("Label above the month digits"),
+  segmentLabelYYYY: z.string().max(40).optional().describe("Label above the year digits")
+}).describe("Translation schema for date questions");
+var signatureQuestionTranslationSchema = baseQuestionTranslationFieldsSchema.extend({
+  type: z.literal("signature").describe("Question type identifier"),
+  clearButtonLabel: z.string().max(50).optional().describe("Translated clear button in draw mode"),
+  placeholder: z.string().max(200).optional().describe("Shared fallback for draw/upload hints"),
+  modeTabLabelType: z.string().max(80).optional().describe("Translated Type tab label"),
+  modeTabLabelDraw: z.string().max(80).optional().describe("Translated Draw tab label"),
+  modeTabLabelUpload: z.string().max(80).optional().describe("Translated Upload tab label"),
+  drawCanvasHint: z.string().max(200).optional().describe("Translated empty-canvas hint"),
+  uploadZonePrimary: z.string().max(200).optional().describe("Translated idle upload prompt"),
+  uploadZoneDrag: z.string().max(120).optional().describe("Translated drag-over upload prompt")
+}).describe("Translation schema for signature questions");
+var schedulerQuestionTranslationSchema = baseQuestionTranslationFieldsSchema.extend({
+  type: z.literal("scheduler").describe("Question type identifier"),
+  placeholder: z.string().max(200).optional().describe("Fallback for meeting CTA when scheduleMeetingLabel is unset"),
+  scheduleMeetingLabel: z.string().max(200).optional().describe("Book-a-meeting button and modal label")
+}).describe("Translation schema for scheduler questions");
+var qnaWithAiQuestionTranslationSchema = baseQuestionTranslationFieldsSchema.extend({
+  type: z.literal("qna_with_ai").describe("Question type identifier"),
+  placeholder: z.string().max(200).optional().describe("Input placeholder for the question field"),
+  askButtonLabel: z.string().max(50).optional().describe("Ask / submit control label"),
+  emptyStateHint: z.string().max(200).optional().describe("Empty chat area hint"),
+  pairsRemainingTemplate: z.string().max(160).optional().describe("Under-limit counter; tokens {remaining} and {max}"),
+  pairsLimitReachedTemplate: z.string().max(160).optional().describe("At-limit message; token {max}")
+}).describe("Translation schema for Q&A with AI questions");
 var nestedSelectionQuestionTranslationSchema = baseQuestionTranslationFieldsSchema.extend({
   type: z.literal("nested_selection").describe("Question type identifier"),
   placeholder: translationEntrySchema.optional().describe("Dropdown placeholder translation")
@@ -164,6 +209,11 @@ var questionTranslationSchema = z.union([
   npsQuestionTranslationSchema,
   shortAnswerQuestionTranslationSchema,
   longAnswerQuestionTranslationSchema,
+  videoAudioQuestionTranslationSchema,
+  dateQuestionTranslationSchema,
+  signatureQuestionTranslationSchema,
+  schedulerQuestionTranslationSchema,
+  qnaWithAiQuestionTranslationSchema,
   nestedSelectionQuestionTranslationSchema,
   annotationQuestionTranslationSchema,
   welcomeQuestionTranslationSchema,
@@ -525,7 +575,9 @@ var questionSchema = z2.object({
   nextButtonLabel: z2.string().min(1).max(50).default("Next").describe(
     "Label for the next button when advancing past this question (overrides section or form defaults when set)"
   ),
-  showQuestionTitle: z2.boolean().default(true).describe("Whether to display the question title; defaults to true")
+  showQuestionTitle: z2.boolean().default(true).describe("Whether to display the question title; defaults to true"),
+  questionMediaUrl: z2.string().url().optional().describe("Optional URL for media (image or video) displayed alongside the question"),
+  questionMediaType: z2.enum(["image", "video", "youtube", "vimeo"]).optional().describe("Type of media referenced by questionMediaUrl; one of 'image', 'video', 'youtube', or 'vimeo'")
 }).describe("Base schema for all question types with common properties");
 var ratingQuestionSchema = questionSchema.extend({
   type: z2.literal("rating").describe("Must be exactly 'rating'"),
@@ -906,6 +958,9 @@ var dateQuestionSchema = questionSchema.extend({
   minDate: z2.string().optional().describe("Earliest allowed date in ISO 8601 format (YYYY-MM-DD); when absent no lower bound is enforced"),
   maxDate: z2.string().optional().describe("Latest allowed date in ISO 8601 format (YYYY-MM-DD); when absent no upper bound is enforced"),
   placeholder: z2.string().max(50).optional().describe("Placeholder text shown in the date input"),
+  segmentLabelDD: z2.string().max(40).optional().describe("Visible label above the day segment; when absent a locale default is used"),
+  segmentLabelMM: z2.string().max(40).optional().describe("Visible label above the month segment"),
+  segmentLabelYYYY: z2.string().max(40).optional().describe("Visible label above the year segment"),
   prepopulatedValue: z2.string().optional().describe("Default date value in ISO 8601 format (YYYY-MM-DD) to pre-fill the input")
 }).describe("Schema for a date question that collects a structured date (and optionally time) from the respondent");
 var csatScaleSchema = z2.union([
@@ -930,12 +985,12 @@ var csatQuestionSchema = questionSchema.extend({
   scale: csatScaleSchema.optional().default(5).describe("Number of response points (2\u20135); 2 and 4 have no neutral option, default is 5"),
   displayStyle: csatDisplayStyleSchema.optional().default("emoji").describe("How response options are rendered \u2014 emoji faces (default) or text buttons"),
   multicolor: z2.boolean().optional().default(false).describe("Whether to apply distinct colors to negative, neutral, and positive segments"),
-  negativeColor: z2.string().max(50).optional().describe("Color for negative response options (semantic values -2, -1); any valid CSS color; used when multicolor is true"),
-  neutralColor: z2.string().max(50).optional().describe("Color for the neutral response option (semantic value 0); any valid CSS color; used when multicolor is true"),
-  positiveColor: z2.string().max(50).optional().describe("Color for positive response options (semantic values 1, 2); any valid CSS color; used when multicolor is true"),
+  negativeColor: z2.string().max(50).optional().describe("Color for negative response options (lower half of scale); any valid CSS color; used when multicolor is true"),
+  neutralColor: z2.string().max(50).optional().describe("Color for the neutral midpoint option (odd scales only: scale 3 = value 2, scale 5 = value 3); any valid CSS color; used when multicolor is true"),
+  positiveColor: z2.string().max(50).optional().describe("Color for positive response options (upper half of scale); any valid CSS color; used when multicolor is true"),
   showLabels: z2.boolean().optional().default(false).describe("Whether to render per-point labels below each response option"),
-  scaleLabels: z2.record(z2.string(), z2.string().max(100)).optional().describe("Per-point label text keyed by semantic value string ('-2', '-1', '0', '1', '2')")
-}).describe("Schema for a CSAT (Customer Satisfaction Score) question using a 2\u20135 point semantic scale");
+  scaleLabels: z2.record(z2.string(), z2.string().max(100)).optional().describe("Per-point label text keyed by value string ('1'\u2013'5'); keys must match the chosen scale size")
+}).describe("Schema for a CSAT (Customer Satisfaction Score) question using an industry-standard 1-to-N positive scale (N = 2\u20135)");
 var opinionScaleQuestionSchema = questionSchema.extend({
   type: z2.literal("opinion_scale").describe("Must be exactly 'opinion_scale'"),
   startValue: z2.union([z2.literal(0), z2.literal(1)]).optional().default(0).describe("Starting value of the scale \u2014 0 (default) or 1"),
@@ -1006,7 +1061,16 @@ var signatureQuestionSchema = questionSchema.extend({
   penWidth: z2.number().int().min(1).max(20).optional().describe("Pen stroke thickness in pixels for the draw canvas (1\u201320); when absent the renderer default (typically 2) is used"),
   backgroundColor: z2.string().max(50).optional().describe("Background color of the draw canvas; any valid CSS color; when absent the canvas is transparent and inherits the form background"),
   canvasHeight: z2.number().int().min(60).max(600).optional().describe("Draw canvas height in logical pixels (60\u2013600); width always fills the container; when absent the renderer chooses a sensible default (typically 200)"),
-  clearButtonLabel: z2.string().max(50).optional().describe("Label for the clear/redo button in draw mode; when absent the platform default label or icon is shown")
+  clearButtonLabel: z2.string().max(50).optional().describe("Label for the clear/redo button in draw mode; when absent the platform default label or icon is shown"),
+  placeholder: z2.string().max(200).optional().describe(
+    "Optional shared fallback copy for draw-canvas and upload-zone hints when their dedicated fields are unset"
+  ),
+  modeTabLabelType: z2.string().max(80).optional().describe("Custom visible label for the Type tab; when absent only the tab icon is shown (use aria-label on the client)"),
+  modeTabLabelDraw: z2.string().max(80).optional().describe("Custom visible label for the Draw tab; when absent only the tab icon is shown"),
+  modeTabLabelUpload: z2.string().max(80).optional().describe("Custom visible label for the Upload tab; when absent only the tab icon is shown"),
+  drawCanvasHint: z2.string().max(200).optional().describe("Hint shown on the empty draw canvas (e.g. 'Draw your signature here'); falls back to placeholder then platform default"),
+  uploadZonePrimary: z2.string().max(200).optional().describe("Main prompt on the upload drop zone when idle (e.g. click to upload); falls back to placeholder then default"),
+  uploadZoneDrag: z2.string().max(120).optional().describe("Short prompt when dragging a file over the upload zone; falls back to platform default")
 }).describe("Schema for a signature question where respondents can type, draw, or upload their electronic signature");
 var fileUploadQuestionSchema = questionSchema.extend({
   type: z2.literal("file_upload").describe("Must be exactly 'file_upload'"),
@@ -1029,7 +1093,7 @@ var numberQuestionSchema = questionSchema.extend({
   allowNegative: z2.boolean().optional().default(false).describe("Whether negative values are accepted; Typeform restricts to positive numbers only, making this a differentiator"),
   placeholder: z2.string().max(200).optional().describe("Placeholder text shown inside the number input"),
   prepopulatedValue: z2.number().optional().describe("Default numeric value to pre-fill the input"),
-  unit: z2.string().max(20).optional().describe("Unit label displayed beside the input (e.g. 'kg', '$', 'years')")
+  unit: z2.string().max(10).optional().describe("Unit label displayed beside the input (e.g. 'kg', '$', 'years')")
 }).refine(
   (data) => data.min === void 0 || data.max === void 0 || data.min <= data.max,
   {
@@ -1052,7 +1116,8 @@ var phoneNumberQuestionSchema = questionSchema.extend({
 var addressSubFieldConfigSchema = z2.object({
   enabled: z2.boolean().default(true).describe("Whether this sub-field is shown in the question"),
   required: z2.boolean().default(false).describe("Whether the respondent must fill in this sub-field"),
-  placeholder: z2.string().max(200).optional().describe("Placeholder text for this sub-field input")
+  placeholder: z2.string().max(200).optional().describe("Placeholder text for this sub-field input"),
+  label: z2.string().max(120).optional().describe("Visible caption above this sub-field; defaults to built-in copy when omitted")
 }).describe("Configuration for an individual address sub-field");
 var addressQuestionSchema = questionSchema.extend({
   type: z2.literal("address").describe("Must be exactly 'address'"),
@@ -1064,21 +1129,32 @@ var addressQuestionSchema = questionSchema.extend({
   country: addressSubFieldConfigSchema.optional().describe("Configuration for the country sub-field"),
   defaultCountry: z2.string().max(2).optional().describe("ISO 3166-1 alpha-2 country code to pre-select in the country dropdown (e.g. 'US', 'GB')")
 }).describe("Schema for an address question that collects a full structured address on a single screen");
-var videoAudioModeSchema = z2.enum(["video", "audio", "text"]);
+var videoAudioModeSchema = z2.enum(["video", "audio", "photo", "text"]);
 var VideoAudioModes = {
   VIDEO: "video",
   AUDIO: "audio",
+  PHOTO: "photo",
   TEXT: "text"
 };
 var videoAudioQuestionSchema = questionSchema.extend({
   type: z2.literal("video_audio").describe("Must be exactly 'video_audio'"),
-  allowedModes: z2.array(videoAudioModeSchema).min(1).optional().describe("Which answer types the respondent can choose from (video, audio, text); when absent all three are enabled"),
+  allowedModes: z2.array(videoAudioModeSchema).min(1).optional().describe("Which answer types the respondent can choose from (video, audio, photo, text); when absent all four are enabled"),
   defaultMode: videoAudioModeSchema.optional().describe("Which mode tab is pre-selected when the question opens; when absent the platform chooses"),
   maxDurationSeconds: z2.number().int().min(5).max(600).optional().describe("Maximum recording length in seconds (5\u2013600); Typeform hardcodes 120s with no config, making this a differentiator; when absent the platform default applies"),
   maxFileSizeMb: z2.number().int().min(1).max(500).optional().describe("Maximum size in megabytes for uploaded pre-recorded files (1\u2013500); when absent the platform ceiling applies"),
-  allowUpload: z2.boolean().optional().default(true).describe("Whether the respondent can upload a pre-recorded file in addition to recording live"),
-  placeholder: z2.string().max(200).optional().describe("Instructional text shown to the respondent before they begin recording")
-}).describe("Schema for a video and audio question where respondents can record or upload a video, audio clip, or text answer");
+  allowUpload: z2.boolean().optional().default(true).describe("Whether the respondent can upload a file in addition to recording or capturing live (video, audio, or photo)"),
+  placeholder: z2.string().max(200).optional().describe("Instructional text shown to the respondent before they begin recording or capturing"),
+  modeTabLabelVideo: z2.string().max(80).optional().describe("Custom tab label for video mode in the respondent UI; when absent defaults to 'Video'"),
+  modeTabLabelAudio: z2.string().max(80).optional().describe("Custom tab label for audio mode; when absent defaults to 'Audio'"),
+  modeTabLabelPhoto: z2.string().max(80).optional().describe("Custom tab label for photo mode; when absent defaults to 'Photo'"),
+  modeTabLabelText: z2.string().max(80).optional().describe("Custom tab label for text mode; when absent defaults to 'Text'"),
+  recordButtonLabel: z2.string().max(80).optional().describe("Label for the Record button in video/audio modes"),
+  uploadMediaButtonLabel: z2.string().max(80).optional().describe("Label for the upload control in video/audio modes when uploads are allowed"),
+  videoIdleHint: z2.string().max(200).optional().describe("Hint shown over the video preview when idle; falls back to placeholder then built-in copy"),
+  photoEmptyHint: z2.string().max(200).optional().describe("Hint in the empty photo preview area; falls back to placeholder then built-in copy"),
+  photoUseCameraButtonLabel: z2.string().max(80).optional().describe("Label for the Use camera button in photo mode"),
+  photoUploadImageButtonLabel: z2.string().max(80).optional().describe("Label for the upload image button in photo mode")
+}).describe("Schema for a video, audio, and photo question where respondents can record or upload media or enter a text answer");
 var schedulerProviderSchema = z2.enum(["google_calendar", "calendly"]);
 var SchedulerProviders = {
   GOOGLE_CALENDAR: "google_calendar",
@@ -1091,7 +1167,12 @@ var schedulerQuestionSchema = questionSchema.extend({
   showIntroScreen: z2.boolean().optional().default(true).describe("Whether to show the Calendly event intro screen (account name, event name, duration) before the time picker; only applies when provider is 'calendly'"),
   autofillNameFieldId: z2.string().optional().describe("ID of a prior Short Text or Name question whose answer is pre-filled into the Calendly booking name field; only applies when provider is 'calendly'"),
   autofillEmailFieldId: z2.string().optional().describe("ID of a prior Email question whose answer is pre-filled into the Calendly booking email field; only applies when provider is 'calendly'"),
-  placeholder: z2.string().max(200).optional().describe("Instructional text shown above the calendar picker to guide the respondent")
+  placeholder: z2.string().max(200).optional().describe(
+    "Fallback text for the book-a-meeting button when scheduleMeetingLabel is unset; also used as a secondary fallback in the CTA copy chain"
+  ),
+  scheduleMeetingLabel: z2.string().max(200).optional().describe(
+    "Primary label on the book-a-meeting button and modal; when absent uses placeholder then the built-in default (e.g. 'Schedule a meeting')"
+  )
 }).describe("Schema for a scheduler question where respondents book a time slot directly within the form via Google Calendar or Calendly");
 var qnaWithAiQuestionSchema = questionSchema.extend({
   type: z2.literal("qna_with_ai").describe("Must be exactly 'qna_with_ai'"),
@@ -1099,7 +1180,16 @@ var qnaWithAiQuestionSchema = questionSchema.extend({
   maxResponseLength: z2.number().int().min(50).max(2e3).optional().describe("Maximum number of characters per AI-generated response (50\u20132000); Typeform hardcodes 300, making this configurable a differentiator; when absent the platform default (300) applies"),
   maxQaPairs: z2.number().int().min(1).max(100).optional().describe("Maximum number of Q&A exchanges allowed per submission (1\u2013100); Typeform hardcodes 20, making this configurable a differentiator; when absent the platform default (20) applies"),
   placeholder: z2.string().max(200).optional().describe("Hint text shown in the respondent's question input field (e.g. 'Ask me anything about this event...')"),
-  askButtonLabel: z2.string().max(50).optional().describe("Label for the submit/ask button; when absent the platform default (e.g. 'Ask AI') is shown")
+  askButtonLabel: z2.string().max(50).optional().describe("Label for the submit/ask button; when absent the platform default (e.g. 'Ask AI') is shown"),
+  emptyStateHint: z2.string().max(200).optional().describe(
+    "Message in the empty chat area (e.g. 'Ask the AI a question to get started.'); when absent uses placeholder then a built-in default"
+  ),
+  pairsRemainingTemplate: z2.string().max(160).optional().describe(
+    "Counter when under the limit; use tokens {remaining} and {max} (e.g. '{remaining} of {max} questions remaining'); when absent the client uses built-in English with pluralization"
+  ),
+  pairsLimitReachedTemplate: z2.string().max(160).optional().describe(
+    "Counter when the exchange limit is reached; use token {max}; when absent the client uses built-in English with pluralization"
+  )
 }).describe("Schema for a Q&A with AI question where respondents ask questions and receive AI-generated answers drawn from a configurable knowledge base");
 var combinedQuestionSchema = z2.discriminatedUnion("type", [
   ratingQuestionSchema,
@@ -1174,10 +1264,10 @@ var AddressAnswerSchema = z3.object({
   country: z3.string().optional().describe("Country name or ISO 3166-1 alpha-2 code")
 }).describe("Answer for an address question");
 var VideoAudioAnswerSchema = z3.object({
-  mode: z3.enum(["video", "audio", "text"]).describe("The answer mode the respondent chose"),
-  fileUrl: z3.string().optional().describe("Secure URL to the recorded or uploaded video/audio file"),
+  mode: z3.enum(["video", "audio", "photo", "text"]).describe("The answer mode the respondent chose"),
+  fileUrl: z3.string().optional().describe("Secure URL or temporary data URL to the recorded, captured, or uploaded video, audio, or image file"),
   text: z3.string().optional().describe("Written answer for text mode"),
-  durationSeconds: z3.number().optional().describe("Actual recording length in seconds for video and audio modes"),
+  durationSeconds: z3.number().optional().describe("Actual recording length in seconds for video and audio modes (not used for photo)"),
   transcriptText: z3.string().optional().describe("Auto-generated transcript for video and audio recordings")
 }).describe("Answer for a video and audio question");
 var QnaWithAiPairSchema = z3.object({
@@ -1185,23 +1275,29 @@ var QnaWithAiPairSchema = z3.object({
   answer: z3.string().describe("The AI-generated answer based on the knowledge base")
 }).describe("A single Q&A exchange between the respondent and the AI");
 var QnaWithAiAnswerSchema = z3.array(QnaWithAiPairSchema).describe("Answer for a qna_with_ai question; ordered transcript of Q&A pairs from the session");
-var SchedulerAnswerSchema = z3.object({
-  provider: z3.enum(["google_calendar", "calendly"]).describe("The calendar integration used to make the booking"),
-  slotStart: z3.string().describe("ISO 8601 datetime of the booked slot start (e.g. '2026-05-15T14:00:00Z')"),
-  slotEnd: z3.string().describe("ISO 8601 datetime of the booked slot end (e.g. '2026-05-15T14:30:00Z')"),
-  eventId: z3.string().optional().describe("Calendar event ID (Google Calendar) or Calendly event UUID"),
-  bookedAt: z3.string().describe("ISO 8601 datetime when the respondent completed the booking")
-}).describe("Answer for a scheduler question");
+var SchedulerAnswerSchema = z3.discriminatedUnion("provider", [
+  z3.object({
+    provider: z3.literal("google_calendar").describe("The calendar integration used to make the booking"),
+    bookedAt: z3.string().describe("Unix timestamp in seconds as a string when the respondent confirmed the booking")
+  }),
+  z3.object({
+    provider: z3.literal("calendly").describe("The calendar integration used to make the booking"),
+    slotStart: z3.string().describe("ISO 8601 datetime of the booked slot start (e.g. '2026-05-15T14:00:00Z')"),
+    slotEnd: z3.string().describe("ISO 8601 datetime of the booked slot end (e.g. '2026-05-15T14:30:00Z')"),
+    eventId: z3.string().optional().describe("Calendly event UUID"),
+    bookedAt: z3.string().describe("Unix timestamp in seconds as a string when the respondent completed the booking")
+  })
+]).describe("Answer for a scheduler question");
 var AnswerItemSchema = z3.object({
   nps: z3.number().optional().describe("Net Promoter Score value (e.g., 0-10)"),
   nestedSelection: z3.array(z3.string()).optional().describe("Array of selected nested option IDs"),
   longText: z3.string().optional().describe("Long text answer, e.g., paragraph or essay"),
   shortAnswer: z3.string().optional().describe("Short text answer, e.g., single sentence or word"),
-  singleChoice: z3.string().optional().describe("single selected option ID (for single choice questions)"),
+  singleChoice: z3.string().optional().describe("Single selected option value for single choice questions"),
   rating: z3.number().optional().describe("Star rating value (e.g., 1-5)"),
   yesNo: z3.boolean().optional().describe("Yes/no answer for yes_no questions (true = Yes, false = No)"),
   consent: z3.boolean().optional().describe("Consent answer for consent questions (true = checked/agreed, false = unchecked)"),
-  multipleChoiceMultiple: z3.array(z3.string()).optional().describe("Array of selected option IDs for multiple choice questions"),
+  multipleChoiceMultiple: z3.array(z3.string()).optional().describe("Array of selected option values for multiple choice questions"),
   singleChoiceOther: z3.string().optional().describe('Free-text "other" answer for single choice questions when allowOther is enabled'),
   multipleChoiceOther: z3.string().optional().describe('Free-text "other" answer for multiple choice questions when allowOther is enabled'),
   annotation: AnnotationSchema.optional().describe(
@@ -1222,15 +1318,14 @@ var AnswerItemSchema = z3.object({
   // Date question
   date: z3.string().optional().describe("Answer for a date question; ISO 8601 format (YYYY-MM-DD or YYYY-MM-DDTHH:MM)"),
   // CSAT question
-  csat: z3.number().optional().describe("Answer for a CSAT question; semantic value: -2, -1, 0, 1, or 2"),
+  csat: z3.number().optional().describe("Answer for a CSAT question; industry-standard value: 1 (lowest/worst) to N (highest/best) where N is the scale size (2\u20135)"),
   // Opinion scale question
   opinionScale: z3.number().optional().describe("Answer for an opinion scale question; the selected numeric value on the scale"),
-  // Ranking question — ordered array of option IDs; index 0 = rank 1
-  ranking: z3.array(z3.string()).optional().describe("Answer for a ranking question; ordered array of option IDs where index 0 is rank 1"),
-  // Picture choice — single selection
-  pictureChoice: z3.string().optional().describe("Answer for a picture choice question (single selection); the selected option ID"),
-  // Picture choice — multiple selection
-  pictureChoiceMultiple: z3.array(z3.string()).optional().describe("Answer for a picture choice question (multiple selection); array of selected option IDs"),
+  // Ranking question — ordered array of option values; index 0 = rank 1
+  ranking: z3.array(z3.string()).optional().describe("Answer for a ranking question; ordered array of option values where index 0 is rank 1"),
+  // Picture choice — always an array of selected option values (single selection = one-element array)
+  pictureChoice: z3.array(z3.string()).optional().describe("Answer for a picture choice question; array of selected option values (single selection produces a one-element array)"),
+  pictureChoiceOther: z3.string().optional().describe('Free-text "other" answer for picture choice questions when allowOther is enabled'),
   // Signature question
   signature: SignatureAnswerSchema.optional().describe("Answer for a signature question"),
   // File upload question
@@ -1238,7 +1333,7 @@ var AnswerItemSchema = z3.object({
   // Email question
   email: z3.string().optional().describe("Answer for an email question; the submitted email address"),
   // Number question
-  number: z3.number().optional().describe("Answer for a number question; the submitted numeric value"),
+  number: z3.string().optional().describe("Answer for a number question; the submitted numeric value as a string"),
   // Website question
   website: z3.string().optional().describe("Answer for a website question; the submitted URL"),
   // Phone number question
@@ -1290,6 +1385,7 @@ var OtherFieldsSchema = z5.object({
   remindMeLaterButtonLabel: z5.string().max(50).optional().describe("Label for the remind me later button; when absent or blank the button is not shown"),
   estimatedCompletionLabel: z5.string().max(100).optional().describe("Estimated completion time label shown on the welcome or first screen (e.g. 'Takes about 2 minutes'); when absent the label is not shown"),
   respondentsShowMinThreshold: z5.number().int().min(1).optional().describe("Minimum number of respondents required before the respondents badge is shown; when absent the badge is never shown"),
+  respondentsLabel: z5.string().max(100).optional().describe("Label template for the respondents badge (e.g. '{count} people have already responded'); client interpolates {count} at render time"),
   windowTitle: z5.string().max(100).optional().describe("Custom browser window/tab title for the form; when absent the platform uses a default (e.g. the form title or app name)")
 }).describe("Schema for other form configuration fields");
 var LanguageFieldSchema = z5.object({
@@ -1798,8 +1894,11 @@ var fetchFeedbackDetailsSchema = z13.object({
 }).strict().describe("Request schema for fetching specific feedback form details");
 var formConfigurationResponseSchema = z13.object({
   formTitle: z13.string().describe("Title of the feedback form"),
-  formDescription: z13.string().describe("Description of the feedback form")
-}).describe("Form configuration response with title and description");
+  formDescription: z13.string().describe("Description of the feedback form"),
+  respondentsCount: z13.number().int().min(0).optional().describe(
+    "Total number of respondents enriched by the server at fetch time; used alongside respondentsShowMinThreshold to decide whether to display the welcome badge"
+  )
+}).describe("Form configuration response with title, description, and optional respondent count");
 var logicJumpRuleSchema = z13.object({
   jsonLogic: z13.record(z13.string(), z13.unknown()).describe("JSON Logic expression to evaluate"),
   targetQuestionId: z13.string().describe("Question ID to navigate to when this rule matches")
@@ -1831,7 +1930,7 @@ var fetchFeedbackDetailsResponseSchema = z13.object({
   feedbackConfigurationId: z13.string().uuid().describe("Unique identifier for the feedback configuration"),
   feedbackIdentifier: z13.string().uuid().describe("Unique identifier for this specific feedback instance"),
   formConfiguration: formConfigurationResponseSchema.describe(
-    "Form configuration with title and description"
+    "Form configuration including title, description, and optional respondent count for the welcome badge"
   ),
   questionnaireFields: questionnaireFieldsResponseSchema.describe(
     "Questionnaire structure including questions, sections, translations, and languages"
@@ -1841,8 +1940,7 @@ var fetchFeedbackDetailsResponseSchema = z13.object({
   ),
   appearanceProperties: appearancePropertiesSchema.describe(
     "Appearance properties including theme configuration"
-  ),
-  respondentsCount: z13.number().int().min(0).optional().describe("Total number of respondents enriched by the server at fetch time; used alongside respondentsShowMinThreshold to decide whether to display the badge")
+  )
 }).strict().describe(
   "Complete response schema for fetchFeedbackDetails API using existing field schemas"
 );
@@ -2055,6 +2153,7 @@ export {
   customEventFieldSchema,
   dateFormatSchema,
   dateQuestionSchema,
+  dateQuestionTranslationSchema,
   dateSeparatorSchema,
   deviceInfoSchema,
   deviceSessionInfoSchema,
@@ -2119,6 +2218,7 @@ export {
   previousButtonModeSchema,
   publicationStatusSchema,
   qnaWithAiQuestionSchema,
+  qnaWithAiQuestionTranslationSchema,
   queryOutputSchema,
   questionCentricTranslationsSchema,
   questionOptionSchema,
@@ -2146,6 +2246,7 @@ export {
   responseSchema,
   schedulerProviderSchema,
   schedulerQuestionSchema,
+  schedulerQuestionTranslationSchema,
   sectionLayoutSchema,
   sectionLayoutVariantSchema,
   sectionSchema,
@@ -2157,6 +2258,7 @@ export {
   shortAnswerQuestionTranslationSchema,
   signatureModeSchema,
   signatureQuestionSchema,
+  signatureQuestionTranslationSchema,
   singleChoiceQuestionTranslationSchema,
   splitLayoutSchema,
   stackLayoutSchema,
@@ -2180,6 +2282,7 @@ export {
   videoAttachmentSchema,
   videoAudioModeSchema,
   videoAudioQuestionSchema,
+  videoAudioQuestionTranslationSchema,
   visibilityConditionSchema,
   wallpaperLayoutSchema,
   websiteQuestionSchema,