@mui/internal-docs-infra 0.2.3-canary.9 → 0.3.1-canary.1

package/esm/pipeline/loaderUtils/processRelativeImports.js

@@ -4,6 +4,7 @@ import _slicedToArray from "@babel/runtime/helpers/esm/slicedToArray";
 import { rewriteImports } from "./rewriteImports.js";
 import { isJavaScriptModule } from "./resolveModulePath.js";
 import { getFileNameFromUrl } from "./getFileNameFromUrl.js";
+import { fileUrlToPortablePath, portablePathToFileUrl } from "./fileUrlToPortablePath.js";
 /**
  * Processes flat mode with intelligent conflict resolution
  */
@@ -16,9 +17,11 @@ function processFlatMode(importResult, resolvedPathsMap) {
     var _ref2 = _slicedToArray(_ref, 2),
       relativePath = _ref2[0],
       importInfo = _ref2[1];
-    var resolvedPath = resolvedPathsMap.get(importInfo.path);
-    if (resolvedPath) {
-      var fileExtension = getFileNameFromUrl(resolvedPath).extension;
+    var resolvedUrl = resolvedPathsMap.get(importInfo.url);
+    if (resolvedUrl) {
+      // Convert file URL to portable path for path manipulation
+      var resolvedPath = resolvedUrl.startsWith('file://') ? fileUrlToPortablePath(resolvedUrl) : resolvedUrl;
+      var fileExtension = getFileNameFromUrl(resolvedUrl).extension;
       var pathSegments = resolvedPath.split('/').filter(Boolean);
       fileMapping.push({
         resolvedPath: resolvedPath,
@@ -36,8 +39,13 @@ function processFlatMode(importResult, resolvedPathsMap) {
     var file = _fileMapping[_i];
     var fileName = file.segments[file.segments.length - 1];
     var isIndexFile = fileName.startsWith('index.');
+    var isUnderscoreIndexFile = fileName.startsWith('_index.');
     var candidateName = void 0;
-    if (isIndexFile) {
+    if (isUnderscoreIndexFile) {
+      // Files starting with "_index." should be treated as direct index imports
+      // e.g., "../../dir/_index.module.css" -> "index.module.css"
+      candidateName = "index".concat(file.extension);
+    } else if (isIndexFile) {
       // Check if the original import was a direct index file (e.g., "./index.ext")
       var originalImportParts = file.originalImportPath.split('/');
       var isDirectIndexImport = originalImportParts.length === 2 && originalImportParts[0] === '.' && originalImportParts[1].startsWith('index.');
@@ -131,9 +139,13 @@ function processFlatMode(importResult, resolvedPathsMap) {
                   var _file = _step.value;
                   var _fileName = _file.segments[_file.segments.length - 1];
                   var _isIndexFile = _fileName.startsWith('index.');
+                  var _isUnderscoreIndexFile = _fileName.startsWith('_index.');
                   var distinguishingSegment = _file.segments[_distinguishingIndex];
                   var finalName = void 0;
-                  if (_isIndexFile) {
+                  if (_isUnderscoreIndexFile) {
+                    // Files starting with "_index." should always use "index" as the base name
+                    finalName = "".concat(distinguishingSegment, "/index").concat(_file.extension);
+                  } else if (_isIndexFile) {
                     // Check if this was a direct index import
                     var _originalImportParts = _file.originalImportPath.split('/');
                     var _isDirectIndexImport = _originalImportParts.length === 2 && _originalImportParts[0] === '.' && _originalImportParts[1].startsWith('index.');
@@ -202,9 +214,13 @@ function processFlatMode(importResult, resolvedPathsMap) {
           var _file2 = _step3.value;
           var _fileName2 = _file2.segments[_file2.segments.length - 1];
           var _isIndexFile2 = _fileName2.startsWith('index.');
+          var _isUnderscoreIndexFile2 = _fileName2.startsWith('_index.');
           var _distinguishingSegment = _file2.segments[distinguishingIndex];
           var _finalName = void 0;
-          if (_isIndexFile2) {
+          if (_isUnderscoreIndexFile2) {
+            // Files starting with "_index." should always use "index" as the base name
+            _finalName = "".concat(_distinguishingSegment, "/index").concat(_file2.extension);
+          } else if (_isIndexFile2) {
             // Check if this was a direct index import
             var _originalImportParts2 = _file2.originalImportPath.split('/');
             var _isDirectIndexImport2 = _originalImportParts2.length === 2 && _originalImportParts2[0] === '.' && _originalImportParts2[1].startsWith('index.');
@@ -229,7 +245,7 @@ function processFlatMode(importResult, resolvedPathsMap) {
 
   // Fourth pass: build the extraFiles mapping
   finalNames.forEach(function (finalName, resolvedPath) {
-    extraFiles["./".concat(finalName)] = "file://".concat(resolvedPath);
+    extraFiles["./".concat(finalName)] = portablePathToFileUrl(resolvedPath);
   });
   return {
     processedSource: '',
@@ -253,8 +269,8 @@ function processBasicImports(source, importResult, storeAt) {
       var _ref4 = _slicedToArray(_ref3, 2),
         _relativePath = _ref4[0],
         importInfo = _ref4[1];
-      var resolvedPath = importInfo.path; // For CSS, this is already resolved by parseImports
-      var fileUrl = resolvedPath.startsWith('http') ? resolvedPath : "file://".concat(resolvedPath);
+      var resolvedPath = importInfo.url; // For CSS, this is already resolved by parseImports
+      var fileUrl = portablePathToFileUrl(resolvedPath);
       var _getFileNameFromUrl = getFileNameFromUrl(fileUrl),
         fileName = _getFileNameFromUrl.fileName,
         extension = _getFileNameFromUrl.extension;
@@ -277,7 +293,7 @@ function processBasicImports(source, importResult, storeAt) {
       var _ref6 = _slicedToArray(_ref5, 2),
         relativePath = _ref6[0],
         importInfo = _ref6[1];
-      var resolvedPath = importInfo.path;
+      var resolvedPath = importInfo.url;
       var finalName = finalNames.get(resolvedPath);
       if (finalName) {
         importPathMapping.set(relativePath, finalName);
@@ -286,8 +302,7 @@ function processBasicImports(source, importResult, storeAt) {
 
     // Create extraFiles entries
     finalNames.forEach(function (finalName, resolvedPath) {
-      var fileUrl = resolvedPath.startsWith('http') ? resolvedPath : "file://".concat(resolvedPath);
-      extraFiles["./".concat(finalName)] = fileUrl;
+      extraFiles["./".concat(finalName)] = portablePathToFileUrl(resolvedPath);
     });
 
     // Apply import path replacements using position-based rewriting
@@ -316,9 +331,8 @@ function processBasicImports(source, importResult, storeAt) {
       var _ref8 = _slicedToArray(_ref7, 2),
         relativePath = _ref8[0],
         importInfo = _ref8[1];
-      var resolvedPath = importInfo.path;
-      var fileUrl = resolvedPath.startsWith('http') ? resolvedPath : "file://".concat(resolvedPath);
-      extraFiles[relativePath] = fileUrl; // Always use original path for extraFiles
+      var resolvedPath = importInfo.url;
+      extraFiles[relativePath] = portablePathToFileUrl(resolvedPath); // Always use original path for extraFiles
     });
 
     // Apply import path replacements using position-based rewriting
@@ -338,9 +352,8 @@ function processBasicImports(source, importResult, storeAt) {
     var _ref0 = _slicedToArray(_ref9, 2),
       relativePath = _ref0[0],
       importInfo = _ref0[1];
-    var resolvedPath = importInfo.path;
-    var fileUrl = resolvedPath.startsWith('http') ? resolvedPath : "file://".concat(resolvedPath);
-    extraFiles[relativePath] = fileUrl; // Use original import path
+    var resolvedPath = importInfo.url;
+    extraFiles[relativePath] = portablePathToFileUrl(resolvedPath); // Use original import path
   });
   return {
     processedSource: source,
@@ -363,7 +376,8 @@ function processJsImports(source, importResult, storeAt, resolvedPathsMap) {
       var _ref10 = _slicedToArray(_ref1, 2),
         extraFileKey = _ref10[0],
         fileUrl = _ref10[1];
-      var resolvedPath = fileUrl.replace('file://', '');
+      // Convert file URL to portable path for lookup
+      var resolvedPath = fileUrl.startsWith('file://') ? fileUrlToPortablePath(fileUrl) : fileUrl;
       resolvedToExtraFile.set(resolvedPath, extraFileKey);
     });
 
@@ -373,8 +387,10 @@ function processJsImports(source, importResult, storeAt, resolvedPathsMap) {
       var _ref12 = _slicedToArray(_ref11, 2),
         relativePath = _ref12[0],
         importInfo = _ref12[1];
-      var resolvedPath = resolvedPathsMap.get(importInfo.path);
-      if (resolvedPath) {
+      var resolvedUrl = resolvedPathsMap.get(importInfo.url);
+      if (resolvedUrl) {
+        // Convert file URL to portable path for lookup
+        var resolvedPath = resolvedUrl.startsWith('file://') ? fileUrlToPortablePath(resolvedUrl) : resolvedUrl;
         var extraFileKey = resolvedToExtraFile.get(resolvedPath);
         if (extraFileKey) {
           // For JavaScript modules, remove the extension; for other files (CSS, JSON, etc.), keep it
@@ -408,12 +424,14 @@ function processJsImports(source, importResult, storeAt, resolvedPathsMap) {
     var _ref14 = _slicedToArray(_ref13, 2),
       relativePath = _ref14[0],
       importInfo = _ref14[1];
-    var resolved = resolvedPathsMap.get(importInfo.path);
-    if (!resolved) {
+    var resolvedUrl = resolvedPathsMap.get(importInfo.url);
+    if (!resolvedUrl) {
       return;
     }
-    var resolvedPath = resolved;
-    var fileExtension = getFileNameFromUrl(resolvedPath).extension;
+
+    // Convert file URL to portable path for path manipulation
+    var resolvedPath = resolvedUrl.startsWith('file://') ? fileUrlToPortablePath(resolvedUrl) : resolvedUrl;
+    var fileExtension = getFileNameFromUrl(resolvedUrl).extension;
     var isJavascriptModule = isJavaScriptModule(relativePath);
     var keyPath;
     if (!isJavascriptModule) {
@@ -434,8 +452,7 @@ function processJsImports(source, importResult, storeAt, resolvedPathsMap) {
           keyPath = "".concat(relativePath).concat(fileExtension);
       }
     }
-    var fileUrl = resolvedPath.startsWith('http') ? resolvedPath : "file://".concat(resolvedPath);
-    extraFiles[keyPath] = fileUrl;
+    extraFiles[keyPath] = portablePathToFileUrl(resolvedPath);
   });
   return {
     processedSource: source,

package/esm/pipeline/loaderUtils/resolveModulePath.d.ts

@@ -37,18 +37,18 @@ export interface TypeAwareResolveResult {
  * Resolves a module path by reading directory contents to find matching files.
  * This is more efficient than checking each file individually with stat calls.
  *
- * Given a path like `/Code/mui-public/packages/docs-infra/docs/app/components/code-highlighter/demos/code/BasicCode`,
+ * Given a path like `file:///Code/mui-public/packages/docs-infra/docs/app/components/code-highlighter/demos/code/BasicCode`,
  * this function will try to find the actual file by checking for:
  * - `BasicCode.ts`, `BasicCode.tsx`, `BasicCode.js`, `BasicCode.jsx`
  * - `BasicCode/index.ts`, `BasicCode/index.tsx`, `BasicCode/index.js`, `BasicCode/index.jsx`
  *
- * @param modulePath - The module path to resolve (without file extension)
+ * @param moduleUrl - The module URL to resolve (file:// URL or portable path, without file extension)
  * @param readDirectory - Function to read directory contents
  * @param options - Configuration options
  * @param includeTypeDefs - If true, returns both import and typeImport paths with different extension priorities
- * @returns Promise<string | TypeAwareResolveResult> - The resolved file path(s)
+ * @returns Promise<string | TypeAwareResolveResult> - The resolved file:// URL(s)
  */
-export declare function resolveModulePath(modulePath: string, readDirectory: DirectoryReader, options?: ResolveModulePathOptions, includeTypeDefs?: boolean): Promise<string | TypeAwareResolveResult>;
+export declare function resolveModulePath(moduleUrl: string, readDirectory: DirectoryReader, options?: ResolveModulePathOptions, includeTypeDefs?: boolean): Promise<string | TypeAwareResolveResult>;
 /**
  * Resolves multiple module paths efficiently by grouping them by directory
  * and performing batch directory lookups.
@@ -70,7 +70,7 @@ export declare function resolveModulePaths(modulePaths: string[], readDirectory:
  * @returns Promise<Map<string, string>> - Map from import path to resolved file path
  */
 export declare function resolveImportResult(importResult: Record<string, {
-  path: string;
+  url: string;
   names: string[];
   includeTypeDefs?: true;
   positions?: Array<{

package/esm/pipeline/loaderUtils/resolveModulePath.js

@@ -5,6 +5,7 @@ import _createForOfIteratorHelper from "@babel/runtime/helpers/esm/createForOfIt
 import _regenerator from "@babel/runtime/helpers/esm/regenerator";
 import _asyncToGenerator from "@babel/runtime/helpers/esm/asyncToGenerator";
 import { getFileNameFromUrl } from "./getFileNameFromUrl.js";
+import { fileUrlToPortablePath, portablePathToFileUrl } from "./fileUrlToPortablePath.js";
 
 /**
  * Isomorphic path joining function that works in both Node.js and browser environments.
@@ -65,16 +66,16 @@ export function isJavaScriptModule(path) {
  * Resolves a module path by reading directory contents to find matching files.
  * This is more efficient than checking each file individually with stat calls.
  *
- * Given a path like `/Code/mui-public/packages/docs-infra/docs/app/components/code-highlighter/demos/code/BasicCode`,
+ * Given a path like `file:///Code/mui-public/packages/docs-infra/docs/app/components/code-highlighter/demos/code/BasicCode`,
  * this function will try to find the actual file by checking for:
  * - `BasicCode.ts`, `BasicCode.tsx`, `BasicCode.js`, `BasicCode.jsx`
  * - `BasicCode/index.ts`, `BasicCode/index.tsx`, `BasicCode/index.js`, `BasicCode/index.jsx`
  *
- * @param modulePath - The module path to resolve (without file extension)
+ * @param moduleUrl - The module URL to resolve (file:// URL or portable path, without file extension)
  * @param readDirectory - Function to read directory contents
  * @param options - Configuration options
  * @param includeTypeDefs - If true, returns both import and typeImport paths with different extension priorities
- * @returns Promise<string | TypeAwareResolveResult> - The resolved file path(s)
+ * @returns Promise<string | TypeAwareResolveResult> - The resolved file:// URL(s)
  */
 export function resolveModulePath(_x, _x2) {
   return _resolveModulePath.apply(this, arguments);
@@ -85,11 +86,12 @@ export function resolveModulePath(_x, _x2) {
  * This function is optimized to do only a single directory read instead of two separate reads.
  */
 function _resolveModulePath() {
-  _resolveModulePath = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(modulePath, readDirectory) {
+  _resolveModulePath = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(moduleUrl, readDirectory) {
     var options,
       includeTypeDefs,
       _options$extensions,
       extensions,
+      modulePath,
       lastSlashIndex,
       parentDir,
       moduleName,
@@ -100,7 +102,8 @@ function _resolveModulePath() {
         case 0:
           options = _args.length > 2 && _args[2] !== undefined ? _args[2] : {};
           includeTypeDefs = _args.length > 3 ? _args[3] : undefined;
-          _options$extensions = options.extensions, extensions = _options$extensions === void 0 ? JAVASCRIPT_MODULE_EXTENSIONS : _options$extensions; // If includeTypeDefs is true, we need to resolve with both type and value extension priorities
+          _options$extensions = options.extensions, extensions = _options$extensions === void 0 ? JAVASCRIPT_MODULE_EXTENSIONS : _options$extensions; // Convert file URL to portable path for internal processing
+          modulePath = moduleUrl.startsWith('file://') ? fileUrlToPortablePath(moduleUrl) : moduleUrl; // If includeTypeDefs is true, we need to resolve with both type and value extension priorities
           if (!includeTypeDefs) {
             _context.n = 1;
             break;
@@ -205,7 +208,7 @@ function _resolveWithTypeAwareness() {
           parentDir = modulePath.substring(0, lastSlashIndex);
           moduleName = modulePath.substring(lastSlashIndex + 1); // Single filesystem read to get directory contents
           _context2.n = 1;
-          return readDirectory(parentDir);
+          return readDirectory(portablePathToFileUrl(parentDir));
         case 1:
           dirContents = _context2.v;
           // Build a map of available files by basename
@@ -271,7 +274,7 @@ function _resolveWithTypeAwareness() {
             _context2.n = 6;
             break;
           }
-          importPath = joinPath(parentDir, entry.name);
+          importPath = portablePathToFileUrl(joinPath(parentDir, entry.name));
           return _context2.a(3, 7);
         case 6:
           _context2.n = 5;
@@ -332,7 +335,7 @@ function _resolveWithTypeAwareness() {
             _context2.n = 20;
             break;
           }
-          typeImportPath = joinPath(parentDir, _entry.name);
+          typeImportPath = portablePathToFileUrl(joinPath(parentDir, _entry.name));
           return _context2.a(3, 21);
         case 20:
           _context2.n = 19;
@@ -405,7 +408,7 @@ function _resolveWithTypeAwareness() {
           moduleDir = joinPath(parentDir, directoryMatches[0].name);
           _context2.p = 33;
           _context2.n = 34;
-          return readDirectory(moduleDir);
+          return readDirectory(portablePathToFileUrl(moduleDir));
         case 34:
           moduleDirContents = _context2.v;
           // Build a map of available index files by basename
@@ -471,7 +474,7 @@ function _resolveWithTypeAwareness() {
             _context2.n = 39;
             break;
           }
-          _importPath = joinPath(moduleDir, _entry2.name);
+          _importPath = portablePathToFileUrl(joinPath(moduleDir, _entry2.name));
           return _context2.a(3, 40);
         case 39:
           _context2.n = 38;
@@ -532,7 +535,7 @@ function _resolveWithTypeAwareness() {
             _context2.n = 53;
             break;
           }
-          _typeImportPath = joinPath(moduleDir, _entry3.name);
+          _typeImportPath = portablePathToFileUrl(joinPath(moduleDir, _entry3.name));
           return _context2.a(3, 54);
         case 53:
           _context2.n = 52;
@@ -628,7 +631,7 @@ function _resolveSinglePath() {
         case 0:
           _context3.p = 0;
           _context3.n = 1;
-          return readDirectory(parentDir);
+          return readDirectory(portablePathToFileUrl(parentDir));
         case 1:
           dirContents = _context3.v;
           // Look for direct file matches in extension priority order
@@ -696,7 +699,7 @@ function _resolveSinglePath() {
             break;
           }
           resolvedPath = joinPath(parentDir, entry.name);
-          return _context3.a(2, resolvedPath);
+          return _context3.a(2, portablePathToFileUrl(resolvedPath));
         case 6:
           _context3.n = 5;
           break;
@@ -737,7 +740,7 @@ function _resolveSinglePath() {
           moduleDir = joinPath(parentDir, directoryMatches[0].name);
           _context3.p = 15;
           _context3.n = 16;
-          return readDirectory(moduleDir);
+          return readDirectory(portablePathToFileUrl(moduleDir));
         case 16:
           moduleDirContents = _context3.v;
           // Look for index files in extension priority order
@@ -803,7 +806,7 @@ function _resolveSinglePath() {
             _context3.n = 21;
             break;
           }
-          return _context3.a(2, joinPath(moduleDir, _entry5.name));
+          return _context3.a(2, portablePathToFileUrl(joinPath(moduleDir, _entry5.name)));
         case 21:
           _context3.n = 20;
           break;
@@ -931,7 +934,7 @@ function _resolveModulePaths() {
                     _ref3 = _slicedToArray(_ref, 2), parentDir = _ref3[0], pathGroup = _ref3[1];
                     _context5.p = 1;
                     _context5.n = 2;
-                    return readDirectory(parentDir);
+                    return readDirectory(portablePathToFileUrl(parentDir));
                   case 2:
                     dirContents = _context5.v;
                     unresolved = [];
@@ -999,7 +1002,7 @@ function _resolveModulePaths() {
                     }
                     resolved.push({
                       fullPath: _fullPath,
-                      resolvedPath: joinPath(parentDir, _entry7.name)
+                      resolvedPath: portablePathToFileUrl(joinPath(parentDir, _entry7.name))
                     });
                     foundMatch = true;
                     return _context5.a(3, 10);
@@ -1083,7 +1086,7 @@ function _resolveModulePaths() {
                               moduleDir = joinPath(parentDir, moduleName);
                               _context4.p = 1;
                               _context4.n = 2;
-                              return readDirectory(moduleDir);
+                              return readDirectory(portablePathToFileUrl(moduleDir));
                             case 2:
                               moduleDirContents = _context4.v;
                               // Look for index files in extension priority order
@@ -1140,7 +1143,7 @@ function _resolveModulePaths() {
                               }
                               return _context4.a(2, {
                                 fullPath: fullPath,
-                                resolvedPath: joinPath(moduleDir, entry.name)
+                                resolvedPath: portablePathToFileUrl(joinPath(moduleDir, entry.name))
                               });
                             case 7:
                               _context4.n = 6;
@@ -1285,26 +1288,26 @@ function _resolveImportResult() {
           jsModulesWithExtensions = [];
           staticAssets = [];
           _loop = /*#__PURE__*/_regenerator().m(function _loop() {
-            var _Object$entries$_i, importPath, _Object$entries$_i$, path, includeTypeDefs;
+            var _Object$entries$_i, importPath, _Object$entries$_i$, url, includeTypeDefs;
             return _regenerator().w(function (_context7) {
               while (1) switch (_context7.n) {
                 case 0:
-                  _Object$entries$_i = _slicedToArray(_Object$entries[_i], 2), importPath = _Object$entries$_i[0], _Object$entries$_i$ = _Object$entries$_i[1], path = _Object$entries$_i$.path, includeTypeDefs = _Object$entries$_i$.includeTypeDefs;
+                  _Object$entries$_i = _slicedToArray(_Object$entries[_i], 2), importPath = _Object$entries$_i[0], _Object$entries$_i$ = _Object$entries$_i[1], url = _Object$entries$_i$.url, includeTypeDefs = _Object$entries$_i$.includeTypeDefs;
                   if (isJavaScriptModule(importPath)) {
                     // If the import path already has a JS/TS extension, use it as-is
                     if (JAVASCRIPT_MODULE_EXTENSIONS.some(function (ext) {
                       return importPath.endsWith(ext);
                     })) {
-                      jsModulesWithExtensions.push(path);
+                      jsModulesWithExtensions.push(url);
                     } else {
                       jsModulesToResolve.push({
-                        path: path,
+                        url: url,
                         includeTypeDefs: includeTypeDefs
                       });
                     }
                   } else {
-                    // Static asset - use path as-is
-                    staticAssets.push(path);
+                    // Static asset - use url as-is
+                    staticAssets.push(url);
                   }
                 case 1:
                   return _context7.a(2);
@@ -1324,13 +1327,13 @@ function _resolveImportResult() {
           break;
         case 3:
           // Add modules with extensions as-is
-          jsModulesWithExtensions.forEach(function (path) {
-            resolvedPathsMap.set(path, path);
+          jsModulesWithExtensions.forEach(function (url) {
+            resolvedPathsMap.set(url, url);
           });
 
           // Add static assets as-is
-          staticAssets.forEach(function (path) {
-            resolvedPathsMap.set(path, path);
+          staticAssets.forEach(function (url) {
+            resolvedPathsMap.set(url, url);
           });
 
           // Resolve JS modules without extensions
@@ -1340,14 +1343,14 @@ function _resolveImportResult() {
           }
           resolutionPromises = jsModulesToResolve.map(/*#__PURE__*/function () {
             var _ref7 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee7(_ref6) {
-              var path, includeTypeDefs, resolved, _t21;
+              var url, includeTypeDefs, resolved, _t21;
               return _regenerator().w(function (_context8) {
                 while (1) switch (_context8.p = _context8.n) {
                   case 0:
-                    path = _ref6.path, includeTypeDefs = _ref6.includeTypeDefs;
+                    url = _ref6.url, includeTypeDefs = _ref6.includeTypeDefs;
                     _context8.p = 1;
                     _context8.n = 2;
-                    return resolveModulePath(path, readDirectory, options, includeTypeDefs);
+                    return resolveModulePath(url, readDirectory, options, includeTypeDefs);
                   case 2:
                     resolved = _context8.v;
                     if (!(typeof resolved === 'string')) {
@@ -1355,12 +1358,12 @@ function _resolveImportResult() {
                       break;
                     }
                     return _context8.a(2, {
-                      path: path,
+                      url: url,
                       resolved: resolved
                     });
                   case 3:
                     return _context8.a(2, {
-                      path: path,
+                      url: url,
                       resolved: resolved["import"]
                     });
                   case 4:
@@ -1381,7 +1384,7 @@ function _resolveImportResult() {
           // Add successful resolutions to the map
           resolutionResults.forEach(function (result) {
             if (result) {
-              resolvedPathsMap.set(result.path, result.resolved);
+              resolvedPathsMap.set(result.url, result.resolved);
             }
           });
         case 5:
@@ -1423,8 +1426,8 @@ function _resolveVariantPaths() {
             _Object$entries2$_i = _slicedToArray(_Object$entries2[_i2], 2), variantName = _Object$entries2$_i[0], variantPath = _Object$entries2$_i[1];
             resolvedVariantPath = resolvedVariantPaths.get(variantPath);
             if (resolvedVariantPath) {
-              // Store as a file URL
-              variantMap.set(variantName, "file://".concat(resolvedVariantPath));
+              // Store as a file URL (portablePathToFileUrl handles portable paths correctly)
+              variantMap.set(variantName, portablePathToFileUrl(resolvedVariantPath));
             }
           }
           return _context0.a(2, variantMap);

package/esm/pipeline/loaderUtils/rewriteImports.d.ts

@@ -1,3 +1,39 @@
+/**
+ * Converts import statements to const declarations set to null.
+ * This preserves variable names while removing the actual imports.
+ * Useful when precomputing data that makes the imports unnecessary.
+ *
+ * @param source - The source code to process
+ * @param importPathsToRewrite - Set of import paths whose import statements should be rewritten
+ * @param importResult - Import result with position and name data
+ * @returns The source code with import statements rewritten to const declarations
+ */
+export declare function rewriteImportsToNull(source: string, importPathsToRewrite: Set<string>, importResult: Record<string, {
+  positions: Array<{
+    start: number;
+    end: number;
+  }>;
+  names: Array<{
+    name: string;
+    alias?: string;
+    type: string;
+  }>;
+}>): string;
+/**
+ * Removes entire import statements for the specified import paths.
+ * This removes the full import line, not just the path.
+ *
+ * @param source - The source code to process
+ * @param importPathsToRemove - Set of import paths whose entire import statements should be removed
+ * @param importResult - Import result with position data
+ * @returns The source code with import statements removed
+ */
+export declare function removeImports(source: string, importPathsToRemove: Set<string>, importResult: Record<string, {
+  positions: Array<{
+    start: number;
+    end: number;
+  }>;
+}>): string;
 /**
  * Efficiently rewrites import paths using position data.
  * This avoids regex parsing and uses precise position information for replacement.