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

package/esm/pipeline/loadCodeVariant/loadCodeVariant.js

@@ -85,15 +85,28 @@ function convertKeyBasedOnDirectory(nestedKey, sourceFileKey) {
     processedNestedKey = "./".concat(nestedKey);
   }
 
-  // Use path module for clean path resolution
+  // Get the directory of the source file
   var sourceDir = path.dirname(sourceFileKey);
-  var resolvedPath = path.resolve(sourceDir, processedNestedKey);
 
-  // Convert back to relative path from current directory
-  var result = path.relative('.', resolvedPath);
+  // If sourceDir is '.' (current directory), just return the processed nested key
+  // This avoids path.resolve which can produce absolute paths on Windows
+  if (sourceDir === '.') {
+    // Remove leading './' if present for consistency
+    return processedNestedKey.startsWith('./') ? processedNestedKey.slice(2) : processedNestedKey;
+  }
+
+  // Use path.join instead of path.resolve to avoid producing absolute paths
+  // path.join keeps paths relative, while path.resolve can make them absolute
+  var joinedPath = path.join(sourceDir, processedNestedKey);
 
-  // Return empty string if result is '.' (current directory)
-  return result === '.' ? '' : result;
+  // Normalize the path to clean up any ../ or ./ segments
+  var normalizedPath = path.normalize(joinedPath);
+
+  // Ensure we return a clean relative path (remove leading './' if present after normalization)
+  if (normalizedPath.startsWith('./')) {
+    return normalizedPath.slice(2);
+  }
+  return normalizedPath === '.' ? '' : normalizedPath;
 }
 
 /**

package/esm/pipeline/loadPrecomputedCodeHighlighter/loadPrecomputedCodeHighlighter.js

@@ -5,6 +5,8 @@ import _asyncToGenerator from "@babel/runtime/helpers/esm/asyncToGenerator";
 // webpack does not like node: imports
 // eslint-disable-next-line n/prefer-node-protocol
 import path from 'path';
+// eslint-disable-next-line n/prefer-node-protocol
+import { fileURLToPath, pathToFileURL } from 'url';
 import { loadCodeVariant } from "../loadCodeVariant/loadCodeVariant.js";
 import { createParseSource } from "../parseSource/index.js";
 // TODO: re-enable following benchmarking
@@ -40,7 +42,7 @@ function _loadPrecomputedCodeHighlighter() {
       _options$performance2,
       _options$performance3,
       _this = this;
-    var callback, options, performanceNotableMs, performanceShowWrapperMeasures, relativePath, observer, currentMark, _observer, _observer2, demoCall, variantData, allDependencies, resolvedVariantMap, loadSource, sourceTransformers, sourceParser, functionsInitMark, variantPromises, variantResults, _iterator, _step, result, modifiedSource, _observer3, _observer4, _t2;
+    var callback, options, performanceNotableMs, performanceShowWrapperMeasures, relativePath, observer, currentMark, resourceFileUrl, _observer, _observer2, demoCall, variantData, allDependencies, resolvedVariantMap, loadSource, sourceTransformers, sourceParser, functionsInitMark, variantPromises, variantResults, _iterator, _step, result, modifiedSource, _observer3, _observer4, _t2;
     return _regenerator().w(function (_context2) {
       while (1) switch (_context2.p = _context2.n) {
         case 0:
@@ -60,10 +62,12 @@ function _loadPrecomputedCodeHighlighter() {
           currentMark = performanceMeasure(undefined, {
             mark: 'Start',
             measure: 'Start'
-          }, [functionName, relativePath], true);
+          }, [functionName, relativePath], true); // Convert the filesystem path to a file:// URL for cross-platform compatibility
+          // pathToFileURL handles Windows drive letters correctly (e.g., C:\... → file:///C:/...)
+          resourceFileUrl = pathToFileURL(this.resourcePath).toString();
           _context2.p = 1;
           _context2.n = 2;
-          return parseCreateFactoryCall(source, this.resourcePath);
+          return parseCreateFactoryCall(source, resourceFileUrl);
         case 2:
           demoCall = _context2.v;
           currentMark = performanceMeasure(currentMark, {
@@ -222,8 +226,9 @@ function _loadPrecomputedCodeHighlighter() {
 
           // Add all dependencies to webpack's watch list
           allDependencies.forEach(function (dep) {
-            // Strip 'file://' prefix if present before adding to webpack's dependency tracking
-            _this.addDependency(dep.startsWith('file://') ? dep.slice(7) : dep);
+            // Convert file:// URLs to proper file system paths for webpack's dependency tracking
+            // Using fileURLToPath handles Windows drive letters correctly (e.g., file:///C:/... → C:\...)
+            _this.addDependency(dep.startsWith('file://') ? fileURLToPath(dep) : dep);
           });
 
           // log any pending performance entries before completing

package/esm/pipeline/loadPrecomputedCodeHighlighter/parseCreateFactoryCall.js

@@ -254,19 +254,19 @@ function parseVariantsObjectFromObject(obj, importMap, namedExportsMap, function
 
 /**
  * Helper function to convert the new parseImportsAndComments format to a Map
- * that maps import names to their resolved paths
+ * that maps import names to their resolved URLs
  */
 function buildImportMap(importResult, allowExternalVariants) {
   var importMap = new Map();
   Object.values(importResult.relative).forEach(function (_ref) {
-    var path = _ref.path,
+    var url = _ref.url,
       names = _ref.names;
     names.forEach(function (_ref2) {
       var name = _ref2.name,
         alias = _ref2.alias;
       // Use alias if available, otherwise use the original name
       var nameToUse = alias || name;
-      importMap.set(nameToUse, path);
+      importMap.set(nameToUse, url);
     });
   });
 

package/esm/pipeline/loadPrecomputedCodeHighlighterClient/loadPrecomputedCodeHighlighterClient.js

@@ -5,6 +5,10 @@ import _asyncToGenerator from "@babel/runtime/helpers/esm/asyncToGenerator";
 // webpack does not like node: imports
 // eslint-disable-next-line n/prefer-node-protocol
 import { readFile } from 'fs/promises';
+// eslint-disable-next-line n/prefer-node-protocol
+import path from 'path';
+// eslint-disable-next-line n/prefer-node-protocol
+import { fileURLToPath, pathToFileURL } from 'url';
 import { parseCreateFactoryCall } from "../loadPrecomputedCodeHighlighter/parseCreateFactoryCall.js";
 import { generateResolvedExternals } from "./generateResolvedExternals.js";
 import { loadCodeVariant } from "../loadCodeVariant/loadCodeVariant.js";
@@ -34,15 +38,19 @@ export function loadPrecomputedCodeHighlighterClient(_x) {
 function _loadPrecomputedCodeHighlighterClient() {
   _loadPrecomputedCodeHighlighterClient = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2(source) {
     var _this = this;
-    var callback, demoCall, allDependencies, allExternalsArray, clientDir, indexPath, indexDemoCall, indexSource, resolvedVariantMap, loadSource, variantPromises, variantResults, _iterator, _step, result, allExternals, runtimeExternals, _generateResolvedExte, importLines, resolvedExternals, precomputeData, modifiedSource, _t2, _t3;
+    var callback, resourceFileUrl, demoCall, allDependencies, allExternalsArray, clientDir, indexPath, indexFileUrl, indexDemoCall, indexSource, resolvedVariantMap, loadSource, variantPromises, variantResults, _iterator, _step, result, allExternals, runtimeExternals, _generateResolvedExte, importLines, resolvedExternals, precomputeData, modifiedSource, _t2, _t3;
     return _regenerator().w(function (_context2) {
       while (1) switch (_context2.p = _context2.n) {
         case 0:
           callback = this.async();
           this.cacheable();
           _context2.p = 1;
+          // Convert the filesystem path to a file:// URL for cross-platform compatibility
+          // pathToFileURL handles Windows drive letters correctly (e.g., C:\... → file:///C:/...)
+          resourceFileUrl = pathToFileURL(this.resourcePath).toString(); // Parse the source to find a single createDemoClient call
+          // Use metadataOnly mode since client calls only have (url, options?) arguments
           _context2.n = 2;
-          return parseCreateFactoryCall(source, this.resourcePath, {
+          return parseCreateFactoryCall(source, resourceFileUrl, {
             metadataOnly: true
           });
         case 2:
@@ -72,8 +80,9 @@ function _loadPrecomputedCodeHighlighterClient() {
           allDependencies = [];
           allExternalsArray = []; // For client files, we need to read the corresponding index.ts to get variants
           // The client.ts and index.ts should be in the same directory
-          clientDir = this.resourcePath.substring(0, this.resourcePath.lastIndexOf('/'));
-          indexPath = "".concat(clientDir, "/index.ts"); // Read and parse the index.ts file to get variant information
+          clientDir = path.dirname(this.resourcePath);
+          indexPath = path.join(clientDir, 'index.ts'); // Convert to file:// URL for parseCreateFactoryCall
+          indexFileUrl = pathToFileURL(indexPath).toString(); // Read and parse the index.ts file to get variant information
           indexDemoCall = null;
           _context2.p = 6;
           _context2.n = 7;
@@ -83,7 +92,7 @@ function _loadPrecomputedCodeHighlighterClient() {
           // Add index.ts as a dependency for hot reloading
           this.addDependency(indexPath);
           _context2.n = 8;
-          return parseCreateFactoryCall(indexSource, indexPath);
+          return parseCreateFactoryCall(indexSource, indexFileUrl);
         case 8:
           indexDemoCall = _context2.v;
           _context2.n = 10;
@@ -213,8 +222,9 @@ function _loadPrecomputedCodeHighlighterClient() {
 
           // Add all dependencies to webpack's watch list
           allDependencies.forEach(function (dep) {
-            // Strip 'file://' prefix if present before adding to webpack's dependency tracking
-            _this.addDependency(dep.startsWith('file://') ? dep.slice(7) : dep);
+            // Convert file:// URLs to proper file system paths for webpack's dependency tracking
+            // Using fileURLToPath handles Windows drive letters correctly (e.g., file:///C:/... → C:\...)
+            _this.addDependency(dep.startsWith('file://') ? fileURLToPath(dep) : dep);
           });
           callback(null, modifiedSource);
           _context2.n = 15;

package/esm/pipeline/loadPrecomputedSitemap/loadPrecomputedSitemap.js

@@ -5,6 +5,8 @@ import _asyncToGenerator from "@babel/runtime/helpers/esm/asyncToGenerator";
 // webpack does not like node: imports
 // eslint-disable-next-line n/prefer-node-protocol
 import path from 'path';
+// eslint-disable-next-line n/prefer-node-protocol
+import { fileURLToPath, pathToFileURL } from 'url';
 import { createPerformanceLogger, logPerformance, nameMark, performanceMeasure } from "../loadPrecomputedCodeHighlighter/performanceLogger.js";
 import { parseCreateFactoryCall } from "../loadPrecomputedCodeHighlighter/parseCreateFactoryCall.js";
 import { replacePrecomputeValue } from "../loadPrecomputedCodeHighlighter/replacePrecomputeValue.js";
@@ -18,7 +20,7 @@ export function loadPrecomputedSitemap(_x) {
 function _loadPrecomputedSitemap() {
   _loadPrecomputedSitemap = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2(source) {
     var _options$performance$, _options$performance, _options$performance$2, _options$performance2, _options$performance3;
-    var callback, options, performanceNotableMs, performanceShowWrapperMeasures, relativePath, observer, currentMark, _observer, _observer2, sitemapCall, variants, sitemapData, rootContext, loadPageIndex, entries, results, _iterator, _step, result, precomputeData, modifiedSource, relative, importPathsToRewrite, importResult, _i, _Object$entries, _Object$entries$_i, importPath, importData, _observer3, _observer4, _t2;
+    var callback, options, performanceNotableMs, performanceShowWrapperMeasures, relativePath, observer, currentMark, _observer, _observer2, resourceFileUrl, sitemapCall, variants, sitemapData, rootContext, loadPageIndex, entries, results, _iterator, _step, result, precomputeData, modifiedSource, relative, importPathsToRewrite, importResult, _i, _Object$entries, _Object$entries$_i, importPath, importData, _observer3, _observer4, _t2;
     return _regenerator().w(function (_context2) {
       while (1) switch (_context2.p = _context2.n) {
         case 0:
@@ -40,8 +42,11 @@ function _loadPrecomputedSitemap() {
           currentMark = nameMark(functionName, 'Start Loading', [relativePath]);
           performance.mark(currentMark);
           _context2.p = 1;
+          // Convert the filesystem path to a file:// URL for cross-platform compatibility
+          // pathToFileURL handles Windows drive letters correctly (e.g., C:\... → file:///C:/...)
+          resourceFileUrl = pathToFileURL(this.resourcePath).toString(); // Parse the source to find a single createSitemap call
           _context2.n = 2;
-          return parseCreateFactoryCall(source, this.resourcePath);
+          return parseCreateFactoryCall(source, resourceFileUrl);
         case 2:
           sitemapCall = _context2.v;
           currentMark = performanceMeasure(currentMark, {
@@ -93,7 +98,9 @@ function _loadPrecomputedSitemap() {
                 while (1) switch (_context.p = _context.n) {
                   case 0:
                     _ref3 = _slicedToArray(_ref, 2), key = _ref3[0], importPath = _ref3[1];
-                    absolutePath = importPath.startsWith('file://') ? importPath.slice(7) : importPath;
+                    // Convert file:// URLs to proper file system paths for webpack's dependency tracking
+                    // Using fileURLToPath handles Windows drive letters correctly (e.g., file:///C:/... → C:\...)
+                    absolutePath = importPath.startsWith('file://') ? fileURLToPath(importPath) : importPath;
                     _context.p = 1;
                     _context.n = 2;
                     return loadPageIndex(importPath);

package/esm/pipeline/loadServerCodeMeta/loadServerCodeMeta.js

@@ -2,6 +2,7 @@ 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 { fileURLToPath } from 'node:url';
 import { resolveVariantPathsWithFs } from "./resolveModulePathWithFs.js";
 import { parseCreateFactoryCall } from "../loadPrecomputedCodeHighlighter/parseCreateFactoryCall.js";
 import { getFileNameFromUrl } from "../loaderUtils/index.js";
@@ -35,14 +36,15 @@ export function createLoadServerCodeMeta() {
       return _regenerator().w(function (_context) {
         while (1) switch (_context.n) {
           case 0:
-            // Remove file:// prefix if present to get file path
-            filePath = url.replace('file://', ''); // Read the source file to find createDemo calls
+            // 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; // Read the source file to find createDemo calls
             _context.n = 1;
             return readFile(filePath, 'utf-8');
           case 1:
             source = _context.v;
             _context.n = 2;
-            return parseCreateFactoryCall(source, filePath);
+            return parseCreateFactoryCall(source, url);
           case 2:
             demoCall = _context.v;
             if (!(!demoCall || !demoCall.variants)) {

package/esm/pipeline/loadServerCodeMeta/resolveModulePathWithFs.d.ts

@@ -18,7 +18,7 @@ export declare function resolveModulePathWithFs(modulePath: string, options: Res
  * @param options - Configuration options
  * @returns Promise<Map<string, string>> - Map from input path to resolved file path
  */
-export declare function resolveModulePathsWithFs(modulePaths: string[], options?: ResolveModulePathOptions): Promise<Map<string, string>>;
+export declare function resolveModulePathsWithFs(moduleUrls: string[], options?: ResolveModulePathOptions): Promise<Map<string, string>>;
 /**
  * Resolves import result by separating JavaScript modules from static assets,
  * only resolving JavaScript modules and returning a combined map.
@@ -30,7 +30,7 @@ export declare function resolveModulePathsWithFs(modulePaths: string[], options?
  * @returns Promise<Map<string, string>> - Map from import path to resolved file path
  */
 export declare function resolveImportResultWithFs(importResult: Record<string, {
-  path: string;
+  url: string;
   names: string[];
   includeTypeDefs?: true;
   positions?: Array<{

package/esm/pipeline/loadServerCodeMeta/resolveModulePathWithFs.js

@@ -3,20 +3,26 @@ import _asyncToGenerator from "@babel/runtime/helpers/esm/asyncToGenerator";
 // webpack does not like node: imports
 // eslint-disable-next-line n/prefer-node-protocol
 import { readdir } from 'fs/promises';
+// eslint-disable-next-line n/prefer-node-protocol
+import { fileURLToPath } from 'url';
 import { resolveModulePath, resolveModulePaths, resolveImportResult, resolveVariantPaths } from "../loaderUtils/resolveModulePath.js";
 
 /**
  * Node.js filesystem-based directory reader that converts Dirent objects
  * to the DirectoryEntry interface expected by the resolver functions.
+ *
+ * The input is a file:// URL. We convert it to a filesystem path using fileURLToPath.
  */
 var nodeDirectoryReader = /*#__PURE__*/function () {
-  var _ref = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(path) {
-    var entries;
+  var _ref = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(fileUrl) {
+    var fsPath, entries;
     return _regenerator().w(function (_context) {
       while (1) switch (_context.n) {
         case 0:
+          // Convert file:// URL to filesystem path for Node.js fs APIs
+          fsPath = fileURLToPath(fileUrl);
           _context.n = 1;
-          return readdir(path, {
+          return readdir(fsPath, {
             withFileTypes: true
           });
         case 1:
@@ -59,7 +65,7 @@ export function resolveModulePathWithFs(_x2) {
  * @returns Promise<Map<string, string>> - Map from input path to resolved file path
  */
 function _resolveModulePathWithFs() {
-  _resolveModulePathWithFs = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2(modulePath) {
+  _resolveModulePathWithFs = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2(moduleUrl) {
     var options,
       includeTypeDefs,
       _args2 = arguments;
@@ -68,7 +74,7 @@ function _resolveModulePathWithFs() {
         case 0:
           options = _args2.length > 1 && _args2[1] !== undefined ? _args2[1] : {};
           includeTypeDefs = _args2.length > 2 ? _args2[2] : undefined;
-          return _context2.a(2, resolveModulePath(modulePath, nodeDirectoryReader, options, includeTypeDefs));
+          return _context2.a(2, resolveModulePath(moduleUrl, nodeDirectoryReader, options, includeTypeDefs));
       }
     }, _callee2);
   }));
@@ -89,14 +95,14 @@ export function resolveModulePathsWithFs(_x3) {
  * @returns Promise<Map<string, string>> - Map from import path to resolved file path
  */
 function _resolveModulePathsWithFs() {
-  _resolveModulePathsWithFs = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee3(modulePaths) {
+  _resolveModulePathsWithFs = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee3(moduleUrls) {
     var options,
       _args3 = arguments;
     return _regenerator().w(function (_context3) {
       while (1) switch (_context3.n) {
         case 0:
           options = _args3.length > 1 && _args3[1] !== undefined ? _args3[1] : {};
-          return _context3.a(2, resolveModulePaths(modulePaths, nodeDirectoryReader, options));
+          return _context3.a(2, resolveModulePaths(moduleUrls, nodeDirectoryReader, options));
       }
     }, _callee3);
   }));

package/esm/pipeline/loadServerPageIndex/loadServerPageIndex.js

@@ -8,6 +8,7 @@ var _excluded = ["titleMarkdown", "children"],
   _excluded2 = ["descriptionMarkdown", "sections"];
 import fs from 'node:fs/promises';
 import path from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { markdownToMetadata } from "../syncPageIndex/metadataToMarkdown.js";
 
 /**
@@ -128,8 +129,9 @@ export function createLoadServerPageIndex() {
       return _regenerator().w(function (_context) {
         while (1) switch (_context.n) {
           case 0:
-            // Resolve the absolute path to the markdown file
-            absolutePath = filePath.startsWith('file://') ? filePath.slice(7) : filePath; // Extract prefix and title from the import path
+            // 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');

package/esm/pipeline/loadServerSitemap/loadServerSitemap.js

@@ -4,6 +4,7 @@ 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';
 import { createLoadServerPageIndex } from "../loadServerPageIndex/loadServerPageIndex.js";
 import { parseCreateFactoryCall } from "../loadPrecomputedCodeHighlighter/parseCreateFactoryCall.js";
 
@@ -59,8 +60,9 @@ export function createLoadServerSitemap() {
       return _regenerator().w(function (_context2) {
         while (1) switch (_context2.n) {
           case 0:
-            // Remove file:// prefix if present to get file path
-            filePath = url.startsWith('file://') ? url.slice(7) : url; // Determine root context from file path if not provided
+            // 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

package/esm/pipeline/loadServerSource/loadServerSource.js

@@ -5,6 +5,8 @@ import _asyncToGenerator from "@babel/runtime/helpers/esm/asyncToGenerator";
 // webpack does not like node: imports
 // eslint-disable-next-line n/prefer-node-protocol
 import { readFile } from 'fs/promises';
+// eslint-disable-next-line n/prefer-node-protocol
+import { fileURLToPath } from 'url';
 import { parseImportsAndComments } from "../loaderUtils/index.js";
 import { resolveImportResultWithFs } from "../loadServerCodeMeta/resolveModulePathWithFs.js";
 import { processRelativeImports } from "../loaderUtils/processRelativeImports.js";
@@ -33,12 +35,13 @@ export function createLoadServerSource() {
     storeAt = _options$storeAt === void 0 ? 'flat' : _options$storeAt;
   return /*#__PURE__*/function () {
     var _loadSource = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(url) {
-      var filePath, source, isJavascriptModuleFile, isCssFile, _yield$parseImportsAn, importResult, externals, transformedExternals, _i, _Object$entries, _Object$entries$_i, modulePath, externalImport, processedSource, extraFiles, extraDependencies, importsCompatible, _i2, _Object$entries2, _Object$entries2$_i, importPath, _Object$entries2$_i$, path, names, positions, result, relativeImportsCompatible, _i3, _Object$entries3, _Object$entries3$_i, _importPath, _Object$entries3$_i$, _path, _names, includeTypeDefs, _positions, resolvedPathsMap, _result;
+      var filePath, source, isJavascriptModuleFile, isCssFile, _yield$parseImportsAn, importResult, externals, transformedExternals, _i, _Object$entries, _Object$entries$_i, modulePath, externalImport, processedSource, extraFiles, extraDependencies, importsCompatible, _i2, _Object$entries2, _Object$entries2$_i, importPath, _Object$entries2$_i$, importUrl, names, positions, result, relativeImportsCompatible, _i3, _Object$entries3, _Object$entries3$_i, _importPath, _Object$entries3$_i$, _importUrl, _names, includeTypeDefs, _positions, resolvedPathsMap, _result;
       return _regenerator().w(function (_context) {
         while (1) switch (_context.n) {
           case 0:
-            // Remove file:// prefix if present
-            filePath = url.replace('file://', ''); // Read the file
+            // 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; // Read the file
             _context.n = 1;
             return readFile(filePath, 'utf8');
           case 1:
@@ -63,7 +66,7 @@ export function createLoadServerSource() {
             });
           case 3:
             _context.n = 4;
-            return parseImportsAndComments(source, filePath);
+            return parseImportsAndComments(source, url);
           case 4:
             _yield$parseImportsAn = _context.v;
             importResult = _yield$parseImportsAn.relative;
@@ -92,9 +95,9 @@ export function createLoadServerSource() {
             // Convert import result to the format expected by processImports, preserving position data
             importsCompatible = {};
             for (_i2 = 0, _Object$entries2 = Object.entries(importResult); _i2 < _Object$entries2.length; _i2++) {
-              _Object$entries2$_i = _slicedToArray(_Object$entries2[_i2], 2), importPath = _Object$entries2$_i[0], _Object$entries2$_i$ = _Object$entries2$_i[1], path = _Object$entries2$_i$.path, names = _Object$entries2$_i$.names, positions = _Object$entries2$_i$.positions;
+              _Object$entries2$_i = _slicedToArray(_Object$entries2[_i2], 2), importPath = _Object$entries2$_i[0], _Object$entries2$_i$ = _Object$entries2$_i[1], importUrl = _Object$entries2$_i$.url, names = _Object$entries2$_i$.names, positions = _Object$entries2$_i$.positions;
               importsCompatible[importPath] = {
-                path: path,
+                url: importUrl,
                 names: names.map(function (_ref) {
                   var name = _ref.name,
                     alias = _ref.alias;
@@ -115,8 +118,8 @@ export function createLoadServerSource() {
 
             // Build dependencies list for recursive loading (CSS files use direct paths)
             extraDependencies = Object.values(importResult).map(function (_ref2) {
-              var path = _ref2.path;
-              return path;
+              var importUrl = _ref2.url;
+              return importUrl;
             });
             _context.n = 8;
             break;
@@ -124,9 +127,9 @@ export function createLoadServerSource() {
             // For JavaScript/TypeScript files, resolve paths first
             relativeImportsCompatible = {};
             for (_i3 = 0, _Object$entries3 = Object.entries(importResult); _i3 < _Object$entries3.length; _i3++) {
-              _Object$entries3$_i = _slicedToArray(_Object$entries3[_i3], 2), _importPath = _Object$entries3$_i[0], _Object$entries3$_i$ = _Object$entries3$_i[1], _path = _Object$entries3$_i$.path, _names = _Object$entries3$_i$.names, includeTypeDefs = _Object$entries3$_i$.includeTypeDefs, _positions = _Object$entries3$_i$.positions;
+              _Object$entries3$_i = _slicedToArray(_Object$entries3[_i3], 2), _importPath = _Object$entries3$_i[0], _Object$entries3$_i$ = _Object$entries3$_i[1], _importUrl = _Object$entries3$_i$.url, _names = _Object$entries3$_i$.names, includeTypeDefs = _Object$entries3$_i$.includeTypeDefs, _positions = _Object$entries3$_i$.positions;
               relativeImportsCompatible[_importPath] = _extends({
-                path: _path,
+                url: _importUrl,
                 names: _names.map(function (_ref3) {
                   var name = _ref3.name,
                     alias = _ref3.alias;
@@ -151,10 +154,10 @@ export function createLoadServerSource() {
 
             // Build dependencies list for recursive loading
             extraDependencies = Object.values(importResult).map(function (_ref4) {
-              var path = _ref4.path;
-              return resolvedPathsMap.get(path);
-            }).filter(function (path) {
-              return path !== undefined;
+              var importUrl = _ref4.url;
+              return resolvedPathsMap.get(importUrl);
+            }).filter(function (resolved) {
+              return resolved !== undefined;
             });
           case 8:
             return _context.a(2, {

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

@@ -1,12 +1,3 @@
-/**
- * Extracts and formats a name and slug from a URL path.
- * This utility takes the last meaningful segment of a URL path and formats it
- * into both a human-readable title and a URL-friendly slug.
- *
- * - Strips common file extensions (index.js, index.ts, index.tsx, etc.)
- * - Converts kebab-case to Title Case for names
- * - Ensures slugs are in kebab-case format
- */
 /**
  * Extracts and formats a name and slug from a URL path
  * @param url - The URL to extract from (can be file:// URL or regular path)

package/esm/pipeline/loaderUtils/extractNameAndSlugFromUrl.js

@@ -1,3 +1,5 @@
+import { fileUrlToPortablePath } from "./fileUrlToPortablePath.js";
+
 /**
  * Extracts and formats a name and slug from a URL path.
  * This utility takes the last meaningful segment of a URL path and formats it
@@ -82,17 +84,15 @@ function toKebabCase(str) {
  * @returns The last meaningful path segment
  */
 function extractLastSegment(url) {
-  // Handle file: URLs by removing the protocol
-  var path = url;
-  if (url.startsWith('file:')) {
-    path = url.replace(/^file:\/\//, '');
-  }
+  // Convert to portable path format for consistent handling across platforms
+  // This handles file:// URLs, Windows paths with backslashes, and regular paths
+  var path = fileUrlToPortablePath(url);
 
   // Strip query parameters and hash fragments before processing
-  path = path.split('?')[0].split('#')[0];
+  var cleanPath = path.split('?')[0].split('#')[0];
 
   // Split the path into segments and filter out empty ones
-  var segments = path.split('/').filter(Boolean);
+  var segments = cleanPath.split('/').filter(Boolean);
   if (segments.length === 0) {
     throw new Error('Could not extract meaningful segment from URL');
   }

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

@@ -0,0 +1,44 @@
+/**
+ * Converts a file:// URL to a portable path format that can be used with path-module (POSIX-only).
+ *
+ * This function is designed to work with isomorphic code that uses path-module,
+ * which only supports POSIX paths. The key insight is that by stripping the `file://`
+ * prefix and normalizing backslashes to forward slashes, we get a path that:
+ * - On Unix: `/home/user/file.ts` - works directly with path-module
+ * - On Windows: `/C:/Users/file.ts` - also works with path-module because it starts with `/`
+ *
+ * The resulting path is NOT a valid filesystem path on Windows, but it's a valid
+ * POSIX-style path for path manipulation. Use `fileURLToPath` from the `url` module
+ * when you need to access the actual filesystem.
+ *
+ * @param fileUrl - A file:// URL or absolute path (with forward slashes)
+ * @returns A portable path starting with `/` that works with path-module
+ *
+ * @example
+ * // Unix file URL
+ * fileUrlToPortablePath('file:///home/user/file.ts') // => '/home/user/file.ts'
+ *
+ * // Windows file URL
+ * fileUrlToPortablePath('file:///C:/Users/file.ts') // => '/C:/Users/file.ts'
+ *
+ * // Already a portable path (passthrough)
+ * fileUrlToPortablePath('/home/user/file.ts') // => '/home/user/file.ts'
+ */
+export declare function fileUrlToPortablePath(fileUrl: string): string;
+/**
+ * Converts a portable path back to a file:// URL.
+ *
+ * This is the inverse of `fileUrlToPortablePath`. It takes a portable path
+ * (which always starts with `/`) and converts it back to a proper file:// URL.
+ *
+ * @param portablePath - A portable path starting with `/`
+ * @returns A file:// URL
+ *
+ * @example
+ * // Unix path
+ * portablePathToFileUrl('/home/user/file.ts') // => 'file:///home/user/file.ts'
+ *
+ * // Windows path (portable format)
+ * portablePathToFileUrl('/C:/Users/file.ts') // => 'file:///C:/Users/file.ts'
+ */
+export declare function portablePathToFileUrl(portablePath: string): string;

package/esm/pipeline/loaderUtils/fileUrlToPortablePath.js

@@ -0,0 +1,80 @@
+/**
+ * Converts a file:// URL to a portable path format that can be used with path-module (POSIX-only).
+ *
+ * This function is designed to work with isomorphic code that uses path-module,
+ * which only supports POSIX paths. The key insight is that by stripping the `file://`
+ * prefix and normalizing backslashes to forward slashes, we get a path that:
+ * - On Unix: `/home/user/file.ts` - works directly with path-module
+ * - On Windows: `/C:/Users/file.ts` - also works with path-module because it starts with `/`
+ *
+ * The resulting path is NOT a valid filesystem path on Windows, but it's a valid
+ * POSIX-style path for path manipulation. Use `fileURLToPath` from the `url` module
+ * when you need to access the actual filesystem.
+ *
+ * @param fileUrl - A file:// URL or absolute path (with forward slashes)
+ * @returns A portable path starting with `/` that works with path-module
+ *
+ * @example
+ * // Unix file URL
+ * fileUrlToPortablePath('file:///home/user/file.ts') // => '/home/user/file.ts'
+ *
+ * // Windows file URL
+ * fileUrlToPortablePath('file:///C:/Users/file.ts') // => '/C:/Users/file.ts'
+ *
+ * // Already a portable path (passthrough)
+ * fileUrlToPortablePath('/home/user/file.ts') // => '/home/user/file.ts'
+ */
+export function fileUrlToPortablePath(fileUrl) {
+  // If it's not a file:// URL, check if it's already a portable path
+  if (!fileUrl.startsWith('file://')) {
+    // Normalize backslashes to forward slashes
+    var normalized = fileUrl.replace(/\\/g, '/');
+    // If it doesn't start with /, it's likely a Windows path - add leading slash
+    if (!normalized.startsWith('/') && /^[a-zA-Z]:\//.test(normalized)) {
+      return "/".concat(normalized);
+    }
+    return normalized;
+  }
+
+  // Strip the file:// prefix
+  // file:///home/user/file.ts => /home/user/file.ts (Unix)
+  // file:///C:/Users/file.ts => /C:/Users/file.ts (Windows - keep the leading slash)
+  var path = fileUrl.slice(7); // Remove 'file://'
+
+  // Normalize any backslashes that might have snuck in
+  path = path.replace(/\\/g, '/');
+
+  // If it doesn't start with /, add one (should already have one for valid file:// URLs)
+  if (!path.startsWith('/')) {
+    path = "/".concat(path);
+  }
+  return path;
+}
+
+/**
+ * Converts a portable path back to a file:// URL.
+ *
+ * This is the inverse of `fileUrlToPortablePath`. It takes a portable path
+ * (which always starts with `/`) and converts it back to a proper file:// URL.
+ *
+ * @param portablePath - A portable path starting with `/`
+ * @returns A file:// URL
+ *
+ * @example
+ * // Unix path
+ * portablePathToFileUrl('/home/user/file.ts') // => 'file:///home/user/file.ts'
+ *
+ * // Windows path (portable format)
+ * portablePathToFileUrl('/C:/Users/file.ts') // => 'file:///C:/Users/file.ts'
+ */
+export function portablePathToFileUrl(portablePath) {
+  // If it's already a URL (file://, http://, https://), return as-is
+  if (portablePath.startsWith('file://') || portablePath.startsWith('http://') || portablePath.startsWith('https://')) {
+    return portablePath;
+  }
+
+  // For Windows portable paths like /C:/Users/..., we need file:// + path
+  // For Unix paths like /home/user/..., we need file:// + path
+  // Both cases: file:// + /path = file:///path
+  return "file://".concat(portablePath);
+}

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

@@ -4,4 +4,5 @@ export * from "./rewriteImports.js";
 export * from "./processRelativeImports.js";
 export * from "./getFileNameFromUrl.js";
 export * from "./extractNameAndSlugFromUrl.js";
-export * from "./externalsToPackages.js";
+export * from "./externalsToPackages.js";
+export * from "./fileUrlToPortablePath.js";