@wix/auto_sdk_stores_read-only-variants-v-3 1.0.48 → 1.0.50

package/build/es/meta.d.mts

@@ -1,4 +1,4 @@
-import { aX as QueryVariantsRequest$1, b0 as QueryVariantsResponse$1, b3 as SearchVariantsRequest$1, a as SearchVariantsResponse$1 } from './stores-catalog-v3-read-only-variant-read-only-variants-v-3.universal-BmO0mCp5.mjs';
+import { aX as QueryVariantsRequest$1, b0 as QueryVariantsResponse$1, b3 as SearchVariantsRequest$1, a as SearchVariantsResponse$1 } from './stores-catalog-v3-read-only-variant-read-only-variants-v-3.universal-DDymOH93.mjs';
 import '@wix/sdk-types';
 
 /**
@@ -1803,7 +1803,7 @@ interface Product extends ProductTypedPropertiesOneOf {
      * > **Note:** Always `false` for `productType: DIGITAL`.
      */
     visibleInPos?: boolean | null;
-    /** Product media items. */
+    /** Product media items. For a detailed explanation of product media, see [About Product Media](https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/products-v3/about-product-media). */
     media?: Media;
     /** Product SEO data. */
     seoData?: SeoSchema;
@@ -1813,18 +1813,20 @@ interface Product extends ProductTypedPropertiesOneOf {
      */
     taxGroupId?: string | null;
     /**
-     * Product options. Each option (like "Size" or "Color") creates variants when combined with other options.
+     * Product options, such as "Size" or "Color". Options define the ways a product can vary.
      *
-     * When you provide options, you must also provide the corresponding variants. Each variant must have exactly one choice for each option.
-     * To use existing [customizations](https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/customizations-v3/introduction), pass their IDs. Otherwise, new customization entities are automatically created.
+     * When you provide options, you must also provide the corresponding variants. Each variant must have exactly one choice for each option. For more information, see [About Product Options and Variants](https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/about-options-and-variants).
+     *
+     * Options are stored as reusable [customization](https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/customizations-v3/introduction) entities. Pass an existing customization's ID to reuse it, or define options inline and new customization entities are created automatically.
      * @maxSize 6
      */
     options?: ConnectedOption[];
     /**
      * Product modifiers. Collect additional information from customers without creating variants.
      *
-     * Unlike options, modifiers don't affect inventory or create additional variants. Use them for customizations like gift messages or engraving text.
-     * To use existing [customizations](https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/customizations-v3/introduction), pass their IDs. Otherwise, new customization entities are automatically created.
+     * Unlike options, modifiers don't affect inventory or create additional variants. Use them for things like gift messages or engraving text. For more information, see [About Product Options and Variants](https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/about-options-and-variants).
+     *
+     * Modifiers are stored as reusable [customization](https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/customizations-v3/introduction) entities. Pass an existing customization's ID to reuse it, or define modifiers inline and new customization entities are created automatically.
      * @maxSize 10
      */
     modifiers?: ConnectedModifier[];
@@ -1927,8 +1929,12 @@ interface Product extends ProductTypedPropertiesOneOf {
      */
     compareAtPriceRange?: PriceRange;
     /**
-     * Product variants. Each variant must reference all product options via its `choices` array.
-     * Each choice references an option using `optionChoiceNames` for all requests.
+     * Product variants. Each variant represents a specific purchasable version of a product defined by option choices.
+     *
+     * Each variant must reference all product options via its `choices` array, using `optionChoiceNames` in requests.
+     * You must explicitly provide each variant when creating products with options.
+     *
+     * For more information, see [About Product Options and Variants](https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/about-options-and-variants).
      */
     variantsInfo?: VariantsInfo;
     /**
@@ -3872,12 +3878,12 @@ interface ProductMedia extends ProductMediaSetByOneOf, ProductMediaMediaOneOf {
      */
     url?: string;
     /**
-     * Product image.
+     * Image details. Populated when you provide a [Wix Media Manager](https://support.wix.com/en/article/wix-media-about-the-media-manager) file ID in `set_by`.
      * @readonly
      */
     image?: Image;
     /**
-     * Product video.
+     * Video details. Populated when you provide a Wix Media Manager file ID in `set_by`.
      * @readonly
      */
     video?: VideoV2;
@@ -3889,7 +3895,8 @@ interface ProductMedia extends ProductMediaSetByOneOf, ProductMediaMediaOneOf {
     altText?: string | null;
     /**
      * Media display name.
-     * Allows to override the default media name. Can be passed only when `setBy: url`.
+     *
+     * Overrides the default media name. Can be passed only when the media is set by a URL in `setBy``.
      * @maxLength 80
      */
     displayName?: string | null;
@@ -3927,12 +3934,12 @@ interface ProductMediaSetByOneOf {
 /** @oneof */
 interface ProductMediaMediaOneOf {
     /**
-     * Product image.
+     * Image details. Populated when you provide a [Wix Media Manager](https://support.wix.com/en/article/wix-media-about-the-media-manager) file ID in `set_by`.
      * @readonly
      */
     image?: Image;
     /**
-     * Product video.
+     * Video details. Populated when you provide a Wix Media Manager file ID in `set_by`.
      * @readonly
      */
     video?: VideoV2;
@@ -4033,7 +4040,9 @@ interface Thumbnail {
 }
 interface MediaItemsInfo {
     /**
-     * All media items (images, videos etc) associated with this product.
+     * All media items associated with this product.
+     *
+     * The first item in the array is automatically set as the product's main media.
      * @maxSize 15
      */
     items?: ProductMedia[];
@@ -4156,7 +4165,7 @@ interface ConnectedOptionChoice extends ConnectedOptionChoiceValueOneOf {
      * When not empty, only these images are shown when a customer selects this choice. Otherwise, all product images are shown.
      * When multiple choices from different options are selected, only media present in `linkedMedia` of ALL selected choices are shown.
      * For example, if `Color: Red` has images 1, 2, 3 and `Material: Silk` has images 2, 3, 5, then only images 2 and 3 are shown when both are selected.
-     * @maxSize 100
+     * @maxSize 15
      */
     linkedMedia?: ProductMedia[];
     /** Choice type. */
@@ -4294,7 +4303,7 @@ interface ConnectedModifierChoice extends ConnectedModifierChoiceValueOneOf {
     choiceId?: string | null;
     /**
      * Product media.
-     * @maxSize 100
+     * @maxSize 15
      */
     linkedMedia?: ProductMedia[];
     /** Choice type. */
@@ -4656,9 +4665,9 @@ interface Variant extends VariantTypedPropertiesOneOf {
     /**
      * List of choices that define this variant. Each variant must have exactly one choice for each product option.
      *
-     * Must use `optionChoiceNames` in all requests this field is required.
+     * Use `optionChoiceNames` in all requests where this field is required. For products without options, this array is empty, representing a single "default variant".
      *
-     * For products without options, this array is empty, representing a single "default variant".
+     * For more information, see [About Product Options and Variants](https://dev.wix.com/docs/api-reference/business-solutions/stores/catalog-v3/about-options-and-variants).
      * @maxSize 6
      * @immutable
      */
@@ -4733,7 +4742,7 @@ interface OptionChoiceNames {
      * @minLength 1
      */
     choiceName?: string;
-    /** Render type. */
+    /** Render type of the option. Required when using `optionChoiceNames`. Must match the `optionRenderType` of the referenced option. */
     renderType?: ProductOptionRenderTypeWithLiterals;
 }
 interface PriceInfo {