@shopify/hydrogen 2026.4.2 → 2026.4.3

package/dist/production/react-router-preset.d.ts

@@ -1,12 +1,12 @@
 import { Preset } from '@react-router/dev/config';
 
 /**
- * Official Hydrogen Preset for React Router 7.12.x
+ * Official Hydrogen Preset for React Router 7.16.x
  *
  * Provides optimal React Router configuration for Hydrogen applications on Oxygen.
  * Enables validated performance optimizations while ensuring CLI compatibility.
  *
- * React Router 7.12.x Feature Support Matrix for Hydrogen 2025.7.0
+ * React Router 7.16.x Feature Support Matrix for Hydrogen 2025.7.0
  *
  * +----------------------------------+----------+----------------------------------+
  * | Feature                          | Status   | Notes                            |
@@ -34,7 +34,7 @@ import { Preset } from '@react-router/dev/config';
  * | prerender: ['/routes']           | Blocked  | Plugin incompatibility           |
  * | serverBundles: () => {}          | Blocked  | Manifest incompatibility         |
  * | buildEnd: () => {}               | Blocked  | CLI bypasses hook execution      |
- * | unstable_subResourceIntegrity    | Blocked  | CSP nonce/hash conflict          |
+ * | subResourceIntegrity             | Blocked  | CSP nonce/hash conflict          |
  * | v8_viteEnvironmentApi            | Blocked  | CLI fallback detection used      |
  * +----------------------------------+----------+----------------------------------+
  *

package/dist/production/react-router-preset.js

@@ -1,4 +1,4 @@
-function r(){return{name:"hydrogen-2025.7.0",reactRouterConfig:()=>({appDirectory:"app",buildDirectory:"dist",ssr:!0,future:{v8_middleware:!0,v8_splitRouteModules:!0,v8_viteEnvironmentApi:!1,unstable_optimizeDeps:!0,unstable_subResourceIntegrity:!1}}),reactRouterConfigResolved:({reactRouterConfig:e})=>{if(e.basename&&e.basename!=="/")throw new Error(`[Hydrogen Preset] basename is not supported in Hydrogen 2025.7.0.
+function r(){return{name:"hydrogen-2025.7.0",reactRouterConfig:()=>({appDirectory:"app",buildDirectory:"dist",ssr:!0,future:{v8_middleware:!0,v8_splitRouteModules:!0,v8_viteEnvironmentApi:!1,unstable_optimizeDeps:!0},subResourceIntegrity:!1}),reactRouterConfigResolved:({reactRouterConfig:e})=>{if(e.basename&&e.basename!=="/")throw new Error(`[Hydrogen Preset] basename is not supported in Hydrogen 2025.7.0.
 Reason: Requires major CLI infrastructure modernization.
 Workaround: Use reverse proxy or CDN path rewriting for subdirectory hosting.`);if(e.prerender)throw new Error(`[Hydrogen Preset] prerender is not supported in Hydrogen 2025.7.0.
 Reason: React Router plugin incompatibility with Hydrogen CLI build pipeline.
@@ -6,6 +6,6 @@ Workaround: Use external static generation tools or server-side caching.`);if(e.
 Reason: React Router plugin manifest incompatibility with Hydrogen CLI.
 Alternative: Route-level code splitting via v8_splitRouteModules is enabled.`);if(e.buildEnd)throw new Error(`[Hydrogen Preset] buildEnd is not supported in Hydrogen 2025.7.0.
 Reason: Hydrogen CLI bypasses React Router buildEnd hook execution.
-Workaround: Use external build scripts or package.json post-build hooks.`);if(e.future?.unstable_subResourceIntegrity===!0)throw new Error(`[Hydrogen Preset] unstable_subResourceIntegrity cannot be enabled.
+Workaround: Use external build scripts or package.json post-build hooks.`);if(e.subResourceIntegrity===!0)throw new Error(`[Hydrogen Preset] subResourceIntegrity cannot be enabled.
 Reason: Conflicts with Hydrogen CSP nonce-based authentication.
 Impact: Would break Content Security Policy and cause script execution failures.`)}}}export{r as hydrogenPreset};

package/dist/react-router.d.ts

@@ -30,6 +30,16 @@ declare global {
     //   updateLineByOptions: (productId: string, selectedOptions: SelectedOptionInput[], line: CartLineUpdateInput) => Promise<CartQueryDataReturn>;
     // }
   }
+
+  /**
+   * The cart type used for `context.cart` in route files.
+   *
+   * `HydrogenCart`'s default type parameter already includes
+   * `HydrogenCustomCartFragment & Cart`, so no explicit intersection is needed
+   * here. The augmentable `HydrogenCustomCartFragment` interface is declared
+   * in `cart/queries/cart-types.ts`.
+   */
+  type HydrogenCartWithFragment = HydrogenCart & HydrogenCustomCartMethods;
 }
 
 declare module 'react-router' {
@@ -37,7 +47,7 @@ declare module 'react-router' {
   interface RouterContextProvider extends HydrogenAdditionalContext {
     // Standard Hydrogen context properties from HydrogenRouterContextProvider
     storefront: HydrogenRouterContextProvider['storefront'];
-    cart: HydrogenCart & HydrogenCustomCartMethods;
+    cart: HydrogenCartWithFragment;
     customerAccount: HydrogenRouterContextProvider['customerAccount'];
     env: HydrogenRouterContextProvider['env'];
     session: HydrogenRouterContextProvider['session'];
@@ -48,7 +58,7 @@ declare module 'react-router' {
   interface AppLoadContext extends HydrogenAdditionalContext {
     // Standard Hydrogen context properties from HydrogenRouterContextProvider
     storefront: HydrogenRouterContextProvider['storefront'];
-    cart: HydrogenCart & HydrogenCustomCartMethods;
+    cart: HydrogenCartWithFragment;
     customerAccount: HydrogenRouterContextProvider['customerAccount'];
     env: HydrogenRouterContextProvider['env'];
     session: HydrogenRouterContextProvider['session'];

package/dist/vite/request-events.d.ts

@@ -1,6 +1,30 @@
 import { IncomingMessage, ServerResponse } from 'node:http';
 import { CountryCode, LanguageCode } from '@shopify/hydrogen-react/storefront-api-types';
 
+declare global {
+    /**
+     * Extensible interface for typing cart results with a custom cart fragment.
+     * Augment this interface with your codegen'd fragment type to get full type
+     * safety on every cart operation — whether accessed via `context.cart`,
+     * `createCartHandler`, or `createHydrogenContext`.
+     *
+     * When empty (the default), `HydrogenCustomCartFragment & Cart` collapses
+     * to `Cart`, so existing behaviour is unchanged.
+     *
+     * @example
+     * ```ts
+     * // In app/lib/context.ts
+     * import type {CartApiQueryFragment} from 'storefrontapi.generated';
+     *
+     * declare global {
+     *   interface HydrogenCustomCartFragment extends CartApiQueryFragment {}
+     * }
+     * ```
+     */
+    interface HydrogenCustomCartFragment {
+    }
+}
+
 type ConsentStatus = boolean | undefined;
 type VisitorConsent = {
     marketing: ConsentStatus;

package/package.json

@@ -5,7 +5,7 @@
     "@shopify:registry": "https://registry.npmjs.org"
   },
   "type": "module",
-  "version": "2026.4.2",
+  "version": "2026.4.3",
   "license": "MIT",
   "main": "dist/index.cjs",
   "module": "dist/production/index.js",
@@ -80,12 +80,12 @@
     "use-resize-observer": "^9.1.0",
     "worktop": "^0.7.3",
     "@shopify/graphql-client": "1.4.1",
-    "@shopify/hydrogen-react": "2026.4.2"
+    "@shopify/hydrogen-react": "2026.4.3"
   },
   "devDependencies": {
-    "react-router": "7.14.0",
-    "@react-router/dev": "7.14.0",
-    "@shopify/generate-docs": "1.1.4",
+    "react-router": "7.16.0",
+    "@react-router/dev": "7.16.0",
+    "@shopify/generate-docs": "1.2.2",
     "@testing-library/jest-dom": "^6.6.3",
     "@types/node": "22.19.15",
     "@types/react": "^18.3.28",
@@ -102,8 +102,8 @@
     "@shopify/hydrogen-codegen": "0.3.3"
   },
   "peerDependencies": {
-    "react-router": "7.14.0",
-    "@react-router/dev": "7.14.0",
+    "react-router": "~7.16.0",
+    "@react-router/dev": "~7.16.0",
     "react": "^18.3.1 || ~19.0.3 || ~19.1.4 || ^19.2.3",
     "vite": "^5.1.0 || ^6.2.1 || ^7.0.0 || ^8.0.0"
   },