chore(gatsby): add Offer a base Page props type which folks can extend

[orta]

Description

Once I started using shared fragments, all the auto-generate types tooling broke, so I went manual.

I started using this type in TypeScript v2 and figured it'd be better that I give it to Gatsby instead. Effectively gives people a base type to build on top of for describing the data in their

This is how I define my types which have both a query and custom context from createPage.

( and yah yah, lang vs langKey - I couldn't find docs on langKey so I just used my own everywhere)

Documentation

When there's official TS docs, this should go in as a way to describe your own props - I included a bunch of examples inline which you can copy & paste later

Discussion

I do not know what these are/do:

• "*" could be on the props, but I included it because it was on the older one (it doesn't show up in any of my props at runtime)

• pageResources - I don't get what this does, and couldn't figure it out from some googling and reading docs - so I didn't document it and left it ambiguous but there

[wardpeet]

"*" could be on the props, but I included it because it was on the older one (it doesn't show up in any of my props at runtime)

We should be able to safely remove this.

pageResources - I don't get what this does, and couldn't figure it out from some googling and reading docs - so I didn't document it and left it ambiguous but there

This is an object that holds info about what the page dependencies are, component, data, ... This should have a fixed type

interface PageResources {
  component: React.Component
    json: {
      data: DataType
      pageContext: PageContextType
    },
    page: {
      componentChunkName: string,
      path: string,
      webpackCompilationHash: string,
      matchPath?: string,
    },
}

[orta]

Updated - thanks!

[wardpeet]

LGTM! Thanks @orta!

[wardpeet]

Fixed in gatsby@2.19.24