@docusaurus/core 0.0.0-4632 → 0.0.0-4635

package/lib/commands/swizzle/index.js

@@ -0,0 +1,115 @@
+"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 logger_1 = (0, tslib_1.__importDefault)(require("@docusaurus/logger"));
+const themes_1 = require("./themes");
+const components_1 = require("./components");
+const tables_1 = require("./tables");
+const common_1 = require("./common");
+const actions_1 = require("./actions");
+const config_1 = require("./config");
+const prompts_1 = require("./prompts");
+const context_1 = require("./context");
+async function listAllThemeComponents({ themeNames, plugins, typescript, }) {
+    const themeComponentsTables = (await Promise.all(themeNames.map(async (themeName) => {
+        const themePath = (0, themes_1.getThemePath)({ themeName, plugins, typescript });
+        const swizzleConfig = (0, config_1.getThemeSwizzleConfig)(themeName, plugins);
+        const themeComponents = await (0, components_1.getThemeComponents)({
+            themeName,
+            themePath,
+            swizzleConfig,
+        });
+        return (0, tables_1.themeComponentsTable)(themeComponents);
+    }))).join('\n\n');
+    logger_1.default.info(`All theme components available to swizzle:
+
+${themeComponentsTables}
+
+${(0, tables_1.helpTables)()}
+    `);
+    return process.exit(0);
+}
+async function ensureActionSafety({ componentName, componentConfig, action, danger, }) {
+    const actionStatus = componentConfig.actions[action];
+    if (actionStatus === 'forbidden') {
+        logger_1.default.error `
+Swizzle action name=${action} is forbidden for component name=${componentName}
+`;
+        return process.exit(1);
+    }
+    if (actionStatus === 'unsafe' && !danger) {
+        logger_1.default.warn `
+Swizzle action name=${action} is unsafe to perform on name=${componentName}.
+It is more likely to be affected by breaking changes in the future
+If you want to swizzle it, use the code=${'--danger'} flag, or confirm that you understand the risks.
+`;
+        const swizzleDangerousComponent = await (0, prompts_1.askSwizzleDangerousComponent)();
+        if (!swizzleDangerousComponent) {
+            return process.exit(1);
+        }
+    }
+    return undefined;
+}
+async function swizzle(siteDir, themeNameParam, componentNameParam, optionsParam) {
+    const options = (0, common_1.normalizeOptions)(optionsParam);
+    const { list, danger, typescript } = options;
+    const { plugins } = await (0, context_1.initSwizzleContext)(siteDir);
+    const themeNames = (0, themes_1.getThemeNames)(plugins);
+    if (list && !themeNameParam) {
+        await listAllThemeComponents({ themeNames, plugins, typescript });
+    }
+    const themeName = await (0, themes_1.getThemeName)({ themeNameParam, themeNames, list });
+    const themePath = (0, themes_1.getThemePath)({ themeName, plugins, typescript });
+    const swizzleConfig = (0, config_1.getThemeSwizzleConfig)(themeName, plugins);
+    const themeComponents = await (0, components_1.getThemeComponents)({
+        themeName,
+        themePath,
+        swizzleConfig,
+    });
+    const componentName = await (0, components_1.getComponentName)({
+        componentNameParam,
+        themeComponents,
+        list,
+    });
+    const componentConfig = themeComponents.getConfig(componentName);
+    const action = await (0, actions_1.getAction)(componentConfig, options);
+    await ensureActionSafety({ componentName, componentConfig, action, danger });
+    async function executeAction() {
+        switch (action) {
+            case 'wrap': {
+                const result = await (0, actions_1.wrap)({
+                    siteDir,
+                    themePath,
+                    componentName,
+                    typescript,
+                });
+                logger_1.default.success `
+Created wrapper of name=${componentName} from name=${themeName} in path=${result.createdFiles}.
+`;
+                return result;
+            }
+            case 'eject': {
+                const result = await (0, actions_1.eject)({
+                    siteDir,
+                    themePath,
+                    componentName,
+                });
+                logger_1.default.success `
+Ejected name=${componentName} from name=${themeName} to path=${result.createdFiles}.
+`;
+                return result;
+            }
+            default:
+                throw new Error(`Unexpected action ${action}`);
+        }
+    }
+    await executeAction();
+    return process.exit(0);
+}
+exports.default = swizzle;

package/lib/commands/swizzle/prompts.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 { ThemeComponents } from './components';
+import type { SwizzleAction, SwizzleComponentConfig } from '@docusaurus/types';
+export declare function askThemeName(themeNames: string[]): Promise<string>;
+export declare function askComponentName(themeComponents: ThemeComponents): Promise<string>;
+export declare function askSwizzleDangerousComponent(): Promise<boolean>;
+export declare function askSwizzleAction(componentConfig: SwizzleComponentConfig): Promise<SwizzleAction>;

package/lib/commands/swizzle/prompts.js

@@ -0,0 +1,110 @@
+"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.askSwizzleAction = exports.askSwizzleDangerousComponent = exports.askComponentName = exports.askThemeName = void 0;
+const tslib_1 = require("tslib");
+const logger_1 = (0, tslib_1.__importDefault)(require("@docusaurus/logger"));
+const prompts_1 = (0, tslib_1.__importDefault)(require("prompts"));
+const common_1 = require("./common");
+const ExitTitle = logger_1.default.yellow('[Exit]');
+async function askThemeName(themeNames) {
+    const { themeName } = await (0, prompts_1.default)({
+        type: 'select',
+        name: 'themeName',
+        message: 'Select a theme to swizzle:',
+        choices: themeNames
+            .map((theme) => ({ title: theme, value: theme }))
+            .concat({ title: ExitTitle, value: '[Exit]' }),
+    });
+    if (!themeName || themeName === '[Exit]') {
+        process.exit(0);
+    }
+    return themeName;
+}
+exports.askThemeName = askThemeName;
+async function askComponentName(themeComponents) {
+    function formatComponentName(componentName) {
+        const anySafe = themeComponents.hasAnySafeAction(componentName);
+        const allSafe = themeComponents.hasAllSafeAction(componentName);
+        const safestStatus = anySafe ? 'safe' : 'unsafe'; // Not 100% accurate but good enough for now.
+        const partiallySafe = anySafe && !allSafe;
+        return `${componentName}${(0, common_1.actionStatusSuffix)(safestStatus, {
+            partiallySafe,
+        })}`;
+    }
+    const { componentName } = await (0, prompts_1.default)({
+        type: 'autocomplete',
+        name: 'componentName',
+        message: `
+Select or type the component to swizzle.
+${common_1.PartiallySafeHint} = not safe for all swizzle actions
+`,
+        // This doesn't work well in small-height terminals (like IDE)
+        // limit: 30,
+        // This does not work well and messes up with terminal scroll position
+        // limit: Number.POSITIVE_INFINITY,
+        choices: themeComponents.all
+            .map((compName) => ({
+            title: formatComponentName(compName),
+            value: compName,
+        }))
+            .concat({ title: ExitTitle, value: '[Exit]' }),
+        async suggest(input, choices) {
+            return choices.filter((choice) => choice.title.toLowerCase().includes(input.toLowerCase()));
+        },
+    });
+    logger_1.default.newLine();
+    if (!componentName || componentName === '[Exit]') {
+        return process.exit(0);
+    }
+    return componentName;
+}
+exports.askComponentName = askComponentName;
+async function askSwizzleDangerousComponent() {
+    const { switchToDanger } = await (0, prompts_1.default)({
+        type: 'select',
+        name: 'switchToDanger',
+        message: `Do you really want to swizzle this unsafe internal component?`,
+        choices: [
+            { title: logger_1.default.green('NO: cancel and stay safe'), value: false },
+            {
+                title: logger_1.default.red('YES: I know what I am doing!'),
+                value: true,
+            },
+            { title: ExitTitle, value: '[Exit]' },
+        ],
+    });
+    if (typeof switchToDanger === 'undefined' || switchToDanger === '[Exit]') {
+        return process.exit(0);
+    }
+    return !!switchToDanger;
+}
+exports.askSwizzleDangerousComponent = askSwizzleDangerousComponent;
+async function askSwizzleAction(componentConfig) {
+    const { action } = await (0, prompts_1.default)({
+        type: 'select',
+        name: 'action',
+        message: `Which swizzle action do you want to do?`,
+        choices: [
+            {
+                title: `${logger_1.default.bold('Wrap')}${(0, common_1.actionStatusSuffix)(componentConfig.actions.wrap)}`,
+                value: 'wrap',
+            },
+            {
+                title: `${logger_1.default.bold('Eject')}${(0, common_1.actionStatusSuffix)(componentConfig.actions.eject)}`,
+                value: 'eject',
+            },
+            { title: ExitTitle, value: '[Exit]' },
+        ],
+    });
+    if (typeof action === 'undefined' || action === '[Exit]') {
+        return process.exit(0);
+    }
+    return action;
+}
+exports.askSwizzleAction = askSwizzleAction;

package/lib/commands/swizzle/tables.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 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 { ThemeComponents } from './components';
+export declare function helpTables(): string;
+export declare function themeComponentsTable(themeComponents: ThemeComponents): string;

package/lib/commands/swizzle/tables.js

@@ -0,0 +1,116 @@
+"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.themeComponentsTable = exports.helpTables = void 0;
+const tslib_1 = require("tslib");
+const logger_1 = (0, tslib_1.__importDefault)(require("@docusaurus/logger"));
+const cli_table3_1 = (0, tslib_1.__importDefault)(require("cli-table3"));
+const lodash_1 = (0, tslib_1.__importDefault)(require("lodash"));
+const actions_1 = require("./actions");
+const common_1 = require("./common");
+function tableStatusLabel(status) {
+    return (0, common_1.actionStatusColor)(status, (0, common_1.actionStatusLabel)(status));
+}
+function getStatusLabel(status) {
+    return (0, common_1.actionStatusColor)(status, (0, common_1.actionStatusLabel)(status));
+}
+function statusTable() {
+    const table = new cli_table3_1.default({
+        head: ['Status', 'CLI option', 'Description'],
+    });
+    table.push({
+        [tableStatusLabel('safe')]: [
+            '',
+            `
+This component is safe to swizzle and was designed for this purpose.
+The swizzled component is retro-compatible with minor version upgrades.
+`,
+        ],
+    });
+    table.push({
+        [tableStatusLabel('unsafe')]: [
+            logger_1.default.code('--danger'),
+            `
+This component is unsafe to swizzle, but you can still do it!
+Warning: we may release breaking changes within minor version upgrades.
+You will have to upgrade your component manually and maintain it over time.
+
+${logger_1.default.green('Tip')}: your customization can't be done in a ${tableStatusLabel('safe')} way?
+Report it here: https://github.com/facebook/docusaurus/discussions/5468
+`,
+        ],
+    });
+    table.push({
+        [tableStatusLabel('forbidden')]: [
+            '',
+            `
+This component should not meant to be swizzled.
+`,
+        ],
+    });
+    return table.toString();
+}
+function actionsTable() {
+    const table = new cli_table3_1.default({
+        head: ['Actions', 'CLI option', 'Description'],
+    });
+    table.push({
+        [logger_1.default.bold('Wrap')]: [
+            logger_1.default.code('--wrap'),
+            `
+Creates a wrapper around the original theme component.
+Allows rendering other components before/after the original theme component.
+
+${logger_1.default.green('Tip')}: prefer ${logger_1.default.code('--wrap')} whenever possible to reduces the amount of code to maintain.
+      `,
+        ],
+    });
+    table.push({
+        [logger_1.default.bold('Eject')]: [
+            logger_1.default.code('--eject'),
+            `
+Ejects the full source code of the original theme component.
+Allows overriding the original component entirely with your own UI and logic.
+
+${logger_1.default.green('Tip')}: ${logger_1.default.code('--eject')} can be useful to completely redesign a component.
+`,
+        ],
+    });
+    return table.toString();
+}
+function helpTables() {
+    return `${logger_1.default.bold('Swizzle actions')}:
+${actionsTable()}
+
+${logger_1.default.bold('Swizzle safety statuses')}:
+${statusTable()}
+
+${logger_1.default.bold('Swizzle guide')}: https://docusaurus.io/docs/swizzling`;
+}
+exports.helpTables = helpTables;
+function themeComponentsTable(themeComponents) {
+    const table = new cli_table3_1.default({
+        head: [
+            'Component name',
+            ...actions_1.SwizzleActions.map((action) => lodash_1.default.capitalize(action)),
+            'Description',
+        ],
+    });
+    themeComponents.all.forEach((component) => {
+        table.push({
+            [component]: [
+                ...actions_1.SwizzleActions.map((action) => getStatusLabel(themeComponents.getActionStatus(component, action))),
+                themeComponents.getDescription(component),
+            ],
+        });
+    });
+    return `${logger_1.default.bold(`Components available for swizzle in ${logger_1.default.name(themeComponents.themeName)}`)}:
+${table.toString()}
+`;
+}
+exports.themeComponentsTable = themeComponentsTable;

package/lib/commands/swizzle/themes.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 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 SwizzlePlugin } from './common';
+export declare function pluginToThemeName(plugin: SwizzlePlugin): string | undefined;
+export declare function getPluginByThemeName(plugins: SwizzlePlugin[], themeName: string): SwizzlePlugin;
+export declare function getThemeNames(plugins: SwizzlePlugin[]): string[];
+export declare function getThemeName({ themeNameParam, themeNames, list, }: {
+    themeNameParam: string | undefined;
+    themeNames: string[];
+    list: boolean | undefined;
+}): Promise<string>;
+export declare function getThemePath({ plugins, themeName, typescript, }: {
+    plugins: SwizzlePlugin[];
+    themeName: string;
+    typescript: boolean | undefined;
+}): string;

package/lib/commands/swizzle/themes.js

@@ -0,0 +1,105 @@
+"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.getThemePath = exports.getThemeName = exports.getThemeNames = exports.getPluginByThemeName = exports.pluginToThemeName = void 0;
+const tslib_1 = require("tslib");
+const logger_1 = (0, tslib_1.__importDefault)(require("@docusaurus/logger"));
+const leven_1 = (0, tslib_1.__importDefault)(require("leven"));
+const lodash_1 = (0, tslib_1.__importDefault)(require("lodash"));
+const prompts_1 = require("./prompts");
+const common_1 = require("./common");
+function pluginToThemeName(plugin) {
+    var _a;
+    if (plugin.instance.getThemePath) {
+        return ((_a = plugin.instance.version.name) !== null && _a !== void 0 ? _a : plugin.instance.name);
+    }
+    return undefined;
+}
+exports.pluginToThemeName = pluginToThemeName;
+function getPluginByThemeName(plugins, themeName) {
+    const plugin = plugins.find((p) => pluginToThemeName(p) === themeName);
+    if (!plugin) {
+        throw new Error(`Theme ${themeName} not found`);
+    }
+    return plugin;
+}
+exports.getPluginByThemeName = getPluginByThemeName;
+function getThemeNames(plugins) {
+    const themeNames = lodash_1.default.uniq(
+    // The fact that getThemePath is attached to the plugin instance makes
+    // this code impossible to optimize. If this is a static method, we don't
+    // need to initialize all plugins just to filter which are themes
+    // Benchmark: loadContext-58ms; initPlugins-323ms
+    plugins.map((plugin) => pluginToThemeName(plugin)).filter(Boolean));
+    // Opinionated ordering: user is most likely to swizzle:
+    // - the classic theme
+    // - official themes
+    // - official plugins
+    return lodash_1.default.orderBy(themeNames, [
+        (t) => t === '@docusaurus/theme-classic',
+        (t) => t.includes('@docusaurus/theme'),
+        (t) => t.includes('@docusaurus'),
+    ], ['desc', 'desc', 'desc']);
+}
+exports.getThemeNames = getThemeNames;
+// Returns a valid value if recovering is possible
+function handleInvalidThemeName({ themeNameParam, themeNames, }) {
+    // Trying to recover invalid value
+    // We look for potential matches that only differ in casing.
+    const differentCaseMatch = (0, common_1.findStringIgnoringCase)(themeNameParam, themeNames);
+    if (differentCaseMatch) {
+        logger_1.default.warn `Theme name=${themeNameParam} doesn't exist.`;
+        logger_1.default.info `name=${differentCaseMatch} will be used instead of name=${themeNameParam}.`;
+        return differentCaseMatch;
+    }
+    // TODO recover from short theme-names here: "classic" => "@docusaurus/theme-classic"
+    // No recovery value is possible: print error
+    const suggestion = themeNames.find((name) => (0, leven_1.default)(name, themeNameParam) < 4);
+    logger_1.default.error `Theme name=${themeNameParam} not found. ${suggestion
+        ? logger_1.default.interpolate `Did you mean name=${suggestion}?`
+        : logger_1.default.interpolate `Themes available for swizzle: ${themeNames}`}`;
+    return process.exit(1);
+}
+async function validateThemeName({ themeNameParam, themeNames, }) {
+    const isValidName = themeNames.includes(themeNameParam);
+    if (!isValidName) {
+        return handleInvalidThemeName({
+            themeNameParam,
+            themeNames,
+        });
+    }
+    return themeNameParam;
+}
+async function getThemeName({ themeNameParam, themeNames, list, }) {
+    if (list && !themeNameParam) {
+        logger_1.default.info `Themes available for swizzle: name=${themeNames}`;
+        return process.exit(0);
+    }
+    return themeNameParam
+        ? validateThemeName({ themeNameParam, themeNames })
+        : (0, prompts_1.askThemeName)(themeNames);
+}
+exports.getThemeName = getThemeName;
+function getThemePath({ plugins, themeName, typescript, }) {
+    var _a, _b, _c, _d;
+    const pluginInstance = getPluginByThemeName(plugins, themeName);
+    const themePath = typescript
+        ? (_b = (_a = pluginInstance.instance).getTypeScriptThemePath) === null || _b === void 0 ? void 0 : _b.call(_a)
+        : (_d = (_c = pluginInstance.instance).getThemePath) === null || _d === void 0 ? void 0 : _d.call(_c);
+    if (!themePath) {
+        logger_1.default.warn(typescript
+            ? logger_1.default.interpolate `name=${themeName} does not provide TypeScript theme code via ${'getTypeScriptThemePath()'}.`
+            : // This is... technically possible to happen, e.g. returning undefined
+                // from getThemePath. Plugins may intentionally or unintentionally
+                // disguise as themes?
+                logger_1.default.interpolate `name=${themeName} does not provide any theme code.`);
+        return process.exit(1);
+    }
+    return themePath;
+}
+exports.getThemePath = getThemePath;

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

@@ -4,7 +4,17 @@
  * 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, InitializedPlugin } from '@docusaurus/types';
+/// <reference types="node" />
+import type { ImportedPluginModule, LoadContext, PluginModule, PluginConfig, PluginOptions, InitializedPlugin } from '@docusaurus/types';
+export declare type NormalizedPluginConfig = {
+    plugin: PluginModule;
+    options: PluginOptions;
+    pluginModule?: {
+        path: string;
+        module: ImportedPluginModule;
+    };
+};
+export declare function normalizePluginConfigs(pluginConfigs: PluginConfig[], pluginRequire: NodeRequire): Promise<NormalizedPluginConfig[]>;
 export default function initPlugins({ pluginConfigs, context, }: {
     pluginConfigs: PluginConfig[];
     context: LoadContext;

package/lib/server/plugins/init.js

@@ -6,6 +6,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizePluginConfigs = void 0;
 const tslib_1 = require("tslib");
 const module_1 = require("module");
 const import_fresh_1 = (0, tslib_1.__importDefault)(require("import-fresh"));
@@ -65,6 +66,10 @@ async function normalizePluginConfig(pluginConfig, pluginRequire) {
     }
     throw new Error(`Unexpected: can't load plugin for following plugin config.\n${JSON.stringify(pluginConfig)}`);
 }
+async function normalizePluginConfigs(pluginConfigs, pluginRequire) {
+    return Promise.all(pluginConfigs.map((pluginConfig) => normalizePluginConfig(pluginConfig, pluginRequire)));
+}
+exports.normalizePluginConfigs = normalizePluginConfigs;
 function getOptionValidationFunction(normalizedPluginConfig) {
     var _a, _b, _c, _d;
     if (normalizedPluginConfig.pluginModule) {
@@ -85,6 +90,7 @@ 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);
+    const pluginConfigsNormalized = await normalizePluginConfigs(pluginConfigs, pluginRequire);
     async function doGetPluginVersion(normalizedPluginConfig) {
         var _a, _b;
         // get plugin version
@@ -120,8 +126,7 @@ async function initPlugins({ pluginConfigs, context, }) {
             id: (_a = normalizedPluginConfig.options.id) !== null && _a !== void 0 ? _a : utils_1.DEFAULT_PLUGIN_ID,
         };
     }
-    async function initializePlugin(pluginConfig) {
-        const normalizedPluginConfig = await normalizePluginConfig(pluginConfig, pluginRequire);
+    async function initializePlugin(normalizedPluginConfig) {
         const pluginVersion = await doGetPluginVersion(normalizedPluginConfig);
         const pluginOptions = doValidatePluginOptions(normalizedPluginConfig);
         // Side-effect: merge the normalized theme config in the original one
@@ -136,7 +141,7 @@ async function initPlugins({ pluginConfigs, context, }) {
             version: pluginVersion,
         };
     }
-    const plugins = (await Promise.all(pluginConfigs.map((pluginConfig) => {
+    const plugins = (await Promise.all(pluginConfigsNormalized.map((pluginConfig) => {
         if (!pluginConfig) {
             return null;
         }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@docusaurus/core",
   "description": "Easy to Maintain Open Source Documentation Websites",
-  "version": "0.0.0-4632",
+  "version": "0.0.0-4635",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -41,13 +41,13 @@
     "@babel/runtime": "^7.17.2",
     "@babel/runtime-corejs3": "^7.17.2",
     "@babel/traverse": "^7.17.3",
-    "@docusaurus/cssnano-preset": "0.0.0-4632",
-    "@docusaurus/logger": "0.0.0-4632",
-    "@docusaurus/mdx-loader": "0.0.0-4632",
+    "@docusaurus/cssnano-preset": "0.0.0-4635",
+    "@docusaurus/logger": "0.0.0-4635",
+    "@docusaurus/mdx-loader": "0.0.0-4635",
     "@docusaurus/react-loadable": "5.5.2",
-    "@docusaurus/utils": "0.0.0-4632",
-    "@docusaurus/utils-common": "0.0.0-4632",
-    "@docusaurus/utils-validation": "0.0.0-4632",
+    "@docusaurus/utils": "0.0.0-4635",
+    "@docusaurus/utils-common": "0.0.0-4635",
+    "@docusaurus/utils-validation": "0.0.0-4635",
     "@slorber/static-site-generator-webpack-plugin": "^4.0.1",
     "@svgr/webpack": "^6.2.1",
     "autoprefixer": "^10.4.2",
@@ -56,6 +56,7 @@
     "boxen": "^6.2.1",
     "chokidar": "^3.5.3",
     "clean-css": "^5.2.4",
+    "cli-table3": "^0.6.1",
     "combine-promises": "^1.1.0",
     "commander": "^5.1.0",
     "copy-webpack-plugin": "^10.2.4",
@@ -105,8 +106,8 @@
     "webpackbar": "^5.0.2"
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "0.0.0-4632",
-    "@docusaurus/types": "0.0.0-4632",
+    "@docusaurus/module-type-aliases": "0.0.0-4635",
+    "@docusaurus/types": "0.0.0-4635",
     "@types/detect-port": "^1.3.2",
     "@types/nprogress": "^0.2.0",
     "@types/react-dom": "^17.0.11",
@@ -117,7 +118,8 @@
     "@types/wait-on": "^5.3.1",
     "@types/webpack-bundle-analyzer": "^4.4.1",
     "react-test-renderer": "^17.0.2",
-    "tmp-promise": "^3.0.3"
+    "tmp-promise": "^3.0.3",
+    "tree-node-cli": "^1.5.2"
   },
   "peerDependencies": {
     "react": "^16.8.4 || ^17.0.0",
@@ -126,5 +128,5 @@
   "engines": {
     "node": ">=14"
   },
-  "gitHead": "71b49c9f003f9388f0e329846dce3d8ea82d5bc0"
+  "gitHead": "267eecbcba13dd00dd8b9a23bde16cfb2171ae7f"
 }

package/lib/commands/swizzle.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 { PluginConfig } from '@docusaurus/types';
-export declare function getPluginNames(plugins: PluginConfig[]): string[];
-export default function swizzle(siteDir: string, themeName?: string, componentName?: string, typescript?: boolean, danger?: boolean): Promise<void>;