create-docusaurus 3.10.2 → 4.0.0-canary-6809

package/README.md

@@ -54,3 +54,32 @@ yarn typecheck
 yarn build
 yarn start
 ```
+
+### End-to-end tests
+
+To run end-to-end tests similar to our CI workflows, publishing monorepo packages to a local Verdaccio repository inside Docker.
+
+**Important**: this modifies `package.json` files before publish, so make sure to commit your work first!
+
+```bash
+cd `git rev-parse --show-toplevel` # Back to repo root
+pnpm install
+
+docker rm -f verdaccio
+pnpm test:build:website -st
+
+cd ../test-website # website is generated outside of the monorepo
+
+cat > pnpm-workspace.yaml <<'YAML'
+strictDepBuilds: true
+allowBuilds:
+  '@swc/core': false
+  core-js: false
+YAML
+
+pnpm_config_registry=http://localhost:4873 pnpm install
+
+pnpm run typecheck
+pnpm start --no-open
+pnpm run build --locale en --locale fr
+```

package/bin/index.js

@@ -15,7 +15,7 @@ import {logger} from '@docusaurus/logger';
 import semver from 'semver';
 import {program} from 'commander';
 
-const packageJson = /** @type {import("../package.json")} */ (
+const packageJson = /** @type {typeof import("../package.json")} */ (
   createRequire(import.meta.url)('../package.json')
 );
 const requiredVersion = packageJson.engines.node;

package/lib/commands.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { type PackageManager, type Source } from './constants.js';
+export declare function getAvailablePackageManagers(): Promise<PackageManager[]>;
+export declare function runPackageManagerInstallCommand(pkgManager: PackageManager): Promise<boolean>;
+export declare function runGitCloneCommand(source: Source & {
+    type: 'git';
+}, dest: string): Promise<boolean>;

package/lib/commands.js

@@ -0,0 +1,76 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+// We use cross-spawn instead of spawn because of Windows compatibility issues.
+// For example, "yarn" doesn't work on Windows, it requires "yarn.cmd"
+import crossSpawn from 'cross-spawn';
+import supportsColor from 'supports-color';
+import { PackageManagers, } from './constants.js';
+import { askForCustomGitCloneCommand } from './prompts.js';
+/**
+ * Run a command, similar to execa(cmd,args) but simpler
+ * @param command
+ * @param args
+ * @param options
+ * @returns the command exit code
+ */
+async function runCommand(command, args = [], options = {}) {
+    // This does something similar to execa.command()
+    // we split a string command (with optional args) into command+args
+    // this way it's compatible with spawn()
+    const [realCommand, ...baseArgs] = command.split(' ');
+    const allArgs = [...baseArgs, ...args];
+    if (!realCommand) {
+        throw new Error(`Invalid command: ${command}`);
+    }
+    return new Promise((resolve, reject) => {
+        const p = crossSpawn(realCommand, allArgs, { stdio: 'ignore', ...options });
+        p.on('error', reject);
+        p.on('close', (exitCode) => exitCode !== null
+            ? resolve(exitCode)
+            : reject(new Error(`No exit code for command ${command}`)));
+    });
+}
+async function hasPackageManager(packageManager) {
+    return (await runCommand(packageManager, ['--version'])) === 0;
+}
+export async function getAvailablePackageManagers() {
+    const list = await Promise.all(PackageManagers.map(async (name) => {
+        return (await hasPackageManager(name)) ? name : null;
+    }));
+    return list.filter((item) => item !== null);
+}
+export async function runPackageManagerInstallCommand(pkgManager) {
+    const installCommand = pkgManager === 'yarn'
+        ? 'yarn'
+        : pkgManager === 'bun'
+            ? 'bun install'
+            : `${pkgManager} install --color always`;
+    return ((await runCommand(installCommand, [], {
+        env: {
+            ...process.env,
+            // Force coloring the output
+            ...(supportsColor.stdout ? { FORCE_COLOR: '1' } : {}),
+        },
+    })) === 0);
+}
+async function getGitCloneCommand(gitStrategy) {
+    switch (gitStrategy) {
+        case 'shallow':
+        case 'copy':
+            return 'git clone --recursive --depth 1';
+        case 'custom': {
+            return askForCustomGitCloneCommand();
+        }
+        case 'deep':
+        default:
+            return 'git clone';
+    }
+}
+export async function runGitCloneCommand(source, dest) {
+    const gitCommand = await getGitCloneCommand(source.strategy);
+    return (await runCommand(gitCommand, [source.url, dest])) === 0;
+}

package/lib/constants.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+export declare const DefaultPackageManager = "npm";
+export declare const LockfileNames: {
+    npm: string;
+    yarn: string;
+    pnpm: string;
+    bun: string;
+};
+export type PackageManager = keyof typeof LockfileNames;
+export declare const PackageManagers: PackageManager[];
+export declare const GitCloneStrategies: readonly ['deep', 'shallow', 'copy', 'custom'];
+export type GitCloneStrategy = (typeof GitCloneStrategies)[number];
+export type Template = {
+    name: string;
+    path: string;
+    tsVariantPath: string | undefined;
+};
+export type Source = {
+    type: 'template';
+    template: Template;
+    language: 'javascript' | 'typescript';
+} | {
+    type: 'git';
+    url: string;
+    strategy: GitCloneStrategy;
+} | {
+    type: 'local';
+    path: string;
+};

package/lib/constants.js

@@ -0,0 +1,23 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+// Only used in the rare, rare case of running globally installed create +
+// using --skip-install. We need a default name to show the tip text
+export const DefaultPackageManager = 'npm';
+// Order matters
+export const LockfileNames = {
+    npm: 'package-lock.json',
+    yarn: 'yarn.lock',
+    pnpm: 'pnpm-lock.yaml',
+    bun: 'bun.lockb',
+};
+export const PackageManagers = Object.keys(LockfileNames);
+export const GitCloneStrategies = [
+    'deep',
+    'shallow',
+    'copy',
+    'custom',
+];

package/lib/index.d.ts

@@ -4,6 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
+import { type PackageManager, type GitCloneStrategy } from './constants.js';
 type LanguagesOptions = {
     javascript?: boolean;
     typescript?: boolean;
@@ -11,16 +12,7 @@ type LanguagesOptions = {
 type CLIOptions = LanguagesOptions & {
     packageManager?: PackageManager;
     skipInstall?: boolean;
-    gitStrategy?: GitStrategy;
+    gitStrategy?: GitCloneStrategy;
 };
-declare const lockfileNames: {
-    npm: string;
-    yarn: string;
-    pnpm: string;
-    bun: string;
-};
-type PackageManager = keyof typeof lockfileNames;
-declare const gitStrategies: readonly ["deep", "shallow", "copy", "custom"];
-type GitStrategy = (typeof gitStrategies)[number];
 export default function init(rootDir: string, reqName?: string, reqTemplate?: string, cliOptions?: CLIOptions): Promise<void>;
 export {};

package/lib/index.js

@@ -12,8 +12,9 @@ import path from 'node:path';
 // TODO try to remove these third-party dependencies if possible
 import { logger } from '@docusaurus/logger';
 import prompts from 'prompts';
-import supportsColor from 'supports-color';
-import { runCommand, siteNameToPackageName } from './utils.js';
+import { LockfileNames, PackageManagers, DefaultPackageManager, GitCloneStrategies, } from './constants.js';
+import { getAvailablePackageManagers, runGitCloneCommand, runPackageManagerInstallCommand, } from './commands.js';
+import { siteNameToPackageName, updatePkg, pathExists, printPackageManagerHelp, } from './utils.js';
 import { askPreferredLanguage } from './prompts.js';
 async function getLanguage(options) {
     if (options.typescript) {
@@ -24,25 +25,9 @@ async function getLanguage(options) {
     }
     return askPreferredLanguage();
 }
-// Only used in the rare, rare case of running globally installed create +
-// using --skip-install. We need a default name to show the tip text
-const defaultPackageManager = 'npm';
-const lockfileNames = {
-    npm: 'package-lock.json',
-    yarn: 'yarn.lock',
-    pnpm: 'pnpm-lock.yaml',
-    bun: 'bun.lockb',
-};
-const packageManagers = Object.keys(lockfileNames);
-function pathExists(filePath) {
-    return fs
-        .access(filePath, fs.constants.F_OK)
-        .then(() => true)
-        .catch(() => false);
-}
 async function findPackageManagerFromLockFile(rootDir) {
-    for (const packageManager of packageManagers) {
-        const lockFilePath = path.join(rootDir, lockfileNames[packageManager]);
+    for (const packageManager of PackageManagers) {
+        const lockFilePath = path.join(rootDir, LockfileNames[packageManager]);
         if (await pathExists(lockFilePath)) {
             return packageManager;
         }
@@ -50,18 +35,18 @@ async function findPackageManagerFromLockFile(rootDir) {
     return undefined;
 }
 function findPackageManagerFromUserAgent() {
-    return packageManagers.find((packageManager) => process.env.npm_config_user_agent?.startsWith(packageManager));
+    return PackageManagers.find((packageManager) => process.env.npm_config_user_agent?.startsWith(packageManager));
 }
 async function askForPackageManagerChoice() {
-    const hasYarn = (await runCommand('yarn --version')) === 0;
-    const hasPnpm = (await runCommand('pnpm --version')) === 0;
-    const hasBun = (await runCommand('bun --version')) === 0;
-    if (!hasYarn && !hasPnpm && !hasBun) {
-        return 'npm';
+    const packageManagers = await getAvailablePackageManagers();
+    if (packageManagers.length === 0) {
+        logger.warn `No package maintainer available? Trying with name=${DefaultPackageManager}`;
+        return DefaultPackageManager;
+    }
+    if (packageManagers.length === 1) {
+        return packageManagers[0];
     }
-    const choices = ['npm', hasYarn && 'yarn', hasPnpm && 'pnpm', hasBun && 'bun']
-        .filter((p) => Boolean(p))
-        .map((p) => ({ title: p, value: p }));
+    const choices = packageManagers.map((p) => ({ title: p, value: p }));
     return ((await prompts({
         type: 'select',
         name: 'packageManager',
@@ -69,13 +54,13 @@ async function askForPackageManagerChoice() {
         choices,
     }, {
         onCancel() {
-            logger.info `Falling back to name=${defaultPackageManager}`;
+            logger.info `Falling back to name=${DefaultPackageManager}`;
         },
-    })).packageManager ?? defaultPackageManager);
+    })).packageManager ?? DefaultPackageManager);
 }
 async function getPackageManager(dest, { packageManager, skipInstall }) {
-    if (packageManager && !packageManagers.includes(packageManager)) {
-        throw new Error(`Invalid package manager choice ${packageManager}. Must be one of ${packageManagers.join(', ')}`);
+    if (packageManager && !PackageManagers.includes(packageManager)) {
+        throw new Error(`Invalid package manager choice ${packageManager}. Must be one of ${PackageManagers.join(', ')}`);
     }
     return (
     // If dest already contains a lockfile (e.g. if using a local template), we
@@ -85,7 +70,7 @@ async function getPackageManager(dest, { packageManager, skipInstall }) {
         (await findPackageManagerFromLockFile('.')) ??
         findPackageManagerFromUserAgent() ??
         // This only happens if the user has a global installation in PATH
-        (skipInstall ? defaultPackageManager : askForPackageManagerChoice()));
+        (skipInstall ? DefaultPackageManager : await askForPackageManagerChoice()));
 }
 const recommendedTemplate = 'classic';
 const typeScriptTemplateSuffix = '-typescript';
@@ -164,29 +149,6 @@ async function askTemplateChoice({ templates, cliOptions, }) {
 function isValidGitRepoUrl(gitRepoUrl) {
     return ['https://', 'git@'].some((item) => gitRepoUrl.startsWith(item));
 }
-const gitStrategies = ['deep', 'shallow', 'copy', 'custom'];
-async function getGitCommand(gitStrategy) {
-    switch (gitStrategy) {
-        case 'shallow':
-        case 'copy':
-            return 'git clone --recursive --depth 1';
-        case 'custom': {
-            const { command } = (await prompts({
-                type: 'text',
-                name: 'command',
-                message: 'Write your own git clone command. The repository URL and destination directory will be supplied. E.g. "git clone --depth 10"',
-            }, {
-                onCancel() {
-                    logger.info `Falling back to code=${'git clone'}`;
-                },
-            }));
-            return command ?? 'git clone';
-        }
-        case 'deep':
-        default:
-            return 'git clone';
-    }
-}
 async function getSiteName(reqName, rootDir) {
     async function validateSiteName(siteName) {
         if (!siteName) {
@@ -246,8 +208,8 @@ async function getTemplateSource({ templateName, templates, cliOptions, }) {
 async function getUserProvidedSource({ reqTemplate, templates, cliOptions, }) {
     if (isValidGitRepoUrl(reqTemplate)) {
         if (cliOptions.gitStrategy &&
-            !gitStrategies.includes(cliOptions.gitStrategy)) {
-            logger.error `Invalid git strategy: name=${cliOptions.gitStrategy}. Value must be one of ${gitStrategies.join(', ')}.`;
+            !GitCloneStrategies.includes(cliOptions.gitStrategy)) {
+            logger.error `Invalid git strategy: name=${cliOptions.gitStrategy}. Value must be one of ${GitCloneStrategies.join(', ')}.`;
             process.exit(1);
         }
         return {
@@ -358,12 +320,6 @@ async function getSource(reqTemplate, templates, cliOptions) {
         cliOptions,
     });
 }
-async function updatePkg(pkgPath, obj) {
-    const pkg = JSON.parse(await fs.readFile(pkgPath, 'utf8'));
-    const newPkg = Object.assign(pkg, obj);
-    await fs.mkdir(path.dirname(pkgPath), { recursive: true });
-    await fs.writeFile(pkgPath, `${JSON.stringify(newPkg, null, 2)}\n`);
-}
 export default async function init(rootDir, reqName, reqTemplate, cliOptions = {}) {
     const [templates, siteName] = await Promise.all([
         readTemplates(),
@@ -373,8 +329,7 @@ export default async function init(rootDir, reqName, reqTemplate, cliOptions = {
     const source = await getSource(reqTemplate, templates, cliOptions);
     logger.info('Creating new Docusaurus project...');
     if (source.type === 'git') {
-        const gitCommand = await getGitCommand(source.strategy);
-        if ((await runCommand(gitCommand, [source.url, dest])) !== 0) {
+        if (!(await runGitCloneCommand(source, dest))) {
             logger.error `Cloning Git template failed!`;
             process.exit(1);
         }
@@ -427,17 +382,7 @@ export default async function init(rootDir, reqName, reqTemplate, cliOptions = {
         process.chdir(dest);
         logger.info `Installing dependencies with name=${pkgManager}...`;
         // ...
-        if ((await runCommand(pkgManager === 'yarn'
-            ? 'yarn'
-            : pkgManager === 'bun'
-                ? 'bun install'
-                : `${pkgManager} install --color always`, [], {
-            env: {
-                ...process.env,
-                // Force coloring the output
-                ...(supportsColor.stdout ? { FORCE_COLOR: '1' } : {}),
-            },
-        })) !== 0) {
+        if (!(await runPackageManagerInstallCommand(pkgManager))) {
             logger.error('Dependency installation failed.');
             logger.info `The site directory has already been created, and you can retry by typing:
 
@@ -446,29 +391,5 @@ export default async function init(rootDir, reqName, reqTemplate, cliOptions = {
             process.exit(0);
         }
     }
-    const useNpm = pkgManager === 'npm';
-    const useBun = pkgManager === 'bun';
-    const useRunCommand = useNpm || useBun;
-    logger.success `Created name=${cdpath}.`;
-    logger.info `Inside that directory, you can run several commands:
-
-  code=${`${pkgManager} start`}
-    Starts the development server.
-
-  code=${`${pkgManager} ${useRunCommand ? 'run ' : ''}build`}
-    Bundles your website into static files for production.
-
-  code=${`${pkgManager} ${useRunCommand ? 'run ' : ''}serve`}
-    Serves the built website locally.
-
-  code=${`${pkgManager} ${useRunCommand ? 'run ' : ''}deploy`}
-    Publishes the website to GitHub pages.
-
-We recommend that you begin by typing:
-
-  code=${`cd ${cdpath}`}
-  code=${`${pkgManager} start`}
-
-Happy building awesome websites!
-`;
+    printPackageManagerHelp({ pkgManager, cdpath });
 }

package/lib/prompts.d.ts

@@ -5,3 +5,4 @@
  * LICENSE file in the root directory of this source tree.
  */
 export declare function askPreferredLanguage(): Promise<'javascript' | 'typescript'>;
+export declare function askForCustomGitCloneCommand(): Promise<string>;

package/lib/prompts.js

@@ -21,3 +21,15 @@ export async function askPreferredLanguage() {
     }
     return language;
 }
+export async function askForCustomGitCloneCommand() {
+    const { command } = (await prompts({
+        type: 'text',
+        name: 'command',
+        message: 'Write your own git clone command. The repository URL and destination directory will be supplied. E.g. "git clone --depth 10"',
+    }, {
+        onCancel() {
+            logger.info `Falling back to code=${'git clone'}`;
+        },
+    }));
+    return command ?? 'git clone';
+}

package/lib/utils.d.ts

@@ -4,15 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import type { SpawnOptions } from 'node:child_process';
-/**
- * Run a command, similar to execa(cmd,args) but simpler
- * @param command
- * @param args
- * @param options
- * @returns the command exit code
- */
-export declare function runCommand(command: string, args?: string[], options?: SpawnOptions): Promise<number>;
+import { type PackageManager } from './constants.js';
 /**
  * We use a simple kebab-case-like conversion
  * It's not perfect, but good enough
@@ -21,3 +13,11 @@ export declare function runCommand(command: string, args?: string[], options?: S
  * @param siteName
  */
 export declare function siteNameToPackageName(siteName: string): string;
+export declare function updatePkg(pkgPath: string, obj: {
+    [key: string]: unknown;
+}): Promise<void>;
+export declare function pathExists(filePath: string): Promise<boolean>;
+export declare function printPackageManagerHelp({ pkgManager, cdpath, }: {
+    pkgManager: PackageManager;
+    cdpath: string;
+}): void;

package/lib/utils.js

@@ -4,36 +4,9 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-// @ts-expect-error: no types, but same as spawn()
-import CrossSpawn from 'cross-spawn';
-// We use cross-spawn instead of spawn because of Windows compatibility issues.
-// For example, "yarn" doesn't work on Windows, it requires "yarn.cmd"
-// Tools like execa() use cross-spawn under the hood, and "resolve" the command
-const crossSpawn = CrossSpawn;
-/**
- * Run a command, similar to execa(cmd,args) but simpler
- * @param command
- * @param args
- * @param options
- * @returns the command exit code
- */
-export async function runCommand(command, args = [], options = {}) {
-    // This does something similar to execa.command()
-    // we split a string command (with optional args) into command+args
-    // this way it's compatible with spawn()
-    const [realCommand, ...baseArgs] = command.split(' ');
-    const allArgs = [...baseArgs, ...args];
-    if (!realCommand) {
-        throw new Error(`Invalid command: ${command}`);
-    }
-    return new Promise((resolve, reject) => {
-        const p = crossSpawn(realCommand, allArgs, { stdio: 'ignore', ...options });
-        p.on('error', reject);
-        p.on('close', (exitCode) => exitCode !== null
-            ? resolve(exitCode)
-            : reject(new Error(`No exit code for command ${command}`)));
-    });
-}
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { logger } from '@docusaurus/logger';
 /**
  * We use a simple kebab-case-like conversion
  * It's not perfect, but good enough
@@ -48,3 +21,43 @@ export function siteNameToPackageName(siteName) {
     }
     return siteName;
 }
+export async function updatePkg(pkgPath, obj) {
+    const pkg = JSON.parse(await fs.readFile(pkgPath, 'utf8'));
+    const newPkg = Object.assign(pkg, obj);
+    await fs.mkdir(path.dirname(pkgPath), { recursive: true });
+    await fs.writeFile(pkgPath, `${JSON.stringify(newPkg, null, 2)}\n`);
+}
+// No need for fs-extra dependency
+export async function pathExists(filePath) {
+    return fs
+        .access(filePath, fs.constants.F_OK)
+        .then(() => true)
+        .catch(() => false);
+}
+export function printPackageManagerHelp({ pkgManager, cdpath, }) {
+    const useNpm = pkgManager === 'npm';
+    const useBun = pkgManager === 'bun';
+    const run = useNpm || useBun ? 'run ' : '';
+    logger.success `Created name=${cdpath}.`;
+    logger.info `Inside that directory, you can run several commands:
+
+  code=${`${pkgManager} start`}
+    Starts the development server.
+
+  code=${`${pkgManager} ${run}build`}
+    Bundles your website into static files for production.
+
+  code=${`${pkgManager} ${run}serve`}
+    Serves the built website locally.
+
+  code=${`${pkgManager} ${run}deploy`}
+    Publishes the website to GitHub pages.
+
+We recommend that you begin by typing:
+
+  code=${`cd ${cdpath}`}
+  code=${`${pkgManager} start`}
+
+Happy building awesome websites!
+`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-docusaurus",
-  "version": "3.10.2",
+  "version": "4.0.0-canary-6809",
   "description": "Create Docusaurus apps easily.",
   "type": "module",
   "repository": {
@@ -22,19 +22,20 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@docusaurus/logger": "3.10.2",
+    "@docusaurus/logger": "4.0.0-canary-6809",
     "commander": "^5.1.0",
-    "cross-spawn": "^7.0.0",
+    "cross-spawn": "^7.0.6",
     "prompts": "^2.4.2",
-    "semver": "^7.5.4",
-    "supports-color": "^9.4.0",
-    "tslib": "^2.6.0"
+    "semver": "^7.8.5",
+    "supports-color": "^10.2.2",
+    "tslib": "^2.8.1"
   },
   "devDependencies": {
-    "@types/supports-color": "^8.1.1"
+    "@types/cross-spawn": "^6.0.6",
+    "@types/supports-color": "^10.0.0"
   },
   "engines": {
-    "node": ">=20.0"
+    "node": ">=24.14"
   },
-  "gitHead": "f37f9035584917a97a260b91fc2842cba4f8b94f"
+  "gitHead": "db942b07f3529b5359bcae27ab3796cb07dec10e"
 }

package/templates/README.md

@@ -4,5 +4,5 @@ Official templates provided by Docusaurus. They are designed to be selected when
 
 ## Guide to Test Templates for Developer
 
-1. `yarn install` in the root of the repo (one level above this directory).
-1. Go to any template's directory, example: `cd classic && yarn start`.
+1. `pnpm install` in the root of the repo (one level above this directory).
+1. Go to any template's directory, example: `cd classic && pnpm start`.

package/templates/classic/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docusaurus-2-classic-template",
-  "version": "3.10.2",
+  "version": "4.0.0-canary-6809",
   "private": true,
   "scripts": {
     "docusaurus": "docusaurus",
@@ -14,18 +14,18 @@
     "write-heading-ids": "docusaurus write-heading-ids"
   },
   "dependencies": {
-    "@docusaurus/core": "3.10.2",
-    "@docusaurus/faster": "3.10.2",
-    "@docusaurus/preset-classic": "3.10.2",
-    "@mdx-js/react": "^3.0.0",
-    "clsx": "^2.0.0",
-    "prism-react-renderer": "^2.3.0",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0"
+    "@docusaurus/core": "4.0.0-canary-6809",
+    "@docusaurus/faster": "4.0.0-canary-6809",
+    "@docusaurus/preset-classic": "4.0.0-canary-6809",
+    "@mdx-js/react": "^3.1.1",
+    "clsx": "^2.1.1",
+    "prism-react-renderer": "^2.4.1",
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0"
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "3.10.2",
-    "@docusaurus/types": "3.10.2"
+    "@docusaurus/module-type-aliases": "4.0.0-canary-6809",
+    "@docusaurus/types": "4.0.0-canary-6809"
   },
   "browserslist": {
     "production": [
@@ -40,6 +40,6 @@
     ]
   },
   "engines": {
-    "node": ">=20.0"
+    "node": ">=24.14"
   }
 }

package/templates/classic-typescript/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docusaurus-2-classic-typescript-template",
-  "version": "3.10.2",
+  "version": "4.0.0-canary-6809",
   "private": true,
   "scripts": {
     "docusaurus": "docusaurus",
@@ -15,21 +15,21 @@
     "typecheck": "tsc"
   },
   "dependencies": {
-    "@docusaurus/core": "3.10.2",
-    "@docusaurus/faster": "3.10.2",
-    "@docusaurus/preset-classic": "3.10.2",
-    "@mdx-js/react": "^3.0.0",
-    "clsx": "^2.0.0",
-    "prism-react-renderer": "^2.3.0",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0"
+    "@docusaurus/core": "4.0.0-canary-6809",
+    "@docusaurus/faster": "4.0.0-canary-6809",
+    "@docusaurus/preset-classic": "4.0.0-canary-6809",
+    "@mdx-js/react": "^3.1.1",
+    "clsx": "^2.1.1",
+    "prism-react-renderer": "^2.4.1",
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0"
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "3.10.2",
-    "@docusaurus/tsconfig": "3.10.2",
-    "@docusaurus/types": "3.10.2",
-    "@types/react": "^19.0.0",
-    "typescript": "~6.0.2"
+    "@docusaurus/module-type-aliases": "4.0.0-canary-6809",
+    "@docusaurus/tsconfig": "4.0.0-canary-6809",
+    "@docusaurus/types": "4.0.0-canary-6809",
+    "@types/react": "^19.3.0",
+    "typescript": "~7.0.2"
   },
   "browserslist": {
     "production": [
@@ -44,6 +44,6 @@
     ]
   },
   "engines": {
-    "node": ">=20.0"
+    "node": ">=24.14"
   }
 }

package/templates/classic-typescript/tsconfig.json

@@ -1,12 +1,7 @@
 // This file is not used by "docusaurus start/build" commands.
-// It is here to improve your IDE experience (type-checking, autocompletion...),
-// and can also run the package.json "typecheck" script manually.
+// It helps improve your IDE experience (type-checking, autocompletion...),
+// You can also run the package.json "typecheck" script manually.
+// Our base config is often good enough, but feel free to customize it!
 {
-  "extends": "@docusaurus/tsconfig",
-  "compilerOptions": {
-    "baseUrl": ".",
-    "ignoreDeprecations": "6.0",
-    "strict": true
-  },
-  "exclude": [".docusaurus", "build"]
+  "extends": "@docusaurus/tsconfig"
 }

package/templates/shared/docs/intro.mdx

@@ -14,7 +14,7 @@ Or **try Docusaurus immediately** with **[docusaurus.new](https://docusaurus.new
 
 ### What you'll need
 
-- [Node.js](https://nodejs.org/en/download/) version 20.0 or above:
+- [Node.js](https://nodejs.org/en/download/) version 24.14 or above:
   - When installing Node.js, you are recommended to check all checkboxes related to dependencies.
 
 ## Generate a new site

package/lib/types.d.ts

@@ -1,7 +0,0 @@
-/**
- * Copyright (c) Facebook, Inc. and its affiliates.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-export type PackageManager = 'npm' | 'yarn' | 'pnpm' | 'bun';

package/lib/types.js

@@ -1,7 +0,0 @@
-/**
- * Copyright (c) Facebook, Inc. and its affiliates.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-export {};