@wix/auto_sdk_forms_submissions 1.0.48 → 1.0.49

package/build/internal/cjs/{forms-v4-submission-submissions.universal-DYvuvm51.d.ts → forms-v4-submission-submissions.universal-38ZdY7HP.d.ts}

@@ -272,18 +272,19 @@ interface CreateCheckoutFromSubmissionRequestFormSchemaIdentifierOneOf {
 }
 interface Form {
     /**
-     * Form ID.
+     * Form schema ID.
      * @format GUID
      * @readonly
      */
     _id?: string | null;
     /**
-     * List of form fields that represent input elements.
+     * Form fields that define the input elements and their validation rules.
      * @maxSize 500
      */
     formFields?: Field[];
     /**
-     * Defines the layout for form fields in each submission step.
+     * Layout configuration that defines how form fields are organized across multiple steps.
+     * Each step represents a page of the form.
      * @maxSize 100
      */
     steps?: Step[];
@@ -296,17 +297,18 @@ interface Form {
      */
     rules?: FormRule[];
     /**
-     * Represents the current state of an item. Each time the item is modified, its `revision` changes. For an update operation to succeed, you MUST pass the latest revision.
+     * Revision number, which increments by 1 each time the form schema is updated.
+     * To prevent conflicting changes, the current revision must be passed when updating the form schema.
      * @readonly
      */
     revision?: string | null;
     /**
-     * Date of creation.
+     * Date and time when the form schema was created.
      * @readonly
      */
     _createdDate?: Date | null;
     /**
-     * Date of last update.
+     * Date and time when the form schema was last updated.
      * @readonly
      */
     _updatedDate?: Date | null;
@@ -323,51 +325,60 @@ interface Form {
      */
     deletedFieldsV2?: FormFieldV2[];
     /**
-     * List of form fields which were soft deleted.
+     * Form fields that were soft deleted.
      * @maxSize 150
      * @readonly
      */
     deletedFormFields?: Field[];
-    /** Data extensions ExtendedFields. */
+    /** Data extensions for storing additional custom properties. */
     extendedFields?: ExtendedFields;
     /**
-     * Identifies the namespace that the form belongs to.
+     * Unique identifier for the app that owns this form schema.
+     * For example, `wix.form_app.form` for Wix Forms.
+     *
+     * See a list of namespaces for [apps made by Wix](https://dev.wix.com/docs/api-reference/crm/forms/form-schemas/introduction#namespaces-of-apps-made-by-wix) section.
      * @minLength 10
      * @maxLength 50
      * @immutable
      */
     namespace?: string;
     /**
-     * Media folder ID.
+     * Media folder ID for storing uploaded files from form submissions.
      * @maxLength 100
      * @readonly
      */
     mediaFolderId?: string | null;
-    /** Rules that limit submissions on this form. */
+    /** Submission limits that can automatically disable the form when reached. */
     limitationRule?: LimitationRule;
     /**
-     * Spam filter protection level.
-     * Default: ADVANCED.
+     * Level of spam protection applied to form submissions.
+     *
+     * Default: `ADVANCED`
      */
     spamFilterProtectionLevel?: SpamFilterProtectionLevelWithLiterals;
-    /** Required indicator properties. */
+    /** Configuration for how required field indicators are displayed to the submitter. */
     requiredIndicatorProperties?: RequiredIndicatorProperties;
-    /** Settings for actions to be taken after form submission. */
+    /** Configuration for actions taken after a form is successfully submitted. */
     submitSettings?: SubmitSettings;
-    /** Message shown when the form is disabled */
+    /**
+     * Message displayed to visitors when the form is disabled.
+     * This allows you to inform submitters why the form isn't available.
+     */
     disabledFormMessage?: RichContent;
     /**
-     * Identifies if the form is enabled.
-     * Default true
+     * Whether the form schema is enabled.
+     *
+     * Default: `true`
      */
     enabled?: boolean | null;
     /**
-     * Form name.
+     * Display name of the form schema.
      * @maxLength 200
      */
     name?: string | null;
     /**
-     * Form rules, can be applied to layout and items properties.
+     * Business logic rules that can modify form behavior based on user input or other conditions.
+     * These rules can show/hide fields, change validation, or trigger actions.
      * @maxSize 100
      */
     formRules?: Rule[];
@@ -682,18 +693,18 @@ declare enum ValidationFormat {
 type ValidationFormatWithLiterals = ValidationFormat | 'UNDEFINED' | 'WIX_FILE' | 'PAYMENT' | 'MULTILINE_ADDRESS' | 'SCHEDULING';
 interface PaymentType {
     /**
-     * Field mapped to products.
+     * Products the submitter can select to make a payment for.
      * @minSize 1
      * @maxSize 100
      */
     products?: Product[];
     /**
-     * Minimum amount of different products.
+     * Minimum number of different products that must be selected.
      * @max 100
      */
     minItems?: number | null;
     /**
-     * Maximum amount of different products.
+     * Maximum number of different products that can be selected.
      * @max 100
      */
     maxItems?: number | null;
@@ -701,7 +712,7 @@ interface PaymentType {
 declare enum ProductType {
     /** Unknown product type. */
     UNKNOWN_PRODUCT_TYPE = "UNKNOWN_PRODUCT_TYPE",
-    /** Shippable (physical) product. */
+    /** Physical product that can be shipped. */
     SHIPPABLE = "SHIPPABLE",
     /** Digital product. */
     DIGITAL = "DIGITAL"
@@ -711,22 +722,22 @@ type ProductTypeWithLiterals = ProductType | 'UNKNOWN_PRODUCT_TYPE' | 'SHIPPABLE
 declare enum PriceType {
     /** Unknown price type. */
     UNKNOWN_PRICE_TYPE = "UNKNOWN_PRICE_TYPE",
-    /** Fixed price. */
+    /** Product has a single, unchanging price. */
     FIXED_PRICE = "FIXED_PRICE",
-    /** Dynamic price from price range. */
+    /** Product price can vary within a specified range. */
     DYNAMIC_PRICE = "DYNAMIC_PRICE"
 }
 /** @enumType */
 type PriceTypeWithLiterals = PriceType | 'UNKNOWN_PRICE_TYPE' | 'FIXED_PRICE' | 'DYNAMIC_PRICE';
 interface QuantityLimit {
     /**
-     * Minimum quantity.
+     * Minimum quantity that must be selected for this product.
      * @min 1
      * @max 100000
      */
     minimum?: number | null;
     /**
-     * Maximum quantity.
+     * Maximum quantity that can be selected for this product.
      * @min 1
      * @max 100000
      */
@@ -734,27 +745,35 @@ interface QuantityLimit {
 }
 interface FixedPriceOptions {
     /**
-     * Fixed price monetary amount. Decimal string with a period as a decimal separator (e.g., 3.99).
+     * Fixed price of the product.
+     *
+     * Specified as a decimal string with period as decimal separator. For example, `"3.99"`.
      * @decimalValue options { gte:0.00, maxScale:2 }
      */
     price?: string;
 }
 interface DynamicPriceOptions {
     /**
-     * Minimal price monetary amount.
+     * Minimum price of the product.
+     *
+     * Specified as a decimal string with period as decimal separator. For example, `"1.00"`.
      * @decimalValue options { gte:0.00, maxScale:2 }
      */
     minPrice?: string;
     /**
-     * Maximal price monetary amount.
+     * Maximum monetary price of the product.
+     *
+     * Specified as a decimal string with period as decimal separator. For example, `"10.00"`.
+     *
+     * If not specified, there is no upper limit on the price.
      * @decimalValue options { gte:0.00, maxScale:2 }
      */
     maxPrice?: string | null;
 }
 interface Product extends ProductPriceOptionsOneOf {
-    /** Fixed price options. */
+    /** Configuration for products with fixed pricing. */
     fixedPriceOptions?: FixedPriceOptions;
-    /** Dynamic price options. */
+    /** Configuration for products with variable pricing within a range. */
     dynamicPriceOptions?: DynamicPriceOptions;
     /**
      * Product ID.
@@ -766,24 +785,25 @@ interface Product extends ProductPriceOptionsOneOf {
     productType?: ProductTypeWithLiterals;
     /** Price type. */
     priceType?: PriceTypeWithLiterals;
-    /** Quantity limit. */
+    /** Limits on how many units of this product can be selected. */
     quantityLimit?: QuantityLimit;
 }
 /** @oneof */
 interface ProductPriceOptionsOneOf {
-    /** Fixed price options. */
+    /** Configuration for products with fixed pricing. */
     fixedPriceOptions?: FixedPriceOptions;
-    /** Dynamic price options. */
+    /** Configuration for products with variable pricing within a range. */
     dynamicPriceOptions?: DynamicPriceOptions;
 }
 interface MultilineAddressValidation {
     /**
-     * Allowed countries. No countries treated as all.
+     * Countries from which addresses are accepted.
+     * If empty, addresses from all countries are allowed.
      * @format COUNTRY
      * @maxSize 200
      */
     allowedCountries?: string[];
-    /** Fields overrides. */
+    /** Customization configuration for individual address field components. */
     fields?: FieldsOverrides;
 }
 interface FieldOverrides {
@@ -791,21 +811,21 @@ interface FieldOverrides {
     required?: boolean;
 }
 interface FieldsOverrides {
-    /** Subdivision. */
+    /** Subdivision settings. */
     subdivision?: FieldOverrides;
-    /** City. */
+    /** City settings. */
     city?: FieldOverrides;
-    /** Postal code. */
+    /** Postal code settings. */
     postalCode?: FieldOverrides;
-    /** Street name. */
+    /** Street name settings. */
     streetName?: FieldOverrides;
-    /** Street number. */
+    /** Street number settings. */
     streetNumber?: FieldOverrides;
-    /** Address line. */
+    /** Address line settings. */
     addressLine?: FieldOverrides;
-    /** Address line 2. */
+    /** Address line 2 settings. */
     addressLine2?: FieldOverrides;
-    /** Country. */
+    /** Country settings. */
     country?: FieldOverrides;
 }
 interface NestedFormFieldOverrides {
@@ -999,30 +1019,32 @@ declare enum InputFieldStringComponentType {
 type InputFieldStringComponentTypeWithLiterals = InputFieldStringComponentType | 'UNKNOWN_COMPONENT_TYPE' | 'TEXT_INPUT' | 'RADIO_GROUP' | 'DROPDOWN' | 'DATE_TIME' | 'PHONE_INPUT' | 'DATE_INPUT' | 'TIME_INPUT' | 'DATE_PICKER' | 'SERVICES_DROPDOWN';
 interface TextInput {
     /**
-     * Label of the field
+     * Field label.
      * @maxLength 350
      */
     label?: string | null;
-    /** Description of the field */
+    /** Additional description or instructions for the field. */
     description?: RichContent;
     /**
-     * Placeholder for the value input
+     * Placeholder text shown inside the field when it's empty.
+     * Useful for providing a hint about the expected format or content.
      * @maxLength 100
      */
     placeholder?: string | null;
     /**
-     * Flag identifying to hide or not label
-     * Default: true
+     * Whether to display the field label.
+     *
+     * Default: `true`
      */
     showLabel?: boolean | null;
     /**
-     * Default value for the text input
+     * Default value for the field. This value is pre-populated in the field when the form loads.
      * @maxLength 20000
      */
     default?: string | null;
-    /** Media item. Media, associated with field, like image. */
+    /** Media content associated with the field, such as an image. */
     media?: MediaItem;
-    /** Settings for media item */
+    /** Configuration for the media content. */
     mediaSettings?: MediaSettings;
 }
 interface RichContent {
@@ -2767,27 +2789,27 @@ interface MediaItemMediaOneOf {
 }
 interface MediaSettings {
     /**
-     * Specifies where image should be displayed.
-     * Default: BELOW
+     * Specifies where the image should be displayed relative to the field's label.
+     * Default: `BELOW`
      */
     imagePosition?: ImagePositionWithLiterals;
     /**
-     * Specifies image alignment.
-     * Default: CENTER
+     * Specifies the image alignment.
+     * Default: `CENTER`
      */
     imageAlignment?: AlignmentWithLiterals;
     /**
-     * Defines how an image should be resized to fit.
-     * Default: COVER
+     * Specifies how an image should be resized to fit.
+     * Default: `COVER`
      */
     imageFit?: ImageFitWithLiterals;
 }
 declare enum ImagePosition {
     /** Undefined position. */
     UNKNOWN_IMAGE_POSITION = "UNKNOWN_IMAGE_POSITION",
-    /** Above label. */
+    /** Above the field's label. */
     ABOVE = "ABOVE",
-    /** Below label. */
+    /** Below the field's label. */
     BELOW = "BELOW"
 }
 /** @enumType */
@@ -2795,70 +2817,71 @@ type ImagePositionWithLiterals = ImagePosition | 'UNKNOWN_IMAGE_POSITION' | 'ABO
 declare enum Alignment {
     /** Undefined alignment. */
     UNKNOWN_ALIGNMENT = "UNKNOWN_ALIGNMENT",
-    /** Left. */
+    /** Align left. */
     LEFT = "LEFT",
-    /** Center. */
+    /** Align center. */
     CENTER = "CENTER",
-    /** Right. */
+    /** Align right. */
     RIGHT = "RIGHT"
 }
 /** @enumType */
 type AlignmentWithLiterals = Alignment | 'UNKNOWN_ALIGNMENT' | 'LEFT' | 'CENTER' | 'RIGHT';
 declare enum ImageFit {
     UNKNOWN_IMAGE_FIT = "UNKNOWN_IMAGE_FIT",
-    /** Image is scaled to maintain its aspect ratio while filling the element's entire content box. Portions of the image may be clipped if the aspect ratios do not match. */
+    /** Scale the image to maintain its aspect ratio while filling the element's entire content box. Portions of the image may be clipped if the aspect ratios don't match. */
     COVER = "COVER",
-    /** Image is resized to fill the element's content box. Aspect ratio may not be preserved. */
+    /** Resize the image to fill the element's content box. The image's original sspect ratio may not be preserved. */
     CONTAIN = "CONTAIN"
 }
 /** @enumType */
 type ImageFitWithLiterals = ImageFit | 'UNKNOWN_IMAGE_FIT' | 'COVER' | 'CONTAIN';
 interface RadioGroup {
     /**
-     * Label of the field
+     * Field label.
      * @maxLength 350
      */
     label?: string | null;
-    /** Description of the field */
+    /** Additional description or instructions for the field. */
     description?: RichContent;
     /**
-     * Flag identifying to show option allowing input custom value
-     * List of options to select from
+     * List of options the submitter can select from.
      * @maxSize 400
      */
     options?: RadioGroupOption[];
     /**
-     * Flag identifying to hide or not label
-     * Default: true
+     * Whether to display the field label.
+     *
+     * Default: `true`
      */
     showLabel?: boolean | null;
-    /** Option which can be specified by UoU, enabled when this object is specified. */
+    /** Custom option which can be specified by the submitter. */
     customOption?: CustomOption;
     /**
      * Specifies the number of columns used to display the selections within the component.
-     * Default: ONE
+     *
+     * Default: `ONE`
      */
     numberOfColumns?: NumberOfColumnsWithLiterals;
-    /** Media item. Media, associated with field, like image. */
+    /** Media content associated with the field, such as an image. */
     media?: MediaItem;
-    /** Settings for media item */
+    /** Configuration for the media content. */
     mediaSettings?: MediaSettings;
 }
 interface RadioGroupOption {
     /**
-     * Selectable option label
+     * Selectable option label.
      * @maxLength 400
      */
     label?: string | null;
     /**
-     * Selectable option value, which is saved to DB.
+     * Value stored on submission when this option is selected.
      * @maxLength 20000
      */
     value?: string | null;
-    /** Flag identifying that option should be selected by default */
+    /** Whether this option is selected by default. */
     default?: boolean;
     /**
-     * Option id. Used as binding for translations
+     * Option ID. Used to connect this option with [Wix Multilingual](https://dev.wix.com/docs/api-reference/business-management/multilingual/translation/introduction) for translation.
      * @format GUID
      * @immutable
      */
@@ -2866,12 +2889,12 @@ interface RadioGroupOption {
 }
 interface CustomOption {
     /**
-     * Label of custom option input
+     * Custom option label.
      * @maxLength 350
      */
     label?: string | null;
     /**
-     * Placeholder of custom option input
+     * Custom option placeholder text.
      * @maxLength 100
      */
     placeholder?: string | null;
@@ -2892,49 +2915,50 @@ declare enum NumberOfColumns {
 type NumberOfColumnsWithLiterals = NumberOfColumns | 'UNKNOWN_NUMBER_OF_COLUMNS' | 'ZERO' | 'ONE' | 'TWO' | 'THREE';
 interface Dropdown {
     /**
-     * Label of the field
+     * Field label.
      * @maxLength 350
      */
     label?: string | null;
-    /** Description of the field */
+    /** Additional description or instructions for the field. */
     description?: RichContent;
     /**
-     * List of options to select from
+     * List of options the submitter can select from.
      * @maxSize 400
      */
     options?: DropdownOption[];
     /**
-     * Flag identifying to hide or not label
-     * Default: true
+     * Whether to display the field label.
+     *
+     * Default: `true`
      */
     showLabel?: boolean | null;
-    /** Option which can be specified by UoU, enabled when this object is specified. */
+    /** Custom option which can be specified by the submitter. */
     customOption?: CustomOption;
     /**
-     * Placeholder of dropdown input
+     * Placeholder text shown when no option is selected.
      * @maxLength 100
      */
     placeholder?: string | null;
-    /** Media item. Media, associated with field, like image. */
+    /** Media content associated with the field, such as an image. */
     media?: MediaItem;
-    /** Settings for media item */
+    /** Configuration for the media content. */
     mediaSettings?: MediaSettings;
 }
 interface DropdownOption {
     /**
-     * Selectable option label
+     * Selectable option label.
      * @maxLength 400
      */
     label?: string | null;
     /**
-     * Selectable option value, which is saved to DB.
+     * Value stored on submission when this option is selected.
      * @maxLength 20000
      */
     value?: string | null;
-    /** Flag identifying that option should be selected by default */
+    /** Whether this option is selected by default. */
     default?: boolean;
     /**
-     * Option id. Used as binding for translations
+     * Option ID. Used to connect this option with [Wix Multilingual](https://dev.wix.com/docs/api-reference/business-management/multilingual/translation/introduction) for translation.
      * @format GUID
      * @immutable
      */
@@ -2942,35 +2966,38 @@ interface DropdownOption {
 }
 interface DateTimeInput {
     /**
-     * Label of the field. Displayed text for the date/time input.
+     * Field label.
      * @maxLength 350
      */
     label?: string | null;
-    /** Description of the field. Additional information about the date/time input. */
+    /** Additional description or instructions for the field. */
     description?: RichContent;
     /**
-     * Flag identifying whether to show or hide the label.
-     * Default: true
+     * Whether to display the field label.
+     *
+     * Default: `true`
      */
     showLabel?: boolean | null;
     /**
-     * Flag identifying whether to show or hide the placeholder.
-     * Default: true
+     * Whether to display placeholder text in the field when it's empty.
+     *
+     * Default: `true`
      */
     showPlaceholder?: boolean | null;
     /**
-     * Flag indicating whether to use the 24-hour time format.
-     * Default: false.
+     * Whether to use 24-hour time format.
+     *
+     * Default: `false`
      */
     use24HourFormat?: boolean;
     /**
-     * Default value for the date time input.
+     * Default value for the field. This value is pre-populated in the field when the form loads.
      * @format LOCAL_DATE_TIME
      */
     default?: string | null;
-    /** Media item. Media, associated with field, like image. */
+    /** Media content associated with the field, such as an image. */
     media?: MediaItem;
-    /** Settings for media item */
+    /** Configuration for the media content. */
     mediaSettings?: MediaSettings;
     /**
      * Flag identifying whether to show or hide the date labels.
@@ -2980,64 +3007,68 @@ interface DateTimeInput {
 }
 interface PhoneInput {
     /**
-     * Label of the field
+     * Field label.
      * @maxLength 350
      */
     label?: string | null;
-    /** Description of the field */
+    /** Additional description or instructions for the field. */
     description?: RichContent;
     /**
-     * Placeholder for the value input
+     * Placeholder text shown inside the field when it's empty.
      * @maxLength 100
      */
     placeholder?: string | null;
     /**
-     * Flag identifying to show label or not
-     * Default: true
+     * Whether to display the field label.
+     *
+     * Default: `true`
      */
     showLabel?: boolean | null;
     /**
-     * Default value of the country code
+     * Default country code for the phone number input. Two-letter country code in ISO-3166 alpha-2 format.
      * @minLength 1
      * @maxLength 5
      */
     defaultCountryCode?: string | null;
     /**
-     * Flag identifying to show country flag or not
-     * Default: false
+     * Whether to display the country flag next to the country code.
+     *
+     * Default: `false`
      */
     showCountryFlag?: boolean;
-    /** Media item. Media, associated with field, like image. */
+    /** Media content associated with the field, such as an image. */
     media?: MediaItem;
-    /** Settings for media item */
+    /** Configuration for the media content. */
     mediaSettings?: MediaSettings;
 }
 interface DateInput {
     /**
-     * Label of the field. Displayed text for the date/time input.
+     * Field label.
      * @maxLength 350
      */
     label?: string | null;
-    /** Description of the field. Additional information about the date/time input. */
+    /** Additional description or instructions for the field. */
     description?: RichContent;
     /**
-     * Flag identifying whether to show or hide the label.
-     * Default: true
+     * Whether to display the field label.
+     *
+     * Default: `true`
      */
     showLabel?: boolean | null;
     /**
-     * Flag identifying whether to show or hide the placeholder.
-     * Default: true
+     * Whether to display placeholder text in the field when it's empty.
+     *
+     * Default: `true`
      */
     showPlaceholder?: boolean | null;
     /**
-     * Default value for the date input.
+     * Default value for the field. This value is pre-populated in the field when the form loads.
      * @format LOCAL_DATE
      */
     default?: string | null;
-    /** Media item. Media, associated with field, like image. */
+    /** Media content associated with the field, such as an image. */
     media?: MediaItem;
-    /** Settings for media item */
+    /** Configuration for the media content. */
     mediaSettings?: MediaSettings;
     /**
      * Flag identifying whether to show or hide the date labels.
@@ -3047,65 +3078,69 @@ interface DateInput {
 }
 interface TimeInput {
     /**
-     * Label of the field. Displayed text for the date/time input.
+     * Field label.
      * @maxLength 350
      */
     label?: string | null;
-    /** Description of the field. Additional information about the date/time input. */
+    /** Field description. */
     description?: RichContent;
     /**
-     * Flag identifying whether to show or hide the label.
-     * Default: true
+     * Whether to display the label.
+     *
+     * Default: `true`
      */
     showLabel?: boolean | null;
     /**
-     * Flag identifying whether to show or hide the placeholder.
-     * Default: true
+     * Whether to display placeholder text in the field when it's empty.
+     *
+     * Default: `true`
      */
     showPlaceholder?: boolean | null;
     /**
-     * Flag indicating whether to use the 24-hour time format.
-     * Default: false.
+     * Whether to use 24-hour time format.
+     *
+     * Default: `false`
      */
     use24HourFormat?: boolean;
     /**
-     * Default value for the time input.
+     * Default value for the field. This value is pre-populated in the field when the form loads.
      * @format LOCAL_TIME
      */
     default?: string | null;
-    /** Media item. Media, associated with field, like image. */
+    /** Media content associated with the field, such as an image. */
     media?: MediaItem;
-    /** Settings for media item */
+    /** Configuration for the media content. */
     mediaSettings?: MediaSettings;
 }
 interface DatePicker {
     /**
-     * Label of the field. Displayed text for the date/time input.
+     * Field label.
      * @maxLength 350
      */
     label?: string | null;
-    /** Description of the field. Additional information about the date/time input. */
+    /** Additional description or instructions for the field. */
     description?: RichContent;
     /**
-     * Flag identifying whether to show or hide the label.
-     * Default: true
+     * Whether to display the field label.
+     *
+     * Default: `true`
      */
     showLabel?: boolean | null;
     /**
-     * Placeholder of date picker input
+     * Placeholder text shown when no date is selected.
      * @maxLength 100
      */
     placeholder?: string | null;
-    /** First day of the week displayed on date picker. */
+    /** First day of the week displayed on the date picker. */
     firstDayOfWeek?: FirstDayOfWeekWithLiterals;
     /**
-     * Default value for the date picker.
+     * Default value for the field. This value is pre-populated in the field when the form loads.
      * @format LOCAL_DATE
      */
     default?: string | null;
-    /** Media item. Media, associated with field, like image. */
+    /** Media content associated with the field, such as an image. */
     media?: MediaItem;
-    /** Settings for media item */
+    /** Configuration for the media content. */
     mediaSettings?: MediaSettings;
 }
 declare enum FirstDayOfWeek {
@@ -3118,26 +3153,27 @@ declare enum FirstDayOfWeek {
 type FirstDayOfWeekWithLiterals = FirstDayOfWeek | 'MONDAY' | 'SUNDAY';
 interface ServicesDropdown {
     /**
-     * Label of the field
+     * Field label.
      * @maxLength 350
      */
     label?: string | null;
     /**
-     * Flag identifying to hide or not label
-     * Default: true
+     * Whether to display the field label.
+     *
+     * Default: `true`
      */
     showLabel?: boolean | null;
     /**
-     * Placeholder of services dropdown input
+     * Placeholder text shown when no service is selected.
      * @maxLength 100
      */
     placeholder?: string | null;
     /**
-     * List of service options to select from
+     * List of service options the submitter can select from.
      * @maxSize 400
      */
     options?: ServiceOption[];
-    /** Option which can be specified by UoU, enabled when this object is specified. */
+    /** Custom option which can be specified by the submitter. */
     customOption?: CustomOption;
 }
 interface ServiceOption {
@@ -3181,51 +3217,53 @@ declare enum InputFieldNumberComponentType {
 type InputFieldNumberComponentTypeWithLiterals = InputFieldNumberComponentType | 'UNKNOWN_COMPONENT_TYPE' | 'NUMBER_INPUT' | 'RATING_INPUT';
 interface NumberInput {
     /**
-     * Label of the field
+     * Field label.
      * @maxLength 350
      */
     label?: string | null;
-    /** Description of the field */
+    /** Additional description or instructions for the field. */
     description?: RichContent;
     /**
-     * Placeholder for the value input
+     * Placeholder text shown inside the field when it's empty.
      * @maxLength 100
      */
     placeholder?: string | null;
     /**
-     * Flag identifying to hide or not label
-     * Default: true
+     * Whether to display the field label.
+     *
+     * Default: `true`
      */
     showLabel?: boolean | null;
-    /** Default value for the number input */
+    /** Default value for the field. This value is pre-populated in the field when the form loads. */
     default?: number | null;
-    /** Media item. Media, associated with field, like image. */
+    /** Media content associated with the field, such as an image. */
     media?: MediaItem;
-    /** Settings for media item */
+    /** Configuration for the media content. */
     mediaSettings?: MediaSettings;
 }
 interface RatingInput {
     /**
-     * Label of the field
+     * Field label.
      * @maxLength 350
      */
     label?: string | null;
-    /** Description of the field */
+    /** Additional description or instructions for the field. */
     description?: RichContent;
     /**
-     * Flag identifying to hide label or not
-     * Default: true
+     * Whether to display the field label.
+     *
+     * Default: `true`
      */
     showLabel?: boolean | null;
     /**
-     * Default rating
+     * Default rating value for the field.
      * @min 1
      * @max 5
      */
     defaultValue?: number | null;
-    /** Media item. Media, associated with field, like image. */
+    /** Media content associated with the field, such as an image. */
     media?: MediaItem;
-    /** Settings for media item */
+    /** Configuration for the media content. */
     mediaSettings?: MediaSettings;
 }
 interface InputFieldBooleanType {
@@ -3242,11 +3280,12 @@ declare enum InputFieldBooleanComponentType {
 /** @enumType */
 type InputFieldBooleanComponentTypeWithLiterals = InputFieldBooleanComponentType | 'UNKNOWN_COMPONENT_TYPE' | 'CHECKBOX';
 interface Checkbox {
-    /** Label of the field */
+    /** Field label. */
     label?: RichContent;
     /**
-     * Flag identifying if checked by default
-     * Default: false
+     * Whether the checkbox is selected by default when the form loads.
+     *
+     * Default: `false`
      */
     checked?: boolean;
 }
@@ -3373,92 +3412,96 @@ declare enum InputFieldArrayComponentType {
 type InputFieldArrayComponentTypeWithLiterals = InputFieldArrayComponentType | 'UNKNOWN_COMPONENT_TYPE' | 'CHECKBOX_GROUP' | 'TAGS' | 'SERVICES_CHECKBOX_GROUP';
 interface CheckboxGroup {
     /**
-     * Label of the field
+     * Field label.
      * @maxLength 350
      */
     label?: string | null;
-    /** Description of the field */
+    /** Additional description or instructions for the field. */
     description?: RichContent;
     /**
-     * List of options to select from
+     * List of options the submitter can select from.
      * @maxSize 400
      */
     options?: Option[];
     /**
-     * Flag identifying to hide or not label
-     * Default: true
+     * Whether to display the field label.
+     *
+     * Default: `true`
      */
     showLabel?: boolean | null;
-    /** Option which can be specified by UoU, enabled when this object is specified. */
+    /** Custom option which can be specified by the submitter. */
     customOption?: CustomOption;
     /**
      * Specifies the number of columns used to display the selections within the component.
-     * Default: ONE
+     *
+     * Default: `ONE`
      */
     numberOfColumns?: NumberOfColumnsWithLiterals;
-    /** Media item. Media, associated with field, like image. */
+    /** Media content associated with the field, such as an image. */
     media?: MediaItem;
-    /** Settings for media item */
+    /** Configuration for the media content. */
     mediaSettings?: MediaSettings;
 }
 interface Option {
     /**
-     * Selectable option label
+     * Selectable option label.
      * @maxLength 400
      */
     label?: string | null;
-    /** Selectable option value, which is saved to DB. */
+    /** Value stored on submission when this option is selected. */
     value?: any;
-    /** Flag identifying that option should be selected by default */
+    /** Whether this option is selected by default. */
     default?: boolean;
     /**
-     * Option id. Used as binding for translations
+     * Option ID. Used to connect this option with [Wix Multilingual](https://dev.wix.com/docs/api-reference/business-management/multilingual/translation/introduction) for translation.
      * @format GUID
      * @immutable
      */
     _id?: string;
-    /** Media item. Media, associated with option, like image. */
+    /** Media content associated with this option. */
     media?: MediaItem;
 }
 interface Tags {
     /**
-     * Label of the field
+     * Field label.
      * @maxLength 350
      */
     label?: string | null;
-    /** Description of the field */
+    /** Additional description or instructions for the field. */
     description?: RichContent;
     /**
-     * List of options to select from
+     * List of options the submitter can select from.
      * @maxSize 400
      */
     options?: TagsOption[];
     /**
-     * Flag identifying to hide or not label
-     * Default: true
+     * Whether to display the label.
+     *
+     * Default: `true`
      */
     showLabel?: boolean | null;
-    /** Option which can be specified by UoU, enabled when this object is specified. */
+    /** Custom option which can be specified by the submitter. */
     customOption?: CustomOption;
     /**
      * Specifies the number of columns used to display the selections within the component.
-     * Default: ONE
+     *
+     * Default: `ONE`
      */
     numberOfColumns?: NumberOfColumnsWithLiterals;
     /** Media item. Media, associated with field, like image. */
     media?: MediaItem;
-    /** Settings for media item */
+    /** Configuration for the media item. */
     mediaSettings?: MediaSettings;
 }
 interface TagsOption {
     /**
-     * Selectable option label
+     * Selectable option label.
      * @maxLength 400
      */
     label?: string | null;
-    /** Selectable option value, which is saved to DB. */
+    /** Value stored on submission when this option is selected. */
     value?: any;
-    /** Flag identifying that option should be selected by default */
+    /** Flag identifying that option should be selected by default. */
     default?: boolean;
     /**
      * Option id. Used as binding for translations
@@ -3466,7 +3509,7 @@ interface TagsOption {
      * @immutable
      */
     _id?: string;
-    /** Media item. Media, associated with option, like image. */
+    /** Media content associated with the option, such as an image. */
     media?: MediaItem;
 }
 interface ServicesCheckboxGroup {
@@ -3504,13 +3547,13 @@ declare enum InputFieldWixFileComponentType {
 type InputFieldWixFileComponentTypeWithLiterals = InputFieldWixFileComponentType | 'UNKNOWN_COMPONENT_TYPE' | 'FILE_UPLOAD' | 'SIGNATURE';
 interface FileType {
     /**
-     * Amount of files allowed to upload
+     * Maximum number of files that can be uploaded.
      * @min 1
      * @max 30
      */
     fileLimit?: number;
     /**
-     * Supported file formats for upload
+     * Supported file formats for uploaded files.
      * @maxSize 5
      */
     uploadFileFormats?: UploadFileFormatWithLiterals[];
@@ -3533,50 +3576,52 @@ declare enum UploadFileFormat {
 type UploadFileFormatWithLiterals = UploadFileFormat | 'UNKNOWN_UPLOAD_FILE_FORMAT' | 'VIDEO' | 'IMAGE' | 'AUDIO' | 'DOCUMENT' | 'ARCHIVE';
 interface FileUpload {
     /**
-     * Selectable option label
+     * Field label.
      * @maxLength 350
      */
     label?: string | null;
-    /** Description of the field */
+    /** Additional description or instructions for the field. */
     description?: RichContent;
     /**
-     * Flag identifying to hide or not label
-     * Default: true
+     * Whether to display the field label.
+     *
+     * Default: `true`
      */
     showLabel?: boolean | null;
     /**
-     * Text on upload button
+     * Text displayed on the upload button.
      * @maxLength 500
      */
     buttonText?: string | null;
     /**
-     * Custom text which appears when file is uploaded, if missing file name will be shown
+     * Custom text displayed when a file is uploaded. If not specified, the file name is shown.
      * @maxLength 255
      */
     explanationText?: string | null;
-    /** Media item. Media, associated with field, like image. */
+    /** Media content associated with the field, such as an image. */
     media?: MediaItem;
-    /** Settings for media item */
+    /** Configuration for the media content. */
     mediaSettings?: MediaSettings;
 }
 interface Signature {
     /**
-     * Selectable option label
+     * Field label.
      * @maxLength 350
      */
     label?: string | null;
     /**
-     * Flag identifying to hide label or not
-     * Default: true
+     * Whether to display the field label.
+     *
+     * Default: `true`
      */
     showLabel?: boolean | null;
-    /** Description of the field */
+    /** Additional description or instructions for the field. */
     description?: RichContent;
-    /** Is image upload enabled */
+    /** Whether image upload is enabled for the signature field. */
     imageUploadEnabled?: boolean;
-    /** Media item. Media, associated with field, like image. */
+    /** Media content associated with the field, such as an image. */
     media?: MediaItem;
-    /** Settings for media item */
+    /** Configuration for the media item. */
     mediaSettings?: MediaSettings;
 }
 declare enum InputFieldPaymentComponentType {
@@ -3590,30 +3635,32 @@ declare enum InputFieldPaymentComponentType {
 type InputFieldPaymentComponentTypeWithLiterals = InputFieldPaymentComponentType | 'UNKNOWN_COMPONENT_TYPE' | 'CHECKBOX_GROUP' | 'DONATION_INPUT' | 'PAYMENT_INPUT' | 'FIXED_PAYMENT';
 interface ProductCheckboxGroup {
     /**
-     * Label of the field.
+     * Field label.
      * @maxLength 350
      */
     label?: string | null;
-    /** Description of the field. */
+    /** Additional description or instructions for the field. */
     description?: RichContent;
     /**
-     * List of options to select from.
+     * List of product options the submitter can select from.
      * @maxSize 400
      */
     options?: ProductCheckboxGroupOption[];
     /**
-     * Flag identifying to hide or not label
-     * Default: true
+     * Whether to display the field label.
+     *
+     * Default: `true`
      */
     showLabel?: boolean | null;
     /**
-     * Defines how an image should be resized to fit within its option.
-     * Default: COVER
+     * How an image should be resized to fit within its option container.
+     *
+     * Default: `COVER`
      */
     imageFit?: ImageFitWithLiterals;
-    /** Media item. Media, associated with field, like image. */
+    /** Media content associated with the field, such as an image. */
     media?: MediaItem;
-    /** Settings for media item */
+    /** Configuration for the media content. */
     mediaSettings?: MediaSettings;
 }
 interface ProductCheckboxGroupOption {
@@ -3622,99 +3669,103 @@ interface ProductCheckboxGroupOption {
      * @maxLength 400
      */
     label?: string | null;
-    /** Selectable option value, which is saved to DB. Corresponds to product id, found in field's products list. */
+    /** Value stored on submission when this option is selected. Must match a product ID found in the field's products list. */
     value?: any;
     /**
-     * Option id. Used as binding for translations.
+     * Option ID. Used to connect this option with [Wix Multilingual](https://dev.wix.com/docs/api-reference/business-management/multilingual/translation/introduction) for translation.
      * @format GUID
      * @immutable
      */
     _id?: string;
-    /** Media item. Media, associated with option, like image. */
+    /** Media content associated with this option, such as an image. */
     media?: MediaItem;
-    /** Flag identifying that option should be selected by default */
+    /** Whether this option is selected by default. */
     default?: boolean;
 }
 interface DonationInput {
     /**
-     * Label of the field.
+     * Field label.
      * @maxLength 350
      */
     label?: string | null;
-    /** Description of the field. */
+    /** Additional description or instructions for the field. */
     description?: RichContent;
     /**
-     * List of options to select from.
+     * List of donation amount options the submitter can select from.
      * @maxSize 400
      */
     options?: DonationInputOption[];
-    /** Option which can be specified by UoU, enabled when this object is specified. */
+    /** Custom option which can be specified by the submitter. */
     customOption?: CustomOption;
     /**
      * Specifies the number of columns used to display the selections within the component.
-     * Default: ONE
+     *
+     * Default: `ONE`
      */
     numberOfColumns?: NumberOfColumnsWithLiterals;
     /**
-     * Flag identifying to hide or not label
-     * Default: true
+     * Whether to display the field label.
+     *
+     * Default: `true`
      */
     showLabel?: boolean | null;
-    /** Media item. Media, associated with field, like image. */
+    /** Media content associated with the field, such as an image. */
     media?: MediaItem;
-    /** Settings for media item */
+    /** Configuration for the media content. */
     mediaSettings?: MediaSettings;
 }
 interface DonationInputOption {
     /**
-     * Selectable option value, which is saved to DB. Corresponds to product id, found in field's products list.
+     * Value stored on submission when this option is selected. Must match a product ID found in the field's products list.
      * @format GUID
      */
     value?: string;
-    /** Flag identifying that option should be selected by default */
+    /** Whether this option is selected by default. */
     default?: boolean;
 }
 interface PaymentInput {
     /**
-     * Label of the field.
+     * Field label.
      * @maxLength 350
      */
     label?: string | null;
-    /** Description of the field. */
+    /** Additional description or instructions for the field. */
     description?: RichContent;
     /**
-     * Flag identifying to hide or not label
-     * Default: true
+     * Whether to display the field label.
+     *
+     * Default: `true`
      */
     showLabel?: boolean | null;
     /**
-     * Placeholder of custom option input
+     * Placeholder text shown inside the field when it's empty.
      * @maxLength 100
      */
     placeholder?: string | null;
-    /** Default value for the payment input */
+    /** Default value for the field. This value is pre-populated in the field when the form loads. */
     default?: number | null;
-    /** Media item. Media, associated with field, like image. */
+    /** Media content associated with the field, such as an image. */
     media?: MediaItem;
-    /** Settings for media item */
+    /** Configuration for the media content. */
     mediaSettings?: MediaSettings;
 }
 interface FixedPayment {
     /**
-     * Label of the field.
+     * Field label.
      * @maxLength 350
      */
     label?: string | null;
-    /** Description of the field. */
+    /** Additional description or instructions for the field. */
     description?: RichContent;
     /**
-     * Flag identifying to hide or not label
-     * Default: true
+     * Whether to display the field label.
+     *
+     * Default: `true`
      */
     showLabel?: boolean | null;
-    /** Media item. Media, associated with field, like image. */
+    /** Media content associated with the field, such as an image. */
     media?: MediaItem;
-    /** Settings for media item */
+    /** Configuration for the media content. */
     mediaSettings?: MediaSettings;
 }
 declare enum InputFieldSchedulingComponentType {
@@ -3724,64 +3775,65 @@ declare enum InputFieldSchedulingComponentType {
 /** @enumType */
 type InputFieldSchedulingComponentTypeWithLiterals = InputFieldSchedulingComponentType | 'UNKNOWN_COMPONENT_TYPE' | 'APPOINTMENT';
 interface Appointment extends AppointmentFormatInfoOneOf {
-    /** In person options for the appointment */
+    /** Configuration for in-person appointments. */
     inPersonOptions?: InPersonOptions;
-    /** Online video conference options for the appointment */
+    /** Configuration for video conference appointments. */
     videoConferenceOptions?: VideoConferenceOptions;
-    /** Phone options for the appointment */
+    /** Configuration for phone appointments. */
     phoneOptions?: PhoneOptions;
     /**
-     * Label of the field
+     * Field label.
      * @maxLength 255
      */
     label?: string | null;
     /**
-     * Name of the appointment
+     * Appointment name.
      * @minLength 1
      * @maxLength 400
      */
     name?: string | null;
     /**
-     * Duration of the appointment in minutes
+     * Duration of the appointment in minutes.
      * @min 1
      * @max 44639
      */
     durationInMinutes?: number | null;
-    /** Indicates whether manual approval is required for the appointment */
+    /** Whether appointments require manual approval before confirmation. */
     manualApprovalRequired?: boolean | null;
     /**
-     * ID of the staff members providing the appointment
+     * IDs of staff members who provide this service.
      * @maxSize 220
      * @format GUID
      */
     staffIds?: string[] | null;
-    /** The format of the appointment */
+    /** Appointment format. */
     format?: FormatWithLiterals;
-    /** Description of the field */
+    /** Additional description or instructions for the field. */
     description?: RichContent;
     /**
-     * Flag identifying to hide or not label
-     * Default: true
+     * Whether to display the field label.
+     *
+     * Default: `true`
      */
     showLabel?: boolean | null;
 }
 /** @oneof */
 interface AppointmentFormatInfoOneOf {
-    /** In person options for the appointment */
+    /** Configuration for in-person appointments. */
     inPersonOptions?: InPersonOptions;
-    /** Online video conference options for the appointment */
+    /** Configuration for video conference appointments. */
     videoConferenceOptions?: VideoConferenceOptions;
-    /** Phone options for the appointment */
+    /** Configuration for phone appointments. */
     phoneOptions?: PhoneOptions;
 }
 interface Location extends LocationLocationInfoOneOf {
     /**
-     * Custom address details
+     * Custom address specified as a text string.
      * @maxLength 512
      */
     customAddress?: string | null;
     /**
-     * ID of a business location
+     * ID of a predefined business [location](https://dev.wix.com/docs/rest/crm/members-contacts/locations/locations/introduction).
      * @format GUID
      */
     businessLocationId?: string | null;
@@ -3789,27 +3841,30 @@ interface Location extends LocationLocationInfoOneOf {
 /** @oneof */
 interface LocationLocationInfoOneOf {
     /**
-     * Custom address details
+     * Custom address specified as a text string.
      * @maxLength 512
      */
     customAddress?: string | null;
     /**
-     * ID of a business location
+     * ID of a predefined business [location](https://dev.wix.com/docs/rest/crm/members-contacts/locations/locations/introduction).
      * @format GUID
      */
     businessLocationId?: string | null;
 }
 declare enum Format {
     UNKNOWN_FORMAT_TYPE = "UNKNOWN_FORMAT_TYPE",
+    /** Face-to-face meeting at a physical location. */
     IN_PERSON = "IN_PERSON",
+    /** Online meeting via video conference. */
     VIDEO_CONFERENCE = "VIDEO_CONFERENCE",
+    /** Appointment conducted over the phone. */
     PHONE = "PHONE"
 }
 /** @enumType */
 type FormatWithLiterals = Format | 'UNKNOWN_FORMAT_TYPE' | 'IN_PERSON' | 'VIDEO_CONFERENCE' | 'PHONE';
 interface InPersonOptions {
     /**
-     * The locations details
+     * Physical locations where the appointment can take place.
      * @minSize 1
      * @maxSize 1
      */
@@ -3817,14 +3872,14 @@ interface InPersonOptions {
 }
 interface VideoConferenceOptions {
     /**
-     * Description or instructions for the online video conference
+     * Description or instructions for video conference appointments.
      * @maxLength 512
      */
     description?: string | null;
 }
 interface PhoneOptions {
     /**
-     * Description or instructions for the phone appointment
+     * Description or instructions for phone appointments.
      * @maxLength 512
      */
     description?: string | null;
@@ -3837,19 +3892,19 @@ declare enum MultilineAddressComponentType {
 type MultilineAddressComponentTypeWithLiterals = MultilineAddressComponentType | 'UNKNOWN_COMPONENT_TYPE' | 'MULTILINE_ADDRESS';
 interface MultilineAddress {
     /**
-     * Label of the field.
+     * Field label.
      * @maxLength 350
      */
     label?: string | null;
-    /** Description of the field. */
+    /** Additional description or instructions for the field. */
     description?: RichContent;
-    /** Show country flags. */
+    /** Whether to display country flags in the country selection. */
     showCountryFlags?: boolean;
-    /** Default country configuration. */
+    /** Default country configuration for the address field. */
     defaultCountryConfig?: DefaultCountryConfig;
     /** Fields settings. */
     fieldSettings?: FieldsSettings;
-    /** Autocomplete enabled for address line field. */
+    /** Whether autocomplete is enabled for the address line field. */
     autocompleteEnabled?: boolean;
     /**
      * Flag identifying whether to show or hide the address labels.
@@ -3863,9 +3918,9 @@ interface MultilineAddress {
     showLabel?: boolean | null;
 }
 declare enum Type {
-    /** Unknown default country config type. */
+    /** Unknown default country configuration type. */
     UNKNOWN_DEFAULT_COUNTRY = "UNKNOWN_DEFAULT_COUNTRY",
-    /** Country is determined by customer's IP address. */
+    /** Country is determined by the submitter's IP address. */
     BY_IP = "BY_IP",
     /** Pre-selected default country. */
     COUNTRY = "COUNTRY"
@@ -3873,12 +3928,12 @@ declare enum Type {
 /** @enumType */
 type TypeWithLiterals = Type | 'UNKNOWN_DEFAULT_COUNTRY' | 'BY_IP' | 'COUNTRY';
 interface AddressLine2 {
-    /** Show address line 2 field. */
+    /** Whether to display the address line 2 field. */
     show?: boolean;
 }
 interface DefaultCountryConfig extends DefaultCountryConfigOptionsOneOf {
     /**
-     * Country.
+     * Country code for the pre-selected default country. Two-letter country code in ISO-3166 alpha-2 format.
      * @format COUNTRY
      */
     countryOptions?: string;
@@ -3888,13 +3943,13 @@ interface DefaultCountryConfig extends DefaultCountryConfigOptionsOneOf {
 /** @oneof */
 interface DefaultCountryConfigOptionsOneOf {
     /**
-     * Country.
+     * Country code for the pre-selected default country. Two-letter country code in ISO-3166 alpha-2 format.
      * @format COUNTRY
      */
     countryOptions?: string;
 }
 interface FieldsSettings {
-    /** Address line 2. */
+    /** Configuration for the address line 2 field. */
     addressLine2?: AddressLine2;
 }
 declare enum InputFieldInputType {
@@ -3920,9 +3975,9 @@ interface V4FormFieldContactInfo extends V4FormFieldContactInfoAdditionalInfoOne
     addressInfo?: FormFieldContactInfoAddressInfo;
     /** Custom field info. */
     customFieldInfo?: FormFieldContactInfoCustomFieldInfo;
-    /** Subscription info */
+    /** Subscription info. */
     subscriptionInfo?: FormFieldContactInfoSubscriptionInfo;
-    /** Field mapped to contacts. */
+    /** The contact field that the form field maps to. */
     contactField?: FormFieldContactInfoContactFieldWithLiterals;
 }
 /** @oneof */
@@ -3935,46 +3990,67 @@ interface V4FormFieldContactInfoAdditionalInfoOneOf {
     addressInfo?: FormFieldContactInfoAddressInfo;
     /** Custom field info. */
     customFieldInfo?: FormFieldContactInfoCustomFieldInfo;
-    /** Subscription info */
+    /** Subscription info. */
     subscriptionInfo?: FormFieldContactInfoSubscriptionInfo;
 }
 declare enum FormFieldContactInfoEmailInfoTag {
+    /** Email without a specific tag. */
     UNTAGGED = "UNTAGGED",
+    /** Primary email address for the contact. */
     MAIN = "MAIN"
 }
 /** @enumType */
 type FormFieldContactInfoEmailInfoTagWithLiterals = FormFieldContactInfoEmailInfoTag | 'UNTAGGED' | 'MAIN';
 declare enum FormFieldContactInfoPhoneInfoTag {
+    /** Phone number without a specific tag. */
     UNTAGGED = "UNTAGGED",
+    /** Primary phone number for the contact. */
     MAIN = "MAIN"
 }
 /** @enumType */
 type FormFieldContactInfoPhoneInfoTagWithLiterals = FormFieldContactInfoPhoneInfoTag | 'UNTAGGED' | 'MAIN';
 declare enum AddressInfoTag {
+    /** Address without a specific tag. */
     UNTAGGED = "UNTAGGED",
+    /** Home address for the contact. */
     HOME = "HOME"
 }
 /** @enumType */
 type AddressInfoTagWithLiterals = AddressInfoTag | 'UNTAGGED' | 'HOME';
 declare enum SubscriptionInfoOptInLevel {
+    /** Unknown opt-in level. */
     UNKNOWN = "UNKNOWN",
+    /** Single confirmation opt-in. The contact is subscribed immediately. */
     SINGLE_CONFIRMATION = "SINGLE_CONFIRMATION",
+    /** Double confirmation opt-in. The contact must confirm their subscription via email. */
     DOUBLE_CONFIRMATION = "DOUBLE_CONFIRMATION"
 }
 /** @enumType */
 type SubscriptionInfoOptInLevelWithLiterals = SubscriptionInfoOptInLevel | 'UNKNOWN' | 'SINGLE_CONFIRMATION' | 'DOUBLE_CONFIRMATION';
 declare enum FormFieldContactInfoContactField {
+    /** Unknown contact field. */
     UNDEFINED = "UNDEFINED",
+    /** First name. */
     FIRST_NAME = "FIRST_NAME",
+    /** CLast name. */
     LAST_NAME = "LAST_NAME",
+    /** Company name. */
     COMPANY = "COMPANY",
+    /** Job position or title. */
     POSITION = "POSITION",
+    /** Email address. */
     EMAIL = "EMAIL",
+    /** Phone number. */
     PHONE = "PHONE",
+    /** Physical address. */
     ADDRESS = "ADDRESS",
+    /** Birth date. */
     BIRTHDATE = "BIRTHDATE",
+    /** Custom field. */
     CUSTOM_FIELD = "CUSTOM_FIELD",
+    /** Subscription status. */
     SUBSCRIPTION = "SUBSCRIPTION",
+    /** VAT identification number. */
     VAT_ID = "VAT_ID"
 }
 /** @enumType */
@@ -4001,8 +4077,8 @@ interface FormFieldContactInfoCustomFieldInfo {
 }
 interface FormFieldContactInfoSubscriptionInfo {
     /**
-     * Subscription consent opt in level, either single or double confirmation.
-     * Default: SINGLE_CONFIRMATION
+     * Subscription consent opt-in level.
+     * Default: `SINGLE_CONFIRMATION`
      */
     optInLevel?: SubscriptionInfoOptInLevelWithLiterals;
 }
@@ -4280,250 +4356,297 @@ interface FormFieldV2InputFieldInputTypeOptionsOneOf {
 }
 /** Copy of the entity existing in form template project, needed to hide translations. */
 interface DisplayField extends DisplayFieldDisplayFieldTypeOptionsOneOf {
-    /** Component displaying rich content */
+    /** Configuration for rich content display fields. */
     richContentOptions?: V4RichContentOptions;
-    /** Page navigation component resolving as navigation or submit buttons */
+    /** Configuration for page navigation display fields. */
     pageNavigationOptions?: V4PageNavigationOptions;
-    /** Type of the display field */
+    /** Type of display field that determines its appearance and behavior. */
     displayFieldType?: DisplayFieldTypeWithLiterals;
 }
 /** @oneof */
 interface DisplayFieldDisplayFieldTypeOptionsOneOf {
-    /** Component displaying rich content */
+    /** Configuration for rich content display fields. */
     richContentOptions?: V4RichContentOptions;
-    /** Page navigation component resolving as navigation or submit buttons */
+    /** Configuration for page navigation display fields. */
     pageNavigationOptions?: V4PageNavigationOptions;
 }
 declare enum DisplayFieldType {
+    /** Unknown display field type. */
     UNKNOWN_FIELD_TYPE = "UNKNOWN_FIELD_TYPE",
+    /** Rich content element for displaying formatted text, images, and media. */
     RICH_CONTENT = "RICH_CONTENT",
+    /** Navigation element with buttons for moving between form pages or submitting. */
     PAGE_NAVIGATION = "PAGE_NAVIGATION"
 }
 /** @enumType */
 type DisplayFieldTypeWithLiterals = DisplayFieldType | 'UNKNOWN_FIELD_TYPE' | 'RICH_CONTENT' | 'PAGE_NAVIGATION';
 interface V4RichContentOptions {
-    /** Content of the header */
+    /** Rich content to display, including formatted text, images, and embedded media. */
     richContent?: RichContent;
-    /** Number of paragraphs visible. Other part is hidden under expandable section. If not provided all text visible. */
+    /**
+     * Maximum number of paragraphs to show initially.
+     * Additional content is hidden behind an expandable section. If not specified, all content is visible.
+     */
     maxShownParagraphs?: number | null;
 }
 interface V4PageNavigationOptions {
     /**
-     * When button is not on last page it behaves as switch between pages page, text of label to go to next page.
+     * Text displayed on the button when it navigates to the next page.
+     * Only applicable when the button is not on the final form page.
      * @maxLength 65
      */
     nextPageText?: string | null;
     /**
-     * When button is not on last page it behaves as switch between pages page, text of label to go to previous page.
+     * Text displayed on the button when it navigates to the previous page.
+     * Only applicable when the button is not on the first form page.
      * @maxLength 65
      */
     previousPageText?: string | null;
     /**
-     * Text on the button when button is submitting a form
+     * Text displayed on the button when it submits the form.
+     * Only applicable when the button is on the final form page.
      * @maxLength 65
      */
     submitText?: string | null;
 }
 interface Field extends FieldFieldTypeOptionsOneOf {
-    /** Field accept input of data */
+    /** Configuration for input fields that collect user data. */
     inputOptions?: InputField;
-    /** Field for displaying information such as header or text paragraph */
+    /** Configuration for display fields that show information without collecting input. */
     displayOptions?: FieldsDisplayField;
     /**
-     * Field id.
+     * Field ID.
      * @format GUID
      * @immutable
      */
     _id?: string;
     /**
-     * Whether the field is hidden.
-     * Default: false
+     * Whether the field is hidden from submitters.
+     *
+     * Default: `false`
      */
     hidden?: boolean;
     /**
-     * Custom identification of field, can be used to specify exceptional behaviour of client for specific field
+     * Custom identification for the field. This is intended as a way for you to identify certain fields that you want to apply special behavior to in your own logic.
      * @maxLength 50
      */
     identifier?: string | null;
     /**
-     * Type of the field
+     * Field type.
      * @readonly
      */
     fieldType?: FieldTypeWithLiterals;
 }
 /** @oneof */
 interface FieldFieldTypeOptionsOneOf {
-    /** Field accept input of data */
+    /** Configuration for input fields that collect user data. */
     inputOptions?: InputField;
-    /** Field for displaying information such as header or text paragraph */
+    /** Configuration for display fields that show information without collecting input. */
     displayOptions?: FieldsDisplayField;
 }
 declare enum FieldType {
+    /** Unknown field type. */
     UNKNOWN_FIELD_TYPE = "UNKNOWN_FIELD_TYPE",
+    /** Input field that collects data from users. */
     INPUT = "INPUT",
+    /** Display field that shows information without collecting input. */
     DISPLAY = "DISPLAY"
 }
 /** @enumType */
 type FieldTypeWithLiterals = FieldType | 'UNKNOWN_FIELD_TYPE' | 'INPUT' | 'DISPLAY';
 interface InputField extends InputFieldInputTypeOptionsOneOf {
-    /** Input return string as value */
+    /** String input field settings. */
     stringOptions?: _String;
-    /** Input return number as value */
+    /** Number input field settings. */
     numberOptions?: _Number;
-    /** Input return boolean as value */
+    /** Boolean input field settings. */
     booleanOptions?: _Boolean;
-    /** Input return array as value */
+    /** Array input field settings. */
     arrayOptions?: _Array;
-    /** Input return object as value */
+    /** Object input field settings. */
     objectOptions?: _Object;
-    /** Input return "Wix file" as value */
+    /** File input field settings. Files are uploaded to the [Media Manager](https://support.wix.com/en/article/wix-media-about-the-media-manager). */
     wixFileOptions?: WixFile;
-    /** Input returns selected products as value. */
+    /** Payment input field settings. */
     paymentOptions?: Payment;
-    /** Input returns scheduling as value. */
+    /** Scheduling input field settings. */
     schedulingOptions?: Scheduling;
-    /** Input returns multiline address as value. */
+    /** Address input field settings. */
     addressOptions?: Address;
     /**
-     * Definition of a target where the value of field belongs.
+     * Human readable identifier used to reference a field. For example, `"address"`.
+     *
+     * Can be set once.
      * @minLength 1
      * @maxLength 200
      * @immutable
      */
     target?: string;
     /**
-     * Mark the field as containing personal information. This will encrypt user data when storing it.
-     * Default: false
+     * Whether this field contains Personally Identifiable Information (PII).
+     *
+     * PII fields are automatically encrypted when stored.
+     *
+     * Default: `false`
      */
     pii?: boolean;
     /**
-     * Whether the field is required.
-     * Default: false
+     * Whether the field is required for form submission.
+     *
+     * Default: `false`
      */
     required?: boolean;
     /**
-     * Type of the input field
+     * Type of the input field that determines what kind of data it collects.
      * @readonly
      */
     inputType?: InputTypeWithLiterals;
-    /** Mapping to contacts, telling to what contact property field input value should be saved. */
+    /**
+     * Mapping configuration for automatically saving field values to contact properties.
+     *
+     * When specified, form submissions automatically create or update contacts with the field data.
+     */
     contactMapping?: FormFieldContactInfo;
     /**
-     * Whether the field is read only.
-     * Default: false
+     * Whether the field is read-only.
+     *
+     * Default: `false`
      */
     readOnly?: boolean;
 }
 /** @oneof */
 interface InputFieldInputTypeOptionsOneOf {
-    /** Input return string as value */
+    /** String input field settings. */
     stringOptions?: _String;
-    /** Input return number as value */
+    /** Number input field settings. */
     numberOptions?: _Number;
-    /** Input return boolean as value */
+    /** Boolean input field settings. */
     booleanOptions?: _Boolean;
-    /** Input return array as value */
+    /** Array input field settings. */
     arrayOptions?: _Array;
-    /** Input return object as value */
+    /** Object input field settings. */
     objectOptions?: _Object;
-    /** Input return "Wix file" as value */
+    /** File input field settings. Files are uploaded to the [Media Manager](https://support.wix.com/en/article/wix-media-about-the-media-manager). */
     wixFileOptions?: WixFile;
-    /** Input returns selected products as value. */
+    /** Payment input field settings. */
     paymentOptions?: Payment;
-    /** Input returns scheduling as value. */
+    /** Scheduling input field settings. */
     schedulingOptions?: Scheduling;
-    /** Input returns multiline address as value. */
+    /** Address input field settings. */
     addressOptions?: Address;
 }
 interface StringType extends StringTypeFormatOptionsOneOf {
-    /** DATE format options */
+    /** Validation rules for strings with date format. */
     dateOptions?: DateTimeConstraints;
-    /** DATE_TIME format options */
+    /** Validation rules for strings with date and time format. */
     dateTimeOptions?: DateTimeConstraints;
-    /** TIME format options */
+    /** Validation rules for strings with time format. */
     timeOptions?: DateTimeConstraints;
-    /** DATE_OPTIONAL_TIME format options */
+    /** Validation rules for string with date and time format, where time is optional. */
     dateOptionalTimeOptions?: DateTimeConstraints;
-    /** PHONE format options */
+    /** Validation rules for strings with phone number format. */
     phoneOptions?: PhoneConstraints;
     /**
-     * Minimum length.
+     * Minimum required length for the string value.
      * @max 20000
      */
     minLength?: number | null;
     /**
-     * Maximum length.
+     * Maximum allowed length for the string value.
      * @max 20000
      */
     maxLength?: number | null;
     /**
-     * Pattern for a regular expression match.
+     * Regular expression pattern that the string value must match.
      * @maxLength 500
      */
     pattern?: string | null;
-    /** Format of a string. */
+    /** Expected format of the string value. */
     format?: FormatEnumFormatWithLiterals;
     /**
-     * List of allowed values.
+     * List of specific values that are allowed for this field.
+     * When specified, the input must match one of these predefined values.
      * @maxSize 500
      * @maxLength 20000
      */
     enum?: string[] | null;
-    /** User defined error messages when particular validation constraint fails */
+    /** Custom error messages displayed when validation fails. */
     validationMessages?: ValidationMessages;
 }
 /** @oneof */
 interface StringTypeFormatOptionsOneOf {
-    /** DATE format options */
+    /** Validation rules for strings with date format. */
     dateOptions?: DateTimeConstraints;
-    /** DATE_TIME format options */
+    /** Validation rules for strings with date and time format. */
     dateTimeOptions?: DateTimeConstraints;
-    /** TIME format options */
+    /** Validation rules for strings with time format. */
     timeOptions?: DateTimeConstraints;
-    /** DATE_OPTIONAL_TIME format options */
+    /** Validation rules for string with date and time format, where time is optional. */
     dateOptionalTimeOptions?: DateTimeConstraints;
-    /** PHONE format options */
+    /** Validation rules for strings with phone number format. */
     phoneOptions?: PhoneConstraints;
 }
 declare enum FormatEnumFormat {
+    /** Unknown format. */
     UNKNOWN_FORMAT = "UNKNOWN_FORMAT",
+    /** Date format. */
     DATE = "DATE",
+    /** Time format. */
     TIME = "TIME",
+    /** Date and time format. */
     DATE_TIME = "DATE_TIME",
+    /** Email format. */
     EMAIL = "EMAIL",
+    /** URL format. */
     URL = "URL",
+    /** UUID format. */
     UUID = "UUID",
+    /** Phone number format. */
     PHONE = "PHONE",
+    /** URI format. */
     URI = "URI",
+    /** Hostname format. */
     HOSTNAME = "HOSTNAME",
+    /** Hexadecimal color code format. */
     COLOR_HEX = "COLOR_HEX",
+    /** Currency format. */
     CURRENCY = "CURRENCY",
+    /** Language code format. */
     LANGUAGE = "LANGUAGE",
+    /** Date with optional time format. */
     DATE_OPTIONAL_TIME = "DATE_OPTIONAL_TIME"
 }
 /** @enumType */
 type FormatEnumFormatWithLiterals = FormatEnumFormat | 'UNKNOWN_FORMAT' | 'DATE' | 'TIME' | 'DATE_TIME' | 'EMAIL' | 'URL' | 'UUID' | 'PHONE' | 'URI' | 'HOSTNAME' | 'COLOR_HEX' | 'CURRENCY' | 'LANGUAGE' | 'DATE_OPTIONAL_TIME';
 interface DateTimeConstraints {
     /**
-     * Support static constrains defined as ISO date/time format, as well as
-     * dynamic calculations can be performed using special keywords such as "$now" to represent the current date and time.
-     * The dynamic calculation supports expressions like "$now+2d" (2 days in the future), "$now-1h" (1 hour in the past), etc.
-     * The regex pattern for dynamic calculations is: \$now([+-]\d{1,2})([yMdmh])
+     * Minimum allowed datetime value.
+     *
+     * Supports ISO datetime format or dynamic calculations using "$now" keyword.
+     * The dynamic calculation supports times in the future and past.
+     * The pattern for dynamic calculations: $now([+-]\d{1,2})([yMdmh]).
+     *
+     * Examples: `"2023-01-01"`, `"$now-1d"` (1 day ago), `"$now+2h"` (2 hours from now).
      * @maxLength 50
      */
     minimum?: string | null;
     /**
-     * Support static constrains defined as ISO date/time format, as well as
-     * dynamic calculations can be performed using special keywords such as "$now" to represent the current date and time.
-     * The dynamic calculation supports expressions like "$now+2d" (2 days in the future), "$now-1h" (1 hour in the past), etc.
-     * The regex pattern for dynamic calculations is: \$now([+-]\d{1,2})([yMdmh])
+     * Maximum allowed datetime value.
+     *
+     * Supports ISO datetime format or dynamic calculations using "$now" keyword.
+     * The dynamic calculation supports times in the future and past.
+     * The pattern for dynamic calculations: $now([+-]\d{1,2})([yMdmh]).
+     *
+     * Examples: `"2023-01-01"`, `"$now-1d"` (1 day ago), `"$now+2h"` (2 hours from now).
      * @maxLength 50
      */
     maximum?: string | null;
 }
 interface PhoneConstraints {
     /**
-     * Country codes for phone number that are allowed
+     * Country codes that are allowed for phone number validation.
+     *
+     * Use ISO 3166-1 alpha-2 country codes. For example, `"US"`, `"GB"`, `"CA"`.
      * @maxSize 250
      * @maxLength 2
      */
@@ -4531,31 +4654,43 @@ interface PhoneConstraints {
 }
 interface ValidationMessages {
     /**
-     * Error message shown when validation of patter fails
+     * Error message shown when the pattern validation fails.
+     *
+     * This message is displayed to users when their input doesn't match the specified regex pattern.
      * @maxLength 200
      */
     pattern?: string | null;
 }
 declare enum StringComponentType {
+    /** Unknown component type. */
     UNKNOWN_COMPONENT_TYPE = "UNKNOWN_COMPONENT_TYPE",
+    /** Text input component. */
     TEXT_INPUT = "TEXT_INPUT",
+    /** Radio group component. */
     RADIO_GROUP = "RADIO_GROUP",
+    /** Dropdown component. */
     DROPDOWN = "DROPDOWN",
+    /** Date and time component. */
     DATE_TIME = "DATE_TIME",
+    /** Phone number component. */
     PHONE_INPUT = "PHONE_INPUT",
+    /** Date selection component. */
     DATE_INPUT = "DATE_INPUT",
+    /** Time selection component. */
     TIME_INPUT = "TIME_INPUT",
+    /** Calendar-style date picker component. */
     DATE_PICKER = "DATE_PICKER",
+    /** Dropdown component for selecting available services. */
     SERVICES_DROPDOWN = "SERVICES_DROPDOWN"
 }
 /** @enumType */
 type StringComponentTypeWithLiterals = StringComponentType | 'UNKNOWN_COMPONENT_TYPE' | 'TEXT_INPUT' | 'RADIO_GROUP' | 'DROPDOWN' | 'DATE_TIME' | 'PHONE_INPUT' | 'DATE_INPUT' | 'TIME_INPUT' | 'DATE_PICKER' | 'SERVICES_DROPDOWN';
 interface NumberType {
-    /** Inclusive maximum value. */
+    /** The maximum value of the number. Inclusive. */
     maximum?: number | null;
-    /** Inclusive minimum value. */
+    /** The minimum value of the number. Inclusive. */
     minimum?: number | null;
-    /** Multiple of value. */
+    /** A number that the value must be a multiple of. */
     multipleOf?: number | null;
     /**
      * List of allowed values.
@@ -4564,8 +4699,11 @@ interface NumberType {
     enum?: number[] | null;
 }
 declare enum NumberComponentType {
+    /** Unknown component type. */
     UNKNOWN_COMPONENT_TYPE = "UNKNOWN_COMPONENT_TYPE",
+    /** Numeric input component. */
     NUMBER_INPUT = "NUMBER_INPUT",
+    /** Rating input component. */
     RATING_INPUT = "RATING_INPUT"
 }
 /** @enumType */
@@ -4578,229 +4716,286 @@ interface BooleanType {
     enum?: boolean[];
 }
 declare enum BooleanComponentType {
+    /** Unknown component type. */
     UNKNOWN_COMPONENT_TYPE = "UNKNOWN_COMPONENT_TYPE",
+    /** Checkbox component. */
     CHECKBOX = "CHECKBOX"
 }
 /** @enumType */
 type BooleanComponentTypeWithLiterals = BooleanComponentType | 'UNKNOWN_COMPONENT_TYPE' | 'CHECKBOX';
 interface ArrayType {
     /**
-     * Maximum amount of array elements.
+     * Maximum number of elements allowed in the array.
      * @max 1000
      */
     maxItems?: number | null;
     /**
-     * Minimum amount of array elements.
+     * Minimum number of elements required in the array.
      * @max 1000
      */
     minItems?: number | null;
-    /** Type of items allowed in array. */
+    /** Type of items allowed in the array. */
     items?: ArrayItems;
 }
 declare enum ItemType {
+    /** Unknown item type. */
     UNKNOWN_ITEM_TYPE = "UNKNOWN_ITEM_TYPE",
+    /** Array can contain string values. */
     STRING = "STRING",
+    /** Array can contain numeric values. */
     NUMBER = "NUMBER",
+    /** Array can contain boolean values. */
     BOOLEAN = "BOOLEAN",
+    /** Array can contain object values. */
     OBJECT = "OBJECT"
 }
 /** @enumType */
 type ItemTypeWithLiterals = ItemType | 'UNKNOWN_ITEM_TYPE' | 'STRING' | 'NUMBER' | 'BOOLEAN' | 'OBJECT';
 interface ObjectType {
-    /** Description of object properties. */
+    /** Definition of object properties and their validation rules. */
     properties?: Record<string, PropertiesType>;
 }
 declare enum PropertiesTypeEnum {
+    /** Unknown property type. */
     UNKNOWN_PROPERTY_TYPE = "UNKNOWN_PROPERTY_TYPE",
+    /** Property must contain a string value. */
     STRING = "STRING",
+    /** Property must contain a numeric value. */
     NUMBER = "NUMBER",
+    /** Property must contain a boolean value. */
     BOOLEAN = "BOOLEAN",
+    /** Property must contain an array. */
     ARRAY = "ARRAY"
 }
 /** @enumType */
 type PropertiesTypeEnumWithLiterals = PropertiesTypeEnum | 'UNKNOWN_PROPERTY_TYPE' | 'STRING' | 'NUMBER' | 'BOOLEAN' | 'ARRAY';
 interface PropertiesType extends PropertiesTypePropertiesTypeOptionsOneOf {
-    /** String type validation for property. */
+    /** Validation rules for string properties. */
     stringOptions?: StringType;
-    /** Number type validation for property. */
+    /** Validation rules for numeric properties. */
     numberOptions?: NumberType;
-    /** Boolean type validation for property. */
+    /** Validation rules for boolean properties. */
     booleanOptions?: BooleanType;
-    /** Array type validation for property. */
+    /** Validation rules for array properties. */
     arrayOptions?: ArrayType;
     /**
-     * Type of object properties
+     * Data type of the object property.
      * @readonly
      */
     propertiesType?: PropertiesTypeEnumWithLiterals;
-    /** Whether the property is required. */
+    /** Whether the object property is required for validation. */
     required?: boolean;
 }
 /** @oneof */
 interface PropertiesTypePropertiesTypeOptionsOneOf {
-    /** String type validation for property. */
+    /** Validation rules for string properties. */
     stringOptions?: StringType;
-    /** Number type validation for property. */
+    /** Validation rules for numeric properties. */
     numberOptions?: NumberType;
-    /** Boolean type validation for property. */
+    /** Validation rules for boolean properties. */
     booleanOptions?: BooleanType;
-    /** Array type validation for property. */
+    /** Validation rules for array properties. */
     arrayOptions?: ArrayType;
 }
 interface ArrayItems extends ArrayItemsItemTypeOptionsOneOf {
-    /** String type validation for items. */
+    /** Validation rules for string array elements. */
     stringOptions?: StringType;
-    /** Number type validation for items. */
+    /** Validation rules for numeric array elements. */
     numberOptions?: NumberType;
-    /** Boolean type validation for items. */
+    /** Validation rules for boolean array elements. */
     booleanOptions?: BooleanType;
-    /** Object type validation for items */
+    /** Validation rules for object array elements. */
     objectOptions?: ObjectType;
     /**
-     * Type of array items
+     * Allowed item type.
      * @readonly
      */
     itemType?: ItemTypeWithLiterals;
 }
 /** @oneof */
 interface ArrayItemsItemTypeOptionsOneOf {
-    /** String type validation for items. */
+    /** Validation rules for string array elements. */
     stringOptions?: StringType;
-    /** Number type validation for items. */
+    /** Validation rules for numeric array elements. */
     numberOptions?: NumberType;
-    /** Boolean type validation for items. */
+    /** Validation rules for boolean array elements. */
     booleanOptions?: BooleanType;
-    /** Object type validation for items */
+    /** Validation rules for object array elements. */
     objectOptions?: ObjectType;
 }
 declare enum ArrayComponentType {
+    /** Unknown component type. */
     UNKNOWN_COMPONENT_TYPE = "UNKNOWN_COMPONENT_TYPE",
+    /** Checkbox group component. */
     CHECKBOX_GROUP = "CHECKBOX_GROUP",
+    /** Tags component. */
     TAGS = "TAGS",
     SERVICES_CHECKBOX_GROUP = "SERVICES_CHECKBOX_GROUP"
 }
 /** @enumType */
 type ArrayComponentTypeWithLiterals = ArrayComponentType | 'UNKNOWN_COMPONENT_TYPE' | 'CHECKBOX_GROUP' | 'TAGS' | 'SERVICES_CHECKBOX_GROUP';
 declare enum WixFileComponentType {
+    /** Unknown component type. */
     UNKNOWN_COMPONENT_TYPE = "UNKNOWN_COMPONENT_TYPE",
+    /** File upload component. */
     FILE_UPLOAD = "FILE_UPLOAD",
+    /** Signature component. */
     SIGNATURE = "SIGNATURE"
 }
 /** @enumType */
 type WixFileComponentTypeWithLiterals = WixFileComponentType | 'UNKNOWN_COMPONENT_TYPE' | 'FILE_UPLOAD' | 'SIGNATURE';
 declare enum PaymentComponentType {
+    /** Unknown component type. */
     UNKNOWN_COMPONENT_TYPE = "UNKNOWN_COMPONENT_TYPE",
+    /** Checkbox group component. */
     CHECKBOX_GROUP = "CHECKBOX_GROUP",
+    /** Donation input component. */
     DONATION_INPUT = "DONATION_INPUT",
+    /** Payment input component. */
     PAYMENT_INPUT = "PAYMENT_INPUT",
+    /** Fixed payment component. */
     FIXED_PAYMENT = "FIXED_PAYMENT"
 }
 /** @enumType */
 type PaymentComponentTypeWithLiterals = PaymentComponentType | 'UNKNOWN_COMPONENT_TYPE' | 'CHECKBOX_GROUP' | 'DONATION_INPUT' | 'PAYMENT_INPUT' | 'FIXED_PAYMENT';
 declare enum ComponentType {
+    /** Unknown component type. */
     UNKNOWN_COMPONENT_TYPE = "UNKNOWN_COMPONENT_TYPE",
+    /** Multiline address component. */
     MULTILINE_ADDRESS = "MULTILINE_ADDRESS"
 }
 /** @enumType */
 type ComponentTypeWithLiterals = ComponentType | 'UNKNOWN_COMPONENT_TYPE' | 'MULTILINE_ADDRESS';
 declare enum SchedulingComponentType {
+    /** Unknown component type. */
     UNKNOWN_COMPONENT_TYPE = "UNKNOWN_COMPONENT_TYPE",
+    /** Appointment component. */
     APPOINTMENT = "APPOINTMENT"
 }
 /** @enumType */
 type SchedulingComponentTypeWithLiterals = SchedulingComponentType | 'UNKNOWN_COMPONENT_TYPE' | 'APPOINTMENT';
 declare enum InputType {
+    /** Unknown input type. */
     UNKNOWN_INPUT_TYPE = "UNKNOWN_INPUT_TYPE",
+    /** String input. */
     STRING = "STRING",
+    /** Numeric input. */
     NUMBER = "NUMBER",
+    /** Boolean input. */
     BOOLEAN = "BOOLEAN",
+    /** Array input. */
     ARRAY = "ARRAY",
+    /** Object input. */
     OBJECT = "OBJECT",
+    /** File upload input. */
     WIX_FILE = "WIX_FILE",
+    /** Payment input. */
     PAYMENT = "PAYMENT",
+    /** Scheduling input. */
     SCHEDULING = "SCHEDULING",
+    /** Address input. */
     ADDRESS = "ADDRESS"
 }
 /** @enumType */
 type InputTypeWithLiterals = InputType | 'UNKNOWN_INPUT_TYPE' | 'STRING' | 'NUMBER' | 'BOOLEAN' | 'ARRAY' | 'OBJECT' | 'WIX_FILE' | 'PAYMENT' | 'SCHEDULING' | 'ADDRESS';
 interface FormFieldContactInfo extends FormFieldContactInfoAdditionalInfoOneOf {
-    /** Email info. */
+    /** Configuration for email contact fields. */
     emailInfo?: EmailInfo;
-    /** Phone info. */
+    /** Configuration for phone contact fields. */
     phoneInfo?: PhoneInfo;
-    /** Address info. */
+    /** Configuration for address contact fields. */
     addressInfo?: AddressInfo;
-    /** Custom field info. */
+    /** Configuration for custom contact fields. */
     customFieldInfo?: CustomFieldInfo;
-    /** Subscription info */
+    /** Configuration for subscription contact fields. */
     subscriptionInfo?: SubscriptionInfo;
-    /** Field mapped to contacts. */
+    /** The [Contact](https://dev.wix.com/docs/rest/crm/members-contacts/contacts/contacts/introduction) field that this form field maps to. */
     contactField?: ContactFieldWithLiterals;
 }
 /** @oneof */
 interface FormFieldContactInfoAdditionalInfoOneOf {
-    /** Email info. */
+    /** Configuration for email contact fields. */
     emailInfo?: EmailInfo;
-    /** Phone info. */
+    /** Configuration for phone contact fields. */
     phoneInfo?: PhoneInfo;
-    /** Address info. */
+    /** Configuration for address contact fields. */
     addressInfo?: AddressInfo;
-    /** Custom field info. */
+    /** Configuration for custom contact fields. */
     customFieldInfo?: CustomFieldInfo;
-    /** Subscription info */
+    /** Configuration for subscription contact fields. */
     subscriptionInfo?: SubscriptionInfo;
 }
 declare enum EmailInfoTag {
+    /** Untagged email address. */
     UNTAGGED = "UNTAGGED",
+    /** Primary email address for the contact. */
     MAIN = "MAIN"
 }
 /** @enumType */
 type EmailInfoTagWithLiterals = EmailInfoTag | 'UNTAGGED' | 'MAIN';
 declare enum PhoneInfoTag {
+    /** Untagged phone number. */
     UNTAGGED = "UNTAGGED",
+    /** Primary phone number for the contact. */
     MAIN = "MAIN"
 }
 /** @enumType */
 type PhoneInfoTagWithLiterals = PhoneInfoTag | 'UNTAGGED' | 'MAIN';
 declare enum Tag {
+    /** Untagged address. */
     UNTAGGED = "UNTAGGED",
+    /** Home address. */
     HOME = "HOME"
 }
 /** @enumType */
 type TagWithLiterals = Tag | 'UNTAGGED' | 'HOME';
 declare enum ConfirmationLevel {
+    /** Unknown confirmation level. */
     UNKNOWN_CONFIRMATION_LEVEL = "UNKNOWN_CONFIRMATION_LEVEL",
+    /** Single confirmation level. */
     SINGLE_CONFIRMATION = "SINGLE_CONFIRMATION",
+    /** Double confirmation level. */
     DOUBLE_CONFIRMATION = "DOUBLE_CONFIRMATION"
 }
 /** @enumType */
 type ConfirmationLevelWithLiterals = ConfirmationLevel | 'UNKNOWN_CONFIRMATION_LEVEL' | 'SINGLE_CONFIRMATION' | 'DOUBLE_CONFIRMATION';
 declare enum ContactField {
     UNKNOWN_CONTACT_FIELD = "UNKNOWN_CONTACT_FIELD",
+    /** Contact's first name. */
     FIRST_NAME = "FIRST_NAME",
+    /** Contact's last name. */
     LAST_NAME = "LAST_NAME",
+    /** Contact's company or organization. */
     COMPANY = "COMPANY",
+    /** Contact's job title or position. */
     POSITION = "POSITION",
+    /** Contact's email address. */
     EMAIL = "EMAIL",
+    /** Contact's phone number. */
     PHONE = "PHONE",
+    /** Contact's physical address. */
     ADDRESS = "ADDRESS",
+    /** Contact's birth date. */
     BIRTHDATE = "BIRTHDATE",
+    /** Custom contact field defined by the site owner. */
     CUSTOM_FIELD = "CUSTOM_FIELD",
+    /** Contact's subscription preferences. */
     SUBSCRIPTION = "SUBSCRIPTION",
+    /** Contact's VAT identification number. */
     VAT_ID = "VAT_ID"
 }
 /** @enumType */
 type ContactFieldWithLiterals = ContactField | 'UNKNOWN_CONTACT_FIELD' | 'FIRST_NAME' | 'LAST_NAME' | 'COMPANY' | 'POSITION' | 'EMAIL' | 'PHONE' | 'ADDRESS' | 'BIRTHDATE' | 'CUSTOM_FIELD' | 'SUBSCRIPTION' | 'VAT_ID';
 interface EmailInfo {
-    /** Email tag. */
+    /** Email categorization tag. */
     tag?: EmailInfoTagWithLiterals;
 }
 interface PhoneInfo {
-    /** Phone tag. */
+    /** Phone number categorization tag. */
     tag?: PhoneInfoTagWithLiterals;
 }
 interface AddressInfo {
-    /** Address tag. */
+    /** Address categorization tag. */
     tag?: TagWithLiterals;
 }
 interface CustomFieldInfo {
@@ -4813,243 +5008,253 @@ interface CustomFieldInfo {
 }
 interface SubscriptionInfo {
     /**
-     * Subscription consent opt in level, either single or double confirmation.
-     * Default: SINGLE_CONFIRMATION
+     * Subscription consent opt-in level, either single or double confirmation.
+     * Default: `SINGLE_CONFIRMATION`
      */
     confirmationLevel?: ConfirmationLevelWithLiterals;
 }
 interface _String extends _StringComponentTypeOptionsOneOf {
-    /** Text input field */
+    /** Text input component settings. */
     textInputOptions?: TextInput;
-    /** Selection field as radio group */
+    /** Radio group component settings. */
     radioGroupOptions?: RadioGroup;
-    /** Selection field as drop down */
+    /** Dropdown component settings. */
     dropdownOptions?: Dropdown;
-    /** Field for selecting date and time */
+    /** Date and time input component settings. */
     dateTimeOptions?: DateTimeInput;
-    /** Phone input field */
+    /** Phone input component settings. */
     phoneInputOptions?: PhoneInput;
-    /** Dropdown based component for selecting date */
+    /** Date input component settings. */
     dateInputOptions?: DateInput;
-    /** Field for selecting time */
+    /** Time input component settings. */
     timeInputOptions?: TimeInput;
-    /** Calendar type component for selecting date */
+    /** Date picker component settings. */
     datePickerOptions?: DatePicker;
-    /** Dropdown for selecting services */
+    /** Services dropdown component settings. */
     servicesDropdownOptions?: ServicesDropdown;
-    /** Validation of field output value. */
+    /** Validation configuration for the string input. */
     validation?: StringType;
     /**
-     * Component type of the string input field
+     * Component type of the string input field.
      * @readonly
      */
     componentType?: StringComponentTypeWithLiterals;
 }
 /** @oneof */
 interface _StringComponentTypeOptionsOneOf {
-    /** Text input field */
+    /** Text input component settings. */
     textInputOptions?: TextInput;
-    /** Selection field as radio group */
+    /** Radio group component settings. */
     radioGroupOptions?: RadioGroup;
-    /** Selection field as drop down */
+    /** Dropdown component settings. */
     dropdownOptions?: Dropdown;
-    /** Field for selecting date and time */
+    /** Date and time input component settings. */
     dateTimeOptions?: DateTimeInput;
-    /** Phone input field */
+    /** Phone input component settings. */
     phoneInputOptions?: PhoneInput;
-    /** Dropdown based component for selecting date */
+    /** Date input component settings. */
     dateInputOptions?: DateInput;
-    /** Field for selecting time */
+    /** Time input component settings. */
     timeInputOptions?: TimeInput;
-    /** Calendar type component for selecting date */
+    /** Date picker component settings. */
     datePickerOptions?: DatePicker;
-    /** Dropdown for selecting services */
+    /** Services dropdown component settings. */
     servicesDropdownOptions?: ServicesDropdown;
 }
 interface _Number extends _NumberComponentTypeOptionsOneOf {
-    /** Number value input field */
+    /** Number input settings. */
     numberInputOptions?: NumberInput;
-    /** Rating value input field */
+    /** Rating input settings. */
     ratingInputOptions?: RatingInput;
-    /** Validation of field output value. */
+    /** Validation configuration for the number input. */
     validation?: NumberType;
     /**
-     * Component type of the number input field
+     * Component type of the number input field.
      * @readonly
      */
     componentType?: NumberComponentTypeWithLiterals;
 }
 /** @oneof */
 interface _NumberComponentTypeOptionsOneOf {
-    /** Number value input field */
+    /** Number input settings. */
     numberInputOptions?: NumberInput;
-    /** Rating value input field */
+    /** Rating input settings. */
     ratingInputOptions?: RatingInput;
 }
 interface _Boolean extends _BooleanComponentTypeOptionsOneOf {
-    /** Checkbox input field */
+    /** Checkbox component settings. */
     checkboxOptions?: Checkbox;
-    /** Validation of field output value. */
+    /** Validation configuration for the boolean input. */
     validation?: BooleanType;
     /**
-     * Component type of the boolean input field
+     * Component type of the boolean input field.
      * @readonly
      */
     componentType?: BooleanComponentTypeWithLiterals;
 }
 /** @oneof */
 interface _BooleanComponentTypeOptionsOneOf {
-    /** Checkbox input field */
+    /** Checkbox component settings. */
     checkboxOptions?: Checkbox;
 }
 interface _Array extends _ArrayComponentTypeOptionsOneOf {
-    /** Checkbox group input field */
+    /** Checkbox group component settings. */
     checkboxGroupOptions?: CheckboxGroup;
-    /** Tags input field */
+    /** Tags component settings. */
     tagsOptions?: Tags;
     /** Services checkbox group input field */
     servicesCheckboxGroupOptions?: ServicesCheckboxGroup;
-    /** Validation of array type. */
+    /** Validation configuration for the array input. */
     validation?: ArrayType;
     /**
-     * Component type of the array input field
+     * Component type of the array input field.
      * @readonly
      */
     componentType?: ArrayComponentTypeWithLiterals;
 }
 /** @oneof */
 interface _ArrayComponentTypeOptionsOneOf {
-    /** Checkbox group input field */
+    /** Checkbox group component settings. */
     checkboxGroupOptions?: CheckboxGroup;
-    /** Tags input field */
+    /** Tags component settings. */
     tagsOptions?: Tags;
     /** Services checkbox group input field */
     servicesCheckboxGroupOptions?: ServicesCheckboxGroup;
 }
 interface _Object {
-    /** Validation of object type. */
+    /** Validation configuration for the object input. */
     validation?: ObjectType;
 }
 interface WixFile extends WixFileComponentTypeOptionsOneOf {
-    /** File upload input field */
+    /** File upload component settings. */
     fileUploadOptions?: FileUpload;
-    /** Signature input field */
+    /** Signature component settings. */
     signatureOptions?: Signature;
     /**
-     * Component type of the array input field
+     * Component type of the file input field.
      * @readonly
      */
     componentType?: WixFileComponentTypeWithLiterals;
-    /** Validation of field type. */
+    /** Validation configuration for the file input. */
     validation?: FileType;
 }
 /** @oneof */
 interface WixFileComponentTypeOptionsOneOf {
-    /** File upload input field */
+    /** File upload component settings. */
     fileUploadOptions?: FileUpload;
-    /** Signature input field */
+    /** Signature component settings. */
     signatureOptions?: Signature;
 }
 interface Payment extends PaymentComponentTypeOptionsOneOf {
-    /** Checkbox group input field. */
+    /** Checkbox group component settings. */
     checkboxGroupOptions?: ProductCheckboxGroup;
-    /** Donation input field. */
+    /** Donation input component settings. */
     donationInputOptions?: DonationInput;
-    /** Payment input field. */
+    /** Payment input component settings. */
     paymentInputOptions?: PaymentInput;
-    /** Fixed payment field. */
+    /** Fixed payment component settings. */
     fixedPaymentOptions?: FixedPayment;
     /**
      * Component type of the payment input field.
      * @readonly
      */
     componentType?: PaymentComponentTypeWithLiterals;
-    /** Validation of payment type. */
+    /** Validation configuration for the payment input. */
     validation?: PaymentType;
 }
 /** @oneof */
 interface PaymentComponentTypeOptionsOneOf {
-    /** Checkbox group input field. */
+    /** Checkbox group component settings. */
     checkboxGroupOptions?: ProductCheckboxGroup;
-    /** Donation input field. */
+    /** Donation input component settings. */
     donationInputOptions?: DonationInput;
-    /** Payment input field. */
+    /** Payment input component settings. */
     paymentInputOptions?: PaymentInput;
-    /** Fixed payment field. */
+    /** Fixed payment component settings. */
     fixedPaymentOptions?: FixedPayment;
 }
 interface Scheduling extends SchedulingComponentTypeOptionsOneOf {
-    /** Appointment input field */
+    /** Appointment component settings. */
     appointmentOptions?: Appointment;
     /**
-     * Component type of the scheduling input field
+     * Component type of the scheduling field.
      * @readonly
      */
     componentType?: SchedulingComponentTypeWithLiterals;
 }
 /** @oneof */
 interface SchedulingComponentTypeOptionsOneOf {
-    /** Appointment input field */
+    /** Appointment component settings. */
     appointmentOptions?: Appointment;
 }
 interface Address extends AddressComponentTypeOptionsOneOf {
-    /** Multiline address input field. */
+    /** Multiline address component settings. */
     multilineAddressOptions?: MultilineAddress;
     /**
      * Component type of the multiline address field.
      * @readonly
      */
     componentType?: ComponentTypeWithLiterals;
-    /** Validation of multiline address field output value. */
+    /** Validation configuration for the multiline address input. */
     validation?: MultilineAddressValidation;
 }
 /** @oneof */
 interface AddressComponentTypeOptionsOneOf {
-    /** Multiline address input field. */
+    /** Multiline address component settings. */
     multilineAddressOptions?: MultilineAddress;
 }
 interface FieldsDisplayField extends FieldsDisplayFieldDisplayFieldTypeOptionsOneOf {
-    /** Component displaying rich content */
+    /** Configuration for rich content display fields. */
     richContentOptions?: RichContentOptions;
-    /** Page navigation component resolving as navigation or submit buttons */
+    /** Configuration for page navigation display fields such as navigation or submit buttons. */
     pageNavigationOptions?: PageNavigationOptions;
-    /** Type of the display field */
+    /** Type of display field that determines its appearance and behavior. */
     displayFieldType?: DisplayFieldDisplayFieldTypeWithLiterals;
 }
 /** @oneof */
 interface FieldsDisplayFieldDisplayFieldTypeOptionsOneOf {
-    /** Component displaying rich content */
+    /** Configuration for rich content display fields. */
     richContentOptions?: RichContentOptions;
-    /** Page navigation component resolving as navigation or submit buttons */
+    /** Configuration for page navigation display fields such as navigation or submit buttons. */
     pageNavigationOptions?: PageNavigationOptions;
 }
 declare enum DisplayFieldDisplayFieldType {
+    /** Unknown field type. */
     UNKNOWN_FIELD_TYPE = "UNKNOWN_FIELD_TYPE",
+    /** Rich content display field. */
     RICH_CONTENT = "RICH_CONTENT",
+    /** Page navigation display field. */
     PAGE_NAVIGATION = "PAGE_NAVIGATION",
+    /** Login bar display field. */
     LOGIN_BAR = "LOGIN_BAR"
 }
 /** @enumType */
 type DisplayFieldDisplayFieldTypeWithLiterals = DisplayFieldDisplayFieldType | 'UNKNOWN_FIELD_TYPE' | 'RICH_CONTENT' | 'PAGE_NAVIGATION' | 'LOGIN_BAR';
 interface RichContentOptions {
-    /** Content of the header */
+    /** Rich content to display in the field. */
     richContent?: RichContent;
-    /** Number of paragraphs visible. Other part is hidden under expandable section. If not provided all text visible. */
+    /**
+     * Maximum number of paragraphs to show initially.
+     * Additional content is hidden behind an expandable section. If not specified, all content is visible.
+     */
     maxShownParagraphs?: number | null;
 }
 interface PageNavigationOptions {
     /**
-     * When button is not on last page it behaves as switch between pages page, text of label to go to next page.
+     * Text displayed on the button when it navigates to the next page.
+     * Only applicable when the button is not on the final form page.
      * @maxLength 65
      */
     nextPageText?: string | null;
     /**
-     * When button is not on last page it behaves as switch between pages page, text of label to go to previous page.
+     * Text displayed on the button when it navigates to the previous page.
+     * Only applicable when the button is not on the first form page.
      * @maxLength 65
      */
     previousPageText?: string | null;
     /**
-     * Text on the button when button is submitting a form
+     * Text displayed on the button when it submits the form.
+     * Only applicable when the button is on the final form page.
      * @maxLength 65
      */
     submitText?: string | null;
@@ -5066,95 +5271,93 @@ interface Step {
      * @maxLength 200
      */
     name?: string | null;
-    /** Is step hidden */
+    /** Whether the step is hidden. */
     hidden?: boolean;
-    /** Form step properties */
+    /** Layout configuration that defines how form fields are arranged within this step. */
     layout?: FormLayout;
 }
 interface FormLayout {
-    /** Layout for large break point. */
+    /** Layout configuration for large screen breakpoints (desktop). */
     large?: BreakPoint;
-    /** Layout for medium break point. */
+    /** Layout configuration for medium screen breakpoints (tablet). */
     medium?: BreakPoint;
-    /** Layout for small break point. */
+    /** Layout configuration for small screen breakpoints (mobile). */
     small?: BreakPoint;
 }
 interface BreakPoint {
     /**
-     * Description of layouts for items.
+     * Configuration for the layout of items in the breakpoint.
      * @maxSize 500
      */
     items?: ItemLayout[];
-    /** Amount of columns of layout grid. */
+    /** Number of columns in the layout grid. */
     columns?: number | null;
-    /** Row height of layout grid. */
+    /** Height of each row in the layout grid, measured in pixels. */
     rowHeight?: number | null;
-    /** Description of elements margins. */
+    /** Margin spacing configuration for the form elements. */
     margin?: Margin;
-    /** Description of elements paddings. */
+    /** Padding spacing inside form elements in pixels. */
     padding?: Margin;
 }
 interface ItemLayout extends ItemLayoutItemOneOf {
     /**
-     * Form field reference id.
+     * ID of the form field to be positioned in the layout.
      * @format GUID
      */
     fieldId?: string;
-    /** Group info, defining that this item is a group of multiple fields */
+    /** Group configuration for positioning multiple fields as a single layout unit. */
     group?: Group;
-    /** Horizontal coordinate in the grid. */
+    /** Row position in the grid where this item is placed. */
     row?: number | null;
-    /** Vertical coordinate in the grid. */
+    /** Column position in the grid where this item is placed. */
     column?: number | null;
-    /** Height. */
+    /** Width of the item in grid units. */
     width?: number | null;
-    /** Width. */
+    /** Height of the item in grid units. */
     height?: number | null;
 }
 /** @oneof */
 interface ItemLayoutItemOneOf {
     /**
-     * Form field reference id.
+     * ID of the form field to be positioned in the layout.
      * @format GUID
      */
     fieldId?: string;
-    /** Group info, defining that this item is a group of multiple fields */
+    /** Group configuration for positioning multiple fields as a single layout unit. */
     group?: Group;
 }
 interface Group {
     /**
-     * Field group reference id.
+     * ID of the field group.
      * @format GUID
      */
     groupId?: string;
     /**
-     * Description of layouts for items.
+     * Layout configuration for individual items within this group.
      * @minSize 1
      * @maxSize 500
      */
     items?: ItemLayout[];
 }
 interface Margin {
-    /** Horizontal value. */
+    /** Horizontal spacing in pixels. */
     horizontal?: number | null;
-    /** Vertical value. */
+    /** Vertical spacing in pixels. */
     vertical?: number | null;
 }
 interface Section {
     /**
-     * Id of the section
+     * Section ID.
      * @format GUID
      * @minLength 1
      */
     _id?: string;
-    /** Horizontal coordinate in the grid. */
+    /** Row position where this section is placed in the grid. */
     row?: number | null;
     /**
-     * A list of field identifiers that are permitted to be placed within a section.
-     * The section will only accept fields with IDs specified in this list.
-     * If the section encounters the $new key within the list,
-     * it allows the inclusion of fields not explicitly listed,
-     * enabling dynamic addition of new fields.
+     * A list of field IDs that can be placed within the section.
+     * The section only accepts fields with IDs specified in this list.
+     * If the `$new` key is contained in this list, the section allows the inclusion of fields not explicitly listed, enabling dynamic addition of new fields.
      * @maxSize 100
      * @maxLength 100
      */
@@ -5162,44 +5365,49 @@ interface Section {
 }
 interface FormRule {
     /**
-     * Id of the rule
+     * Rule ID.
      * @format GUID
      * @immutable
      */
     _id?: string;
-    /** Rule on which item properties or layouts will be changed. */
+    /** Condition that determines when this rule's overrides should be applied. */
     condition?: Record<string, any> | null;
     /**
-     * Form items with defined properties that will be
-     * changed when given condition is resolved to true.
+     * Changes to apply to form elements when the condition evaluates to true.
      * @maxSize 500
      */
     overrides?: FormOverride[];
     /**
-     * Name of the rule
+     * Name for the rule.
      * @maxLength 200
      */
     name?: string | null;
 }
 declare enum OverrideEntityType {
+    /** Unknown override entity type. */
     UNKNOWN = "UNKNOWN",
+    /** Override applies to a form field. */
     FIELD = "FIELD"
 }
 /** @enumType */
 type OverrideEntityTypeWithLiterals = OverrideEntityType | 'UNKNOWN' | 'FIELD';
 interface FormOverride {
     /**
-     * Override entity type.
+     * Type of form element that this override targets.
      * @immutable
      */
     entityType?: OverrideEntityTypeWithLiterals;
     /**
-     * Overridden entity id. Either fieldId, or "{fieldIdWithNestedForm}/{nestedFormFieldId}"
+     * ID of the form element to modify.
+     * For nested form fields, use the format: "{fieldIdWithNestedForm}/{nestedFormFieldId}".
      * @immutable
      * @maxLength 73
      */
     entityId?: string | null;
-    /** Form entity properties path with new value, that will be changed on condition. */
+    /**
+     * Property changes to apply to the form element when the rule condition is met.
+     * Each key represents a property path, and the value is the new value to set.
+     */
     valueChanges?: Record<string, any>;
 }
 interface FormProperties {
@@ -5228,19 +5436,21 @@ declare enum Kind {
 /** @enumType */
 type KindWithLiterals = Kind | 'REGULAR' | 'EXTENSION';
 interface PostSubmissionTriggers {
-    /** Upserts a contact from the submission data. */
+    /** Upserts a [contact](https://support.wix.com/en/article/about-your-contact-list) to the Wix site from the form submission data. */
     upsertContact?: UpsertContact;
 }
 interface UpsertContact {
     /**
-     * Fields mapping (target field mapped to corresponding contact field).
+     * Fields mapping between the form fields and the contact fields.
+     *
+     * This is the target form field mapped to the corresponding contact field.
+     *
+     * The key is the form field ID, and the value is the contact field.
      * @maxSize 250
      */
     fieldsMapping?: Record<string, V4FormFieldContactInfo>;
     /**
-     * List of contact label keys.
-     * [Contact labels](https://support.wix.com/en/article/adding-labels-to-contacts-in-your-contact-list)
-     * help categorize contacts.
+     * List of [labels](https://support.wix.com/en/article/creating-contact-labels) to add to the contact to help categorize it.
      * @minLength 1
      * @maxLength 100
      * @maxSize 20
@@ -5266,29 +5476,29 @@ interface LimitationRule {
 declare enum SpamFilterProtectionLevel {
     /** Unknown spam filter protection level. */
     UNKNOWN = "UNKNOWN",
-    /** Spam filter is not used. Form is open for spam submissions. */
+    /** No spam filtering. All submissions are accepted without screening. */
     NONE = "NONE",
-    /** Spam filter operates in basic mode. Form is open to high risk of spam submissions. */
+    /** Basic spam filtering. Provides minimal protection against obvious spam and the form is open to a high risk of spam submissions. */
     BASIC = "BASIC",
-    /** Spam filter operates in advanced mode. Form is open to low risk of spam submissions. */
+    /** Advanced spam filtering. Provides comprehensive protection with intelligent screening and the form is open to a low risk of spam submissions. */
     ADVANCED = "ADVANCED"
 }
 /** @enumType */
 type SpamFilterProtectionLevelWithLiterals = SpamFilterProtectionLevel | 'UNKNOWN' | 'NONE' | 'BASIC' | 'ADVANCED';
 interface RequiredIndicatorProperties {
-    /** Required indicator. */
+    /** Type of visual indicator used to mark required fields. */
     requiredIndicator?: RequiredIndicatorWithLiterals;
-    /** Required indicator placement. */
+    /** Position where the required indicator appears relative to the field title. */
     requiredIndicatorPlacement?: RequiredIndicatorPlacementWithLiterals;
 }
 declare enum RequiredIndicator {
-    /** Unknown required indicator. */
+    /** Unknown required indicator type. */
     UNKNOWN_INDICATOR = "UNKNOWN_INDICATOR",
-    /** Asterisk (*). */
+    /** Display an asterisk (*) symbol to indicate required fields. */
     ASTERISK = "ASTERISK",
-    /** Text (default: "Required"). */
+    /** Display the text "Required" to indicate required fields. */
     TEXT = "TEXT",
-    /** None. */
+    /** No visual indicator is shown for required fields. */
     NONE = "NONE"
 }
 /** @enumType */
@@ -5296,34 +5506,34 @@ type RequiredIndicatorWithLiterals = RequiredIndicator | 'UNKNOWN_INDICATOR' | '
 declare enum RequiredIndicatorPlacement {
     /** Unknown required indicator placement. */
     UNKNOWN_PLACEMENT = "UNKNOWN_PLACEMENT",
-    /** After field title. */
+    /** Place the required indicator after the field title. */
     AFTER_FIELD_TITLE = "AFTER_FIELD_TITLE",
-    /** Before field title. */
+    /** Place the required indicator before the field title. */
     BEFORE_FIELD_TITLE = "BEFORE_FIELD_TITLE"
 }
 /** @enumType */
 type RequiredIndicatorPlacementWithLiterals = RequiredIndicatorPlacement | 'UNKNOWN_PLACEMENT' | 'AFTER_FIELD_TITLE' | 'BEFORE_FIELD_TITLE';
 interface SubmitSettings extends SubmitSettingsSubmitSuccessActionOptionsOneOf {
-    /** Options for showing a thank you message after submission. */
+    /** Configuration for displaying a thank you message after submission. */
     thankYouMessageOptions?: ThankYouMessageOptions;
-    /** Options for redirecting to a URL after submission. */
+    /** Configuration for redirecting submitters to a URL after submission. */
     redirectOptions?: RedirectOptions;
-    /** Action that is triggered after a successful form submission. */
+    /** Action that's triggered after a form is successfully submitted. */
     submitSuccessAction?: SubmitSuccessActionWithLiterals;
 }
 /** @oneof */
 interface SubmitSettingsSubmitSuccessActionOptionsOneOf {
-    /** Options for showing a thank you message after submission. */
+    /** Configuration for displaying a thank you message after submission. */
     thankYouMessageOptions?: ThankYouMessageOptions;
-    /** Options for redirecting to a URL after submission. */
+    /** Configuration for redirecting submitters to a URL after submission. */
     redirectOptions?: RedirectOptions;
 }
 declare enum Target {
-    /** Unknown target. */
+    /** Unknown target behavior. */
     UNKNOWN_TARGET = "UNKNOWN_TARGET",
-    /** Open in the same browser tab. */
+    /** Open the URL in the same browser tab, replacing the current page. */
     SELF = "SELF",
-    /** Open in a new browser tab. */
+    /** Open the URL in a new browser tab. */
     BLANK = "BLANK"
 }
 /** @enumType */
@@ -5331,28 +5541,31 @@ type TargetWithLiterals = Target | 'UNKNOWN_TARGET' | 'SELF' | 'BLANK';
 declare enum SubmitSuccessAction {
     /** Unknown submit success action. */
     UNKNOWN_SUBMIT_SUCCESS_ACTION = "UNKNOWN_SUBMIT_SUCCESS_ACTION",
-    /** No action will be taken after submission. */
+    /** No action is taken after form submission. */
     NO_ACTION = "NO_ACTION",
-    /** A thank you message will be shown after submission. */
+    /** Display a thank you message after form submission. */
     THANK_YOU_MESSAGE = "THANK_YOU_MESSAGE",
-    /** The user will be redirected to a URL after submission. */
+    /** Redirect the user to a specified URL after form submission. */
     REDIRECT = "REDIRECT"
 }
 /** @enumType */
 type SubmitSuccessActionWithLiterals = SubmitSuccessAction | 'UNKNOWN_SUBMIT_SUCCESS_ACTION' | 'NO_ACTION' | 'THANK_YOU_MESSAGE' | 'REDIRECT';
 interface ThankYouMessageOptions {
-    /** Duration in seconds after which the message should disappear. If 0, the message will stay forever. */
+    /**
+     * Duration in seconds before the thank you message automatically disappears.
+     * If set to 0, the message remains visible until manually dismissed.
+     */
     durationInSeconds?: number | null;
-    /** The message shown after form submission. */
+    /** Rich content message displayed to users after successful form submission. */
     richContent?: RichContent;
 }
 interface RedirectOptions {
     /**
-     * The URL to which the user should be redirected after a successful form submission.
+     * URL to which the user should be redirected after successfully submitting the form.
      * @maxLength 2000
      */
     redirectUrl?: string | null;
-    /** How the URL should be opened. */
+    /** How the redirect URL should be opened in the browser. */
     target?: TargetWithLiterals;
 }
 interface FieldGroup {
@@ -5369,26 +5582,29 @@ interface FieldGroup {
 }
 interface Rule {
     /**
-     * Id of the rule
+     * Rule ID.
      * @format GUID
      * @immutable
      */
     _id?: string;
-    /** Rule on which item properties or layouts will be changed. */
+    /**
+     * Conditional expression that determines when this rule should be applied.
+     * The overrides defined in this rule are applied when this expression evaluates to true.
+     */
     expression?: ConditionNode;
     /**
-     * Form items with defined properties that will be
-     * changed when given condition is resolved to true.
+     * Form modifications that are applied when the rule expression evaluates to true.
+     * Each override specifies how a form element should be changed.
      * @maxSize 500
      */
     overrides?: RuleFormOverride[];
     /**
-     * Name of the rule
+     * Human-readable name for the rule.
      * @maxLength 200
      */
     name?: string | null;
 }
-/** Enum for different types of changeable properties. */
+/** Enum for different types of field properties that can be modified by rules. */
 declare enum ChangeableProperty {
     /** Unknown property type. */
     UNKNOWN_CHANGEABLE_PROPERTY = "UNKNOWN_CHANGEABLE_PROPERTY",
@@ -5402,72 +5618,75 @@ declare enum ChangeableProperty {
 /** @enumType */
 type ChangeablePropertyWithLiterals = ChangeableProperty | 'UNKNOWN_CHANGEABLE_PROPERTY' | 'REQUIRED' | 'HIDDEN' | 'ALLOWED_VALUES';
 interface RequiredOptions {
-    /** Value of required property */
+    /** Whether the field should be required. */
     required?: boolean;
 }
 interface HiddenOptions {
-    /** Value of hidden property */
+    /** Whether the field should be hidden. */
     hidden?: boolean;
 }
 interface AllowedValuesOptions {
     /**
-     * Allowed values
+     * List of values that are allowed for the field when this rule is active.
+     * Restricts user input to only these predefined options.
      * @maxSize 300
      * @maxLength 200
      */
     allowedValues?: string[];
 }
 declare enum OverrideEntityTypeEnumOverrideEntityType {
+    /** Unknown override entity type. */
     UNKNOWN_OVERRIDE_ENTITY_TYPE = "UNKNOWN_OVERRIDE_ENTITY_TYPE",
+    /** Override applies to a form field. */
     FIELD = "FIELD"
 }
 /** @enumType */
 type OverrideEntityTypeEnumOverrideEntityTypeWithLiterals = OverrideEntityTypeEnumOverrideEntityType | 'UNKNOWN_OVERRIDE_ENTITY_TYPE' | 'FIELD';
 interface FieldOverride extends FieldOverridePropertyTypeOptionsOneOf {
-    /** Required property overrides */
+    /** Configuration for changing the required property of a field. */
     requiredOptions?: RequiredOptions;
-    /** Hidden property overrides */
+    /** Configuration for changing the visibility property of a field. */
     hiddenOptions?: HiddenOptions;
-    /** Allowed values property overrides */
+    /** Configuration for changing the allowed values of a field. */
     allowedValuesOptions?: AllowedValuesOptions;
     /**
-     * Overridden entity id
+     * ID of the field to be modified by this override.
      * @immutable
      * @format GUID
      */
     fieldId?: string;
-    /** Form entity properties path with new value, that will be changed on condition. */
+    /** The new value for the field property that will be set when the rule conditions are met. */
     propertyType?: ChangeablePropertyWithLiterals;
 }
 /** @oneof */
 interface FieldOverridePropertyTypeOptionsOneOf {
-    /** Required property overrides */
+    /** Configuration for changing the required property of a field. */
     requiredOptions?: RequiredOptions;
-    /** Hidden property overrides */
+    /** Configuration for changing the visibility property of a field. */
     hiddenOptions?: HiddenOptions;
-    /** Allowed values property overrides */
+    /** Configuration for changing the allowed values of a field. */
     allowedValuesOptions?: AllowedValuesOptions;
 }
 interface ConditionNode extends ConditionNodeNodeOneOf {
-    /** A compound condition that requires all conditions to be true. */
+    /** Logical AND condition with 1 or more child conditions. All child conditions must be true. */
     and?: AndCondition;
-    /** A compound condition that requires at least one condition to be true. */
+    /** Logical OR condition with 1 or more child conditions. At least 1 child condition must be true. */
     or?: OrCondition;
-    /** A single condition in the rule. */
+    /** Single condition to evaluate. */
     condition?: Condition;
 }
 /** @oneof */
 interface ConditionNodeNodeOneOf {
-    /** A compound condition that requires all conditions to be true. */
+    /** Logical AND condition with 1 or more child conditions. All child conditions must be true. */
     and?: AndCondition;
-    /** A compound condition that requires at least one condition to be true. */
+    /** Logical OR condition with 1 or more child conditions. At least 1 child condition must be true. */
     or?: OrCondition;
-    /** A single condition in the rule. */
+    /** Single condition to evaluate. */
     condition?: Condition;
 }
 interface AndCondition {
     /**
-     * The list of conditions that must all be true.
+     * List of conditions that must all evaluate to true.
      * @minSize 1
      * @maxSize 100
      */
@@ -5475,7 +5694,7 @@ interface AndCondition {
 }
 interface OrCondition {
     /**
-     * The list of conditions where at least one must be true.
+     * List of conditions where at least 1 must evaluate to true.
      * @minSize 1
      * @maxSize 100
      */
@@ -5483,58 +5702,85 @@ interface OrCondition {
 }
 interface Condition {
     /**
-     * The property name to be evaluated, supports dot notation for nested properties.
+     * Human readable identifier used to reference a field.
+     * Supports dot notation for nested properties. For example, `"address.city"`.
      * @maxLength 100
      */
     target?: string;
-    /** The operator to use for comparison. */
+    /** Comparison operator to use for evaluating the condition. */
     operator?: OperatorWithLiterals;
-    /** The value to compare against. */
+    /** Value to compare against the value in the target field. */
     value?: any;
 }
 declare enum Operator {
     UNKNOWN_OPERATOR = "UNKNOWN_OPERATOR",
+    /** Specified value equals the value in the target field. */
     EQUAL = "EQUAL",
+    /** Specified value doesn't equal the value in the target field. */
     NOT_EQUAL = "NOT_EQUAL",
+    /** Target field is empty or has no value. */
     EMPTY = "EMPTY",
+    /** Target field isn't empty and has a value. */
     NOT_EMPTY = "NOT_EMPTY",
+    /** String value in the target field contains the specified substring. */
     CONTAINS = "CONTAINS",
+    /** String value in the target field doesn't contain the specified substring. */
     NOT_CONTAINS = "NOT_CONTAINS",
+    /** Numeric value in the target field is less than the specified value. */
     LESS_THAN = "LESS_THAN",
+    /** Numeric value in the target field is less than or equal to the specified value. */
     LESS_THAN_OR_EQUALS = "LESS_THAN_OR_EQUALS",
+    /** Numeric value in the target field is greater than the specified value. */
     GREATER_THAN = "GREATER_THAN",
+    /** Numeric value in the target field is greater than or equal to the specified value. */
     GREATER_THAN_OR_EQUALS = "GREATER_THAN_OR_EQUALS",
+    /** Date value in the target field is before the specified date. */
     BEFORE = "BEFORE",
+    /** Date value in the target field is before or equal to the specified date. */
     BEFORE_OR_EQUAL = "BEFORE_OR_EQUAL",
+    /** Date value in the target field is after the specified date. */
     AFTER = "AFTER",
+    /** Date value in the target field is after or equal to the specified date. */
     AFTER_OR_EQUAL = "AFTER_OR_EQUAL",
+    /** Value in the target field falls within the specified range. */
     BETWEEN = "BETWEEN",
+    /** Value in the target field matches any of the specified values. */
     ANY = "ANY",
+    /** Array value in the target field exactly equals the specified array. */
     ARRAY_EQUAL = "ARRAY_EQUAL",
+    /** Array value in the target field doesn't equal the specified array. */
     ARRAY_NOT_EQUAL = "ARRAY_NOT_EQUAL",
+    /** Checkbox or boolean field value in the target field is checked. */
     CHECKED = "CHECKED",
+    /** Checkbox or boolean field value in the target field isn't checked. */
     NOT_CHECKED = "NOT_CHECKED",
+    /** Value in the target field is included in the specified list. */
     IN = "IN",
+    /** Value in the target field isn't included in the specified list. */
     NOT_IN = "NOT_IN",
+    /** Date value in the target field is older than the specified time period. */
     IS_DATE_OLDER_THAN = "IS_DATE_OLDER_THAN",
+    /** Date value in the target field is older than or equal to the specified time period. */
     IS_DATE_OLDER_THAN_OR_EQUAL = "IS_DATE_OLDER_THAN_OR_EQUAL",
+    /** Date value in the target field is newer than the specified time period. */
     IS_DATE_NEWER_THAN = "IS_DATE_NEWER_THAN",
+    /** Date value in the target field is newer than or equal to the specified time period. */
     IS_DATE_NEWER_THAN_OR_EQUAL = "IS_DATE_NEWER_THAN_OR_EQUAL"
 }
 /** @enumType */
 type OperatorWithLiterals = Operator | 'UNKNOWN_OPERATOR' | 'EQUAL' | 'NOT_EQUAL' | 'EMPTY' | 'NOT_EMPTY' | 'CONTAINS' | 'NOT_CONTAINS' | 'LESS_THAN' | 'LESS_THAN_OR_EQUALS' | 'GREATER_THAN' | 'GREATER_THAN_OR_EQUALS' | 'BEFORE' | 'BEFORE_OR_EQUAL' | 'AFTER' | 'AFTER_OR_EQUAL' | 'BETWEEN' | 'ANY' | 'ARRAY_EQUAL' | 'ARRAY_NOT_EQUAL' | 'CHECKED' | 'NOT_CHECKED' | 'IN' | 'NOT_IN' | 'IS_DATE_OLDER_THAN' | 'IS_DATE_OLDER_THAN_OR_EQUAL' | 'IS_DATE_NEWER_THAN' | 'IS_DATE_NEWER_THAN_OR_EQUAL';
 interface RuleFormOverride extends RuleFormOverrideEntityTypeOptionsOneOf {
-    /** Field override properties. */
+    /** Field override settings. */
     fieldOptions?: FieldOverride;
     /**
-     * Override entity type.
+     * Type of form element being modified by this override.
      * @immutable
      */
     entityType?: OverrideEntityTypeEnumOverrideEntityTypeWithLiterals;
 }
 /** @oneof */
 interface RuleFormOverrideEntityTypeOptionsOneOf {
-    /** Field override properties. */
+    /** Field override settings. */
     fieldOptions?: FieldOverride;
 }
 interface CreateCheckoutFromSubmissionResponse {
@@ -5778,7 +6024,7 @@ interface SubmissionValidationErrorsDetails {
 }
 interface ValidationError {
     /**
-     * Path indicating the source of the error, such as `submission.submissions.email``
+     * Path indicating the source of the error, such as `submission.submissions.email`
      * @maxLength 1000
      */
     errorPath?: string;