@docusaurus/plugin-content-pages 0.0.0-6063 → 0.0.0-6065

package/lib/contentHelpers.d.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.
+ */
+import type { LoadedContent, Metadata } from '@docusaurus/plugin-content-pages';
+export declare function createContentHelpers(): {
+    updateContent: (content: LoadedContent) => void;
+    sourceToPage: Map<string, Metadata>;
+};

package/lib/contentHelpers.js

@@ -0,0 +1,30 @@
+"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.createContentHelpers = createContentHelpers;
+function indexPagesBySource(content) {
+    return new Map(content.map((page) => [page.source, page]));
+}
+// TODO this is bad, we should have a better way to do this (new lifecycle?)
+//  The source to page/permalink is a mutable map passed to the mdx loader
+//  See https://github.com/facebook/docusaurus/pull/10457
+//  See https://github.com/facebook/docusaurus/pull/10185
+function createContentHelpers() {
+    const sourceToPage = new Map();
+    // const sourceToPermalink = new Map<string, string>();
+    // Mutable map update :/
+    function updateContent(content) {
+        sourceToPage.clear();
+        // sourceToPermalink.clear();
+        indexPagesBySource(content).forEach((value, key) => {
+            sourceToPage.set(key, value);
+            // sourceToPermalink.set(key, value.metadata.permalink);
+        });
+    }
+    return { updateContent, sourceToPage };
+}

package/lib/index.js

@@ -15,11 +15,13 @@ const utils_1 = require("@docusaurus/utils");
 const mdx_loader_1 = require("@docusaurus/mdx-loader");
 const routes_1 = require("./routes");
 const content_1 = require("./content");
+const contentHelpers_1 = require("./contentHelpers");
 async function pluginContentPages(context, options) {
     const { siteConfig, siteDir, generatedFilesDir } = context;
     const contentPaths = (0, content_1.createPagesContentPaths)({ context, options });
     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);
+    const contentHelpers = (0, contentHelpers_1.createContentHelpers)();
     async function createPagesMDXLoaderRule() {
         const { admonitions, rehypePlugins, remarkPlugins, recmaPlugins, beforeDefaultRehypePlugins, beforeDefaultRemarkPlugins, } = options;
         const contentDirs = (0, content_1.getContentPathList)(contentPaths);
@@ -37,7 +39,12 @@ async function pluginContentPages(context, options) {
                 // 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`);
+                const metadataPath = path_1.default.join(dataDir, `${(0, utils_1.docuHash)(aliasedSource)}.json`);
+                const metadataContent = contentHelpers.sourceToPage.get(aliasedSource);
+                return {
+                    metadataPath,
+                    metadataContent,
+                };
             },
             // Assets allow to convert some relative images paths to
             // require(...) calls
@@ -70,6 +77,7 @@ async function pluginContentPages(context, options) {
             if (!content) {
                 return;
             }
+            contentHelpers.updateContent(content);
             await (0, routes_1.createAllRoutes)({ content, options, actions });
         },
         configureWebpack() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/plugin-content-pages",
-  "version": "0.0.0-6063",
+  "version": "0.0.0-6065",
   "description": "Pages plugin for Docusaurus.",
   "main": "lib/index.js",
   "types": "src/plugin-content-pages.d.ts",
@@ -18,11 +18,11 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@docusaurus/core": "0.0.0-6063",
-    "@docusaurus/mdx-loader": "0.0.0-6063",
-    "@docusaurus/types": "0.0.0-6063",
-    "@docusaurus/utils": "0.0.0-6063",
-    "@docusaurus/utils-validation": "0.0.0-6063",
+    "@docusaurus/core": "0.0.0-6065",
+    "@docusaurus/mdx-loader": "0.0.0-6065",
+    "@docusaurus/types": "0.0.0-6065",
+    "@docusaurus/utils": "0.0.0-6065",
+    "@docusaurus/utils-validation": "0.0.0-6065",
     "fs-extra": "^11.1.1",
     "tslib": "^2.6.0",
     "webpack": "^5.88.1"
@@ -34,5 +34,5 @@
   "engines": {
     "node": ">=18.0"
   },
-  "gitHead": "d6fbbb85fcb98fd3bf658610f6d7345e5dad2530"
+  "gitHead": "6da713a524315a36515fc3e998ff1551bfa054d2"
 }

package/src/contentHelpers.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 type {LoadedContent, Metadata} from '@docusaurus/plugin-content-pages';
+
+function indexPagesBySource(content: LoadedContent): Map<string, Metadata> {
+  return new Map(content.map((page) => [page.source, page]));
+}
+
+// TODO this is bad, we should have a better way to do this (new lifecycle?)
+//  The source to page/permalink is a mutable map passed to the mdx loader
+//  See https://github.com/facebook/docusaurus/pull/10457
+//  See https://github.com/facebook/docusaurus/pull/10185
+export function createContentHelpers() {
+  const sourceToPage = new Map<string, Metadata>();
+  // const sourceToPermalink = new Map<string, string>();
+
+  // Mutable map update :/
+  function updateContent(content: LoadedContent): void {
+    sourceToPage.clear();
+    // sourceToPermalink.clear();
+    indexPagesBySource(content).forEach((value, key) => {
+      sourceToPage.set(key, value);
+      // sourceToPermalink.set(key, value.metadata.permalink);
+    });
+  }
+
+  return {updateContent, sourceToPage};
+}

package/src/index.ts

@@ -24,6 +24,7 @@ import {
   getContentPathList,
   loadPagesContent,
 } from './content';
+import {createContentHelpers} from './contentHelpers';
 import type {LoadContext, Plugin} from '@docusaurus/types';
 import type {
   PluginOptions,
@@ -46,6 +47,8 @@ export default async function pluginContentPages(
   );
   const dataDir = path.join(pluginDataDirRoot, options.id ?? DEFAULT_PLUGIN_ID);
 
+  const contentHelpers = createContentHelpers();
+
   async function createPagesMDXLoaderRule(): Promise<RuleSetRule> {
     const {
       admonitions,
@@ -73,7 +76,15 @@ export default async function pluginContentPages(
         // 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`);
+        const metadataPath = path.join(
+          dataDir,
+          `${docuHash(aliasedSource)}.json`,
+        );
+        const metadataContent = contentHelpers.sourceToPage.get(aliasedSource);
+        return {
+          metadataPath,
+          metadataContent,
+        };
       },
       // Assets allow to convert some relative images paths to
       // require(...) calls
@@ -114,6 +125,7 @@ export default async function pluginContentPages(
       if (!content) {
         return;
       }
+      contentHelpers.updateContent(content);
       await createAllRoutes({content, options, actions});
     },