@wix/auto_sdk_stores_catalog-imports-v-3 1.0.20 → 1.0.21

package/build/es/index.typings.d.mts

@@ -113,18 +113,20 @@ interface ProductWithInventory extends ProductWithInventoryTypedPropertiesOneOf
      */
     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[];
@@ -172,8 +174,12 @@ interface ProductWithInventory extends ProductWithInventoryTypedPropertiesOneOf
      */
     handle?: 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.
+     * Variants aren't auto-generated. 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;
     /**