refactor: split generate-messenger-docs into modular folder structure

Author: cryptodev-2s

.gitignore

@@ -44,6 +44,7 @@ docs-site/build/
 docs-site/.docusaurus/
 docs-site/node_modules/
 docs-site/package-lock.json
+docs-site/.yarn/
 
 # Emacs
 \#*\#

docs-site/yarn.lock

@@ -15,6 +15,12 @@ const config = createConfig([
       'merged-packages/**',
       '.yarn/**',
       'scripts/create-package/package-template/**',
+      'docs-site/docs/**',
+      'docs-site/sidebars.ts',
+      'docs-site/build/**',
+      'docs-site/.docusaurus/**',
+      'docs-site/node_modules/**',
+      'docs-site/.yarn/**',
     ],
   },
   {
@@ -41,8 +47,7 @@ const config = createConfig([
       '**/*.test.{js,ts}',
       '**/test/**/*.{js,ts}',
       '**/tests/**/*.{js,ts}',
-      'scripts/*.ts',
-      'scripts/create-package/**/*.ts',
+      'scripts/**/*.ts',
     ],
     extends: [nodejs],
   },
@@ -125,7 +130,7 @@ const config = createConfig([
     },
   },
   {
-    files: ['scripts/*.ts'],
+    files: ['scripts/**/*.ts'],
     rules: {
       // Scripts may be self-executable and thus have hashbangs.
       'n/hashbang': 'off',

eslint.config.mjs

@@ -21,14 +21,14 @@
     "changelog:update": "yarn workspaces foreach --all --no-private --parallel --interlaced --verbose run changelog:update",
     "changelog:validate": "yarn workspaces foreach --all --no-private --parallel --interlaced --verbose run changelog:validate",
     "create-package": "tsx scripts/create-package",
-    "docs:messenger:build": "yarn docs:messenger:generate && npm --prefix docs-site install && npm --prefix docs-site run build",
-    "docs:messenger:build:client": "yarn docs:messenger:generate:client && npm --prefix docs-site install && npm --prefix docs-site run build",
-    "docs:messenger:dev": "yarn docs:messenger:generate && npm --prefix docs-site install && npm --prefix docs-site start",
-    "docs:messenger:dev:client": "yarn docs:messenger:generate:client && npm --prefix docs-site install && npm --prefix docs-site start",
-    "docs:messenger:generate": "tsx scripts/generate-messenger-docs.ts",
-    "docs:messenger:generate:client": "tsx scripts/generate-messenger-docs.ts --client",
-    "docs:messenger:serve": "yarn docs:messenger:build && npm --prefix docs-site run serve",
-    "docs:messenger:serve:client": "yarn docs:messenger:build:client && npm --prefix docs-site run serve",
+    "docs:messenger:build": "yarn docs:messenger:generate && yarn --cwd docs-site install && yarn --cwd docs-site build",
+    "docs:messenger:build:client": "yarn docs:messenger:generate:client \"$@\" && yarn --cwd docs-site install && yarn --cwd docs-site build",
+    "docs:messenger:dev": "yarn docs:messenger:generate && yarn --cwd docs-site install && yarn --cwd docs-site start",
+    "docs:messenger:dev:client": "yarn docs:messenger:generate:client \"$@\" && yarn --cwd docs-site install && yarn --cwd docs-site start",
+    "docs:messenger:generate": "tsx scripts/generate-messenger-docs/index.ts",
+    "docs:messenger:generate:client": "tsx scripts/generate-messenger-docs/index.ts --client",
+    "docs:messenger:serve": "yarn docs:messenger:build && yarn --cwd docs-site serve",
+    "docs:messenger:serve:client": "yarn docs:messenger:build:client \"$@\" && yarn --cwd docs-site serve",
     "generate-method-action-types": "yarn workspaces foreach --all --parallel --interlaced --verbose run generate-method-action-types",
     "lint": "yarn lint:eslint && echo && yarn lint:misc --check && yarn constraints && yarn lint:dependencies && yarn lint:teams && yarn generate-method-action-types --check",
     "lint:dependencies": "depcheck && yarn dedupe --check",

package.json

@@ -0,0 +1,75 @@
+/* eslint-disable n/no-sync */
+
+import * as fs from 'fs';
+import * as path from 'path';
+
+export const SKIP_DIRS = new Set([
+  '__tests__',
+  'tests',
+  'test',
+  'node_modules',
+  'dist',
+  '__mocks__',
+]);
+
+/**
+ * Recursively find all non-test TypeScript files in a directory.
+ *
+ * @param dir - The directory to search.
+ * @returns An array of absolute file paths.
+ */
+export function findTsFiles(dir: string): string[] {
+  const results: string[] = [];
+
+  function walk(directory: string): void {
+    for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
+      const full = path.join(directory, entry.name);
+      if (entry.isDirectory()) {
+        // Skip test dirs, node_modules, dist
+        if (SKIP_DIRS.has(entry.name)) {
+          continue;
+        }
+        walk(full);
+      } else if (
+        entry.name.endsWith('.ts') &&
+        !entry.name.endsWith('.test.ts') &&
+        !entry.name.endsWith('.test-d.ts') &&
+        !entry.name.endsWith('.spec.ts') &&
+        !entry.name.endsWith('.d.ts')
+      ) {
+        results.push(full);
+      }
+    }
+  }
+
+  walk(dir);
+  return results;
+}
+
+/**
+ * Recursively find all `.d.cts` declaration files in a directory.
+ * Skips nested `node_modules` subdirectories.
+ *
+ * @param dir - The directory to search.
+ * @returns An array of absolute file paths.
+ */
+export function findDtsFiles(dir: string): string[] {
+  const results: string[] = [];
+
+  function walk(directory: string): void {
+    for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
+      const full = path.join(directory, entry.name);
+      if (entry.isDirectory()) {
+        if (entry.name === 'node_modules') {
+          continue;
+        }
+        walk(full);
+      } else if (entry.name.endsWith('.d.cts')) {
+        results.push(full);
+      }
+    }
+  }
+
+  walk(dir);
+  return results;
+}