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

package/build/internal/es/{stores-catalog-v3-read-only-variant-read-only-variants-v-3.universal-DK8tu3gS.d.mts → stores-catalog-v3-read-only-variant-read-only-variants-v-3.universal-DxKHqgOx.d.mts}

@@ -1750,7 +1750,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;
@@ -1760,18 +1760,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[];
@@ -1886,8 +1888,12 @@ interface Product extends ProductTypedPropertiesOneOf {
      */
     inventoryAppId?: string | null;
     /**
-     * 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;
     /**
@@ -3825,12 +3831,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?: string;
     /**
-     * Product video.
+     * Video details. Populated when you provide a Wix Media Manager file ID in `set_by`.
      * @readonly
      */
     video?: string;
@@ -3842,7 +3848,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;
@@ -3880,12 +3887,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?: string;
     /**
-     * Product video.
+     * Video details. Populated when you provide a Wix Media Manager file ID in `set_by`.
      * @readonly
      */
     video?: string;
@@ -3934,7 +3941,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[];
@@ -4057,7 +4066,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. */
@@ -4195,7 +4204,7 @@ interface ConnectedModifierChoice extends ConnectedModifierChoiceValueOneOf {
     choiceId?: string | null;
     /**
      * Product media.
-     * @maxSize 100
+     * @maxSize 15
      */
     linkedMedia?: ProductMedia[];
     /** Choice type. */
@@ -4557,9 +4566,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
      */
@@ -4634,7 +4643,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 {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/auto_sdk_stores_read-only-variants-v-3",
-  "version": "1.0.48",
+  "version": "1.0.50",
   "license": "MIT",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
@@ -50,5 +50,5 @@
       "fqdn": "wix.stores.catalog.v3.read_only_variant"
     }
   },
-  "falconPackageHash": "97b7656600995259e3144d49f8ce87b393da605b379ffc189d717af7"
+  "falconPackageHash": "43e16f0b80705e4cf963b0fc3852ce0887f97af1c4bdec1e384dfba1"
 }