feat(types): ctx.getSiteData

ulivz · ulivz · commit 332dac7138d1 · 2021-12-26T04:41:47.000+08:00
diff --git a/packages/@vuepress/types/src/config.ts b/packages/@vuepress/types/src/config.ts
@@ -1,16 +1,28 @@
 import { PostCssLoaderOptions } from "./style";
 import { MarkdownConfig } from "./markdown";
-import { LocaleConfig } from "./locale";
+import { Locales } from "./locale";
 import { ThemeConfig } from "./theme";
 import { UserPlugins } from "./plugin";
 import { Context } from "./context";
 import { ChainWebpack } from "./shared";
 
+
 /**
  * HTML tag name
  */
 export type HTMLTagName = keyof HTMLElementTagNameMap;
 
+/**
+ * Expose `HeadTags`
+ */
+export type HeadTags = Array<
+[
+  HTMLTagName,
+  Partial<HTMLElementTagNameMap[HTMLTagName]>,
+  string? /* innerHTML */
+]
+>;
+
 /**
  * Expose `VuePress` config.
  */
@@ -39,13 +51,7 @@ export interface Config<T extends ThemeConfig> {
    *
    * @see https://vuepress.vuejs.org/config/#head
    */
-  head?: Array<
-    [
-      HTMLTagName,
-      Partial<HTMLElementTagNameMap[HTMLTagName]>,
-      string? /* innerHTML */
-    ]
-  >;
+  head?: HeadTags;
   /**
    * Specify the host to use for the dev server.
    *
@@ -77,7 +83,7 @@ export interface Config<T extends ThemeConfig> {
    *
    * @see https://vuepress.vuejs.org/config/#locales
    */
-  locales?: { [path: string]: LocaleConfig };
+  locales?: Locales;
   /**
    * A function to control what files should have <link rel="prefetch"> resource hints generated.
    *
diff --git a/packages/@vuepress/types/src/context.ts b/packages/@vuepress/types/src/context.ts
@@ -1,6 +1,7 @@
 import { ThemeConfig } from "./theme";
 import { Config } from "./config";
 import { Lang } from "./lang";
+import { SiteData } from "./site-data";
 
 /**
  * Page instance.
@@ -173,4 +174,8 @@ export interface Context<
    * Theme API.
    */
   themeAPI: ThemeAPI;
+  /**
+   * Get site data.
+   */
+  getSiteData(): SiteData;
 }
diff --git a/packages/@vuepress/types/src/locale.ts b/packages/@vuepress/types/src/locale.ts
@@ -16,3 +16,5 @@ export interface LocaleConfig {
    */
   description: string;
 }
+
+export type Locales = { [path: string]: LocaleConfig };
diff --git a/packages/@vuepress/types/src/site-data.ts b/packages/@vuepress/types/src/site-data.ts
@@ -0,0 +1,14 @@
+import { Page } from "./context";
+import { ThemeConfig } from "./theme";
+import { Locales } from "./locale";
+import { HeadTags } from "./config";
+
+export interface SiteData<T extends ThemeConfig = ThemeConfig> {
+  title: string;
+  description: string;
+  base: string;
+  pages: Page[];
+  headTags: HeadTags;
+  themeConfig: T;
+  locales: Locales;
+}

Original file line number	Diff line number	Diff line change
`@@ -16,3 +16,5 @@ export interface LocaleConfig {`
`16`	`16`	`*/`
`17`	`17`	`description: string;`
`18`	`18`	`}`
	`19`	`+`
	`20`	`+export type Locales = { [path: string]: LocaleConfig };`