Add script to compile typedocs into one top-level docs folder

.gitignore

@@ -1,5 +1,8 @@
 **/z-*
 **/*.log
+**/doc
+**/lib
+**/build
 **/.cache
 **/.clangd
 **/.ccache
@@ -9,9 +12,6 @@
 
 .env
 .cmake-js
-modules/**/*/doc
-modules/**/*/lib
-modules/**/*/build
 modules/*/include/rmm
 modules/*/include/cudf
 modules/*/include/cuml

modules/cuda/typedoc.js

@@ -1,5 +1,5 @@
 module.exports = {
-    entryPoints: ['src'],
+    entryPoints: ['src/index.ts'],
     out: 'doc',
     name: '@nvidia/cuda',
     tsconfig: 'tsconfig.json',

modules/cudf/typedoc.js

@@ -1,5 +1,5 @@
 module.exports = {
-    entryPoints: ['src'],
+    entryPoints: ['src/index.ts'],
     out: 'doc',
     name: '@nvidia/cudf',
     tsconfig: 'tsconfig.json',

modules/cugraph/typedoc.js

@@ -1,5 +1,5 @@
 module.exports = {
-    entryPoints: ['src'],
+    entryPoints: ['src/index.ts'],
     out: 'doc',
     name: '@nvidia/cugraph',
     tsconfig: 'tsconfig.json',

modules/deck.gl/typedoc.js

@@ -1,5 +1,5 @@
 module.exports = {
-    entryPoints: ['src'],
+    entryPoints: ['src/index.ts'],
     out: 'doc',
     name: '@nvidia/deck.gl',
     tsconfig: 'tsconfig.json',

modules/glfw/typedoc.js

@@ -1,5 +1,5 @@
 module.exports = {
-    entryPoints: ['src'],
+    entryPoints: ['src/index.ts'],
     out: 'doc',
     name: '@nvidia/glfw',
     tsconfig: 'tsconfig.json',

modules/rmm/typedoc.js

@@ -1,5 +1,5 @@
 module.exports = {
-    entryPoints: ['src'],
+    entryPoints: ['src/index.ts'],
     out: 'doc',
     name: '@nvidia/rmm',
     tsconfig: 'tsconfig.json',

modules/webgl/typedoc.js

@@ -1,5 +1,5 @@
 module.exports = {
-    entryPoints: ['src'],
+    entryPoints: ['src/index.ts'],
     out: 'doc',
     name: '@nvidia/webgl',
     tsconfig: 'tsconfig.json',

package.json

@@ -9,7 +9,8 @@
   ],
   "scripts": {
     "clean": "scripts/exec.js clean",
-    "doc": "scripts/exec.js run doc",
+    "doc": "rimraf doc && typedoc --options typedoc.js && npm run doc:packages",
+    "doc:packages": "scripts/exec.js run doc",
     "demo": "scripts/exec.js demo",
     "test": "scripts/exec.js test",
     "lint": "scripts/exec.js lint",

typedoc.js

@@ -0,0 +1,29 @@
+const Path = require('path');
+const loadOptions = (base) => {
+    const opts = require(Path.resolve(base, 'typedoc.js'));
+    opts.entryPoints = opts.entryPoints.map((entryPoint) => Path.resolve(base, entryPoint));
+    return opts;
+};
+
+const mergeOptions = (...opts) => Object.assign({}, ...opts, {
+    entryPoints: opts.reduce((es, { entryPoints = [] }) => [...es, ...entryPoints], [])
+});
+
+module.exports = mergeOptions(
+    loadOptions('modules/cuda'),
+    loadOptions('modules/rmm'),
+    loadOptions('modules/cudf'),
+    loadOptions('modules/cugraph'),
+    loadOptions('modules/deck.gl'),
+    loadOptions('modules/glfw'),
+    loadOptions('modules/webgl'),
+    {
+        out: 'doc',
+        name: 'RAPIDS',
+        tsconfig: 'tsconfig.json',
+        hideGenerator: true,
+        excludePrivate: true,
+        excludeProtected: true,
+        excludeExternals: true,
+    }
+);