chore: remove the legacy-html and legacy-html-all generators

Node.js builds its API docs with the redesigned `html` generator since
nodejs/node#62045, so nothing uses the legacy HTML generators anymore.

This also removes what only they used: the `shiki.config.mjs` export of
`@doc-kit/core`, and the `hastscript`, `remark-parse`, `unist-builder`,
and `unist-util-visit` dependencies of `@node-core/doc-kit-legacy`.

Assisted-by: Claude Opus 5.5 <noreply@anthropic.com>
Assisted-by: Claude Sonnet 5.5 <noreply@anthropic.com>

Author: ovflowd

.c8rc.json

@@ -3,7 +3,6 @@
   "exclude": [
     "eslint.config.mjs",
     "**/fixtures",
-    "packages/node-legacy/src/legacy-html/assets",
     "packages/react/src/html/ui",
     "**/*.d.ts",
     "www/**",

.changeset/remove-legacy-generators.md

@@ -0,0 +1,7 @@
+---
+'@doc-kit/core': major
+'@doc-kit/cli': major
+'@node-core/doc-kit-legacy': major
+---
+
+Remove the `legacy-html` and `legacy-html-all` generators, now that Node.js builds its API docs with the redesigned `html` generator. The `shiki.config.mjs` export of `@doc-kit/core`, which only they used, is removed too

.github/workflows/generate.yml

@@ -102,10 +102,6 @@ jobs:
             input: './node/doc/api/*.md'
             compare: object-assertion
 
-          - target: legacy-html
-            input: './node/doc/api/*.md'
-            compare: file-size
-
           - target: web
             input: './node/doc/api/*.md'
             compare: file-size

.oxlintrc.json

@@ -204,11 +204,7 @@
       }
     },
     {
-      "files": [
-        "packages/node-legacy/src/legacy-html/assets/*.js",
-        "packages/react/src/html/ui/**/*",
-        "e2e/**/*.spec.js"
-      ],
+      "files": ["packages/react/src/html/ui/**/*", "e2e/**/*.spec.js"],
       "globals": {
         "AsyncDisposableStack": "readonly",
         "DisposableStack": "readonly",

CONTRIBUTING.md

@@ -116,7 +116,7 @@ comparators](docs/contributing/comparators.md) — live under
 
    ```bash
    node packages/cli/bin/cli.mjs generate \
-     -t legacy-html \
+     -t html \
      -i ../node/doc/api/fs.md \
      -o out \
      --index ../node/doc/api/index.md \
@@ -136,7 +136,7 @@ comparators](docs/contributing/comparators.md) — live under
    Add `--log-level debug` before the `generate` subcommand to see the full pipeline trace:
 
    ```bash
-   node packages/cli/bin/cli.mjs --log-level debug generate -t legacy-html -i ../node/doc/api/fs.md -o out
+   node packages/cli/bin/cli.mjs --log-level debug generate -t html -i ../node/doc/api/fs.md -o out
    ```
 
 > [!TIP]

README.md

@@ -68,9 +68,8 @@ Generate API docs
 Options:
   --config-file <path>         Config file
   -i, --input <patterns...>    Input file patterns (glob)
-  -t, --target <generator...>  Target generator(s): a built-in name
-                               (json, json-all, json-simple, legacy-html,
-                               legacy-html-all, man-page, legacy-json,
+  -t, --target <generator...>  Target generator(s): a built-in name (json,
+                               json-all, json-simple, man-page, legacy-json,
                                legacy-json-all, addon-verify, api-links,
                                orama-db, llms-txt, llms-txt-full, sitemap,
                                html, section-pages) or an import specifier
@@ -93,11 +92,10 @@ Options:
 
 ### Legacy
 
-To generate a 1:1 match with the [legacy tooling](https://github.com/nodejs/node/tree/main/tools/doc), use the `legacy-html`, `legacy-json`, `legacy-html-all`, and `legacy-json-all` generators.
+To generate a 1:1 match with the JSON of the [legacy tooling](https://github.com/nodejs/node/tree/main/tools/doc), use the `legacy-json` and `legacy-json-all` generators.
 
 ```sh
 npx @doc-kit/cli generate \
-  -t legacy-html \
   -t legacy-json \
   -i "path/to/node/doc/api/*.md" \
   -o out \

docs/contributing/comparators.md

@@ -39,7 +39,7 @@ scripts/
 
 Comparators can be reused across multiple generators. You specify which comparator to use in the workflow file using the `compare` field. For example:
 
-- `file-size.mjs` can compare output from `html`, `legacy-html`, or any generator
+- `file-size.mjs` can compare output from `html`, `orama-db`, or any generator
 - `object-assertion.mjs` can compare JSON output from `legacy-json`, `json-simple`, etc.
 - `my-comparator.mjs` would be a custom comparator for specific needs
 

docs/generators.md

@@ -32,12 +32,10 @@ npx @doc-kit/cli generate -t html -t orama-db -t sitemap -i "docs/**/*.md" -o ou
 1:1 matches for Node.js's original documentation tooling, for consumers of
 the classic layouts.
 
-| Target                                               | Output                              |
-| ---------------------------------------------------- | ----------------------------------- |
-| [`legacy-html`](./generators/legacy-html.md)         | One classic HTML page per document. |
-| [`legacy-html-all`](./generators/legacy-html-all.md) | The single-page `all.html` bundle.  |
-| [`legacy-json`](./generators/legacy-json.md)         | The classic per-document JSON.      |
-| [`legacy-json-all`](./generators/legacy-json-all.md) | The single-file JSON bundle.        |
+| Target                                               | Output                         |
+| ---------------------------------------------------- | ------------------------------ |
+| [`legacy-json`](./generators/legacy-json.md)         | The classic per-document JSON. |
+| [`legacy-json-all`](./generators/legacy-json-all.md) | The single-file JSON bundle.   |
 
 ### Node.js-specific ([`@node-core/doc-kit`](./packages/node.md))
 

docs/getting-started.md

@@ -50,9 +50,7 @@ static server will do the trick; for example:
 npx serve out -p 3000
 ```
 
-Then open the printed URL (usually <http://localhost:3000>). The
-`legacy-html-all` output from earlier has no such requirement — `out/all.html`
-opens straight from disk.
+Then open the printed URL (usually <http://localhost:3000>).
 
 ## Customize the `html` generator output
 

docs/index.md

@@ -8,7 +8,7 @@ on [the OpenJS Slack][].
 
 A few places `doc-kit` is already in use. Feel free to PR yours.
 
-- <https://nodejs.org/api> - `legacy-html`, `legacy-json`
+- <https://nodejs.org/api> - `html`, `section-pages`, `legacy-json`
 - <https://nodejs.org/llms.txt> - `llms-txt`
 - <https://beta.docs.nodejs.org/> - `html`, `orama-db`, `llms-txt`
 - <https://nodejs.org/learn> - `html`, `orama-db`, `llms-txt`