up n_m

node_modules/@docusaurus/plugin-content-pages/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Facebook, Inc. and its affiliates.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

node_modules/@docusaurus/plugin-content-pages/README.md

@@ -0,0 +1,7 @@
+# `@docusaurus/plugin-content-pages`
+
+Pages plugin for Docusaurus.
+
+## Usage
+
+See [plugin-content-pages documentation](https://docusaurus.io/docs/api/plugins/@docusaurus/plugin-content-pages).

node_modules/@docusaurus/plugin-content-pages/lib/frontMatter.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 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 { PageFrontMatter } from '@docusaurus/plugin-content-pages';
+export declare function validatePageFrontMatter(frontMatter: {
+    [key: string]: unknown;
+}): PageFrontMatter;

node_modules/@docusaurus/plugin-content-pages/lib/frontMatter.js

@@ -0,0 +1,25 @@
+"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({
+    // See https://github.com/facebook/docusaurus/issues/4591#issuecomment-822372398
+    title: utils_validation_1.Joi.string().allow(''),
+    // See https://github.com/facebook/docusaurus/issues/4591#issuecomment-822372398
+    description: utils_validation_1.Joi.string().allow(''),
+    keywords: utils_validation_1.Joi.array().items(utils_validation_1.Joi.string().required()),
+    image: utils_validation_1.URISchema,
+    wrapperClassName: utils_validation_1.Joi.string(),
+    hide_table_of_contents: utils_validation_1.Joi.boolean(),
+    ...utils_validation_1.FrontMatterTOCHeadingLevels,
+}).concat(utils_validation_1.ContentVisibilitySchema);
+function validatePageFrontMatter(frontMatter) {
+    return (0, utils_validation_1.validateFrontMatter)(frontMatter, PageFrontMatterSchema);
+}
+exports.validatePageFrontMatter = validatePageFrontMatter;

node_modules/@docusaurus/plugin-content-pages/lib/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 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 { LoadContext, Plugin } from '@docusaurus/types';
+import type { PagesContentPaths } from './types';
+import type { PluginOptions, LoadedContent } from '@docusaurus/plugin-content-pages';
+export declare function getContentPathList(contentPaths: PagesContentPaths): string[];
+export default function pluginContentPages(context: LoadContext, options: PluginOptions): Plugin<LoadedContent | null>;
+export { validateOptions } from './options';

node_modules/@docusaurus/plugin-content-pages/lib/index.js

@@ -0,0 +1,188 @@
+"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.validateOptions = exports.getContentPathList = void 0;
+const tslib_1 = require("tslib");
+const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
+const path_1 = tslib_1.__importDefault(require("path"));
+const utils_1 = require("@docusaurus/utils");
+const frontMatter_1 = require("./frontMatter");
+function getContentPathList(contentPaths) {
+    return [contentPaths.contentPathLocalized, contentPaths.contentPath];
+}
+exports.getContentPathList = getContentPathList;
+const isMarkdownSource = (source) => source.endsWith('.md') || source.endsWith('.mdx');
+function pluginContentPages(context, options) {
+    const { siteConfig, siteDir, generatedFilesDir, localizationDir } = context;
+    const contentPaths = {
+        contentPath: path_1.default.resolve(siteDir, options.path),
+        contentPathLocalized: (0, utils_1.getPluginI18nPath)({
+            localizationDir,
+            pluginName: 'docusaurus-plugin-content-pages',
+            pluginId: options.id,
+        }),
+    };
+    const pluginDataDirRoot = path_1.default.join(generatedFilesDir, 'docusaurus-plugin-content-pages');
+    const dataDir = path_1.default.join(pluginDataDirRoot, options.id ?? utils_1.DEFAULT_PLUGIN_ID);
+    return {
+        name: 'docusaurus-plugin-content-pages',
+        getPathsToWatch() {
+            const { include } = options;
+            return getContentPathList(contentPaths).flatMap((contentPath) => include.map((pattern) => `${contentPath}/${pattern}`));
+        },
+        async loadContent() {
+            const { include } = options;
+            if (!(await fs_extra_1.default.pathExists(contentPaths.contentPath))) {
+                return null;
+            }
+            const { baseUrl } = siteConfig;
+            const pagesFiles = await (0, utils_1.Globby)(include, {
+                cwd: contentPaths.contentPath,
+                ignore: options.exclude,
+            });
+            async function processPageSourceFile(relativeSource) {
+                // Lookup in localized folder in priority
+                const contentPath = await (0, utils_1.getFolderContainingFile)(getContentPathList(contentPaths), relativeSource);
+                const source = path_1.default.join(contentPath, relativeSource);
+                const aliasedSourcePath = (0, utils_1.aliasedSitePath)(source, siteDir);
+                const permalink = (0, utils_1.normalizeUrl)([
+                    baseUrl,
+                    options.routeBasePath,
+                    (0, utils_1.encodePath)((0, utils_1.fileToPath)(relativeSource)),
+                ]);
+                if (!isMarkdownSource(relativeSource)) {
+                    return {
+                        type: 'jsx',
+                        permalink,
+                        source: aliasedSourcePath,
+                    };
+                }
+                const content = await fs_extra_1.default.readFile(source, 'utf-8');
+                const { frontMatter: unsafeFrontMatter, contentTitle, excerpt, } = await (0, utils_1.parseMarkdownFile)({
+                    filePath: source,
+                    fileContent: content,
+                    parseFrontMatter: siteConfig.markdown.parseFrontMatter,
+                });
+                const frontMatter = (0, frontMatter_1.validatePageFrontMatter)(unsafeFrontMatter);
+                if ((0, utils_1.isDraft)({ frontMatter })) {
+                    return undefined;
+                }
+                const unlisted = (0, utils_1.isUnlisted)({ frontMatter });
+                return {
+                    type: 'mdx',
+                    permalink,
+                    source: aliasedSourcePath,
+                    title: frontMatter.title ?? contentTitle,
+                    description: frontMatter.description ?? excerpt,
+                    frontMatter,
+                    unlisted,
+                };
+            }
+            async function doProcessPageSourceFile(relativeSource) {
+                try {
+                    return await processPageSourceFile(relativeSource);
+                }
+                catch (err) {
+                    throw new Error(`Processing of page source file path=${relativeSource} failed.`, { cause: err });
+                }
+            }
+            return (await Promise.all(pagesFiles.map(doProcessPageSourceFile))).filter(Boolean);
+        },
+        async contentLoaded({ content, actions }) {
+            if (!content) {
+                return;
+            }
+            const { addRoute, createData } = actions;
+            await Promise.all(content.map(async (metadata) => {
+                const { permalink, source } = metadata;
+                if (metadata.type === 'mdx') {
+                    await createData(
+                    // Note that this created data path must be in sync with
+                    // metadataPath provided to mdx-loader.
+                    `${(0, utils_1.docuHash)(metadata.source)}.json`, JSON.stringify(metadata, null, 2));
+                    addRoute({
+                        path: permalink,
+                        component: options.mdxPageComponent,
+                        exact: true,
+                        modules: {
+                            content: source,
+                        },
+                    });
+                }
+                else {
+                    addRoute({
+                        path: permalink,
+                        component: source,
+                        exact: true,
+                        modules: {
+                            config: `@generated/docusaurus.config`,
+                        },
+                    });
+                }
+            }));
+        },
+        configureWebpack() {
+            const { admonitions, rehypePlugins, remarkPlugins, beforeDefaultRehypePlugins, beforeDefaultRemarkPlugins, } = options;
+            const contentDirs = getContentPathList(contentPaths);
+            return {
+                resolve: {
+                    alias: {
+                        '~pages': pluginDataDirRoot,
+                    },
+                },
+                module: {
+                    rules: [
+                        {
+                            test: /\.mdx?$/i,
+                            include: contentDirs
+                                // Trailing slash is important, see https://github.com/facebook/docusaurus/pull/3970
+                                .map(utils_1.addTrailingPathSeparator),
+                            use: [
+                                {
+                                    loader: require.resolve('@docusaurus/mdx-loader'),
+                                    options: {
+                                        admonitions,
+                                        remarkPlugins,
+                                        rehypePlugins,
+                                        beforeDefaultRehypePlugins,
+                                        beforeDefaultRemarkPlugins,
+                                        staticDirs: siteConfig.staticDirectories.map((dir) => path_1.default.resolve(siteDir, dir)),
+                                        siteDir,
+                                        isMDXPartial: (0, utils_1.createAbsoluteFilePathMatcher)(options.exclude, contentDirs),
+                                        metadataPath: (mdxPath) => {
+                                            // Note that metadataPath must be the same/in-sync as
+                                            // the path from createData for each MDX.
+                                            const aliasedSource = (0, utils_1.aliasedSitePath)(mdxPath, siteDir);
+                                            return path_1.default.join(dataDir, `${(0, utils_1.docuHash)(aliasedSource)}.json`);
+                                        },
+                                        // Assets allow to convert some relative images paths to
+                                        // require(...) calls
+                                        createAssets: ({ frontMatter, }) => ({
+                                            image: frontMatter.image,
+                                        }),
+                                        markdownConfig: siteConfig.markdown,
+                                    },
+                                },
+                                {
+                                    loader: path_1.default.resolve(__dirname, './markdownLoader.js'),
+                                    options: {
+                                    // siteDir,
+                                    // contentPath,
+                                    },
+                                },
+                            ].filter(Boolean),
+                        },
+                    ],
+                },
+            };
+        },
+    };
+}
+exports.default = pluginContentPages;
+var options_1 = require("./options");
+Object.defineProperty(exports, "validateOptions", { enumerable: true, get: function () { return options_1.validateOptions; } });

node_modules/@docusaurus/plugin-content-pages/lib/markdownLoader.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 { LoaderContext } from 'webpack';
+export default function markdownLoader(this: LoaderContext<undefined>, fileString: string): void;

node_modules/@docusaurus/plugin-content-pages/lib/markdownLoader.js

@@ -0,0 +1,16 @@
+"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 });
+function markdownLoader(fileString) {
+    const callback = this.async();
+    // const options = this.getOptions();
+    // TODO provide additional md processing here? like interlinking pages?
+    // fileString = linkify(fileString)
+    return callback(null, fileString);
+}
+exports.default = markdownLoader;

node_modules/@docusaurus/plugin-content-pages/lib/options.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 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 { OptionValidationContext } from '@docusaurus/types';
+import type { PluginOptions, Options } from '@docusaurus/plugin-content-pages';
+export declare const DEFAULT_OPTIONS: PluginOptions;
+export declare function validateOptions({ validate, options, }: OptionValidationContext<Options, PluginOptions>): PluginOptions;

node_modules/@docusaurus/plugin-content-pages/lib/options.js

@@ -0,0 +1,40 @@
+"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.validateOptions = exports.DEFAULT_OPTIONS = void 0;
+const utils_validation_1 = require("@docusaurus/utils-validation");
+const utils_1 = require("@docusaurus/utils");
+exports.DEFAULT_OPTIONS = {
+    path: 'src/pages',
+    routeBasePath: '/',
+    include: ['**/*.{js,jsx,ts,tsx,md,mdx}'],
+    exclude: utils_1.GlobExcludeDefault,
+    mdxPageComponent: '@theme/MDXPage',
+    remarkPlugins: [],
+    rehypePlugins: [],
+    beforeDefaultRehypePlugins: [],
+    beforeDefaultRemarkPlugins: [],
+    admonitions: true,
+};
+const PluginOptionSchema = utils_validation_1.Joi.object({
+    path: utils_validation_1.Joi.string().default(exports.DEFAULT_OPTIONS.path),
+    routeBasePath: utils_validation_1.RouteBasePathSchema.default(exports.DEFAULT_OPTIONS.routeBasePath),
+    include: utils_validation_1.Joi.array().items(utils_validation_1.Joi.string()).default(exports.DEFAULT_OPTIONS.include),
+    exclude: utils_validation_1.Joi.array().items(utils_validation_1.Joi.string()).default(exports.DEFAULT_OPTIONS.exclude),
+    mdxPageComponent: utils_validation_1.Joi.string().default(exports.DEFAULT_OPTIONS.mdxPageComponent),
+    remarkPlugins: utils_validation_1.RemarkPluginsSchema.default(exports.DEFAULT_OPTIONS.remarkPlugins),
+    rehypePlugins: utils_validation_1.RehypePluginsSchema.default(exports.DEFAULT_OPTIONS.rehypePlugins),
+    beforeDefaultRehypePlugins: utils_validation_1.RehypePluginsSchema.default(exports.DEFAULT_OPTIONS.beforeDefaultRehypePlugins),
+    beforeDefaultRemarkPlugins: utils_validation_1.RemarkPluginsSchema.default(exports.DEFAULT_OPTIONS.beforeDefaultRemarkPlugins),
+    admonitions: utils_validation_1.AdmonitionsSchema.default(exports.DEFAULT_OPTIONS.admonitions),
+});
+function validateOptions({ validate, options, }) {
+    const validatedOptions = validate(PluginOptionSchema, options);
+    return validatedOptions;
+}
+exports.validateOptions = validateOptions;

node_modules/@docusaurus/plugin-content-pages/lib/types.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 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.
+ */
+export type PagesContentPaths = {
+    contentPath: string;
+    contentPathLocalized: string;
+};

node_modules/@docusaurus/plugin-content-pages/lib/types.js

@@ -0,0 +1,8 @@
+"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 });

node_modules/@docusaurus/plugin-content-pages/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@docusaurus/plugin-content-pages",
+  "version": "3.1.1",
+  "description": "Pages plugin for Docusaurus.",
+  "main": "lib/index.js",
+  "types": "src/plugin-content-pages.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/facebook/docusaurus.git",
+    "directory": "packages/docusaurus-plugin-content-pages"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@docusaurus/core": "3.1.1",
+    "@docusaurus/mdx-loader": "3.1.1",
+    "@docusaurus/types": "3.1.1",
+    "@docusaurus/utils": "3.1.1",
+    "@docusaurus/utils-validation": "3.1.1",
+    "fs-extra": "^11.1.1",
+    "tslib": "^2.6.0",
+    "webpack": "^5.88.1"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0",
+    "react-dom": "^18.0.0"
+  },
+  "engines": {
+    "node": ">=18.0"
+  },
+  "gitHead": "8017f6a6776ba1bd7065e630a52fe2c2654e2f1b"
+}

node_modules/@docusaurus/plugin-content-pages/src/frontMatter.ts

@@ -0,0 +1,33 @@
+/**
+ * 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,
+  ContentVisibilitySchema,
+  URISchema,
+} from '@docusaurus/utils-validation';
+import type {PageFrontMatter} from '@docusaurus/plugin-content-pages';
+
+const PageFrontMatterSchema = Joi.object<PageFrontMatter>({
+  // See https://github.com/facebook/docusaurus/issues/4591#issuecomment-822372398
+  title: Joi.string().allow(''),
+  // See https://github.com/facebook/docusaurus/issues/4591#issuecomment-822372398
+  description: Joi.string().allow(''),
+  keywords: Joi.array().items(Joi.string().required()),
+  image: URISchema,
+  wrapperClassName: Joi.string(),
+  hide_table_of_contents: Joi.boolean(),
+  ...FrontMatterTOCHeadingLevels,
+}).concat(ContentVisibilitySchema);
+
+export function validatePageFrontMatter(frontMatter: {
+  [key: string]: unknown;
+}): PageFrontMatter {
+  return validateFrontMatter(frontMatter, PageFrontMatterSchema);
+}

node_modules/@docusaurus/plugin-content-pages/src/index.ts

@@ -0,0 +1,270 @@
+/**
+ * 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 fs from 'fs-extra';
+import path from 'path';
+import {
+  encodePath,
+  fileToPath,
+  aliasedSitePath,
+  docuHash,
+  getPluginI18nPath,
+  getFolderContainingFile,
+  addTrailingPathSeparator,
+  Globby,
+  createAbsoluteFilePathMatcher,
+  normalizeUrl,
+  DEFAULT_PLUGIN_ID,
+  parseMarkdownFile,
+  isUnlisted,
+  isDraft,
+} from '@docusaurus/utils';
+import {validatePageFrontMatter} from './frontMatter';
+
+import type {LoadContext, Plugin} from '@docusaurus/types';
+import type {PagesContentPaths} from './types';
+import type {
+  PluginOptions,
+  Metadata,
+  LoadedContent,
+  PageFrontMatter,
+} from '@docusaurus/plugin-content-pages';
+
+export function getContentPathList(contentPaths: PagesContentPaths): string[] {
+  return [contentPaths.contentPathLocalized, contentPaths.contentPath];
+}
+
+const isMarkdownSource = (source: string) =>
+  source.endsWith('.md') || source.endsWith('.mdx');
+
+export default function pluginContentPages(
+  context: LoadContext,
+  options: PluginOptions,
+): Plugin<LoadedContent | null> {
+  const {siteConfig, siteDir, generatedFilesDir, localizationDir} = context;
+
+  const contentPaths: PagesContentPaths = {
+    contentPath: path.resolve(siteDir, options.path),
+    contentPathLocalized: getPluginI18nPath({
+      localizationDir,
+      pluginName: 'docusaurus-plugin-content-pages',
+      pluginId: options.id,
+    }),
+  };
+
+  const pluginDataDirRoot = path.join(
+    generatedFilesDir,
+    'docusaurus-plugin-content-pages',
+  );
+  const dataDir = path.join(pluginDataDirRoot, options.id ?? DEFAULT_PLUGIN_ID);
+
+  return {
+    name: 'docusaurus-plugin-content-pages',
+
+    getPathsToWatch() {
+      const {include} = options;
+      return getContentPathList(contentPaths).flatMap((contentPath) =>
+        include.map((pattern) => `${contentPath}/${pattern}`),
+      );
+    },
+
+    async loadContent() {
+      const {include} = options;
+
+      if (!(await fs.pathExists(contentPaths.contentPath))) {
+        return null;
+      }
+
+      const {baseUrl} = siteConfig;
+      const pagesFiles = await Globby(include, {
+        cwd: contentPaths.contentPath,
+        ignore: options.exclude,
+      });
+
+      async function processPageSourceFile(
+        relativeSource: string,
+      ): Promise<Metadata | undefined> {
+        // Lookup in localized folder in priority
+        const contentPath = await getFolderContainingFile(
+          getContentPathList(contentPaths),
+          relativeSource,
+        );
+
+        const source = path.join(contentPath, relativeSource);
+        const aliasedSourcePath = aliasedSitePath(source, siteDir);
+        const permalink = normalizeUrl([
+          baseUrl,
+          options.routeBasePath,
+          encodePath(fileToPath(relativeSource)),
+        ]);
+        if (!isMarkdownSource(relativeSource)) {
+          return {
+            type: 'jsx',
+            permalink,
+            source: aliasedSourcePath,
+          };
+        }
+        const content = await fs.readFile(source, 'utf-8');
+        const {
+          frontMatter: unsafeFrontMatter,
+          contentTitle,
+          excerpt,
+        } = await parseMarkdownFile({
+          filePath: source,
+          fileContent: content,
+          parseFrontMatter: siteConfig.markdown.parseFrontMatter,
+        });
+        const frontMatter = validatePageFrontMatter(unsafeFrontMatter);
+
+        if (isDraft({frontMatter})) {
+          return undefined;
+        }
+        const unlisted = isUnlisted({frontMatter});
+
+        return {
+          type: 'mdx',
+          permalink,
+          source: aliasedSourcePath,
+          title: frontMatter.title ?? contentTitle,
+          description: frontMatter.description ?? excerpt,
+          frontMatter,
+          unlisted,
+        };
+      }
+
+      async function doProcessPageSourceFile(relativeSource: string) {
+        try {
+          return await processPageSourceFile(relativeSource);
+        } catch (err) {
+          throw new Error(
+            `Processing of page source file path=${relativeSource} failed.`,
+            {cause: err as Error},
+          );
+        }
+      }
+
+      return (
+        await Promise.all(pagesFiles.map(doProcessPageSourceFile))
+      ).filter(Boolean) as Metadata[];
+    },
+
+    async contentLoaded({content, actions}) {
+      if (!content) {
+        return;
+      }
+
+      const {addRoute, createData} = actions;
+
+      await Promise.all(
+        content.map(async (metadata) => {
+          const {permalink, source} = metadata;
+          if (metadata.type === 'mdx') {
+            await createData(
+              // Note that this created data path must be in sync with
+              // metadataPath provided to mdx-loader.
+              `${docuHash(metadata.source)}.json`,
+              JSON.stringify(metadata, null, 2),
+            );
+            addRoute({
+              path: permalink,
+              component: options.mdxPageComponent,
+              exact: true,
+              modules: {
+                content: source,
+              },
+            });
+          } else {
+            addRoute({
+              path: permalink,
+              component: source,
+              exact: true,
+              modules: {
+                config: `@generated/docusaurus.config`,
+              },
+            });
+          }
+        }),
+      );
+    },
+
+    configureWebpack() {
+      const {
+        admonitions,
+        rehypePlugins,
+        remarkPlugins,
+        beforeDefaultRehypePlugins,
+        beforeDefaultRemarkPlugins,
+      } = options;
+      const contentDirs = getContentPathList(contentPaths);
+      return {
+        resolve: {
+          alias: {
+            '~pages': pluginDataDirRoot,
+          },
+        },
+        module: {
+          rules: [
+            {
+              test: /\.mdx?$/i,
+              include: contentDirs
+                // Trailing slash is important, see https://github.com/facebook/docusaurus/pull/3970
+                .map(addTrailingPathSeparator),
+              use: [
+                {
+                  loader: require.resolve('@docusaurus/mdx-loader'),
+                  options: {
+                    admonitions,
+                    remarkPlugins,
+                    rehypePlugins,
+                    beforeDefaultRehypePlugins,
+                    beforeDefaultRemarkPlugins,
+                    staticDirs: siteConfig.staticDirectories.map((dir) =>
+                      path.resolve(siteDir, dir),
+                    ),
+                    siteDir,
+                    isMDXPartial: createAbsoluteFilePathMatcher(
+                      options.exclude,
+                      contentDirs,
+                    ),
+                    metadataPath: (mdxPath: string) => {
+                      // Note that metadataPath must be the same/in-sync as
+                      // the path from createData for each MDX.
+                      const aliasedSource = aliasedSitePath(mdxPath, siteDir);
+                      return path.join(
+                        dataDir,
+                        `${docuHash(aliasedSource)}.json`,
+                      );
+                    },
+                    // Assets allow to convert some relative images paths to
+                    // require(...) calls
+                    createAssets: ({
+                      frontMatter,
+                    }: {
+                      frontMatter: PageFrontMatter;
+                    }) => ({
+                      image: frontMatter.image,
+                    }),
+                    markdownConfig: siteConfig.markdown,
+                  },
+                },
+                {
+                  loader: path.resolve(__dirname, './markdownLoader.js'),
+                  options: {
+                    // siteDir,
+                    // contentPath,
+                  },
+                },
+              ].filter(Boolean),
+            },
+          ],
+        },
+      };
+    },
+  };
+}
+
+export {validateOptions} from './options';

node_modules/@docusaurus/plugin-content-pages/src/markdownLoader.ts

@@ -0,0 +1,22 @@
+/**
+ * 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 {LoaderContext} from 'webpack';
+
+export default function markdownLoader(
+  this: LoaderContext<undefined>,
+  fileString: string,
+): void {
+  const callback = this.async();
+
+  // const options = this.getOptions();
+
+  // TODO provide additional md processing here? like interlinking pages?
+  // fileString = linkify(fileString)
+
+  return callback(null, fileString);
+}

node_modules/@docusaurus/plugin-content-pages/src/options.ts

@@ -0,0 +1,55 @@
+/**
+ * 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,
+  RemarkPluginsSchema,
+  RehypePluginsSchema,
+  AdmonitionsSchema,
+  RouteBasePathSchema,
+} from '@docusaurus/utils-validation';
+import {GlobExcludeDefault} from '@docusaurus/utils';
+import type {OptionValidationContext} from '@docusaurus/types';
+import type {PluginOptions, Options} from '@docusaurus/plugin-content-pages';
+
+export const DEFAULT_OPTIONS: PluginOptions = {
+  path: 'src/pages', // Path to data on filesystem, relative to site dir.
+  routeBasePath: '/', // URL Route.
+  include: ['**/*.{js,jsx,ts,tsx,md,mdx}'], // Extensions to include.
+  exclude: GlobExcludeDefault,
+  mdxPageComponent: '@theme/MDXPage',
+  remarkPlugins: [],
+  rehypePlugins: [],
+  beforeDefaultRehypePlugins: [],
+  beforeDefaultRemarkPlugins: [],
+  admonitions: true,
+};
+
+const PluginOptionSchema = Joi.object<PluginOptions>({
+  path: Joi.string().default(DEFAULT_OPTIONS.path),
+  routeBasePath: RouteBasePathSchema.default(DEFAULT_OPTIONS.routeBasePath),
+  include: Joi.array().items(Joi.string()).default(DEFAULT_OPTIONS.include),
+  exclude: Joi.array().items(Joi.string()).default(DEFAULT_OPTIONS.exclude),
+  mdxPageComponent: Joi.string().default(DEFAULT_OPTIONS.mdxPageComponent),
+  remarkPlugins: RemarkPluginsSchema.default(DEFAULT_OPTIONS.remarkPlugins),
+  rehypePlugins: RehypePluginsSchema.default(DEFAULT_OPTIONS.rehypePlugins),
+  beforeDefaultRehypePlugins: RehypePluginsSchema.default(
+    DEFAULT_OPTIONS.beforeDefaultRehypePlugins,
+  ),
+  beforeDefaultRemarkPlugins: RemarkPluginsSchema.default(
+    DEFAULT_OPTIONS.beforeDefaultRemarkPlugins,
+  ),
+  admonitions: AdmonitionsSchema.default(DEFAULT_OPTIONS.admonitions),
+});
+
+export function validateOptions({
+  validate,
+  options,
+}: OptionValidationContext<Options, PluginOptions>): PluginOptions {
+  const validatedOptions = validate(PluginOptionSchema, options);
+  return validatedOptions;
+}

node_modules/@docusaurus/plugin-content-pages/src/plugin-content-pages.d.ts

@@ -0,0 +1,83 @@
+/**
+ * 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.
+ */
+
+declare module '@docusaurus/plugin-content-pages' {
+  import type {MDXOptions} from '@docusaurus/mdx-loader';
+  import type {LoadContext, Plugin} from '@docusaurus/types';
+
+  export type Assets = {
+    image?: string;
+  };
+
+  export type PluginOptions = MDXOptions & {
+    id?: string;
+    path: string;
+    routeBasePath: string;
+    include: string[];
+    exclude: string[];
+    mdxPageComponent: string;
+  };
+
+  export type Options = Partial<PluginOptions>;
+
+  export type PageFrontMatter = {
+    readonly title?: string;
+    readonly description?: string;
+    readonly image?: string;
+    readonly keywords?: string[];
+    readonly wrapperClassName?: string;
+    readonly hide_table_of_contents?: string;
+    readonly toc_min_heading_level?: number;
+    readonly toc_max_heading_level?: number;
+    readonly draft?: boolean;
+    readonly unlisted?: boolean;
+  };
+
+  export type JSXPageMetadata = {
+    type: 'jsx';
+    permalink: string;
+    source: string;
+  };
+
+  export type MDXPageMetadata = {
+    type: 'mdx';
+    permalink: string;
+    source: string;
+    frontMatter: PageFrontMatter & {[key: string]: unknown};
+    title?: string;
+    description?: string;
+    unlisted: boolean;
+  };
+
+  export type Metadata = JSXPageMetadata | MDXPageMetadata;
+
+  export type LoadedContent = Metadata[];
+
+  export default function pluginContentPages(
+    context: LoadContext,
+    options: PluginOptions,
+  ): Promise<Plugin<LoadedContent | null>>;
+}
+
+declare module '@theme/MDXPage' {
+  import type {LoadedMDXContent} from '@docusaurus/mdx-loader';
+  import type {
+    MDXPageMetadata,
+    PageFrontMatter,
+    Assets,
+  } from '@docusaurus/plugin-content-pages';
+
+  export interface Props {
+    readonly content: LoadedMDXContent<
+      PageFrontMatter,
+      MDXPageMetadata,
+      Assets
+    >;
+  }
+
+  export default function MDXPage(props: Props): JSX.Element;
+}

node_modules/@docusaurus/plugin-content-pages/src/types.ts

@@ -0,0 +1,11 @@
+/**
+ * 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.
+ */
+
+export type PagesContentPaths = {
+  contentPath: string;
+  contentPathLocalized: string;
+};