@mui/internal-docs-infra 0.11.1-canary.5 → 0.11.1-canary.6

package/abstractCreateDemo/abstractCreateDemo.d.mts

@@ -34,20 +34,20 @@ type AbstractCreateDemoOptions<T extends {}> = {
   sourceParser?: Promise<ParseSource>;
   sourceEnhancers?: SourceEnhancers;
   /**
-   * Absolute filesystem path of the project root used to resolve `url`s
-   * gathered from `import.meta.url`. Combined with `projectUrl` to rewrite
-   * local `file://` URLs into hosted Git URLs (e.g.
+   * `file://` URL of the project root used to resolve `url`s gathered from
+   * `import.meta.url`. Combined with `projectUrl` to rewrite local `file://`
+   * URLs into hosted Git URLs (e.g.
    * `https://github.com/owner/repo/tree/<branch>/`) before they reach the
    * `CodeHighlighter`.
    *
    * Typically read from an environment variable populated by the build
-   * pipeline (e.g. Netlify's `REPOSITORY_URL`/`BRANCH` plus
-   * `git rev-parse --show-toplevel`). When either `projectPath` or
-   * `projectUrl` is missing, URLs are left untouched.
+   * pipeline (e.g. `process.env.SOURCE_CODE_ROOT_DIR` from
+   * `withDeploymentConfig`). When either `projectDir` or `projectUrl` is
+   * missing, URLs are left untouched.
    */
-  projectPath?: string;
+  projectDir?: string;
   /**
-   * Public URL prefix that maps to `projectPath`. See `projectPath` for
+   * Public URL prefix that maps to `projectDir`. See `projectDir` for
    * details.
    */
   projectUrl?: string;

package/abstractCreateDemo/abstractCreateDemo.mjs

@@ -1,5 +1,4 @@
 import * as React from 'react';
-import { pathToFileURL } from 'node:url';
 import { CodeHighlighter } from "../CodeHighlighter/index.mjs";
 import { applyUrlPrefixToCode, applyUrlPrefixToGlobalsCode, replaceUrlPrefix } from "../pipeline/loaderUtils/applyUrlPrefix.mjs";
 import { createDemoDataWithVariants } from "../createDemoData/index.mjs";
@@ -26,7 +25,7 @@ export function abstractCreateDemo(options, url, variants, meta) {
   // the `urlPrefix` prop on `<CodeHighlighter>` (forwarded into
   // `loadIsomorphicCodeVariant`) takes care of rewriting the loaded variant after the
   // file is read.
-  const urlPrefix = resolveUrlPrefix(options.projectPath, options.projectUrl);
+  const urlPrefix = resolveUrlPrefix(options.projectDir, options.projectUrl);
   const resolvedUrl = urlPrefix && demoData.precompute ? replaceUrlPrefix(demoData.url, urlPrefix) ?? demoData.url : demoData.url;
   const resolvedPrecompute = urlPrefix && demoData.precompute ? applyUrlPrefixToCode(demoData.precompute, urlPrefix) : demoData.precompute;
   const resolvedGlobalCode = urlPrefix && globalCode.length > 0 ? applyUrlPrefixToGlobalsCode(globalCode, urlPrefix) : globalCode;
@@ -87,11 +86,11 @@ export function abstractCreateDemo(options, url, variants, meta) {
   }
   return DemoComponent;
 }
-function resolveUrlPrefix(projectPath, projectUrl) {
-  if (!projectPath || !projectUrl) {
+function resolveUrlPrefix(projectDir, projectUrl) {
+  if (!projectDir || !projectUrl) {
     return undefined;
   }
-  const from = `${pathToFileURL(projectPath).href}/`;
+  const from = projectDir.endsWith('/') ? projectDir : `${projectDir}/`;
   const to = projectUrl.endsWith('/') ? projectUrl : `${projectUrl}/`;
   return {
     from,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mui/internal-docs-infra",
-  "version": "0.11.1-canary.5",
+  "version": "0.11.1-canary.6",
   "author": "MUI Team",
   "description": "MUI Infra - internal documentation creation tools.",
   "license": "MIT",
@@ -686,5 +686,5 @@
   "bin": {
     "docs-infra": "./cli/index.mjs"
   },
-  "gitSha": "9ce4b0162a6bdf6fb598e838f2f67c2df8869126"
+  "gitSha": "dc47acc4c60d02db487df3900491752cf51fe989"
 }

package/withDocsInfra/withDeploymentConfig.mjs

@@ -3,6 +3,7 @@ import { execSync } from 'node:child_process';
 import { readFileSync } from 'node:fs';
 import * as os from 'node:os';
 import { dirname, join } from 'node:path';
+import { pathToFileURL } from 'node:url';
 
 // Read Next.js version to handle version-specific config
 const nextMajorVersion = parseInt(pkgJson.version.split('.')[0], 10);
@@ -59,10 +60,22 @@ process.env.SHOW_PRIVATE_PAGES = SHOW_PRIVATE_PAGES;
  * Resolves to an empty string when neither source yields a value.
  */
 const repoRootDir = findRepoRootDir();
-const SOURCE_CODE_ROOT_PATH = repoRootDir ?? '';
+// Stored as a `file://` URL (with exactly one trailing slash) so consumers
+// can use it in isomorphic code without depending on Node's `url` module to
+// convert from a filesystem path. We normalize via the `URL` object so a repo
+// root that already ends in a separator (e.g. `/` or `C:\` at a drive root)
+// doesn't produce a double-slash suffix.
+const SOURCE_CODE_ROOT_DIR = repoRootDir ? toDirFileUrl(repoRootDir) : '';
 const SOURCE_CODE_ROOT_URL = resolveSourceCodeRootUrl(repoRootDir);
-process.env.SOURCE_CODE_ROOT_PATH = SOURCE_CODE_ROOT_PATH;
+process.env.SOURCE_CODE_ROOT_DIR = SOURCE_CODE_ROOT_DIR;
 process.env.SOURCE_CODE_ROOT_URL = SOURCE_CODE_ROOT_URL;
+function toDirFileUrl(dir) {
+  const url = pathToFileURL(dir);
+  if (!url.pathname.endsWith('/')) {
+    url.pathname = `${url.pathname}/`;
+  }
+  return url.href;
+}
 function resolveSourceCodeRootUrl(rootDir) {
   const repositoryUrl = process.env.REPOSITORY_URL ?? (rootDir ? readRepositoryUrlFromPackageJson(rootDir) : undefined);
   const headEnv = process.env.HEAD;
@@ -189,10 +202,10 @@ export function withDeploymentConfig(nextConfig) {
       // commit (e.g. `https://github.com/owner/repo/tree/<branch>/`). Derived
       // from REPOSITORY_URL/BRANCH with package.json/git fallbacks.
       SOURCE_CODE_ROOT_URL,
-      // Absolute filesystem path of the repository root, used to translate
-      // `import.meta.url` file URLs into paths relative to the repo root
-      // before applying SOURCE_CODE_ROOT_URL.
-      SOURCE_CODE_ROOT_PATH,
+      // `file://` URL (with trailing slash) of the repository root, used to
+      // translate `import.meta.url` file URLs into paths relative to the repo
+      // root before applying SOURCE_CODE_ROOT_URL.
+      SOURCE_CODE_ROOT_DIR,
       // For template images
       TEMPLATE_IMAGE_URL: ''
     },