feat(core): support frontmatter type param in Page type (close vuepress#638)

BREAKING CHANGE: the generics type params of Page type has been changed

Author: meteorlxy

packages/@vuepress/core/__tests__/pluginApi/createHookQueue.spec.ts

@@ -183,14 +183,18 @@ describe('core > pluginApi > createHookQueue', () => {
 
       const hook = createHookQueue(hookName)
       const page = (await createPage(app, { path: '/' })) as Page<
-        { bar: string },
-        { foo: string }
+        { extraData: string },
+        { extraFrontmatter: string },
+        { extraField: string }
       >
       const func1 = jest.fn((page) => {
-        page.foo = 'foo'
+        page.data.extraData = 'foo'
       })
       const func2 = jest.fn((page) => {
-        page.data.bar = 'bar'
+        page.frontmatter.extraFrontmatter = 'bar'
+      })
+      const func3 = jest.fn((page) => {
+        page.extraField = 'baz'
       })
       hook.add({
         pluginName: 'test1',
@@ -200,14 +204,19 @@ describe('core > pluginApi > createHookQueue', () => {
         pluginName: 'test2',
         hook: func2,
       })
+      hook.add({
+        pluginName: 'test3',
+        hook: func3,
+      })
       await hook.process(page, app)
 
       expect(func1).toHaveBeenCalledTimes(1)
       expect(func1).toHaveBeenCalledWith(page, app)
       expect(func2).toHaveBeenCalledTimes(1)
       expect(func2).toHaveBeenCalledWith(page, app)
-      expect(page.foo).toEqual('foo')
-      expect(page.data.bar).toEqual('bar')
+      expect(page.data.extraData).toEqual('foo')
+      expect(page.frontmatter.extraFrontmatter).toEqual('bar')
+      expect(page.extraField).toEqual('baz')
     })
   })
 

packages/@vuepress/core/src/types/page.ts

@@ -1,18 +1,19 @@
 import type { MarkdownLink } from '@vuepress/markdown'
-import type { PageData, PageFrontmatter } from '@vuepress/shared'
+import type { PageBase, PageData, PageFrontmatter } from '@vuepress/shared'
 
 /**
  * Vuepress Page
  */
 export type Page<
   ExtraPageData extends Record<any, any> = Record<never, never>,
+  ExtraPageFrontmatter extends Record<any, any> = Record<string, unknown>,
   ExtraPageFields extends Record<any, any> = Record<never, never>
-> = PageData &
+> = PageBase<ExtraPageFrontmatter> &
   ExtraPageFields & {
     /**
      * Data of the page, which will be available in client code
      */
-    data: PageData<ExtraPageData>
+    data: PageData<ExtraPageData, ExtraPageFrontmatter>
 
     /**
      * Raw Content of the page

packages/@vuepress/shared/src/types/page.ts

@@ -1,11 +1,11 @@
 import type { HeadConfig } from './head'
 
 /**
- * Vuepress page data
+ * Base type of vuepress page
  */
-export type PageData<
-  ExtraPageData extends Record<any, any> = Record<never, never>
-> = ExtraPageData & {
+export type PageBase<
+  ExtraPageFrontmatter extends Record<any, any> = Record<string, unknown>
+> = {
   /**
    * Identifier of the page
    *
@@ -40,7 +40,7 @@ export type PageData<
   /**
    * Front matter of the page
    */
-  frontmatter: PageFrontmatter
+  frontmatter: PageFrontmatter<ExtraPageFrontmatter>
 
   /**
    * Excerpt of the page
@@ -53,6 +53,14 @@ export type PageData<
   headers: PageHeader[]
 }
 
+/**
+ * Vuepress page data
+ */
+export type PageData<
+  ExtraPageData extends Record<any, any> = Record<never, never>,
+  ExtraPageFrontmatter extends Record<any, any> = Record<string, unknown>
+> = PageBase<ExtraPageFrontmatter> & ExtraPageData
+
 /**
  * Vuepress page frontmatter
  *