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

package/README.md

@@ -4,6 +4,7 @@ This package hosts the tools that help create the documentation.
 
 ## Documentation
 
-This is stored in the `docs` directory.
+This is stored in the `docs` top-level directory.
 
-[Read More](../../docs/app/docs-infra/page.mdx)
+[Read in Markdown](../../docs/app/docs-infra/page.mdx)
+[Read in Browser](https://infra.mui.com/docs-infra)

package/esm/pipeline/getFileConventions/fileConventions.d.ts

@@ -0,0 +1,4 @@
+export declare const fileConventions: {
+  rule: string;
+  loader: string;
+}[];

package/esm/pipeline/getFileConventions/fileConventions.js

@@ -0,0 +1,4 @@
+export var fileConventions = [{
+  rule: './app/**/demos/*/index.ts',
+  loader: 'loadPrecomputedCodeHighlighter'
+}];

package/esm/pipeline/getFileConventions/getFileConventions.d.ts

@@ -0,0 +1,4 @@
+export declare function getFileConventions(): Promise<{
+  rule: string;
+  loader: string;
+}[]>;

package/esm/pipeline/getFileConventions/getFileConventions.js

@@ -0,0 +1,17 @@
+import _regenerator from "@babel/runtime/helpers/esm/regenerator";
+import _asyncToGenerator from "@babel/runtime/helpers/esm/asyncToGenerator";
+import { fileConventions } from "./fileConventions.js";
+export function getFileConventions() {
+  return _getFileConventions.apply(this, arguments);
+}
+function _getFileConventions() {
+  _getFileConventions = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee() {
+    return _regenerator().w(function (_context) {
+      while (1) switch (_context.n) {
+        case 0:
+          return _context.a(2, fileConventions);
+      }
+    }, _callee);
+  }));
+  return _getFileConventions.apply(this, arguments);
+}

package/esm/pipeline/getFileConventions/index.d.ts

@@ -0,0 +1 @@
+export * from "./getFileConventions.js";

package/esm/pipeline/getFileConventions/index.js

@@ -0,0 +1 @@
+export * from "./getFileConventions.js";

package/esm/pipeline/loadCodeVariant/calculateMainFilePath.js

@@ -1,5 +1,5 @@
 import _toConsumableArray from "@babel/runtime/helpers/esm/toConsumableArray";
-import { createSyntheticDirectories, buildPath } from './pathUtils.js';
+import { createSyntheticDirectories, buildPath } from "./pathUtils.js";
 export function calculateMainFilePath(url, maxBackNav, maxSourceBackNav, metadataPrefix, fileName) {
   // Handle optional parameters with defaults
   var actualMaxSourceBackNav = maxSourceBackNav != null ? maxSourceBackNav : maxBackNav;

package/esm/pipeline/loadCodeVariant/loadCodeFallback.js

@@ -6,6 +6,7 @@ import _regenerator from "@babel/runtime/helpers/esm/regenerator";
 import _asyncToGenerator from "@babel/runtime/helpers/esm/asyncToGenerator";
 import { loadCodeVariant } from "./loadCodeVariant.js";
 import { getFileNameFromUrl } from "../loaderUtils/index.js";
+import { performanceMeasure } from "../loadPrecomputedCodeHighlighter/performanceLogger.js";
 
 // Helper function to get the source for a specific filename from a variant
 function getFileSource(_x, _x2, _x3) {
@@ -100,6 +101,8 @@ function _loadCodeFallback() {
       variants,
       globalsCode,
       output,
+      functionName,
+      currentMark,
       initial,
       _allFileNames,
       fileSource,
@@ -107,11 +110,13 @@ function _loadCodeFallback() {
       result,
       parseSource,
       quickVariant,
+      beforeInitialVariantMark,
       _allFileNames2,
       _fileSource,
       _actualFilename,
       _result,
       _parseSource,
+      beforeGlobalsMark,
       globalsCodeObjects,
       hasStringUrls,
       globalsPromises,
@@ -123,6 +128,7 @@ function _loadCodeFallback() {
       _yield$loadCodeVarian,
       loadedVariant,
       allFileNames,
+      beforeAllVariantMark,
       allVariants,
       variantPromises,
       variantResults,
@@ -145,11 +151,14 @@ function _loadCodeFallback() {
           options = _args4.length > 3 && _args4[3] !== undefined ? _args4[3] : {};
           shouldHighlight = options.shouldHighlight, fallbackUsesExtraFiles = options.fallbackUsesExtraFiles, fallbackUsesAllVariants = options.fallbackUsesAllVariants, sourceParser = options.sourceParser, loadSource = options.loadSource, loadVariantMeta = options.loadVariantMeta, loadCodeMeta = options.loadCodeMeta, initialFilename = options.initialFilename, variants = options.variants, globalsCode = options.globalsCode, output = options.output;
           loaded = _extends({}, loaded);
-
-          // Step 1: Ensure we have the initial variant loaded
+          functionName = 'Load Fallback Code';
+          currentMark = performanceMeasure(undefined, {
+            mark: 'Start',
+            measure: 'Start'
+          }, [functionName, url], true); // Step 1: Ensure we have the initial variant loaded
           initial = loaded[initialVariant];
           if (initial) {
-            _context4.n = 5;
+            _context4.n = 6;
             break;
           }
           if (loadCodeMeta) {
@@ -177,8 +186,13 @@ function _loadCodeFallback() {
           }
           throw new Error("Initial variant \"".concat(initialVariant, "\" not found in loaded code."));
         case 5:
+          currentMark = performanceMeasure(currentMark, {
+            mark: 'Loaded Code Meta',
+            measure: 'Code Meta Loading'
+          }, [functionName, url]);
+        case 6:
           if (!(typeof initial !== 'string' && initial.allFilesListed && !fallbackUsesExtraFiles && !fallbackUsesAllVariants)) {
-            _context4.n = 16;
+            _context4.n = 17;
             break;
           }
           // Collect all file names from the loaded code
@@ -193,40 +207,50 @@ function _loadCodeFallback() {
           }
 
           // Get the source for the requested filename (or main file if not specified)
-          _context4.p = 6;
-          _context4.n = 7;
+          _context4.p = 7;
+          _context4.n = 8;
           return getFileSource(initial, initialFilename, loadSource);
-        case 7:
+        case 8:
           result = _context4.v;
           fileSource = result.source;
           actualFilename = result.filename;
-          _context4.n = 9;
+          _context4.n = 10;
           break;
-        case 8:
-          _context4.p = 8;
+        case 9:
+          _context4.p = 9;
           _t5 = _context4.v;
           throw new Error("Failed to get source for file ".concat(initialFilename || initial.fileName, " in variant ").concat(initialVariant, ": ").concat(_t5));
-        case 9:
+        case 10:
+          currentMark = performanceMeasure(currentMark, {
+            mark: 'Loaded Main File',
+            measure: 'Main File Loading'
+          }, [functionName, url]);
+
+          // If we need highlighting and have a string source, parse it
           if (!(shouldHighlight && typeof fileSource === 'string' && sourceParser && actualFilename)) {
-            _context4.n = 14;
+            _context4.n = 15;
             break;
           }
-          _context4.p = 10;
-          _context4.n = 11;
+          _context4.p = 11;
+          _context4.n = 12;
           return sourceParser;
-        case 11:
+        case 12:
           parseSource = _context4.v;
           fileSource = parseSource(fileSource, actualFilename);
-          _context4.n = 13;
+          _context4.n = 14;
           break;
-        case 12:
-          _context4.p = 12;
+        case 13:
+          _context4.p = 13;
           _t6 = _context4.v;
           throw new Error("Failed to parse source for highlighting (variant: ".concat(initialVariant, ", file: ").concat(actualFilename, "): ").concat(JSON.stringify(_t6)));
-        case 13:
-          _context4.n = 15;
-          break;
         case 14:
+          currentMark = performanceMeasure(currentMark, {
+            mark: 'Parsed Main File',
+            measure: 'Main File Parsing'
+          }, [functionName, url]);
+          _context4.n = 16;
+          break;
+        case 15:
           if (shouldHighlight && typeof fileSource === 'string' && !actualFilename) {
             // Create basic HAST node when we can't parse due to missing filename
             // This marks that the source has passed through the parsing pipeline
@@ -238,7 +262,7 @@ function _loadCodeFallback() {
               }]
             };
           }
-        case 15:
+        case 16:
           // Update the loaded code with any changes we made
           if (actualFilename && actualFilename === initial.fileName) {
             initial = _extends(_extends({}, initial), {}, {
@@ -261,35 +285,40 @@ function _loadCodeFallback() {
             initialExtraFiles: initial.extraFiles || {},
             allFileNames: Array.from(_allFileNames)
           });
-        case 16:
+        case 17:
           if (!(typeof initial === 'string')) {
-            _context4.n = 33;
+            _context4.n = 34;
             break;
           }
-          _context4.p = 17;
+          _context4.p = 18;
           if (!loadVariantMeta) {
-            _context4.n = 19;
+            _context4.n = 20;
             break;
           }
-          _context4.n = 18;
+          _context4.n = 19;
           return loadVariantMeta(initialVariant, initial);
-        case 18:
+        case 19:
           quickVariant = _context4.v;
-          _context4.n = 20;
+          currentMark = performanceMeasure(currentMark, {
+            mark: 'Loaded Initial Variant Meta',
+            measure: 'Initial Variant Meta Loading'
+          }, [functionName, url]);
+          _context4.n = 21;
           break;
-        case 19:
+        case 20:
           // Create a basic variant using fallback logic
           quickVariant = {
             url: initial,
             fileName: getFileNameFromUrl(initial).fileName
           };
-        case 20:
+        case 21:
+          beforeInitialVariantMark = currentMark;
           loaded = _extends(_extends({}, loaded), {}, _defineProperty({}, initialVariant, quickVariant));
           initial = quickVariant;
 
           // If we have all files listed and don't need extra file processing, we can optimize
           if (!(quickVariant.allFilesListed && !fallbackUsesExtraFiles && !fallbackUsesAllVariants)) {
-            _context4.n = 31;
+            _context4.n = 32;
             break;
           }
           // Collect all file names from the quick load
@@ -304,40 +333,48 @@ function _loadCodeFallback() {
           }
 
           // Get the source for the requested filename (or main file if not specified)
-          _context4.p = 21;
-          _context4.n = 22;
+          _context4.p = 22;
+          _context4.n = 23;
           return getFileSource(quickVariant, initialFilename, loadSource);
-        case 22:
+        case 23:
           _result = _context4.v;
           _fileSource = _result.source;
           _actualFilename = _result.filename;
-          _context4.n = 24;
+          currentMark = performanceMeasure(currentMark, {
+            mark: 'Loaded Initial File',
+            measure: 'Initial File Loading'
+          }, [functionName, initialFilename || 'unknown', url]);
+          _context4.n = 25;
           break;
-        case 23:
-          _context4.p = 23;
+        case 24:
+          _context4.p = 24;
           _t7 = _context4.v;
           throw new Error("Failed to get source for file ".concat(initialFilename || quickVariant.fileName, " in variant ").concat(initialVariant, ": ").concat(_t7));
-        case 24:
+        case 25:
           if (!(shouldHighlight && typeof _fileSource === 'string' && sourceParser && _actualFilename)) {
-            _context4.n = 29;
+            _context4.n = 30;
             break;
           }
-          _context4.p = 25;
-          _context4.n = 26;
+          _context4.p = 26;
+          _context4.n = 27;
           return sourceParser;
-        case 26:
+        case 27:
           _parseSource = _context4.v;
           _fileSource = _parseSource(_fileSource, _actualFilename);
-          _context4.n = 28;
+          currentMark = performanceMeasure(currentMark, {
+            mark: 'Parsed Initial File',
+            measure: 'Initial File Parsing'
+          }, [functionName, initialFilename || 'unknown', url]);
+          _context4.n = 29;
           break;
-        case 27:
-          _context4.p = 27;
+        case 28:
+          _context4.p = 28;
           _t8 = _context4.v;
           throw new Error("Failed to parse source for highlighting (variant: ".concat(initialVariant, ", file: ").concat(_actualFilename, "): ").concat(JSON.stringify(_t8)));
-        case 28:
-          _context4.n = 30;
-          break;
         case 29:
+          _context4.n = 31;
+          break;
+        case 30:
           if (shouldHighlight && typeof _fileSource === 'string' && !_actualFilename) {
             // Create basic HAST node when we can't parse due to missing filename
             // This marks that the source has passed through the parsing pipeline
@@ -349,7 +386,7 @@ function _loadCodeFallback() {
               }]
             };
           }
-        case 30:
+        case 31:
           // Update the loaded code with any changes we made
           if (_actualFilename && _actualFilename === quickVariant.fileName) {
             initial = _extends(_extends({}, quickVariant), {}, {
@@ -363,6 +400,10 @@ function _loadCodeFallback() {
             });
             loaded = _extends(_extends({}, loaded), {}, _defineProperty({}, initialVariant, initial));
           }
+          currentMark = performanceMeasure(beforeInitialVariantMark, {
+            mark: 'Loaded Initial Files',
+            measure: 'Initial Files Loading'
+          }, [functionName, url], true);
 
           // Early return - we have all the info we need
           return _context4.a(2, {
@@ -372,31 +413,33 @@ function _loadCodeFallback() {
             initialExtraFiles: quickVariant.extraFiles || {},
             allFileNames: Array.from(_allFileNames2)
           });
-        case 31:
-          _context4.n = 33;
-          break;
         case 32:
-          _context4.p = 32;
+          _context4.n = 34;
+          break;
+        case 33:
+          _context4.p = 33;
           _t9 = _context4.v;
           throw new Error("Failed to load initial variant code (variant: ".concat(initialVariant, ", url: ").concat(initial, "): ").concat(JSON.stringify(_t9)));
-        case 33:
+        case 34:
+          beforeGlobalsMark = currentMark; // Step 2b: Fall back to full loadCodeVariant processing
+          // Load globalsCode - convert string URLs to Code objects, keep Code objects as-is
           if (!(globalsCode && globalsCode.length > 0)) {
-            _context4.n = 36;
+            _context4.n = 37;
             break;
           }
           hasStringUrls = globalsCode.some(function (item) {
             return typeof item === 'string';
           });
           if (!(hasStringUrls && !loadCodeMeta)) {
-            _context4.n = 34;
+            _context4.n = 35;
             break;
           }
           throw new Error('loadCodeMeta function is required when globalsCode contains string URLs');
-        case 34:
+        case 35:
           // Load all string URLs in parallel, keep Code objects as-is
           globalsPromises = globalsCode.map(/*#__PURE__*/function () {
             var _ref = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2(globalItem) {
-              var _t;
+              var codeMeta, _t;
               return _regenerator().w(function (_context2) {
                 while (1) switch (_context2.p = _context2.n) {
                   case 0:
@@ -408,7 +451,12 @@ function _loadCodeFallback() {
                     _context2.n = 2;
                     return loadCodeMeta(globalItem);
                   case 2:
-                    return _context2.a(2, _context2.v);
+                    codeMeta = _context2.v;
+                    currentMark = performanceMeasure(currentMark, {
+                      mark: 'Loaded Global Code Meta',
+                      measure: 'Global Code Meta Loading'
+                    }, [functionName, globalItem, url]);
+                    return _context2.a(2, codeMeta);
                   case 3:
                     _context2.p = 3;
                     _t = _context2.v;
@@ -424,11 +472,15 @@ function _loadCodeFallback() {
               return _ref.apply(this, arguments);
             };
           }());
-          _context4.n = 35;
+          _context4.n = 36;
           return Promise.all(globalsPromises);
-        case 35:
-          globalsCodeObjects = _context4.v;
         case 36:
+          globalsCodeObjects = _context4.v;
+          currentMark = performanceMeasure(beforeGlobalsMark, {
+            mark: 'Loaded Globals Meta',
+            measure: 'Globals Meta Loading'
+          }, [functionName, url], true);
+        case 37:
           if (globalsCodeObjects && globalsCodeObjects.length > 0) {
             resolvedGlobalsCode = [];
             _iterator = _createForOfIteratorHelper(globalsCodeObjects);
@@ -447,8 +499,8 @@ function _loadCodeFallback() {
               _iterator.f();
             }
           }
-          _context4.p = 37;
-          _context4.n = 38;
+          _context4.p = 38;
+          _context4.n = 39;
           return loadCodeVariant(url, initialVariant, initial, {
             sourceParser: sourceParser,
             loadSource: loadSource,
@@ -463,19 +515,24 @@ function _loadCodeFallback() {
             // Pass resolved globalsCode
             output: output
           });
-        case 38:
+        case 39:
           _yield$loadCodeVarian = _context4.v;
           loadedVariant = _yield$loadCodeVarian.code;
+          currentMark = performanceMeasure(currentMark, {
+            mark: 'Loaded Initial Variant',
+            measure: 'Initial Variant Loading'
+          }, [functionName, url], true);
+
           // Update the loaded code with the processed variant
           loaded = _extends(_extends({}, loaded), {}, _defineProperty({}, initialVariant, loadedVariant));
           initial = loadedVariant;
-          _context4.n = 40;
+          _context4.n = 41;
           break;
-        case 39:
-          _context4.p = 39;
+        case 40:
+          _context4.p = 40;
           _t0 = _context4.v;
           throw new Error("Failed to load initial variant using loadCodeVariant (variant: ".concat(initialVariant, ", url: ").concat(url, "): ").concat(JSON.stringify(_t0)));
-        case 40:
+        case 41:
           // Step 3: Collect all file names
           allFileNames = new Set();
           if (initial.fileName) {
@@ -491,19 +548,19 @@ function _loadCodeFallback() {
 
           // Step 4: Handle fallbackUsesAllVariants - load all variants to get all possible files
           if (!fallbackUsesAllVariants) {
-            _context4.n = 43;
+            _context4.n = 45;
             break;
           }
-          // Determine all variants to process - use provided variants or infer from loaded code
+          beforeAllVariantMark = currentMark; // Determine all variants to process - use provided variants or infer from loaded code
           allVariants = variants || Object.keys(loaded || {});
           if (!(allVariants.length === 0)) {
-            _context4.n = 41;
+            _context4.n = 42;
             break;
           }
           console.warn('No variants found for fallbackUsesAllVariants processing');
-          _context4.n = 43;
+          _context4.n = 44;
           break;
-        case 41:
+        case 42:
           // Process all required variants, not just the ones already loaded
           variantPromises = allVariants.map(/*#__PURE__*/function () {
             var _ref2 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee3(variantName) {
@@ -535,6 +592,10 @@ function _loadCodeFallback() {
                     variant = allCode[variantName];
                     // Update loaded with all variants from loadCodeMeta
                     loaded = _extends(_extends({}, loaded), allCode);
+                    currentMark = performanceMeasure(currentMark, {
+                      mark: 'Loaded Initial Code Meta',
+                      measure: 'Initial Code Meta Loading'
+                    }, [functionName, url]);
                     _context3.n = 5;
                     break;
                   case 4:
@@ -599,6 +660,10 @@ function _loadCodeFallback() {
                     if (_loadedVariant.extraFiles) {
                       fileNames.push.apply(fileNames, _toConsumableArray(Object.keys(_loadedVariant.extraFiles)));
                     }
+                    currentMark = performanceMeasure(currentMark, {
+                      mark: 'Loaded Initial Variant',
+                      measure: 'Initial Variant Loading'
+                    }, [functionName, variantName, url], true);
                     return _context3.a(2, {
                       variantName: variantName,
                       loadedVariant: _loadedVariant,
@@ -621,9 +686,9 @@ function _loadCodeFallback() {
               return _ref2.apply(this, arguments);
             };
           }());
-          _context4.n = 42;
+          _context4.n = 43;
           return Promise.all(variantPromises);
-        case 42:
+        case 43:
           variantResults = _context4.v;
           // Update loaded code and collect file names
           variantResults.forEach(function (_ref3) {
@@ -637,37 +702,46 @@ function _loadCodeFallback() {
               return allFileNames.add(fileName);
             });
           });
-        case 43:
+        case 44:
+          currentMark = performanceMeasure(beforeAllVariantMark, {
+            mark: 'Loaded Initial Variants',
+            measure: 'Initial Variants Loading'
+          }, [functionName, url], true);
+        case 45:
           // Ensure we have the latest initial variant data
           finalInitial = loaded[initialVariant];
           if (!(!finalInitial || typeof finalInitial === 'string')) {
-            _context4.n = 44;
+            _context4.n = 46;
             break;
           }
           throw new Error("Failed to process initial variant: ".concat(initialVariant));
-        case 44:
-          _context4.p = 44;
-          _context4.n = 45;
+        case 46:
+          _context4.p = 46;
+          _context4.n = 47;
           return getFileSource(finalInitial, initialFilename, loadSource);
-        case 45:
+        case 47:
           _result2 = _context4.v;
           finalFileSource = _result2.source;
           finalFilename = _result2.filename;
-          _context4.n = 48;
+          _context4.n = 50;
           break;
-        case 46:
-          _context4.p = 46;
+        case 48:
+          _context4.p = 48;
           _t1 = _context4.v;
           if (!(!finalInitial.fileName && !finalInitial.source)) {
-            _context4.n = 47;
+            _context4.n = 49;
             break;
           }
           throw new Error("Cannot determine filename for initial variant \"".concat(initialVariant, "\". ") + "No fileName available in variant definition, no initialFilename provided, and no source available.");
-        case 47:
+        case 49:
           // Fall back to the main file with proper validation
           finalFileSource = finalInitial.source || '';
           finalFilename = finalInitial.fileName;
-        case 48:
+        case 50:
+          currentMark = performanceMeasure(currentMark, {
+            mark: 'Loaded Initial File',
+            measure: 'Initial File Loading'
+          }, [functionName, url]);
           return _context4.a(2, {
             code: loaded,
             initialFilename: finalFilename,
@@ -677,7 +751,7 @@ function _loadCodeFallback() {
             processedGlobalsCode: globalsCodeObjects
           });
       }
-    }, _callee4, null, [[44, 46], [37, 39], [25, 27], [21, 23], [17, 32], [10, 12], [6, 8], [1, 3]]);
+    }, _callee4, null, [[46, 48], [38, 40], [26, 28], [22, 24], [18, 33], [11, 13], [7, 9], [1, 3]]);
   }));
   return _loadCodeFallback.apply(this, arguments);
 }