fix(docs): pin builddocs to 1.x to fix api docs build

.github/renovate.json

@@ -19,6 +19,12 @@
       "matchDepNames": ["prosemirror-*"],
       "groupName": "prosemirror"
     },
+    {
+      "matchDepNames": ["builddocs"],
+      "description": "builddocs 2.x is an incompatible rewrite (HTML output, no markdown/templates); stay on 1.x",
+      "matchUpdateTypes": ["major"],
+      "enabled": false
+    },
     {
       "groupName": "all non-major dependencies",
       "groupSlug": "all-minor-patch",

.github/workflows/ci.yml

@@ -65,6 +65,9 @@ jobs:
       - name: Build packages
         run: pnpm build
 
+      - name: Build API docs
+        run: pnpm --filter=@milkdown/docs run build
+
       - name: Publish snapshot
         if: ${{ github.event_name == 'pull_request' }}
         run: >

docs/api/preset-commonmark.md

@@ -166,6 +166,7 @@ Editor.make()
 @linkSchema
 @toggleLinkCommand
 @updateLinkCommand
+@sanitizeLinkHref
 
 ---
 

docs/package.json

@@ -15,7 +15,7 @@
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0.4",
-    "builddocs": "^2.0.0",
+    "builddocs": "^1.0.9",
     "fs-extra": "^11.3.0"
   }
 }

docs/src/index.ts

@@ -32,7 +32,7 @@ const logError = (error: unknown) => {
 const write = readdirSync(apiDir)
   .filter((dir) => dir !== '.DS_Store')
   .map((pathname) => parse(pathname).name)
-  .map(async (name) => {
+  .map(async (name): Promise<boolean> => {
     const main = resolve(apiDir, `${name}.md`)
     const out = resolve(apiOutDir, `${name}.md`)
 
@@ -51,27 +51,38 @@ const write = readdirSync(apiDir)
         })
         await writeFile(out, markdown)
         logger.info(`Build module: @milkdown/${name} finished.`)
+        return true
       } catch (error) {
         logger.error(`Build module: @milkdown/${name} failed.`)
         logError(error)
+        return false
       }
     } catch {
       // copy the main file to out
       logger.log(`Copying module: @milkdown/${name}...`)
       try {
         await copyFile(main, out)
         logger.info(`Copy module: @milkdown/${name} finished.`)
+        return true
       } catch (error) {
         logger.error(`Copy module: @milkdown/${name} failed.`)
         logError(error)
+        return false
       }
     }
   })
 
 Promise.all(write)
-  .then(() => {
+  .then((results) => {
+    const failed = results.filter((ok) => !ok).length
+    if (failed > 0) {
+      logger.error(`Build api failed: ${failed} module(s) could not be built.`)
+      process.exitCode = 1
+      return
+    }
     logger.info('Build api done.')
   })
   .catch((error) => {
-    throw error
+    logError(error)
+    process.exitCode = 1
   })