@depup/gatsby 5.16.1-depup.0

package/dist/utils/api-node-docs.d.ts

@@ -0,0 +1,470 @@
+/**
+ * Lets plugins implementing support for other compile-to-js add to the list
+ * of "resolvable" file extensions. Gatsby supports `.js` and `.jsx` by default.
+ * @returns {Array<string>} array of extensions
+ */
+export declare const resolvableExtensions = true;
+/**
+ * Create pages dynamically. This extension point is called only after the initial
+ * sourcing and transformation of nodes plus creation of the GraphQL schema are
+ * complete so you can query your data in order to create pages.
+ *
+ * You can also fetch data from remote or local sources to create pages.
+ *
+ * See also [the documentation for the action `createPage`](/docs/actions/#createPage).
+ *
+ * @param {object} $0 See the [documentation for `Node API Helpers` for more details](/docs/node-api-helpers)
+ * @param {Actions} $0.actions See the [list of documented actions](/docs/actions)
+ * @param {function} $0.actions.createPage [Documentation for this action](/docs/actions/#createPage)
+ * @param {function} $0.graphql: Query GraphQL API. See [examples here](/docs/creating-and-modifying-pages/#creating-pages-in-gatsby-nodejs)
+ * @param {GatsbyReporter} $0.reporter Log issues. See [GatsbyReporter documentation](/docs/node-api-helpers/#GatsbyReporter) for more details
+ * @returns {Promise<void>} No return value required, but the caller will `await` any promise that's returned
+ *
+ * @example
+ * const path = require(`path`)
+ *
+ * exports.createPages = ({ graphql, actions }) => {
+ *   const { createPage } = actions
+ *   const blogPostTemplate = path.resolve(`src/templates/blog-post.js`)
+ *   // Query for markdown nodes to use in creating pages.
+ *   // You can query for whatever data you want to create pages for e.g.
+ *   // products, portfolio items, landing pages, etc.
+ *   // Variables can be added as the second function parameter
+ *   return graphql(`
+ *     query loadPagesQuery ($limit: Int!) {
+ *       allMarkdownRemark(limit: $limit) {
+ *         edges {
+ *           node {
+ *             frontmatter {
+ *               slug
+ *             }
+ *           }
+ *         }
+ *       }
+ *     }
+ *   `, { limit: 1000 }).then(result => {
+ *     if (result.errors) {
+ *       throw result.errors
+ *     }
+ *
+ *     // Create blog post pages.
+ *     result.data.allMarkdownRemark.edges.forEach(edge => {
+ *       createPage({
+ *         // Path for this page — required
+ *         path: `${edge.node.frontmatter.slug}`,
+ *         component: blogPostTemplate,
+ *         context: {
+ *           // Add optional context data to be inserted
+ *           // as props into the page component.
+ *           //
+ *           // The context data can also be used as
+ *           // arguments to the page GraphQL query.
+ *           //
+ *           // The page "path" is always available as a GraphQL
+ *           // argument.
+ *         },
+ *       })
+ *     })
+ *   })
+ * }
+ */
+export declare const createPages = true;
+/**
+ * Like `createPages` but for plugins who want to manage creating and removing
+ * pages themselves in response to changes in data *not* managed by Gatsby.
+ * Plugins implementing `createPages` will get called regularly to recompute
+ * page information as Gatsby's data changes but those implementing
+ * `createPagesStatefully` will not.
+ *
+ * An example of a plugin that uses this extension point is the plugin
+ * [gatsby-plugin-page-creator](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-plugin-page-creator)
+ * which monitors the `src/pages` directory for the adding and removal of JS
+ * pages. As its source of truth, files in the pages directory, is not known by
+ * Gatsby, it needs to keep its own state about its world to know when to
+ * add and remove pages.
+ */
+export declare const createPagesStatefully = true;
+/**
+ * Extension point to tell plugins to source nodes. This API is called during
+ * the Gatsby bootstrap sequence. Source plugins use this hook to create nodes.
+ * This API is called exactly once per plugin (and once for your site's
+ * `gatsby-config.js` file). If you define this hook in `gatsby-node.js` it
+ * will be called exactly once after all of your source plugins have finished
+ * creating nodes.
+ *
+ * The [Creating a Source
+ * Plugin](/docs/how-to/plugins-and-themes/creating-a-source-plugin/) tutorial
+ * demonstrates a way a plugin or site might use this API.
+ *
+ * See also the documentation for [`createNode`](/docs/actions/#createNode).
+ * @example
+ * exports.sourceNodes = ({ actions, createNodeId, createContentDigest }) => {
+ *   const { createNode } = actions
+ *
+ *   // Data can come from anywhere, but for now create it manually
+ *   const myData = {
+ *     key: 123,
+ *     foo: `The foo field of my node`,
+ *     bar: `Baz`
+ *   }
+ *
+ *   const nodeContent = JSON.stringify(myData)
+ *
+ *   const nodeMeta = {
+ *     id: createNodeId(`my-data-${myData.key}`),
+ *     parent: null,
+ *     children: [],
+ *     internal: {
+ *       type: `MyNodeType`,
+ *       mediaType: `text/html`,
+ *       content: nodeContent,
+ *       contentDigest: createContentDigest(myData)
+ *     }
+ *   }
+ *
+ *   const node = Object.assign({}, myData, nodeMeta)
+ *   createNode(node)
+ * }
+ */
+export declare const sourceNodes = true;
+/**
+ * Called when a new node is created. Plugins wishing to extend or
+ * transform nodes created by other plugins should implement this API.
+ *
+ * See also the documentation for [`createNode`](/docs/actions/#createNode)
+ * and [`createNodeField`](/docs/actions/#createNodeField)
+ *
+ * The [Creating a Source
+ * Plugin](/docs/how-to/plugins-and-themes/creating-a-source-plugin/) tutorial
+ * demonstrates a way a plugin or site might use this API.
+ *
+ * @example
+ * exports.onCreateNode = ({ node, actions }) => {
+ *   const { createNode, createNodeField } = actions
+ *   // Transform the new node here and create a new node or
+ *   // create a new node field.
+ * }
+ */
+export declare const onCreateNode = true;
+/**
+ * Called before scheduling a `onCreateNode` callback for a plugin. If it returns falsy
+ * then Gatsby will not schedule the `onCreateNode` callback for this node for this plugin.
+ * Note: this API does not receive the regular `api` that other callbacks get as first arg.
+ *
+ * @gatsbyVersion 5.0.0
+ * @example
+ * exports.shouldOnCreateNode = ({node}, pluginOptions) => node.internal.type === 'Image'
+ */
+export declare const shouldOnCreateNode = true;
+/**
+ * Called when a new page is created. This extension API is useful
+ * for programmatically manipulating pages created by other plugins e.g.
+ * if you want paths without trailing slashes.
+ *
+ * There is a mechanism in Gatsby to prevent calling onCreatePage for pages
+ * created by the same gatsby-node.js to avoid infinite loops/callback.
+ *
+ * See the guide [Creating and Modifying Pages](/docs/creating-and-modifying-pages/)
+ * for more on this API.
+ */
+export declare const onCreatePage = true;
+/**
+ * Called during the creation of the GraphQL schema. Allows plugins
+ * to add new fields to the types created from data nodes. It will be called
+ * separately for each type.
+ *
+ * This function should return an object in the shape of
+ * [GraphQLFieldConfigMap](https://graphql.org/graphql-js/type/#graphqlobjecttype)
+ * which will be appended to fields inferred by Gatsby from data nodes.
+ *
+ * *Note:* Import GraphQL types from `gatsby/graphql` and don't add the `graphql`
+ * package to your project/plugin dependencies to avoid `Schema must
+ * contain unique named types but contains multiple types named` errors.
+ * `gatsby/graphql` exports all builtin GraphQL types as well as the `GraphQLJSON`
+ * type.
+ *
+ * Many transformer plugins use this to add fields that take arguments.
+ *
+ * * [`gatsby-transformer-remark`](/plugins/gatsby-transformer-remark/)
+ * adds an "excerpt" field where the user when writing their query can specify
+ * how many characters to prune the markdown source to.
+ * * [`gatsby-transformer-sharp`](/plugins/gatsby-transformer-sharp/) exposes
+ * many image transformation options as GraphQL fields.
+ *
+ * @param {object} $0
+ * @param {object} $0.type Object containing `name` and `nodes`
+ * @example
+ * import { GraphQLString } from "gatsby/graphql"
+ *
+ * exports.setFieldsOnGraphQLNodeType = ({ type }) => {
+ *   if (type.name === `File`) {
+ *     return {
+ *       newField: {
+ *         type: GraphQLString,
+ *         args: {
+ *           myArgument: {
+ *             type: GraphQLString,
+ *           }
+ *         },
+ *         resolve: (source, fieldArgs) => {
+ *           return `Id of this node is ${source.id}.
+ *                   Field was called with argument: ${fieldArgs.myArgument}`
+ *         }
+ *       }
+ *     }
+ *   }
+ *
+ *   // by default return empty object
+ *   return {}
+ * }
+ */
+export declare const setFieldsOnGraphQLNodeType = true;
+/**
+ * Customize Gatsby's GraphQL schema by creating type definitions, field
+ * extensions or adding third-party schemas.
+ *
+ * The [`createTypes`](/docs/actions/#createTypes),
+ * [`createFieldExtension`](/docs/actions/#createFieldExtension) and
+ * [`addThirdPartySchema`](/docs/actions/#addThirdPartySchema) actions
+ * are only available in this API. For details on their usage please refer to
+ * the actions documentation.
+ *
+ * This API runs immediately before schema generation. For modifications of the
+ * generated schema, e.g. to customize added third-party types, use the
+ * [`createResolvers`](/docs/node-apis/#createResolvers) API.
+ *
+ * @gatsbyVersion 2.12.0
+ * @param {object} $0
+ * @param {object} $0.actions
+ * @param {object} $0.actions.createTypes
+ * @param {object} $0.actions.createFieldExtension
+ * @param {object} $0.actions.addThirdPartySchema
+ * @example
+ * exports.createSchemaCustomization = ({ actions }) => {
+ *   const { createTypes, createFieldExtension } = actions
+ *
+ *   createFieldExtension({
+ *     name: 'shout',
+ *     extend: () => ({
+ *       resolve(source, args, context, info) {
+ *         return String(source[info.fieldName]).toUpperCase()
+ *       }
+ *     })
+ *   })
+ *
+ *   const typeDefs = `
+ *     type MarkdownRemark implements Node @dontInfer {
+ *       frontmatter: Frontmatter
+ *     }
+ *     type Frontmatter {
+ *       title: String!
+ *       tagline: String @shout
+ *       date: Date @dateformat
+ *       image: File @fileByRelativePath
+ *     }
+ *   `
+ *   createTypes(typeDefs)
+ * }
+ */
+export declare const createSchemaCustomization = true;
+/**
+ * Add custom field resolvers to the GraphQL schema.
+ *
+ * Allows adding new fields to types by providing field configs, or adding resolver
+ * functions to existing fields.
+ *
+ * Things to note:
+ * * Overriding field types is disallowed, instead use the `createTypes`
+ *   action. In case of types added from third-party schemas, where this is not
+ *   possible, overriding field types is allowed.
+ * * New fields will not be available on `filter` and `sort` input types. Extend
+ *   types defined with `createTypes` if you need this.
+ * * In field configs, types can be referenced as strings.
+ * * When extending a field with an existing field resolver, the original
+ *   resolver function is available from `info.originalResolver`.
+ * * The `createResolvers` API is called as the last step in schema generation.
+ *   Thus, an intermediate schema is made available on the `intermediateSchema` property.
+ *   In resolver functions themselves, it is recommended to access the final
+ *   built schema from `info.schema`.
+ * * Gatsby's data layer, including all internal query capabilities, is
+ *   exposed on [`context.nodeModel`](/docs/node-model/). The node store can be
+ *   queried directly with `findOne`, `getNodeById` and `getNodesByIds`,
+ *   while more advanced queries can be composed with `findAll`.
+ * * It is possible to add fields to the root `Query` type.
+ * * When using the first resolver argument (`source` in the example below,
+ *   often also called `parent` or `root`), take care of the fact that field
+ *   resolvers can be called more than once in a query, e.g. when the field is
+ *   present both in the input filter and in the selection set. This means that
+ *   foreign-key fields on `source` can be either resolved or not-resolved.
+ *
+ * For fuller examples, see [`using-type-definitions`](https://github.com/gatsbyjs/gatsby/tree/master/examples/using-type-definitions).
+ *
+ * @gatsbyVersion 2.2.0
+ * @param {object} $0
+ * @param {GraphQLSchema} $0.intermediateSchema Current GraphQL schema
+ * @param {function} $0.createResolvers Add custom resolvers to GraphQL field configs
+ * @param {object} $1
+ * @param {object} $1.resolvers An object map of GraphQL type names to custom resolver functions
+ * @param {object} $1.options Optional createResolvers options
+ * @param {object} $1.options.ignoreNonexistentTypes Silences the warning when trying to add resolvers for types that don't exist. Useful for optional extensions.
+ * @example
+ * exports.createResolvers = ({ createResolvers }) => {
+ *   const resolvers = {
+ *     Author: {
+ *       fullName: {
+ *         resolve: (source, args, context, info) => {
+ *           return source.firstName + source.lastName
+ *         }
+ *       },
+ *     },
+ *     Query: {
+ *       allRecentPosts: {
+ *         type: [`BlogPost`],
+ *         resolve: async (source, args, context, info) => {
+ *           const { entries } = await context.nodeModel.findAll({ type: `BlogPost` })
+ *           return entries.filter(
+ *             post => post.publishedAt > Date.UTC(2018, 0, 1)
+ *           )
+ *         }
+ *       }
+ *     }
+ *   }
+ *   createResolvers(resolvers)
+ * }
+ */
+export declare const createResolvers = true;
+/**
+ * Ask compile-to-js plugins to process source to JavaScript so the query
+ * runner can extract out GraphQL queries for running.
+ */
+export declare const preprocessSource = true;
+/**
+ * Let plugins extend/mutate the site's Babel configuration by calling
+ * [`setBabelPlugin`](/docs/actions/#setBabelPlugin) or
+ * [`setBabelPreset`](/docs/actions/#setBabelPreset).
+ * @param {object} $0
+ * @param {string} $0.stage The current build stage. One of 'develop', 'develop-html',
+ * 'build-javascript', or 'build-html'
+ * @param {object} $0.actions
+ * @param {object} options The Babel configuration
+ * @example
+ * exports.onCreateBabelConfig = ({ actions }) => {
+ *   actions.setBabelPlugin({
+ *     name: `babel-plugin-that-i-like`,
+ *     options: {}
+ *   })
+ * }
+ */
+export declare const onCreateBabelConfig = true;
+/**
+ * Let plugins extend/mutate the site's webpack configuration. This method can be used by any Gatsby site, app, or plugin, not just plugins.
+ *
+ * See also the documentation for [`setWebpackConfig`](/docs/actions/#setWebpackConfig).
+ *
+ * @param {object} $0
+ * @param {string} $0.stage The current build stage. One of 'develop', 'develop-html',
+ * 'build-javascript', or 'build-html'
+ * @param {function} $0.getConfig Returns the current webpack config
+ * @param {object} $0.rules A set of preconfigured webpack config rules
+ * @param {object} $0.loaders A set of preconfigured webpack config loaders
+ * @param {object} $0.plugins A set of preconfigured webpack config plugins
+ * @param {object} $0.actions
+ * @example
+ * exports.onCreateWebpackConfig = ({
+ *  stage, getConfig, rules, loaders, actions
+ * }) => {
+ *   actions.setWebpackConfig({
+ *     module: {
+ *       rules: [
+ *         {
+ *           test: 'my-css',
+ *           use: [loaders.style(), loaders.css()]
+ *         },
+ *       ],
+ *     },
+ *   });
+ * }
+ */
+export declare const onCreateWebpackConfig = true;
+/**
+ * The first API called during Gatsby execution, runs as soon as plugins are loaded, before cache initialization and bootstrap preparation.
+ *
+ * @param {object} $0
+ * @param {object} $0.actions
+ * @example
+ * exports.onPreInit = ({ actions }) => {
+ *
+ * }
+ */
+export declare const onPreInit = true;
+/**
+ * Lifecycle executed in each process (one time per process). Used to store actions etc for later use.
+ *
+ * @example
+ * let createJobV2
+ * exports.onPluginInit = ({ actions }) => {
+ *   // store job creation action to use it later
+ *   createJobV2 = actions.createJobV2
+ * }
+ * @gatsbyVersion 3.9.0
+ */
+export declare const onPluginInit = true;
+/**
+ * Called once Gatsby has initialized itself and is ready to bootstrap your site.
+ */
+export declare const onPreBootstrap = true;
+/**
+ * Called at the end of the bootstrap process after all other extension APIs have been called.
+ */
+export declare const onPostBootstrap = true;
+/**
+ * The first extension point called during the build process. Called after the bootstrap has completed but before the build steps start.
+ */
+export declare const onPreBuild = true;
+/**
+ * The last extension point called after all other parts of the build process
+ * are complete.
+ *
+ * @example
+ * exports.onPostBuild = ({ reporter, basePath, pathPrefix }) => {
+ *  reporter.info(
+ *   `Site was built with basePath: ${basePath} & pathPrefix: ${pathPrefix}`
+ *  );
+ * };
+ */
+export declare const onPostBuild = true;
+/**
+ * Run before GraphQL queries/fragments are extracted from JavaScript files. Useful for plugins
+ * to add more JavaScript files with queries/fragments e.g. from node_modules.
+ *
+ * See gatsby-transformer-sharp and gatsby-source-contentful for examples.
+ */
+export declare const onPreExtractQueries = true;
+/**
+ * Run when the `gatsby develop` server is started. It can be used for adding proxies and Express middleware
+ * to the server.
+ * @param {object} $0
+ * @param {Express} $0.app The [Express app](https://expressjs.com/en/4x/api.html#app) used to run the dev server
+ * @example
+ * exports.onCreateDevServer = ({ app }) => {
+ *   app.get('/hello', function (req, res) {
+ *     res.send('hello world')
+ *   })
+ * }
+ */
+export declare const onCreateDevServer = true;
+/**
+ * Run during the bootstrap phase. Plugins can use this to define a schema for their options using
+ * [Joi](https://joi.dev) to validate the options users pass to the plugin.
+ * @gatsbyVersion 2.25.0
+ * @param {object} $0
+ * @param {Joi} $0.Joi The instance of [Joi](https://joi.dev) to define the schema
+ * @example
+ * exports.pluginOptionsSchema = ({ Joi }) => {
+ *   return Joi.object({
+ *     // Validate that the anonymize option is defined by the user and is a boolean
+ *     anonymize: Joi.boolean().required(),
+ *   })
+ * }
+ */
+export declare const pluginOptionsSchema = true;