@mui/internal-docs-infra 0.2.3-canary.11 → 0.2.3-canary.13

package/esm/pipeline/transformHtmlCodePrecomputed/transformHtmlCodePrecomputed.js

@@ -4,7 +4,7 @@ import _slicedToArray from "@babel/runtime/helpers/esm/slicedToArray";
 import _asyncToGenerator from "@babel/runtime/helpers/esm/asyncToGenerator";
 import _createForOfIteratorHelper from "@babel/runtime/helpers/esm/createForOfIteratorHelper";
 import { visit } from 'unist-util-visit';
-import { loadVariant } from "../../CodeHighlighter/loadVariant.js";
+import { loadCodeVariant } from "../loadCodeVariant/loadCodeVariant.js";
 import { createParseSource } from "../parseSource/index.js";
 import { TypescriptToJavascriptTransformer } from "../transformTypescriptToJavascript/index.js";
 /**
@@ -206,13 +206,13 @@ function extractFromDl(dl) {
 }
 
 /**
- * Rehype plugin that transforms semantic HTML code structures to use loadVariant
+ * Rehype plugin that transforms semantic HTML code structures to use loadCodeVariant
  *
  * This plugin:
  * 1. Finds section and dl elements in the HTML AST
  * 2. Extracts code elements from the semantic structure (figure/dl/dd/pre/code)
  * 3. Creates variants from multiple code elements or single Default variant
- * 4. Uses loadVariant to process each variant
+ * 4. Uses loadCodeVariant to process each variant
  * 5. Stores the combined precompute data on the root element
  * 6. Clears all code element contents and replaces with error message
  */
@@ -307,7 +307,7 @@ export var transformHtmlCodePrecomputed = function transformHtmlCodePrecomputed(
                           });
                         }
 
-                        // Process each variant with loadVariant
+                        // Process each variant with loadCodeVariant
                         processedCode = {};
                         variantPromises = Object.entries(variants).map(/*#__PURE__*/function () {
                           var _ref5 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(_ref4) {
@@ -321,7 +321,7 @@ export var transformHtmlCodePrecomputed = function transformHtmlCodePrecomputed(
                                     break;
                                   }
                                   _context.n = 1;
-                                  return loadVariant(undefined,
+                                  return loadCodeVariant(undefined,
                                   // url - not needed for inline code
                                   variantName, variantData, {
                                     sourceParser: sourceParser,

package/esm/useCode/useCodeUtils.js

@@ -1,7 +1,7 @@
 import _slicedToArray from "@babel/runtime/helpers/esm/slicedToArray";
 import _typeof from "@babel/runtime/helpers/esm/typeof";
 import { stringOrHastToJsx } from "../pipeline/hastUtils/index.js";
-import { applyTransform } from "../CodeHighlighter/applyTransform.js";
+import { applyCodeTransform } from "../pipeline/loadCodeVariant/applyCodeTransform.js";
 /**
  * Pure function to get available transforms from effective code data.
  * Only includes transforms that have actual deltas (file changes), not just filename changes.
@@ -94,7 +94,7 @@ export function applyTransformToSource(source, fileName, transforms, selectedTra
     }
 
     // Apply transform
-    var result = applyTransform(source, transforms, selectedTransform);
+    var result = applyCodeTransform(source, transforms, selectedTransform);
     var transformedName = transformData.fileName || fileName;
     return {
       transformedSource: result,
@@ -209,7 +209,7 @@ export function createTransformedFiles(selectedVariant, selectedTransform, shoul
             // Only apply transform if there's a meaningful delta
             var hasTransformDelta = transformData.delta && Object.keys(transformData.delta).length > 0;
             if (hasTransformDelta) {
-              transformedSource = applyTransform(source, transforms, selectedTransform);
+              transformedSource = applyCodeTransform(source, transforms, selectedTransform);
               transformedName = transformData.fileName || extraFileName;
             }
           }

package/esm/useDemo/createCodeSandbox.d.ts

@@ -1,4 +1,4 @@
-import type { FlattenedFiles } from "./flattenVariant.js";
+import type { FlattenedFiles } from "../pipeline/loadCodeVariant/flattenCodeVariant.js";
 /**
  * Utility function for creating CodeSandbox demos
  * Returns the configuration that can be used with openWithForm

package/esm/useDemo/createStackBlitz.d.ts

@@ -2,7 +2,7 @@
  * Utility function for creating StackBlitz demos
  * Returns the configuration that can be used with openWithForm
  */
-import type { FlattenedFiles } from "./flattenVariant.js";
+import type { FlattenedFiles } from "../pipeline/loadCodeVariant/flattenCodeVariant.js";
 /**
  * Create StackBlitz configuration for use with openWithForm
  */

package/esm/useDemo/exportVariant.js

@@ -7,8 +7,8 @@ import _slicedToArray from "@babel/runtime/helpers/esm/slicedToArray";
 
 import { externalsToPackages } from "../pipeline/loaderUtils/index.js";
 import { getFileNameFromUrl } from "../pipeline/loaderUtils/getFileNameFromUrl.js";
-import { createPathContext } from "../CodeHighlighter/examineVariant.js";
-import { mergeMetadata, extractMetadata } from "../CodeHighlighter/mergeMetadata.js";
+import { examineCodeVariant } from "../pipeline/loadCodeVariant/examineCodeVariant.js";
+import { mergeCodeMetadata, extractCodeMetadata } from "../pipeline/loadCodeVariant/mergeCodeMetadata.js";
 
 /**
  * Merges multiple file objects into a single object.
@@ -162,15 +162,17 @@ export function exportVariant(variantCode) {
   var finalTitle = [titlePrefix, title, titleSuffix].filter(Boolean).join('');
   var finalDescription = [descriptionPrefix, description, descriptionSuffix].filter(Boolean).join('');
 
-  // Use extractMetadata to properly separate metadata and non-metadata files
-  var _extractMetadata = extractMetadata(variantCode),
-    processedVariantCode = _extractMetadata.variant,
-    processedGlobals = _extractMetadata.metadata;
+  // Use extractCodeMetadata to properly separate metadata and non-metadata files
+  var _extractCodeMetadata = extractCodeMetadata(variantCode),
+    processedVariantCode = _extractCodeMetadata.variant,
+    processedGlobals = _extractCodeMetadata.metadata;
+
+  // Run optional transform hook to modify variant and globals before processing
   if (transformVariant) {
     var transformed = transformVariant(processedVariantCode, variantName, processedGlobals);
     if (transformed) {
       // Re-extract metadata after transformation
-      var result = transformed.variant && extractMetadata(transformed.variant);
+      var result = transformed.variant && extractCodeMetadata(transformed.variant);
       processedVariantCode = (result == null ? void 0 : result.variant) || processedVariantCode;
 
       // Start fresh with only the new metadata and explicitly transformed globals
@@ -191,7 +193,7 @@ export function exportVariant(variantCode) {
   var sourceFilename = getFilenameFromVariant(processedVariantCode);
 
   // Get path context to understand navigation
-  var pathContext = createPathContext(variantCode);
+  var pathContext = examineCodeVariant(variantCode);
 
   // Determine if we need to rename the source file
   var ext = useTypescript ? 'tsx' : 'jsx';
@@ -401,7 +403,7 @@ export function exportVariant(variantCode) {
   // Merge all metadata files including framework metadata and globals
   var allMetadataFiles = mergeFiles(processedGlobals || {}, metadataFiles, extraMetadataFiles, frameworkFiles.globals || {});
 
-  // Merge all files using mergeMetadata to properly position everything with 'src/' (sourcePrefix opt) prefix
+  // Merge all files using mergeCodeMetadata to properly position everything with 'src/' (sourcePrefix opt) prefix
   var allSourceFilesWithFramework = mergeFiles(processedVariantCode.extraFiles || {}, generatedFiles, ((_frameworkFiles$varia = frameworkFiles.variant) == null ? void 0 : _frameworkFiles$varia.extraFiles) || {});
 
   // Update the variant with all source files including framework source files
@@ -409,8 +411,8 @@ export function exportVariant(variantCode) {
     extraFiles: allSourceFilesWithFramework
   });
 
-  // Use mergeMetadata to position everything correctly
-  var finalVariant = mergeMetadata(finalVariantWithSources, allMetadataFiles, {
+  // Use mergeCodeMetadata to position everything correctly
+  var finalVariant = mergeCodeMetadata(finalVariantWithSources, allMetadataFiles, {
     metadataPrefix: sourcePrefix
   });
 

package/esm/useDemo/index.d.ts

@@ -1,6 +1,6 @@
 export * from "./useDemo.js";
 export * from "./createStackBlitz.js";
 export * from "./createCodeSandbox.js";
-export * from "./flattenVariant.js";
+export * from "../pipeline/loadCodeVariant/flattenCodeVariant.js";
 export * from "./exportVariant.js";
 export * from "./exportVariantAsCra.js";

package/esm/useDemo/index.js

@@ -1,6 +1,6 @@
 export * from "./useDemo.js";
 export * from "./createStackBlitz.js";
 export * from "./createCodeSandbox.js";
-export * from "./flattenVariant.js";
+export * from "../pipeline/loadCodeVariant/flattenCodeVariant.js";
 export * from "./exportVariant.js";
 export * from "./exportVariantAsCra.js";

package/esm/useDemo/useDemo.d.ts

@@ -3,16 +3,16 @@ import type { UseCodeOpts } from "../useCode/index.js";
 import type { ContentProps } from "../CodeHighlighter/types.js";
 import { type ExportConfig } from "./exportVariant.js";
 /**
- * Demo templates use the exportVariant/exportVariantAsCra with flattenVariant pattern:
+ * Demo templates use the exportVariant/exportVariantAsCra with flattenCodeVariant pattern:
  *
  * For StackBlitz:
  * const { exported: exportedVariant, entrypoint } = exportVariant(variantCode);
- * const flattenedFiles = flattenVariant(exportedVariant);
+ * const flattenedFiles = flattenCodeVariant(exportedVariant);
  * createStackBlitzDemo({ title, description, flattenedFiles, useTypescript, initialFile: entrypoint })
  *
  * For CodeSandbox:
  * const { exported: craExport, entrypoint } = exportVariantAsCra(variantCode, { title, description, useTypescript });
- * const flattenedFiles = flattenVariant(craExport);
+ * const flattenedFiles = flattenCodeVariant(craExport);
  * createCodeSandboxDemo({ title, description, flattenedFiles, useTypescript, initialFile: entrypoint })
  * createCodeSandboxDemo({ title, description, flattenedFiles, useTypescript })
  */

package/esm/useDemo/useDemo.js

@@ -8,19 +8,19 @@ import { createStackBlitz } from "./createStackBlitz.js";
 import { createCodeSandbox } from "./createCodeSandbox.js";
 import { exportVariant } from "./exportVariant.js";
 import { exportVariantAsCra } from "./exportVariantAsCra.js";
-import { flattenVariant } from "./flattenVariant.js";
+import { flattenCodeVariant } from "../pipeline/loadCodeVariant/flattenCodeVariant.js";
 
 /**
- * Demo templates use the exportVariant/exportVariantAsCra with flattenVariant pattern:
+ * Demo templates use the exportVariant/exportVariantAsCra with flattenCodeVariant pattern:
  *
  * For StackBlitz:
  * const { exported: exportedVariant, entrypoint } = exportVariant(variantCode);
- * const flattenedFiles = flattenVariant(exportedVariant);
+ * const flattenedFiles = flattenCodeVariant(exportedVariant);
  * createStackBlitzDemo({ title, description, flattenedFiles, useTypescript, initialFile: entrypoint })
  *
  * For CodeSandbox:
  * const { exported: craExport, entrypoint } = exportVariantAsCra(variantCode, { title, description, useTypescript });
- * const flattenedFiles = flattenVariant(craExport);
+ * const flattenedFiles = flattenCodeVariant(craExport);
  * createCodeSandboxDemo({ title, description, flattenedFiles, useTypescript, initialFile: entrypoint })
  * createCodeSandboxDemo({ title, description, flattenedFiles, useTypescript })
  */
@@ -133,7 +133,7 @@ export function useDemo(contentProps, opts) {
       rootFile = _exportFunction.rootFile;
 
     // Flatten the variant to get a flat file structure
-    var flattenedFiles = flattenVariant(exported);
+    var flattenedFiles = flattenCodeVariant(exported);
     var stackBlitzDemo = createStackBlitz({
       title: title,
       description: description,
@@ -173,7 +173,7 @@ export function useDemo(contentProps, opts) {
       rootFile = _exportFunction2.rootFile;
 
     // Flatten the variant to get a flat file structure
-    var flattenedFiles = flattenVariant(craExport);
+    var flattenedFiles = flattenCodeVariant(craExport);
     var codeSandboxDemo = createCodeSandbox({
       flattenedFiles: flattenedFiles,
       rootFile: rootFile

package/esm/withDocsInfra/withDeploymentConfig.js

@@ -33,7 +33,8 @@ process.env.DEPLOY_ENV = DEPLOY_ENV;
 export function withDeploymentConfig(nextConfig) {
   return _extends(_extends({
     trailingSlash: true,
-    reactStrictMode: true
+    reactStrictMode: true,
+    productionBrowserSourceMaps: true
   }, nextConfig), {}, {
     env: _extends(_extends({
       // production | staging | pull-request | development

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mui/internal-docs-infra",
-  "version": "0.2.3-canary.11",
+  "version": "0.2.3-canary.13",
   "author": "MUI Team",
   "description": "MUI Infra - internal documentation creation tools.",
   "keywords": [
@@ -173,6 +173,12 @@
         "default": "./esm/pipeline/hastUtils/index.js"
       }
     },
+    "./pipeline/loadCodeVariant": {
+      "default": {
+        "types": "./esm/pipeline/loadCodeVariant/index.d.ts",
+        "default": "./esm/pipeline/loadCodeVariant/index.js"
+      }
+    },
     "./pipeline/loaderUtils": {
       "default": {
         "types": "./esm/pipeline/loaderUtils/index.d.ts",
@@ -229,5 +235,5 @@
     },
     "./esm": null
   },
-  "gitSha": "fd9d593490ae2b177feb323402b9ba8f86bcf6d1"
+  "gitSha": "8b1850f1e23152917fcc1e97d123805cd99d6a31"
 }

package/esm/CodeHighlighter/transformParsedSource.d.ts

@@ -1,3 +0,0 @@
-import type { Nodes } from 'hast';
-import { ParseSource, Transforms } from "./types.js";
-export declare function transformParsedSource(source: string, parsedSource: Nodes, filename: string, transforms: Transforms, parseSource: ParseSource): Promise<Record<string, any>>;