feat: extract messenger-docs into publishable package

Move messenger docs generation from scripts/generate-messenger-docs/
and docs-site/ into packages/messenger-docs/ as a standalone CLI tool
that can be used by any project with @MetaMask controller dependencies.

Author: cryptodev-2s

.github/CODEOWNERS

@@ -80,6 +80,7 @@
 /packages/error-reporting-service      @MetaMask/core-platform
 /packages/eth-json-rpc-middleware      @MetaMask/core-platform
 /packages/messenger                    @MetaMask/core-platform
+/packages/messenger-docs               @MetaMask/core-platform
 /packages/sample-controllers           @MetaMask/core-platform
 /packages/polling-controller           @MetaMask/core-platform
 /packages/preferences-controller       @MetaMask/core-platform

.github/workflows/messenger-docs.yml

@@ -23,28 +23,22 @@ jobs:
         with:
           is-high-risk-environment: false
 
-      - name: Generate Messenger docs
-        run: yarn docs:messenger:generate
-
-      - name: Install docs-site dependencies
-        run: npm --prefix docs-site install
-
-      - name: Build Docusaurus site
-        run: npm --prefix docs-site run build
+      - name: Generate and build Messenger docs
+        run: yarn docs:messenger:build
 
       - name: Upload build artifact (PR)
         if: github.event_name == 'pull_request'
         uses: actions/upload-artifact@v4
         with:
           name: messenger-api-docs
-          path: docs-site/build/
+          path: .messenger-docs/build/
           retention-days: 7
 
       - name: Upload Pages artifact (main)
         if: github.ref == 'refs/heads/main' && github.event_name == 'push'
         uses: actions/upload-pages-artifact@v3
         with:
-          path: docs-site/build/
+          path: .messenger-docs/build/
 
   deploy:
     name: Deploy to GitHub Pages

.gitignore

@@ -37,14 +37,8 @@ scripts/coverage
 # typescript
 packages/*/*.tsbuildinfo
 
-# Messenger API docs site (generated)
-docs-site/docs/
-docs-site/sidebars.ts
-docs-site/build/
-docs-site/.docusaurus/
-docs-site/node_modules/
-docs-site/package-lock.json
-docs-site/.yarn/
+# Messenger API docs (generated)
+.messenger-docs/
 
 # Emacs
 \#*\#