@docusaurus/core 0.0.0-4799 → 0.0.0-4800

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (50) hide show
  1. package/lib/commands/build.js +4 -2
  2. package/lib/commands/commandUtils.js +2 -3
  3. package/lib/commands/deploy.js +2 -1
  4. package/lib/commands/external.js +1 -1
  5. package/lib/commands/serve.js +2 -2
  6. package/lib/commands/start.js +2 -1
  7. package/lib/commands/swizzle/common.d.ts +1 -2
  8. package/lib/commands/swizzle/context.js +2 -3
  9. package/lib/commands/writeHeadingIds.js +1 -1
  10. package/lib/commands/writeTranslations.js +2 -1
  11. package/lib/server/choosePort.d.ts +12 -0
  12. package/lib/{choosePort.js → server/choosePort.js} +8 -10
  13. package/lib/server/clientModules.d.ts +5 -1
  14. package/lib/server/clientModules.js +4 -0
  15. package/lib/server/config.d.ts +5 -2
  16. package/lib/server/config.js +11 -7
  17. package/lib/server/htmlTags.d.ts +6 -2
  18. package/lib/server/htmlTags.js +4 -0
  19. package/lib/server/i18n.d.ts +2 -3
  20. package/lib/server/index.d.ts +26 -10
  21. package/lib/server/index.js +34 -37
  22. package/lib/server/plugins/configs.d.ts +8 -2
  23. package/lib/server/plugins/configs.js +64 -5
  24. package/lib/server/plugins/index.d.ts +4 -0
  25. package/lib/server/plugins/index.js +20 -21
  26. package/lib/server/plugins/init.d.ts +5 -15
  27. package/lib/server/plugins/init.js +8 -61
  28. package/lib/server/{moduleShorthand.d.ts → plugins/moduleShorthand.d.ts} +0 -0
  29. package/lib/server/{moduleShorthand.js → plugins/moduleShorthand.js} +0 -0
  30. package/lib/server/plugins/pluginIds.d.ts +4 -0
  31. package/lib/server/plugins/pluginIds.js +4 -2
  32. package/lib/server/plugins/presets.d.ts +6 -5
  33. package/lib/server/plugins/presets.js +7 -3
  34. package/lib/server/routes.d.ts +3 -2
  35. package/lib/server/routes.js +49 -24
  36. package/lib/server/siteMetadata.d.ts +2 -2
  37. package/lib/server/siteMetadata.js +2 -1
  38. package/lib/server/translations/translations.js +1 -4
  39. package/lib/webpack/aliases/index.d.ts +29 -0
  40. package/lib/webpack/aliases/index.js +106 -0
  41. package/lib/webpack/base.d.ts +0 -3
  42. package/lib/webpack/base.js +4 -21
  43. package/package.json +10 -11
  44. package/lib/choosePort.d.ts +0 -11
  45. package/lib/server/duplicateRoutes.d.ts +0 -8
  46. package/lib/server/duplicateRoutes.js +0 -42
  47. package/lib/server/themes/alias.d.ts +0 -9
  48. package/lib/server/themes/alias.js +0 -50
  49. package/lib/server/themes/index.d.ts +0 -12
  50. package/lib/server/themes/index.js +0 -47
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@docusaurus/core",
3
3
  "description": "Easy to Maintain Open Source Documentation Websites",
4
- "version": "0.0.0-4799",
4
+ "version": "0.0.0-4800",
5
5
  "license": "MIT",
6
6
  "publishConfig": {
7
7
  "access": "public"
@@ -41,13 +41,13 @@
41
41
  "@babel/runtime": "^7.17.8",
42
42
  "@babel/runtime-corejs3": "^7.17.8",
43
43
  "@babel/traverse": "^7.17.3",
44
- "@docusaurus/cssnano-preset": "0.0.0-4799",
45
- "@docusaurus/logger": "0.0.0-4799",
46
- "@docusaurus/mdx-loader": "0.0.0-4799",
44
+ "@docusaurus/cssnano-preset": "0.0.0-4800",
45
+ "@docusaurus/logger": "0.0.0-4800",
46
+ "@docusaurus/mdx-loader": "0.0.0-4800",
47
47
  "@docusaurus/react-loadable": "5.5.2",
48
- "@docusaurus/utils": "0.0.0-4799",
49
- "@docusaurus/utils-common": "0.0.0-4799",
50
- "@docusaurus/utils-validation": "0.0.0-4799",
48
+ "@docusaurus/utils": "0.0.0-4800",
49
+ "@docusaurus/utils-common": "0.0.0-4800",
50
+ "@docusaurus/utils-validation": "0.0.0-4800",
51
51
  "@slorber/static-site-generator-webpack-plugin": "^4.0.4",
52
52
  "@svgr/webpack": "^6.2.1",
53
53
  "autoprefixer": "^10.4.4",
@@ -74,7 +74,6 @@
74
74
  "html-tags": "^3.1.0",
75
75
  "html-webpack-plugin": "^5.5.0",
76
76
  "import-fresh": "^3.3.0",
77
- "is-root": "^2.1.0",
78
77
  "leven": "^3.1.0",
79
78
  "lodash": "^4.17.21",
80
79
  "mini-css-extract-plugin": "^2.6.0",
@@ -106,8 +105,8 @@
106
105
  "webpackbar": "^5.0.2"
107
106
  },
108
107
  "devDependencies": {
109
- "@docusaurus/module-type-aliases": "0.0.0-4799",
110
- "@docusaurus/types": "0.0.0-4799",
108
+ "@docusaurus/module-type-aliases": "0.0.0-4800",
109
+ "@docusaurus/types": "0.0.0-4800",
111
110
  "@types/detect-port": "^1.3.2",
112
111
  "@types/nprogress": "^0.2.0",
113
112
  "@types/react-dom": "^17.0.14",
@@ -128,5 +127,5 @@
128
127
  "engines": {
129
128
  "node": ">=14"
130
129
  },
131
- "gitHead": "f0feed7df346c16329386f13a7f8522660b97a51"
130
+ "gitHead": "d38da3dea586e001b552facb59e41f2547a38cac"
132
131
  }
@@ -1,11 +0,0 @@
1
- /**
2
- * Copyright (c) Facebook, Inc. and its affiliates.
3
- *
4
- * This source code is licensed under the MIT license found in the
5
- * LICENSE file in the root directory of this source tree.
6
- */
7
- /**
8
- * Detects if program is running on port and prompts user
9
- * to choose another if port is already being used
10
- */
11
- export default function choosePort(host: string, defaultPort: number): Promise<number | null>;
@@ -1,8 +0,0 @@
1
- /**
2
- * Copyright (c) Facebook, Inc. and its affiliates.
3
- *
4
- * This source code is licensed under the MIT license found in the
5
- * LICENSE file in the root directory of this source tree.
6
- */
7
- import type { ReportingSeverity, RouteConfig } from '@docusaurus/types';
8
- export declare function handleDuplicateRoutes(pluginsRouteConfigs: RouteConfig[], onDuplicateRoutes: ReportingSeverity): void;
@@ -1,42 +0,0 @@
1
- "use strict";
2
- /**
3
- * Copyright (c) Facebook, Inc. and its affiliates.
4
- *
5
- * This source code is licensed under the MIT license found in the
6
- * LICENSE file in the root directory of this source tree.
7
- */
8
- Object.defineProperty(exports, "__esModule", { value: true });
9
- exports.handleDuplicateRoutes = void 0;
10
- const utils_1 = require("@docusaurus/utils");
11
- const utils_2 = require("./utils");
12
- function getAllDuplicateRoutes(pluginsRouteConfigs) {
13
- const allRoutes = (0, utils_2.getAllFinalRoutes)(pluginsRouteConfigs).map((routeConfig) => routeConfig.path);
14
- const seenRoutes = new Set();
15
- return allRoutes.filter((route) => {
16
- if (seenRoutes.has(route)) {
17
- return true;
18
- }
19
- seenRoutes.add(route);
20
- return false;
21
- });
22
- }
23
- function getDuplicateRoutesMessage(allDuplicateRoutes) {
24
- const message = allDuplicateRoutes
25
- .map((duplicateRoute) => `- Attempting to create page at ${duplicateRoute}, but a page already exists at this route.`)
26
- .join('\n');
27
- return message;
28
- }
29
- function handleDuplicateRoutes(pluginsRouteConfigs, onDuplicateRoutes) {
30
- if (onDuplicateRoutes === 'ignore') {
31
- return;
32
- }
33
- const duplicatePaths = getAllDuplicateRoutes(pluginsRouteConfigs);
34
- const message = getDuplicateRoutesMessage(duplicatePaths);
35
- if (message) {
36
- const finalMessage = `Duplicate routes found!
37
- ${message}
38
- This could lead to non-deterministic routing behavior.`;
39
- (0, utils_1.reportMessage)(finalMessage, onDuplicateRoutes);
40
- }
41
- }
42
- exports.handleDuplicateRoutes = handleDuplicateRoutes;
@@ -1,9 +0,0 @@
1
- /**
2
- * Copyright (c) Facebook, Inc. and its affiliates.
3
- *
4
- * This source code is licensed under the MIT license found in the
5
- * LICENSE file in the root directory of this source tree.
6
- */
7
- import type { ThemeAliases } from '@docusaurus/types';
8
- export declare function sortAliases(aliases: ThemeAliases): ThemeAliases;
9
- export declare function themeAlias(themePath: string, addOriginalAlias: boolean): Promise<ThemeAliases>;
@@ -1,50 +0,0 @@
1
- "use strict";
2
- /**
3
- * Copyright (c) Facebook, Inc. and its affiliates.
4
- *
5
- * This source code is licensed under the MIT license found in the
6
- * LICENSE file in the root directory of this source tree.
7
- */
8
- Object.defineProperty(exports, "__esModule", { value: true });
9
- exports.themeAlias = exports.sortAliases = void 0;
10
- const tslib_1 = require("tslib");
11
- const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
12
- const path_1 = tslib_1.__importDefault(require("path"));
13
- const utils_1 = require("@docusaurus/utils");
14
- const lodash_1 = tslib_1.__importDefault(require("lodash"));
15
- // Order of Webpack aliases is important because one alias can shadow another
16
- // This ensure @theme/NavbarItem alias is after @theme/NavbarItem/LocaleDropdown
17
- // See https://github.com/facebook/docusaurus/pull/3922
18
- // See https://github.com/facebook/docusaurus/issues/5382
19
- function sortAliases(aliases) {
20
- // Alphabetical order by default
21
- const entries = lodash_1.default.sortBy(Object.entries(aliases), ([alias]) => alias);
22
- // @theme/NavbarItem should be after @theme/NavbarItem/LocaleDropdown
23
- entries.sort(([alias1], [alias2]) =>
24
- // eslint-disable-next-line no-nested-ternary
25
- alias1.includes(`${alias2}/`) ? -1 : alias2.includes(`${alias1}/`) ? 1 : 0);
26
- return Object.fromEntries(entries);
27
- }
28
- exports.sortAliases = sortAliases;
29
- async function themeAlias(themePath, addOriginalAlias) {
30
- if (!(await fs_extra_1.default.pathExists(themePath))) {
31
- return {};
32
- }
33
- const themeComponentFiles = await (0, utils_1.Globby)(['**/*.{js,jsx,ts,tsx}'], {
34
- cwd: themePath,
35
- });
36
- const aliases = {};
37
- themeComponentFiles.forEach((relativeSource) => {
38
- const filePath = path_1.default.join(themePath, relativeSource);
39
- const fileName = (0, utils_1.fileToPath)(relativeSource);
40
- const aliasName = (0, utils_1.posixPath)((0, utils_1.normalizeUrl)(['@theme', fileName]).replace(/\/$/, ''));
41
- aliases[aliasName] = filePath;
42
- if (addOriginalAlias) {
43
- // For swizzled components to access the original.
44
- const originalAliasName = (0, utils_1.posixPath)((0, utils_1.normalizeUrl)(['@theme-original', fileName]).replace(/\/$/, ''));
45
- aliases[originalAliasName] = filePath;
46
- }
47
- });
48
- return sortAliases(aliases);
49
- }
50
- exports.themeAlias = themeAlias;
@@ -1,12 +0,0 @@
1
- /**
2
- * Copyright (c) Facebook, Inc. and its affiliates.
3
- *
4
- * This source code is licensed under the MIT license found in the
5
- * LICENSE file in the root directory of this source tree.
6
- */
7
- import type { ThemeAliases, LoadedPlugin } from '@docusaurus/types';
8
- export declare function loadThemeAliases(themePaths: string[], userThemePaths: string[]): Promise<ThemeAliases>;
9
- export declare function loadPluginsThemeAliases({ siteDir, plugins, }: {
10
- siteDir: string;
11
- plugins: LoadedPlugin[];
12
- }): Promise<ThemeAliases>;
@@ -1,47 +0,0 @@
1
- "use strict";
2
- /**
3
- * Copyright (c) Facebook, Inc. and its affiliates.
4
- *
5
- * This source code is licensed under the MIT license found in the
6
- * LICENSE file in the root directory of this source tree.
7
- */
8
- Object.defineProperty(exports, "__esModule", { value: true });
9
- exports.loadPluginsThemeAliases = exports.loadThemeAliases = void 0;
10
- const tslib_1 = require("tslib");
11
- const path_1 = tslib_1.__importDefault(require("path"));
12
- const utils_1 = require("@docusaurus/utils");
13
- const alias_1 = require("./alias");
14
- const ThemeFallbackDir = path_1.default.join(__dirname, '../../client/theme-fallback');
15
- async function loadThemeAliases(themePaths, userThemePaths) {
16
- const aliases = {};
17
- for (const themePath of themePaths) {
18
- const themeAliases = await (0, alias_1.themeAlias)(themePath, true);
19
- Object.entries(themeAliases).forEach(([aliasKey, alias]) => {
20
- // If this alias shadows a previous one, use @theme-init to preserve the
21
- // initial one. @theme-init is only applied once: to the initial theme
22
- // that provided this component
23
- if (aliasKey in aliases) {
24
- const componentName = aliasKey.substring(aliasKey.indexOf('/') + 1);
25
- const initAlias = `@theme-init/${componentName}`;
26
- if (!(initAlias in aliases)) {
27
- aliases[initAlias] = aliases[aliasKey];
28
- }
29
- }
30
- aliases[aliasKey] = alias;
31
- });
32
- }
33
- for (const themePath of userThemePaths) {
34
- const userThemeAliases = await (0, alias_1.themeAlias)(themePath, false);
35
- Object.assign(aliases, userThemeAliases);
36
- }
37
- return (0, alias_1.sortAliases)(aliases);
38
- }
39
- exports.loadThemeAliases = loadThemeAliases;
40
- function loadPluginsThemeAliases({ siteDir, plugins, }) {
41
- const pluginThemes = plugins
42
- .map((plugin) => plugin.getThemePath && path_1.default.resolve(plugin.path, plugin.getThemePath()))
43
- .filter((x) => Boolean(x));
44
- const userTheme = path_1.default.resolve(siteDir, utils_1.THEME_PATH);
45
- return loadThemeAliases([ThemeFallbackDir, ...pluginThemes], [userTheme]);
46
- }
47
- exports.loadPluginsThemeAliases = loadPluginsThemeAliases;