Version Packages

[github-actions]

This PR was opened by the Changesets release GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to main, this PR will be updated.

Releases

@nodejs/doc-kit@1.0.0

Major Changes

• #961 c334823 Thanks @avivkeller! - The doc-kit engine and CLI, previously published as @node-core/doc-kit,
  are now published as @nodejs/doc-kit. The @node-core/doc-kit name now
  contains only the Node.js-specific generators (api-links, addon-verify,
  and man-page).

• #960 c734403 Thanks @avivkeller! - The legacy-format generators (legacy-html, legacy-html-all,
  legacy-json, and legacy-json-all) now live in the new
  @nodejs/doc-kit-generator-legacy package and are loaded via import specifiers such
  as @nodejs/doc-kit-generator-legacy/legacy-html. The corresponding
  @nodejs/doc-kit/* package exports have been removed. The CLI shorthand
  names are unchanged.

• #961 c334823 Thanks @avivkeller! - The Node.js-specific generators (api-links, addon-verify, and
  man-page) now live in the @node-core/doc-kit package and are loaded
  via import specifiers such as @node-core/doc-kit/man-page. The
  corresponding package exports have been removed from the doc-kit engine.
  The CLI shorthand names are unchanged.

• #959 ca36039 Thanks @avivkeller! - The React/JSX-based generators (html — previously web —, jsx-ast,
  llms-txt, sitemap, and orama-db) now live in the new
  @nodejs/doc-kit-generator-react package and are loaded via import specifiers such as
  @nodejs/doc-kit-generator-react/html. The corresponding @nodejs/doc-kit/*
  package exports have been removed. The web generator is renamed to html:
  the CLI shorthand web keeps working as a deprecated alias, but the
  configuration key is now html instead of web.

Minor Changes

• #939 7bd1b5b Thanks @avivkeller! - Discover and load configuration files with cosmiconfig.

• #911 ada6540 Thanks @avivkeller! - Add banner opt-out

• #958 0bd347d Thanks @avivkeller! - Generators are now loaded dynamically by import specifier instead of a static
  registry. --target accepts either a built-in shorthand name (web,
  legacy-html, …) or any import specifier resolving to a generator module
  (e.g. some-package/generator or ./my-generator.mjs), and a generator's
  dependsOn is now a full import specifier. This lays the groundwork for
  splitting the built-in generators into separate packages and enables
  third-party generator packages.

• #937 43a09f7 Thanks @avivkeller! - Make the web generator bundler-neutral through a custom adapter contract,
  with Vite 8.1 provided as the default adapter.

Patch Changes

• #964 96e1c26 Thanks @avivkeller! - Add web.navigation, which supplies the sidebar groups (navigation.sidebar)
  and the navigation bar items (navigation.navbar) from configuration.

• #955 b80958f Thanks @avivkeller! - Close Orama search when the target link is on the same page

• #968 d3306a2 Thanks @pimterry! - Resolve unions and arrays of display-name types ({HTTP/2 Headers Object | vm.Module}, {HTTP/2 Headers Object[]}), and stop capturing prose such as U+007B ({), and U+007D (}). as a type annotation.

• #889 68751af Thanks @bmuenzenmeyer! - Fix relative() URL resolution when the target path is a prefix of the current
  page's path (e.g. /generators from /generators/web): the target's final
  segment was consumed as a common directory, producing . instead of
  ../generators. Unreachable in flat page layouts; surfaced by sites with
  nested input directories.

• #945 70b7526 Thanks @avivkeller! - Moved the package into a packages/core workspace.

• #946 9ab2840 Thanks @btea! - Fix missing spaces in the riscv64 multithreading warning message, which
  previously concatenated as "failures whenallocating" and "spaceon riscv64".

• #933 b73b704 Thanks @vsolano9! - Use short DEP codes for deprecation heading anchors.

• #942 cef45ca Thanks @btea! - Space union separators in type annotation values ({string|URL} is now rendered as string | URL).

• #934 e6f1769 Thanks @avivkeller! - Switches oxc-parser for @swc/wasm, since oxc-parser does not provide the needed bindings.

• #919 d0f0de0 Thanks @MFA-G! - Preserve deprecation codes in generated table-of-contents labels.

• #963 2f9defe Thanks @btea! - Sync the URL hash when following same-page search hits

• #955 b80958f Thanks @avivkeller! - Render markdown code snippets in the sidebar

• Updated dependencies [c734403, c334823, ca36039]:

  • @nodejs/doc-kit-generator-legacy@1.0.0
  • @node-core/doc-kit@2.0.0
  • @nodejs/doc-kit-generator-react@0.1.0

@nodejs/doc-kit-generator-legacy@1.0.0

Major Changes

• #960 c734403 Thanks @avivkeller! - The legacy-format generators (legacy-html, legacy-html-all,
  legacy-json, and legacy-json-all) now live in the new
  @nodejs/doc-kit-generator-legacy package and are loaded via import specifiers such
  as @nodejs/doc-kit-generator-legacy/legacy-html. The corresponding
  @nodejs/doc-kit/* package exports have been removed. The CLI shorthand
  names are unchanged.

Patch Changes

• Updated dependencies [96e1c26, 7bd1b5b, b80958f, d3306a2, c334823, 68751af, c734403, 70b7526, c334823, ada6540, ca36039, 9ab2840, b73b704, cef45ca, 0bd347d, e6f1769, d0f0de0, 2f9defe, 43a09f7, b80958f]:
  • @nodejs/doc-kit@1.0.0

@node-core/doc-kit@2.0.0

Major Changes

• #961 c334823 Thanks @avivkeller! - The Node.js-specific generators (api-links, addon-verify, and
  man-page) now live in the @node-core/doc-kit package and are loaded
  via import specifiers such as @node-core/doc-kit/man-page. The
  corresponding package exports have been removed from the doc-kit engine.
  The CLI shorthand names are unchanged.

Patch Changes

• Updated dependencies [96e1c26, 7bd1b5b, b80958f, d3306a2, c334823, 68751af, c734403, 70b7526, c334823, ada6540, ca36039, 9ab2840, b73b704, cef45ca, 0bd347d, e6f1769, d0f0de0, 2f9defe, 43a09f7, b80958f]:
  • @nodejs/doc-kit@1.0.0

@nodejs/doc-kit-generator-react@0.1.0

Minor Changes

• #959 ca36039 Thanks @avivkeller! - The React/JSX-based generators (html — previously web —, jsx-ast,
  llms-txt, sitemap, and orama-db) now live in the new
  @nodejs/doc-kit-generator-react package and are loaded via import specifiers such as
  @nodejs/doc-kit-generator-react/html. The corresponding @nodejs/doc-kit/*
  package exports have been removed. The web generator is renamed to html:
  the CLI shorthand web keeps working as a deprecated alias, but the
  configuration key is now html instead of web.

Patch Changes

• Updated dependencies [96e1c26, 7bd1b5b, b80958f, d3306a2, c334823, 68751af, c734403, 70b7526, c334823, ada6540, ca36039, 9ab2840, b73b704, cef45ca, 0bd347d, e6f1769, d0f0de0, 2f9defe, 43a09f7, b80958f]:
  • @nodejs/doc-kit@1.0.0

[vercel]

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

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

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
nodejs-doc-kit	Ignored	Preview	Aug 4, 2026 3:19pm

[cursor]

PR Summary

Medium Risk
Merging publishes major semver bumps and package name/export moves to npm; downstream installs must align package names and generator import paths even though this PR only updates metadata.

Overview
This is an automated Changesets release PR: it applies accumulated changesets by bumping versions, writing CHANGELOG entries, and removing the consumed .changeset/*.md files (no new runtime source changes in the diff).

@nodejs/doc-kit goes to 1.0.0 with peer deps on @node-core/doc-kit@^2.0.0, @nodejs/doc-kit-generator-legacy@^1.0.0, and @nodejs/doc-kit-generator-react@^0.1.0. @nodejs/doc-kit-generator-legacy is 1.0.0, @node-core/doc-kit is 2.0.0, and @nodejs/doc-kit-generator-react is 0.1.0, each depending on @nodejs/doc-kit@^1.0.0.

The changelog text documents the prior architectural work: engine published as @nodejs/doc-kit, generators split into legacy/react/node packages with dynamic import loading, web → html config, cosmiconfig, and assorted doc/UI fixes bundled into these version lines.

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

[avivkeller]

I'm going to land this just before RenderATL so they get the tip-of-the-tree