@shopify/hydrogen 0.0.0-unstable-20220314172608

package/CHANGELOG.md

@@ -0,0 +1,869 @@
+# Changelog
+
+## 0.0.0-unstable-20220314172608
+
+### Major Changes
+
+- [`a10e166`](https://github.com/Shopify/hydrogen/commit/a10e1665a95d27525f0b07df187b1346a62850cb) Thanks [@jplhomer](https://github.com/jplhomer)! - Hydrogen v1.0 is now available as a release candidate.
+
+  Install it using the `rc1` tag for new apps:
+
+  ```bash
+  npx create-hydrogen-app@rc1
+  ```
+
+  Or update existing apps:
+
+  ```bash
+  yarn add @shopify/hydrogen@rc1
+  ```
+
+### Minor Changes
+
+- [#698](https://github.com/Shopify/hydrogen/pull/698) [`6f30b9a`](https://github.com/Shopify/hydrogen/commit/6f30b9a1327f06d648a01dd94d539c7dcb3061e0) Thanks [@jplhomer](https://github.com/jplhomer)! - Basic end-to-end tests have been added to the default Hydrogen template. You can run tests in development:
+
+  ```bash
+  yarn test
+  ```
+
+  Or in continuous-integration (CI) environments:
+
+  ```bash
+  yarn test:ci
+  ```
+
+* [#846](https://github.com/Shopify/hydrogen/pull/846) [`58c823b`](https://github.com/Shopify/hydrogen/commit/58c823b5eb5c5c33caa25cae629409ce651b3991) Thanks [@blittle](https://github.com/blittle)! - ## New `<Route>` Component
+
+  The `<Route>` component is available for routes not defined by the file system. The `<Route>` component must be used within the `<Router>` component.
+
+  ```jsx
+  // app.server.jsx
+
+  function App({routes, ...serverProps}) {
+    return (
+      <Suspense fallback={<LoadingFallback />}>
+        <ShopifyProvider shopifyConfig={shopifyConfig}>
+          <CartProvider>
+            <DefaultSeo />
+            <Router serverProps={serverProps}>
+              <Route path="/custom" page={<CustomRoute />} />
+            </Router>
+          </CartProvider>
+        </ShopifyProvider>
+      </Suspense>
+    );
+  }
+
+  function CustomRoute() {
+    return <h1>Custom route</h1>;
+  }
+  ```
+
+  `<Route>` accepts two props:
+
+  | Property | Type                                    | Required | Description                                                                                            |
+  | -------- | --------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------ |
+  | `path`   | `string`                                | Yes      | The URL path where the route exists. The path can contain variables. For example, `/products/:handle`. |
+  | `page`   | `A rendered Server Component reference` | Yes      | A reference to a React Server Component that's rendered when the route is active.                      |
+
+  ## Changes to `<Router>`
+
+  You can have multiple `<Route>` and `<FileRoutes>` components in your app. Hydrogen will only render one route for each request — whichever it finds first. This means the `<Router>` component no longer takes `fallback` as a prop. It also doesn't need `serverProps`. Instead, to render a 404 "Not Found" page, add `<Route path="*" page={<NotFound />} />` to your app. Make sure it's the last `<Route>` defined inside your app:
+
+  ```diff
+  function App({routes, ...serverProps}) {
+    return (
+      <ShopifyProvider shopifyConfig={shopifyConfig}>
+        <CartProvider>
+          <DefaultSeo />
+  -       <Router
+  -         fallback={<NotFound response={serverProps.response} />}
+  -         serverProps={serverProps}
+  -       >
+  +       <Router>
+            <FileRoutes routes={routes} />
+  +         <Route path="*" page={<NotFound />} />
+          </Router>
+        </CartProvider>
+      </ShopifyProvider>
+    );
+  }
+  ```
+
+  ## Changes to `<FileRoutes>`
+
+  The `<FileRoutes>` component now accepts two additional optional props:
+
+  | Property    | Type     | Required | Default Value | Description                                                             |
+  | ----------- | -------- | -------- | ------------- | ----------------------------------------------------------------------- |
+  | `basePath`  | `string` | No       | `"/"`         | A path that's prepended to all file routes.                             |
+  | `dirPrefix` | `string` | No       | `"./routes"`  | The portion of the file route path that shouldn't be a part of the URL. |
+
+  You need to modify `dirPrefix` if you want to import routes from a location other than `src/routes`.
+
+  You can modify `basePath` if you want to prefix all file routes. For example, you can prefix all file routes with a locale:
+
+  ```jsx
+  <Router>
+    <FileRoutes basePath={`/${locale}`} routes={routes} />
+    <Route path="*" page={<NotFound />} />
+  </Router>
+  ```
+
+  ## New `useRouteParams()` hook
+
+  You can use the `useRouteParams()` hook to retrieve the parameters of an active route. The hook is available in both server and client components:
+
+  ```jsx
+  // products/[handle].server.jsx
+
+  import {useRouteParams} from '@shopify/hydrogen';
+
+  export default function Product() {
+    const {handle} = useRouteParams();
+    // ...
+  }
+  ```
+
+  ```jsx
+  // ProductDetails.client.jsx
+  import {useRouteParams} from '@shopify/hydrogen/client';
+
+  export default function ProductDetails() {
+    const {handle} = useRouteParams();
+    // ...
+  }
+  ```
+
+- [#842](https://github.com/Shopify/hydrogen/pull/842) [`626e58e`](https://github.com/Shopify/hydrogen/commit/626e58eebe3cf994423895bbdf7754c009d701fe) Thanks [@wizardlyhel](https://github.com/wizardlyhel)! - Removed the `Rawhtml` component.
+
+  Upgrade your project by replacing references to the `RawHtml` component to follow
+  [React's `dangerouslySetInnerHTML`](https://reactjs.org/docs/dom-elements.html#dangerouslysetinnerhtml):
+
+  Change all `RawHtml` component
+
+  ```jsx
+  <RawHtml string="<p>Hello world</p>" />
+  ```
+
+  to jsx equivalent
+
+  ```jsx
+  <div dangerouslySetInnerHTML={{__html: '<p>Hello world</p>'}} />
+  ```
+
+### Patch Changes
+
+- [#870](https://github.com/Shopify/hydrogen/pull/870) [`4c0fcd8`](https://github.com/Shopify/hydrogen/commit/4c0fcd8f55a7956ab4641f12a5d9ebcb2587264c) Thanks [@frandiox](https://github.com/frandiox)! - Remove useQuery hook from client exports to avoid leaking server logic to the browser.
+
+* [#895](https://github.com/Shopify/hydrogen/pull/895) [`1017b54`](https://github.com/Shopify/hydrogen/commit/1017b541c275c030f97ee6dee1e310df1fe89fb5) Thanks [@frandiox](https://github.com/frandiox)! - Improve error thrown in development when entry point fails on load.
+
+- [#871](https://github.com/Shopify/hydrogen/pull/871) [`4cb07c7`](https://github.com/Shopify/hydrogen/commit/4cb07c7357cf05cc63f9d3c2834ac3c43e8859b5) Thanks [@scottdixon](https://github.com/scottdixon)! - Hydrogen docs: Update ProductProvider example query
+
+## 0.12.0
+
+### Minor Changes
+
+- [`8271be8`](https://github.com/Shopify/hydrogen/commit/8271be83331c99f27a258e6532983da4fe4f0b5b) Thanks [@michenly](https://github.com/michenly)! - Export Seo components Fragement and use them in the starter template.
+
+* [#827](https://github.com/Shopify/hydrogen/pull/827) [`745e8c0`](https://github.com/Shopify/hydrogen/commit/745e8c0a87a7c41803934565e5a756295ff629c2) Thanks [@michenly](https://github.com/michenly)! - Move any static `Fragment` properties on components to the entry point `@shopify/hydrogen/fragments`.
+  The migration diff are as follows:
+
+  ```diff
+  - import {ExternalVideoFragment} from '@shopify/hydrogen';
+  + import {ExternalVideoFragment} from '@shopify/hydrogen/fragments';
+  - import type {ExternalVideoFragmentFragment} from '@shopify/hydrogen';
+  + import type {ExternalVideoFragmentFragment} from '@shopify/hydrogen/fragments';
+  ```
+
+  ```diff
+  - import {ImageFragment} from '@shopify/hydrogen';
+  + import {ImageFragment} from '@shopify/hydrogen/fragments';
+  - import type {ImageFragmentFragment} from '@shopify/hydrogen';
+  + import type {ImageFragmentFragment} from '@shopify/hydrogen/fragments';
+  ```
+
+  ```diff
+  - import {MediaFileFragment} from '@shopify/hydrogen';
+  + import {MediaFileFragment} from '@shopify/hydrogen/fragments';
+  - import type {MediaFileFragmentFragment} from '@shopify/hydrogen';
+  + import type {MediaFileFragmentFragment} from '@shopify/hydrogen/fragments';
+  ```
+
+  ```diff
+  - import {MetafieldFragment} from '@shopify/hydrogen';
+  + import {MetafieldFragment} from '@shopify/hydrogen/fragments';
+  - import type {MetafieldFragmentFragment} from '@shopify/hydrogen';
+  + import type {MetafieldFragmentFragment} from '@shopify/hydrogen/fragments';
+  ```
+
+  ```diff
+  - import {Model3DFragment} from '@shopify/hydrogen';
+  + import {Model3DFragment} from '@shopify/hydrogen/fragments';
+  - import type {Model3DFragmentFragment} from '@shopify/hydrogen';
+  + import type {Model3DFragmentFragment} from '@shopify/hydrogen/fragments';
+  ```
+
+  ```diff
+  - import {MoneyFragment} from '@shopify/hydrogen';
+  + import {MoneyFragment} from '@shopify/hydrogen/fragments';
+  - import type {MoneyFragmentFragment} from '@shopify/hydrogen';
+  + import type {MoneyFragmentFragment} from '@shopify/hydrogen/fragments';
+  ```
+
+  ```diff
+  - import {ProductProviderFragment} from '@shopify/hydrogen';
+  + import {ProductProviderFragment} from '@shopify/hydrogen/fragments';
+  - import type {ProductProviderFragmentFragment} from '@shopify/hydrogen';
+  + import type {ProductProviderFragmentFragment} from '@shopify/hydrogen/fragments';
+  ```
+
+  ```diff
+  - import {UnitPriceFragment} from '@shopify/hydrogen';
+  + import {UnitPriceFragment} from '@shopify/hydrogen/fragments';
+  - import type {UnitPriceFragmentFragment} from '@shopify/hydrogen';
+  + import type {UnitPriceFragmentFragment} from '@shopify/hydrogen/fragments';
+  ```
+
+  ```diff
+  - import {VideoFragment} from '@shopify/hydrogen';
+  + import {VideoFragment} from '@shopify/hydrogen/fragments';
+  - import type {VideoFragmentFragment} from '@shopify/hydrogen';
+  + import type {VideoFragmentFragment} from '@shopify/hydrogen/fragments';
+  ```
+
+- [#455](https://github.com/Shopify/hydrogen/pull/455) [`81ac653`](https://github.com/Shopify/hydrogen/commit/81ac6534b8464e187b09ee13525319ed0c6c7c1d) Thanks [@johncraigcole](https://github.com/johncraigcole)! - Updated the ExternalVideo component to use the new `embedUrl` Storefront API ([introduced in 2022-04](https://shopify.dev/api/release-notes/2022-04#non-encoded-object-ids-in-the-graphql-storefront-api)) on ExternalVideo.
+
+* [#809](https://github.com/Shopify/hydrogen/pull/809) [`47f23f9`](https://github.com/Shopify/hydrogen/commit/47f23f921873b782947aed2e54d997ad034801b8) Thanks [@frehner](https://github.com/frehner)! - Upgrade default Storefront API to version '2022-04'. Some components have been updated to use the 2022-04 features and types as well.
+
+  One important change is that the `2022-04` Storefront API no longer encodes object IDs: see more [details here](https://shopify.dev/api/release-notes/2022-04#non-encoded-object-ids-in-the-graphql-storefront-api). Because of this, Hydrogen will no longer decode IDs, either, which will cause issues if you are using a previous version of the Storefront API with Hydrogen components.
+
+- [#780](https://github.com/Shopify/hydrogen/pull/780) [`122a5c5`](https://github.com/Shopify/hydrogen/commit/122a5c5e0b70fa2a11c2c708b303da987f25fc53) Thanks [@jplhomer](https://github.com/jplhomer)! - Adds `queryShop` helper to API routes. This makes it easy to query the Storefront API, similar to how `useShopQuery` is available in server components:
+
+  ```jsx
+  // my-api.server.js
+
+  export default function api(request, {queryShop}) {
+    return await queryShop({
+      query: `query ShopName { shop { name } }`,
+    });
+  }
+  ```
+
+  `queryShop` accepts a single argument object with the following properties:
+
+  | Property    | Type                                   | Required |
+  | ----------- | -------------------------------------- | -------- |
+  | `query`     | `string \| ASTNode`                    | Yes      |
+  | `variables` | `Record<string, any>`                  | No       |
+  | `locale`    | `string` (defaults to `defaultLocale`) | No       |
+
+  **Important**: In order to use `queryShop`, you should pass `shopifyConfig` to `renderHydrogen` inside `App.server.jsx`:
+
+  ```diff
+  -export default renderHydrogen(App, {routes});
+  +export default renderHydrogen(App, {shopifyConfig, routes});
+  ```
+
+* [#712](https://github.com/Shopify/hydrogen/pull/712) [`6368968`](https://github.com/Shopify/hydrogen/commit/6368968e4c68bb44b01b6b0b6903e403269dc233) Thanks [@blittle](https://github.com/blittle)! - Routing in Hydrogen has been updated according to [Custom Routes proposal](https://github.com/Shopify/hydrogen/discussions/569). Specifically, a new `Router` component has been added, and `DefaultRoutes` has been renamed to `FileRoutes`, along with other minor changes. Custom route components are not implemented yet.
+
+  Follow these steps to upgrade your `App.server.jsx` file:
+
+  1. Rename the parameter `pages` to `routes` when calling `renderHydrogen`.
+  2. Rename the `DefaultRoutes` component to `FileRoutes`.
+  3. Add the new `Router` component as a parent of `FileRoutes` and pass `fallback` and `serverProps` props (previously in `DefaultRoutes`).
+  4. Rename `src/pages` directory to `src/routes` and update the glob import in `App.server.jsx` to `import.meta.globEager('./routes/**/*.server.[jt](s|sx)')`.
+
+  #### Full example of `App.server.jsx`
+
+  ```jsx
+  import renderHydrogen from '@shopify/hydrogen/entry-server';
+  import {Router, FileRoutes, ShopifyProvider} from '@shopify/hydrogen';
+  import {Suspense} from 'react';
+  import shopifyConfig from '../shopify.config';
+  import DefaultSeo from './components/DefaultSeo.server';
+  import NotFound from './components/NotFound.server';
+  import LoadingFallback from './components/LoadingFallback';
+  import CartProvider from './components/CartProvider.client';
+
+  function App({routes, ...serverProps}) {
+    return (
+      <Suspense fallback={<LoadingFallback />}>
+        <ShopifyProvider shopifyConfig={shopifyConfig}>
+          <CartProvider>
+            <DefaultSeo />
+            <Router fallback={<NotFound />} serverProps={serverProps}>
+              <FileRoutes routes={routes} />
+            </Router>
+          </CartProvider>
+        </ShopifyProvider>
+      </Suspense>
+    );
+  }
+
+  const routes = import.meta.globEager('./routes/**/*.server.[jt](s|sx)');
+  export default renderHydrogen(App, {shopifyConfig, routes});
+  ```
+
+### Patch Changes
+
+- [#799](https://github.com/Shopify/hydrogen/pull/799) [`350293a`](https://github.com/Shopify/hydrogen/commit/350293a9fa113fa9950aad27cf7ccaa6b535bedb) Thanks [@michenly](https://github.com/michenly)! - Update `linesAdd` to create cart if cart does not exist.
+
+* [#788](https://github.com/Shopify/hydrogen/pull/788) [`9d4c43d`](https://github.com/Shopify/hydrogen/commit/9d4c43d6cc4f0b52affc33274c438a356c95ad37) Thanks [@mcvinci](https://github.com/mcvinci)! - Hydrogen docs: Static assets and component props
+
+- [#813](https://github.com/Shopify/hydrogen/pull/813) [`b1b959c`](https://github.com/Shopify/hydrogen/commit/b1b959c45ae43d7078c655b4012b6d6cd2db6491) Thanks [@frandiox](https://github.com/frandiox)! - Do not scroll to top if the URL pathname has not changed.
+
+* [#821](https://github.com/Shopify/hydrogen/pull/821) [`548979e`](https://github.com/Shopify/hydrogen/commit/548979ea7cbc38e52628d3359fd6c4edd19b41cc) Thanks [@jplhomer](https://github.com/jplhomer)! - Add null check for ShopifyProvider
+
+- [#850](https://github.com/Shopify/hydrogen/pull/850) [`74b14e4`](https://github.com/Shopify/hydrogen/commit/74b14e4a66c72125bc1b372c57f305a86a2e1fe4) Thanks [@blittle](https://github.com/blittle)! - Ignore when boomerang doesn't load. This often happens when a adblocker is present on the client.
+  There is no longer an uncaught promise exception in the console.
+
+* [#803](https://github.com/Shopify/hydrogen/pull/803) [`7528bf4`](https://github.com/Shopify/hydrogen/commit/7528bf4956970d76f37452bd33f9c9a692187c4f) Thanks [@frandiox](https://github.com/frandiox)! - Avoid accessing undefined global \_\_flight as a side effect of another unknown error.
+
+- [#833](https://github.com/Shopify/hydrogen/pull/833) [`214927a`](https://github.com/Shopify/hydrogen/commit/214927a071b9350d1f70fa02c74227f1e5d77238) Thanks [@frandiox](https://github.com/frandiox)! - Disable worker streaming until it is properly supported.
+
+* [#837](https://github.com/Shopify/hydrogen/pull/837) [`2e76d66`](https://github.com/Shopify/hydrogen/commit/2e76d66ac23d84c13cf9c60e0b7aacf9eddda9ce) Thanks [@jplhomer](https://github.com/jplhomer)! - Minify server build output
+
+- [#819](https://github.com/Shopify/hydrogen/pull/819) [`09d9ad5`](https://github.com/Shopify/hydrogen/commit/09d9ad5d7b65942d9187c6b766bf4c60a6979453) Thanks [@jplhomer](https://github.com/jplhomer)! - Improve logging for useShopQuery errors
+
+* [#825](https://github.com/Shopify/hydrogen/pull/825) [`1215fdb`](https://github.com/Shopify/hydrogen/commit/1215fdb02910190096c6920f533d06f00fc59a6c) Thanks [@michenly](https://github.com/michenly)! - `@shopify/hydrogen` will no longer export the following types
+
+  - MediaFileProps
+  - VideoProps
+  - ImageProps
+  - ExternalVideoProps
+  - RawHtmlProps
+  - AddToCartButtonProps
+  - ModelViewerProps
+  - MoneyProps
+  - BuyNowButtonProps
+  - BuyNowButtonPropsWeControl
+  - ShopPayButtonProps
+
+  Any Component props type should be typed instead with `React.ComponentProps<typeof MyComponent>`.
+
+- [#792](https://github.com/Shopify/hydrogen/pull/792) [`8aad0b5`](https://github.com/Shopify/hydrogen/commit/8aad0b561ddbef55abc598c91c6e9bd642c46d9c) Thanks [@frandiox](https://github.com/frandiox)! - Attributes from `<html>` and `<body>` elements in `index.html` are now included in the SSR response.
+
+* [#811](https://github.com/Shopify/hydrogen/pull/811) [`2226b6e`](https://github.com/Shopify/hydrogen/commit/2226b6eda30a29ad79fb89c600a210b615dc5406) Thanks [@frandiox](https://github.com/frandiox)! - Support non-PascalCase filenames for client components.
+
+- [#786](https://github.com/Shopify/hydrogen/pull/786) [`d1ecaf7`](https://github.com/Shopify/hydrogen/commit/d1ecaf7efff4595da46b0ece08c3cd94c6cdd55f) Thanks [@frehner](https://github.com/frehner)! - Updated graphql-codegen, which updates the Typescript types available for each Storefront API object
+
+* [#849](https://github.com/Shopify/hydrogen/pull/849) [`e64fa17`](https://github.com/Shopify/hydrogen/commit/e64fa17c61585a7dc967bef5a2216dde40b2fc42) Thanks [@blittle](https://github.com/blittle)! - Fix server the server to only log once for the full time it takes to stream render a page
+
+- [#394](https://github.com/Shopify/hydrogen/pull/394) [`818312d`](https://github.com/Shopify/hydrogen/commit/818312d72618882056d0344f069568e71766d32d) Thanks [@sahilmob](https://github.com/sahilmob)! - Respond with 404 if the route has no matches.
+
+* [#841](https://github.com/Shopify/hydrogen/pull/841) [`0aa74cf`](https://github.com/Shopify/hydrogen/commit/0aa74cf78dae555fc111c06df3d2b73b022af4f0) Thanks [@michenly](https://github.com/michenly)! - Update MediaFile's options prop type to included Image options.
+
+- [#796](https://github.com/Shopify/hydrogen/pull/796) [`1dc62e2`](https://github.com/Shopify/hydrogen/commit/1dc62e2514b53411ae750d81c0a1b4f50eae9aff) Thanks [@mcvinci](https://github.com/mcvinci)! - Hydrogen docs: Strict mode
+
+* [#813](https://github.com/Shopify/hydrogen/pull/813) [`b1b959c`](https://github.com/Shopify/hydrogen/commit/b1b959c45ae43d7078c655b4012b6d6cd2db6491) Thanks [@frandiox](https://github.com/frandiox)! - Remove Router client-only logic from server bundle and avoid extra waterfall requests during Hydration.
+  Extract part of the client bundle into separate modules that can be loaded in parallel.
+
+## 0.11.1
+
+### Patch Changes
+
+- [#770](https://github.com/Shopify/hydrogen/pull/770) [`71e0255`](https://github.com/Shopify/hydrogen/commit/71e0255ea48dc1caa34d2c05a1556cc0ce6d4ce9) Thanks [@mcvinci](https://github.com/mcvinci)! - Hydrogen docs: Framework and global hooks content updates
+
+* [#761](https://github.com/Shopify/hydrogen/pull/761) [`1142647`](https://github.com/Shopify/hydrogen/commit/114264716bc8f3027e3e6395d523714adbc92014) Thanks [@frehner](https://github.com/frehner)! - Fix issue with components that take in the `as` prop not validating other props when a component is passed to `as`.
+
+- [#752](https://github.com/Shopify/hydrogen/pull/752) [`428aa7a`](https://github.com/Shopify/hydrogen/commit/428aa7adac179dd1efffc29bf382a7bb0a2c8971) Thanks [@michenly](https://github.com/michenly)! - Ensure ProductSeo knows how to handle `featuredImage = null`
+
+* [#774](https://github.com/Shopify/hydrogen/pull/774) [`052f148`](https://github.com/Shopify/hydrogen/commit/052f148e0d33029cdc2540afa5ead32825962f3a) Thanks [@frandiox](https://github.com/frandiox)! - Fix internal url usage in platforms like Vercel, which already provides protocol and host in `request.url`.
+
+- [#744](https://github.com/Shopify/hydrogen/pull/744) [`2e487b7`](https://github.com/Shopify/hydrogen/commit/2e487b7e70fe0572538dc2a24b6b6b36ba9fc804) Thanks [@jplhomer](https://github.com/jplhomer)! - Switch to using Changesets for changelogs.
+
+* [#775](https://github.com/Shopify/hydrogen/pull/775) [`d5b7ee1`](https://github.com/Shopify/hydrogen/commit/d5b7ee1d8312f64922d1f78afc82ec5ad4a3f457) Thanks [@cartogram](https://github.com/cartogram)! - In cases where the `initialVariantId` is missing on the `<ProductProvider />`, the `selectedVariantId` in the returned `object` from `useProduct()` will now use the first available variant _or_ the first variant (if non are available).
+
+- [#773](https://github.com/Shopify/hydrogen/pull/773) [`b6a053e`](https://github.com/Shopify/hydrogen/commit/b6a053e774da443b5692dec51546f5558b3018ad) Thanks [@frandiox](https://github.com/frandiox)! - Fix server bundle name in cases where CSS or images are imported in server components.
+
+* [#764](https://github.com/Shopify/hydrogen/pull/764) [`5e55da4`](https://github.com/Shopify/hydrogen/commit/5e55da4090692369ff6a3d57fbc6d29124bdf2e9) Thanks [@wizardlyhel](https://github.com/wizardlyhel)! - Preload queries breaking fetch on Cloudfare [#764](https://github.com/Shopify/hydrogen/pull/764)
+
+- [#763](https://github.com/Shopify/hydrogen/pull/763) [`ea2857a`](https://github.com/Shopify/hydrogen/commit/ea2857a515866f37f392bca5da8be1139c055a64) Thanks [@frehner](https://github.com/frehner)! - Client-side apps now have React's `StrictMode` component wrapping the whole app, with an option to disable it. If you do turn it off, it is recommended that you still include the `StrictMode` component at as high of a level as possible in your React tree.
+
+  See also [React 17's docs](https://reactjs.org/docs/strict-mode.html) on `StrictMode`, and [React 18's updates](https://github.com/reactwg/react-18/discussions/19) to `StrictMode`.
+
+* [#747](https://github.com/Shopify/hydrogen/pull/747) [`2d8ab7e`](https://github.com/Shopify/hydrogen/commit/2d8ab7e2a8038ff8b43e6e9398e0bb2da72220a0) Thanks [@mcvinci](https://github.com/mcvinci)! - Hydrogen docs: Preloaded queries and query timing
+
+## [0.11.0] - 2022-02-24
+
+### Added
+
+- New React hook `useScriptLoader` is available to more easily load external scripts
+- Add `totalQuantity` to the returned object from `useCart()`
+- Export `ProductPrice` and `ProductMetafield` standalone components
+- Added `useUrl` hook that allows the consumer to get the current url in server or client component
+- Added logging option `showCacheApiStatus` and `cacheControlHeader` by @wizardlyhel in [#472](https://github.com/Shopify/hydrogen/pull/472)
+- Pass HYDROGEN_ASSET_BASE_URL into config to set base URL for compiled assets
+- Introduce Hydrogen the `<Link>` component and `useNavigate` hook for routing
+- Add a default virtual entry-client in `/@shopify/hydrogen/entry-client` that can be used in `index.html`
+- Enable early hydration when streaming
+- Add variantId prop to `<ProductMetafield />` component [#730](https://github.com/Shopify/hydrogen/pull/730)
+- Add query timing logging option `showQueryTiming` [#699](https://github.com/Shopify/hydrogen/pull/699)
+- Add variantId prop to `<ProductPrice />` component
+- Add `preload` option to `useQuery` and `useShopQuery` [#700](https://github.com/Shopify/hydrogen/pull/700)
+
+### Breaking Change
+
+- `<Model3D>` has been renamed to `<ModelViewer>`
+- `<Product />` and `<CartLine />` aliases have been removed; use the original components `<ProductProvider />` and `<CartLineProvider />` instead. Their nested component aliases, such as `<Product.Image />`, have also been removed; in this example you should use `<ProductImage />`.
+- Merge `/src/entry-server.jsx` entry point into `App.server.jsx`
+- The following components had their prop name renamed. Refer to the documentation or [#627](https://github.com/Shopify/hydrogen/issues/627) for more details.
+  - `<ExternalVideo />`: renamed video prop to data
+  - `<Video />`: renamed video prop to data
+  - `<Image>`: renamed image prop to data
+  - `<MediaFile>`: renamed media prop to data
+  - `<ModelViewer>`: renamed model prop to data
+  - `<Metafield>`: renamed metafield prop to data
+  - `<Money>`: renamed money prop to data
+  - `<UnitPrice>`: renamed unitPrice prop to data, unitPriceMeasurement prop to measurement
+  - `<ProductProvider>`: renamed product prop to data
+  - `<CartProvider>`: renamed cart prop to data
+- Helmet component has been renamed to Head
+- Remove the `<SelectedVariantBuyNowButton />` component in favour of using `<BuyNowButton variantId={product.selectedVariant.id} />`
+- `<SelectedVariantAddToCartButton />` has been removed; the `<AddToCartButton />` will now use the selectedVariant by default.
+- Remove the `<SelectedVariantImage />` component in favour of using `<Image data={product.selectedVariant.image} />`
+- Remove the `<SelectedVariantMetafield />` component in favour of using `<ProductMetafield variantId={product.selectedVariant.id} />`
+- Remove the `<SelectedVariantShopPayButton />` component in favour of using `<ShopPayButton variantId={product.selectedVariant.id} />`
+- Remove the `<SelectedVariantPrice/>` and `<SelectedVariantUnitPrice/>` component in favour of using `<ProductPrice variantId={product.selectedVariant.id} />`
+
+### Changed
+
+- Change `/react` RSC path to `/__rsc`
+- `<ShopifyProvider>` can again be used in server components
+- Use hashes as client component ids instead of absolute paths
+- Transition away from deprecated currency selector in favor of country selector
+- Simplify Helmet usage and make it compatible with RSC
+- The `Seo.client` component has been moved from `src/components` to `@shopify/hydrogen`. The props of the `Seo.client` component also changed to always take in `type` and `data`. Refer to the [`Seo` component reference](../src/components/Seo/README.md) for more details. [#539](https://github.com/Shopify/hydrogen/pull/539)
+- Standardize cache control header into caching strategies by @wizardlyhel in [#629](https://github.com/Shopify/hydrogen/pull/629)
+- Target future release to use '2022-01' API Version
+- Correct Typescript issue where `as` was a default prop for all components when it should not be
+- Update types and docs for `useCart()` hook and `<CartProvider>`
+- Track page load performance
+- The following money components no longer allow the function-as-a-child (also known as "render props") pattern; see [#589](https://github.com/Shopify/hydrogen/pull/589)
+  - `<Money>` Use `useMoney()` for customization
+  - `<CartLinePrice>` Use `useMoney()` for customization
+  - `<ProductPrice>` Use `useMoney()` for customization
+  - `<SelectedVariantPrice>` Use `useMoney()` for customization
+  - `<Metafield>` Use `useParsedMetafields()` for customization
+  - `<ProductMetafield>` Use `useParsedMetafields()` for customization
+  - `<SelectedVariantMetafield>` Use `useParsedMetafields()` for customization
+  - `<UnitPrice>` Use `useMoney()` for customization
+  - `<CartLines>` Use `useCart()` for customization
+- `<Metafield>` now renders `ratings` as a `<span>` with text instead of stars; `multi_line_text_field` inside of a `<span>` instead of a `<div>`
+- Use `featureImage` instead of images(first:1) on product query
+- Update `react-helmet-async` to 1.2.3 and remove our custom types
+
+### Fixed
+
+- Fix index routes. See [#562](https://github.com/Shopify/hydrogen/issues/562)
+- Fix missing server state on SSR pass
+- Fix mobile navigation in example that scrolls the body underneath when shown by @Francismori7 in [#582](https://github.com/Shopify/hydrogen/pull/582)
+- Add charset to content type in HTML responses
+- Fix header shift when cart is opened by @Francismori7 in [#600](https://github.com/Shopify/hydrogen/pull/600)
+- Fix bug where search param is not being pass along during RSC streaming call [#623](https://github.com/Shopify/hydrogen/pull/623)
+- Allow custom entry-client filenames
+- Clear browser fetch cache by @wizardlyhel in [#591](https://github.com/Shopify/hydrogen/pull/591)
+- Cannot redefine property error when updating client components
+- `ShopPayButton` supports quantities greater than 1. Also fixed issues with IDs in Storefront API version 2022-01
+- Render error in `Gallery.client.jsx` component when product resource has an external video or no images.
+- Ensure youtube external videos are embed compatible urls
+- Prevent client components from being cached during development
+- Backticks in HTML break RSC hydration.
+
+### Removed
+
+- <CartLineSelectedOptions /> and <CartLineAttributes /> components. These components used the “function-as-a-child” pattern which doesn’t allow the `children` prop to be serialized, preventing them from being rendered within Server components.
+
+_Migration_
+
+The functionality provided by these components can be replicated using the `useCartLine()` hook instead.
+
+_Example_
+
+```tsx
+// Before
+function SomeComponent() {
+  return (
+    <>
+      <CartLineSelectedOptions as="ul" className="text-xs space-y-1">
+        {({name, value}) => (
+          <>
+            {name}: {value}
+          </>
+        )}
+      </CartLineSelectedOptions>
+      <CartLineAttributes as="ul" className="text-sm space-y-1">
+        {({key, value}) => (
+          <>
+            {key}: {value}
+          </>
+        )}
+      </CartLineAttributes>
+    </>
+  );
+}
+
+// After
+function SomeComponent() {
+  const {merchandise} = useCartLine();
+
+  return (
+    <>
+      <ul className="text-xs space-y-1">
+        {merchandise.selectedOptions.map(({name, value}) => (
+          <li key={name}>
+            {name}: {value}
+          </li>
+        ))}
+      </ul>
+    </>
+  );
+}
+```
+
+- Remove `fetch` workaround
+- Remove the following hooks. (All the same functionality can be retrieved through the `useCart()` hook)
+  - `useCartAttributesUpdateCallback`
+  - `useCartBuyerIdentityUpdateCallback`
+  - `useCartCheckoutUrl`
+  - `useCartCreateCallback`
+  - `useCartDiscountCodesUpdateCallback`
+  - `useCartLinesAddCallback`
+  - `useCartLinesRemoveCallback`
+  - `useCartLinesTotalQuantity`
+  - `useCartLinesUpdateCallback`
+  - `useCartNoteUpdateCallback`
+- Remove React Router on the client
+- Remove `handleEvent` in favor of `handleRequest`
+- Remove `assetHandler` parameter in the new `handleRequest`
+- `<SelectedVariantAddToCartButton />` has been removed; the `<AddToCartButton />` will now use the selectedVariant by default.
+- Remove the `<SelectedVariantImage />` component in favour of using `<Image data={product.selectedVariant.image} />`
+- Remove the `<SelectedVariantMetafield />` component in favour of using `<ProductMetafield variantId={product.selectedVariant.id} />`
+- Remove the `<SelectedVariantBuyNowButton />` component in favour of using `<BuyNowButton variantId={product.selectedVariant.id} />`
+- Remove the `<SelectedVariantShopPayButton />` component in favour of using `<ShopPayButton variantId={product.selectedVariant.id} />`
+
+## [0.10.1] - 2022-01-26
+
+### Fixed
+
+- Hot reload for newly added page files
+
+## [0.10.0] - 2022-01-25
+
+### Changed
+
+- Warn instead of error when a page server component is missing valid exports
+- Adopt upstream version of React Server Components. See [#498](https://github.com/Shopify/hydrogen/pull/498) for breaking changes
+- Bump to latest version of React experimental to include [upstream context bugfix](https://github.com/facebook/react/issues/23089)
+- Improve API routes by allowing [strings and JS objects](https://github.com/Shopify/hydrogen/issues/476) to be returned.
+
+### Breaking Change
+
+- The 'locale' option in shopify.config.js had been renamed to 'defaultLocale'
+- Rename `graphqlApiVersion` to `storefrontApiVersion` in `shopify.config.js`
+
+### Fixed
+
+- Make sure that API routes [hot reload properly](https://github.com/Shopify/hydrogen/issues/497)
+
+## [0.9.1] - 2022-01-20
+
+### Changed
+
+- Transitive dependency bump.
+
+## [0.9.0] - 2022-01-20
+
+### Added
+
+- API routes 🎉
+
+### Changed
+
+- Move to undici instead of node-fetch
+
+## [0.8.3] - 2022-01-13
+
+### Added
+
+- Add optional `locale` param to `useShopQuery` to be used as `Accept-Language` in the store Storefront API query
+- Optional purge query cache per build
+
+### Fixed
+
+- Replace log abbreviations with full text.
+
+## [0.8.2] - 2022-01-07
+
+### Changed
+
+- Warn when requests take longer than 3000ms instead of erroring
+- `useQuery` returns an error if the query's fetch was unsuccessful
+- `useShopQuery` will give error hints to look at `shopify.config.js` when the Storefront API responds with a 403
+
+### Fixed
+
+- Load logger only once.
+- Do not attempt to decode product IDs, as they are no longer base64-encoded in `unstable`
+
+## [0.8.1] - 2022-01-04
+
+### Added
+
+- Detect bot user agents and give bots a non-streamed response.
+- Add global `Oxygen.env` for server-only environment variables.
+- Logging abstraction with default timing information
+
+### Changed
+
+- Upgrade to latest React 18 experimental version
+
+### Fixed
+
+- Cart decrease button removes at zero quantity
+
+## [0.8.0] - 2021-12-07
+
+### Fixed
+
+- Export `CartLineSelectedOptions` properly
+- Fix suspense utility function
+
+## [0.7.1] - 2021-12-02
+
+### Changed
+
+- Allow `useShopQuery` to be skippable if no query is passed
+- Remove usage of `react-query` (Not a breaking change)
+
+### Fixed
+
+- Avoid repeating the same identifier for default and named exports
+- Remove sourcemap warnings
+
+## [0.7.0] - 2021-11-22
+
+### Added
+
+- Add file reference metafield support
+- Allow custom Model3D poster
+- Support synchronous server redirects
+
+### Fixed
+
+- Binding of waitUntil in playground/server-components-worker
+- Default to `retry: false` in `useQuery`
+- Warn and ignore reserved properties in server state
+- Run graphiql middleware before vite, fixing graphiql
+
+## [0.6.4] - 2021-11-11
+
+### Fixed
+
+- Let Vite handle public assets in development
+- New lines in hydration request break JSON.parse
+- Normalize POSIX separators to support windows [#201](https://github.com/Shopify/hydrogen/pull/201)
+- Scroll to top on app first load
+- Update variantID to variantId [#78](https://github.com/Shopify/hydrogen/pull/78)
+
+## [0.6.3] - 2021-11-10
+
+### Fixed
+
+- Add trailing slash to user components glob
+
+## [0.6.2] - 2021-11-10
+
+### Fixed
+
+- Remove CartProvider from BuyNowButton
+- Reading property of null for component props
+- Transform deeply-imported client components
+- Duplicated files and contexts in browser
+
+## [0.6.1] - 2021-11-08
+
+### Changed
+
+- Transitive dependency bump.
+
+### Fixed
+
+- Do not set headers after they are sent to client
+
+## [0.6.0] - 2021-11-05
+
+### Changed
+
+- Disable the quantity adjust button when the cart is not idle
+- Use country server state in cart for the inContext directive
+- Use Image url field instead of deprecated originalSrc field
+- Switch to unstable API
+
+### Fixed
+
+- Update interaction prompt and interaction promp style attributes for Model3d
+- Make sure all errors show an error dialog when hydrogen is in dev mode
+- MediaFile component warning on non-Model3D types
+- Remove console logs for caching
+- Lowercased SVG tags in RSC
+- Make the URL search property available via hooks
+
+## 0.5.8 - 2021-11-04
+
+### Fixed
+
+- Ensure delayed callback is fired for cache purposes in Workers runtimes.
+
+## 0.5.3 - 2021-11-02
+
+### Changed
+
+- No updates. Transitive dependency bump.
+
+## 0.5.2 - 2021-11-02
+
+### Changed
+
+- No updates. Transitive dependency bump.
+
+## 0.5.1 - 2021-11-02
+
+### Changed
+
+- No updates. Transitive dependency bump.
+
+## 0.5.0 - 2021-11-01
+
+### Fixed
+
+- Update the ServerStateProvider context
+- Add tabIndex to ShopPayButton
+- Update LocalizationProvider query, context, and exports
+
+## 0.4.3 - 2021-10-29
+
+### Added
+
+- Introduct full-page and sub-request caching API.
+
+## 0.4.2 - 2021-10-29
+
+### Changed
+
+- Update Model3D props and add binding to model-viewer events
+
+### Fixed
+
+- Add `passthoughProps.disabled` to `AddToCartButton`
+- Do not show undefined currency symbol in production
+
+## 0.4.0 - 2021-10-27
+
+### Added
+
+- Add external image support to Image component
+
+### Changed
+
+- Make `CartProvider` a client-only concern. [#631](https://github.com/Shopify/hydrogen/pull/631)
+- Use `Accept: application/hydrogen` as a header when making `fetch` calls against a Hydrogen page. Useful for Custom Responses.
+
+### Fixed
+
+- Lock model-viewer.js version to 1.8
+- Use the Intl.NumberFormat parts for determining the amount value returned by the useMoney hook
+- Optimize React related dependencies at server start to avoid page reloads
+- Do not throw when `storeDomain` contains protocol.
+
+## 0.3.0 - 2021-10-20
+
+### Added
+
+- Export utilities in client bundle
+
+### Fixed
+
+- `parseCookies` will split only on first =
+- Make BuyNowButton a client component since it uses useEffect
+- Preserve original aspect ratio for product images
+- Invoke CartProvider callbacks before performing the GraphQL mutations
+- Fix the accessible label in the AddToCartButton component when an item is added to cart
+- Cart fetch to return stringified error
+
+### Removed
+
+- Remove sourcemap warnings
+
+## 0.2.1 - 2021-10-12
+
+### Fixed
+
+- Starter template GalleryPreview unique key warning
+- Mitigation for upcoming breaking minor Vite update
+
+## 0.2.0 - 2021-10-08
+
+### Added
+
+- Added support for images and collections in the ProductProvider component
+- Added more GraphQL fragments for building block components (Metafield, UnitPrice) and updated exports of these fragments
+
+### Breaking Change
+
+- `useQuery` now behaves exactly like [react-query's hook of the same name](https://react-query.tanstack.com/reference/useQuery#_top)
+
+### Fixed
+
+- Handle products with selling plans
+
+## 0.1.2 - 2021-09-30
+
+### Fixed
+
+- SSR issue when running Vite 2.6
+- Occasional `ProductProviderFragment` error when booting Hydrogen dev server [#571](https://github.com/Shopify/hydrogen/issues/571)
+
+## 0.1.1 - 2021-09-24
+
+### Added
+
+- New GraphQL fragments for Variants, SellingPlans, and SellingPlanGroups
+
+### Changed
+
+- Updated types for the `useProductOptions` hook
+
+### Fixed
+
+- `Dynamic require of "stream" is not supported` error in browser logs
+
+## 0.1.0 - 2021-09-23
+
+### Changed
+
+- No updates. Transitive dependency bump.
+
+## 1.0.0-alpha.22 - 2021-09-22
+
+### Changed
+
+- No updates. Transitive dependency bump.
+
+[0.6.0]: https://github.com/Shopify/hydrogen/releases/tag/v0.6.0
+[0.6.1]: https://github.com/Shopify/hydrogen/releases/tag/v0.6.1
+[0.6.2]: https://github.com/Shopify/hydrogen/releases/tag/v0.6.2
+[0.6.3]: https://github.com/Shopify/hydrogen/releases/tag/v0.6.3
+[0.6.4]: https://github.com/Shopify/hydrogen/releases/tag/v0.6.4
+[0.7.0]: https://github.com/Shopify/hydrogen/releases/tag/v0.7.0
+[0.7.1]: https://github.com/Shopify/hydrogen/releases/tag/v0.7.1
+[0.8.0]: https://github.com/Shopify/hydrogen/releases/tag/v0.8.0
+[0.8.1]: https://github.com/Shopify/hydrogen/releases/tag/v0.8.1
+[0.8.2]: https://github.com/Shopify/hydrogen/releases/tag/v0.8.2
+[0.8.3]: https://github.com/Shopify/hydrogen/releases/tag/v0.8.3
+[0.9.0]: https://github.com/Shopify/hydrogen/releases/tag/v0.9.0
+[0.9.1]: https://github.com/Shopify/hydrogen/releases/tag/v0.9.1
+[0.10.0]: https://github.com/Shopify/hydrogen/releases/tag/v0.10.0
+[0.10.1]: https://github.com/Shopify/hydrogen/releases/tag/v0.10.1
+[0.11.0]: https://github.com/Shopify/hydrogen/releases/tag/v0.11.0