refactor(legacy): extract @nodejs/doc-kit-legacy package

[avivkeller]

The legacy-format generators (legacy-html, legacy-html-all, legacy-json, and legacy-json-all) have moved into the new @nodejs/doc-kit-legacy package, and are loaded via import specifiers such as @nodejs/doc-kit-legacy/legacy-html.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
api-docs-tooling	Ready	Preview	Aug 3, 2026 5:02pm

[cursor]

PR Summary

Medium Risk
Breaking change for anyone importing @node-core/doc-kit/legacy-* directly; monorepo consumers must add @nodejs/doc-kit-legacy. Generator behavior is largely a move with import path changes, so runtime risk is moderate if workspace linking and versions are correct.

Overview
Legacy-format generators (legacy-html, legacy-html-all, legacy-json, legacy-json-all) are moved from @node-core/doc-kit into a new @nodejs/doc-kit-legacy package. CLI shorthand names (legacy-html, etc.) still resolve through publicGenerators, but they now point at @nodejs/doc-kit-legacy/* instead of @node-core/doc-kit/*.

@node-core/doc-kit drops the four ./legacy-* package exports and removes legacyToJSON from utils/generators.mjs (tests moved to legacy). parseList’s section JSDoc is generalized so core no longer references legacy-json types.

packages/legacy holds the moved generator code, depends on @node-core/doc-kit for shared utilities, and exports the four generators. legacyToJSON lives in packages/legacy/src/utils/legacyToJSON.mjs. Tooling paths update (e.g. .c8rc.json, ESLint browser globals for legacy HTML assets).

^{Reviewed by Cursor Bugbot for commit 2fdc942. Bugbot is set up for automated code reviews on this repo. Configure here.}

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 89.65%. Comparing base (137230e) to head (2fdc942).

Additional details and impacted files

@@                  Coverage Diff                   @@
##           refactor/react-kitten     #960   +/-   ##
======================================================
  Coverage                  89.64%   89.65%           
======================================================
  Files                        198      200    +2     
  Lines                      18480    18493   +13     
  Branches                    1727     1729    +2     
======================================================
+ Hits                       16566    16579   +13     
  Misses                      1907     1907           
  Partials                       7        7           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[ovflowd]

The legacy-format generators (legacy-html, legacy-html-all, legacy-json, and legacy-json-all) have moved into the new @doc-kittens/legacy package, and are loaded via import specifiers such as @doc-kittens/legacy/legacy-html.

nit: can we name it @doc-kittens/legacy-nodejs? (also fine w/ current)

[cursor]

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 0f93e3d. Configure here.}

[Copilot]

Pull request overview

Copilot reviewed 26 out of 45 changed files in this pull request and generated 1 comment.

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.