@docusaurus/core 2.0.0-beta.14 → 2.0.0-beta.15

package/lib/commands/writeTranslations.d.ts

@@ -4,8 +4,8 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import { ConfigOptions } from '@docusaurus/types';
-import { WriteTranslationsOptions } from '../server/translations/translations';
+import type { ConfigOptions } from '@docusaurus/types';
+import { type WriteTranslationsOptions } from '../server/translations/translations';
 export default function writeTranslations(siteDir: string, options: WriteTranslationsOptions & ConfigOptions & {
     locale?: string;
 }): Promise<void>;

package/lib/commands/writeTranslations.js

@@ -51,7 +51,7 @@ async function writeTranslations(siteDir, options) {
         locale: options.locale,
     });
     const pluginConfigs = (0, server_1.loadPluginConfigs)(context);
-    const plugins = (0, init_1.default)({
+    const plugins = await (0, init_1.default)({
         pluginConfigs,
         context,
     });

package/lib/server/brokenLinks.d.ts

@@ -4,7 +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 { RouteConfig, ReportingSeverity } from '@docusaurus/types';
+import type { RouteConfig, ReportingSeverity } from '@docusaurus/types';
 declare type BrokenLink = {
     link: string;
     resolvedLink: string;

package/lib/server/brokenLinks.js

@@ -9,7 +9,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.handleBrokenLinks = exports.filterExistingFileLinks = exports.getBrokenLinksErrorMessage = exports.getAllBrokenLinks = void 0;
 const tslib_1 = require("tslib");
 const react_router_config_1 = require("react-router-config");
-const resolve_pathname_1 = (0, tslib_1.__importDefault)(require("resolve-pathname"));
 const fs_extra_1 = (0, tslib_1.__importDefault)(require("fs-extra"));
 const lodash_1 = require("lodash");
 const utils_1 = require("@docusaurus/utils");
@@ -29,7 +28,7 @@ function getPageBrokenLinks({ pagePath, pageLinks, routes, }) {
     // we must resolve the links before using matchRoutes
     // resolvePathname is used internally by ReactRouter
     function resolveLink(link) {
-        const resolvedLink = (0, resolve_pathname_1.default)(onlyPathname(link), pagePath);
+        const resolvedLink = (0, utils_1.resolvePathname)(onlyPathname(link), pagePath);
         return { link, resolvedLink };
     }
     function isBrokenLink(link) {

package/lib/server/client-modules/index.d.ts

@@ -4,5 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import { Plugin } from '@docusaurus/types';
+import type { Plugin } from '@docusaurus/types';
 export default function loadClientModules(plugins: Plugin<unknown>[]): string[];

package/lib/server/config.d.ts

@@ -4,5 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import { DocusaurusConfig } from '@docusaurus/types';
-export default function loadConfig(configPath: string): DocusaurusConfig;
+import type { DocusaurusConfig } from '@docusaurus/types';
+export default function loadConfig(configPath: string): Promise<DocusaurusConfig>;

package/lib/server/config.js

@@ -10,11 +10,14 @@ const tslib_1 = require("tslib");
 const fs_extra_1 = (0, tslib_1.__importDefault)(require("fs-extra"));
 const import_fresh_1 = (0, tslib_1.__importDefault)(require("import-fresh"));
 const configValidation_1 = require("./configValidation");
-function loadConfig(configPath) {
+async function loadConfig(configPath) {
     if (!fs_extra_1.default.existsSync(configPath)) {
         throw new Error(`Config file at "${configPath}" not found.`);
     }
-    const loadedConfig = (0, import_fresh_1.default)(configPath);
+    const importedConfig = (0, import_fresh_1.default)(configPath);
+    const loadedConfig = importedConfig instanceof Function
+        ? await importedConfig()
+        : await importedConfig;
     return (0, configValidation_1.validateConfig)(loadedConfig);
 }
 exports.default = loadConfig;

package/lib/server/configValidation.d.ts

@@ -4,7 +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 { DocusaurusConfig, I18nConfig } from '@docusaurus/types';
+import type { DocusaurusConfig, I18nConfig } from '@docusaurus/types';
 import { Joi } from '@docusaurus/utils-validation';
 export declare const DEFAULT_I18N_CONFIG: I18nConfig;
 export declare const DEFAULT_CONFIG: Pick<DocusaurusConfig, 'i18n' | 'onBrokenLinks' | 'onBrokenMarkdownLinks' | 'onDuplicateRoutes' | 'plugins' | 'themes' | 'presets' | 'customFields' | 'themeConfig' | 'titleDelimiter' | 'noIndex' | 'baseUrlIssueBanner' | 'staticDirectories'>;

package/lib/server/configValidation.js

@@ -36,9 +36,7 @@ const PluginSchema = utils_validation_1.Joi.alternatives()
     .try(utils_validation_1.Joi.function(), utils_validation_1.Joi.array().ordered(utils_validation_1.Joi.function().required(), utils_validation_1.Joi.object().required()), utils_validation_1.Joi.string(), utils_validation_1.Joi.array()
     .ordered(utils_validation_1.Joi.string().required(), utils_validation_1.Joi.object().required())
     .length(2), utils_validation_1.Joi.bool().equal(false))
-    // TODO isn't there a simpler way to customize the default Joi error message???
-    // Not sure why Joi makes it complicated to add a custom error message...
-    // See https://stackoverflow.com/a/54657686/82609
+    // @ts-expect-error: bad lib def, doesn't recognize an array of reports
     .error((errors) => {
     errors.forEach((error) => {
         error.message = ` => Bad Docusaurus plugin value as path [${error.path}].
@@ -60,6 +58,7 @@ const ThemeSchema = utils_validation_1.Joi.alternatives().try(utils_validation_1
 const PresetSchema = utils_validation_1.Joi.alternatives().try(utils_validation_1.Joi.string(), utils_validation_1.Joi.array().items(utils_validation_1.Joi.string().required(), utils_validation_1.Joi.object().required()).length(2));
 const LocaleConfigSchema = utils_validation_1.Joi.object({
     label: utils_validation_1.Joi.string(),
+    htmlLang: utils_validation_1.Joi.string(),
     direction: utils_validation_1.Joi.string().equal('ltr', 'rtl').default('ltr'),
 });
 const I18N_CONFIG_SCHEMA = utils_validation_1.Joi.object({

package/lib/server/duplicateRoutes.d.ts

@@ -4,7 +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 { ReportingSeverity, RouteConfig } from '@docusaurus/types';
+import type { ReportingSeverity, RouteConfig } from '@docusaurus/types';
 export declare function getAllDuplicateRoutes(pluginsRouteConfigs: RouteConfig[]): string[];
 export declare function getDuplicateRoutesMessage(allDuplicateRoutes: string[]): string;
 export declare function handleDuplicateRoutes(pluginsRouteConfigs: RouteConfig[], onDuplicateRoutes: ReportingSeverity): void;

package/lib/server/html-tags/index.d.ts

@@ -4,6 +4,6 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import { InjectedHtmlTags, HtmlTags, LoadedPlugin } from '@docusaurus/types';
+import type { InjectedHtmlTags, HtmlTags, LoadedPlugin } from '@docusaurus/types';
 export declare function createHtmlTagsString(tags: HtmlTags): string;
 export declare function loadHtmlTags(plugins: LoadedPlugin[]): InjectedHtmlTags;

package/lib/server/i18n.d.ts

@@ -4,7 +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 { I18n, DocusaurusConfig, I18nLocaleConfig } from '@docusaurus/types';
+import type { I18n, DocusaurusConfig, I18nLocaleConfig } from '@docusaurus/types';
 export declare function getDefaultLocaleConfig(locale: string): I18nLocaleConfig;
 export declare function shouldWarnAboutNodeVersion(version: number, locales: string[]): boolean;
 export declare function loadI18n(config: DocusaurusConfig, options?: {

package/lib/server/i18n.js

@@ -13,19 +13,14 @@ const utils_1 = require("@docusaurus/utils");
 const rtl_detect_1 = require("rtl-detect");
 const logger_1 = (0, tslib_1.__importDefault)(require("@docusaurus/logger"));
 function getDefaultLocaleLabel(locale) {
-    // Intl.DisplayNames is ES2021 - Node14+
-    // https://v8.dev/features/intl-displaynames
-    if (typeof Intl.DisplayNames !== 'undefined') {
-        const languageName = new Intl.DisplayNames(locale, { type: 'language' }).of(locale);
-        return (languageName.charAt(0).toLocaleUpperCase(locale) +
-            languageName.substring(1));
-    }
-    return locale;
+    const languageName = new Intl.DisplayNames(locale, { type: 'language' }).of(locale);
+    return (languageName.charAt(0).toLocaleUpperCase(locale) + languageName.substring(1));
 }
 function getDefaultLocaleConfig(locale) {
     return {
         label: getDefaultLocaleLabel(locale),
         direction: (0, rtl_detect_1.getLangDir)(locale),
+        htmlLang: locale,
     };
 }
 exports.getDefaultLocaleConfig = getDefaultLocaleConfig;

package/lib/server/index.d.ts

@@ -4,7 +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 { DocusaurusConfig, LoadContext, PluginConfig, Props } from '@docusaurus/types';
+import type { DocusaurusConfig, LoadContext, PluginConfig, Props } from '@docusaurus/types';
 export declare type LoadContextOptions = {
     customOutDir?: string;
     customConfigFilePath?: string;

package/lib/server/index.js

@@ -11,7 +11,7 @@ const tslib_1 = require("tslib");
 const utils_1 = require("@docusaurus/utils");
 const path_1 = (0, tslib_1.__importDefault)(require("path"));
 const logger_1 = (0, tslib_1.__importDefault)(require("@docusaurus/logger"));
-const ssr_html_template_1 = (0, tslib_1.__importDefault)(require("../client/templates/ssr.html.template"));
+const ssr_html_template_1 = (0, tslib_1.__importDefault)(require("../webpack/templates/ssr.html.template"));
 const client_modules_1 = (0, tslib_1.__importDefault)(require("./client-modules"));
 const config_1 = (0, tslib_1.__importDefault)(require("./config"));
 const plugins_1 = require("./plugins");
@@ -77,7 +77,7 @@ async function loadContext(siteDir, options = {}) {
         outDir,
         baseUrl,
         i18n,
-        ssrTemplate,
+        ssrTemplate: ssrTemplate !== null && ssrTemplate !== void 0 ? ssrTemplate : ssr_html_template_1.default,
         codeTranslations,
     };
 }
@@ -150,7 +150,7 @@ function createBootstrapPlugin({ siteConfig, }) {
         },
     };
 }
-// Configurer Webpack fallback mdx loader for md/mdx files out of content-plugin folders
+// Configure Webpack fallback mdx loader for md/mdx files out of content-plugin folders
 // Adds a "fallback" mdx loader for mdx files that are not processed by content plugins
 // This allows to do things such as importing repo/README.md as a partial from another doc
 // Not ideal solution though, but good enough for now
@@ -208,9 +208,19 @@ async function load(siteDir, options = {}) {
     // Side-effect to replace the untranslated themeConfig by the translated one
     context.siteConfig.themeConfig = themeConfigTranslated;
     (0, duplicateRoutes_1.handleDuplicateRoutes)(pluginsRouteConfigs, siteConfig.onDuplicateRoutes);
+    const genWarning = (0, utils_1.generate)(generatedFilesDir, 'DONT-EDIT-THIS-FOLDER', `This folder stores temp files that Docusaurus' client bundler accesses.
+DO NOT hand-modify files in this folder because they will be overwritten in the
+next build. You can clear all build artifacts (including this folder) with the
+\`docusaurus clear\` command.
+`);
     // Site config must be generated after plugins
     // We want the generated config to have been normalized by the plugins!
-    const genSiteConfig = (0, utils_1.generate)(generatedFilesDir, utils_1.DEFAULT_CONFIG_FILE_NAME, `export default ${JSON.stringify(siteConfig, null, 2)};`);
+    const genSiteConfig = (0, utils_1.generate)(generatedFilesDir, utils_1.DEFAULT_CONFIG_FILE_NAME, `/*
+AUTOGENERATED - DON'T EDIT
+Your edits in this file will be overwritten in the next build!
+Modify the docusaurus.config.js file at your site's root instead.
+*/
+export default ${JSON.stringify(siteConfig, null, 2)};`);
     plugins.push(createBootstrapPlugin({ siteConfig }));
     plugins.push(createMDXFallbackPlugin({ siteDir, siteConfig }));
     // Load client modules.
@@ -218,8 +228,7 @@ async function load(siteDir, options = {}) {
     const genClientModules = (0, utils_1.generate)(generatedFilesDir, 'client-modules.js', `export default [\n${clientModules
         // import() is async so we use require() because client modules can have
         // CSS and the order matters for loading CSS.
-        // We need to JSON.stringify so that if its on windows, backslash are escaped.
-        .map((module) => `  require(${JSON.stringify(module)}),`)
+        .map((module) => `  require('${(0, utils_1.escapePath)(module)}'),`)
         .join('\n')}\n];\n`);
     // Load extra head & body html tags.
     const { headTags, preBodyTags, postBodyTags } = (0, html_tags_1.loadHtmlTags)(plugins);
@@ -228,9 +237,7 @@ async function load(siteDir, options = {}) {
     const genRegistry = (0, utils_1.generate)(generatedFilesDir, 'registry.js', `export default {
 ${Object.keys(registry)
         .sort()
-        .map((key) => 
-    // We need to JSON.stringify so that if its on windows, backslash are escaped.
-    `  '${key}': [${registry[key].loader}, ${JSON.stringify(registry[key].modulePath)}, require.resolveWeak(${JSON.stringify(registry[key].modulePath)})],`)
+        .map((key) => `  '${key}': [${registry[key].loader}, '${(0, utils_1.escapePath)(registry[key].modulePath)}', require.resolveWeak('${(0, utils_1.escapePath)(registry[key].modulePath)}')],`)
         .join('\n')}};\n`);
     const genRoutesChunkNames = (0, utils_1.generate)(generatedFilesDir, 'routesChunkNames.json', JSON.stringify(routesChunkNames, null, 2));
     const genRoutes = (0, utils_1.generate)(generatedFilesDir, 'routes.js', routesConfig);
@@ -255,6 +262,7 @@ ${Object.keys(registry)
     checkDocusaurusPackagesVersion(siteMetadata);
     const genSiteMetadata = (0, utils_1.generate)(generatedFilesDir, 'site-metadata.json', JSON.stringify(siteMetadata, null, 2));
     await Promise.all([
+        genWarning,
         genClientModules,
         genSiteConfig,
         genRegistry,
@@ -280,7 +288,7 @@ ${Object.keys(registry)
         headTags,
         preBodyTags,
         postBodyTags,
-        ssrTemplate: ssrTemplate || ssr_html_template_1.default,
+        ssrTemplate,
         codeTranslations,
     };
     return props;

package/lib/server/loadSetup.d.ts

@@ -4,6 +4,6 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import { Props } from '@docusaurus/types';
+import type { Props } from '@docusaurus/types';
 declare const loadSetup: (name: string) => Promise<Props>;
 export default loadSetup;

package/lib/server/moduleShorthand.js

@@ -28,15 +28,19 @@ function getNamePatterns(moduleName, moduleType) {
 exports.getNamePatterns = getNamePatterns;
 function resolveModuleName(moduleName, moduleRequire, moduleType) {
     const modulePatterns = getNamePatterns(moduleName, moduleType);
-    // eslint-disable-next-line no-restricted-syntax
-    for (const module of modulePatterns) {
+    const module = modulePatterns.find((m) => {
         try {
-            moduleRequire.resolve(module);
-            return module;
+            moduleRequire.resolve(m);
+            return true;
         }
-        catch (e) { }
+        catch {
+            return false;
+        }
+    });
+    if (!module) {
+        throw new Error(`Docusaurus was unable to resolve the "${moduleName}" ${moduleType}. Make sure one of the following packages are installed:
+${modulePatterns.map((m) => `- ${m}`).join('\n')}`);
     }
-    throw new Error(`Docusaurus was unable to resolve the "${moduleName}" ${moduleType}. Make sure one of the following packages are installed:
-${modulePatterns.map((module) => `- ${module}`).join('\n')}`);
+    return module;
 }
 exports.resolveModuleName = resolveModuleName;

package/lib/server/plugins/applyRouteTrailingSlash.d.ts

@@ -4,6 +4,6 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import { RouteConfig } from '@docusaurus/types';
-import { ApplyTrailingSlashParams } from '@docusaurus/utils-common';
+import type { RouteConfig } from '@docusaurus/types';
+import { type ApplyTrailingSlashParams } from '@docusaurus/utils-common';
 export default function applyRouteTrailingSlash(route: RouteConfig, params: ApplyTrailingSlashParams): RouteConfig;

package/lib/server/plugins/index.d.ts

@@ -4,7 +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 { LoadContext, PluginConfig, RouteConfig, ThemeConfig, LoadedPlugin } from '@docusaurus/types';
+import type { LoadContext, PluginConfig, RouteConfig, ThemeConfig, LoadedPlugin } from '@docusaurus/types';
 export declare function sortConfig(routeConfigs: RouteConfig[], baseUrl?: string): void;
 export declare function loadPlugins({ pluginConfigs, context, }: {
     pluginConfigs: PluginConfig[];

package/lib/server/plugins/index.js

@@ -52,7 +52,7 @@ function sortConfig(routeConfigs, baseUrl = '/') {
 exports.sortConfig = sortConfig;
 async function loadPlugins({ pluginConfigs, context, }) {
     // 1. Plugin Lifecycle - Initialization/Constructor.
-    const plugins = (0, init_1.default)({
+    const plugins = await (0, init_1.default)({
         pluginConfigs,
         context,
     });

package/lib/server/plugins/init.d.ts

@@ -4,8 +4,8 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import { LoadContext, PluginConfig, InitializedPlugin } from '@docusaurus/types';
+import type { LoadContext, PluginConfig, InitializedPlugin } from '@docusaurus/types';
 export default function initPlugins({ pluginConfigs, context, }: {
     pluginConfigs: PluginConfig[];
     context: LoadContext;
-}): InitializedPlugin[];
+}): Promise<InitializedPlugin[]>;

package/lib/server/plugins/init.js

@@ -85,7 +85,7 @@ function getThemeValidationFunction(normalizedPluginConfig) {
         return normalizedPluginConfig.plugin.validateThemeConfig;
     }
 }
-function initPlugins({ pluginConfigs, context, }) {
+async function initPlugins({ pluginConfigs, context, }) {
     // We need to resolve plugins from the perspective of the siteDir, since the siteDir's package.json
     // declares the dependency on these plugins.
     const pluginRequire = (0, module_1.createRequire)(context.siteConfigPath);
@@ -130,11 +130,7 @@ function initPlugins({ pluginConfigs, context, }) {
             };
         }
     }
-    const plugins = pluginConfigs
-        .map((pluginConfig) => {
-        if (!pluginConfig) {
-            return null;
-        }
+    async function initializePlugin(pluginConfig) {
         const normalizedPluginConfig = normalizePluginConfig(pluginConfig, pluginRequire);
         const pluginVersion = doGetPluginVersion(normalizedPluginConfig);
         const pluginOptions = doValidatePluginOptions(normalizedPluginConfig);
@@ -143,14 +139,19 @@ function initPlugins({ pluginConfigs, context, }) {
             ...context.siteConfig.themeConfig,
             ...doValidateThemeConfig(normalizedPluginConfig),
         };
-        const pluginInstance = normalizedPluginConfig.plugin(context, pluginOptions);
+        const pluginInstance = await normalizedPluginConfig.plugin(context, pluginOptions);
         return {
             ...pluginInstance,
             options: pluginOptions,
             version: pluginVersion,
         };
-    })
-        .filter((item) => Boolean(item));
+    }
+    const plugins = (await Promise.all(pluginConfigs.map((pluginConfig) => {
+        if (!pluginConfig) {
+            return null;
+        }
+        return initializePlugin(pluginConfig);
+    }))).filter((item) => Boolean(item));
     (0, pluginIds_1.ensureUniquePluginInstanceIds)(plugins);
     return plugins;
 }

package/lib/server/plugins/pluginIds.d.ts

@@ -4,5 +4,5 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import { InitializedPlugin } from '@docusaurus/types';
+import type { InitializedPlugin } from '@docusaurus/types';
 export declare function ensureUniquePluginInstanceIds(plugins: InitializedPlugin[]): void;

package/lib/server/presets/index.d.ts

@@ -4,7 +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 { LoadContext, PluginConfig } from '@docusaurus/types';
+import type { LoadContext, PluginConfig } from '@docusaurus/types';
 export default function loadPresets(context: LoadContext): {
     plugins: PluginConfig[];
     themes: PluginConfig[];

package/lib/server/presets/index.js

@@ -14,7 +14,7 @@ function loadPresets(context) {
     // We need to resolve presets from the perspective of the siteDir, since the siteDir's package.json
     // declares the dependency on these presets.
     const presetRequire = (0, module_1.createRequire)(context.siteConfigPath);
-    const presets = (context.siteConfig || {}).presets || [];
+    const presets = context.siteConfig.presets || [];
     const unflatPlugins = [];
     const unflatThemes = [];
     presets.forEach((presetItem) => {

package/lib/server/routes.d.ts

@@ -4,7 +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 { ChunkRegistry, RouteConfig, ChunkNames } from '@docusaurus/types';
+import type { ChunkRegistry, RouteConfig, ChunkNames } from '@docusaurus/types';
 declare type LoadedRoutes = {
     registry: {
         [chunkName: string]: ChunkRegistry;

package/lib/server/routes.js

@@ -122,8 +122,7 @@ registry, value, prefix, name) {
     if (isModule(value)) {
         const modulePath = getModulePath(value);
         const chunkName = (0, utils_1.genChunkName)(modulePath, prefix, name);
-        // We need to JSON.stringify so that if its on windows, backslashes are escaped.
-        const loader = `() => import(/* webpackChunkName: '${chunkName}' */ ${JSON.stringify(modulePath)})`;
+        const loader = `() => import(/* webpackChunkName: '${chunkName}' */ '${(0, utils_1.escapePath)(modulePath)}')`;
         registry[chunkName] = {
             loader,
             modulePath,

package/lib/server/themes/alias.d.ts

@@ -4,6 +4,6 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import { ThemeAliases } from '@docusaurus/types';
+import type { ThemeAliases } from '@docusaurus/types';
 export declare function sortAliases(aliases: ThemeAliases): ThemeAliases;
 export default function themeAlias(themePath: string, addOriginalAlias: boolean): ThemeAliases;

package/lib/server/themes/index.d.ts

@@ -4,7 +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 { ThemeAliases, LoadedPlugin } from '@docusaurus/types';
+import type { ThemeAliases, LoadedPlugin } from '@docusaurus/types';
 export declare function loadThemeAliases(themePaths: string[], userThemePaths: string[]): ThemeAliases;
 export declare function loadPluginsThemeAliases({ siteDir, plugins, }: {
     siteDir: string;

package/lib/server/translations/translations.d.ts

@@ -4,7 +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 { TranslationFileContent, TranslationFile, TranslationMessage, InitializedPlugin } from '@docusaurus/types';
+import type { TranslationFileContent, TranslationFile, TranslationMessage, InitializedPlugin } from '@docusaurus/types';
 export declare type WriteTranslationsOptions = {
     override?: boolean;
     messagePrefix?: string;

package/lib/server/translations/translations.js

@@ -82,7 +82,7 @@ Maybe you should remove them? ${unknownKeys}`;
     if (Object.keys(mergedContent).length > 0) {
         logger_1.default.info `number=${Object.keys(mergedContent).length} translations will be written at path=${(0, utils_1.toMessageRelativeFilePath)(filePath)}.`;
         await fs_extra_1.default.ensureDir(path_1.default.dirname(filePath));
-        await fs_extra_1.default.writeFile(filePath, JSON.stringify(mergedContent, null, 2));
+        await fs_extra_1.default.writeFile(filePath, `${JSON.stringify(mergedContent, null, 2)}\n`);
     }
 }
 exports.writeTranslationFileContent = writeTranslationFileContent;

package/lib/server/translations/translationsExtractor.d.ts

@@ -4,8 +4,8 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import { TransformOptions } from '@babel/core';
-import { InitializedPlugin, TranslationFileContent, TranslationMessage } from '@docusaurus/types';
+import { type TransformOptions } from '@babel/core';
+import type { InitializedPlugin, TranslationFileContent, TranslationMessage } from '@docusaurus/types';
 export declare function globSourceCodeFilePaths(dirPaths: string[]): Promise<string[]>;
 export declare function extractSiteSourceCodeTranslations(siteDir: string, plugins: InitializedPlugin[], babelOptions: TransformOptions, extraSourceCodeFilePaths?: string[]): Promise<TranslationFileContent>;
 declare type SourceCodeFileTranslations = {