@mui/internal-docs-infra 0.3.1-canary.3 → 0.3.1-canary.5

package/esm/pipeline/loadServerPageIndex/loadServerPageIndex.js

@@ -1,11 +1,3 @@
-import _regenerator from "@babel/runtime/helpers/esm/regenerator";
-import _asyncToGenerator from "@babel/runtime/helpers/esm/asyncToGenerator";
-import _extends from "@babel/runtime/helpers/esm/extends";
-import _objectWithoutPropertiesLoose from "@babel/runtime/helpers/esm/objectWithoutPropertiesLoose";
-import _typeof from "@babel/runtime/helpers/esm/typeof";
-import _slicedToArray from "@babel/runtime/helpers/esm/slicedToArray";
-var _excluded = ["titleMarkdown", "children"],
-  _excluded2 = ["descriptionMarkdown", "sections"];
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -24,29 +16,27 @@ import { markdownToMetadata } from "../syncPageIndex/metadataToMarkdown.js";
  * e.g., "docs-infra" -> "Docs Infra", "components" -> "Components"
  */
 export function pathSegmentToTitle(segment) {
-  return segment.split('-').map(function (word) {
-    return word.charAt(0).toUpperCase() + word.slice(1);
-  }).join(' ');
+  return segment.split('-').map(word => word.charAt(0).toUpperCase() + word.slice(1)).join(' ');
 }
 
 /**
  * Recursively removes titleMarkdown fields from a heading hierarchy
  */
 export function stripTitleMarkdown(hierarchy) {
-  var result = {};
-  for (var _i = 0, _Object$entries = Object.entries(hierarchy); _i < _Object$entries.length; _i++) {
-    var _Object$entries$_i = _slicedToArray(_Object$entries[_i], 2),
-      key = _Object$entries$_i[0],
-      value = _Object$entries$_i[1];
-    if (_typeof(value) === 'object' && value !== null) {
-      var titleMarkdown = value.titleMarkdown,
-        children = value.children,
-        rest = _objectWithoutPropertiesLoose(value, _excluded);
-      var strippedChildren = children ? stripTitleMarkdown(children) : {};
-      result[key] = _extends(_extends({}, rest), {}, {
+  const result = {};
+  for (const [key, value] of Object.entries(hierarchy)) {
+    if (typeof value === 'object' && value !== null) {
+      const {
+        titleMarkdown,
+        children,
+        ...rest
+      } = value;
+      const strippedChildren = children ? stripTitleMarkdown(children) : {};
+      result[key] = {
+        ...rest,
         // Only include children if it has keys, otherwise set to undefined
         children: Object.keys(strippedChildren).length > 0 ? strippedChildren : undefined
-      });
+      };
     }
   }
   return result;
@@ -58,19 +48,19 @@ export function stripTitleMarkdown(hierarchy) {
  */
 export function extractPrefixAndTitle(absolutePath, rootContext) {
   // Get the relative path from the root context
-  var relativePath = path.relative(rootContext, absolutePath);
+  const relativePath = path.relative(rootContext, absolutePath);
 
   // Extract the directory path (remove filename)
-  var dirPath = path.dirname(relativePath);
+  const dirPath = path.dirname(relativePath);
 
   // Split into segments
-  var allSegments = dirPath.split(path.sep);
+  const allSegments = dirPath.split(path.sep);
 
   // Filter out segments:
   // - Remove leading 'src' and 'app' directory markers (only if they're at the start)
   // - Remove Next.js route groups (segments in parentheses like '(public)')
   // - Remove current directory markers ('.' and empty strings)
-  var segments = allSegments.filter(function (seg, index) {
+  const segments = allSegments.filter((seg, index) => {
     // Remove 'src' only if it's the first segment
     if (seg === 'src' && index === 0) {
       return false;
@@ -91,13 +81,13 @@ export function extractPrefixAndTitle(absolutePath, rootContext) {
   });
 
   // Generate prefix with leading and trailing slashes
-  var prefix = segments.length > 0 ? "/".concat(segments.join('/'), "/") : '/';
+  const prefix = segments.length > 0 ? `/${segments.join('/')}/` : '/';
 
   // Generate title from path segments
-  var title = segments.map(pathSegmentToTitle).join(' ');
+  const title = segments.map(pathSegmentToTitle).join(' ');
   return {
-    prefix: prefix,
-    title: title
+    prefix,
+    title
   };
 }
 
@@ -105,7 +95,7 @@ export function extractPrefixAndTitle(absolutePath, rootContext) {
  * Default loadServerPageIndex function that loads page index data from a markdown file.
  * This function uses process.cwd() as the root context for resolving relative paths.
  */
-export var loadServerPageIndex = createLoadServerPageIndex();
+export const loadServerPageIndex = createLoadServerPageIndex();
 
 /**
  * Creates a loadServerPageIndex function with custom options.
@@ -119,58 +109,49 @@ export var loadServerPageIndex = createLoadServerPageIndex();
  * @param options - Configuration options for the loader
  * @returns LoadServerPageIndex function that takes a file path and returns Promise<SitemapSectionData | null>
  */
-export function createLoadServerPageIndex() {
-  var _options$rootContext;
-  var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
-  var rootContext = (_options$rootContext = options.rootContext) != null ? _options$rootContext : process.cwd();
-  return /*#__PURE__*/function () {
-    var _loadPageIndex = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(filePath) {
-      var absolutePath, _extractPrefixAndTitl, prefix, generatedTitle, markdownContent, metadata, enrichedMetadata;
-      return _regenerator().w(function (_context) {
-        while (1) switch (_context.n) {
-          case 0:
-            // Convert file:// URLs to proper file system paths for reading the file
-            // Using fileURLToPath handles Windows drive letters correctly (e.g., file:///C:/... → C:\...)
-            absolutePath = filePath.startsWith('file://') ? fileURLToPath(filePath) : filePath; // Extract prefix and title from the import path
-            _extractPrefixAndTitl = extractPrefixAndTitle(absolutePath, rootContext), prefix = _extractPrefixAndTitl.prefix, generatedTitle = _extractPrefixAndTitl.title; // Read the markdown file
-            _context.n = 1;
-            return fs.readFile(absolutePath, 'utf-8');
-          case 1:
-            markdownContent = _context.v;
-            _context.n = 2;
-            return markdownToMetadata(markdownContent);
-          case 2:
-            metadata = _context.v;
-            if (metadata) {
-              _context.n = 3;
-              break;
-            }
-            return _context.a(2, null);
-          case 3:
-            // Add prefix and override title with the generated one from the path
-            // Strip descriptionMarkdown and titleMarkdown to reduce bundle size
-            enrichedMetadata = _extends(_extends({}, metadata), {}, {
-              prefix: prefix,
-              // Use the generated title from the path (override markdown's H1)
-              title: generatedTitle,
-              // Strip markdown AST fields from each page to reduce size
-              pages: metadata.pages.map(function (page) {
-                var descriptionMarkdown = page.descriptionMarkdown,
-                  sections = page.sections,
-                  pageWithoutMarkdown = _objectWithoutPropertiesLoose(page, _excluded2);
-                return _extends(_extends({}, pageWithoutMarkdown), {}, {
-                  // Strip titleMarkdown from sections hierarchy
-                  sections: sections ? stripTitleMarkdown(sections) : undefined
-                });
-              })
-            });
-            return _context.a(2, enrichedMetadata);
-        }
-      }, _callee);
-    }));
-    function loadPageIndex(_x) {
-      return _loadPageIndex.apply(this, arguments);
+export function createLoadServerPageIndex(options = {}) {
+  const rootContext = options.rootContext ?? process.cwd();
+  return async function loadPageIndex(filePath) {
+    // Convert file:// URLs to proper file system paths for reading the file
+    // Using fileURLToPath handles Windows drive letters correctly (e.g., file:///C:/... → C:\...)
+    const absolutePath = filePath.startsWith('file://') ? fileURLToPath(filePath) : filePath;
+
+    // Extract prefix and title from the import path
+    const {
+      prefix,
+      title: generatedTitle
+    } = extractPrefixAndTitle(absolutePath, rootContext);
+
+    // Read the markdown file
+    const markdownContent = await fs.readFile(absolutePath, 'utf-8');
+
+    // Parse the markdown to extract metadata
+    const metadata = await markdownToMetadata(markdownContent);
+    if (!metadata) {
+      return null;
     }
-    return loadPageIndex;
-  }();
+
+    // Add prefix and override title with the generated one from the path
+    // Strip descriptionMarkdown and titleMarkdown to reduce bundle size
+    const enrichedMetadata = {
+      ...metadata,
+      prefix,
+      // Use the generated title from the path (override markdown's H1)
+      title: generatedTitle,
+      // Strip markdown AST fields from each page to reduce size
+      pages: metadata.pages.map(page => {
+        const {
+          descriptionMarkdown,
+          sections,
+          ...pageWithoutMarkdown
+        } = page;
+        return {
+          ...pageWithoutMarkdown,
+          // Strip titleMarkdown from sections hierarchy
+          sections: sections ? stripTitleMarkdown(sections) : undefined
+        };
+      })
+    };
+    return enrichedMetadata;
+  };
 }

package/esm/pipeline/loadServerSitemap/loadServerSitemap.js

@@ -1,7 +1,3 @@
-import _createForOfIteratorHelper from "@babel/runtime/helpers/esm/createForOfIteratorHelper";
-import _regenerator from "@babel/runtime/helpers/esm/regenerator";
-import _slicedToArray from "@babel/runtime/helpers/esm/slicedToArray";
-import _asyncToGenerator from "@babel/runtime/helpers/esm/asyncToGenerator";
 import { readFile } from 'node:fs/promises';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -37,7 +33,7 @@ export function createSitemapSchema() {
  * This function parses the sitemap index file to find createSitemap calls and resolves
  * the page index paths from the imports.
  */
-export var loadServerSitemap = createLoadServerSitemap();
+export const loadServerSitemap = createLoadServerSitemap();
 
 /**
  * Creates a loadServerSitemap function with custom options.
@@ -51,120 +47,77 @@ export var loadServerSitemap = createLoadServerSitemap();
  * @param options - Configuration options for the loader
  * @returns LoadServerSitemap function that takes a file URL and returns Promise<Sitemap>
  */
-export function createLoadServerSitemap() {
-  var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
-  return /*#__PURE__*/function () {
-    var _loadSitemap = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2(url) {
-      var _options$rootContext;
-      var filePath, rootContext, loadPageIndex, source, sitemapCall, entries, results, sitemapData, errors, _iterator, _step, result, errorMessages;
-      return _regenerator().w(function (_context2) {
-        while (1) switch (_context2.n) {
-          case 0:
-            // Convert file:// URL to proper file system path for reading the file
-            // Using fileURLToPath handles Windows drive letters correctly (e.g., file:///C:/... → C:\...)
-            filePath = url.startsWith('file://') ? fileURLToPath(url) : url; // Determine root context from file path if not provided
-            rootContext = (_options$rootContext = options.rootContext) != null ? _options$rootContext : path.dirname(filePath); // Create page index loader with root context
-            loadPageIndex = createLoadServerPageIndex({
-              rootContext: rootContext
-            }); // Read the source file to find createSitemap calls
-            _context2.n = 1;
-            return readFile(filePath, 'utf-8');
-          case 1:
-            source = _context2.v;
-            _context2.n = 2;
-            return parseCreateFactoryCall(source, filePath);
-          case 2:
-            sitemapCall = _context2.v;
-            if (!(!sitemapCall || !sitemapCall.variants)) {
-              _context2.n = 3;
-              break;
-            }
-            return _context2.a(2, {
-              schema: createSitemapSchema(),
-              data: {}
-            });
-          case 3:
-            // Process all page index files in parallel
-            entries = Object.entries(sitemapCall.variants);
-            _context2.n = 4;
-            return Promise.all(entries.map(/*#__PURE__*/function () {
-              var _ref2 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(_ref) {
-                var _ref3, key, importPath, metadata, _t;
-                return _regenerator().w(function (_context) {
-                  while (1) switch (_context.p = _context.n) {
-                    case 0:
-                      _ref3 = _slicedToArray(_ref, 2), key = _ref3[0], importPath = _ref3[1];
-                      _context.p = 1;
-                      _context.n = 2;
-                      return loadPageIndex(importPath);
-                    case 2:
-                      metadata = _context.v;
-                      return _context.a(2, {
-                        key: key,
-                        metadata: metadata,
-                        error: null
-                      });
-                    case 3:
-                      _context.p = 3;
-                      _t = _context.v;
-                      return _context.a(2, {
-                        key: key,
-                        metadata: null,
-                        error: _t instanceof Error ? _t : new Error(String(_t))
-                      });
-                  }
-                }, _callee, null, [[1, 3]]);
-              }));
-              return function (_x2) {
-                return _ref2.apply(this, arguments);
-              };
-            }()));
-          case 4:
-            results = _context2.v;
-            // Collect results and errors
-            sitemapData = {};
-            errors = [];
-            _iterator = _createForOfIteratorHelper(results);
-            try {
-              for (_iterator.s(); !(_step = _iterator.n()).done;) {
-                result = _step.value;
-                if (result.error) {
-                  errors.push({
-                    key: result.key,
-                    error: result.error
-                  });
-                } else if (result.metadata) {
-                  sitemapData[result.key] = result.metadata;
-                }
-              }
+export function createLoadServerSitemap(options = {}) {
+  return async function loadSitemap(url) {
+    // Convert file:// URL to proper file system path for reading the file
+    // Using fileURLToPath handles Windows drive letters correctly (e.g., file:///C:/... → C:\...)
+    const filePath = url.startsWith('file://') ? fileURLToPath(url) : url;
 
-              // Throw if any pages failed to load
-            } catch (err) {
-              _iterator.e(err);
-            } finally {
-              _iterator.f();
-            }
-            if (!(errors.length > 0)) {
-              _context2.n = 5;
-              break;
-            }
-            errorMessages = errors.map(function (_ref4) {
-              var key = _ref4.key,
-                error = _ref4.error;
-              return "  ".concat(key, ": ").concat(error.message);
-            }).join('\n');
-            throw new Error("Failed to load ".concat(errors.length, " page index(es):\n").concat(errorMessages));
-          case 5:
-            return _context2.a(2, {
-              schema: createSitemapSchema(),
-              data: sitemapData
-            });
-        }
-      }, _callee2);
+    // Determine root context from file path if not provided
+    const rootContext = options.rootContext ?? path.dirname(filePath);
+
+    // Create page index loader with root context
+    const loadPageIndex = createLoadServerPageIndex({
+      rootContext
+    });
+
+    // Read the source file to find createSitemap calls
+    const source = await readFile(filePath, 'utf-8');
+
+    // Parse the source to find createSitemap call with page imports
+    const sitemapCall = await parseCreateFactoryCall(source, filePath);
+    if (!sitemapCall || !sitemapCall.variants) {
+      // Return empty sitemap if no createSitemap call found
+      return {
+        schema: createSitemapSchema(),
+        data: {}
+      };
+    }
+
+    // Process all page index files in parallel
+    const entries = Object.entries(sitemapCall.variants);
+    const results = await Promise.all(entries.map(async ([key, importPath]) => {
+      try {
+        const metadata = await loadPageIndex(importPath);
+        return {
+          key,
+          metadata,
+          error: null
+        };
+      } catch (error) {
+        return {
+          key,
+          metadata: null,
+          error: error instanceof Error ? error : new Error(String(error))
+        };
+      }
     }));
-    function loadSitemap(_x) {
-      return _loadSitemap.apply(this, arguments);
+
+    // Collect results and errors
+    const sitemapData = {};
+    const errors = [];
+    for (const result of results) {
+      if (result.error) {
+        errors.push({
+          key: result.key,
+          error: result.error
+        });
+      } else if (result.metadata) {
+        sitemapData[result.key] = result.metadata;
+      }
+    }
+
+    // Throw if any pages failed to load
+    if (errors.length > 0) {
+      const errorMessages = errors.map(({
+        key,
+        error
+      }) => `  ${key}: ${error.message}`).join('\n');
+      throw new Error(`Failed to load ${errors.length} page index(es):\n${errorMessages}`);
     }
-    return loadSitemap;
-  }();
+    return {
+      schema: createSitemapSchema(),
+      data: sitemapData
+    };
+  };
 }