feat: support the Alpha release phase

.changeset/brave-alpha-releases.md

@@ -0,0 +1,5 @@
+---
+'@node-core/website-i18n': patch
+---
+
+Add the Alpha release warning.

apps/site/app/[locale]/download/archive/[version]/page.tsx

@@ -51,7 +51,10 @@ const getPage: FC<PageParams> = async props => {
   if (version === 'current') {
     const releaseData = await provideReleaseData();
 
-    const release = releaseData.find(release => release.status === 'Current');
+    // There's no Current release while the next major is in its Alpha phase
+    const release =
+      releaseData.find(release => release.status === 'Current') ??
+      releaseData.find(release => release.status === 'LTS');
 
     redirect(`/${locale}/download/archive/${release?.versionWithPrefix}`);
   }

apps/site/components/Downloads/Release/VersionDropdown.tsx

@@ -27,7 +27,10 @@ const VersionDropdown: FC = () => {
       ({ versionWithPrefix }) => versionWithPrefix === version
     );
 
-    if (release?.status === 'LTS' && pathname.includes('current')) {
+    if (
+      release?.status === 'LTS' &&
+      (pathname.includes('current') || pathname.includes('alpha'))
+    ) {
       redirect({ href: '/download', locale });
       return;
     }
@@ -37,6 +40,11 @@ const VersionDropdown: FC = () => {
       return;
     }
 
+    if (release?.status === 'Alpha' && !pathname.includes('alpha')) {
+      redirect({ href: '/download/alpha', locale });
+      return;
+    }
+
     setVersion(version);
   };
 

apps/site/components/withDownloadSection.tsx

@@ -9,7 +9,7 @@ import {
   ReleasesProvider,
 } from '#site/providers/releaseProvider';
 
-import type { NodeRelease } from '../types';
+import type { NodeRelease, NodeReleaseStatus } from '../types';
 import type { FC, PropsWithChildren } from 'react';
 
 type WithDownloadSectionProps = PropsWithChildren<{
@@ -39,7 +39,11 @@ const WithDownloadSection: FC<WithDownloadSectionProps> = async ({
     .concat(localeSnippets);
 
   // Decides which initial release to use based on the current pathname
-  const initialRelease = pathname.endsWith('/current') ? 'Current' : 'LTS';
+  const initialRelease: Array<NodeReleaseStatus> = pathname.endsWith('/alpha')
+    ? ['Alpha', 'Current', 'LTS']
+    : pathname.endsWith('/current')
+      ? ['Current', 'LTS']
+      : ['LTS'];
 
   return (
     <WithNodeRelease status={initialRelease}>

apps/site/components/withReleaseAlertBox.tsx

@@ -26,6 +26,22 @@ const WithReleaseAlertBox: FC<WithReleaseAlertBoxProps> = ({ status }) => {
           })}
         </AlertBox>
       );
+    case 'Alpha':
+      return (
+        <AlertBox
+          title={t('components.common.alertBox.warning')}
+          level="warning"
+          size="small"
+        >
+          {t.rich('layouts.download.codeBox.alphaVersionWarning', {
+            link: text => (
+              <Link href="/blog/announcements/evolving-the-nodejs-release-schedule">
+                {text}
+              </Link>
+            ),
+          })}
+        </AlertBox>
+      );
     case 'LTS':
       return (
         <AlertBox

apps/site/next-data/generators/__tests__/majorNodeReleases.test.mjs

@@ -0,0 +1,100 @@
+import assert from 'node:assert/strict';
+import { describe, it } from 'node:test';
+
+import getMajorNodeReleases from '#site/next-data/generators/majorNodeReleases.mjs';
+
+const createRelease = (version, date, lts = false) => ({
+  version,
+  date,
+  files: [],
+  npm: '11.0.0',
+  v8: '14.0.0.0',
+  modules: '150',
+  lts,
+  security: false,
+});
+
+const SCHEDULE = {
+  v26: {
+    start: '2026-05-05',
+    lts: '2026-10-28',
+    maintenance: '2027-10-20',
+    end: '2029-04-30',
+    codename: '',
+  },
+  v27: {
+    alpha: '2026-10-28',
+    start: '2027-04-22',
+    lts: '2027-10-20',
+    end: '2030-04-30',
+    codename: '',
+  },
+};
+
+const mockFetch = (index, schedule = SCHEDULE) => {
+  globalThis.fetch = async url => ({
+    json: async () => (url.includes('schedule') ? schedule : index),
+  });
+};
+
+describe('getMajorNodeReleases', () => {
+  it('keeps the pre-release identifiers of Alpha releases', async () => {
+    mockFetch([
+      createRelease('v27.0.0-alpha.1.0.0', '2026-11-25'),
+      createRelease('v27.0.0-alpha.0.0.0', '2026-10-28'),
+      createRelease('v26.1.0', '2026-10-28', 'Codename'),
+    ]);
+
+    const majors = await getMajorNodeReleases();
+
+    assert.deepEqual(
+      majors.map(([version]) => version),
+      ['v27', 'v26']
+    );
+
+    const [, v27] = majors[0];
+
+    assert.deepEqual(Object.keys(v27.releases), [
+      'v27.0.0-alpha.1.0.0',
+      'v27.0.0-alpha.0.0.0',
+    ]);
+    assert.equal(
+      v27.releases['v27.0.0-alpha.1.0.0'].semver.raw,
+      '27.0.0-alpha.1.0.0'
+    );
+    assert.equal(v27.releases['v27.0.0-alpha.1.0.0'].semver.major, 27);
+    assert.equal(v27.releases['v27.0.0-alpha.1.0.0'].lts.isLts, false);
+    assert.equal(v27.support.phases.dates.end, '2030-04-30');
+  });
+
+  it('lists Alpha releases after the stable releases of the same line', async () => {
+    mockFetch([
+      createRelease('v27.0.0', '2027-04-22'),
+      createRelease('v27.0.0-alpha.1.0.0', '2026-11-25'),
+      createRelease('v27.0.0-alpha.0.0.0', '2026-10-28'),
+    ]);
+
+    const [[version, v27]] = await getMajorNodeReleases();
+
+    assert.equal(version, 'v27');
+    assert.deepEqual(Object.keys(v27.releases), [
+      'v27.0.0',
+      'v27.0.0-alpha.1.0.0',
+      'v27.0.0-alpha.0.0.0',
+    ]);
+  });
+
+  it('ignores Alpha releases of release lines without documented support', async () => {
+    mockFetch([
+      createRelease('v28.0.0-alpha.0.0.0', '2027-10-27'),
+      createRelease('v26.1.0', '2026-10-28', 'Codename'),
+    ]);
+
+    const majors = await getMajorNodeReleases();
+
+    assert.deepEqual(
+      majors.map(([version]) => version),
+      ['v26']
+    );
+  });
+});

apps/site/next-data/generators/__tests__/releaseData.test.mjs

@@ -130,6 +130,74 @@ describe('generateReleaseData', () => {
     assert.equal(result[0]?.status, 'Current');
   });
 
+  it('returns Alpha when release is not EOL and latest is a pre-release', async t => {
+    const result = await runWithNodevuData(t, '2026-11-01', {
+      27: {
+        releases: {
+          'v27.0.0-alpha.0.0.0': {
+            semver: { major: 27, raw: '27.0.0-alpha.0.0.0' },
+            dependencies: { npm: '11.6.0', v8: '14.6.0.0' },
+            lts: { isLts: false },
+            releaseDate: '2026-10-28',
+            modules: { version: '150' },
+          },
+        },
+        support: {
+          phases: {
+            dates: {
+              alpha: '2026-10-28',
+              start: '2027-04-22',
+              maintenance: '2027-10-20',
+              end: '2030-04-30',
+            },
+          },
+        },
+      },
+    });
+
+    assert.equal(result[0]?.status, 'Alpha');
+    assert.equal(result[0]?.versionWithPrefix, 'v27.0.0-alpha.0.0.0');
+  });
+
+  it('returns Current when latest is a stable release following pre-releases', async t => {
+    const result = await runWithNodevuData(t, '2027-04-22', {
+      27: {
+        releases: {
+          'v27.0.0': {
+            semver: { major: 27, raw: '27.0.0' },
+            dependencies: { npm: '11.6.0', v8: '14.6.0.0' },
+            lts: { isLts: false },
+            releaseDate: '2027-04-22',
+            modules: { version: '150' },
+          },
+          'v27.0.0-alpha.0.0.0': {
+            semver: { major: 27, raw: '27.0.0-alpha.0.0.0' },
+            dependencies: { npm: '11.6.0', v8: '14.6.0.0' },
+            lts: { isLts: false },
+            releaseDate: '2026-10-28',
+            modules: { version: '150' },
+          },
+        },
+        support: {
+          phases: {
+            dates: {
+              alpha: '2026-10-28',
+              start: '2027-04-22',
+              maintenance: '2027-10-20',
+              end: '2030-04-30',
+            },
+          },
+        },
+      },
+    });
+
+    assert.equal(result[0]?.status, 'Current');
+    assert.equal(
+      result[0]?.minorVersions[1]?.versionWithPrefix,
+      'v27.0.0-alpha.0.0.0'
+    );
+  });
+
   it('uses latest and earliest release dates for latestReleaseDate and initialReleaseDate', async t => {
     const result = await runWithNodevuData(t, '2026-04-14', {
       26: {

apps/site/next-data/generators/majorNodeReleases.mjs

@@ -1,14 +1,69 @@
 'use strict';
 
 import nodevu from '@nodevu/core';
+import semVer from 'semver';
 
 import { fetchWithRetry } from '#site/next.fetch.mjs';
 
+const toNodevuRelease = ({ version, date, npm, v8, modules, lts }) => {
+  const { version: raw, major, minor, patch } = semVer.parse(version);
+
+  return {
+    semver: { raw, major, minor, patch, line: `v${major}` },
+    releaseDate: date,
+    modules: { version: modules },
+    dependencies: { npm, v8 },
+    lts: { isLts: !!lts },
+  };
+};
+
 /**
  * Filters Node.js release data to return only major releases with documented support.
  */
 export default async function getMajorNodeReleases() {
-  const nodevuData = await nodevu({ fetch: fetchWithRetry });
+  const preReleases = [];
+  let schedule = {};
+
+  // nodevu coerces versions (v27.0.0-alpha.0.0.0 becomes v27.0.0), hence
+  // pre-releases are removed before nodevu parses index.json and added back
+  const fetchWithoutPreReleases = async (url, options) => {
+    const data = await fetchWithRetry(url, options).then(r => r.json());
+
+    if (!Array.isArray(data)) {
+      schedule = data;
+
+      return Response.json(data);
+    }
+
+    preReleases.push(
+      ...data.filter(({ version }) => semVer.prerelease(version))
+    );
+
+    return Response.json(data.filter(r => !preReleases.includes(r)));
+  };
+
+  const releaseLines = await nodevu({ fetch: fetchWithoutPreReleases });
+
+  const preReleaseLines = {};
+
+  preReleases.forEach(release => {
+    const line = `v${semVer.major(release.version)}`;
+
+    if (!releaseLines[line] && !preReleaseLines[line]) {
+      const { codename, ...dates } = schedule[line] ?? {};
+
+      preReleaseLines[line] = {
+        releases: {},
+        support: schedule[line] && { codename, phases: { dates } },
+      };
+    }
+
+    const { releases } = releaseLines[line] ?? preReleaseLines[line];
+
+    releases[release.version] = toNodevuRelease(release);
+  });
+
+  const nodevuData = { ...preReleaseLines, ...releaseLines };
 
   return Object.entries(nodevuData).filter(([version, { support }]) => {
     // Filter out those without documented support

apps/site/next-data/generators/releaseData.mjs

@@ -1,5 +1,7 @@
 'use strict';
 
+import semVer from 'semver';
+
 import getMajorNodeReleases from './majorNodeReleases.mjs';
 
 // Gets the appropriate release status for each major release
@@ -14,6 +16,10 @@ const getNodeReleaseStatus = (latest, eol) => {
     return 'LTS';
   }
 
+  if (semVer.prerelease(latest.semver.raw)) {
+    return 'Alpha';
+  }
+
   return 'Current';
 };
 

apps/site/next.constants.mjs

@@ -145,6 +145,7 @@ export const STATUS_KIND_MAP = {
   EOL: 'warning',
   LTS: 'info',
   Current: 'default',
+  Alpha: 'default',
 };
 
 /**