From e664ec5e7ed932b13e4a0a6048121de3c65abe03 Mon Sep 17 00:00:00 2001
From: ubay1 <tomdelonge976@gmail.com>
Date: Fri, 22 May 2026 15:03:45 +0700
Subject: [PATCH 1/6] fix: remove redundant TOC picker from legacy HTML
 template.

Removed the `__TOC_PICKER__` placeholder from the template and its corresponding generation logic in `replaceTemplateValues.mjs` to prevent duplicate Table of Contents rendering.
---
 src/generators/legacy-html/template.html                   | 2 +-
 src/generators/legacy-html/utils/replaceTemplateValues.mjs | 3 +--
 2 files changed, 2 insertions(+), 3 deletions(-)

diff --git a/src/generators/legacy-html/template.html b/src/generators/legacy-html/template.html
index 0142fde1..7f6a7947 100644
--- a/src/generators/legacy-html/template.html
+++ b/src/generators/legacy-html/template.html
@@ -81,7 +81,7 @@ <h1>Node.js __VERSION__ documentation</h1>
           <div id="gtoc">
             <ul>
               <li class="pinned-header">Node.js __VERSION__</li>
-              __TOC_PICKER__ __GTOC_PICKER__ __ALTDOCS__
+              __GTOC_PICKER__ __ALTDOCS__
               <li class="picker-header">
                 <a href="#options-picker" aria-controls="options-picker">
                   <span class="picker-arrow"></span>
diff --git a/src/generators/legacy-html/utils/replaceTemplateValues.mjs b/src/generators/legacy-html/utils/replaceTemplateValues.mjs
index baec0754..3cb6ad32 100644
--- a/src/generators/legacy-html/utils/replaceTemplateValues.mjs
+++ b/src/generators/legacy-html/utils/replaceTemplateValues.mjs
@@ -1,7 +1,7 @@
 'use strict';
 
 import {
-  buildToC,
+  // buildToC,
   buildNavigation,
   buildVersions,
   buildGitHub,
@@ -31,7 +31,6 @@ export const replaceTemplateValues = (
     .replace(/__TOC__/g, tableOfContents.wrapToC(toc))
     .replace(/__GTOC__/g, nav)
     .replace('__CONTENT__', content)
-    .replace(/__TOC_PICKER__/g, buildToC(toc))
     .replace(/__GTOC_PICKER__/g, skipGtocPicker ? '' : buildNavigation(nav))
     .replace('__ALTDOCS__', buildVersions(path, added, config.changelog))
     .replace(

From ec8e8ee59296f504d61433d09a7dab40d31accbf Mon Sep 17 00:00:00 2001
From: ubay1 <tomdelonge976@gmail.com>
Date: Fri, 22 May 2026 15:11:07 +0700
Subject: [PATCH 2/6] remove unused buildToC import

---
 src/generators/legacy-html/utils/replaceTemplateValues.mjs | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/generators/legacy-html/utils/replaceTemplateValues.mjs b/src/generators/legacy-html/utils/replaceTemplateValues.mjs
index 3cb6ad32..1a0d8fae 100644
--- a/src/generators/legacy-html/utils/replaceTemplateValues.mjs
+++ b/src/generators/legacy-html/utils/replaceTemplateValues.mjs
@@ -1,7 +1,6 @@
 'use strict';
 
 import {
-  // buildToC,
   buildNavigation,
   buildVersions,
   buildGitHub,

From 35caceb54abbd5938a884ee9a9fbe544fe277b4c Mon Sep 17 00:00:00 2001
From: ubay1 <tomdelonge976@gmail.com>
Date: Sat, 23 May 2026 03:54:57 +0700
Subject: [PATCH 3/6] feat(legacy-html): add configurable index redirect
 support

- Added a new CLI flag: --index-redirect-url.
- Added redirect handling for generated index.html pages.
- Added a smart JavaScript redirect with a meta refresh fallback
- Replaced the hardcoded / header link with a configurable __HOME_LINK__ template value
---
 bin/commands/generate.mjs                     |  6 ++++++
 src/generators/legacy-html/index.mjs          |  1 +
 src/generators/legacy-html/template.html      |  5 +++--
 .../utils/replaceTemplateValues.mjs           | 20 +++++++++++++++++++
 src/utils/configuration/index.mjs             |  3 +++
 5 files changed, 33 insertions(+), 2 deletions(-)

diff --git a/bin/commands/generate.mjs b/bin/commands/generate.mjs
index d4586663..81dee2b0 100644
--- a/bin/commands/generate.mjs
+++ b/bin/commands/generate.mjs
@@ -56,6 +56,12 @@ export default new Command('generate')
   .addOption(new Option('-c, --changelog <url>', 'Changelog URL or path'))
   .addOption(new Option('--git-ref', 'Git ref URL'))
   .addOption(new Option('--index <url>', 'index.md URL or path'))
+  .addOption(
+    new Option(
+      '--index-redirect-url <url>',
+      'URL to redirect index.html to (legacy-html generator)'
+    )
+  )
   .addOption(new Option('--minify', 'Minify?'))
   .addOption(new Option('--type-map <url>', 'Type map URL or path'))
 
diff --git a/src/generators/legacy-html/index.mjs b/src/generators/legacy-html/index.mjs
index 32003ec1..6826ebd1 100644
--- a/src/generators/legacy-html/index.mjs
+++ b/src/generators/legacy-html/index.mjs
@@ -31,6 +31,7 @@ export default createLazyGenerator({
     ref: 'main',
     pageURL: '{baseURL}/latest-{version}/api{path}.html',
     editURL: `${GITHUB_EDIT_URL}/doc/api{path}.md`,
+    indexRedirectURL: '',
   },
 
   hasParallelProcessor: true,
diff --git a/src/generators/legacy-html/template.html b/src/generators/legacy-html/template.html
index 7f6a7947..7ef803f8 100644
--- a/src/generators/legacy-html/template.html
+++ b/src/generators/legacy-html/template.html
@@ -1,6 +1,7 @@
 <!doctype html>
 <html lang="en">
   <head>
+    __REDIRECT__
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width" />
     <link rel="icon" href="https://nodejs.org/favicon.ico" />
@@ -25,7 +26,7 @@
     <div id="content" class="clearfix">
       <div role="navigation" id="column2" class="interior">
         <div id="intro" class="interior">
-          <a href="/" title="Go back to the home page"> Node.js </a>
+          <a href="__HOME_LINK__" title="Go back to the home page"> Node.js </a>
         </div>
         <hr class="line" />
         __GTOC__
@@ -81,7 +82,7 @@ <h1>Node.js __VERSION__ documentation</h1>
           <div id="gtoc">
             <ul>
               <li class="pinned-header">Node.js __VERSION__</li>
-              __GTOC_PICKER__ __ALTDOCS__
+              __TOC_PICKER__ __GTOC_PICKER__ __ALTDOCS__
               <li class="picker-header">
                 <a href="#options-picker" aria-controls="options-picker">
                   <span class="picker-arrow"></span>
diff --git a/src/generators/legacy-html/utils/replaceTemplateValues.mjs b/src/generators/legacy-html/utils/replaceTemplateValues.mjs
index 1a0d8fae..ab835cc7 100644
--- a/src/generators/legacy-html/utils/replaceTemplateValues.mjs
+++ b/src/generators/legacy-html/utils/replaceTemplateValues.mjs
@@ -1,6 +1,7 @@
 'use strict';
 
 import {
+  buildToC,
   buildNavigation,
   buildVersions,
   buildGitHub,
@@ -22,7 +23,22 @@ export const replaceTemplateValues = (
   config,
   { skipGitHub = false, skipGtocPicker = false } = {}
 ) => {
+  const redirectMeta =
+    api === 'index' && config.indexRedirectURL
+      ? `<script>
+      let p = window.location.pathname;
+      let t = "${config.indexRedirectURL}";
+      if (!p.endsWith('/') && !p.split('/').pop().includes('.') && !p.endsWith('/index')) {
+        t = p + '/' + t;
+      }
+      window.location.replace(t);
+    </script>
+    <noscript><meta http-equiv="refresh" content="0; url=${config.indexRedirectURL}"></noscript>`
+      : '';
+
   return apiTemplate
+    .replace('__REDIRECT__', redirectMeta)
+    .replace('__HOME_LINK__', config.indexRedirectURL || '/')
     .replace('__ID__', api)
     .replace(/__FILENAME__/g, api)
     .replace('__SECTION__', section)
@@ -30,6 +46,10 @@ export const replaceTemplateValues = (
     .replace(/__TOC__/g, tableOfContents.wrapToC(toc))
     .replace(/__GTOC__/g, nav)
     .replace('__CONTENT__', content)
+    .replace(
+      /__TOC_PICKER__/g,
+      config.indexRedirectURL && api === 'index' ? '' : buildToC(toc)
+    )
     .replace(/__GTOC_PICKER__/g, skipGtocPicker ? '' : buildNavigation(nav))
     .replace('__ALTDOCS__', buildVersions(path, added, config.changelog))
     .replace(
diff --git a/src/utils/configuration/index.mjs b/src/utils/configuration/index.mjs
index 8323fe8d..fb17d997 100644
--- a/src/utils/configuration/index.mjs
+++ b/src/utils/configuration/index.mjs
@@ -101,6 +101,9 @@ export const createConfigFromCLIOptions = options => ({
   target: options.target,
   threads: options.threads,
   chunkSize: options.chunkSize,
+  'legacy-html': {
+    indexRedirectURL: options.indexRedirectUrl,
+  },
 });
 
 /**

From 4c0c5be20974de16954a5ff934cfe2fd01c4df8e Mon Sep 17 00:00:00 2001
From: ubay1 <tomdelonge976@gmail.com>
Date: Sat, 23 May 2026 04:19:37 +0700
Subject: [PATCH 4/6] fix: secure redirect script and fix absolute URL handling

---
 .../utils/replaceTemplateValues.mjs           | 20 ++++++++++++-------
 1 file changed, 13 insertions(+), 7 deletions(-)

diff --git a/src/generators/legacy-html/utils/replaceTemplateValues.mjs b/src/generators/legacy-html/utils/replaceTemplateValues.mjs
index ab835cc7..b30e9345 100644
--- a/src/generators/legacy-html/utils/replaceTemplateValues.mjs
+++ b/src/generators/legacy-html/utils/replaceTemplateValues.mjs
@@ -26,14 +26,20 @@ export const replaceTemplateValues = (
   const redirectMeta =
     api === 'index' && config.indexRedirectURL
       ? `<script>
-      let p = window.location.pathname;
-      let t = "${config.indexRedirectURL}";
-      if (!p.endsWith('/') && !p.split('/').pop().includes('.') && !p.endsWith('/index')) {
-        t = p + '/' + t;
-      }
-      window.location.replace(t);
+      (function() {
+        let p = window.location.pathname;
+        let targetUrl = ${JSON.stringify(config.indexRedirectURL)};
+
+        const isAbsolute = targetUrl.startsWith('http://') || targetUrl.startsWith('https://');
+
+        if (!isAbsolute && !p.endsWith('/') && !p.split('/').pop().includes('.') && !p.endsWith('/index')) {
+          targetUrl = p + '/' + targetUrl;
+        }
+
+        window.location.replace(targetUrl);
+      })();
     </script>
-    <noscript><meta http-equiv="refresh" content="0; url=${config.indexRedirectURL}"></noscript>`
+    <noscript><meta http-equiv="refresh" content="0; url=${config.indexRedirectURL.replace(/"/g, '&quot;')}"></noscript>`
       : '';
 
   return apiTemplate

From 0206b3b5d819dfbf6da33edf6341152017a07bc2 Mon Sep 17 00:00:00 2001
From: ubay1 <tomdelonge976@gmail.com>
Date: Sat, 23 May 2026 05:29:14 +0700
Subject: [PATCH 5/6] fix: secure redirect script and fix conditional config
 key

---
 .../legacy-html/utils/replaceTemplateValues.mjs           | 3 +--
 src/utils/configuration/index.mjs                         | 8 +++++---
 2 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/src/generators/legacy-html/utils/replaceTemplateValues.mjs b/src/generators/legacy-html/utils/replaceTemplateValues.mjs
index b30e9345..30442f53 100644
--- a/src/generators/legacy-html/utils/replaceTemplateValues.mjs
+++ b/src/generators/legacy-html/utils/replaceTemplateValues.mjs
@@ -38,8 +38,7 @@ export const replaceTemplateValues = (
 
         window.location.replace(targetUrl);
       })();
-    </script>
-    <noscript><meta http-equiv="refresh" content="0; url=${config.indexRedirectURL.replace(/"/g, '&quot;')}"></noscript>`
+    </script>`
       : '';
 
   return apiTemplate
diff --git a/src/utils/configuration/index.mjs b/src/utils/configuration/index.mjs
index fb17d997..207d504f 100644
--- a/src/utils/configuration/index.mjs
+++ b/src/utils/configuration/index.mjs
@@ -101,9 +101,11 @@ export const createConfigFromCLIOptions = options => ({
   target: options.target,
   threads: options.threads,
   chunkSize: options.chunkSize,
-  'legacy-html': {
-    indexRedirectURL: options.indexRedirectUrl,
-  },
+  ...(options.indexRedirectUrl && {
+    'legacy-html': {
+      indexRedirectURL: options.indexRedirectUrl,
+    },
+  }),
 });
 
 /**

From edff75fcd8263365bd0f0d5fdacb49c9d5939344 Mon Sep 17 00:00:00 2001
From: ubay1 <tomdelonge976@gmail.com>
Date: Sat, 23 May 2026 05:43:44 +0700
Subject: [PATCH 6/6] fix: redirect script mishandles root-relative URLs

---
 src/generators/legacy-html/utils/replaceTemplateValues.mjs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/generators/legacy-html/utils/replaceTemplateValues.mjs b/src/generators/legacy-html/utils/replaceTemplateValues.mjs
index 30442f53..2639bd87 100644
--- a/src/generators/legacy-html/utils/replaceTemplateValues.mjs
+++ b/src/generators/legacy-html/utils/replaceTemplateValues.mjs
@@ -30,7 +30,7 @@ export const replaceTemplateValues = (
         let p = window.location.pathname;
         let targetUrl = ${JSON.stringify(config.indexRedirectURL)};
 
-        const isAbsolute = targetUrl.startsWith('http://') || targetUrl.startsWith('https://');
+        const isAbsolute = targetUrl.startsWith('http://') || targetUrl.startsWith('https://') || targetUrl.startsWith('/');
 
         if (!isAbsolute && !p.endsWith('/') && !p.split('/').pop().includes('.') && !p.endsWith('/index')) {
           targetUrl = p + '/' + targetUrl;