build(docs): output TypeDoc to typedoc/ so docs/ can hold tracked documentation

TypeDoc output moves from ./docs to ./typedoc (typedoc.json, .gitignore,
collectCoverage.mjs, post_integration Pages publish_dir) so the gitignored,
build-regenerated docs/ tree is freed to hold tracked, human-authored
documentation. The published docs site content is unchanged.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: rhyslbw

.github/workflows/post_integration.yml

@@ -37,4 +37,4 @@ jobs:
         uses: peaceiris/actions-gh-pages@v3
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: docs
+          publish_dir: typedoc

.gitignore

@@ -2,7 +2,7 @@
 package-lock.json
 coverage
 node_modules
-docs
+typedoc
 .env
 tsconfig.tsbuildinfo
 lerna-debug.log

collectCoverage.mjs

@@ -4,10 +4,8 @@ import url from 'url';
 
 const rootDir = path.dirname(url.fileURLToPath(import.meta.url));
 
-const coverageIndexDir = path.join(rootDir, 'docs', 'coverage');
-if (!fs.existsSync(coverageIndexDir)) {
-  fs.mkdirSync(coverageIndexDir);
-}
+const coverageIndexDir = path.join(rootDir, 'typedoc', 'coverage');
+fs.ensureDirSync(coverageIndexDir);
 
 const packagesDir = path.join(rootDir, 'packages');
 for (const packageName of fs.readdirSync(packagesDir)) {

typedoc.json

@@ -1,5 +1,5 @@
 {
-  "out": "./docs",
+  "out": "./typedoc",
   "readme": "none",
   "exclude": [ "**/node_modules/**"],
   "excludeInternal": true,