@docusaurus/plugin-content-pages 3.9.2-canary-6465 → 3.9.2-canary-6499

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

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();
+    // Mutable map update :/
+    function updateContent(content) {
+        sourceToPage.clear();
+        sourceToPermalink.clear();
+        indexPagesBySource(content).forEach((value, key) => {
+            sourceToPage.set(key, value);
+            sourceToPermalink.set(key, value.permalink);
+        });
+    }
+    return { updateContent, sourceToPage, sourceToPermalink };
+}

package/lib/index.js

@@ -15,9 +15,11 @@ 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 contentHelpers = (0, contentHelpers_1.createContentHelpers)();
     const pluginDataDirRoot = path_1.default.join(generatedFilesDir, 'docusaurus-plugin-content-pages');
     const dataDir = path_1.default.join(pluginDataDirRoot, options.id);
     async function createPagesMDXLoaderRule() {
@@ -49,6 +51,14 @@ async function pluginContentPages(context, options) {
                     image: frontMatter.image,
                 }),
                 markdownConfig: siteConfig.markdown,
+                resolveMarkdownLink: ({ linkPathname, sourceFilePath }) => {
+                    return (0, utils_1.resolveMarkdownLinkPathname)(linkPathname, {
+                        sourceFilePath,
+                        sourceToPermalink: contentHelpers.sourceToPermalink,
+                        siteDir,
+                        contentPaths,
+                    });
+                },
             },
         });
     }
@@ -69,6 +79,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": "3.9.2-canary-6465",
+  "version": "3.9.2-canary-6499",
   "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": "3.9.2-canary-6465",
-    "@docusaurus/mdx-loader": "3.9.2-canary-6465",
-    "@docusaurus/types": "3.9.2-canary-6465",
-    "@docusaurus/utils": "3.9.2-canary-6465",
-    "@docusaurus/utils-validation": "3.9.2-canary-6465",
+    "@docusaurus/core": "3.9.2-canary-6499",
+    "@docusaurus/mdx-loader": "3.9.2-canary-6499",
+    "@docusaurus/types": "3.9.2-canary-6499",
+    "@docusaurus/utils": "3.9.2-canary-6499",
+    "@docusaurus/utils-validation": "3.9.2-canary-6499",
     "fs-extra": "^11.1.1",
     "tslib": "^2.6.0",
     "webpack": "^5.88.1"
@@ -34,5 +34,5 @@
   "engines": {
     "node": ">=20.0"
   },
-  "gitHead": "3b356ca82e7bac46de224279685a7788a7154fea"
+  "gitHead": "5ad8c2b9301411f0be8fabe95315c6a4ac7a7af4"
 }

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.permalink);
+    });
+  }
+
+  return {updateContent, sourceToPage, sourceToPermalink};
+}

package/src/index.ts

@@ -13,10 +13,12 @@ import {
   addTrailingPathSeparator,
   createAbsoluteFilePathMatcher,
   getContentPathList,
+  resolveMarkdownLinkPathname,
 } from '@docusaurus/utils';
 import {createMDXLoaderRule} from '@docusaurus/mdx-loader';
 import {createAllRoutes} from './routes';
 import {createPagesContentPaths, loadPagesContent} from './content';
+import {createContentHelpers} from './contentHelpers';
 import type {LoadContext, Plugin} from '@docusaurus/types';
 import type {
   PluginOptions,
@@ -32,6 +34,7 @@ export default async function pluginContentPages(
   const {siteConfig, siteDir, generatedFilesDir} = context;
 
   const contentPaths = createPagesContentPaths({context, options});
+  const contentHelpers = createContentHelpers();
 
   const pluginDataDirRoot = path.join(
     generatedFilesDir,
@@ -82,6 +85,14 @@ export default async function pluginContentPages(
           image: frontMatter.image,
         }),
         markdownConfig: siteConfig.markdown,
+        resolveMarkdownLink: ({linkPathname, sourceFilePath}) => {
+          return resolveMarkdownLinkPathname(linkPathname, {
+            sourceFilePath,
+            sourceToPermalink: contentHelpers.sourceToPermalink,
+            siteDir,
+            contentPaths,
+          });
+        },
       },
     });
   }
@@ -109,6 +120,7 @@ export default async function pluginContentPages(
       if (!content) {
         return;
       }
+      contentHelpers.updateContent(content);
       await createAllRoutes({content, options, actions});
     },