@rspress/plugin-typedoc 2.0.0-rc.1 → 2.0.0-rc.2

package/dist/es/index.js

@@ -1,5 +1,6 @@
 import path from "path";
-import { Application, TSConfigReader } from "typedoc";
+import { cwd } from "process";
+import { Application } from "typedoc";
 import { load } from "typedoc-plugin-markdown";
 import promises from "fs/promises";
 function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) {
@@ -76,7 +77,6 @@ function generateMetaJson(absoluteApiDir) {
 function patchGeneratedApiDocs(absoluteApiDir) {
     return _async_to_generator(function*() {
         yield patchLinks(absoluteApiDir);
-        yield promises.rename(path.join(absoluteApiDir, 'README.md'), path.join(absoluteApiDir, 'index.md'));
         yield generateMetaJson(absoluteApiDir);
     })();
 }
@@ -107,21 +107,22 @@ function src_async_to_generator(fn) {
     };
 }
 function pluginTypeDoc(options) {
-    let docRoot;
-    const { entryPoints = [], outDir = "api" } = options;
+    const { entryPoints: userEntryPoints = [], outDir = "api", setup = ()=>{} } = options;
+    const entryPoints = userEntryPoints.map((entryPath)=>{
+        if (!path.isAbsolute(entryPath)) return entryPath;
+        const cwdPosix = cwd().replace(/\\/g, '/');
+        const entryPosix = entryPath.replace(/\\/g, '/');
+        return path.posix.relative(cwdPosix, entryPosix);
+    });
     return {
         name: '@rspress/plugin-typedoc',
         config (config) {
             return src_async_to_generator(function*() {
-                const app = new Application();
-                docRoot = config.root;
-                app.options.addReader(new TSConfigReader());
-                load(app);
-                app.bootstrap({
+                let app = yield Application.bootstrapWithPlugins({
                     name: config.title,
                     entryPoints,
-                    theme: 'markdown',
                     disableSources: true,
+                    router: 'kind',
                     readme: 'none',
                     githubPages: false,
                     requiredToBeDocumented: [
@@ -130,16 +131,23 @@ function pluginTypeDoc(options) {
                         'Interface'
                     ],
                     plugin: [
-                        'typedoc-plugin-markdown'
+                        load
                     ],
+                    entryFileName: 'index',
+                    hidePageHeader: true,
                     hideBreadcrumbs: true,
-                    hideMembersSymbol: true,
-                    allReflectionsHaveOwnDocument: true
+                    pageTitleTemplates: {
+                        module: '{kind}: {name}'
+                    }
                 });
-                const project = app.convert();
+                app = (yield setup(app)) || app;
+                const project = yield app.convert();
                 if (project) {
-                    const absoluteApiDir = path.join(docRoot, outDir);
-                    yield app.generateDocs(project, absoluteApiDir);
+                    const absoluteApiDir = path.join(config.root, outDir);
+                    yield app.outputs.writeOutput({
+                        name: 'markdown',
+                        path: absoluteApiDir
+                    }, project);
                     yield patchGeneratedApiDocs(absoluteApiDir);
                 }
                 return config;

package/dist/types/index.d.ts

@@ -1,3 +1,4 @@
+import { Application } from 'typedoc';
 import type { RspressPlugin } from '@rspress/core';
 
 export declare function pluginTypeDoc(options: PluginTypeDocOptions): RspressPlugin;
@@ -13,6 +14,11 @@ export declare interface PluginTypeDocOptions {
      * @default 'api'
      */
     outDir?: string;
+    /**
+     * A function to setup the TypeDoc Application.
+     * @param app
+     */
+    setup?: (app: Application) => Promise<Application> | Promise<void> | void;
 }
 
 export { }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rspress/plugin-typedoc",
-  "version": "2.0.0-rc.1",
+  "version": "2.0.0-rc.2",
   "description": "A plugin for rspress to integrate typedoc",
   "bugs": "https://github.com/web-infra-dev/rspress/issues",
   "repository": {
@@ -28,22 +28,22 @@
     "dist"
   ],
   "dependencies": {
-    "typedoc": "0.24.8",
-    "typedoc-plugin-markdown": "3.17.1"
+    "typedoc": "0.28.15",
+    "typedoc-plugin-markdown": "4.9.0"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.55.0",
-    "@rslib/core": "0.17.2",
+    "@microsoft/api-extractor": "^7.55.2",
+    "@rslib/core": "0.18.3",
     "@types/node": "^22.8.1",
-    "@types/react": "^19.2.5",
+    "@types/react": "^19.2.7",
     "@types/react-dom": "^19.2.3",
-    "react": "^19.2.0",
+    "react": "^19.2.1",
     "rsbuild-plugin-publint": "^0.3.3",
     "typescript": "^5.8.2",
     "@rspress/config": "1.0.0"
   },
   "peerDependencies": {
-    "@rspress/core": "^2.0.0-rc.1"
+    "@rspress/core": "^2.0.0-rc.2"
   },
   "engines": {
     "node": ">=18.0.0"