feat(core): brand new swizzle CLI experience

packages/docusaurus-plugin-debug/src/index.ts

@@ -26,6 +26,9 @@ export default function pluginDebug({
     getThemePath() {
       return path.resolve(__dirname, '../lib/theme');
     },
+    getTypeScriptThemePath() {
+      return path.resolve(__dirname, '../src/theme');
+    },
 
     async contentLoaded({actions: {createData, addRoute}, allContent}) {
       const allContentPath = await createData(

packages/docusaurus-plugin-pwa/src/index.ts

@@ -69,7 +69,10 @@ export default function (
     name: 'docusaurus-plugin-pwa',
 
     getThemePath() {
-      return path.resolve(__dirname, './theme');
+      return path.resolve(__dirname, '../lib/theme');
+    },
+    getTypeScriptThemePath() {
+      return path.resolve(__dirname, '../src/theme');
     },
 
     getClientModules() {

packages/docusaurus-theme-live-codeblock/src/index.ts

@@ -18,7 +18,10 @@ export default function theme(context: DocusaurusContext): Plugin {
     name: 'docusaurus-theme-live-codeblock',
 
     getThemePath() {
-      return path.resolve(__dirname, './theme');
+      return path.resolve(__dirname, '../lib/theme');
+    },
+    getTypeScriptThemePath() {
+      return path.resolve(__dirname, '../src/theme');
     },
 
     getDefaultCodeTranslationMessages() {

packages/docusaurus-theme-search-algolia/src/index.ts

@@ -42,11 +42,10 @@ export default function themeSearchAlgolia(context: LoadContext): Plugin<void> {
     name: 'docusaurus-theme-search-algolia',
 
     getThemePath() {
-      return path.resolve(__dirname, './theme');
+      return path.resolve(__dirname, '../lib/theme');
     },
-
     getTypeScriptThemePath() {
-      return path.resolve(__dirname, '..', 'src', 'theme');
+      return path.resolve(__dirname, '../src/theme');
     },
 
     getDefaultCodeTranslationMessages() {

packages/docusaurus-types/src/index.d.ts

@@ -322,7 +322,7 @@ export type PluginModule = {
     | Promise<Plugin<Content>>;
   validateOptions?: <T>(data: OptionValidationContext<T>) => T;
   validateThemeConfig?: <T>(data: ThemeConfigValidationContext<T>) => T;
-  getSwizzleComponentList?: () => string[];
+  getSwizzleComponentList?: () => string[] | undefined;
 };
 
 export type ImportedPluginModule = PluginModule & {

packages/docusaurus/bin/docusaurus.js

@@ -66,12 +66,16 @@ cli
   .command('swizzle [themeName] [componentName] [siteDir]')
   .description('Copy the theme files into website folder for customization.')
   .option(
-    '--typescript',
+    '-l, --list',
+    'only list the available themes/components without further prompting (default: false)',
+  )
+  .option(
+    '-t, --typescript',
     'copy TypeScript theme files when possible (default: false)',
   )
   .option('--danger', 'enable swizzle for internal component of themes')
-  .action((themeName, componentName, siteDir, {typescript, danger}) => {
-    swizzle(resolveDir(siteDir), themeName, componentName, typescript, danger);
+  .action((themeName, componentName, siteDir, options) => {
+    swizzle(resolveDir(siteDir), themeName, componentName, options);
   });
 
 cli