@depup/gatsby 5.16.1-depup.0

package/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Gatsbyjs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,142 @@
+# @depup/gatsby
+
+> Dependency-bumped version of [gatsby](https://www.npmjs.com/package/gatsby)
+
+Generated by [DepUp](https://github.com/depup/npm) -- all production
+dependencies bumped to latest versions.
+
+## Installation
+
+```bash
+npm install @depup/gatsby
+```
+
+| Field | Value |
+|-------|-------|
+| Original | [gatsby](https://www.npmjs.com/package/gatsby) @ 5.16.1 |
+| Processed | 2026-03-17 |
+| Smoke test | failed |
+| Deps updated | 112 |
+
+## Dependency Changes
+
+| Dependency | From | To |
+|------------|------|-----|
+| @babel/code-frame | ^7.18.6 | ^7.29.0 |
+| @babel/core | ^7.20.12 | ^7.29.0 |
+| @babel/eslint-parser | ^7.19.1 | ^7.28.6 |
+| @babel/helper-plugin-utils | ^7.20.2 | ^7.28.6 |
+| @babel/parser | ^7.20.13 | ^7.29.2 |
+| @babel/runtime | ^7.20.13 | ^7.29.2 |
+| @babel/traverse | ^7.20.13 | ^7.29.0 |
+| @babel/types | ^7.20.7 | ^7.29.0 |
+| @builder.io/partytown | ^0.7.5 | ^0.10.3 |
+| @expo/devcert | ^1.2.0 | ^1.2.1 |
+| @graphql-codegen/add | ^3.2.3 | ^6.0.0 |
+| @graphql-codegen/core | ^2.6.8 | ^5.0.1 |
+| @graphql-codegen/plugin-helpers | ^2.7.2 | ^6.2.0 |
+| @graphql-codegen/typescript | ^2.8.8 | ^5.0.9 |
+| @graphql-codegen/typescript-operations | ^2.5.13 | ^5.0.9 |
+| @graphql-tools/code-file-loader | ^7.3.23 | ^8.1.28 |
+| @graphql-tools/load | ^7.8.14 | ^8.1.8 |
+| @jridgewell/trace-mapping | ^0.3.18 | ^0.3.31 |
+| @nodelib/fs.walk | ^1.2.8 | ^3.0.1 |
+| @parcel/cache | 2.8.3 | ^2.16.4 |
+| @parcel/core | 2.8.3 | ^2.16.4 |
+| @pmmmwh/react-refresh-webpack-plugin | 0.5 | ^0.6.2 |
+| @types/http-proxy | ^1.17.11 | ^1.17.17 |
+| @typescript-eslint/eslint-plugin | ^5.60.1 | ^8.57.1 |
+| @typescript-eslint/parser | ^5.60.1 | ^8.57.1 |
+| @vercel/webpack-asset-relocator-loader | 1.7.3 | ^1.10.0 |
+| acorn-loose | ^8.3.0 | ^8.5.2 |
+| acorn-walk | ^8.2.0 | ^8.3.5 |
+| address | 1.2.2 | ^2.0.3 |
+| anser | ^2.1.1 | ^2.3.5 |
+| autoprefixer | ^10.4.14 | ^10.4.27 |
+| axios | ^1.6.4 | ^1.13.6 |
+| babel-loader | ^8.3.0 | ^10.1.1 |
+| better-opn | ^2.1.1 | ^3.0.2 |
+| browserslist | ^4.21.9 | ^4.28.1 |
+| cache-manager | ^2.11.1 | ^7.2.8 |
+| chalk | ^4.1.2 | ^5.6.2 |
+| chokidar | ^3.6.0 | ^5.0.0 |
+| compression | ^1.7.4 | ^1.8.1 |
+| cookie | ^0.5.0 | ^1.1.1 |
+| core-js | ^3.31.0 | ^3.49.0 |
+| cors | ^2.8.5 | ^2.8.6 |
+| css-loader | ^5.2.7 | ^7.1.4 |
+| css-minimizer-webpack-plugin | ^2.0.0 | ^8.0.0 |
+| date-fns | ^2.30.0 | ^4.1.0 |
+| debug | ^4.3.4 | ^4.4.3 |
+| detect-port | ^1.5.1 | ^2.1.0 |
+| dotenv | ^8.6.0 | ^17.3.1 |
+| enhanced-resolve | ^5.15.0 | ^5.20.1 |
+| eslint | ^7.32.0 | ^10.0.3 |
+| eslint-config-react-app | ^6.0.0 | ^7.0.1 |
+| eslint-plugin-flowtype | ^5.10.0 | ^8.0.3 |
+| eslint-plugin-import | ^2.27.5 | ^2.32.0 |
+| eslint-plugin-jsx-a11y | ^6.8.0 | ^6.10.2 |
+| eslint-plugin-react | ^7.32.2 | ^7.37.5 |
+| eslint-plugin-react-hooks | ^4.6.0 | ^7.0.1 |
+| eslint-webpack-plugin | ^2.7.0 | ^5.0.3 |
+| execa | ^5.1.1 | ^9.6.1 |
+| express | ^4.18.2 | ^5.2.1 |
+| express-http-proxy | ^1.6.3 | ^2.1.2 |
+| fastq | ^1.15.0 | ^1.20.1 |
+| find-cache-dir | ^3.3.2 | ^6.0.0 |
+| fs-extra | ^11.2.0 | ^11.3.4 |
+| glob | ^7.2.3 | ^13.0.6 |
+| globby | ^11.1.0 | ^16.1.1 |
+| got | ^11.8.6 | ^14.6.6 |
+| graphql | ^16.7.1 | ^16.13.1 |
+| graphql-compose | ^9.0.10 | ^9.1.0 |
+| graphql-http | ^1.19.0 | ^1.22.4 |
+| hasha | ^5.2.2 | ^7.0.0 |
+| is-relative-url | ^3.0.0 | ^4.1.0 |
+| joi | ^17.9.2 | ^18.0.2 |
+| latest-version | ^7.0.0 | ^9.0.0 |
+| lmdb | 2.5.3 | ^3.5.2 |
+| lodash | ^4.17.21 | ^4.17.23 |
+| meant | ^1.0.3 | ^2.0.1 |
+| memoizee | ^0.4.15 | ^0.4.17 |
+| micromatch | ^4.0.5 | ^4.0.8 |
+| mime | ^3.0.0 | ^4.1.0 |
+| mini-css-extract-plugin | 1.6.2 | ^2.10.1 |
+| mitt | ^1.2.0 | ^3.0.1 |
+| moment | ^2.29.4 | ^2.30.1 |
+| multer | ^2.0.1 | ^2.1.1 |
+| node-fetch | ^2.6.11 | ^3.3.2 |
+| node-html-parser | ^5.4.2 | ^7.1.0 |
+| p-defer | ^3.0.0 | ^4.0.1 |
+| path-to-regexp | 0.1.12 | ^8.3.0 |
+| postcss | ^8.4.24 | ^8.5.8 |
+| postcss-loader | ^5.3.0 | ^8.2.1 |
+| query-string | ^6.14.1 | ^9.3.1 |
+| react-refresh | ^0.14.1 | ^0.18.0 |
+| react-server-dom-webpack | 0.0.0-experimental-c8b778b7f-20220825 | ^19.2.4 |
+| redux | 4.2.1 | ^5.0.1 |
+| redux-thunk | ^2.4.2 | ^3.1.0 |
+| semver | ^7.5.3 | ^7.7.4 |
+| signal-exit | ^3.0.7 | ^4.1.0 |
+| slugify | ^1.6.6 | ^1.6.8 |
+| socket.io | ^4.8.1 | ^4.8.3 |
+| socket.io-client | ^4.8.1 | ^4.8.3 |
+| stack-trace | ^0.0.10 | ^1.0.0-pre2 |
+| string-similarity | ^1.2.2 | ^4.0.4 |
+| strip-ansi | ^6.0.1 | ^7.2.0 |
+| style-loader | ^2.0.0 | ^4.0.0 |
+| style-to-object | ^0.4.1 | ^1.0.14 |
+| terser-webpack-plugin | ^5.3.9 | ^5.4.0 |
+| tmp | ^0.2.1 | ^0.2.5 |
+| uuid | ^8.3.2 | ^13.0.0 |
+| webpack | ~5.98.0 | ^5.105.4 |
+| webpack-dev-middleware | ^5.3.4 | ^7.4.5 |
+| webpack-merge | ^5.9.0 | ^6.0.1 |
+| xstate | ^4.38.0 | ^5.28.0 |
+| yaml-loader | ^0.8.0 | ^0.9.0 |
+
+---
+
+Source: https://github.com/depup/npm | Original: https://www.npmjs.com/package/gatsby
+
+License inherited from the original package.

package/adapters.js

@@ -0,0 +1,31 @@
+// @ts-check
+
+/**
+ * List of adapters that should be automatically installed if not present already.
+ * The first item which test function returns `true` will be used.
+ * 
+ * If you're the author of an adapter and want to add it to this list, please open a PR!
+ * If you want to create an adapter, please see: http://www.gatsbyjs.com/docs/how-to/previews-deploys-hosting/creating-an-adapter/
+ * 
+ * @type {Array<import("./src/utils/adapter/types").IAdapterManifestEntry>}
+ * @see http://www.gatsbyjs.com/docs/how-to/previews-deploys-hosting/zero-configuration-deployments/
+ */
+const adaptersManifest = [
+    {
+    name: `Netlify`,
+    module: `gatsby-adapter-netlify`,
+    test: () => !!process.env.NETLIFY || !!process.env.NETLIFY_LOCAL,
+    versions: [
+      {
+        gatsbyVersion: `^5.12.10`,
+        moduleVersion: `^1.2.1`,
+      },
+      {
+        gatsbyVersion: `>=5.0.0 <5.12.10`,
+        moduleVersion: `>=1.0.0 <=1.0.3`,
+      }
+    ],
+  }
+]
+
+module.exports = adaptersManifest

package/apis.json

@@ -0,0 +1,73 @@
+{
+  "ssr": {
+    "replaceRenderer": {},
+    "onRenderBody": {},
+    "onPreRenderHTML": {},
+    "wrapPageElement": {},
+    "wrapRootElement": {}
+  },
+  "browser": {
+    "onClientEntry": {},
+    "onInitialClientRender": {},
+    "onPreRouteUpdate": {},
+    "onRouteUpdateDelayed": {},
+    "onRouteUpdate": {},
+    "shouldUpdateScroll": {},
+    "registerServiceWorker": {},
+    "wrapPageElement": {},
+    "wrapRootElement": {},
+    "onPrefetchPathname": {},
+    "onPostPrefetchPathname": {},
+    "disableCorePrefetching": {},
+    "replaceHydrateFunction": {},
+    "onServiceWorkerInstalled": {},
+    "onServiceWorkerUpdateFound": {},
+    "onServiceWorkerUpdateReady": {},
+    "onServiceWorkerActive": {},
+    "onServiceWorkerRedundant": {},
+    "onCaughtError": {},
+    "onUncaughtError": {}
+  },
+  "node": {
+    "resolvableExtensions": {},
+    "createPages": {},
+    "createPagesStatefully": {},
+    "sourceNodes": {},
+    "onCreateNode": {},
+    "shouldOnCreateNode": {
+      "version": "5.0.0"
+    },
+    "onCreatePage": {},
+    "setFieldsOnGraphQLNodeType": {},
+    "createSchemaCustomization": {
+      "version": "2.12.0"
+    },
+    "createResolvers": {
+      "version": "2.2.0"
+    },
+    "preprocessSource": {},
+    "onCreateBabelConfig": {},
+    "onCreateWebpackConfig": {},
+    "onPreInit": {},
+    "onPluginInit": {
+      "version": "3.9.0"
+    },
+    "onPreBootstrap": {},
+    "onPostBootstrap": {},
+    "onPreBuild": {},
+    "onPostBuild": {},
+    "onPreExtractQueries": {},
+    "onCreateDevServer": {},
+    "pluginOptionsSchema": {
+      "version": "2.25.0"
+    }
+  },
+  "features": [
+    "image-cdn",
+    "graphql-typegen",
+    "content-file-path",
+    "slices",
+    "stateful-source-nodes",
+    "adapters"
+  ]
+}

package/cache-dir/.eslintrc.json

@@ -0,0 +1,10 @@
+{
+  "env": {
+    "browser": true
+  },
+  "globals": {
+    "__PATH_PREFIX__": false,
+    "__TRAILNG_SLASH__": false,
+    "___emitter": false
+  }
+}

package/cache-dir/api-runner-browser-plugins.js

@@ -0,0 +1,14 @@
+// During bootstrap, we write requires at top of this file which looks
+// basically like:
+// module.exports = [
+//   {
+//     plugin: require("/path/to/plugin1/gatsby-browser.js"),
+//     options: { ... },
+//   },
+//   {
+//     plugin: require("/path/to/plugin2/gatsby-browser.js"),
+//     options: { ... },
+//   },
+// ]
+
+module.exports = []

package/cache-dir/api-runner-browser.js

@@ -0,0 +1,52 @@
+const plugins = require(`./api-runner-browser-plugins`)
+const { getResourceURLsForPathname, loadPage, loadPageSync } =
+  require(`./loader`).publicLoader
+
+exports.apiRunner = (api, args = {}, defaultReturn, argTransform) => {
+  // Hooks for gatsby-cypress's API handler
+  if (process.env.CYPRESS_SUPPORT) {
+    if (window.___apiHandler) {
+      window.___apiHandler(api)
+    } else if (window.___resolvedAPIs) {
+      window.___resolvedAPIs.push(api)
+    } else {
+      window.___resolvedAPIs = [api]
+    }
+  }
+
+  let results = plugins.map(plugin => {
+    if (!plugin.plugin[api]) {
+      return undefined
+    }
+
+    args.getResourceURLsForPathname = getResourceURLsForPathname
+    args.loadPage = loadPage
+    args.loadPageSync = loadPageSync
+
+    const result = plugin.plugin[api](args, plugin.options)
+    if (result && argTransform) {
+      args = argTransform({ args, result, plugin })
+    }
+    return result
+  })
+
+  // Filter out undefined results.
+  results = results.filter(result => typeof result !== `undefined`)
+
+  if (results.length > 0) {
+    return results
+  } else if (defaultReturn) {
+    return [defaultReturn]
+  } else {
+    return []
+  }
+}
+
+exports.apiRunnerAsync = (api, args, defaultReturn) =>
+  plugins.reduce(
+    (previous, next) =>
+      next.plugin[api]
+        ? previous.then(() => next.plugin[api](args, next.options))
+        : previous,
+    Promise.resolve()
+  )

package/cache-dir/api-runner-ssr.js

@@ -0,0 +1,88 @@
+/* global plugins */
+// During bootstrap, we write requires at top of this file which looks like:
+// var plugins = [
+//   {
+//     plugin: require("/path/to/plugin1/gatsby-ssr.js"),
+//     options: { ... },
+//   },
+//   {
+//     plugin: require("/path/to/plugin2/gatsby-ssr.js"),
+//     options: { ... },
+//   },
+// ]
+
+const apis = require(`./api-ssr-docs`)
+
+function augmentErrorWithPlugin(plugin, err) {
+  if (plugin.name !== `default-site-plugin`) {
+    // default-site-plugin is user code and will print proper stack trace,
+    // so no point in annotating error message pointing out which plugin is root of the problem
+    err.message += ` (from plugin: ${plugin.name})`
+  }
+
+  throw err
+}
+
+export function apiRunner(api, args, defaultReturn, argTransform) {
+  if (!apis[api]) {
+    console.log(`This API doesn't exist`, api)
+  }
+
+  const results = []
+  plugins.forEach(plugin => {
+    const apiFn = plugin.plugin[api]
+    if (!apiFn) {
+      return
+    }
+
+    try {
+      const result = apiFn(args, plugin.options)
+
+      if (result && argTransform) {
+        args = argTransform({ args, result })
+      }
+
+      // This if case keeps behaviour as before, we should allow undefined here as the api is defined
+      // TODO V4
+      if (typeof result !== `undefined`) {
+        results.push(result)
+      }
+    } catch (e) {
+      augmentErrorWithPlugin(plugin, e)
+    }
+  })
+
+  return results.length ? results : [defaultReturn]
+}
+
+export async function apiRunnerAsync(api, args, defaultReturn, argTransform) {
+  if (!apis[api]) {
+    console.log(`This API doesn't exist`, api)
+  }
+
+  const results = []
+  for (const plugin of plugins) {
+    const apiFn = plugin.plugin[api]
+    if (!apiFn) {
+      continue
+    }
+
+    try {
+      const result = await apiFn(args, plugin.options)
+
+      if (result && argTransform) {
+        args = argTransform({ args, result })
+      }
+
+      // This if case keeps behaviour as before, we should allow undefined here as the api is defined
+      // TODO V4
+      if (typeof result !== `undefined`) {
+        results.push(result)
+      }
+    } catch (e) {
+      augmentErrorWithPlugin(plugin, e)
+    }
+  }
+
+  return results.length ? results : [defaultReturn]
+}

package/cache-dir/api-ssr-docs.js

@@ -0,0 +1,207 @@
+/**
+ * Object containing options defined in `gatsby-config.js`
+ * @typedef {object} pluginOptions
+ */
+
+/**
+ * Replace the default server renderer. This is useful for integration with
+ * Redux, css-in-js libraries, etc. that need custom setups for server
+ * rendering.
+ * @param {object} $0
+ * @param {string} $0.pathname The pathname of the page currently being rendered.
+ * @param {ReactNode} $0.bodyComponent The React element to be rendered as the page body
+ * @param {function} $0.replaceBodyHTMLString Call this with the HTML string
+ * you render. **WARNING** if multiple plugins implement this API it's the
+ * last plugin that "wins". TODO implement an automated warning against this.
+ * @param {function} $0.setHeadComponents Takes an array of components as its
+ * first argument which are added to the `headComponents` array which is passed
+ * to the `html.js` component.
+ * @param {function} $0.setHtmlAttributes Takes an object of props which will
+ * spread into the `<html>` component.
+ * @param {function} $0.setBodyAttributes Takes an object of props which will
+ * spread into the `<body>` component.
+ * @param {function} $0.setPreBodyComponents Takes an array of components as its
+ * first argument which are added to the `preBodyComponents` array which is passed
+ * to the `html.js` component.
+ * @param {function} $0.setPostBodyComponents Takes an array of components as its
+ * first argument which are added to the `postBodyComponents` array which is passed
+ * to the `html.js` component.
+ * @param {function} $0.setBodyProps Takes an object of data which
+ * is merged with other body props and passed to `html.js` as `bodyProps`.
+ * @param {pluginOptions} pluginOptions
+ * @returns {void | Promise<void>}
+ * @example
+ * // From gatsby-plugin-glamor
+ * const { renderToString } = require("react-dom/server")
+ * const inline = require("glamor-inline")
+ *
+ * exports.replaceRenderer = ({ bodyComponent, replaceBodyHTMLString }) => {
+ *   const bodyHTML = renderToString(bodyComponent)
+ *   const inlinedHTML = inline(bodyHTML)
+ *
+ *   replaceBodyHTMLString(inlinedHTML)
+ * }
+ */
+exports.replaceRenderer = true
+
+/**
+ * Called after every page Gatsby server renders while building HTML so you can
+ * set head and body components to be rendered in your `html.js`.
+ *
+ * Gatsby does a two-pass render for HTML. It loops through your pages first
+ * rendering only the body and then takes the result body HTML string and
+ * passes it as the `body` prop to your `html.js` to complete the render.
+ *
+ * It's often handy to be able to send custom components to your `html.js`.
+ * For example, it's a very common pattern for React.js libraries that
+ * support server rendering to pull out data generated during the render to
+ * add to your HTML.
+ *
+ * Using this API over [`replaceRenderer`](#replaceRenderer) is preferable as
+ * multiple plugins can implement this API where only one plugin can take
+ * over server rendering. However, if your plugin requires taking over server
+ * rendering then that's the one to
+ * use
+ * @param {object} $0
+ * @param {string} $0.pathname The pathname of the page currently being rendered.
+ * @param {function} $0.setHeadComponents Takes an array of components as its
+ * first argument which are added to the `headComponents` array which is passed
+ * to the `html.js` component.
+ * @param {function} $0.setHtmlAttributes Takes an object of props which will
+ * spread into the `<html>` component.
+ * @param {function} $0.setBodyAttributes Takes an object of props which will
+ * spread into the `<body>` component.
+ * @param {function} $0.setPreBodyComponents Takes an array of components as its
+ * first argument which are added to the `preBodyComponents` array which is passed
+ * to the `html.js` component.
+ * @param {function} $0.setPostBodyComponents Takes an array of components as its
+ * first argument which are added to the `postBodyComponents` array which is passed
+ * to the `html.js` component.
+ * @param {function} $0.setBodyProps Takes an object of data which
+ * is merged with other body props and passed to `html.js` as `bodyProps`.
+ * @param {pluginOptions} pluginOptions
+ * @example
+ * // Import React so that you can use JSX in HeadComponents
+ * const React = require("react")
+ *
+ * const HtmlAttributes = {
+ *   lang: "en"
+ * }
+ *
+ * const HeadComponents = [
+ *   <script key="my-script" src="https://gatsby.dev/my-script" />
+ * ]
+ *
+ * const BodyAttributes = {
+ *   "data-theme": "dark"
+ * }
+ *
+ * exports.onRenderBody = ({
+ *   setHeadComponents,
+ *   setHtmlAttributes,
+ *   setBodyAttributes
+ * }, pluginOptions) => {
+ *   setHtmlAttributes(HtmlAttributes)
+ *   setHeadComponents(HeadComponents)
+ *   setBodyAttributes(BodyAttributes)
+ * }
+ */
+exports.onRenderBody = true
+
+/**
+ * Called after every page Gatsby server renders while building HTML so you can
+ * replace head components to be rendered in your `html.js`. This is useful if
+ * you need to reorder scripts or styles added by other plugins.
+ * @param {object} $0
+ * @param {string} $0.pathname The pathname of the page currently being rendered.
+ * @param {Array<ReactNode>} $0.getHeadComponents Returns the current `headComponents` array.
+ * @param {function} $0.replaceHeadComponents Takes an array of components as its
+ * first argument which replace the `headComponents` array which is passed
+ * to the `html.js` component. **WARNING** if multiple plugins implement this
+ * API it's the last plugin that "wins".
+ * @param {Array<ReactNode>} $0.getPreBodyComponents Returns the current `preBodyComponents` array.
+ *  @param {function} $0.replacePreBodyComponents Takes an array of components as its
+ * first argument which replace the `preBodyComponents` array which is passed
+ * to the `html.js` component. **WARNING** if multiple plugins implement this
+ * API it's the last plugin that "wins".
+ * @param {Array<ReactNode>} $0.getPostBodyComponents Returns the current `postBodyComponents` array.
+ *  @param {function} $0.replacePostBodyComponents Takes an array of components as its
+ * first argument which replace the `postBodyComponents` array which is passed
+ * to the `html.js` component. **WARNING** if multiple plugins implement this
+ * API it's the last plugin that "wins".
+ * @param {pluginOptions} pluginOptions
+ * @example
+ * // Move Typography.js styles to the top of the head section so they're loaded first.
+ * exports.onPreRenderHTML = ({ getHeadComponents, replaceHeadComponents }) => {
+ *   const headComponents = getHeadComponents()
+ *   headComponents.sort((x, y) => {
+ *     if (x.key === 'TypographyStyle') {
+ *       return -1
+ *     } else if (y.key === 'TypographyStyle') {
+ *       return 1
+ *     }
+ *     return 0
+ *   })
+ *   replaceHeadComponents(headComponents)
+ * }
+ */
+exports.onPreRenderHTML = true
+
+/**
+ * Allow a plugin to wrap the page element.
+ *
+ * This is useful for setting wrapper components around pages that won't get
+ * unmounted on page changes. For setting context providers, use [wrapRootElement](#wrapRootElement).
+ *
+ * _Note:_
+ * There is an equivalent hook in Gatsby's [Browser API](/docs/browser-apis/#wrapPageElement).
+ * It is recommended to use both APIs together.
+ * For example usage, check out [Using i18n](https://github.com/gatsbyjs/gatsby/tree/master/examples/using-i18n).
+ * @param {object} $0
+ * @param {ReactNode} $0.element The "Page" React Element built by Gatsby.
+ * @param {object} $0.props Props object used by page.
+ * @param {pluginOptions} pluginOptions
+ * @returns {ReactNode} Wrapped element
+ * @example
+ * const React = require("react")
+ * const Layout = require("./src/components/layout").default
+ *
+ * exports.wrapPageElement = ({ element, props }) => {
+ *   // props provide same data to Layout as Page element will get
+ *   // including location, data, etc - you don't need to pass it
+ *   return <Layout {...props}>{element}</Layout>
+ * }
+ */
+exports.wrapPageElement = true
+
+/**
+ * Allow a plugin to wrap the root element.
+ *
+ * This is useful to set up any context providers that will wrap your application.
+ * For setting persistent UI elements around pages use [wrapPageElement](#wrapPageElement).
+ *
+ * _Note:_
+ * There is an equivalent hook in Gatsby's [Browser API](/docs/browser-apis/#wrapRootElement).
+ * It is recommended to use both APIs together.
+ * For example usage, check out [Using redux](https://github.com/gatsbyjs/gatsby/tree/master/examples/using-redux).
+ * @param {object} $0
+ * @param {string} $0.pathname The pathname of the page currently being rendered.
+ * @param {ReactNode} $0.element The "Root" React Element built by Gatsby.
+ * @param {pluginOptions} pluginOptions
+ * @returns {ReactNode} Wrapped element
+ * @example
+ * const React = require("react")
+ * const { Provider } = require("react-redux")
+ *
+ * const createStore = require("./src/state/createStore")
+ * const store = createStore()
+ *
+ * exports.wrapRootElement = ({ element }) => {
+ *   return (
+ *     <Provider store={store}>
+ *       {element}
+ *     </Provider>
+ *   )
+ * }
+ */
+exports.wrapRootElement = true