feat(monorepo): implement orchestrator

Author: avivkeller

.github/workflows/generate.yml

@@ -75,36 +75,36 @@ jobs:
       fail-fast: false
       matrix:
         include:
-          - target: man-page
+          - target: '@node-core/doc-kit/generators/man-page'
             input: './node/doc/api/cli.md'
 
-          - target: addon-verify
+          - target: '@node-core/doc-kit/generators/addon-verify'
             input: './node/doc/api/addons.md'
 
-          - target: api-links
+          - target: '@node-core/doc-kit/generators/api-links'
             input: './node/lib/*.js'
             compare: object-assertion
 
-          - target: orama-db
+          - target: '@node-core/doc-kit/generators/orama-db'
             input: './node/doc/api/*.md'
             compare: file-size
 
-          - target: json-simple
+          - target: '@node-core/doc-kit/generators/json-simple'
             input: './node/doc/api/*.md'
 
-          - target: legacy-json
+          - target: '@node-core/doc-kit/generators/legacy-json'
             input: './node/doc/api/*.md'
             compare: object-assertion
 
-          - target: legacy-html
+          - target: '@node-core/doc-kit/generators/legacy-html'
             input: './node/doc/api/*.md'
             compare: file-size
 
-          - target: web
+          - target: '@node-core/doc-kit/generators/web'
             input: './node/doc/api/*.md'
             compare: file-size
 
-          - target: llms-txt
+          - target: '@node-core/doc-kit/generators/llms-txt'
             input: './node/doc/api/*.md'
             compare: file-size
     steps:

README.md

@@ -68,7 +68,7 @@ Options:
   -v, --version <semver>     Target Node.js version (default: "v22.14.0")
   -c, --changelog <url>      Changelog URL or path (default: "https://raw.githubusercontent.com/nodejs/node/HEAD/CHANGELOG.md")
   --git-ref <url>            Git ref/commit URL (default: "https://github.com/nodejs/node/tree/HEAD")
-  -t, --target [modes...]    Target generator modes (choices: "json-simple", "legacy-html", "legacy-html-all", "man-page", "legacy-json", "legacy-json-all", "addon-verify", "api-links", "orama-db", "llms-txt")
+  -t, --target <generator...>  Target generator(s) (e.g. @node-core/doc-kit/generators/web)
   -h, --help                 display help for command
 ```
 
@@ -91,8 +91,8 @@ To generate a 1:1 match with the [legacy tooling](https://github.com/nodejs/node
 
 ```sh
 npx doc-kit generate \
-  -t legacy-html \
-  -t legacy-json \
+  -t @node-core/doc-kit/generators/legacy-html \
+  -t @node-core/doc-kit/generators/legacy-json \
   -i "path/to/node/doc/api/*.md" \
   -o out \
   --index path/to/node/doc/api/index.md
@@ -104,8 +104,8 @@ To generate [our redesigned documentation pages](https://nodejs-api-docs-tooling
 
 ```sh
 npx doc-kit generate \
-  -t web \
-  -t orama-db \
+  -t @node-core/doc-kit/generators/web \
+  -t @node-core/doc-kit/generators/orama-db \
   -i "path/to/node/doc/api/*.md" \
   -o out \
   --index path/to/node/doc/api/index.md

docs/configuration.md

@@ -100,17 +100,17 @@ Configurations are merged in the following order (earlier sources take precedenc
 
 CLI options map to configuration properties:
 
-| CLI Option             | Config Property    | Example                   |
-| ---------------------- | ------------------ | ------------------------- |
-| `--input <path>`       | `global.input`     | `--input src/`            |
-| `--output <path>`      | `global.output`    | `--output dist/`          |
-| `--ignore <pattern>`   | `global.ignore[]`  | `--ignore test/`          |
-| `--minify`             | `global.minify`    | `--minify`                |
-| `--git-ref <ref>`      | `global.ref`       | `--git-ref v20.0.0`       |
-| `--version <version>`  | `global.version`   | `--version 20.0.0`        |
-| `--changelog <url>`    | `global.changelog` | `--changelog https://...` |
-| `--index <url>`        | `global.index`     | `--index file://...`      |
-| `--type-map <map>`     | `metadata.typeMap` | `--type-map file://...`   |
-| `--target <generator>` | `target`           | `--target json`           |
-| `--threads <n>`        | `threads`          | `--threads 4`             |
-| `--chunk-size <n>`     | `chunkSize`        | `--chunk-size 10`         |
+| CLI Option             | Config Property    | Example                                              |
+| ---------------------- | ------------------ | ---------------------------------------------------- |
+| `--input <path>`       | `global.input`     | `--input src/`                                       |
+| `--output <path>`      | `global.output`    | `--output dist/`                                     |
+| `--ignore <pattern>`   | `global.ignore[]`  | `--ignore test/`                                     |
+| `--minify`             | `global.minify`    | `--minify`                                           |
+| `--git-ref <ref>`      | `global.ref`       | `--git-ref v20.0.0`                                  |
+| `--version <version>`  | `global.version`   | `--version 20.0.0`                                   |
+| `--changelog <url>`    | `global.changelog` | `--changelog https://...`                            |
+| `--index <url>`        | `global.index`     | `--index file://...`                                 |
+| `--type-map <map>`     | `metadata.typeMap` | `--type-map file://...`                              |
+| `--target <generator>` | `target`           | `--target @node-core/doc-kit/generators/legacy-json` |
+| `--threads <n>`        | `threads`          | `--threads 4`                                        |
+| `--chunk-size <n>`     | `chunkSize`        | `--chunk-size 10`                                    |