@docusaurus/core 2.0.0-beta.18 → 2.0.0-beta.19

package/lib/commands/commandUtils.d.ts

@@ -1,9 +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.
- */
-import type { HostPortCLIOptions } from '@docusaurus/types';
-export declare function getCLIOptionHost(hostOption: HostPortCLIOptions['host']): string;
-export declare function getCLIOptionPort(portOption: HostPortCLIOptions['port'], host: string): Promise<number | null>;

package/lib/commands/commandUtils.js

@@ -1,21 +0,0 @@
-"use strict";
-/**
- * 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.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getCLIOptionPort = exports.getCLIOptionHost = void 0;
-const tslib_1 = require("tslib");
-const choosePort_1 = tslib_1.__importDefault(require("../choosePort"));
-const utils_1 = require("@docusaurus/utils");
-function getCLIOptionHost(hostOption) {
-    return hostOption ?? 'localhost';
-}
-exports.getCLIOptionHost = getCLIOptionHost;
-async function getCLIOptionPort(portOption, host) {
-    const basePort = portOption ? parseInt(portOption, 10) : utils_1.DEFAULT_PORT;
-    return (0, choosePort_1.default)(host, basePort);
-}
-exports.getCLIOptionPort = getCLIOptionPort;

package/lib/server/duplicateRoutes.d.ts

@@ -1,8 +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.
- */
-import type { ReportingSeverity, RouteConfig } from '@docusaurus/types';
-export declare function handleDuplicateRoutes(pluginsRouteConfigs: RouteConfig[], onDuplicateRoutes: ReportingSeverity): void;

package/lib/server/duplicateRoutes.js

@@ -1,42 +0,0 @@
-"use strict";
-/**
- * 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.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleDuplicateRoutes = void 0;
-const utils_1 = require("@docusaurus/utils");
-const utils_2 = require("./utils");
-function getAllDuplicateRoutes(pluginsRouteConfigs) {
-    const allRoutes = (0, utils_2.getAllFinalRoutes)(pluginsRouteConfigs).map((routeConfig) => routeConfig.path);
-    const seenRoutes = new Set();
-    return allRoutes.filter((route) => {
-        if (seenRoutes.has(route)) {
-            return true;
-        }
-        seenRoutes.add(route);
-        return false;
-    });
-}
-function getDuplicateRoutesMessage(allDuplicateRoutes) {
-    const message = allDuplicateRoutes
-        .map((duplicateRoute) => `- Attempting to create page at ${duplicateRoute}, but a page already exists at this route.`)
-        .join('\n');
-    return message;
-}
-function handleDuplicateRoutes(pluginsRouteConfigs, onDuplicateRoutes) {
-    if (onDuplicateRoutes === 'ignore') {
-        return;
-    }
-    const duplicatePaths = getAllDuplicateRoutes(pluginsRouteConfigs);
-    const message = getDuplicateRoutesMessage(duplicatePaths);
-    if (message) {
-        const finalMessage = `Duplicate routes found!
-${message}
-This could lead to non-deterministic routing behavior.`;
-        (0, utils_1.reportMessage)(finalMessage, onDuplicateRoutes);
-    }
-}
-exports.handleDuplicateRoutes = handleDuplicateRoutes;

package/lib/server/html-tags/htmlTags.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 default function htmlTagObjectToString(tagDefinition: unknown): string;

package/lib/server/html-tags/htmlTags.js

@@ -1,38 +0,0 @@
-"use strict";
-/**
- * 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.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-const html_tags_1 = tslib_1.__importDefault(require("html-tags"));
-const void_1 = tslib_1.__importDefault(require("html-tags/void"));
-const escape_html_1 = tslib_1.__importDefault(require("escape-html"));
-function assertIsHtmlTagObject(val) {
-    if (typeof val !== 'object' || !val) {
-        throw new Error(`"${val}" is not a valid HTML tag object.`);
-    }
-    if (typeof val.tagName !== 'string') {
-        throw new Error(`${JSON.stringify(val)} is not a valid HTML tag object. "tagName" must be defined as a string.`);
-    }
-}
-function htmlTagObjectToString(tagDefinition) {
-    assertIsHtmlTagObject(tagDefinition);
-    if (html_tags_1.default.indexOf(tagDefinition.tagName) === -1) {
-        throw new Error(`Error loading ${JSON.stringify(tagDefinition)}, "${tagDefinition.tagName}" is not a valid HTML tags.`);
-    }
-    const isVoidTag = void_1.default.indexOf(tagDefinition.tagName) !== -1;
-    const tagAttributes = tagDefinition.attributes ?? {};
-    const attributes = Object.keys(tagAttributes)
-        .filter((attributeName) => tagAttributes[attributeName] !== false)
-        .map((attributeName) => {
-        if (tagAttributes[attributeName] === true) {
-            return attributeName;
-        }
-        return `${attributeName}="${(0, escape_html_1.default)(tagAttributes[attributeName])}"`;
-    });
-    return `<${[tagDefinition.tagName].concat(attributes).join(' ')}>${(!isVoidTag && tagDefinition.innerHTML) || ''}${isVoidTag ? '' : `</${tagDefinition.tagName}>`}`;
-}
-exports.default = htmlTagObjectToString;

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

@@ -1,8 +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.
- */
-import type { InjectedHtmlTags, LoadedPlugin } from '@docusaurus/types';
-export declare function loadHtmlTags(plugins: LoadedPlugin[]): InjectedHtmlTags;

package/lib/server/html-tags/index.js

@@ -1,42 +0,0 @@
-"use strict";
-/**
- * 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.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadHtmlTags = void 0;
-const tslib_1 = require("tslib");
-const htmlTags_1 = tslib_1.__importDefault(require("./htmlTags"));
-function toString(val) {
-    return typeof val === 'string' ? val : (0, htmlTags_1.default)(val);
-}
-function createHtmlTagsString(tags) {
-    return Array.isArray(tags) ? tags.map(toString).join('\n') : toString(tags);
-}
-function loadHtmlTags(plugins) {
-    const htmlTags = plugins.reduce((acc, plugin) => {
-        if (!plugin.injectHtmlTags) {
-            return acc;
-        }
-        const { headTags, preBodyTags, postBodyTags } = plugin.injectHtmlTags({ content: plugin.content }) ?? {};
-        return {
-            headTags: headTags
-                ? `${acc.headTags}\n${createHtmlTagsString(headTags)}`
-                : acc.headTags,
-            preBodyTags: preBodyTags
-                ? `${acc.preBodyTags}\n${createHtmlTagsString(preBodyTags)}`
-                : acc.preBodyTags,
-            postBodyTags: postBodyTags
-                ? `${acc.postBodyTags}\n${createHtmlTagsString(postBodyTags)}`
-                : acc.postBodyTags,
-        };
-    }, { headTags: '', preBodyTags: '', postBodyTags: '' });
-    return {
-        headTags: htmlTags.headTags.trim(),
-        preBodyTags: htmlTags.preBodyTags.trim(),
-        postBodyTags: htmlTags.postBodyTags.trim(),
-    };
-}
-exports.loadHtmlTags = loadHtmlTags;

package/lib/server/plugins/applyRouteTrailingSlash.js

@@ -1,19 +0,0 @@
-"use strict";
-/**
- * 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.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-const utils_common_1 = require("@docusaurus/utils-common");
-function applyRouteTrailingSlash(route, params) {
-    return {
-        ...route,
-        path: (0, utils_common_1.applyTrailingSlash)(route.path, params),
-        ...(route.routes && {
-            routes: route.routes.map((subroute) => applyRouteTrailingSlash(subroute, params)),
-        }),
-    };
-}
-exports.default = applyRouteTrailingSlash;

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

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

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

@@ -1,9 +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.
- */
-import type { ThemeAliases } from '@docusaurus/types';
-export declare function sortAliases(aliases: ThemeAliases): ThemeAliases;
-export default function themeAlias(themePath: string, addOriginalAlias: boolean): Promise<ThemeAliases>;

package/lib/server/themes/alias.js

@@ -1,50 +0,0 @@
-"use strict";
-/**
- * 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.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.sortAliases = void 0;
-const tslib_1 = require("tslib");
-const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
-const path_1 = tslib_1.__importDefault(require("path"));
-const utils_1 = require("@docusaurus/utils");
-const lodash_1 = tslib_1.__importDefault(require("lodash"));
-// Order of Webpack aliases is important because one alias can shadow another
-// This ensure @theme/NavbarItem alias is after @theme/NavbarItem/LocaleDropdown
-// See https://github.com/facebook/docusaurus/pull/3922
-// See https://github.com/facebook/docusaurus/issues/5382
-function sortAliases(aliases) {
-    // Alphabetical order by default
-    const entries = lodash_1.default.sortBy(Object.entries(aliases), ([alias]) => alias);
-    // @theme/NavbarItem should be after @theme/NavbarItem/LocaleDropdown
-    entries.sort(([alias1], [alias2]) => 
-    // eslint-disable-next-line no-nested-ternary
-    alias1.includes(`${alias2}/`) ? -1 : alias2.includes(`${alias1}/`) ? 1 : 0);
-    return Object.fromEntries(entries);
-}
-exports.sortAliases = sortAliases;
-async function themeAlias(themePath, addOriginalAlias) {
-    if (!(await fs_extra_1.default.pathExists(themePath))) {
-        return {};
-    }
-    const themeComponentFiles = await (0, utils_1.Globby)(['**/*.{js,jsx,ts,tsx}'], {
-        cwd: themePath,
-    });
-    const aliases = {};
-    themeComponentFiles.forEach((relativeSource) => {
-        const filePath = path_1.default.join(themePath, relativeSource);
-        const fileName = (0, utils_1.fileToPath)(relativeSource);
-        const aliasName = (0, utils_1.posixPath)((0, utils_1.normalizeUrl)(['@theme', fileName]).replace(/\/$/, ''));
-        aliases[aliasName] = filePath;
-        if (addOriginalAlias) {
-            // For swizzled components to access the original.
-            const originalAliasName = (0, utils_1.posixPath)((0, utils_1.normalizeUrl)(['@theme-original', fileName]).replace(/\/$/, ''));
-            aliases[originalAliasName] = filePath;
-        }
-    });
-    return sortAliases(aliases);
-}
-exports.default = themeAlias;

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

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

package/lib/server/themes/index.js

@@ -1,47 +0,0 @@
-"use strict";
-/**
- * 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.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadPluginsThemeAliases = exports.loadThemeAliases = void 0;
-const tslib_1 = require("tslib");
-const path_1 = tslib_1.__importDefault(require("path"));
-const utils_1 = require("@docusaurus/utils");
-const alias_1 = tslib_1.__importStar(require("./alias"));
-const ThemeFallbackDir = path_1.default.join(__dirname, '../../client/theme-fallback');
-async function loadThemeAliases(themePaths, userThemePaths) {
-    const aliases = {};
-    for (const themePath of themePaths) {
-        const themeAliases = await (0, alias_1.default)(themePath, true);
-        Object.entries(themeAliases).forEach(([aliasKey, alias]) => {
-            // If this alias shadows a previous one, use @theme-init to preserve the
-            // initial one. @theme-init is only applied once: to the initial theme
-            // that provided this component
-            if (aliasKey in aliases) {
-                const componentName = aliasKey.substring(aliasKey.indexOf('/') + 1);
-                const initAlias = `@theme-init/${componentName}`;
-                if (!(initAlias in aliases)) {
-                    aliases[initAlias] = aliases[aliasKey];
-                }
-            }
-            aliases[aliasKey] = alias;
-        });
-    }
-    for (const themePath of userThemePaths) {
-        const userThemeAliases = await (0, alias_1.default)(themePath, false);
-        Object.assign(aliases, userThemeAliases);
-    }
-    return (0, alias_1.sortAliases)(aliases);
-}
-exports.loadThemeAliases = loadThemeAliases;
-function loadPluginsThemeAliases({ siteDir, plugins, }) {
-    const pluginThemes = plugins
-        .map((plugin) => plugin.getThemePath && path_1.default.resolve(plugin.path, plugin.getThemePath()))
-        .filter((x) => Boolean(x));
-    const userTheme = path_1.default.resolve(siteDir, utils_1.THEME_PATH);
-    return loadThemeAliases([ThemeFallbackDir, ...pluginThemes], [userTheme]);
-}
-exports.loadPluginsThemeAliases = loadPluginsThemeAliases;