build, doc: move to redesign

Signed-off-by: avivkeller <me@aviv.sh>

Author: avivkeller

.github/workflows/build-tarball.yml

@@ -65,6 +65,7 @@ env:
   PYTHON_VERSION: '3.14'
   FLAKY_TESTS: keep_retrying
   CLANG_VERSION: '19'
+  NODE_VERSION: lts/*
 
 permissions:
   contents: read
@@ -82,6 +83,10 @@ jobs:
         with:
           python-version: ${{ env.PYTHON_VERSION }}
           allow-prereleases: true
+      - name: Use Node.js ${{ env.NODE_VERSION }}
+        uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e  # v6.4.0
+        with:
+          node-version: ${{ env.NODE_VERSION }}
       - name: Environment Information
         run: npx envinfo@7.21.0
       - name: Make tarball

Makefile

@@ -856,7 +856,7 @@ VERSION=v$(RAWVER)
 
 .PHONY: doc-only
 .NOTPARALLEL: doc-only
-doc-only: $(apidoc_dirs) $(apidocs_html) $(apidocs_json) out/doc/api/all.html out/doc/api/all.json out/doc/llms.txt out/doc/apilinks.json  ## Builds the docs with the local or the global Node.js binary.
+doc-only: $(apidoc_dirs) $(apidocs_html) $(apidocs_json) out/doc/api/all.json out/doc/apilinks.json  ## Builds the docs with the local or the global Node.js binary.
 
 .PHONY: doc
 doc: $(NODE_EXE) doc-only ## Build Node.js, and then build the documentation with the new binary.
@@ -871,49 +871,15 @@ out/doc/api: doc/api
 	mkdir -p $@
 	cp -r doc/api out/doc
 
-# Generate all doc files (individual and all.html/all.json) in a single doc-kit call
-# Using grouped targets (&:) so Make knows one command produces all outputs
-ifeq ($(OSTYPE),aix)
-# TODO(@nodejs/web-infra): AIX is currently hanging during HTML minification
-$(apidocs_html) $(apidocs_json) out/doc/api/all.html out/doc/api/all.json:
-	@echo "Skipping $@ (not currently supported by $(OSTYPE) machines)"
-else ifeq ($(OSTYPE),os400)
-# TODO(@nodejs/web-infra): IBMi is currently hanging during HTML minification
-$(apidocs_html) $(apidocs_json) out/doc/api/all.html out/doc/api/all.json:
-	@echo "Skipping $@ (not currently supported by $(OSTYPE) machines)"
-else
-$(apidocs_html) $(apidocs_json) out/doc/api/all.html out/doc/api/all.json &: $(apidoc_sources) tools/doc/node_modules | out/doc/api
+$(apidocs_html) $(apidocs_json) out/doc/api/all.json &: $(apidoc_sources) tools/doc/node_modules | out/doc/api
 	@if [ "$(shell $(node_use_openssl_and_icu))" != "true" ]; then \
 		echo "Skipping $@ (no crypto and/or no ICU)"; \
 	else \
 		$(call available-node, \
 			$(DOC_KIT) generate \
-			-t legacy-html-all \
-			-t legacy-json-all \
-			-i doc/api/*.md \
-			--ignore $(skip_apidoc_files) \
-			-o out/doc/api \
-			-c ./CHANGELOG.md \
+			--config-file tools/doc/web.doc-kit.config.mjs \
 			-v $(VERSION) \
-			--index doc/api/index.md \
-			--type-map doc/type-map.json \
-		) \
-	fi
-endif
-
-out/doc/llms.txt: $(apidoc_sources) tools/doc/node_modules | out/doc
-	@if [ "$(shell $(node_use_openssl_and_icu))" != "true" ]; then \
-		echo "Skipping $@ (no crypto and/or no ICU)"; \
-	else \
-		$(call available-node, \
-			$(DOC_KIT) generate \
-			-t llms-txt \
-			-i doc/api/*.md \
-			--ignore $(skip_apidoc_files) \
-			-o $(@D) \
-			-c ./CHANGELOG.md \
-			-v $(VERSION) \
-			--type-map doc/type-map.json \
+			$(if $(JOBS),-p $(JOBS)) \
 		) \
 	fi