@docusaurus/plugin-content-pages 0.0.0-4435 → 0.0.0-4440

package/lib/index.js

@@ -13,6 +13,7 @@ const path_1 = (0, tslib_1.__importDefault)(require("path"));
 const utils_1 = require("@docusaurus/utils");
 const remark_admonitions_1 = (0, tslib_1.__importDefault)(require("remark-admonitions"));
 const pluginOptionSchema_1 = require("./pluginOptionSchema");
+const pageFrontMatter_1 = require("./pageFrontMatter");
 function getContentPathList(contentPaths) {
     return [contentPaths.contentPathLocalized, contentPaths.contentPath];
 }
@@ -54,6 +55,7 @@ async function pluginContentPages(context, options) {
                 ignore: options.exclude,
             });
             async function toMetadata(relativeSource) {
+                var _a, _b;
                 // Lookup in localized folder in priority
                 const contentPath = await (0, utils_1.getFolderContainingFile)(getContentPathList(contentPaths), relativeSource);
                 const source = path_1.default.join(contentPath, relativeSource);
@@ -64,11 +66,16 @@ async function pluginContentPages(context, options) {
                     (0, utils_1.encodePath)((0, utils_1.fileToPath)(relativeSource)),
                 ]);
                 if (isMarkdownSource(relativeSource)) {
-                    // TODO: missing frontmatter validation/normalization here
+                    const content = await fs_extra_1.default.readFile(source, 'utf-8');
+                    const { frontMatter: unsafeFrontMatter, contentTitle, excerpt, } = (0, utils_1.parseMarkdownString)(content);
+                    const frontMatter = (0, pageFrontMatter_1.validatePageFrontMatter)(unsafeFrontMatter);
                     return {
                         type: 'mdx',
                         permalink,
                         source: aliasedSourcePath,
+                        title: (_a = frontMatter.title) !== null && _a !== void 0 ? _a : contentTitle,
+                        description: (_b = frontMatter.description) !== null && _b !== void 0 ? _b : excerpt,
+                        frontMatter,
                     };
                 }
                 else {

package/lib/pageFrontMatter.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import type { FrontMatter } from '@docusaurus/plugin-content-pages';
+export declare function validatePageFrontMatter(frontMatter: Record<string, unknown>): FrontMatter;

package/lib/pageFrontMatter.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validatePageFrontMatter = void 0;
+const utils_validation_1 = require("@docusaurus/utils-validation");
+const PageFrontMatterSchema = utils_validation_1.Joi.object({
+    title: utils_validation_1.Joi.string(),
+    description: utils_validation_1.Joi.string(),
+    wrapperClassName: utils_validation_1.Joi.string(),
+    hide_table_of_contents: utils_validation_1.Joi.string(),
+    ...utils_validation_1.FrontMatterTOCHeadingLevels,
+});
+function validatePageFrontMatter(frontMatter) {
+    return (0, utils_validation_1.validateFrontMatter)(frontMatter, PageFrontMatterSchema);
+}
+exports.validatePageFrontMatter = validatePageFrontMatter;

package/lib/types.d.ts

@@ -4,17 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-export declare type JSXPageMetadata = {
-    type: 'jsx';
-    permalink: string;
-    source: string;
-};
-export declare type MDXPageMetadata = {
-    type: 'mdx';
-    permalink: string;
-    source: string;
-};
-export declare type Metadata = JSXPageMetadata | MDXPageMetadata;
+import type { Metadata } from '@docusaurus/plugin-content-pages';
 export declare type LoadedContent = Metadata[];
 export declare type PagesContentPaths = {
     contentPath: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/plugin-content-pages",
-  "version": "0.0.0-4435",
+  "version": "0.0.0-4440",
   "description": "Pages plugin for Docusaurus.",
   "main": "lib/index.js",
   "types": "src/plugin-content-pages.d.ts",
@@ -18,10 +18,10 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@docusaurus/core": "0.0.0-4435",
-    "@docusaurus/mdx-loader": "0.0.0-4435",
-    "@docusaurus/utils": "0.0.0-4435",
-    "@docusaurus/utils-validation": "0.0.0-4435",
+    "@docusaurus/core": "0.0.0-4440",
+    "@docusaurus/mdx-loader": "0.0.0-4440",
+    "@docusaurus/utils": "0.0.0-4440",
+    "@docusaurus/utils-validation": "0.0.0-4440",
     "fs-extra": "^10.0.0",
     "globby": "^11.0.2",
     "remark-admonitions": "^1.2.1",
@@ -29,7 +29,7 @@
     "webpack": "^5.61.0"
   },
   "devDependencies": {
-    "@docusaurus/types": "0.0.0-4435"
+    "@docusaurus/types": "0.0.0-4440"
   },
   "peerDependencies": {
     "react": "^16.8.4 || ^17.0.0",
@@ -38,5 +38,5 @@
   "engines": {
     "node": ">=14"
   },
-  "gitHead": "41656dfd8207e4a9d80de20fa5d9591f197a12b6"
+  "gitHead": "d13aa3d3a63285610086e000cfb556fa66073368"
 }

package/src/index.ts

@@ -19,6 +19,7 @@ import {
   createAbsoluteFilePathMatcher,
   normalizeUrl,
   DEFAULT_PLUGIN_ID,
+  parseMarkdownString,
 } from '@docusaurus/utils';
 import type {
   LoadContext,
@@ -30,9 +31,10 @@ import type {
 import type {Configuration} from 'webpack';
 import admonitions from 'remark-admonitions';
 import {PluginOptionSchema} from './pluginOptionSchema';
+import {validatePageFrontMatter} from './pageFrontMatter';
 
-import type {LoadedContent, Metadata, PagesContentPaths} from './types';
-import type {PluginOptions} from '@docusaurus/plugin-content-pages';
+import type {LoadedContent, PagesContentPaths} from './types';
+import type {PluginOptions, Metadata} from '@docusaurus/plugin-content-pages';
 
 export function getContentPathList(contentPaths: PagesContentPaths): string[] {
   return [contentPaths.contentPathLocalized, contentPaths.contentPath];
@@ -111,11 +113,20 @@ export default async function pluginContentPages(
           encodePath(fileToPath(relativeSource)),
         ]);
         if (isMarkdownSource(relativeSource)) {
-          // TODO: missing frontmatter validation/normalization here
+          const content = await fs.readFile(source, 'utf-8');
+          const {
+            frontMatter: unsafeFrontMatter,
+            contentTitle,
+            excerpt,
+          } = parseMarkdownString(content);
+          const frontMatter = validatePageFrontMatter(unsafeFrontMatter);
           return {
             type: 'mdx',
             permalink,
             source: aliasedSourcePath,
+            title: frontMatter.title ?? contentTitle,
+            description: frontMatter.description ?? excerpt,
+            frontMatter,
           };
         } else {
           return {

package/src/pageFrontMatter.ts

@@ -0,0 +1,27 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import {
+  Joi,
+  validateFrontMatter,
+  FrontMatterTOCHeadingLevels,
+} from '@docusaurus/utils-validation';
+import type {FrontMatter} from '@docusaurus/plugin-content-pages';
+
+const PageFrontMatterSchema = Joi.object<FrontMatter>({
+  title: Joi.string(),
+  description: Joi.string(),
+  wrapperClassName: Joi.string(),
+  hide_table_of_contents: Joi.string(),
+  ...FrontMatterTOCHeadingLevels,
+});
+
+export function validatePageFrontMatter(
+  frontMatter: Record<string, unknown>,
+): FrontMatter {
+  return validateFrontMatter(frontMatter, PageFrontMatterSchema);
+}

package/src/plugin-content-pages.d.ts

@@ -19,22 +19,45 @@ declare module '@docusaurus/plugin-content-pages' {
   };
 
   export type Options = Partial<PluginOptions>;
+
+  export type FrontMatter = {
+    readonly title?: string;
+    readonly description?: string;
+    readonly wrapperClassName?: string;
+    readonly hide_table_of_contents?: string;
+    readonly toc_min_heading_level?: number;
+    readonly toc_max_heading_level?: number;
+  };
+
+  export type JSXPageMetadata = {
+    type: 'jsx';
+    permalink: string;
+    source: string;
+  };
+
+  export type MDXPageMetadata = {
+    type: 'mdx';
+    permalink: string;
+    source: string;
+    frontMatter: FrontMatter & Record<string, unknown>;
+    title?: string;
+    description?: string;
+  };
+
+  export type Metadata = JSXPageMetadata | MDXPageMetadata;
 }
 
 declare module '@theme/MDXPage' {
   import type {TOCItem} from '@docusaurus/types';
+  import type {
+    MDXPageMetadata,
+    FrontMatter,
+  } from '@docusaurus/plugin-content-pages';
 
   export interface Props {
     readonly content: {
-      readonly frontMatter: {
-        readonly title: string;
-        readonly description: string;
-        readonly wrapperClassName?: string;
-        readonly hide_table_of_contents?: string;
-        readonly toc_min_heading_level?: number;
-        readonly toc_max_heading_level?: number;
-      };
-      readonly metadata: {readonly permalink: string};
+      readonly frontMatter: FrontMatter;
+      readonly metadata: MDXPageMetadata;
       readonly toc: readonly TOCItem[];
       (): JSX.Element;
     };

package/src/types.ts

@@ -5,19 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-export type JSXPageMetadata = {
-  type: 'jsx';
-  permalink: string;
-  source: string;
-};
-
-export type MDXPageMetadata = {
-  type: 'mdx';
-  permalink: string;
-  source: string;
-};
-
-export type Metadata = JSXPageMetadata | MDXPageMetadata;
+import type {Metadata} from '@docusaurus/plugin-content-pages';
 
 export type LoadedContent = Metadata[];