@encatch/schema 1.3.0-beta.3 → 1.3.0-beta.5

package/dist/esm/index.js

@@ -2,7 +2,7 @@ var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 
 // src/schemas/fields/field-schema.ts
-import { z as z3 } from "zod";
+import { z as z4 } from "zod";
 
 // src/schemas/fields/translations-schema.ts
 import { z } from "zod";
@@ -438,8 +438,217 @@ var completionCtaSchema = z2.object({
   "Optional completion CTA configuration for thank_you and exit_form questions; controls what happens after form submission \u2014 redirect, in-app navigation, or dismiss \u2014 with separate settings per rendering surface (inApp / link)"
 );
 
+// src/schemas/fields/answer-schema.ts
+import { z as z3 } from "zod";
+var AnnotationMarkerSchema = z3.object({
+  markerNo: z3.string(),
+  timeline: z3.string(),
+  comment: z3.string()
+});
+var AnnotationSchema = z3.object({
+  fileType: z3.string(),
+  fileName: z3.string(),
+  markers: z3.array(AnnotationMarkerSchema)
+});
+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"
+  ),
+  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')"
+  )
+}).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 PhoneNumberAnswerSchema = z3.object({
+  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");
+var AddressAnswerSchema = z3.object({
+  addressLine1: z3.string().optional().describe("Primary street address line"),
+  addressLine2: z3.string().optional().describe("Secondary address line (apartment, suite, etc.)"),
+  city: z3.string().optional().describe("City or town"),
+  stateProvince: z3.string().optional().describe("State, region, or province"),
+  postalCode: z3.string().optional().describe("ZIP or postal code"),
+  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", "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 (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.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.string().trim().refine((s) => {
+    const n = Number(s);
+    return Number.isFinite(n) && n > 0;
+  }, { message: "Amount must be a positive numeric value" }).describe(
+    "INR amount shown to the respondent when the payment instruction was generated, as a decimal string (legacy numeric values are accepted when parsing)"
+  ),
+  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"),
+  sourceEmail: z3.string().optional().describe("Email address resolved from the configured source email question"),
+  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 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 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"
+  ),
+  ratingMatrix: z3.record(z3.string(), z3.union([z3.number(), z3.string()])).optional().describe(
+    "Rating matrix answers keyed by statement value (export key), value is the selected scale value (number for likert/numerical, string for custom)"
+  ),
+  matrixSingleChoice: z3.record(z3.string(), z3.string()).optional().describe(
+    "Matrix single-choice answers keyed by row value (export key), map value is the selected column option value"
+  ),
+  matrixMultipleChoice: z3.record(z3.string(), z3.array(z3.string())).optional().describe(
+    "Matrix multiple-choice answers keyed by row value (export key), map value is array of selected column option values"
+  ),
+  others: z3.string().optional().describe(
+    "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)"
+  ),
+  // CSAT question
+  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 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
+  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.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"
+  ),
+  // 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"
+  ),
+  // 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"
+  ),
+  // 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"
+);
+var AnswerSchema = AnswerItemSchema;
+
 // src/schemas/fields/field-schema.ts
-var questionTypeSchema = z3.enum([
+var questionTypeSchema = z4.enum([
   "rating",
   "single_choice",
   "nps",
@@ -509,7 +718,7 @@ var QuestionTypes = {
   QNA_WITH_AI: "qna_with_ai",
   PAYMENTS_UPI: "payments_upi"
 };
-var validationRuleTypeSchema = z3.enum([
+var validationRuleTypeSchema = z4.enum([
   "required",
   "min",
   "max",
@@ -531,13 +740,13 @@ var ValidationRuleTypes = {
   URL: "url",
   CUSTOM: "custom"
 };
-var validationRuleSchema = z3.object({
+var validationRuleSchema = z4.object({
   type: validationRuleTypeSchema.describe("Type of validation rule to apply"),
-  value: z3.union([z3.string(), z3.number(), z3.boolean()]).optional().describe("Value for the validation rule (string, number, or boolean)"),
-  message: z3.string().optional().describe("Custom error message when validation fails"),
-  describe: z3.string().max(500).optional().describe("LLM tool call description for this validation rule")
+  value: z4.union([z4.string(), z4.number(), z4.boolean()]).optional().describe("Value for the validation rule (string, number, or boolean)"),
+  message: z4.string().optional().describe("Custom error message when validation fails"),
+  describe: z4.string().max(500).optional().describe("LLM tool call description for this validation rule")
 }).describe("Schema defining validation rules for question responses");
-var visibilityConditionOperatorSchema = z3.enum([
+var visibilityConditionOperatorSchema = z4.enum([
   "equals",
   "not_equals",
   "contains",
@@ -557,44 +766,44 @@ var VisibilityConditionOperators = {
   IS_EMPTY: "is_empty",
   IS_NOT_EMPTY: "is_not_empty"
 };
-var visibilityConditionSchema = z3.object({
-  field: z3.string().describe("ID of the field to check against"),
+var visibilityConditionSchema = z4.object({
+  field: z4.string().describe("ID of the field to check against"),
   operator: visibilityConditionOperatorSchema.describe(
     "Comparison operator for the condition"
   ),
-  value: z3.union([z3.string(), z3.number(), z3.boolean()]).optional().describe("Value to compare against (string, number, or boolean)"),
-  describe: z3.string().max(500).optional().describe("LLM tool call description for this visibility condition")
+  value: z4.union([z4.string(), z4.number(), z4.boolean()]).optional().describe("Value to compare against (string, number, or boolean)"),
+  describe: z4.string().max(500).optional().describe("LLM tool call description for this visibility condition")
 }).describe(
   "Schema defining conditions that control when questions are visible"
 );
-var sectionSchema = z3.object({
-  id: z3.string().describe("Unique identifier for the section"),
-  title: z3.string().min(1).max(200).describe("Display title for the section"),
-  description: z3.string().max(1e3).optional().describe("Optional detailed description or help text for the section"),
-  showTitle: z3.boolean().default(true).describe("Whether to show the section title in the UI"),
-  showDescription: z3.boolean().default(true).describe("Whether to show the section description in the UI"),
-  nextButtonLabel: z3.string().min(1).max(50).optional().describe("Label for the next button when navigating from this section"),
+var sectionSchema = z4.object({
+  id: z4.string().describe("Unique identifier for the section"),
+  title: z4.string().min(1).max(200).describe("Display title for the section"),
+  description: z4.string().max(1e3).optional().describe("Optional detailed description or help text for the section"),
+  showTitle: z4.boolean().default(true).describe("Whether to show the section title in the UI"),
+  showDescription: z4.boolean().default(true).describe("Whether to show the section description in the UI"),
+  nextButtonLabel: z4.string().min(1).max(50).optional().describe("Label for the next button when navigating from this section"),
   translations: sectionTranslationsByLanguageSchema.optional().describe(
     "Per-language section copy (title, optional description and nextButtonLabel), keyed by language code"
   ),
-  inAppSingleQuestion: z3.boolean().default(false).describe(
+  inAppSingleQuestion: z4.boolean().default(false).describe(
     "When true, the native app shows one question at a time within this section"
   ),
-  isPreviousAllowed: z3.boolean().default(false).optional().describe(
+  isPreviousAllowed: z4.boolean().default(false).optional().describe(
     "When the global previousButton mode is 'auto', controls whether the Previous button is shown for this section. Defaults to false (hidden)."
   ),
-  questionIds: z3.array(z3.string()).min(1).describe("Array of question IDs that belong to this section")
+  questionIds: z4.array(z4.string()).min(1).describe("Array of question IDs that belong to this section")
 }).describe(
   "Schema defining sections that organize questions into logical groups"
 );
-var questionStatusSchema = z3.enum(["D", "P", "A", "S"]);
+var questionStatusSchema = z4.enum(["D", "P", "A", "S"]);
 var QuestionStatuses = {
   DRAFT: "D",
   PUBLISHED: "P",
   ARCHIVED: "A",
   SUSPENDED: "S"
 };
-var ratingDisplayStyleSchema = z3.enum([
+var ratingDisplayStyleSchema = z4.enum([
   "star",
   "heart",
   "thumbs-up",
@@ -610,7 +819,7 @@ var RatingDisplayStyles = {
   EMOJI: "emoji",
   EMOJI_EXP: "emoji_exp"
 };
-var ratingRepresentationSizeSchema = z3.enum([
+var ratingRepresentationSizeSchema = z4.enum([
   "small",
   "medium",
   "large"
@@ -620,7 +829,7 @@ var RatingRepresentationSizes = {
   MEDIUM: "medium",
   LARGE: "large"
 };
-var multipleChoiceDisplayStyleSchema = z3.enum([
+var multipleChoiceDisplayStyleSchema = z4.enum([
   "radio",
   "list",
   "chip",
@@ -634,7 +843,7 @@ var MultipleChoiceDisplayStyles = {
   DROPDOWN: "dropdown",
   AUTOSUGGEST: "autosuggest"
 };
-var multipleChoiceMultipleDisplayStyleSchema = z3.enum([
+var multipleChoiceMultipleDisplayStyleSchema = z4.enum([
   "checkbox",
   "list",
   "chip",
@@ -646,12 +855,12 @@ var MultipleChoiceMultipleDisplayStyles = {
   CHIP: "chip",
   AUTOSUGGEST: "autosuggest"
 };
-var yesNoDisplayStyleSchema = z3.enum(["horizontal", "vertical"]);
+var yesNoDisplayStyleSchema = z4.enum(["horizontal", "vertical"]);
 var YesNoDisplayStyles = {
   HORIZONTAL: "horizontal",
   VERTICAL: "vertical"
 };
-var choiceOrderOptionSchema = z3.enum([
+var choiceOrderOptionSchema = z4.enum([
   "randomize",
   "flip",
   "rotate",
@@ -665,74 +874,74 @@ var ChoiceOrderOptions = {
   ASCENDING: "ascending",
   NONE: "none"
 };
-var questionSchema = z3.object({
-  id: z3.string().describe("Unique identifier for the question"),
-  slug: z3.string().min(1).max(128).optional().describe(
+var questionSchema = z4.object({
+  id: z4.string().describe("Unique identifier for the question"),
+  slug: z4.string().min(1).max(128).optional().describe(
     "Optional stable identifier for the question (e.g. URLs, analytics, or integrations)"
   ),
   type: questionTypeSchema.describe(
     "The type of question (rating, single_choice, etc.)"
   ),
-  title: z3.string().min(1).max(200).describe("The main title/question text displayed to users"),
-  description: z3.string().max(1e3).optional().describe("Optional detailed description or help text"),
-  describe: z3.string().max(2e3).optional().describe(
+  title: z4.string().min(1).max(200).describe("The main title/question text displayed to users"),
+  description: z4.string().max(1e3).optional().describe("Optional detailed description or help text"),
+  describe: z4.string().max(2e3).optional().describe(
     "LLM tool call description for better AI understanding and context"
   ),
-  required: z3.boolean().default(false).describe("Whether this question must be answered"),
-  isHidden: z3.boolean().default(false).describe("When true, the question is hidden from the form UI"),
-  errorMessage: z3.string().max(500).optional().describe("Custom error message when validation fails"),
-  validations: z3.array(validationRuleSchema).optional().default([]).describe("Array of validation rules to apply"),
-  visibility: z3.array(visibilityConditionSchema).optional().default([]).describe("Conditions that control when this question is shown"),
-  sectionId: z3.string().optional().describe("ID of the section this question belongs to"),
+  required: z4.boolean().default(false).describe("Whether this question must be answered"),
+  isHidden: z4.boolean().default(false).describe("When true, the question is hidden from the form UI"),
+  errorMessage: z4.string().max(500).optional().describe("Custom error message when validation fails"),
+  validations: z4.array(validationRuleSchema).optional().default([]).describe("Array of validation rules to apply"),
+  visibility: z4.array(visibilityConditionSchema).optional().default([]).describe("Conditions that control when this question is shown"),
+  sectionId: z4.string().optional().describe("ID of the section this question belongs to"),
   status: questionStatusSchema.describe(
     "Current status of the question (Draft, Published, etc.)"
   ),
-  textAlign: z3.enum(["left", "center", "justify"]).optional().default("left").describe(
+  textAlign: z4.enum(["left", "center", "justify"]).optional().default("left").describe(
     "Text alignment for the question title and description; `justify` is intended for consent questions (full-width justified consent body markdown)"
   ),
-  nextButtonLabel: z3.string().min(1).max(50).default("Next").describe(
+  nextButtonLabel: z4.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: z3.boolean().default(true).describe("Whether to display the question title; defaults to true"),
-  questionMediaUrl: z3.string().url().optional().describe(
+  showQuestionTitle: z4.boolean().default(true).describe("Whether to display the question title; defaults to true"),
+  questionMediaUrl: z4.string().url().optional().describe(
     "Optional URL for media (image or video) displayed alongside the question"
   ),
-  questionMediaType: z3.enum(["image", "video", "youtube", "vimeo"]).optional().describe(
+  questionMediaType: z4.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: z3.literal("rating").describe("Must be exactly 'rating'"),
-  showLabels: z3.boolean().optional().describe("Whether to show min/max labels"),
-  minLabel: z3.string().max(100).optional().describe("Label for the minimum rating value"),
-  maxLabel: z3.string().max(100).optional().describe("Label for the maximum rating value"),
+  type: z4.literal("rating").describe("Must be exactly 'rating'"),
+  showLabels: z4.boolean().optional().describe("Whether to show min/max labels"),
+  minLabel: z4.string().max(100).optional().describe("Label for the minimum rating value"),
+  maxLabel: z4.string().max(100).optional().describe("Label for the maximum rating value"),
   displayStyle: ratingDisplayStyleSchema.optional().describe("Visual style for rating display"),
-  numberOfRatings: z3.number().int().min(1).max(10).describe("Number of rating options (1-10)"),
+  numberOfRatings: z4.number().int().min(1).max(10).describe("Number of rating options (1-10)"),
   representationSize: ratingRepresentationSizeSchema.optional().describe("Size of rating visual elements"),
-  color: z3.string().regex(/^#[0-9A-F]{6}$/i, "Must be a valid hex color").optional().describe("Hex color for rating elements")
+  color: z4.string().regex(/^#[0-9A-F]{6}$/i, "Must be a valid hex color").optional().describe("Hex color for rating elements")
 }).describe("Schema for rating questions with customizable display options");
 var annotationQuestionSchema = questionSchema.extend({
-  type: z3.literal("annotation").describe("Must be exactly 'annotation'"),
-  annotationText: z3.string().max(1e3).optional().describe("Text to display when annotation is provided"),
-  noAnnotationText: z3.string().max(500).optional().describe("Text to display when no annotation is provided")
+  type: z4.literal("annotation").describe("Must be exactly 'annotation'"),
+  annotationText: z4.string().max(1e3).optional().describe("Text to display when annotation is provided"),
+  noAnnotationText: z4.string().max(500).optional().describe("Text to display when no annotation is provided")
 }).describe(
   "Schema for annotation questions that provide additional context or instructions"
 );
 var welcomeQuestionSchema = questionSchema.extend({
-  type: z3.literal("welcome").describe("Must be exactly 'welcome'"),
-  title: z3.string().min(1).max(200).describe("The main heading displayed on the welcome screen"),
-  description: z3.string().max(1e3).optional().describe("Optional sub-text body shown below the heading"),
-  imageUrl: z3.string().url().optional().describe("Optional image URL displayed on the welcome screen")
+  type: z4.literal("welcome").describe("Must be exactly 'welcome'"),
+  title: z4.string().min(1).max(200).describe("The main heading displayed on the welcome screen"),
+  description: z4.string().max(1e3).optional().describe("Optional sub-text body shown below the heading"),
+  imageUrl: z4.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"
 );
 var thankYouQuestionSchema = questionSchema.extend({
-  type: z3.literal("thank_you").describe("Must be exactly 'thank_you'"),
-  title: z3.string().min(1).max(200).describe("The main heading displayed on the thank you screen"),
-  description: z3.string().max(1e3).optional().describe(
+  type: z4.literal("thank_you").describe("Must be exactly 'thank_you'"),
+  title: z4.string().min(1).max(200).describe("The main heading displayed on the thank you screen"),
+  description: z4.string().max(1e3).optional().describe(
     "Optional thank you body text; rendered as Markdown where the form supports it"
   ),
-  imageUrl: z3.string().url().optional().describe("Optional image URL displayed on the thank you screen"),
+  imageUrl: z4.string().url().optional().describe("Optional image URL displayed on the thank you screen"),
   completionCta: completionCtaSchema.optional().describe(
     "Optional CTA shown after submission; supports primary + optional secondary buttons with per-surface action routing (inApp / link), and optional auto-trigger timer; when absent the engine falls back to nextButtonLabel as a single dismiss button"
   )
@@ -740,15 +949,15 @@ var thankYouQuestionSchema = questionSchema.extend({
   "Schema for a thank you screen shown at the end or inline within a form"
 );
 var messagePanelQuestionSchema = questionSchema.extend({
-  type: z3.literal("message_panel").describe("Must be exactly 'message_panel'"),
-  title: z3.string().min(1).max(200).describe("The main heading displayed on the message panel"),
-  description: z3.string().max(1e3).optional().describe("Optional body text shown below the heading"),
-  imageUrl: z3.string().url().optional().describe("Optional image URL displayed on the message panel")
+  type: z4.literal("message_panel").describe("Must be exactly 'message_panel'"),
+  title: z4.string().min(1).max(200).describe("The main heading displayed on the message panel"),
+  description: z4.string().max(1e3).optional().describe("Optional body text shown below the heading"),
+  imageUrl: z4.string().url().optional().describe("Optional image URL displayed on the message panel")
 }).describe(
   "Schema for an inline message panel (informational); distinct from welcome for UI semantics and analytics"
 );
 var exitFormQuestionSchema = questionSchema.extend({
-  type: z3.literal("exit_form").describe("Must be exactly 'exit_form'"),
+  type: z4.literal("exit_form").describe("Must be exactly 'exit_form'"),
   completionCta: completionCtaSchema.optional().describe(
     "Optional silent completion action fired when the exit_form terminal is reached; no UI is shown \u2014 use redirect_internal / redirect_external for silent redirects or app_navigate for host routing; autoTriggerDelayMs defaults to 0 (immediate) when a configured action is present"
   )
@@ -756,11 +965,11 @@ var exitFormQuestionSchema = questionSchema.extend({
   "Schema for an exit marker that silently ends the survey; carries no UI and captures no answer \u2014 intended for branch logic paths that should terminate without showing a thank-you screen"
 );
 var yesNoQuestionSchema = questionSchema.extend({
-  type: z3.literal("yes_no").describe("Must be exactly 'yes_no'"),
-  yesLabel: z3.string().min(1).max(50).optional().describe(
+  type: z4.literal("yes_no").describe("Must be exactly 'yes_no'"),
+  yesLabel: z4.string().min(1).max(50).optional().describe(
     "Label for the Yes option (defaults to 'Yes' in the UI if omitted)"
   ),
-  noLabel: z3.string().min(1).max(50).optional().describe(
+  noLabel: z4.string().min(1).max(50).optional().describe(
     "Label for the No option (defaults to 'No' in the UI if omitted)"
   ),
   displayStyle: yesNoDisplayStyleSchema.optional().describe(
@@ -770,11 +979,11 @@ var yesNoQuestionSchema = questionSchema.extend({
   "Schema for yes/no questions with optional custom labels and layout"
 );
 var consentQuestionSchema = questionSchema.extend({
-  type: z3.literal("consent").describe("Must be exactly 'consent'")
+  type: z4.literal("consent").describe("Must be exactly 'consent'")
 }).describe(
   "Schema for a single-checkbox consent question; use description (rendered as markdown) for the checkbox label text and any policy/terms links; answer is boolean (true = checked)"
 );
-var ratingMatrixDisplayStyleSchema = z3.enum([
+var ratingMatrixDisplayStyleSchema = z4.enum([
   "radio",
   "star",
   "emoji",
@@ -786,82 +995,82 @@ var RatingMatrixDisplayStyles = {
   EMOJI: "emoji",
   BUTTON: "button"
 };
-var ratingMatrixStatementSchema = z3.object({
-  id: z3.string().describe(
+var ratingMatrixStatementSchema = z4.object({
+  id: z4.string().describe(
     "Unique identifier for this statement (system time milliseconds)"
   ),
-  value: z3.string().min(1).max(100).describe("Internal value / export key for this statement"),
-  label: z3.string().min(1).max(200).describe("Display text shown to users for this statement"),
-  describe: z3.string().max(500).optional().describe("LLM tool call description for this statement")
+  value: z4.string().min(1).max(100).describe("Internal value / export key for this statement"),
+  label: z4.string().min(1).max(200).describe("Display text shown to users for this statement"),
+  describe: z4.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 = z3.object({
-  id: z3.string().describe("Unique identifier for this scale point"),
-  value: z3.union([z3.number(), z3.string()]).describe(
+var ratingMatrixScalePointSchema = z4.object({
+  id: z4.string().describe("Unique identifier for this scale point"),
+  value: z4.union([z4.number(), z4.string()]).describe(
     "Stored response value for this scale point (number or string)"
   ),
-  label: z3.string().min(1).max(200).describe("Display label shown for this scale point"),
-  describe: z3.string().max(500).optional().describe("LLM tool call description for this scale point")
+  label: z4.string().min(1).max(200).describe("Display label shown for this scale point"),
+  describe: z4.string().max(500).optional().describe("LLM tool call description for this scale point")
 }).describe("Schema for a single point on a custom rating scale");
-var ratingMatrixScaleSchema = z3.discriminatedUnion("kind", [
+var ratingMatrixScaleSchema = z4.discriminatedUnion("kind", [
   // Likert: symmetric ordinal scale -2…+2, explicit scale points with labels
-  z3.object({
-    kind: z3.literal("likert").describe("Symmetric ordinal scale (-2 to +2)"),
-    scalePoints: z3.array(ratingMatrixScalePointSchema).min(2).max(10).describe("Scale points with display labels for each column")
+  z4.object({
+    kind: z4.literal("likert").describe("Symmetric ordinal scale (-2 to +2)"),
+    scalePoints: z4.array(ratingMatrixScalePointSchema).min(2).max(10).describe("Scale points with display labels for each column")
   }),
   // Numerical: 1…N points where N is 2, 3, 4, or 5, explicit scale points with labels
-  z3.object({
-    kind: z3.literal("numerical").describe("Numerical scale from 1 to N"),
-    scalePoints: z3.array(ratingMatrixScalePointSchema).min(2).max(10).describe("Scale points with display labels for each column"),
-    pointCount: z3.union([z3.literal(2), z3.literal(3), z3.literal(4), z3.literal(5)]).describe("Number of scale points (2, 3, 4, or 5)")
+  z4.object({
+    kind: z4.literal("numerical").describe("Numerical scale from 1 to N"),
+    scalePoints: z4.array(ratingMatrixScalePointSchema).min(2).max(10).describe("Scale points with display labels for each column"),
+    pointCount: z4.union([z4.literal(2), z4.literal(3), z4.literal(4), z4.literal(5)]).describe("Number of scale points (2, 3, 4, or 5)")
   }),
   // Custom: consumer defines each point's value and label
-  z3.object({
-    kind: z3.literal("custom").describe("Custom scale with user-defined points and values"),
-    scalePoints: z3.array(ratingMatrixScalePointSchema).min(2).max(10).describe("Scale points with display labels for each column")
+  z4.object({
+    kind: z4.literal("custom").describe("Custom scale with user-defined points and values"),
+    scalePoints: z4.array(ratingMatrixScalePointSchema).min(2).max(10).describe("Scale points with display labels for each column")
   })
 ]).describe("Scale configuration for rating matrix questions");
 var ratingMatrixQuestionSchema = questionSchema.extend({
-  type: z3.literal("rating_matrix").describe("Must be exactly 'rating_matrix'"),
-  statements: z3.array(ratingMatrixStatementSchema).min(1).max(10).describe("Statements (rows) users will rate on the shared scale (1-10)"),
+  type: z4.literal("rating_matrix").describe("Must be exactly 'rating_matrix'"),
+  statements: z4.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"
   ),
   displayStyle: ratingMatrixDisplayStyleSchema.optional().describe(
     "Visual representation of scale points per row (radio buttons, stars, emoji, or buttons)"
   ),
-  randomizeStatements: z3.boolean().optional().default(false).describe("Whether to randomize the order of statements")
+  randomizeStatements: z4.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"
 );
-var matrixRowSchema = z3.object({
-  id: z3.string().describe("Unique identifier for this row (system time milliseconds)"),
-  value: z3.string().min(1).max(100).describe("Internal value / export key for this row"),
-  label: z3.string().min(1).max(200).describe("Display text shown to users for this row"),
-  describe: z3.string().max(500).optional().describe("LLM tool call description for this row")
+var matrixRowSchema = z4.object({
+  id: z4.string().describe("Unique identifier for this row (system time milliseconds)"),
+  value: z4.string().min(1).max(100).describe("Internal value / export key for this row"),
+  label: z4.string().min(1).max(200).describe("Display text shown to users for this row"),
+  describe: z4.string().max(500).optional().describe("LLM tool call description for this row")
 }).describe("Schema for an individual row in a matrix choice question");
-var matrixColumnSchema = z3.object({
-  id: z3.string().describe("Unique identifier for this column (system time milliseconds)"),
-  value: z3.string().min(1).max(100).describe("Internal value / export key for this column"),
-  label: z3.string().min(1).max(200).describe("Display label shown for this column"),
-  describe: z3.string().max(500).optional().describe("LLM tool call description for this column")
+var matrixColumnSchema = z4.object({
+  id: z4.string().describe("Unique identifier for this column (system time milliseconds)"),
+  value: z4.string().min(1).max(100).describe("Internal value / export key for this column"),
+  label: z4.string().min(1).max(200).describe("Display label shown for this column"),
+  describe: z4.string().max(500).optional().describe("LLM tool call description for this column")
 }).describe("Schema for an individual column in a matrix choice question");
 var matrixSingleChoiceQuestionSchema = questionSchema.extend({
-  type: z3.literal("matrix_single_choice").describe("Must be exactly 'matrix_single_choice'"),
-  rows: z3.array(matrixRowSchema).min(1).max(20).describe("Row items (1-20 rows)"),
-  columns: z3.array(matrixColumnSchema).min(2).max(10).describe("Column options shared across all rows (2-10 columns)"),
-  randomizeRows: z3.boolean().optional().default(false).describe("Whether to randomize the order of rows"),
-  randomizeColumns: z3.boolean().optional().default(false).describe("Whether to randomize the order of columns")
+  type: z4.literal("matrix_single_choice").describe("Must be exactly 'matrix_single_choice'"),
+  rows: z4.array(matrixRowSchema).min(1).max(20).describe("Row items (1-20 rows)"),
+  columns: z4.array(matrixColumnSchema).min(2).max(10).describe("Column options shared across all rows (2-10 columns)"),
+  randomizeRows: z4.boolean().optional().default(false).describe("Whether to randomize the order of rows"),
+  randomizeColumns: z4.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"
 );
 var matrixMultipleChoiceQuestionSchema = questionSchema.extend({
-  type: z3.literal("matrix_multiple_choice").describe("Must be exactly 'matrix_multiple_choice'"),
-  rows: z3.array(matrixRowSchema).min(1).max(20).describe("Row items (1-20 rows)"),
-  columns: z3.array(matrixColumnSchema).min(2).max(10).describe("Column options shared across all rows (2-10 columns)"),
-  minSelectionsPerRow: z3.number().int().min(0).optional().describe("Minimum number of columns a user must select per row"),
-  maxSelectionsPerRow: z3.number().int().min(1).optional().describe("Maximum number of columns a user can select per row"),
-  randomizeRows: z3.boolean().optional().default(false).describe("Whether to randomize the order of rows"),
-  randomizeColumns: z3.boolean().optional().default(false).describe("Whether to randomize the order of columns")
+  type: z4.literal("matrix_multiple_choice").describe("Must be exactly 'matrix_multiple_choice'"),
+  rows: z4.array(matrixRowSchema).min(1).max(20).describe("Row items (1-20 rows)"),
+  columns: z4.array(matrixColumnSchema).min(2).max(10).describe("Column options shared across all rows (2-10 columns)"),
+  minSelectionsPerRow: z4.number().int().min(0).optional().describe("Minimum number of columns a user must select per row"),
+  maxSelectionsPerRow: z4.number().int().min(1).optional().describe("Maximum number of columns a user can select per row"),
+  randomizeRows: z4.boolean().optional().default(false).describe("Whether to randomize the order of rows"),
+  randomizeColumns: z4.boolean().optional().default(false).describe("Whether to randomize the order of columns")
 }).refine(
   (data) => {
     if (data.minSelectionsPerRow !== void 0 && data.maxSelectionsPerRow !== void 0) {
@@ -876,64 +1085,64 @@ var matrixMultipleChoiceQuestionSchema = questionSchema.extend({
 ).describe(
   "Schema for matrix multiple-choice questions where one or more columns can be selected per row"
 );
-var questionOptionSchema = z3.object({
-  id: z3.string().describe("Unique identifier for this option (system time milliseconds)"),
-  value: z3.string().min(1).max(100).describe("The internal value used for this option"),
-  label: z3.string().min(1).max(200).describe("The display text shown to users for this option"),
-  hint: z3.string().max(300).optional().describe(
+var questionOptionSchema = z4.object({
+  id: z4.string().describe("Unique identifier for this option (system time milliseconds)"),
+  value: z4.string().min(1).max(100).describe("The internal value used for this option"),
+  label: z4.string().min(1).max(200).describe("The display text shown to users for this option"),
+  hint: z4.string().max(300).optional().describe(
     "Optional short description shown below the option label to help respondents understand what they are selecting or ranking"
   ),
-  describe: z3.string().max(500).optional().describe(
+  describe: z4.string().max(500).optional().describe(
     "LLM tool call description providing context about this option"
   ),
-  imageUrl: z3.string().url().optional().describe("Optional image URL to display with this option")
+  imageUrl: z4.string().url().optional().describe("Optional image URL to display with this option")
 }).describe("Schema for individual options in choice-based questions");
-var nestedOptionSchema = z3.lazy(
-  () => z3.object({
-    id: z3.string().describe(
+var nestedOptionSchema = z4.lazy(
+  () => z4.object({
+    id: z4.string().describe(
       "Unique identifier for this nested option (system time milliseconds)"
     ),
-    value: z3.string().min(1).max(100).describe("The internal value used for this nested option"),
-    label: z3.string().min(1).max(200).describe("The display text shown for this nested option"),
-    describe: z3.string().max(500).optional().describe("LLM tool call description for this nested option context"),
-    imageUrl: z3.string().url().optional().describe("Optional image URL for this nested option"),
-    hint: z3.string().max(500).optional().describe(
+    value: z4.string().min(1).max(100).describe("The internal value used for this nested option"),
+    label: z4.string().min(1).max(200).describe("The display text shown for this nested option"),
+    describe: z4.string().max(500).optional().describe("LLM tool call description for this nested option context"),
+    imageUrl: z4.string().url().optional().describe("Optional image URL for this nested option"),
+    hint: z4.string().max(500).optional().describe(
       "Optional hint text to help users understand this nested option"
     ),
-    children: z3.array(nestedOptionSchema).optional().default([]).describe("Array of child options for hierarchical structure")
+    children: z4.array(nestedOptionSchema).optional().default([]).describe("Array of child options for hierarchical structure")
   }).describe("Schema for nested options with hierarchical structure support")
 );
 var multipleChoiceSingleQuestionSchema = questionSchema.extend({
-  type: z3.literal("single_choice").describe("Must be exactly 'single_choice'"),
+  type: z4.literal("single_choice").describe("Must be exactly 'single_choice'"),
   displayStyle: multipleChoiceDisplayStyleSchema.optional().describe("Visual style for displaying options"),
-  allowOther: z3.boolean().optional().default(false).describe('Whether to allow a custom "other" option'),
-  otherTextConfig: z3.object({
-    minChars: z3.number().int().min(0).optional().describe("Minimum number of characters required for the other text"),
-    maxChars: z3.number().int().min(1).optional().describe("Maximum number of characters allowed for the other text"),
-    placeholder: z3.string().max(200).optional().describe("Placeholder text for the other text input"),
-    showLimitIndicatorThreshold: z3.number().int().min(0).optional().describe(
+  allowOther: z4.boolean().optional().default(false).describe('Whether to allow a custom "other" option'),
+  otherTextConfig: z4.object({
+    minChars: z4.number().int().min(0).optional().describe("Minimum number of characters required for the other text"),
+    maxChars: z4.number().int().min(1).optional().describe("Maximum number of characters allowed for the other text"),
+    placeholder: z4.string().max(200).optional().describe("Placeholder text for the other text input"),
+    showLimitIndicatorThreshold: z4.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: z3.boolean().optional().default(false).describe("Whether to randomize the order of options"),
-  options: z3.array(questionOptionSchema).min(1).max(50).describe("Array of options for user selection (1-50 options)")
+  randomizeOptions: z4.boolean().optional().default(false).describe("Whether to randomize the order of options"),
+  options: z4.array(questionOptionSchema).min(1).max(50).describe("Array of options for user selection (1-50 options)")
 }).describe("Schema for single-choice multiple selection questions");
 var multipleChoiceMultipleQuestionSchema = questionSchema.extend({
-  type: z3.literal("multiple_choice_multiple").describe("Must be exactly 'multiple_choice_multiple'"),
+  type: z4.literal("multiple_choice_multiple").describe("Must be exactly 'multiple_choice_multiple'"),
   displayStyle: multipleChoiceMultipleDisplayStyleSchema.optional().describe("Visual style for displaying multiple options"),
-  allowOther: z3.boolean().optional().default(false).describe('Whether to allow a custom "other" option'),
-  otherTextConfig: z3.object({
-    minChars: z3.number().int().min(0).optional().describe("Minimum number of characters required for the other text"),
-    maxChars: z3.number().int().min(1).optional().describe("Maximum number of characters allowed for the other text"),
-    placeholder: z3.string().max(200).optional().describe("Placeholder text for the other text input"),
-    showLimitIndicatorThreshold: z3.number().int().min(0).optional().describe(
+  allowOther: z4.boolean().optional().default(false).describe('Whether to allow a custom "other" option'),
+  otherTextConfig: z4.object({
+    minChars: z4.number().int().min(0).optional().describe("Minimum number of characters required for the other text"),
+    maxChars: z4.number().int().min(1).optional().describe("Maximum number of characters allowed for the other text"),
+    placeholder: z4.string().max(200).optional().describe("Placeholder text for the other text input"),
+    showLimitIndicatorThreshold: z4.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: z3.number().int().min(0).optional().describe("Minimum number of options that must be selected"),
-  maxSelections: z3.number().int().min(1).optional().describe("Maximum number of options that can be selected"),
-  randomizeOptions: z3.boolean().optional().default(false).describe("Whether to randomize the order of options"),
-  options: z3.array(questionOptionSchema).min(1).max(50).describe("Array of options for user selection (1-50 options)")
+  minSelections: z4.number().int().min(0).optional().describe("Minimum number of options that must be selected"),
+  maxSelections: z4.number().int().min(1).optional().describe("Maximum number of options that can be selected"),
+  randomizeOptions: z4.boolean().optional().default(false).describe("Whether to randomize the order of options"),
+  options: z4.array(questionOptionSchema).min(1).max(50).describe("Array of options for user selection (1-50 options)")
 }).refine(
   (data) => {
     if (data.minSelections !== void 0 && data.maxSelections !== void 0) {
@@ -950,20 +1159,20 @@ var multipleChoiceMultipleQuestionSchema = questionSchema.extend({
   "Schema for multiple-choice questions allowing multiple selections"
 );
 var npsQuestionSchema = questionSchema.extend({
-  type: z3.literal("nps").describe("Must be exactly 'nps'"),
-  min: z3.literal(0).describe("NPS always starts at 0"),
-  max: z3.literal(10).describe("NPS always ends at 10"),
-  minLabel: z3.string().max(100).optional().describe("Label for the minimum NPS value (0)"),
-  maxLabel: z3.string().max(100).optional().describe("Label for the maximum NPS value (10)"),
-  scaleLabels: z3.record(z3.string().regex(/^\d+$/), z3.string().max(50)).optional().describe("Custom labels for specific NPS values (0-10)"),
-  prepopulatedValue: z3.number().int().min(0).max(10).optional().describe("Default value to pre-select (0-10)"),
-  detractorColor: z3.string().max(50).optional().describe(
+  type: z4.literal("nps").describe("Must be exactly 'nps'"),
+  min: z4.literal(0).describe("NPS always starts at 0"),
+  max: z4.literal(10).describe("NPS always ends at 10"),
+  minLabel: z4.string().max(100).optional().describe("Label for the minimum NPS value (0)"),
+  maxLabel: z4.string().max(100).optional().describe("Label for the maximum NPS value (10)"),
+  scaleLabels: z4.record(z4.string().regex(/^\d+$/), z4.string().max(50)).optional().describe("Custom labels for specific NPS values (0-10)"),
+  prepopulatedValue: z4.number().int().min(0).max(10).optional().describe("Default value to pre-select (0-10)"),
+  detractorColor: z4.string().max(50).optional().describe(
     "Color applied to detractor scores (0\u20136); accepts any valid CSS color value (hex, rgb, hsl, named)"
   ),
-  passiveColor: z3.string().max(50).optional().describe(
+  passiveColor: z4.string().max(50).optional().describe(
     "Color applied to passive scores (7\u20138); accepts any valid CSS color value"
   ),
-  promoterColor: z3.string().max(50).optional().describe(
+  promoterColor: z4.string().max(50).optional().describe(
     "Color applied to promoter scores (9\u201310); accepts any valid CSS color value"
   )
 }).refine(
@@ -983,19 +1192,19 @@ var npsQuestionSchema = questionSchema.extend({
   }
 ).describe("Schema for Net Promoter Score questions with 0-10 scale");
 var shortAnswerQuestionSchema = questionSchema.extend({
-  type: z3.literal("short_answer").describe("Must be exactly 'short_answer'"),
-  maxCharacters: z3.number().int().min(1).max(1e4).optional().describe("Maximum number of characters allowed"),
-  minCharacters: z3.number().int().min(0).optional().describe("Minimum number of characters required"),
-  showLimitIndicatorThreshold: z3.number().int().min(0).optional().describe(
+  type: z4.literal("short_answer").describe("Must be exactly 'short_answer'"),
+  maxCharacters: z4.number().int().min(1).max(1e4).optional().describe("Maximum number of characters allowed"),
+  minCharacters: z4.number().int().min(0).optional().describe("Minimum number of characters required"),
+  showLimitIndicatorThreshold: z4.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: z3.string().max(200).optional().describe("Placeholder text shown in the input field"),
-  enableRegexValidation: z3.boolean().optional().default(false).describe("Whether to enable regex pattern validation"),
-  regexPattern: z3.string().optional().describe("Regular expression pattern for validation"),
-  enableEnhanceWithAi: z3.boolean().optional().default(false).describe("Whether to enable AI enhancement features"),
-  promptTemplate: z3.string().max(2e3).optional().describe("Template for AI enhancement prompts"),
-  maxTokenAllowed: z3.number().int().min(1).max(1e4).optional().describe("Maximum tokens allowed for AI processing"),
-  minCharactersToEnhance: z3.number().int().min(1).optional().describe("Minimum characters needed to trigger AI enhancement")
+  placeholder: z4.string().max(200).optional().describe("Placeholder text shown in the input field"),
+  enableRegexValidation: z4.boolean().optional().default(false).describe("Whether to enable regex pattern validation"),
+  regexPattern: z4.string().optional().describe("Regular expression pattern for validation"),
+  enableEnhanceWithAi: z4.boolean().optional().default(false).describe("Whether to enable AI enhancement features"),
+  promptTemplate: z4.string().max(2e3).optional().describe("Template for AI enhancement prompts"),
+  maxTokenAllowed: z4.number().int().min(1).max(1e4).optional().describe("Maximum tokens allowed for AI processing"),
+  minCharactersToEnhance: z4.number().int().min(1).optional().describe("Minimum characters needed to trigger AI enhancement")
 }).refine(
   (data) => {
     if (data.minCharacters !== void 0 && data.maxCharacters !== void 0) {
@@ -1031,22 +1240,22 @@ var shortAnswerQuestionSchema = questionSchema.extend({
   }
 ).describe("Schema for short answer questions with optional AI enhancement");
 var longAnswerQuestionSchema = questionSchema.extend({
-  type: z3.literal("long_text").describe("Must be exactly 'long_text'"),
-  maxCharacters: z3.number().int().min(1).max(5e4).optional().describe(
+  type: z4.literal("long_text").describe("Must be exactly 'long_text'"),
+  maxCharacters: z4.number().int().min(1).max(5e4).optional().describe(
     "Maximum number of characters allowed (higher limit for long text)"
   ),
-  minCharacters: z3.number().int().min(0).optional().describe("Minimum number of characters required"),
-  showLimitIndicatorThreshold: z3.number().int().min(0).optional().describe(
+  minCharacters: z4.number().int().min(0).optional().describe("Minimum number of characters required"),
+  showLimitIndicatorThreshold: z4.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: z3.number().int().min(1).max(20).optional().describe("Number of textarea rows to display (1-20)"),
-  placeholder: z3.string().max(500).optional().describe("Placeholder text for the textarea (longer for long text)"),
-  enableEnhanceWithAi: z3.boolean().optional().default(false).describe("Whether to enable AI enhancement features"),
-  promptTemplate: z3.string().max(2e3).optional().describe("Template for AI enhancement prompts"),
-  maxTokenAllowed: z3.number().int().min(1).max(25e3).optional().describe(
+  rows: z4.number().int().min(1).max(20).optional().describe("Number of textarea rows to display (1-20)"),
+  placeholder: z4.string().max(500).optional().describe("Placeholder text for the textarea (longer for long text)"),
+  enableEnhanceWithAi: z4.boolean().optional().default(false).describe("Whether to enable AI enhancement features"),
+  promptTemplate: z4.string().max(2e3).optional().describe("Template for AI enhancement prompts"),
+  maxTokenAllowed: z4.number().int().min(1).max(25e3).optional().describe(
     "Maximum tokens allowed for AI processing (higher for long text)"
   ),
-  minCharactersToEnhance: z3.number().int().min(1).optional().describe("Minimum characters needed to trigger AI enhancement")
+  minCharactersToEnhance: z4.number().int().min(1).optional().describe("Minimum characters needed to trigger AI enhancement")
 }).refine(
   (data) => {
     if (data.minCharacters !== void 0 && data.maxCharacters !== void 0) {
@@ -1073,19 +1282,19 @@ var longAnswerQuestionSchema = questionSchema.extend({
   "Schema for long answer questions with rich text support and AI enhancement"
 );
 var nestedDropdownQuestionSchema = questionSchema.extend({
-  type: z3.literal("nested_selection").describe("Must be exactly 'nested_selection'"),
-  placeholder: z3.string().max(200).optional().describe("Placeholder text for the nested dropdown"),
-  options: z3.array(nestedOptionSchema).min(1).max(100).describe(
+  type: z4.literal("nested_selection").describe("Must be exactly 'nested_selection'"),
+  placeholder: z4.string().max(200).optional().describe("Placeholder text for the nested dropdown"),
+  options: z4.array(nestedOptionSchema).min(1).max(100).describe(
     "Array of nested options for hierarchical selection (1-100 options)"
   ),
-  displayStyle: z3.literal("list").describe("Fixed display style for nested dropdowns"),
+  displayStyle: z4.literal("list").describe("Fixed display style for nested dropdowns"),
   choiceOrderOption: choiceOrderOptionSchema.optional().default("none").describe("How to order the nested choices"),
-  preserveLastChoices: z3.number().int().min(0).max(10).optional().describe("Number of choice levels to preserve (0-10)"),
-  prepopulatedValue: z3.string().max(1e3).optional().describe("Default value to pre-populate"),
-  allowOther: z3.boolean().optional().default(false).describe('Whether to allow custom "other" options'),
-  otherColumnName: z3.string().max(100).optional().describe('Column name for storing custom "other" values'),
-  maxDepth: z3.number().int().min(1).max(10).optional().describe("Maximum nesting depth allowed (1-10)"),
-  cascadeLabels: z3.boolean().optional().default(false).describe("Whether to cascade labels from parent options")
+  preserveLastChoices: z4.number().int().min(0).max(10).optional().describe("Number of choice levels to preserve (0-10)"),
+  prepopulatedValue: z4.string().max(1e3).optional().describe("Default value to pre-populate"),
+  allowOther: z4.boolean().optional().default(false).describe('Whether to allow custom "other" options'),
+  otherColumnName: z4.string().max(100).optional().describe('Column name for storing custom "other" values'),
+  maxDepth: z4.number().int().min(1).max(10).optional().describe("Maximum nesting depth allowed (1-10)"),
+  cascadeLabels: z4.boolean().optional().default(false).describe("Whether to cascade labels from parent options")
 }).refine(
   (data) => {
     if (data.allowOther && !data.otherColumnName) {
@@ -1100,7 +1309,7 @@ var nestedDropdownQuestionSchema = questionSchema.extend({
 ).describe(
   "Schema for nested dropdown questions with hierarchical option structure"
 );
-var dateFormatSchema = z3.enum([
+var dateFormatSchema = z4.enum([
   "MM/DD/YYYY",
   "DD/MM/YYYY",
   "YYYY/MM/DD"
@@ -1110,40 +1319,40 @@ var DateFormats = {
   DD_MM_YYYY: "DD/MM/YYYY",
   YYYY_MM_DD: "YYYY/MM/DD"
 };
-var dateSeparatorSchema = z3.enum(["/", "-", "."]);
+var dateSeparatorSchema = z4.enum(["/", "-", "."]);
 var DateSeparators = {
   SLASH: "/",
   DASH: "-",
   DOT: "."
 };
 var dateQuestionSchema = questionSchema.extend({
-  type: z3.literal("date").describe("Must be exactly 'date'"),
+  type: z4.literal("date").describe("Must be exactly 'date'"),
   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: z3.boolean().optional().default(false).describe("Whether to also collect a time (HH:MM) alongside the date"),
-  minDate: z3.string().optional().describe(
+  includeTime: z4.boolean().optional().default(false).describe("Whether to also collect a time (HH:MM) alongside the date"),
+  minDate: z4.string().optional().describe(
     "Earliest allowed date in ISO 8601 format (YYYY-MM-DD); when absent no lower bound is enforced"
   ),
-  maxDate: z3.string().optional().describe(
+  maxDate: z4.string().optional().describe(
     "Latest allowed date in ISO 8601 format (YYYY-MM-DD); when absent no upper bound is enforced"
   ),
-  placeholder: z3.string().max(50).optional().describe("Placeholder text shown in the date input"),
-  segmentLabelDD: z3.string().max(40).optional().describe(
+  placeholder: z4.string().max(50).optional().describe("Placeholder text shown in the date input"),
+  segmentLabelDD: z4.string().max(40).optional().describe(
     "Visible label above the day segment; when absent a locale default is used"
   ),
-  segmentLabelMM: z3.string().max(40).optional().describe("Visible label above the month segment"),
-  segmentLabelYYYY: z3.string().max(40).optional().describe("Visible label above the year segment"),
-  prepopulatedValue: z3.string().optional().describe(
+  segmentLabelMM: z4.string().max(40).optional().describe("Visible label above the month segment"),
+  segmentLabelYYYY: z4.string().max(40).optional().describe("Visible label above the year segment"),
+  prepopulatedValue: z4.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 = z3.union([
-  z3.literal(2),
-  z3.literal(3),
-  z3.literal(4),
-  z3.literal(5)
+var csatScaleSchema = z4.union([
+  z4.literal(2),
+  z4.literal(3),
+  z4.literal(4),
+  z4.literal(5)
 ]);
 var CsatScales = {
   TWO: 2,
@@ -1151,56 +1360,56 @@ var CsatScales = {
   FOUR: 4,
   FIVE: 5
 };
-var csatDisplayStyleSchema = z3.enum(["emoji", "text"]);
+var csatDisplayStyleSchema = z4.enum(["emoji", "text"]);
 var CsatDisplayStyles = {
   EMOJI: "emoji",
   TEXT: "text"
 };
 var csatQuestionSchema = questionSchema.extend({
-  type: z3.literal("csat").describe("Must be exactly 'csat'"),
+  type: z4.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: z3.boolean().optional().default(false).describe(
+  multicolor: z4.boolean().optional().default(false).describe(
     "Whether to apply distinct colors to negative, neutral, and positive segments"
   ),
-  negativeColor: z3.string().max(50).optional().describe(
+  negativeColor: z4.string().max(50).optional().describe(
     "Color for negative response options (lower half of scale); any valid CSS color; used when multicolor is true"
   ),
-  neutralColor: z3.string().max(50).optional().describe(
+  neutralColor: z4.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: z3.string().max(50).optional().describe(
+  positiveColor: z4.string().max(50).optional().describe(
     "Color for positive response options (upper half of scale); any valid CSS color; used when multicolor is true"
   ),
-  showLabels: z3.boolean().optional().default(false).describe(
+  showLabels: z4.boolean().optional().default(false).describe(
     "Whether to render per-point labels below each response option"
   ),
-  scaleLabels: z3.record(z3.string(), z3.string().max(100)).optional().describe(
+  scaleLabels: z4.record(z4.string(), z4.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: z3.literal("opinion_scale").describe("Must be exactly 'opinion_scale'"),
-  startValue: z3.union([z3.literal(0), z3.literal(1)]).optional().default(0).describe("Starting value of the scale \u2014 0 (default) or 1"),
-  steps: z3.number().int().min(5).max(11).optional().default(11).describe(
+  type: z4.literal("opinion_scale").describe("Must be exactly 'opinion_scale'"),
+  startValue: z4.union([z4.literal(0), z4.literal(1)]).optional().default(0).describe("Starting value of the scale \u2014 0 (default) or 1"),
+  steps: z4.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: z3.string().max(100).optional().describe(
+  minLabel: z4.string().max(100).optional().describe(
     "Optional label anchoring the low end of the scale (e.g. 'Not at all likely')"
   ),
-  maxLabel: z3.string().max(100).optional().describe(
+  maxLabel: z4.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 = z3.enum([
+var rankingDisplayStyleSchema = z4.enum([
   "drag_drop",
   "dropdown",
   "up_down"
@@ -1211,18 +1420,21 @@ var RankingDisplayStyles = {
   UP_DOWN: "up_down"
 };
 var rankingQuestionSchema = questionSchema.extend({
-  type: z3.literal("ranking").describe("Must be exactly 'ranking'"),
-  options: z3.array(questionOptionSchema).min(2).max(30).describe(
+  type: z4.literal("ranking").describe("Must be exactly 'ranking'"),
+  options: z4.array(questionOptionSchema).min(2).max(30).describe(
     "List of items to rank (2\u201330 items); each item supports an optional hint for clarification"
   ),
-  randomizeOptions: z3.boolean().optional().default(false).describe(
+  randomizeOptions: z4.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: z3.number().int().min(1).optional().describe(
+  maxRank: z4.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"
+  ),
+  prepopulatedValue: z4.array(z4.string()).optional().describe(
+    "Default ranked order as option value strings (index 0 = rank 1)"
   )
 }).refine(
   (data) => data.maxRank === void 0 || data.maxRank <= data.options.length,
@@ -1230,34 +1442,53 @@ var rankingQuestionSchema = questionSchema.extend({
     message: "maxRank cannot exceed the number of options",
     path: ["maxRank"]
   }
+).refine(
+  (data) => {
+    if (!data.prepopulatedValue?.length) return true;
+    const optionValues = new Set(data.options.map((o) => o.value));
+    return data.prepopulatedValue.every((v) => optionValues.has(v));
+  },
+  {
+    message: "Prepopulated value must use valid option values",
+    path: ["prepopulatedValue"]
+  }
+).refine(
+  (data) => {
+    if (!data.prepopulatedValue?.length || data.maxRank === void 0) return true;
+    return data.prepopulatedValue.length <= data.maxRank;
+  },
+  {
+    message: "Prepopulated value cannot exceed maxRank",
+    path: ["prepopulatedValue"]
+  }
 ).describe(
   "Schema for a ranking question where respondents order items by preference"
 );
 var pictureChoiceQuestionSchema = questionSchema.extend({
-  type: z3.literal("picture_choice").describe("Must be exactly 'picture_choice'"),
-  options: z3.array(questionOptionSchema).min(1).max(50).describe(
+  type: z4.literal("picture_choice").describe("Must be exactly 'picture_choice'"),
+  options: z4.array(questionOptionSchema).min(1).max(50).describe(
     "Array of options; each should include an imageUrl for the picture to display"
   ),
-  multiple: z3.boolean().optional().default(false).describe(
+  multiple: z4.boolean().optional().default(false).describe(
     "When true respondents may select more than one image; when false (default) only one image can be selected"
   ),
-  minSelections: z3.number().int().min(1).optional().describe(
+  minSelections: z4.number().int().min(1).optional().describe(
     "Minimum number of images the respondent must select (only applies when multiple is true)"
   ),
-  maxSelections: z3.number().int().min(1).optional().describe(
+  maxSelections: z4.number().int().min(1).optional().describe(
     "Maximum number of images the respondent may select (only applies when multiple is true)"
   ),
-  supersize: z3.boolean().optional().default(false).describe("Whether to display images at an enlarged size"),
-  showLabels: z3.boolean().optional().default(true).describe("Whether to show the text label below each image"),
-  randomizeOptions: z3.boolean().optional().default(false).describe(
+  supersize: z4.boolean().optional().default(false).describe("Whether to display images at an enlarged size"),
+  showLabels: z4.boolean().optional().default(true).describe("Whether to show the text label below each image"),
+  randomizeOptions: z4.boolean().optional().default(false).describe(
     "Whether to shuffle image order per respondent to avoid position bias"
   ),
-  allowOther: z3.boolean().optional().default(false).describe('Whether to include a free-text "other" option'),
-  otherTextConfig: z3.object({
-    minChars: z3.number().int().min(0).optional().describe("Minimum number of characters required for the other text"),
-    maxChars: z3.number().int().min(1).optional().describe("Maximum number of characters allowed for the other text"),
-    placeholder: z3.string().max(200).optional().describe("Placeholder text for the other text input"),
-    showLimitIndicatorThreshold: z3.number().int().min(0).optional().describe(
+  allowOther: z4.boolean().optional().default(false).describe('Whether to include a free-text "other" option'),
+  otherTextConfig: z4.object({
+    minChars: z4.number().int().min(0).optional().describe("Minimum number of characters required for the other text"),
+    maxChars: z4.number().int().min(1).optional().describe("Maximum number of characters allowed for the other text"),
+    placeholder: z4.string().max(200).optional().describe("Placeholder text for the other text input"),
+    showLimitIndicatorThreshold: z4.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')
@@ -1275,111 +1506,111 @@ var pictureChoiceQuestionSchema = questionSchema.extend({
 ).describe(
   "Schema for a picture choice question where respondents select from image-based options"
 );
-var signatureModeSchema = z3.enum(["type", "draw", "upload"]);
+var signatureModeSchema = z4.enum(["type", "draw", "upload"]);
 var SignatureModes = {
   TYPE: "type",
   DRAW: "draw",
   UPLOAD: "upload"
 };
 var signatureQuestionSchema = questionSchema.extend({
-  type: z3.literal("signature").describe("Must be exactly 'signature'"),
-  allowedModes: z3.array(signatureModeSchema).min(1).optional().describe(
+  type: z4.literal("signature").describe("Must be exactly 'signature'"),
+  allowedModes: z4.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: z3.boolean().optional().default(true).describe(
+  collectSignerEmail: z4.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: z3.string().optional().describe(
+  signerEmailFieldId: z4.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: z3.string().max(50).optional().describe(
+  penColor: z4.string().max(50).optional().describe(
     "Stroke color for the draw canvas; any valid CSS color; when absent the theme foreground color is used"
   ),
-  penWidth: z3.number().int().min(1).max(20).optional().describe(
+  penWidth: z4.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: z3.string().max(50).optional().describe(
+  backgroundColor: z4.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: z3.number().int().min(60).max(600).optional().describe(
+  canvasHeight: z4.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: z3.string().max(50).optional().describe(
+  clearButtonLabel: z4.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: z3.string().max(200).optional().describe(
+  placeholder: z4.string().max(200).optional().describe(
     "Optional shared fallback copy for draw-canvas and upload-zone hints when their dedicated fields are unset"
   ),
-  modeTabLabelType: z3.string().max(80).optional().describe(
+  modeTabLabelType: z4.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: z3.string().max(80).optional().describe(
+  modeTabLabelDraw: z4.string().max(80).optional().describe(
     "Custom visible label for the Draw tab; when absent only the tab icon is shown"
   ),
-  modeTabLabelUpload: z3.string().max(80).optional().describe(
+  modeTabLabelUpload: z4.string().max(80).optional().describe(
     "Custom visible label for the Upload tab; when absent only the tab icon is shown"
   ),
-  drawCanvasHint: z3.string().max(200).optional().describe(
+  drawCanvasHint: z4.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: z3.string().max(200).optional().describe(
+  uploadZonePrimary: z4.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: z3.string().max(120).optional().describe(
+  uploadZoneDrag: z4.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: z3.literal("file_upload").describe("Must be exactly 'file_upload'"),
-  allowedFileTypes: z3.array(z3.string()).min(1).optional().describe(
+  type: z4.literal("file_upload").describe("Must be exactly 'file_upload'"),
+  allowedFileTypes: z4.array(z4.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: z3.number().int().min(1).max(100).optional().describe(
+  maxFileSizeMb: z4.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: z3.boolean().optional().default(false).describe(
+  multiple: z4.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: z3.number().int().min(1).max(20).optional().describe(
+  maxFiles: z4.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: z3.string().max(200).optional().describe(
+  placeholder: z4.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: z3.literal("email").describe("Must be exactly 'email'"),
-  placeholder: z3.string().max(200).optional().describe("Placeholder text shown inside the email input"),
-  prepopulatedValue: z3.string().optional().describe(
+  type: z4.literal("email").describe("Must be exactly 'email'"),
+  placeholder: z4.string().max(200).optional().describe("Placeholder text shown inside the email input"),
+  prepopulatedValue: z4.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: z3.literal("number").describe("Must be exactly 'number'"),
-  min: z3.number().optional().describe(
+  type: z4.literal("number").describe("Must be exactly 'number'"),
+  min: z4.number().optional().describe(
     "Minimum allowed value (inclusive); when absent no lower bound is enforced"
   ),
-  max: z3.number().optional().describe(
+  max: z4.number().optional().describe(
     "Maximum allowed value (inclusive); when absent no upper bound is enforced"
   ),
-  allowDecimal: z3.boolean().optional().default(false).describe(
+  allowDecimal: z4.boolean().optional().default(false).describe(
     "Whether decimal (non-integer) values are accepted; Typeform restricts to whole numbers only, making this a differentiator"
   ),
-  allowNegative: z3.boolean().optional().default(false).describe(
+  allowNegative: z4.boolean().optional().default(false).describe(
     "Whether negative values are accepted; Typeform restricts to positive numbers only, making this a differentiator"
   ),
-  placeholder: z3.string().max(200).optional().describe("Placeholder text shown inside the number input"),
-  prepopulatedValue: z3.number().optional().describe("Default numeric value to pre-fill the input"),
-  unit: z3.string().max(10).optional().describe(
+  placeholder: z4.string().max(200).optional().describe("Placeholder text shown inside the number input"),
+  prepopulatedValue: z4.number().optional().describe("Default numeric value to pre-fill the input"),
+  unit: z4.string().max(10).optional().describe(
     "Unit label displayed beside the input (e.g. 'kg', '$', 'years')"
   )
 }).refine(
@@ -1392,39 +1623,39 @@ var numberQuestionSchema = questionSchema.extend({
   "Schema for a number question that only accepts numeric input with configurable range and format constraints"
 );
 var websiteQuestionSchema = questionSchema.extend({
-  type: z3.literal("website").describe("Must be exactly 'website'"),
-  placeholder: z3.string().max(200).optional().describe(
+  type: z4.literal("website").describe("Must be exactly 'website'"),
+  placeholder: z4.string().max(200).optional().describe(
     "Placeholder text shown inside the URL input (e.g. 'https://yoursite.com')"
   ),
-  prepopulatedValue: z3.string().optional().describe("Default URL to pre-fill the input")
+  prepopulatedValue: z4.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"
 );
 var phoneNumberQuestionSchema = questionSchema.extend({
-  type: z3.literal("phone_number").describe("Must be exactly 'phone_number'"),
-  defaultCountryCode: z3.string().max(2).optional().describe(
+  type: z4.literal("phone_number").describe("Must be exactly 'phone_number'"),
+  defaultCountryCode: z4.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: z3.boolean().optional().default(true).describe(
+  allowCountryChange: z4.boolean().optional().default(true).describe(
     "Whether the respondent can change the country code; when false the default country is locked"
   ),
-  placeholder: z3.string().max(200).optional().describe("Placeholder text shown inside the phone number input"),
-  prepopulatedValue: z3.string().optional().describe(
+  placeholder: z4.string().max(200).optional().describe("Placeholder text shown inside the phone number input"),
+  prepopulatedValue: z4.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 = z3.object({
-  enabled: z3.boolean().default(true).describe("Whether this sub-field is shown in the question"),
-  required: z3.boolean().default(false).describe("Whether the respondent must fill in this sub-field"),
-  placeholder: z3.string().max(200).optional().describe("Placeholder text for this sub-field input"),
-  label: z3.string().max(120).optional().describe(
+var addressSubFieldConfigSchema = z4.object({
+  enabled: z4.boolean().default(true).describe("Whether this sub-field is shown in the question"),
+  required: z4.boolean().default(false).describe("Whether the respondent must fill in this sub-field"),
+  placeholder: z4.string().max(200).optional().describe("Placeholder text for this sub-field input"),
+  label: z4.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: z3.literal("address").describe("Must be exactly 'address'"),
+  type: z4.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"
@@ -1433,13 +1664,16 @@ var addressQuestionSchema = questionSchema.extend({
   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: z3.string().max(2).optional().describe(
+  defaultCountry: z4.string().max(2).optional().describe(
     "ISO 3166-1 alpha-2 country code to pre-select in the country dropdown (e.g. 'US', 'GB')"
+  ),
+  prepopulatedValue: AddressAnswerSchema.optional().describe(
+    "Default address values to pre-fill the sub-fields"
   )
 }).describe(
   "Schema for an address question that collects a full structured address on a single screen"
 );
-var videoAudioModeSchema = z3.enum(["video", "audio", "photo", "text"]);
+var videoAudioModeSchema = z4.enum(["video", "audio", "photo", "text"]);
 var VideoAudioModes = {
   VIDEO: "video",
   AUDIO: "audio",
@@ -1447,186 +1681,186 @@ var VideoAudioModes = {
   TEXT: "text"
 };
 var videoAudioQuestionSchema = questionSchema.extend({
-  type: z3.literal("video_audio").describe("Must be exactly 'video_audio'"),
-  allowedModes: z3.array(videoAudioModeSchema).min(1).optional().describe(
+  type: z4.literal("video_audio").describe("Must be exactly 'video_audio'"),
+  allowedModes: z4.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: z3.number().int().min(5).max(600).optional().describe(
+  maxDurationSeconds: z4.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: z3.number().int().min(1).max(500).optional().describe(
+  maxFileSizeMb: z4.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: z3.boolean().optional().default(true).describe(
+  allowUpload: z4.boolean().optional().default(true).describe(
     "Whether the respondent can upload a file in addition to recording or capturing live (video, audio, or photo)"
   ),
-  placeholder: z3.string().max(200).optional().describe(
+  placeholder: z4.string().max(200).optional().describe(
     "Instructional text shown to the respondent before they begin recording or capturing"
   ),
-  modeTabLabelVideo: z3.string().max(80).optional().describe(
+  modeTabLabelVideo: z4.string().max(80).optional().describe(
     "Custom tab label for video mode in the respondent UI; when absent defaults to 'Video'"
   ),
-  modeTabLabelAudio: z3.string().max(80).optional().describe(
+  modeTabLabelAudio: z4.string().max(80).optional().describe(
     "Custom tab label for audio mode; when absent defaults to 'Audio'"
   ),
-  modeTabLabelPhoto: z3.string().max(80).optional().describe(
+  modeTabLabelPhoto: z4.string().max(80).optional().describe(
     "Custom tab label for photo mode; when absent defaults to 'Photo'"
   ),
-  modeTabLabelText: z3.string().max(80).optional().describe(
+  modeTabLabelText: z4.string().max(80).optional().describe(
     "Custom tab label for text mode; when absent defaults to 'Text'"
   ),
-  recordButtonLabel: z3.string().max(80).optional().describe("Label for the Record button in video/audio modes"),
-  uploadMediaButtonLabel: z3.string().max(80).optional().describe(
+  recordButtonLabel: z4.string().max(80).optional().describe("Label for the Record button in video/audio modes"),
+  uploadMediaButtonLabel: z4.string().max(80).optional().describe(
     "Label for the upload control in video/audio modes when uploads are allowed"
   ),
-  videoIdleHint: z3.string().max(200).optional().describe(
+  videoIdleHint: z4.string().max(200).optional().describe(
     "Hint shown over the video preview when idle; falls back to placeholder then built-in copy"
   ),
-  photoEmptyHint: z3.string().max(200).optional().describe(
+  photoEmptyHint: z4.string().max(200).optional().describe(
     "Hint in the empty photo preview area; falls back to placeholder then built-in copy"
   ),
-  photoUseCameraButtonLabel: z3.string().max(80).optional().describe("Label for the Use camera button in photo mode"),
-  photoUploadImageButtonLabel: z3.string().max(80).optional().describe("Label for the upload image button in photo mode")
+  photoUseCameraButtonLabel: z4.string().max(80).optional().describe("Label for the Use camera button in photo mode"),
+  photoUploadImageButtonLabel: z4.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 = z3.enum(["google_calendar", "calendly"]);
+var schedulerProviderSchema = z4.enum(["google_calendar", "calendly"]);
 var SchedulerProviders = {
   GOOGLE_CALENDAR: "google_calendar",
   CALENDLY: "calendly"
 };
 var schedulerQuestionSchema = questionSchema.extend({
-  type: z3.literal("scheduler").describe("Must be exactly 'scheduler'"),
+  type: z4.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: z3.string().optional().describe(
+  calendarId: z4.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: z3.boolean().optional().default(true).describe(
+  showIntroScreen: z4.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: z3.string().optional().describe(
+  autofillNameFieldId: z4.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: z3.string().optional().describe(
+  autofillEmailFieldId: z4.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: z3.string().max(200).optional().describe(
+  placeholder: z4.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: z3.string().max(200).optional().describe(
+  scheduleMeetingLabel: z4.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: z3.literal("qna_with_ai").describe("Must be exactly 'qna_with_ai'"),
-  knowledgeBase: z3.string().max(2e4).describe(
+  type: z4.literal("qna_with_ai").describe("Must be exactly 'qna_with_ai'"),
+  knowledgeBase: z4.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: z3.number().int().min(50).max(2e3).optional().describe(
+  maxResponseLength: z4.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: z3.number().int().min(1).max(100).optional().describe(
+  maxQaPairs: z4.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: z3.string().max(200).optional().describe(
+  placeholder: z4.string().max(200).optional().describe(
     "Hint text shown in the respondent's question input field (e.g. 'Ask me anything about this event...')"
   ),
-  askButtonLabel: z3.string().max(50).optional().describe(
+  askButtonLabel: z4.string().max(50).optional().describe(
     "Label for the submit/ask button; when absent the platform default (e.g. 'Ask AI') is shown"
   ),
-  emptyStateHint: z3.string().max(200).optional().describe(
+  emptyStateHint: z4.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: z3.string().max(160).optional().describe(
+  pairsRemainingTemplate: z4.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: z3.string().max(160).optional().describe(
+  pairsLimitReachedTemplate: z4.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 = z3.discriminatedUnion("mode", [
-  z3.object({
-    mode: z3.literal("fixed").describe("A fixed amount configured by the form builder"),
-    amount: z3.number().positive().describe("Fixed amount to request in INR")
+var paymentsUpiAmountConfigSchema = z4.discriminatedUnion("mode", [
+  z4.object({
+    mode: z4.literal("fixed").describe("A fixed amount configured by the form builder"),
+    amount: z4.number().positive().describe("Fixed amount to request in INR")
   }),
-  z3.object({
-    mode: z3.literal("range").describe("Respondent enters an amount within the configured range"),
-    minAmount: z3.number().positive().describe("Minimum allowed amount in INR"),
-    maxAmount: z3.number().positive().describe("Maximum allowed amount in INR"),
-    defaultAmount: z3.number().positive().optional().describe("Optional initial amount shown to the respondent")
+  z4.object({
+    mode: z4.literal("range").describe("Respondent enters an amount within the configured range"),
+    minAmount: z4.number().positive().describe("Minimum allowed amount in INR"),
+    maxAmount: z4.number().positive().describe("Maximum allowed amount in INR"),
+    defaultAmount: z4.number().positive().optional().describe("Optional initial amount shown to the respondent")
   }),
-  z3.object({
-    mode: z3.literal("question_mappings").describe("Amount is summed from one or more previous question answers"),
-    sources: z3.array(
-      z3.object({
-        sourceQuestionId: z3.string().describe(
+  z4.object({
+    mode: z4.literal("question_mappings").describe("Amount is summed from one or more previous question answers"),
+    sources: z4.array(
+      z4.object({
+        sourceQuestionId: z4.string().describe(
           "ID of the prior question whose answer contributes to the amount"
         ),
-        mappings: z3.array(
-          z3.object({
-            answerValue: z3.string().describe("Previous question answer value to match"),
-            amount: z3.number().nonnegative().describe(
+        mappings: z4.array(
+          z4.object({
+            answerValue: z4.string().describe("Previous question answer value to match"),
+            amount: z4.number().nonnegative().describe(
               "Amount to add in INR when this answer is selected"
             ),
-            label: z3.string().max(120).optional().describe("Optional display label for this mapped amount")
+            label: z4.string().max(120).optional().describe("Optional display label for this mapped amount")
           })
         ).min(1).describe("Answer-to-amount mappings for this source question")
       })
     ).min(1).describe("Previous question sources that contribute to the amount"),
-    fallbackAmount: z3.number().nonnegative().optional().describe("Optional amount to use when no source mapping matches")
+    fallbackAmount: z4.number().nonnegative().optional().describe("Optional amount to use when no source mapping matches")
   })
 ]).superRefine((data, ctx) => {
   if (data.mode !== "range") return;
   if (data.minAmount > data.maxAmount) {
     ctx.addIssue({
-      code: z3.ZodIssueCode.custom,
+      code: z4.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: z3.ZodIssueCode.custom,
+      code: z4.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: z3.literal("payments_upi").describe("Must be exactly 'payments_upi'"),
-  payeeVpa: z3.string().min(3).max(255).regex(
+  type: z4.literal("payments_upi").describe("Must be exactly 'payments_upi'"),
+  payeeVpa: z4.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: z3.string().max(100).optional().describe("Display name for the UPI payee"),
+  payeeName: z4.string().max(100).optional().describe("Display name for the UPI payee"),
   amount: paymentsUpiAmountConfigSchema.describe(
     "How the requested INR amount is determined"
   ),
-  sourceEmailQuestionId: z3.string().optional().describe(
+  sourceEmailQuestionId: z4.string().optional().describe(
     "Optional ID of the email question whose answer is used for form submission receipt emails"
   ),
-  transactionNote: z3.string().max(80).optional().describe(
+  transactionNote: z4.string().max(80).optional().describe(
     "Short note included in the UPI intent; the platform may append the Encatch reference"
   ),
-  transactionReferencePrefix: z3.string().max(24).optional().describe("Optional prefix for generated Encatch payment references"),
-  qrLabel: z3.string().max(100).optional().describe("Label shown above the UPI QR code"),
-  openUpiAppLabel: z3.string().max(80).optional().describe("Label for the mobile UPI intent button"),
-  copyUpiIdLabel: z3.string().max(80).optional().describe("Label for the copy UPI ID button"),
-  transactionIdLabel: z3.string().max(100).optional().describe("Label for the self-reported transaction ID / UTR input"),
-  transactionIdPlaceholder: z3.string().max(120).optional().describe("Placeholder for the transaction ID / UTR input")
+  transactionReferencePrefix: z4.string().max(24).optional().describe("Optional prefix for generated Encatch payment references"),
+  qrLabel: z4.string().max(100).optional().describe("Label shown above the UPI QR code"),
+  openUpiAppLabel: z4.string().max(80).optional().describe("Label for the mobile UPI intent button"),
+  copyUpiIdLabel: z4.string().max(80).optional().describe("Label for the copy UPI ID button"),
+  transactionIdLabel: z4.string().max(100).optional().describe("Label for the self-reported transaction ID / UTR input"),
+  transactionIdPlaceholder: z4.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 = z3.discriminatedUnion("type", [
+var combinedQuestionSchema = z4.discriminatedUnion("type", [
   ratingQuestionSchema,
   annotationQuestionSchema,
   welcomeQuestionSchema,
@@ -1662,215 +1896,6 @@ var combinedQuestionSchema = z3.discriminatedUnion("type", [
   paymentsUpiQuestionSchema
 ]);
 
-// src/schemas/fields/answer-schema.ts
-import { z as z4 } from "zod";
-var AnnotationMarkerSchema = z4.object({
-  markerNo: z4.string(),
-  timeline: z4.string(),
-  comment: z4.string()
-});
-var AnnotationSchema = z4.object({
-  fileType: z4.string(),
-  fileName: z4.string(),
-  markers: z4.array(AnnotationMarkerSchema)
-});
-var SignatureAnswerSchema = z4.object({
-  mode: z4.enum(["type", "draw", "upload"]).describe("The signing method the respondent used"),
-  fileUrl: z4.string().optional().describe(
-    "Secure URL to the signature artifact for draw and upload modes"
-  ),
-  typedName: z4.string().optional().describe("The name the respondent typed for type mode")
-}).describe("Answer for a signature question");
-var FileUploadAnswerItemSchema = z4.object({
-  fileUrl: z4.string().describe("Secure URL to the uploaded file"),
-  fileName: z4.string().describe("Original filename as provided by the respondent"),
-  fileSizeMb: z4.number().describe("File size in megabytes"),
-  mimeType: z4.string().optional().describe(
-    "MIME type of the uploaded file (e.g. 'application/pdf', 'image/jpeg')"
-  )
-}).describe("Metadata for a single uploaded file");
-var FileUploadAnswerSchema = z4.array(FileUploadAnswerItemSchema).describe(
-  "Answer for a file upload question; array supports single and multiple file uploads"
-);
-var PhoneNumberAnswerSchema = z4.object({
-  countryCode: z4.string().describe(
-    "Dialing country code including the + prefix (e.g. '+1', '+91')"
-  ),
-  number: z4.string().describe("Local phone number without the country code"),
-  e164: z4.string().optional().describe("Full phone number in E.164 format (e.g. '+14155552671')")
-}).describe("Answer for a phone number question");
-var AddressAnswerSchema = z4.object({
-  addressLine1: z4.string().optional().describe("Primary street address line"),
-  addressLine2: z4.string().optional().describe("Secondary address line (apartment, suite, etc.)"),
-  city: z4.string().optional().describe("City or town"),
-  stateProvince: z4.string().optional().describe("State, region, or province"),
-  postalCode: z4.string().optional().describe("ZIP or postal code"),
-  country: z4.string().optional().describe("Country name or ISO 3166-1 alpha-2 code")
-}).describe("Answer for an address question");
-var VideoAudioAnswerSchema = z4.object({
-  mode: z4.enum(["video", "audio", "photo", "text"]).describe("The answer mode the respondent chose"),
-  fileUrl: z4.string().optional().describe(
-    "Secure URL or temporary data URL to the recorded, captured, or uploaded video, audio, or image file"
-  ),
-  text: z4.string().optional().describe("Written answer for text mode"),
-  durationSeconds: z4.number().optional().describe(
-    "Actual recording length in seconds for video and audio modes (not used for photo)"
-  ),
-  transcriptText: z4.string().optional().describe("Auto-generated transcript for video and audio recordings")
-}).describe("Answer for a video and audio question");
-var QnaWithAiPairSchema = z4.object({
-  question: z4.string().describe("The question the respondent asked"),
-  answer: z4.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 = z4.array(QnaWithAiPairSchema).describe(
-  "Answer for a qna_with_ai question; ordered transcript of Q&A pairs from the session"
-);
-var SchedulerAnswerSchema = z4.discriminatedUnion("provider", [
-  z4.object({
-    provider: z4.literal("google_calendar").describe("The calendar integration used to make the booking"),
-    bookedAt: z4.string().describe(
-      "Unix timestamp in seconds as a string when the respondent confirmed the booking"
-    )
-  }),
-  z4.object({
-    provider: z4.literal("calendly").describe("The calendar integration used to make the booking"),
-    slotStart: z4.string().describe(
-      "ISO 8601 datetime of the booked slot start (e.g. '2026-05-15T14:00:00Z')"
-    ),
-    slotEnd: z4.string().describe(
-      "ISO 8601 datetime of the booked slot end (e.g. '2026-05-15T14:30:00Z')"
-    ),
-    eventId: z4.string().optional().describe("Calendly event UUID"),
-    bookedAt: z4.string().describe(
-      "Unix timestamp in seconds as a string when the respondent completed the booking"
-    )
-  })
-]).describe("Answer for a scheduler question");
-var PaymentsUpiAnswerSchema = z4.object({
-  transactionId: z4.string().describe(
-    "Respondent-entered UPI transaction ID / UTR; self-reported and not verified by Encatch"
-  ),
-  encatchPaymentReference: z4.string().describe(
-    "Opaque Encatch-generated reconciliation reference included in the UPI intent"
-  ),
-  amount: z4.string().trim().refine((s) => {
-    const n = Number(s);
-    return Number.isFinite(n) && n > 0;
-  }, { message: "Amount must be a positive numeric value" }).describe(
-    "INR amount shown to the respondent when the payment instruction was generated, as a decimal string (legacy numeric values are accepted when parsing)"
-  ),
-  currency: z4.literal("INR").describe("Currency for UPI payments"),
-  payeeVpa: z4.string().describe("UPI VPA shown to the respondent"),
-  payeeName: z4.string().optional().describe("Payee display name shown to the respondent"),
-  sourceEmail: z4.string().optional().describe("Email address resolved from the configured source email question"),
-  upiIntentUri: z4.string().optional().describe("Generated UPI intent URI shown to the respondent"),
-  selfReported: z4.literal(true).describe(
-    "Always true: Encatch records this answer but does not verify the payment"
-  )
-}).describe("Answer for a payments_upi question");
-var AnswerItemSchema = z4.object({
-  nps: z4.number().optional().describe("Net Promoter Score value (e.g., 0-10)"),
-  nestedSelection: z4.array(z4.string()).optional().describe("Array of selected nested option IDs"),
-  longText: z4.string().optional().describe("Long text answer, e.g., paragraph or essay"),
-  shortAnswer: z4.string().optional().describe("Short text answer, e.g., single sentence or word"),
-  singleChoice: z4.string().optional().describe("Single selected option value for single choice questions"),
-  rating: z4.number().optional().describe("Star rating value (e.g., 1-5)"),
-  yesNo: z4.boolean().optional().describe("Yes/no answer for yes_no questions (true = Yes, false = No)"),
-  consent: z4.boolean().optional().describe(
-    "Consent answer for consent questions (true = checked/agreed, false = unchecked)"
-  ),
-  multipleChoiceMultiple: z4.array(z4.string()).optional().describe(
-    "Array of selected option values for multiple choice questions"
-  ),
-  singleChoiceOther: z4.string().optional().describe(
-    'Free-text "other" answer for single choice questions when allowOther is enabled'
-  ),
-  multipleChoiceOther: z4.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"
-  ),
-  ratingMatrix: z4.record(z4.string(), z4.union([z4.number(), z4.string()])).optional().describe(
-    "Rating matrix answers keyed by statement value (export key), value is the selected scale value (number for likert/numerical, string for custom)"
-  ),
-  matrixSingleChoice: z4.record(z4.string(), z4.string()).optional().describe(
-    "Matrix single-choice answers keyed by row value (export key), map value is the selected column option value"
-  ),
-  matrixMultipleChoice: z4.record(z4.string(), z4.array(z4.string())).optional().describe(
-    "Matrix multiple-choice answers keyed by row value (export key), map value is array of selected column option values"
-  ),
-  others: z4.string().optional().describe(
-    "For multiple choice questions and single choice questions, this is the value of the other option"
-  ),
-  // Date question
-  date: z4.string().optional().describe(
-    "Answer for a date question; ISO 8601 format (YYYY-MM-DD or YYYY-MM-DDTHH:MM)"
-  ),
-  // CSAT question
-  csat: z4.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: z4.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: z4.array(z4.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: z4.array(z4.string()).optional().describe(
-    "Answer for a picture choice question; array of selected option values (single selection produces a one-element array)"
-  ),
-  pictureChoiceOther: z4.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
-  fileUpload: FileUploadAnswerSchema.optional().describe(
-    "Answer for a file upload question; array supports single and multiple file uploads"
-  ),
-  // Email question
-  email: z4.string().optional().describe("Answer for an email question; the submitted email address"),
-  // Number question
-  number: z4.string().optional().describe(
-    "Answer for a number question; the submitted numeric value as a string"
-  ),
-  // Website question
-  website: z4.string().optional().describe("Answer for a website question; the submitted URL"),
-  // Phone number question
-  phoneNumber: PhoneNumberAnswerSchema.optional().describe(
-    "Answer for a phone number question"
-  ),
-  // 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"
-  ),
-  // 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"
-  ),
-  // 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"
-);
-var AnswerSchema = AnswerItemSchema;
-
 // src/schemas/fields/form-schema.ts
 import { z as z5 } from "zod";
 var externalPublishingPropertiesSchema = z5.object({
@@ -2336,8 +2361,10 @@ var formConfigSchema = z13.object({
 }).describe("Configuration information for the feedback form");
 var questionResponseSchema = z13.object({
   questionId: z13.string().uuid().describe("Unique identifier for the question"),
-  answer: AnswerSchema.describe("The answer provided for this question"),
-  type: z13.string().describe("Type of the question (e.g., 'rating', 'single_choice')"),
+  answer: AnswerSchema.nullable().optional().describe(
+    "The answer provided for this question; null for display-only types (thank_you, welcome, exit_form) or unanswered questions on the respondent's path"
+  ),
+  type: z13.string().optional().describe("Type of the question (e.g., 'rating', 'single_choice')"),
   error: z13.string().optional().describe("Error message if any validation failed"),
   isOnPath: z13.boolean().optional().describe(
     "When present, whether this question was on the respondent's navigation path (e.g. logic jumps); false for questions not reached"
@@ -2380,6 +2407,26 @@ var submitFeedbackSchema = baseSubmitFeedbackSchema.extend({
   response: responseSchema.describe("User responses (required for full submit)")
 }).describe("Full submit feedback request schema (response required)");
 var feedbackRequestSchema = z13.union([partialFeedbackSchema, submitFeedbackSchema]).describe("Union schema for both partial and full feedback submissions");
+var formDetailsSchema = z13.object({
+  formConfigurationId: z13.string().uuid().describe("Server-issued configuration ID for this form"),
+  feedbackIdentifier: z13.string().optional().describe("Instance identifier for the feedback session"),
+  responseLanguageCode: z13.string().optional().describe("Two-letter language code for the response (e.g., 'en')"),
+  isPartialSubmit: z13.boolean().optional().describe("When true, marks this as a partial (mid-journey) submission"),
+  completionTimeInSeconds: z13.number().int().min(0).optional().describe("Total time taken to complete the form in seconds"),
+  response: z13.object({
+    questions: z13.array(questionResponseSchema).optional().describe("Array of per-question responses"),
+    context: z13.record(z13.string(), z13.unknown()).optional().describe("Liquid variable substitution values from the showForm context option"),
+    contact: z13.record(z13.string(), z13.unknown()).optional().describe("Contact properties from the server for Liquid substitution"),
+    sourceTrackingFieldValues: z13.record(z13.string(), z13.string()).optional().describe("Source tracking field values captured at survey load time")
+  }).optional().describe("User responses to the form questions"),
+  visitedQuestionIds: z13.array(z13.string()).optional().describe("Ordered list of question IDs the respondent actually navigated to"),
+  context: z13.record(z13.string(), z13.union([z13.string(), z13.number(), z13.boolean()])).optional().describe("Caller-provided metadata attached to this submission")
+}).describe("Form details for an SDK-style submit-form request");
+var submitFormRequestSchema = z13.object({
+  triggerType: z13.enum(["automatic", "manual"]).optional().describe("Whether the form was triggered automatically or manually"),
+  formDetails: formDetailsSchema.describe("Core submission payload"),
+  $deviceInfo: z13.record(z13.string(), z13.unknown()).optional().describe("Device and SDK metadata automatically injected by the SDK")
+}).describe("Complete submit-form request envelope (SDK-facing contract)");
 
 // src/schemas/api/fetch-feedback-schema.ts
 import { z as z14 } from "zod";
@@ -2724,6 +2771,7 @@ export {
   focalPointSchema,
   formConfigSchema,
   formConfigurationResponseSchema,
+  formDetailsSchema,
   formPropertiesSchema,
   gradientAttachmentSchema,
   imageAttachmentSchema,
@@ -2815,6 +2863,7 @@ export {
   splitLayoutSchema,
   stackLayoutSchema,
   submitFeedbackSchema,
+  submitFormRequestSchema,
   thankYouQuestionSchema,
   thankYouQuestionTranslationSchema,
   themeColorsSchema,