@graphcommerce/docs 9.0.4-canary.0 → 9.0.4-canary.10

package/CHANGELOG.md

@@ -1,33 +1,33 @@
 # Change Log
 
-## 9.0.4-canary.0
-
-## 9.0.3
+## 9.0.4-canary.10
 
-## 9.0.3-canary.0
+## 9.0.4-canary.9
 
-## 9.0.2
+## 9.0.4-canary.8
 
-## 9.0.2-canary.0
+## 9.0.4-canary.7
 
-## 9.0.1
+## 9.0.4-canary.6
 
-### Patch Changes
+## 9.0.4-canary.5
 
-- [#2461](https://github.com/graphcommerce-org/graphcommerce/pull/2461) [`7017b60`](https://github.com/graphcommerce-org/graphcommerce/commit/7017b608eb61097c881103c40701ab4a41197d7a) - Solve issue with documentation parsing markdown files as mdx ([@paales](https://github.com/paales))
+## 9.0.4-canary.4
 
-- [#2454](https://github.com/graphcommerce-org/graphcommerce/pull/2454) [`0f5267b`](https://github.com/graphcommerce-org/graphcommerce/commit/0f5267b92d8561e20164fe2f078097cb52220726) - Update VSCode guide reference ([@emmanuel-ferdman](https://github.com/emmanuel-ferdman))
+## 9.0.4-canary.3
 
-## 9.0.1-canary.1
+## 9.0.4-canary.2
 
-### Patch Changes
+## 9.0.4-canary.1
 
-- [#2461](https://github.com/graphcommerce-org/graphcommerce/pull/2461) [`7017b60`](https://github.com/graphcommerce-org/graphcommerce/commit/7017b608eb61097c881103c40701ab4a41197d7a) - Solve issue with documentation parsing markdown files as mdx ([@paales](https://github.com/paales))
+## 9.0.4-canary.0
 
-## 9.0.1-canary.0
+## 9.0.1
 
 ### Patch Changes
 
+- [#2461](https://github.com/graphcommerce-org/graphcommerce/pull/2461) [`7017b60`](https://github.com/graphcommerce-org/graphcommerce/commit/7017b608eb61097c881103c40701ab4a41197d7a) - Solve issue with documentation parsing markdown files as mdx ([@paales](https://github.com/paales))
+
 - [#2454](https://github.com/graphcommerce-org/graphcommerce/pull/2454) [`0f5267b`](https://github.com/graphcommerce-org/graphcommerce/commit/0f5267b92d8561e20164fe2f078097cb52220726) - Update VSCode guide reference ([@emmanuel-ferdman](https://github.com/emmanuel-ferdman))
 
 ## 9.0.0

package/feature-list.md

@@ -203,7 +203,7 @@ Features taken from the Magento Commerce 2 Feature List
 - [x] Zoom-in on product images.
 - [ ] Display product videos from YouTube or Vimeo. — [Todo]
 - [x] Include swatches to show colors, fabrics, and more.
-- [ ] Show multiple products in a grouped view. — [Todo]
+- [x] Show multiple products in a grouped view. — [Todo]
 - [x] Indicate stock availability.
 - [x] Set related products, up-sell, and cross-sell recommendations to increase
       average order value.
@@ -276,7 +276,7 @@ Features taken from the Magento Commerce 2 Feature List
       emails.
 - [x] Build customer relationships by creating newsletters and managing their
       distribution.
-- [ ] Connect with customers with a Contact Us form. — [Todo]
+- [x] Connect with customers with a Contact Us form.
 
 ### Customer loyalty
 
@@ -305,10 +305,11 @@ Features taken from the Magento Commerce 2 Feature List
 - [x] Choose default billing and shipping addresses.
 - [x] Store unlimited addresses in the address book.
 - [x] See order status and history.
-- [ ] Re-order from the customer account. — [Todo]
+- [x] Re-order from the customer account.
 - [x] View recently ordered items.
-- [ ] Track available store credits, gift card totals, and reward points. —
-      [Commerce]
+- [x] Track available store credits — [Commerce]
+- [ ] Track gift card totals — [Commerce]
+- [ ] Track reward points — [Commerce]
 - [x] Manage newsletter subscriptions.
 - [x] View submitted product reviews.
 - [ ] Access downloadable/digital products. — [Todo]

package/framework/config.md

@@ -251,6 +251,11 @@ The Google Tagmanager ID to be used on the site.
 
 This value is required even if you are configuring different values for each locale.
 
+#### graphqlMeshEditMode: boolean = `false`
+
+The GraphQL Mesh will be loaded once and any modifications to resolvers will be ignored. When developing
+new resolvers this should be set to true.
+
 #### hygraphManagementApi: string
 
 Hygraph Management API. **Only used for migrations.**

package/framework/mesh.md

@@ -27,7 +27,8 @@ To make modifications to the Mesh configuration, you can:
 ### Modify the meshrc.yaml:
 
 You can always modify the base configuration of the Mesh by modifying the
-`meshrc.yaml` file.
+`meshrc.yaml` file. After making always run `yarn codegen` (this can be in a
+separate terminal and nextjs will reload it).
 
 ### Write a plugin:
 
@@ -61,6 +62,33 @@ export const meshConfig: FunctionPlugin<typeof meshConfigBase> = (
         },
       },
     ],
+    additionalResolvers: [
+      ...(baseConfig.additionalResolvers ?? []),
+      'lib/resolvers/my-feature.ts',
+    ],
   })
 }
 ```
+
+### Creating additional schema's
+
+During development it might come in handy to write schema extensions even before
+any backend work has been done. `AnyFile.graphqls` in the graphql directory will
+automatically be picked up and merged with the rest of the schema.
+
+### Creating additional resolvers
+
+In the plugin add additionalResolvers and point to your ts file where the
+resolver is.
+
+```tsx
+// This MUST be a type import, else there will be a circular dependency.
+import type { Resolvers } from '@graphcommerce/graphql-mesh'
+
+const resolvers: Resolvers = {}
+```
+
+To make sure changes are picked up during development set the config value
+`graphqlMeshEditMode: true` in your graphcommerce.config.js or set the env
+variable `GC_GRAPHQL_MESH_EDIT_MODE=1`. This _will_ make the frontend
+considerably slower.

package/package.json

@@ -2,10 +2,10 @@
   "name": "@graphcommerce/docs",
   "homepage": "https://www.graphcommerce.org/docs",
   "repository": "github:graphcommerce-org/graphcommerce/docs",
-  "version": "9.0.4-canary.0",
+  "version": "9.0.4-canary.10",
   "sideEffects": true,
   "peerDependencies": {
-    "@graphcommerce/prettier-config-pwa": "^9.0.4-canary.0"
+    "@graphcommerce/prettier-config-pwa": "^9.0.4-canary.10"
   },
   "prettier": "@graphcommerce/prettier-config-pwa"
 }

package/roadmap.md

@@ -24,6 +24,7 @@ roadmap.
       configurations that can be made to get a good starting point for your
       project.
 - [ ] Material UI 6 support with CSS variables.
+- [ ] GraphCommerce Pro: Pagebuilder support
 - [ ] GraphCommerce Pro: Login as Customer functionality Magento module +
       GraphCommerce integration.
 - [ ] GraphCommerce Pro: Cache Notifier module + GraphCommerce Integration to
@@ -33,9 +34,6 @@ roadmap.
 
 - [ ] Mui 6 support with [pigment-css](https://github.com/mui/pigment-css)
 - [ ] Upgrade to React 19 + Next.js app router support.
-
-- [ ] GraphCommerce Pro: Pagebuilder support
-      [depends on ↗](https://github.com/magento/magento2/issues/37768)
 - [ ] Adobe Commerce: Reward points functionality
 - [ ] Adobe Commerce: Gift wrapping functionality
 - [ ] Adobe Commerce: Gift card functionality

package/upgrading/graphcommerce-8-to-9.md

@@ -24,7 +24,7 @@ const MyPlugin: ReactPlugin<typeof OriginalComponent> = (props) => {
 export const Plugin = MyPlugin
 ```
 
-Now becomes:
+With:
 
 ```tsx
 const MyPlugin = (props: PluginProps<OriginalComponentProps>) => {
@@ -37,8 +37,7 @@ export const Plugin = MyPlugin
 There is a new plugin configuration method by using
 `export config: PluginConfig = {}`.
 
-2. linguiLocale now requires an explicit configuration where they differ from
-   the locale
+## 2. `linguiLocale` now requires an explicit configuration where they differ from the locale
 
 > linguiLocale: Custom locale used to load the .po files. Must be a valid
 > locale, also used for Intl functions.
@@ -56,15 +55,15 @@ const config = {
 }
 ```
 
-3. `@graphcommerce/graphcms-ui` is now `@graphcommerce/hygraph-ui`
+## 3. `@graphcommerce/graphcms-ui` is now `@graphcommerce/hygraph-ui`
 
 Replace all `@graphcommerce/graphcms-ui` with `@graphcommerce/hygraph-ui`.
 
-4. `@ducanh2912/next-pwa` replaced by `serwist`
+## 4. `@ducanh2912/next-pwa` replaced by `serwist`
 
 Any customizations made to the service worker should
 
-5. `next-sitemap` replaced by custom implementation.
+## 5. `next-sitemap` replaced by custom implementation.
 
 - pages/robots.txt.tsx
 - pages/sitemap/categories.xml.tsx