feat(core): simplify plugin API, support route.props (#10042)

packages/docusaurus-plugin-content-docs/src/routes.ts

@@ -9,7 +9,6 @@ import _ from 'lodash';
 import logger from '@docusaurus/logger';
 import {
   docuHash,
-  createSlugger,
   normalizeUrl,
   aliasedSitePathToRelativePath,
 } from '@docusaurus/utils';
@@ -29,7 +28,6 @@ import type {
   CategoryGeneratedIndexMetadata,
   DocMetadata,
   PluginOptions,
-  PropTagsListPage,
 } from '@docusaurus/plugin-content-docs';
 
 function createDocRouteMetadata(docMeta: DocMetadata): RouteMetadata {
@@ -41,36 +39,23 @@ function createDocRouteMetadata(docMeta: DocMetadata): RouteMetadata {
 
 async function buildVersionCategoryGeneratedIndexRoutes({
   version,
-  actions,
   options,
-  aliasedSource,
 }: BuildVersionRoutesParam): Promise<RouteConfig[]> {
-  const slugs = createSlugger();
-
   async function buildCategoryGeneratedIndexRoute(
     categoryGeneratedIndex: CategoryGeneratedIndexMetadata,
   ): Promise<RouteConfig> {
-    const {sidebar, ...prop} = categoryGeneratedIndex;
-
-    const propFileName = slugs.slug(
-      `${version.path}-${categoryGeneratedIndex.sidebar}-category-${categoryGeneratedIndex.title}`,
-    );
-
-    const propData = await actions.createData(
-      `${docuHash(`category/${propFileName}`)}.json`,
-      JSON.stringify(prop, null, 2),
-    );
-
     return {
       path: categoryGeneratedIndex.permalink,
       component: options.docCategoryGeneratedIndexComponent,
       exact: true,
-      modules: {
-        categoryGeneratedIndex: aliasedSource(propData),
+      props: {
+        categoryGeneratedIndex,
       },
       // Same as doc, this sidebar route attribute permits to associate this
       // subpage to the given sidebar
-      ...(sidebar && {sidebar}),
+      ...(categoryGeneratedIndex.sidebar && {
+        sidebar: categoryGeneratedIndex.sidebar,
+      }),
     };
   }
 
@@ -90,7 +75,7 @@ async function buildVersionDocRoutes({
         // Note that this created data path must be in sync with
         // metadataPath provided to mdx-loader.
         `${docuHash(doc.source)}.json`,
-        JSON.stringify(doc, null, 2),
+        doc,
       );
 
       const docRoute: RouteConfig = {
@@ -131,7 +116,7 @@ async function buildVersionSidebarRoute(param: BuildVersionRoutesParam) {
 async function buildVersionTagsRoutes(
   param: BuildVersionRoutesParam,
 ): Promise<RouteConfig[]> {
-  const {version, options, actions, aliasedSource} = param;
+  const {version, options} = param;
   const versionTags = getVersionTags(version.docs);
 
   async function buildTagsListRoute(): Promise<RouteConfig | null> {
@@ -139,37 +124,27 @@ async function buildVersionTagsRoutes(
     if (Object.keys(versionTags).length === 0) {
       return null;
     }
-    const tagsProp: PropTagsListPage['tags'] = toTagsListTagsProp(versionTags);
-    const tagsPropPath = await actions.createData(
-      `${docuHash(`tags-list-${version.versionName}-prop`)}.json`,
-      JSON.stringify(tagsProp, null, 2),
-    );
     return {
       path: version.tagsPath,
       exact: true,
       component: options.docTagsListComponent,
-      modules: {
-        tags: aliasedSource(tagsPropPath),
+      props: {
+        tags: toTagsListTagsProp(versionTags),
       },
     };
   }
 
   async function buildTagDocListRoute(tag: VersionTag): Promise<RouteConfig> {
-    const tagProps = toTagDocListProp({
-      allTagsPath: version.tagsPath,
-      tag,
-      docs: version.docs,
-    });
-    const tagPropPath = await actions.createData(
-      `${docuHash(`tag-${tag.permalink}`)}.json`,
-      JSON.stringify(tagProps, null, 2),
-    );
     return {
       path: tag.permalink,
       component: options.docTagDocListComponent,
       exact: true,
-      modules: {
-        tag: aliasedSource(tagPropPath),
+      props: {
+        tag: toTagDocListProp({
+          allTagsPath: version.tagsPath,
+          tag,
+          docs: version.docs,
+        }),
       },
     };
   }
@@ -189,7 +164,7 @@ type BuildVersionRoutesParam = Omit<BuildAllRoutesParam, 'versions'> & {
 async function buildVersionRoutes(
   param: BuildVersionRoutesParam,
 ): Promise<RouteConfig> {
-  const {version, actions, options, aliasedSource} = param;
+  const {version, options} = param;
 
   async function buildVersionSubRoutes() {
     const [sidebarRoute, tagsRoutes] = await Promise.all([
@@ -201,19 +176,15 @@ async function buildVersionRoutes(
   }
 
   async function doBuildVersionRoutes(): Promise<RouteConfig> {
-    const versionProp = toVersionMetadataProp(options.id, version);
-    const versionPropPath = await actions.createData(
-      `${docuHash(`version-${version.versionName}-metadata-prop`)}.json`,
-      JSON.stringify(versionProp, null, 2),
-    );
-    const subRoutes = await buildVersionSubRoutes();
     return {
       path: version.path,
       exact: false,
       component: options.docVersionRootComponent,
-      routes: subRoutes,
-      modules: {
-        version: aliasedSource(versionPropPath),
+      routes: await buildVersionSubRoutes(),
+      props: {
+        // TODO Docusaurus v4 breaking change?
+        //  expose version metadata as route context instead of props
+        version: toVersionMetadataProp(options.id, version),
       },
       priority: version.routePriority,
     };