@docusaurus/theme-classic 0.0.0-4430 → 0.0.0-4435

package/lib/index.js

@@ -178,7 +178,10 @@ options) {
     configureWebpack() {
       const prismLanguages = additionalLanguages.map(lang => `prism-${lang}`).join('|');
       return {
-        plugins: [new ContextReplacementPlugin(/prismjs[\\/]components$/, new RegExp(`^./(${prismLanguages})$`))]
+        plugins: [// This allows better optimization by only bundling those components
+        // that the user actually needs, because the modules are dynamically
+        // required and can't be known during compile time.
+        new ContextReplacementPlugin(/prismjs[\\/]components$/, new RegExp(`^./(${prismLanguages})$`))]
       };
     },
 

package/lib-next/theme/prism-include-languages.js

@@ -10,12 +10,19 @@ import siteConfig from '@generated/docusaurus.config';
 const prismIncludeLanguages = (PrismObject) => {
   if (ExecutionEnvironment.canUseDOM) {
     const {
-      themeConfig: {prism = {}},
+      themeConfig: {prism},
     } = siteConfig;
-    const {additionalLanguages = []} = prism;
+    const {additionalLanguages} = prism; // Prism components work on the Prism instance on the window, while
+    // prism-react-renderer uses its own Prism instance. We temporarily mount
+    // the instance onto window, import components to enhance it, then remove it
+    // to avoid polluting global namespace.
+    // You can mutate this object: registering plugins, deleting languages... As
+    // long as you don't re-assign it
+
     window.Prism = PrismObject;
     additionalLanguages.forEach((lang) => {
-      require(`prismjs/components/prism-${lang}`); // eslint-disable-line
+      // eslint-disable-next-line global-require, import/no-dynamic-require
+      require(`prismjs/components/prism-${lang}`);
     });
     delete window.Prism;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/theme-classic",
-  "version": "0.0.0-4430",
+  "version": "0.0.0-4435",
   "description": "Classic theme for Docusaurus",
   "main": "lib/index.js",
   "types": "src/theme-classic.d.ts",
@@ -23,14 +23,14 @@
     "update-code-translations": "node -e 'require(\"./update-code-translations.js\").run()'"
   },
   "dependencies": {
-    "@docusaurus/core": "0.0.0-4430",
-    "@docusaurus/plugin-content-blog": "0.0.0-4430",
-    "@docusaurus/plugin-content-docs": "0.0.0-4430",
-    "@docusaurus/plugin-content-pages": "0.0.0-4430",
-    "@docusaurus/theme-common": "0.0.0-4430",
-    "@docusaurus/theme-translations": "0.0.0-4430",
-    "@docusaurus/utils": "0.0.0-4430",
-    "@docusaurus/utils-validation": "0.0.0-4430",
+    "@docusaurus/core": "0.0.0-4435",
+    "@docusaurus/plugin-content-blog": "0.0.0-4435",
+    "@docusaurus/plugin-content-docs": "0.0.0-4435",
+    "@docusaurus/plugin-content-pages": "0.0.0-4435",
+    "@docusaurus/theme-common": "0.0.0-4435",
+    "@docusaurus/theme-translations": "0.0.0-4435",
+    "@docusaurus/utils": "0.0.0-4435",
+    "@docusaurus/utils-validation": "0.0.0-4435",
     "@mdx-js/mdx": "^1.6.21",
     "@mdx-js/react": "^1.6.21",
     "clsx": "^1.1.1",
@@ -45,8 +45,8 @@
     "rtlcss": "^3.3.0"
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "0.0.0-4430",
-    "@docusaurus/types": "0.0.0-4430",
+    "@docusaurus/module-type-aliases": "0.0.0-4435",
+    "@docusaurus/types": "0.0.0-4435",
     "@types/mdx-js__react": "^1.5.4",
     "@types/parse-numeric-range": "^0.0.1",
     "@types/rtlcss": "^3.1.1",
@@ -61,5 +61,5 @@
   "engines": {
     "node": ">=14"
   },
-  "gitHead": "548160af2a7413bdb58a37c37b73ff65be106db9"
+  "gitHead": "41656dfd8207e4a9d80de20fa5d9591f197a12b6"
 }

package/src/index.ts

@@ -18,13 +18,13 @@ import type {Plugin as PostCssPlugin} from 'postcss';
 import rtlcss from 'rtlcss';
 import {readDefaultCodeTranslationMessages} from '@docusaurus/theme-translations';
 import type {Options} from '@docusaurus/theme-classic';
+import type webpack from 'webpack';
 
 const requireFromDocusaurusCore = createRequire(
   require.resolve('@docusaurus/core/package.json'),
 );
-const ContextReplacementPlugin = requireFromDocusaurusCore(
-  'webpack/lib/ContextReplacementPlugin',
-);
+const ContextReplacementPlugin: typeof webpack.ContextReplacementPlugin =
+  requireFromDocusaurusCore('webpack/lib/ContextReplacementPlugin');
 
 // Need to be inlined to prevent dark mode FOUC
 // Make sure that the 'storageKey' is the same as the one in `/theme/hooks/useTheme.js`
@@ -172,6 +172,9 @@ export default function docusaurusThemeClassic(
 
       return {
         plugins: [
+          // This allows better optimization by only bundling those components
+          // that the user actually needs, because the modules are dynamically
+          // required and can't be known during compile time.
           new ContextReplacementPlugin(
             /prismjs[\\/]components$/,
             new RegExp(`^./(${prismLanguages})$`),

package/src/theme/prism-include-languages.ts

@@ -12,14 +12,21 @@ import type * as PrismNamespace from 'prismjs';
 const prismIncludeLanguages = (PrismObject: typeof PrismNamespace): void => {
   if (ExecutionEnvironment.canUseDOM) {
     const {
-      themeConfig: {prism = {}},
+      themeConfig: {prism},
     } = siteConfig;
-    const {additionalLanguages = []} = prism as {additionalLanguages: string[]};
+    const {additionalLanguages} = prism as {additionalLanguages: string[]};
 
+    // Prism components work on the Prism instance on the window, while
+    // prism-react-renderer uses its own Prism instance. We temporarily mount
+    // the instance onto window, import components to enhance it, then remove it
+    // to avoid polluting global namespace.
+    // You can mutate this object: registering plugins, deleting languages... As
+    // long as you don't re-assign it
     window.Prism = PrismObject;
 
     additionalLanguages.forEach((lang) => {
-      require(`prismjs/components/prism-${lang}`); // eslint-disable-line
+      // eslint-disable-next-line global-require, import/no-dynamic-require
+      require(`prismjs/components/prism-${lang}`);
     });
 
     delete (window as Window & {Prism?: typeof PrismNamespace}).Prism;