[ci] release 2025.10.0

packages/hydrogen-react/CHANGELOG.md

@@ -1,5 +1,67 @@
 # @shopify/hydrogen-react
 
+## 2025.10.0
+
+### Major Changes
+
+- Update Storefront API and Customer Account API to version 2025-10 ([#3352](https://github.com/Shopify/hydrogen/pull/3352)) by [@fredericoo](https://github.com/fredericoo)
+
+### Minor Changes
+
+- Add `visitorConsent` support to `@inContext` directive for Storefront API parity ([#3408](https://github.com/Shopify/hydrogen/pull/3408)) by [@kdaviduik](https://github.com/kdaviduik)
+
+  **Note: Most Hydrogen storefronts do NOT need this feature.**
+
+  This API addition provides Storefront API 2025-10 parity for the `visitorConsent` parameter in `@inContext` directives. However, if you're using Hydrogen's analytics provider or Shopify's Customer Privacy API (including third-party consent services integrated with it), consent is already handled automatically and you don't need to use this.
+
+  This feature is primarily intended for Checkout Kit and other non-Hydrogen integrations that manage consent outside of Shopify's standard consent flow.
+
+  **What it does:**
+  When explicitly provided, `visitorConsent` encodes buyer consent preferences (analytics, marketing, preferences, saleOfData) into the cart's `checkoutUrl` via the `_cs` parameter.
+
+### Patch Changes
+
+- Add `parent` prop to `AddToCartButton` for nested cart lines ([#3398](https://github.com/Shopify/hydrogen/pull/3398)) by [@fredericoo](https://github.com/fredericoo)
+
+  The `AddToCartButton` component now accepts an optional `parent` prop, allowing you to add items as children of an existing cart line. This enables adding warranties, gift wrapping, or other add-ons that should be associated with a parent product.
+
+  ### Usage
+
+  ```tsx
+  import {AddToCartButton} from '@shopify/hydrogen-react';
+
+  // Add a warranty as a child of an existing cart line (by line ID)
+  <AddToCartButton
+    variantId="gid://shopify/ProductVariant/warranty-123"
+    parent={{parentLineId: 'gid://shopify/CartLine/parent-456'}}
+  >
+    Add Extended Warranty
+  </AddToCartButton>
+
+  // Add a warranty as a child of a cart line (by merchandise ID)
+  // Useful when you know the product variant but not the cart line ID
+  <AddToCartButton
+    variantId="gid://shopify/ProductVariant/warranty-123"
+    parent={{merchandiseId: 'gid://shopify/ProductVariant/laptop-456'}}
+  >
+    Add Extended Warranty
+  </AddToCartButton>
+  ```
+
+  ### Type
+
+  ```ts
+  interface AddToCartButtonPropsBase {
+    // ... existing props
+    /** The parent line item of the item being added to the cart. Used for nested cart lines. */
+    parent?: CartLineParentInput;
+  }
+  ```
+
+- Add support for `article_reference` and `list.article_reference` metafield types ([#3407](https://github.com/Shopify/hydrogen/pull/3407)) by [@kdaviduik](https://github.com/kdaviduik)
+
+  These new metafield types were introduced in Storefront API 2025-10, allowing merchants to reference blog articles in metafields.
+
 ## 2025.7.2
 
 ### Minor Changes

packages/hydrogen-react/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shopify/hydrogen-react",
-  "version": "2025.7.2",
+  "version": "2025.10.0",
   "description": "React components, hooks, and utilities for creating custom Shopify storefronts",
   "homepage": "https://github.com/Shopify/hydrogen/tree/main/packages/hydrogen-react",
   "license": "MIT",