@docusaurus/core 2.0.0-beta.2 → 2.0.0-beta.22

package/lib/server/themes/alias.js

@@ -1,40 +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 globby_1 = tslib_1.__importDefault(require("globby"));
-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 = require("lodash");
-// TODO make async
-function themeAlias(themePath, addOriginalAlias) {
-    if (!fs_extra_1.default.pathExistsSync(themePath)) {
-        return {};
-    }
-    const themeComponentFiles = globby_1.default.sync(['**/*.{js,jsx,ts,tsx}'], {
-        cwd: themePath,
-    });
-    // See https://github.com/facebook/docusaurus/pull/3922
-    // ensure @theme/NavbarItem alias is created after @theme/NavbarItem/LocaleDropdown
-    const sortedThemeComponentFiles = lodash_1.sortBy(themeComponentFiles, (file) => file.endsWith('/index.js'));
-    const aliases = {};
-    sortedThemeComponentFiles.forEach((relativeSource) => {
-        const filePath = path_1.default.join(themePath, relativeSource);
-        const fileName = utils_1.fileToPath(relativeSource);
-        const aliasName = utils_1.posixPath(utils_1.normalizeUrl(['@theme', fileName]).replace(/\/$/, ''));
-        aliases[aliasName] = filePath;
-        if (addOriginalAlias) {
-            // For swizzled components to access the original.
-            const originalAliasName = utils_1.posixPath(utils_1.normalizeUrl(['@theme-original', fileName]).replace(/\/$/, ''));
-            aliases[originalAliasName] = filePath;
-        }
-    });
-    return 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 { ThemeAliases, LoadedPlugin } from '@docusaurus/types';
-export declare function loadThemeAliases(themePaths: string[], userThemePaths?: string[]): ThemeAliases;
-export declare function loadPluginsThemeAliases({ siteDir, plugins, }: {
-    siteDir: string;
-    plugins: LoadedPlugin[];
-}): 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 constants_1 = require("../../constants");
-const alias_1 = tslib_1.__importDefault(require("./alias"));
-const ThemeFallbackDir = path_1.default.resolve(__dirname, '../../client/theme-fallback');
-function buildThemeAliases(themeAliases, aliases = {}) {
-    Object.keys(themeAliases).forEach((aliasKey) => {
-        if (aliasKey in aliases) {
-            const componentName = aliasKey.substring(aliasKey.indexOf('/') + 1);
-            // eslint-disable-next-line no-param-reassign
-            aliases[`@theme-init/${componentName}`] = aliases[aliasKey];
-        }
-        // eslint-disable-next-line no-param-reassign
-        aliases[aliasKey] = themeAliases[aliasKey];
-    });
-    return aliases;
-}
-function loadThemeAliases(themePaths, userThemePaths = []) {
-    let aliases = {}; // TODO refactor, inelegant side-effect
-    themePaths.forEach((themePath) => {
-        const themeAliases = alias_1.default(themePath, true);
-        aliases = { ...aliases, ...buildThemeAliases(themeAliases, aliases) };
-    });
-    userThemePaths.forEach((themePath) => {
-        const userThemeAliases = alias_1.default(themePath, false);
-        aliases = { ...aliases, ...buildThemeAliases(userThemeAliases, aliases) };
-    });
-    return aliases;
-}
-exports.loadThemeAliases = loadThemeAliases;
-function loadPluginsThemeAliases({ siteDir, plugins, }) {
-    const pluginThemes = plugins
-        .map((plugin) => (plugin.getThemePath ? plugin.getThemePath() : undefined))
-        .filter((x) => Boolean(x));
-    const userTheme = path_1.default.resolve(siteDir, constants_1.THEME_PATH);
-    return loadThemeAliases([ThemeFallbackDir, ...pluginThemes], [userTheme]);
-}
-exports.loadPluginsThemeAliases = loadPluginsThemeAliases;

package/lib/server/versions/__fixtures__/package.json

@@ -1,3 +0,0 @@
-{
-  "version": "random-version"
-}

package/lib/server/versions/__tests/index.test.js

@@ -1,25 +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 __1 = require("..");
-const path_1 = require("path");
-describe('getPluginVersion', () => {
-    it('Can detect external packages plugins versions of correctly.', () => {
-        expect(__1.getPluginVersion(path_1.join(__dirname, '..', '__fixtures__', 'dummy-plugin.js'), 
-        // Make the plugin appear external.
-        path_1.join(__dirname, '..', '..', '..', '..', '..', '..', 'website'))).toEqual({ type: 'package', version: 'random-version' });
-    });
-    it('Can detect project plugins versions correctly.', () => {
-        expect(__1.getPluginVersion(path_1.join(__dirname, '..', '__fixtures__', 'dummy-plugin.js'), 
-        // Make the plugin appear project local.
-        path_1.join(__dirname, '..', '__fixtures__'))).toEqual({ type: 'project' });
-    });
-    it('Can detect local packages versions correctly.', () => {
-        expect(__1.getPluginVersion('/', '/')).toEqual({ type: 'local' });
-    });
-});

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

@@ -1,10 +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 { DocusaurusPluginVersionInformation } from '@docusaurus/types';
-export declare function getPackageJsonVersion(packageJsonPath: string): string | undefined;
-export declare function getPackageJsonName(packageJsonPath: string): string | undefined;
-export declare function getPluginVersion(pluginPath: string, siteDir: string): DocusaurusPluginVersionInformation;

package/lib/server/versions/index.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.getPluginVersion = exports.getPackageJsonName = exports.getPackageJsonVersion = void 0;
-const fs_extra_1 = require("fs-extra");
-const path_1 = require("path");
-function getPackageJsonVersion(packageJsonPath) {
-    if (fs_extra_1.existsSync(packageJsonPath)) {
-        // eslint-disable-next-line @typescript-eslint/no-var-requires, import/no-dynamic-require, global-require
-        const { version } = require(packageJsonPath);
-        return typeof version === 'string' ? version : undefined;
-    }
-    return undefined;
-}
-exports.getPackageJsonVersion = getPackageJsonVersion;
-function getPackageJsonName(packageJsonPath) {
-    if (fs_extra_1.existsSync(packageJsonPath)) {
-        // eslint-disable-next-line @typescript-eslint/no-var-requires, import/no-dynamic-require, global-require
-        const { name } = require(packageJsonPath);
-        return typeof name === 'string' ? name : undefined;
-    }
-    return undefined;
-}
-exports.getPackageJsonName = getPackageJsonName;
-function getPluginVersion(pluginPath, siteDir) {
-    let potentialPluginPackageJsonDirectory = path_1.dirname(pluginPath);
-    while (potentialPluginPackageJsonDirectory !== '/') {
-        const packageJsonPath = path_1.join(potentialPluginPackageJsonDirectory, 'package.json');
-        if (fs_extra_1.existsSync(packageJsonPath) && fs_extra_1.lstatSync(packageJsonPath).isFile()) {
-            if (potentialPluginPackageJsonDirectory === siteDir) {
-                // If the plugin belongs to the same docusaurus project, we classify it as local plugin.
-                return { type: 'project' };
-            }
-            return {
-                type: 'package',
-                name: getPackageJsonName(packageJsonPath),
-                version: getPackageJsonVersion(packageJsonPath),
-            };
-        }
-        potentialPluginPackageJsonDirectory = path_1.dirname(potentialPluginPackageJsonDirectory);
-    }
-    // In rare cases where a plugin is a path where no parent directory contains package.json, we can only classify it as local.
-    return { type: 'local' };
-}
-exports.getPluginVersion = getPluginVersion;

package/lib/webpack/react-dev-utils-webpack5/README.md

@@ -1,11 +0,0 @@
-This is a temporary copy of
-
-CRA / react-dev-utils does not support Webpack 5 yet
-
-https://github.com/facebook/create-react-app/issues/9994
-
-This folder is a temporary copy of some react-dev-utils code to which we made some changes to support Webpack 5 without warnings
-
-TODO remove this folder once Webpack 5 is supported (https://github.com/facebook/create-react-app/issues/9994)
-
-The comment `// modified for Docusaurus` is added near the modified elements

package/lib/webpack/react-dev-utils-webpack5/evalSourceMapMiddleware.js

@@ -1,57 +0,0 @@
-/**
- * Copyright (c) 2015-present, Facebook, Inc.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-/* eslint-disable */
-/*
- * THIS FILE IS MODIFIED FOR DOCUSAURUS
- * the above copyright header must be preserved for license compliance.
- */
-
-/*
-Implementation based on comment: https://github.com/facebook/create-react-app/issues/9994#issuecomment-811289191
- */
-
-function base64SourceMap(source) {
-  const base64 = Buffer.from(JSON.stringify(source.map()), 'utf8').toString(
-    'base64',
-  );
-  return `data:application/json;charset=utf-8;base64,${base64}`;
-}
-
-// modified for Docusaurus => remove webpack 5 deprecation warnings
-// See https://github.com/facebook/create-react-app/issues/9994#issuecomment-811289191
-function getSourceById(server, id) {
-  const module = Array.from(server._stats.compilation.modules).find(
-    (m) => server._stats.compilation.chunkGraph.getModuleId(m) == id,
-  );
-  return module.originalSource();
-}
-
-/*
- * Middleware responsible for retrieving a generated source
- * Receives a webpack internal url: "webpack-internal:///<module-id>"
- * Returns a generated source: "<source-text><sourceMappingURL><sourceURL>"
- *
- * Based on EvalSourceMapDevToolModuleTemplatePlugin.js
- */
-module.exports = function createEvalSourceMapMiddleware(server) {
-  return function handleWebpackInternalMiddleware(req, res, next) {
-    if (req.url.startsWith('/__get-internal-source')) {
-      const fileName = req.query.fileName;
-      const id = fileName.match(/webpack-internal:\/\/\/(.+)/)[1];
-      if (!id || !server._stats) {
-        next();
-      }
-
-      const source = getSourceById(server, id);
-      const sourceMapURL = `//# sourceMappingURL=${base64SourceMap(source)}`;
-      const sourceURL = `//# sourceURL=webpack-internal:///${module.id}`;
-      res.end(`${source.source()}\n${sourceMapURL}\n${sourceURL}`);
-    } else {
-      next();
-    }
-  };
-};

package/lib/webpack/react-dev-utils-webpack5/formatWebpackMessages.js

@@ -1,138 +0,0 @@
-/**
- * Copyright (c) 2015-present, Facebook, Inc.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-/* eslint-disable */
-/*
- * THIS FILE IS MODIFIED FOR DOCUSAURUS
- * the above copyright header must be preserved for license compliance.
- */
-
-/*
-Implementation has been copied from https://github.com/facebook/create-react-app/pull/10656
- */
-
-const friendlySyntaxErrorLabel = 'Syntax error:';
-
-function isLikelyASyntaxError(message) {
-  return message.indexOf(friendlySyntaxErrorLabel) !== -1;
-}
-
-// Cleans up webpack error messages.
-function formatMessage(message) {
-  let lines = [];
-
-  // modified for Docusaurus => see https://github.com/facebook/create-react-app/pull/10656
-  if (typeof message === 'string') {
-    lines = message.split('\n');
-  } else if ('message' in message) {
-    lines = message['message'].split('\n');
-  } else if (Array.isArray(message)) {
-    message.forEach((message) => {
-      if ('message' in message) {
-        lines = message['message'].split('\n');
-      }
-    });
-  }
-
-  // Strip webpack-added headers off errors/warnings
-  // https://github.com/webpack/webpack/blob/master/lib/ModuleError.js
-  lines = lines.filter((line) => !/Module [A-z ]+\(from/.test(line));
-
-  // Transform parsing error into syntax error
-  // TODO: move this to our ESLint formatter?
-  lines = lines.map((line) => {
-    const parsingError = /Line (\d+):(?:(\d+):)?\s*Parsing error: (.+)$/.exec(
-      line,
-    );
-    if (!parsingError) {
-      return line;
-    }
-    const [, errorLine, errorColumn, errorMessage] = parsingError;
-    return `${friendlySyntaxErrorLabel} ${errorMessage} (${errorLine}:${errorColumn})`;
-  });
-
-  message = lines.join('\n');
-  // Smoosh syntax errors (commonly found in CSS)
-  message = message.replace(
-    /SyntaxError\s+\((\d+):(\d+)\)\s*(.+?)\n/g,
-    `${friendlySyntaxErrorLabel} $3 ($1:$2)\n`,
-  );
-  // Clean up export errors
-  message = message.replace(
-    /^.*export '(.+?)' was not found in '(.+?)'.*$/gm,
-    `Attempted import error: '$1' is not exported from '$2'.`,
-  );
-  message = message.replace(
-    /^.*export 'default' \(imported as '(.+?)'\) was not found in '(.+?)'.*$/gm,
-    `Attempted import error: '$2' does not contain a default export (imported as '$1').`,
-  );
-  message = message.replace(
-    /^.*export '(.+?)' \(imported as '(.+?)'\) was not found in '(.+?)'.*$/gm,
-    `Attempted import error: '$1' is not exported from '$3' (imported as '$2').`,
-  );
-  lines = message.split('\n');
-
-  // Remove leading newline
-  if (lines.length > 2 && lines[1].trim() === '') {
-    lines.splice(1, 1);
-  }
-  // Clean up file name
-  lines[0] = lines[0].replace(/^(.*) \d+:\d+-\d+$/, '$1');
-
-  // Cleans up verbose "module not found" messages for files and packages.
-  if (lines[1] && lines[1].indexOf('Module not found: ') === 0) {
-    lines = [
-      lines[0],
-      lines[1]
-        .replace('Error: ', '')
-        .replace('Module not found: Cannot find file:', 'Cannot find file:'),
-    ];
-  }
-
-  // Add helpful message for users trying to use Sass for the first time
-  if (lines[1] && lines[1].match(/Cannot find module.+node-sass/)) {
-    lines[1] = 'To import Sass files, you first need to install node-sass.\n';
-    lines[1] +=
-      'Run `npm install node-sass` or `yarn add node-sass` inside your workspace.';
-  }
-
-  message = lines.join('\n');
-  // Internal stacks are generally useless so we strip them... with the
-  // exception of stacks containing `webpack:` because they're normally
-  // from user code generated by webpack. For more information see
-  // https://github.com/facebook/create-react-app/pull/1050
-  message = message.replace(
-    /^\s*at\s((?!webpack:).)*:\d+:\d+[\s)]*(\n|$)/gm,
-    '',
-  ); // at ... ...:x:y
-  message = message.replace(/^\s*at\s<anonymous>(\n|$)/gm, ''); // at <anonymous>
-  lines = message.split('\n');
-
-  // Remove duplicated newlines
-  lines = lines.filter(
-    (line, index, arr) =>
-      index === 0 ||
-      line.trim() !== '' ||
-      line.trim() !== arr[index - 1].trim(),
-  );
-
-  // Reassemble the message
-  message = lines.join('\n');
-  return message.trim();
-}
-
-function formatWebpackMessages(json) {
-  const formattedErrors = json.errors.map(formatMessage);
-  const formattedWarnings = json.warnings.map(formatMessage);
-  const result = {errors: formattedErrors, warnings: formattedWarnings};
-  if (result.errors.some(isLikelyASyntaxError)) {
-    // If there are any syntax errors, show just them.
-    result.errors = result.errors.filter(isLikelyASyntaxError);
-  }
-  return result;
-}
-
-module.exports = formatWebpackMessages;