@mui/internal-docs-infra 0.12.1-canary.2 → 0.12.1-canary.21

package/withDocsInfra/withDeploymentConfig.mjs

@@ -170,12 +170,62 @@ function readCommitShaFromGit() {
     return undefined;
   }
 }
+
+/**
+ * Work around https://github.com/vercel/next.js/issues/91735.
+ * Next.js 16.2 does not assign MDX files to the React Server Components webpack layer.
+ */
+function patchMdxWebpackLayers(rules) {
+  for (const rule of rules) {
+    if (!rule || typeof rule !== 'object') {
+      continue;
+    }
+    const webpackRule = rule;
+
+    // page.mdx just verifies the regex matches MDX files
+    if (webpackRule.test instanceof RegExp && webpackRule.test.test('page.mdx')) {
+      const loaders = Array.isArray(webpackRule.use) ? webpackRule.use : [webpackRule.use];
+      for (const loader of loaders) {
+        if (!loader || typeof loader !== 'object') {
+          continue;
+        }
+        const webpackLoader = loader;
+        const {
+          options
+        } = webpackLoader;
+        if (typeof webpackLoader.loader === 'string' && webpackLoader.loader.includes('next-swc-loader') && options && typeof options === 'object') {
+          const webpackOptions = options;
+          if (webpackOptions.bundleLayer == null) {
+            webpackOptions.bundleLayer = 'rsc';
+          } else {
+            // Next.js now assigns the bundle layer itself, so this workaround is obsolete.
+            throw new Error('MDX webpack layer workaround is obsolete; remove patchMdxWebpackLayers (see https://github.com/vercel/next.js/issues/91735).');
+          }
+        }
+      }
+    }
+    if (Array.isArray(webpackRule.oneOf)) {
+      patchMdxWebpackLayers(webpackRule.oneOf);
+    }
+    if (Array.isArray(webpackRule.rules)) {
+      patchMdxWebpackLayers(webpackRule.rules);
+    }
+  }
+}
 export function withDeploymentConfig(nextConfig) {
+  const consumerWebpack = nextConfig.webpack;
+  const webpack = (config, context) => {
+    if (context.isServer && config?.module && Array.isArray(config.module.rules)) {
+      patchMdxWebpackLayers(config.module.rules);
+    }
+    return consumerWebpack ? consumerWebpack(config, context) : config;
+  };
   return {
     trailingSlash: true,
     reactStrictMode: true,
     productionBrowserSourceMaps: true,
     ...nextConfig,
+    webpack,
     env: {
       // production | staging | pull-request | development
       DEPLOY_ENV,
@@ -212,6 +262,12 @@ export function withDeploymentConfig(nextConfig) {
     experimental: {
       scrollRestoration: true,
       workerThreads: false,
+      // Run each webpack compilation in a separate, disposable worker process so
+      // its memory is released before static generation instead of accumulating
+      // in the long-lived build process. This is off by default whenever a custom
+      // `webpack` config is present (Next resolves the `undefined` default to
+      // `false` when `config.webpack` is set), so it must be enabled explicitly.
+      webpackBuildWorker: true,
       ...(process.env.CI ? {
         cpus: process.env.NEXT_PARALLELISM ? parseInt(process.env.NEXT_PARALLELISM, 10) : os.availableParallelism()
       } : {}),
@@ -228,6 +284,7 @@ export function withDeploymentConfig(nextConfig) {
     typescript: {
       // Motivated by https://github.com/vercel/next.js/issues/7687
       ignoreBuildErrors: true,
+      tsconfigPath: './tsconfig.json',
       ...nextConfig.typescript
     }
   };

package/withDocsInfra/withDocsInfra.d.mts

@@ -165,6 +165,14 @@ export interface WithDocsInfraOptions {
    * ```
    */
   descriptionReplacements?: DescriptionReplacement[];
+  /**
+   * Directory rooting docs-infra's build caches and coordination state — relocate it (or point it
+   * at a persistent cache) and everything under it moves together: the sha256-validated JSON caches
+   * (`pages-index`, `types-text`, `types-enhanced`) and the index marker directories
+   * (`index-updates`, `types-index-updates`). The types socket dir (`.next/docs-infra`) is separate.
+   * @default '.next/cache/docs-infra'
+   */
+  cacheDir?: string;
 }
 export interface DocsInfraMdxOptions {
   remarkPlugins?: Array<string | [string, ...any[]]>;
@@ -219,6 +227,12 @@ export interface DocsInfraMdxOptions {
    * Passed to `transformHtmlCodeBlock` in the default rehype plugin list.
    */
   codeBlockEmphasisOptions?: TransformHtmlCodeBlockOptions;
+  /**
+   * Directory rooting docs-infra's build caches and index markers. Indexes synced from MDX store
+   * the page-index cache under `{cacheDir}/pages-index/` and markers under `{cacheDir}/index-updates/`.
+   * @default '.next/cache/docs-infra'
+   */
+  cacheDir?: string;
 }
 /**
  * Get default MDX options for docs-infra

package/withDocsInfra/withDocsInfra.mjs

@@ -1,3 +1,6 @@
+import path from 'node:path';
+import { DEFAULT_CACHE_DIR } from "../pipeline/cacheUtils/index.mjs";
+
 // Local type definition matching Next.js's internal JSONValue
 // Used for Turbopack loader options which require serializable values
 
@@ -12,7 +15,8 @@ export function getDocsInfraMdxOptions(customOptions = {}) {
     baseDir,
     errorIfIndexOutOfDate = Boolean(process.env.CI),
     defaultInlineCodeLanguage,
-    codeBlockEmphasisOptions
+    codeBlockEmphasisOptions,
+    cacheDir = DEFAULT_CACHE_DIR
   } = customOptions;
 
   // Normalize extractToIndex to options object
@@ -26,18 +30,22 @@ export function getDocsInfraMdxOptions(customOptions = {}) {
     extractToIndexOptions = {
       include: ['app', 'src/app'],
       exclude: [],
-      baseDir: baseDir ?? process.cwd()
+      baseDir: baseDir ?? process.cwd(),
+      markerDir: path.posix.join(cacheDir, 'index-updates'),
+      errorIfOutOfDate: errorIfIndexOutOfDate,
+      cacheDir
     };
   } else {
     extractToIndexOptions = {
       ...extractToIndex,
-      baseDir: baseDir ?? process.cwd()
+      baseDir: baseDir ?? process.cwd(),
+      markerDir: path.posix.join(cacheDir, 'index-updates'),
+      errorIfOutOfDate: errorIfIndexOutOfDate,
+      cacheDir
     };
   }
   const defaultRemarkPlugins = [['remark-gfm'], ['@mui/internal-docs-infra/pipeline/transformMarkdownMetadata', {
-    extractToIndex: extractToIndexOptions,
-    markerPath: '.next/cache/docs-infra/index-updates',
-    errorIfIndexOutOfDate
+    extractToIndex: extractToIndexOptions
   }], ['@mui/internal-docs-infra/pipeline/transformMarkdownRelativePaths'], ['@mui/internal-docs-infra/pipeline/transformMarkdownBlockquoteCallouts'],
   // Only pass options if explicitly set (undefined uses plugin default of 'tsx')
   defaultInlineCodeLanguage !== undefined ? ['@mui/internal-docs-infra/pipeline/transformMarkdownCode', {
@@ -78,7 +86,8 @@ export function withDocsInfra(options = {}) {
     errorIfTypesIndexOutOfDate = Boolean(process.env.CI),
     requireDemoClient,
     requireDemoPage = false,
-    transformTypescriptToJavascript = false
+    transformTypescriptToJavascript = false,
+    cacheDir = DEFAULT_CACHE_DIR
   } = options;
 
   // Only include ordering in loader options if explicitly provided
@@ -91,9 +100,10 @@ export function withDocsInfra(options = {}) {
   const updateParentIndex = {
     baseDir: process.cwd(),
     indexFileName: typesIndexFileName,
-    markerDir: '.next/cache/docs-infra/types-index-updates',
+    markerDir: path.posix.join(cacheDir, 'types-index-updates'),
     onlyUpdateIndexes: true,
-    errorIfOutOfDate: errorIfTypesIndexOutOfDate
+    errorIfOutOfDate: errorIfTypesIndexOutOfDate,
+    cacheDir
   };
   let output = 'hastCompressed';
   if (deferCodeParsing === 'json') {
@@ -164,6 +174,7 @@ export function withDocsInfra(options = {}) {
             performance,
             socketDir: '.next/docs-infra',
             updateParentIndex,
+            cacheDir,
             ...(codeBlockEmphasisOptions ? {
               codeBlockEmphasisOptions: codeBlockEmphasisOptions
             } : {}),
@@ -180,7 +191,8 @@ export function withDocsInfra(options = {}) {
         loaders: [{
           loader: '@mui/internal-docs-infra/pipeline/loadPrecomputedSitemap',
           options: {
-            performance
+            performance,
+            cacheDir
           }
         }]
       }
@@ -277,7 +289,8 @@ export function withDocsInfra(options = {}) {
           use: [defaultLoaders.babel, {
             loader: '@mui/internal-docs-infra/pipeline/loadPrecomputedSitemap',
             options: {
-              performance
+              performance,
+              cacheDir
             }
           }]
         });
@@ -291,6 +304,7 @@ export function withDocsInfra(options = {}) {
               performance,
               socketDir: '.next/docs-infra',
               updateParentIndex,
+              cacheDir,
               ...(codeBlockEmphasisOptions ? {
                 codeBlockEmphasisOptions
               } : {}),