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

package/dist/esm/index.js

@@ -11,7 +11,9 @@ var baseQuestionTranslationFieldsSchema = z.object({
   title: translationEntrySchema.describe("Question title translation"),
   description: translationEntrySchema.optional().describe("Question description translation"),
   errorMessage: translationEntrySchema.optional().describe("Error message translation"),
-  nextButtonLabel: translationEntrySchema.max(50).optional().describe("Next button label translation when advancing past this question")
+  nextButtonLabel: translationEntrySchema.max(50).optional().describe(
+    "Next button label translation when advancing past this question"
+  )
 });
 var BASE_QUESTION_TRANSLATION_KEYS = [
   "type",
@@ -33,9 +35,13 @@ var singleChoiceQuestionTranslationSchema = baseQuestionTranslationFieldsSchema.
     const additionalKeys = Object.keys(data).filter(
       (key) => ![...BASE_QUESTION_TRANSLATION_KEYS, "placeholder"].includes(key)
     );
-    return additionalKeys.every((key) => /^option\..+\.(label|value)$/.test(key));
+    return additionalKeys.every(
+      (key) => /^option\..+\.(label|value)$/.test(key)
+    );
   },
-  { message: "Additional keys must follow the pattern 'option.{id}.{label|value}'" }
+  {
+    message: "Additional keys must follow the pattern 'option.{id}.{label|value}'"
+  }
 ).describe("Translation schema for single choice questions");
 var multipleChoiceQuestionTranslationSchema = baseQuestionTranslationFieldsSchema.extend({
   type: z.literal("multiple_choice_multiple").describe("Question type identifier"),
@@ -45,9 +51,13 @@ var multipleChoiceQuestionTranslationSchema = baseQuestionTranslationFieldsSchem
     const additionalKeys = Object.keys(data).filter(
       (key) => ![...BASE_QUESTION_TRANSLATION_KEYS, "placeholder"].includes(key)
     );
-    return additionalKeys.every((key) => /^option\..+\.(label|value)$/.test(key));
+    return additionalKeys.every(
+      (key) => /^option\..+\.(label|value)$/.test(key)
+    );
   },
-  { message: "Additional keys must follow the pattern 'option.{id}.{label|value}'" }
+  {
+    message: "Additional keys must follow the pattern 'option.{id}.{label|value}'"
+  }
 ).describe("Translation schema for multiple choice questions");
 var npsQuestionTranslationSchema = baseQuestionTranslationFieldsSchema.extend({
   type: z.literal("nps").describe("Question type identifier"),
@@ -56,11 +66,15 @@ var npsQuestionTranslationSchema = baseQuestionTranslationFieldsSchema.extend({
 }).catchall(translationEntrySchema).refine(
   (data) => {
     const additionalKeys = Object.keys(data).filter(
-      (key) => ![...BASE_QUESTION_TRANSLATION_KEYS, "minLabel", "maxLabel"].includes(key)
+      (key) => ![...BASE_QUESTION_TRANSLATION_KEYS, "minLabel", "maxLabel"].includes(
+        key
+      )
     );
     return additionalKeys.every((key) => /^scaleLabel\.\d+$/.test(key));
   },
-  { message: "Additional keys must follow the pattern 'scaleLabel.{number}'" }
+  {
+    message: "Additional keys must follow the pattern 'scaleLabel.{number}'"
+  }
 ).describe("Translation schema for NPS questions");
 var shortAnswerQuestionTranslationSchema = baseQuestionTranslationFieldsSchema.extend({
   type: z.literal("short_answer").describe("Question type identifier"),
@@ -70,6 +84,61 @@ 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 paymentsUpiQuestionTranslationSchema = baseQuestionTranslationFieldsSchema.extend({
+  type: z.literal("payments_upi").describe("Question type identifier"),
+  qrLabel: z.string().max(100).optional().describe("Label shown above the UPI QR code"),
+  openUpiAppLabel: z.string().max(80).optional().describe("UPI intent button label"),
+  copyUpiIdLabel: z.string().max(80).optional().describe("Copy UPI ID button label"),
+  transactionIdLabel: z.string().max(100).optional().describe("Transaction ID / UTR input label"),
+  transactionIdPlaceholder: z.string().max(120).optional().describe("Transaction ID / UTR input placeholder")
+}).describe("Translation schema for payments_upi questions");
 var nestedSelectionQuestionTranslationSchema = baseQuestionTranslationFieldsSchema.extend({
   type: z.literal("nested_selection").describe("Question type identifier"),
   placeholder: translationEntrySchema.optional().describe("Dropdown placeholder translation")
@@ -78,9 +147,13 @@ var nestedSelectionQuestionTranslationSchema = baseQuestionTranslationFieldsSche
     const additionalKeys = Object.keys(data).filter(
       (key) => ![...BASE_QUESTION_TRANSLATION_KEYS, "placeholder"].includes(key)
     );
-    return additionalKeys.every((key) => /^nestedOption\..+\.(label|hint)$/.test(key));
+    return additionalKeys.every(
+      (key) => /^nestedOption\..+\.(label|hint)$/.test(key)
+    );
   },
-  { message: "Additional keys must follow the pattern 'nestedOption.{id}.{label|hint}'" }
+  {
+    message: "Additional keys must follow the pattern 'nestedOption.{id}.{label|hint}'"
+  }
 ).describe("Translation schema for nested selection questions");
 var annotationQuestionTranslationSchema = baseQuestionTranslationFieldsSchema.extend({
   type: z.literal("annotation").describe("Question type identifier"),
@@ -98,7 +171,9 @@ var messagePanelQuestionTranslationSchema = baseQuestionTranslationFieldsSchema.
 }).describe("Translation schema for message panel questions");
 var consentQuestionTranslationSchema = baseQuestionTranslationFieldsSchema.extend({
   type: z.literal("consent").describe("Question type identifier")
-}).describe("Translation schema for consent questions; description carries the translated checkbox label (markdown supported)");
+}).describe(
+  "Translation schema for consent questions; description carries the translated checkbox label (markdown supported)"
+);
 var yesNoQuestionTranslationSchema = baseQuestionTranslationFieldsSchema.extend({
   type: z.literal("yes_no").describe("Question type identifier"),
   yesLabel: translationEntrySchema.optional().describe("Translated Yes label"),
@@ -115,9 +190,11 @@ var ratingMatrixQuestionTranslationSchema = baseQuestionTranslationFieldsSchema.
 }).catchall(translationEntrySchema).refine(
   (data) => {
     const additionalKeys = Object.keys(data).filter(
-      (key) => ![...BASE_QUESTION_TRANSLATION_KEYS, "minLabel", "maxLabel"].includes(
-        key
-      )
+      (key) => ![
+        ...BASE_QUESTION_TRANSLATION_KEYS,
+        "minLabel",
+        "maxLabel"
+      ].includes(key)
     );
     return additionalKeys.every(
       (key) => /^statement\..+\.label$/.test(key) || /^scalePoint\..+\.label$/.test(key)
@@ -164,6 +241,12 @@ var questionTranslationSchema = z.union([
   npsQuestionTranslationSchema,
   shortAnswerQuestionTranslationSchema,
   longAnswerQuestionTranslationSchema,
+  videoAudioQuestionTranslationSchema,
+  dateQuestionTranslationSchema,
+  signatureQuestionTranslationSchema,
+  schedulerQuestionTranslationSchema,
+  qnaWithAiQuestionTranslationSchema,
+  paymentsUpiQuestionTranslationSchema,
   nestedSelectionQuestionTranslationSchema,
   annotationQuestionTranslationSchema,
   welcomeQuestionTranslationSchema,
@@ -183,8 +266,12 @@ var sectionTranslationSchema = z.object({
 }).describe("Translation payload for a section in a single language");
 var sectionTranslationsByLanguageSchema = z.record(languageCodeSchema, sectionTranslationSchema).describe("Section translations keyed by language code");
 var questionTranslationsByLanguageSchema = z.record(languageCodeSchema, questionTranslationSchema).describe("Question translations keyed by language code");
-var questionCentricTranslationsSchema = z.record(z.string().uuid(), questionTranslationsByLanguageSchema).describe("Question-centric translations keyed by question ID, then by language code");
-var translationsSchema = questionCentricTranslationsSchema.describe("Question-centric translations at root level");
+var questionCentricTranslationsSchema = z.record(z.string().uuid(), questionTranslationsByLanguageSchema).describe(
+  "Question-centric translations keyed by question ID, then by language code"
+);
+var translationsSchema = questionCentricTranslationsSchema.describe(
+  "Question-centric translations at root level"
+);
 var _TranslationProvider = class _TranslationProvider {
   constructor(translations, defaultLanguage = "en") {
     this.translations = translations;
@@ -206,7 +293,10 @@ var _TranslationProvider = class _TranslationProvider {
    * Get a specific translation text by field path
    */
   getTranslationText(questionId, languageCode, fieldPath) {
-    const questionTranslation = this.getQuestionTranslations(questionId, languageCode);
+    const questionTranslation = this.getQuestionTranslations(
+      questionId,
+      languageCode
+    );
     if (!questionTranslation) return null;
     if (fieldPath in questionTranslation) {
       const value = questionTranslation[fieldPath];
@@ -309,7 +399,8 @@ var questionTypeSchema = z2.enum([
   "address",
   "video_audio",
   "scheduler",
-  "qna_with_ai"
+  "qna_with_ai",
+  "payments_upi"
 ]).describe("Enumeration of all supported question types for form fields");
 var QuestionTypes = {
   RATING: "rating",
@@ -343,7 +434,8 @@ var QuestionTypes = {
   ADDRESS: "address",
   VIDEO_AUDIO: "video_audio",
   SCHEDULER: "scheduler",
-  QNA_WITH_AI: "qna_with_ai"
+  QNA_WITH_AI: "qna_with_ai",
+  PAYMENTS_UPI: "payments_upi"
 };
 var validationRuleTypeSchema = z2.enum([
   "required",
@@ -395,7 +487,9 @@ var VisibilityConditionOperators = {
 };
 var visibilityConditionSchema = z2.object({
   field: z2.string().describe("ID of the field to check against"),
-  operator: visibilityConditionOperatorSchema.describe("Comparison operator for the condition"),
+  operator: visibilityConditionOperatorSchema.describe(
+    "Comparison operator for the condition"
+  ),
   value: z2.union([z2.string(), z2.number(), z2.boolean()]).optional().describe("Value to compare against (string, number, or boolean)"),
   describe: z2.string().max(500).optional().describe("LLM tool call description for this visibility condition")
 }).describe(
@@ -418,7 +512,9 @@ var sectionSchema = z2.object({
     "When the global previousButton mode is 'auto', controls whether the Previous button is shown for this section. Defaults to false (hidden)."
   ),
   questionIds: z2.array(z2.string()).min(1).describe("Array of question IDs that belong to this section")
-}).describe("Schema defining sections that organize questions into logical groups");
+}).describe(
+  "Schema defining sections that organize questions into logical groups"
+);
 var questionStatusSchema = z2.enum(["D", "P", "A", "S"]);
 var QuestionStatuses = {
   DRAFT: "D",
@@ -525,7 +621,13 @@ 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'"),
@@ -549,7 +651,9 @@ var welcomeQuestionSchema = questionSchema.extend({
   title: z2.string().min(1).max(200).describe("The main heading displayed on the welcome screen"),
   description: z2.string().max(1e3).optional().describe("Optional sub-text body shown below the heading"),
   imageUrl: z2.string().url().optional().describe("Optional image URL displayed on the welcome screen")
-}).describe("Schema for a welcome screen displayed at the start or inline within a form");
+}).describe(
+  "Schema for a welcome screen displayed at the start or inline within a form"
+);
 var thankYouQuestionSchema = questionSchema.extend({
   type: z2.literal("thank_you").describe("Must be exactly 'thank_you'"),
   title: z2.string().min(1).max(200).describe("The main heading displayed on the thank you screen"),
@@ -575,10 +679,18 @@ var exitFormQuestionSchema = questionSchema.extend({
 );
 var yesNoQuestionSchema = questionSchema.extend({
   type: z2.literal("yes_no").describe("Must be exactly 'yes_no'"),
-  yesLabel: z2.string().min(1).max(50).optional().describe("Label for the Yes option (defaults to 'Yes' in the UI if omitted)"),
-  noLabel: z2.string().min(1).max(50).optional().describe("Label for the No option (defaults to 'No' in the UI if omitted)"),
-  displayStyle: yesNoDisplayStyleSchema.optional().describe("Layout for the Yes/No controls (horizontal row or vertical stack)")
-}).describe("Schema for yes/no questions with optional custom labels and layout");
+  yesLabel: z2.string().min(1).max(50).optional().describe(
+    "Label for the Yes option (defaults to 'Yes' in the UI if omitted)"
+  ),
+  noLabel: z2.string().min(1).max(50).optional().describe(
+    "Label for the No option (defaults to 'No' in the UI if omitted)"
+  ),
+  displayStyle: yesNoDisplayStyleSchema.optional().describe(
+    "Layout for the Yes/No controls (horizontal row or vertical stack)"
+  )
+}).describe(
+  "Schema for yes/no questions with optional custom labels and layout"
+);
 var consentQuestionSchema = questionSchema.extend({
   type: z2.literal("consent").describe("Must be exactly 'consent'")
 }).describe(
@@ -597,14 +709,18 @@ var RatingMatrixDisplayStyles = {
   BUTTON: "button"
 };
 var ratingMatrixStatementSchema = z2.object({
-  id: z2.string().describe("Unique identifier for this statement (system time milliseconds)"),
+  id: z2.string().describe(
+    "Unique identifier for this statement (system time milliseconds)"
+  ),
   value: z2.string().min(1).max(100).describe("Internal value / export key for this statement"),
   label: z2.string().min(1).max(200).describe("Display text shown to users for this statement"),
   describe: z2.string().max(500).optional().describe("LLM tool call description for this statement")
 }).describe("Schema for an individual statement (row) in a rating matrix");
 var ratingMatrixScalePointSchema = z2.object({
   id: z2.string().describe("Unique identifier for this scale point"),
-  value: z2.union([z2.number(), z2.string()]).describe("Stored response value for this scale point (number or string)"),
+  value: z2.union([z2.number(), z2.string()]).describe(
+    "Stored response value for this scale point (number or string)"
+  ),
   label: z2.string().min(1).max(200).describe("Display label shown for this scale point"),
   describe: z2.string().max(500).optional().describe("LLM tool call description for this scale point")
 }).describe("Schema for a single point on a custom rating scale");
@@ -629,12 +745,16 @@ var ratingMatrixScaleSchema = z2.discriminatedUnion("kind", [
 var ratingMatrixQuestionSchema = questionSchema.extend({
   type: z2.literal("rating_matrix").describe("Must be exactly 'rating_matrix'"),
   statements: z2.array(ratingMatrixStatementSchema).min(1).max(10).describe("Statements (rows) users will rate on the shared scale (1-10)"),
-  scale: ratingMatrixScaleSchema.describe("Scale configuration shared across all statement rows"),
+  scale: ratingMatrixScaleSchema.describe(
+    "Scale configuration shared across all statement rows"
+  ),
   displayStyle: ratingMatrixDisplayStyleSchema.optional().describe(
     "Visual representation of scale points per row (radio buttons, stars, emoji, or buttons)"
   ),
   randomizeStatements: z2.boolean().optional().default(false).describe("Whether to randomize the order of statements")
-}).describe("Schema for rating matrix questions with multiple statements on a shared scale");
+}).describe(
+  "Schema for rating matrix questions with multiple statements on a shared scale"
+);
 var matrixRowSchema = z2.object({
   id: z2.string().describe("Unique identifier for this row (system time milliseconds)"),
   value: z2.string().min(1).max(100).describe("Internal value / export key for this row"),
@@ -653,7 +773,9 @@ var matrixSingleChoiceQuestionSchema = questionSchema.extend({
   columns: z2.array(matrixColumnSchema).min(2).max(10).describe("Column options shared across all rows (2-10 columns)"),
   randomizeRows: z2.boolean().optional().default(false).describe("Whether to randomize the order of rows"),
   randomizeColumns: z2.boolean().optional().default(false).describe("Whether to randomize the order of columns")
-}).describe("Schema for matrix single-choice questions where one column is selected per row");
+}).describe(
+  "Schema for matrix single-choice questions where one column is selected per row"
+);
 var matrixMultipleChoiceQuestionSchema = questionSchema.extend({
   type: z2.literal("matrix_multiple_choice").describe("Must be exactly 'matrix_multiple_choice'"),
   rows: z2.array(matrixRowSchema).min(1).max(20).describe("Row items (1-20 rows)"),
@@ -680,7 +802,9 @@ var questionOptionSchema = z2.object({
   id: z2.string().describe("Unique identifier for this option (system time milliseconds)"),
   value: z2.string().min(1).max(100).describe("The internal value used for this option"),
   label: z2.string().min(1).max(200).describe("The display text shown to users for this option"),
-  hint: z2.string().max(300).optional().describe("Optional short description shown below the option label to help respondents understand what they are selecting or ranking"),
+  hint: z2.string().max(300).optional().describe(
+    "Optional short description shown below the option label to help respondents understand what they are selecting or ranking"
+  ),
   describe: z2.string().max(500).optional().describe(
     "LLM tool call description providing context about this option"
   ),
@@ -688,7 +812,9 @@ var questionOptionSchema = z2.object({
 }).describe("Schema for individual options in choice-based questions");
 var nestedOptionSchema = z2.lazy(
   () => z2.object({
-    id: z2.string().describe("Unique identifier for this nested option (system time milliseconds)"),
+    id: z2.string().describe(
+      "Unique identifier for this nested option (system time milliseconds)"
+    ),
     value: z2.string().min(1).max(100).describe("The internal value used for this nested option"),
     label: z2.string().min(1).max(200).describe("The display text shown for this nested option"),
     describe: z2.string().max(500).optional().describe("LLM tool call description for this nested option context"),
@@ -707,7 +833,9 @@ var multipleChoiceSingleQuestionSchema = questionSchema.extend({
     minChars: z2.number().int().min(0).optional().describe("Minimum number of characters required for the other text"),
     maxChars: z2.number().int().min(1).optional().describe("Maximum number of characters allowed for the other text"),
     placeholder: z2.string().max(200).optional().describe("Placeholder text for the other text input"),
-    showLimitIndicatorThreshold: z2.number().int().min(0).optional().describe("Show the character limit indicator (e.g. '12/100') once the user has typed this many characters; 0 = show immediately, absent = never show")
+    showLimitIndicatorThreshold: z2.number().int().min(0).optional().describe(
+      "Show the character limit indicator (e.g. '12/100') once the user has typed this many characters; 0 = show immediately, absent = never show"
+    )
   }).optional().describe('Configuration for the custom "other" text input'),
   randomizeOptions: z2.boolean().optional().default(false).describe("Whether to randomize the order of options"),
   options: z2.array(questionOptionSchema).min(1).max(50).describe("Array of options for user selection (1-50 options)")
@@ -720,7 +848,9 @@ var multipleChoiceMultipleQuestionSchema = questionSchema.extend({
     minChars: z2.number().int().min(0).optional().describe("Minimum number of characters required for the other text"),
     maxChars: z2.number().int().min(1).optional().describe("Maximum number of characters allowed for the other text"),
     placeholder: z2.string().max(200).optional().describe("Placeholder text for the other text input"),
-    showLimitIndicatorThreshold: z2.number().int().min(0).optional().describe("Show the character limit indicator (e.g. '12/100') once the user has typed this many characters; 0 = show immediately, absent = never show")
+    showLimitIndicatorThreshold: z2.number().int().min(0).optional().describe(
+      "Show the character limit indicator (e.g. '12/100') once the user has typed this many characters; 0 = show immediately, absent = never show"
+    )
   }).optional().describe('Configuration for the custom "other" text input'),
   minSelections: z2.number().int().min(0).optional().describe("Minimum number of options that must be selected"),
   maxSelections: z2.number().int().min(1).optional().describe("Maximum number of options that can be selected"),
@@ -749,9 +879,15 @@ var npsQuestionSchema = questionSchema.extend({
   maxLabel: z2.string().max(100).optional().describe("Label for the maximum NPS value (10)"),
   scaleLabels: z2.record(z2.string().regex(/^\d+$/), z2.string().max(50)).optional().describe("Custom labels for specific NPS values (0-10)"),
   prepopulatedValue: z2.number().int().min(0).max(10).optional().describe("Default value to pre-select (0-10)"),
-  detractorColor: z2.string().max(50).optional().describe("Color applied to detractor scores (0\u20136); accepts any valid CSS color value (hex, rgb, hsl, named)"),
-  passiveColor: z2.string().max(50).optional().describe("Color applied to passive scores (7\u20138); accepts any valid CSS color value"),
-  promoterColor: z2.string().max(50).optional().describe("Color applied to promoter scores (9\u201310); accepts any valid CSS color value")
+  detractorColor: z2.string().max(50).optional().describe(
+    "Color applied to detractor scores (0\u20136); accepts any valid CSS color value (hex, rgb, hsl, named)"
+  ),
+  passiveColor: z2.string().max(50).optional().describe(
+    "Color applied to passive scores (7\u20138); accepts any valid CSS color value"
+  ),
+  promoterColor: z2.string().max(50).optional().describe(
+    "Color applied to promoter scores (9\u201310); accepts any valid CSS color value"
+  )
 }).refine(
   (data) => {
     if (data.scaleLabels) {
@@ -772,7 +908,9 @@ var shortAnswerQuestionSchema = questionSchema.extend({
   type: z2.literal("short_answer").describe("Must be exactly 'short_answer'"),
   maxCharacters: z2.number().int().min(1).max(1e4).optional().describe("Maximum number of characters allowed"),
   minCharacters: z2.number().int().min(0).optional().describe("Minimum number of characters required"),
-  showLimitIndicatorThreshold: z2.number().int().min(0).optional().describe("Show the character limit indicator (e.g. '12/100') once the user has typed this many characters; 0 = show immediately, absent = never show"),
+  showLimitIndicatorThreshold: z2.number().int().min(0).optional().describe(
+    "Show the character limit indicator (e.g. '12/100') once the user has typed this many characters; 0 = show immediately, absent = never show"
+  ),
   placeholder: z2.string().max(200).optional().describe("Placeholder text shown in the input field"),
   enableRegexValidation: z2.boolean().optional().default(false).describe("Whether to enable regex pattern validation"),
   regexPattern: z2.string().optional().describe("Regular expression pattern for validation"),
@@ -820,7 +958,9 @@ var longAnswerQuestionSchema = questionSchema.extend({
     "Maximum number of characters allowed (higher limit for long text)"
   ),
   minCharacters: z2.number().int().min(0).optional().describe("Minimum number of characters required"),
-  showLimitIndicatorThreshold: z2.number().int().min(0).optional().describe("Show the character limit indicator (e.g. '12/100') once the user has typed this many characters; 0 = show immediately, absent = never show"),
+  showLimitIndicatorThreshold: z2.number().int().min(0).optional().describe(
+    "Show the character limit indicator (e.g. '12/100') once the user has typed this many characters; 0 = show immediately, absent = never show"
+  ),
   rows: z2.number().int().min(1).max(20).optional().describe("Number of textarea rows to display (1-20)"),
   placeholder: z2.string().max(500).optional().describe("Placeholder text for the textarea (longer for long text)"),
   enableEnhanceWithAi: z2.boolean().optional().default(false).describe("Whether to enable AI enhancement features"),
@@ -903,11 +1043,24 @@ var dateQuestionSchema = questionSchema.extend({
   format: dateFormatSchema.optional().default("DD/MM/YYYY").describe("Order of day, month, and year segments in the input"),
   separator: dateSeparatorSchema.optional().default("/").describe("Character used to separate day, month, and year segments"),
   includeTime: z2.boolean().optional().default(false).describe("Whether to also collect a time (HH:MM) alongside the date"),
-  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"),
+  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"),
-  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");
+  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([
   z2.literal(2),
   z2.literal(3),
@@ -927,23 +1080,53 @@ var CsatDisplayStyles = {
 };
 var csatQuestionSchema = questionSchema.extend({
   type: z2.literal("csat").describe("Must be exactly 'csat'"),
-  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"),
-  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");
+  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 (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 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"),
-  steps: z2.number().int().min(5).max(11).optional().default(11).describe("Number of points on the scale (5\u201311); default 11 gives a 0\u201310 or 1\u201311 range depending on startValue"),
-  minLabel: z2.string().max(100).optional().describe("Optional label anchoring the low end of the scale (e.g. 'Not at all likely')"),
-  maxLabel: z2.string().max(100).optional().describe("Optional label anchoring the high end of the scale (e.g. 'Extremely likely')")
-}).describe("Schema for an opinion scale question \u2014 a horizontal numeric button scale with configurable range and optional end labels");
-var rankingDisplayStyleSchema = z2.enum(["drag_drop", "dropdown", "up_down"]);
+  steps: z2.number().int().min(5).max(11).optional().default(11).describe(
+    "Number of points on the scale (5\u201311); default 11 gives a 0\u201310 or 1\u201311 range depending on startValue"
+  ),
+  minLabel: z2.string().max(100).optional().describe(
+    "Optional label anchoring the low end of the scale (e.g. 'Not at all likely')"
+  ),
+  maxLabel: z2.string().max(100).optional().describe(
+    "Optional label anchoring the high end of the scale (e.g. 'Extremely likely')"
+  )
+}).describe(
+  "Schema for an opinion scale question \u2014 a horizontal numeric button scale with configurable range and optional end labels"
+);
+var rankingDisplayStyleSchema = z2.enum([
+  "drag_drop",
+  "dropdown",
+  "up_down"
+]);
 var RankingDisplayStyles = {
   DRAG_DROP: "drag_drop",
   DROPDOWN: "dropdown",
@@ -951,32 +1134,54 @@ var RankingDisplayStyles = {
 };
 var rankingQuestionSchema = questionSchema.extend({
   type: z2.literal("ranking").describe("Must be exactly 'ranking'"),
-  options: z2.array(questionOptionSchema).min(2).max(30).describe("List of items to rank (2\u201330 items); each item supports an optional hint for clarification"),
-  randomizeOptions: z2.boolean().optional().default(false).describe("Whether to shuffle item order per respondent to avoid position bias"),
-  displayStyle: rankingDisplayStyleSchema.optional().default("drag_drop").describe("Interaction mode \u2014 drag_drop (default) for drag-and-drop reordering, dropdown for selecting a rank number per item, up_down for arrow button reordering"),
-  maxRank: z2.number().int().min(1).optional().describe("Maximum number of items the respondent must rank (e.g. 3 = 'rank your top 3'); when absent all items must be ranked")
+  options: z2.array(questionOptionSchema).min(2).max(30).describe(
+    "List of items to rank (2\u201330 items); each item supports an optional hint for clarification"
+  ),
+  randomizeOptions: z2.boolean().optional().default(false).describe(
+    "Whether to shuffle item order per respondent to avoid position bias"
+  ),
+  displayStyle: rankingDisplayStyleSchema.optional().default("drag_drop").describe(
+    "Interaction mode \u2014 drag_drop (default) for drag-and-drop reordering, dropdown for selecting a rank number per item, up_down for arrow button reordering"
+  ),
+  maxRank: z2.number().int().min(1).optional().describe(
+    "Maximum number of items the respondent must rank (e.g. 3 = 'rank your top 3'); when absent all items must be ranked"
+  )
 }).refine(
   (data) => data.maxRank === void 0 || data.maxRank <= data.options.length,
   {
     message: "maxRank cannot exceed the number of options",
     path: ["maxRank"]
   }
-).describe("Schema for a ranking question where respondents order items by preference");
+).describe(
+  "Schema for a ranking question where respondents order items by preference"
+);
 var pictureChoiceQuestionSchema = questionSchema.extend({
   type: z2.literal("picture_choice").describe("Must be exactly 'picture_choice'"),
-  options: z2.array(questionOptionSchema).min(1).max(50).describe("Array of options; each should include an imageUrl for the picture to display"),
-  multiple: z2.boolean().optional().default(false).describe("When true respondents may select more than one image; when false (default) only one image can be selected"),
-  minSelections: z2.number().int().min(1).optional().describe("Minimum number of images the respondent must select (only applies when multiple is true)"),
-  maxSelections: z2.number().int().min(1).optional().describe("Maximum number of images the respondent may select (only applies when multiple is true)"),
+  options: z2.array(questionOptionSchema).min(1).max(50).describe(
+    "Array of options; each should include an imageUrl for the picture to display"
+  ),
+  multiple: z2.boolean().optional().default(false).describe(
+    "When true respondents may select more than one image; when false (default) only one image can be selected"
+  ),
+  minSelections: z2.number().int().min(1).optional().describe(
+    "Minimum number of images the respondent must select (only applies when multiple is true)"
+  ),
+  maxSelections: z2.number().int().min(1).optional().describe(
+    "Maximum number of images the respondent may select (only applies when multiple is true)"
+  ),
   supersize: z2.boolean().optional().default(false).describe("Whether to display images at an enlarged size"),
   showLabels: z2.boolean().optional().default(true).describe("Whether to show the text label below each image"),
-  randomizeOptions: z2.boolean().optional().default(false).describe("Whether to shuffle image order per respondent to avoid position bias"),
+  randomizeOptions: z2.boolean().optional().default(false).describe(
+    "Whether to shuffle image order per respondent to avoid position bias"
+  ),
   allowOther: z2.boolean().optional().default(false).describe('Whether to include a free-text "other" option'),
   otherTextConfig: z2.object({
     minChars: z2.number().int().min(0).optional().describe("Minimum number of characters required for the other text"),
     maxChars: z2.number().int().min(1).optional().describe("Maximum number of characters allowed for the other text"),
     placeholder: z2.string().max(200).optional().describe("Placeholder text for the other text input"),
-    showLimitIndicatorThreshold: z2.number().int().min(0).optional().describe("Show the character limit indicator once the user has typed this many characters; 0 = show immediately, absent = never show")
+    showLimitIndicatorThreshold: z2.number().int().min(0).optional().describe(
+      "Show the character limit indicator once the user has typed this many characters; 0 = show immediately, absent = never show"
+    )
   }).optional().describe('Configuration for the custom "other" text input')
 }).refine(
   (data) => {
@@ -989,7 +1194,9 @@ var pictureChoiceQuestionSchema = questionSchema.extend({
     message: "minSelections cannot be greater than maxSelections",
     path: ["minSelections"]
   }
-).describe("Schema for a picture choice question where respondents select from image-based options");
+).describe(
+  "Schema for a picture choice question where respondents select from image-based options"
+);
 var signatureModeSchema = z2.enum(["type", "draw", "upload"]);
 var SignatureModes = {
   TYPE: "type",
@@ -998,87 +1205,216 @@ var SignatureModes = {
 };
 var signatureQuestionSchema = questionSchema.extend({
   type: z2.literal("signature").describe("Must be exactly 'signature'"),
-  allowedModes: z2.array(signatureModeSchema).min(1).optional().describe("Which signing methods the respondent can choose from (type, draw, upload); when absent all three are enabled"),
-  defaultMode: signatureModeSchema.optional().describe("Which signing tab is pre-selected when the question is first shown; when absent the platform chooses"),
-  collectSignerEmail: z2.boolean().optional().default(true).describe("Whether to auto-collect the signer's email so a signed PDF copy can be sent to them; set to false if the form already collects an email via signerEmailFieldId or another question"),
-  signerEmailFieldId: z2.string().optional().describe("ID of an existing email question in the form whose value will be used as the signer's email address, instead of auto-appending a new email prompt"),
-  penColor: z2.string().max(50).optional().describe("Stroke color for the draw canvas; any valid CSS color; when absent the theme foreground color is used"),
-  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")
-}).describe("Schema for a signature question where respondents can type, draw, or upload their electronic signature");
+  allowedModes: z2.array(signatureModeSchema).min(1).optional().describe(
+    "Which signing methods the respondent can choose from (type, draw, upload); when absent all three are enabled"
+  ),
+  defaultMode: signatureModeSchema.optional().describe(
+    "Which signing tab is pre-selected when the question is first shown; when absent the platform chooses"
+  ),
+  collectSignerEmail: z2.boolean().optional().default(true).describe(
+    "Whether to auto-collect the signer's email so a signed PDF copy can be sent to them; set to false if the form already collects an email via signerEmailFieldId or another question"
+  ),
+  signerEmailFieldId: z2.string().optional().describe(
+    "ID of an existing email question in the form whose value will be used as the signer's email address, instead of auto-appending a new email prompt"
+  ),
+  penColor: z2.string().max(50).optional().describe(
+    "Stroke color for the draw canvas; any valid CSS color; when absent the theme foreground color is used"
+  ),
+  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"
+  ),
+  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'"),
-  allowedFileTypes: z2.array(z2.string()).min(1).optional().describe("MIME types and/or file extensions the respondent is allowed to upload (e.g. ['image/jpeg', '.pdf']); when absent all file types are accepted"),
-  maxFileSizeMb: z2.number().int().min(1).max(100).optional().describe("Maximum size per uploaded file in megabytes (1\u2013100); when absent the platform enforces its own ceiling"),
-  multiple: z2.boolean().optional().default(false).describe("When true the respondent may upload more than one file in a single question; when false (default) only one file is accepted"),
-  maxFiles: z2.number().int().min(1).max(20).optional().describe("Maximum number of files the respondent may upload (1\u201320); only applies when multiple is true; when absent no per-question file count limit is enforced"),
-  placeholder: z2.string().max(200).optional().describe("Text shown inside the upload dropzone to guide respondents (e.g. 'Drop your CV here or click to browse')")
-}).describe("Schema for a file upload question where respondents can attach one or more files from their device");
+  allowedFileTypes: z2.array(z2.string()).min(1).optional().describe(
+    "MIME types and/or file extensions the respondent is allowed to upload (e.g. ['image/jpeg', '.pdf']); when absent all file types are accepted"
+  ),
+  maxFileSizeMb: z2.number().int().min(1).max(100).optional().describe(
+    "Maximum size per uploaded file in megabytes (1\u2013100); when absent the platform enforces its own ceiling"
+  ),
+  multiple: z2.boolean().optional().default(false).describe(
+    "When true the respondent may upload more than one file in a single question; when false (default) only one file is accepted"
+  ),
+  maxFiles: z2.number().int().min(1).max(20).optional().describe(
+    "Maximum number of files the respondent may upload (1\u201320); only applies when multiple is true; when absent no per-question file count limit is enforced"
+  ),
+  placeholder: z2.string().max(200).optional().describe(
+    "Text shown inside the upload dropzone to guide respondents (e.g. 'Drop your CV here or click to browse')"
+  )
+}).describe(
+  "Schema for a file upload question where respondents can attach one or more files from their device"
+);
 var emailQuestionSchema = questionSchema.extend({
   type: z2.literal("email").describe("Must be exactly 'email'"),
   placeholder: z2.string().max(200).optional().describe("Placeholder text shown inside the email input"),
-  prepopulatedValue: z2.string().optional().describe("Default email address to pre-fill the input (e.g. passed via URL param or hidden field)")
-}).describe("Schema for an email question that only accepts correctly formatted email addresses");
+  prepopulatedValue: z2.string().optional().describe(
+    "Default email address to pre-fill the input (e.g. passed via URL param or hidden field)"
+  )
+}).describe(
+  "Schema for an email question that only accepts correctly formatted email addresses"
+);
 var numberQuestionSchema = questionSchema.extend({
   type: z2.literal("number").describe("Must be exactly 'number'"),
-  min: z2.number().optional().describe("Minimum allowed value (inclusive); when absent no lower bound is enforced"),
-  max: z2.number().optional().describe("Maximum allowed value (inclusive); when absent no upper bound is enforced"),
-  allowDecimal: z2.boolean().optional().default(false).describe("Whether decimal (non-integer) values are accepted; Typeform restricts to whole numbers only, making this a differentiator"),
-  allowNegative: z2.boolean().optional().default(false).describe("Whether negative values are accepted; Typeform restricts to positive numbers only, making this a differentiator"),
+  min: z2.number().optional().describe(
+    "Minimum allowed value (inclusive); when absent no lower bound is enforced"
+  ),
+  max: z2.number().optional().describe(
+    "Maximum allowed value (inclusive); when absent no upper bound is enforced"
+  ),
+  allowDecimal: z2.boolean().optional().default(false).describe(
+    "Whether decimal (non-integer) values are accepted; Typeform restricts to whole numbers only, making this a differentiator"
+  ),
+  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,
   {
     message: "min cannot be greater than max",
     path: ["min"]
   }
-).describe("Schema for a number question that only accepts numeric input with configurable range and format constraints");
+).describe(
+  "Schema for a number question that only accepts numeric input with configurable range and format constraints"
+);
 var websiteQuestionSchema = questionSchema.extend({
   type: z2.literal("website").describe("Must be exactly 'website'"),
-  placeholder: z2.string().max(200).optional().describe("Placeholder text shown inside the URL input (e.g. 'https://yoursite.com')"),
+  placeholder: z2.string().max(200).optional().describe(
+    "Placeholder text shown inside the URL input (e.g. 'https://yoursite.com')"
+  ),
   prepopulatedValue: z2.string().optional().describe("Default URL to pre-fill the input")
-}).describe("Schema for a website question that collects a URL with built-in format validation");
+}).describe(
+  "Schema for a website question that collects a URL with built-in format validation"
+);
 var phoneNumberQuestionSchema = questionSchema.extend({
   type: z2.literal("phone_number").describe("Must be exactly 'phone_number'"),
-  defaultCountryCode: z2.string().max(2).optional().describe("ISO 3166-1 alpha-2 country code to pre-select in the country picker (e.g. 'US', 'IN'); when absent the platform uses the device/locale default"),
-  allowCountryChange: z2.boolean().optional().default(true).describe("Whether the respondent can change the country code; when false the default country is locked"),
+  defaultCountryCode: z2.string().max(2).optional().describe(
+    "ISO 3166-1 alpha-2 country code to pre-select in the country picker (e.g. 'US', 'IN'); when absent the platform uses the device/locale default"
+  ),
+  allowCountryChange: z2.boolean().optional().default(true).describe(
+    "Whether the respondent can change the country code; when false the default country is locked"
+  ),
   placeholder: z2.string().max(200).optional().describe("Placeholder text shown inside the phone number input"),
-  prepopulatedValue: z2.string().optional().describe("Default phone number to pre-fill the input; E.164 format recommended (e.g. '+14155552671')")
-}).describe("Schema for a phone number question with country code picker and country-specific format validation");
+  prepopulatedValue: z2.string().optional().describe(
+    "Default phone number to pre-fill the input; E.164 format recommended (e.g. '+14155552671')"
+  )
+}).describe(
+  "Schema for a phone number question with country code picker and country-specific format validation"
+);
 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'"),
   addressLine1: addressSubFieldConfigSchema.optional().describe("Configuration for the primary street address line"),
-  addressLine2: addressSubFieldConfigSchema.optional().describe("Configuration for the secondary address line (apartment, suite, etc.); hidden by default"),
+  addressLine2: addressSubFieldConfigSchema.optional().describe(
+    "Configuration for the secondary address line (apartment, suite, etc.); hidden by default"
+  ),
   city: addressSubFieldConfigSchema.optional().describe("Configuration for the city/town sub-field"),
   stateProvince: addressSubFieldConfigSchema.optional().describe("Configuration for the state, region, or province sub-field"),
   postalCode: addressSubFieldConfigSchema.optional().describe("Configuration for the ZIP/postal code sub-field"),
   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"]);
+  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", "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"),
-  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");
+  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 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",
@@ -1086,21 +1422,123 @@ var SchedulerProviders = {
 };
 var schedulerQuestionSchema = questionSchema.extend({
   type: z2.literal("scheduler").describe("Must be exactly 'scheduler'"),
-  provider: schedulerProviderSchema.optional().describe("Which calendar integration to use (google_calendar or calendly); when absent the platform uses whatever is connected"),
-  calendarId: z2.string().optional().describe("Specific Google Calendar ID or Calendly event-type URL/slug to book from; when absent the default calendar or event type is used"),
-  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")
-}).describe("Schema for a scheduler question where respondents book a time slot directly within the form via Google Calendar or Calendly");
+  provider: schedulerProviderSchema.optional().describe(
+    "Which calendar integration to use (google_calendar or calendly); when absent the platform uses whatever is connected"
+  ),
+  calendarId: z2.string().optional().describe(
+    "Specific Google Calendar ID or Calendly event-type URL/slug to book from; when absent the default calendar or event type is used"
+  ),
+  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(
+    "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'"),
-  knowledgeBase: z2.string().max(2e4).describe("The knowledge base content the AI draws from when answering respondent questions; Markdown formatting is recommended; up to 20,000 characters"),
-  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")
-}).describe("Schema for a Q&A with AI question where respondents ask questions and receive AI-generated answers drawn from a configurable knowledge base");
+  knowledgeBase: z2.string().max(2e4).describe(
+    "The knowledge base content the AI draws from when answering respondent questions; Markdown formatting is recommended; up to 20,000 characters"
+  ),
+  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"
+  ),
+  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 paymentsUpiAmountConfigSchema = z2.discriminatedUnion("mode", [
+  z2.object({
+    mode: z2.literal("fixed").describe("A fixed amount configured by the form builder"),
+    amount: z2.number().positive().describe("Fixed amount to request in INR")
+  }),
+  z2.object({
+    mode: z2.literal("range").describe("Respondent enters an amount within the configured range"),
+    minAmount: z2.number().positive().describe("Minimum allowed amount in INR"),
+    maxAmount: z2.number().positive().describe("Maximum allowed amount in INR"),
+    defaultAmount: z2.number().positive().optional().describe("Optional initial amount shown to the respondent")
+  }),
+  z2.object({
+    mode: z2.literal("question_mapping").describe("Amount is resolved from a previous question answer"),
+    sourceQuestionId: z2.string().describe(
+      "ID of the prior question whose answer determines the amount"
+    ),
+    mappings: z2.array(
+      z2.object({
+        answerValue: z2.string().describe("Previous question answer value to match"),
+        amount: z2.number().positive().describe("Amount to request in INR when this answer matches"),
+        label: z2.string().max(120).optional().describe("Optional display label for this mapped amount")
+      })
+    ).min(1).describe("Answer-to-amount mappings"),
+    fallbackAmount: z2.number().positive().optional().describe("Optional amount to use when no mapping matches")
+  })
+]).superRefine((data, ctx) => {
+  if (data.mode !== "range") return;
+  if (data.minAmount > data.maxAmount) {
+    ctx.addIssue({
+      code: z2.ZodIssueCode.custom,
+      message: "minAmount cannot be greater than maxAmount",
+      path: ["minAmount"]
+    });
+  }
+  if (data.defaultAmount !== void 0 && (data.defaultAmount < data.minAmount || data.defaultAmount > data.maxAmount)) {
+    ctx.addIssue({
+      code: z2.ZodIssueCode.custom,
+      message: "defaultAmount must be within minAmount and maxAmount",
+      path: ["defaultAmount"]
+    });
+  }
+}).describe("Amount configuration for a payments_upi question");
+var paymentsUpiQuestionSchema = questionSchema.extend({
+  type: z2.literal("payments_upi").describe("Must be exactly 'payments_upi'"),
+  payeeVpa: z2.string().min(3).max(255).regex(
+    /^[\w.\-]+@[\w.\-]+$/,
+    "payeeVpa must be a valid UPI VPA such as merchant@bank"
+  ).describe("UPI virtual payment address that receives the payment"),
+  payeeName: z2.string().max(100).optional().describe("Display name for the UPI payee"),
+  amount: paymentsUpiAmountConfigSchema.describe(
+    "How the requested INR amount is determined"
+  ),
+  transactionNote: z2.string().max(80).optional().describe(
+    "Short note included in the UPI intent; the platform may append the Encatch reference"
+  ),
+  transactionReferencePrefix: z2.string().max(24).optional().describe("Optional prefix for generated Encatch payment references"),
+  qrLabel: z2.string().max(100).optional().describe("Label shown above the UPI QR code"),
+  openUpiAppLabel: z2.string().max(80).optional().describe("Label for the mobile UPI intent button"),
+  copyUpiIdLabel: z2.string().max(80).optional().describe("Label for the copy UPI ID button"),
+  transactionIdLabel: z2.string().max(100).optional().describe("Label for the self-reported transaction ID / UTR input"),
+  transactionIdPlaceholder: z2.string().max(120).optional().describe("Placeholder for the transaction ID / UTR input")
+}).describe(
+  "Schema for a self-reported UPI payment question that renders a UPI QR/intent link and collects the respondent-entered transaction ID"
+);
 var combinedQuestionSchema = z2.discriminatedUnion("type", [
   ratingQuestionSchema,
   annotationQuestionSchema,
@@ -1133,7 +1571,8 @@ var combinedQuestionSchema = z2.discriminatedUnion("type", [
   addressQuestionSchema,
   videoAudioQuestionSchema,
   schedulerQuestionSchema,
-  qnaWithAiQuestionSchema
+  qnaWithAiQuestionSchema,
+  paymentsUpiQuestionSchema
 ]);
 
 // src/schemas/fields/answer-schema.ts
@@ -1150,18 +1589,26 @@ var AnnotationSchema = z3.object({
 });
 var SignatureAnswerSchema = z3.object({
   mode: z3.enum(["type", "draw", "upload"]).describe("The signing method the respondent used"),
-  fileUrl: z3.string().optional().describe("Secure URL to the signature artifact for draw and upload modes"),
+  fileUrl: z3.string().optional().describe(
+    "Secure URL to the signature artifact for draw and upload modes"
+  ),
   typedName: z3.string().optional().describe("The name the respondent typed for type mode")
 }).describe("Answer for a signature question");
 var FileUploadAnswerItemSchema = z3.object({
   fileUrl: z3.string().describe("Secure URL to the uploaded file"),
   fileName: z3.string().describe("Original filename as provided by the respondent"),
   fileSizeMb: z3.number().describe("File size in megabytes"),
-  mimeType: z3.string().optional().describe("MIME type of the uploaded file (e.g. 'application/pdf', 'image/jpeg')")
+  mimeType: z3.string().optional().describe(
+    "MIME type of the uploaded file (e.g. 'application/pdf', 'image/jpeg')"
+  )
 }).describe("Metadata for a single uploaded file");
-var FileUploadAnswerSchema = z3.array(FileUploadAnswerItemSchema).describe("Answer for a file upload question; array supports single and multiple file uploads");
+var FileUploadAnswerSchema = z3.array(FileUploadAnswerItemSchema).describe(
+  "Answer for a file upload question; array supports single and multiple file uploads"
+);
 var PhoneNumberAnswerSchema = z3.object({
-  countryCode: z3.string().describe("Dialing country code including the + prefix (e.g. '+1', '+91')"),
+  countryCode: z3.string().describe(
+    "Dialing country code including the + prefix (e.g. '+1', '+91')"
+  ),
   number: z3.string().describe("Local phone number without the country code"),
   e164: z3.string().optional().describe("Full phone number in E.164 format (e.g. '+14155552671')")
 }).describe("Answer for a phone number question");
@@ -1174,36 +1621,82 @@ 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({
   question: z3.string().describe("The question the respondent asked"),
   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 QnaWithAiAnswerSchema = z3.array(QnaWithAiPairSchema).describe(
+  "Answer for a qna_with_ai question; ordered transcript of Q&A pairs from the session"
+);
+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 PaymentsUpiAnswerSchema = z3.object({
+  transactionId: z3.string().describe(
+    "Respondent-entered UPI transaction ID / UTR; self-reported and not verified by Encatch"
+  ),
+  encatchPaymentReference: z3.string().describe(
+    "Opaque Encatch-generated reconciliation reference included in the UPI intent"
+  ),
+  amount: z3.number().positive().describe(
+    "INR amount shown to the respondent when the payment instruction was generated"
+  ),
+  currency: z3.literal("INR").describe("Currency for UPI payments"),
+  payeeVpa: z3.string().describe("UPI VPA shown to the respondent"),
+  payeeName: z3.string().optional().describe("Payee display name shown to the respondent"),
+  upiIntentUri: z3.string().optional().describe("Generated UPI intent URI shown to the respondent"),
+  selfReported: z3.literal(true).describe(
+    "Always true: Encatch records this answer but does not verify the payment"
+  )
+}).describe("Answer for a payments_upi 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"),
-  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'),
+  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 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(
     "Annotation object containing file and marker details"
   ),
@@ -1220,37 +1713,68 @@ var AnswerItemSchema = z3.object({
     "For multiple choice questions and single choice questions, this is the value of the other option"
   ),
   // Date question
-  date: z3.string().optional().describe("Answer for a date question; ISO 8601 format (YYYY-MM-DD or YYYY-MM-DDTHH:MM)"),
+  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"),
+  opinionScale: z3.number().optional().describe(
+    "Answer for an opinion scale question; the selected numeric value on the scale"
+  ),
+  // 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"),
+  signature: SignatureAnswerSchema.optional().describe(
+    "Answer for a signature question"
+  ),
   // File upload question
-  fileUpload: FileUploadAnswerSchema.optional().describe("Answer for a file upload question; array supports single and multiple file uploads"),
+  fileUpload: FileUploadAnswerSchema.optional().describe(
+    "Answer for a file upload question; array supports single and multiple file uploads"
+  ),
   // 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
-  phoneNumber: PhoneNumberAnswerSchema.optional().describe("Answer for a phone number question"),
+  phoneNumber: PhoneNumberAnswerSchema.optional().describe(
+    "Answer for a phone number question"
+  ),
   // Address question
-  address: AddressAnswerSchema.optional().describe("Answer for an address question"),
+  address: AddressAnswerSchema.optional().describe(
+    "Answer for an address question"
+  ),
   // Video and audio question
-  videoAudio: VideoAudioAnswerSchema.optional().describe("Answer for a video and audio question"),
+  videoAudio: VideoAudioAnswerSchema.optional().describe(
+    "Answer for a video and audio question"
+  ),
   // Scheduler question
-  scheduler: SchedulerAnswerSchema.optional().describe("Answer for a scheduler question"),
+  scheduler: SchedulerAnswerSchema.optional().describe(
+    "Answer for a scheduler question"
+  ),
   // Q&A with AI question
-  qnaWithAi: QnaWithAiAnswerSchema.optional().describe("Answer for a qna_with_ai question; ordered transcript of Q&A pairs from the session")
+  qnaWithAi: QnaWithAiAnswerSchema.optional().describe(
+    "Answer for a qna_with_ai question; ordered transcript of Q&A pairs from the session"
+  ),
+  // Payments UPI question
+  paymentsUpi: PaymentsUpiAnswerSchema.optional().describe(
+    "Answer for a payments_upi question; self-reported UPI transaction reference"
+  )
 }).describe(
   "Flexible answer item supporting various question types and custom fields"
 );
@@ -1290,6 +1814,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 +2323,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 +2359,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 +2369,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"
 );
@@ -2004,6 +2531,7 @@ export {
   MultipleChoiceMultipleDisplayStyles,
   OtherFieldsSchema,
   OtherFieldsTranslationSchema,
+  PaymentsUpiAnswerSchema,
   PhoneNumberAnswerSchema,
   Positions,
   PreviousButtonModes,
@@ -2055,6 +2583,7 @@ export {
   customEventFieldSchema,
   dateFormatSchema,
   dateQuestionSchema,
+  dateQuestionTranslationSchema,
   dateSeparatorSchema,
   deviceInfoSchema,
   deviceSessionInfoSchema,
@@ -2113,12 +2642,16 @@ export {
   opinionScaleQuestionSchema,
   otherConfigurationPropertiesSchema,
   partialFeedbackSchema,
+  paymentsUpiAmountConfigSchema,
+  paymentsUpiQuestionSchema,
+  paymentsUpiQuestionTranslationSchema,
   phoneNumberQuestionSchema,
   pictureChoiceQuestionSchema,
   positionSchema,
   previousButtonModeSchema,
   publicationStatusSchema,
   qnaWithAiQuestionSchema,
+  qnaWithAiQuestionTranslationSchema,
   queryOutputSchema,
   questionCentricTranslationsSchema,
   questionOptionSchema,
@@ -2146,6 +2679,7 @@ export {
   responseSchema,
   schedulerProviderSchema,
   schedulerQuestionSchema,
+  schedulerQuestionTranslationSchema,
   sectionLayoutSchema,
   sectionLayoutVariantSchema,
   sectionSchema,
@@ -2157,6 +2691,7 @@ export {
   shortAnswerQuestionTranslationSchema,
   signatureModeSchema,
   signatureQuestionSchema,
+  signatureQuestionTranslationSchema,
   singleChoiceQuestionTranslationSchema,
   splitLayoutSchema,
   stackLayoutSchema,
@@ -2180,6 +2715,7 @@ export {
   videoAttachmentSchema,
   videoAudioModeSchema,
   videoAudioQuestionSchema,
+  videoAudioQuestionTranslationSchema,
   visibilityConditionSchema,
   wallpaperLayoutSchema,
   websiteQuestionSchema,