@jsenv/core 28.5.1 → 29.0.1

package/dist/main.js

@@ -4516,7 +4516,8 @@ const jsenvPluginUrlAnalysis = ({
   include,
   supportedProtocols = ["file:", "data:", "virtual:", "http:", "https:"]
 }) => {
-  let getIncludeInfo = () => undefined;
+  // eslint-disable-next-line no-unused-vars
+  let getIncludeInfo = url => undefined;
 
   if (include) {
     const associations = URL_META.resolveAssociations({
@@ -4570,7 +4571,6 @@ const jsenvPluginUrlAnalysis = ({
 
       if (protocolIsSupported) {
         reference.shouldHandle = true;
-        return;
       }
     },
     transformUrlContent: {
@@ -11119,20 +11119,6 @@ const jsenvPluginAsJsClassic = ({
   })] : [])];
 };
 
-const jsenvPluginLeadingSlash = () => {
-  return {
-    name: "jsenv:leading_slash",
-    appliesDuring: "*",
-    resolveUrl: (reference, context) => {
-      if (reference.specifier[0] !== "/") {
-        return null;
-      }
-
-      return new URL(reference.specifier.slice(1), context.rootDirectoryUrl).href;
-    }
-  };
-};
-
 // duplicated from @jsenv/log to avoid the dependency
 const createDetailedMessage = (message, details = {}) => {
   let string = `${message}`;
@@ -12022,41 +12008,6 @@ const jsenvPluginImportmap = () => {
   };
 };
 
-const jsenvPluginUrlResolution = () => {
-  const urlResolver = reference => {
-    return new URL(reference.specifier, reference.baseUrl || reference.parentUrl).href;
-  };
-
-  return {
-    name: "jsenv:url_resolution",
-    appliesDuring: "*",
-    resolveUrl: {
-      "http_request": urlResolver,
-      // during dev
-      "entry_point": urlResolver,
-      // during build
-      "link_href": urlResolver,
-      "script_src": urlResolver,
-      "a_href": urlResolver,
-      "iframe_src": urlResolver,
-      "img_src": urlResolver,
-      "img_srcset": urlResolver,
-      "source_src": urlResolver,
-      "source_srcset": urlResolver,
-      "image_href": urlResolver,
-      "use_href": urlResolver,
-      "css_@import": urlResolver,
-      "css_url": urlResolver,
-      "sourcemap_comment": urlResolver,
-      "js_import_export": urlResolver,
-      "js_url_specifier": urlResolver,
-      "js_inline_content": urlResolver,
-      "webmanifest_icon_src": urlResolver,
-      "package_json": urlResolver
-    }
-  };
-};
-
 const isSpecifierForNodeBuiltin = specifier => {
   return specifier.startsWith("node:") || NODE_BUILTIN_MODULE_SPECIFIERS.includes(specifier);
 };
@@ -13149,7 +13100,17 @@ const mainLegacyResolvers = {
     return null;
   },
   browser: (packageJson, packageUrl) => {
-    const browserMain = typeof packageJson.browser === "string" ? packageJson.browser : typeof packageJson.browser === "object" && packageJson.browser !== null ? packageJson.browser["."] : "";
+    const browserMain = (() => {
+      if (typeof packageJson.browser === "string") {
+        return packageJson.browser;
+      }
+
+      if (typeof packageJson.browser === "object" && packageJson.browser !== null) {
+        return packageJson.browser["."];
+      }
+
+      return "";
+    })();
 
     if (!browserMain) {
       if (typeof packageJson.module === "string") {
@@ -13337,136 +13298,208 @@ const getExtensionsToTry = (magicExtensions, importer) => {
  *   if that comes from node resolution or anything else (not even magic resolution)
  *   it should likely be an other plugin happening after the others
  */
-const jsenvPluginNodeEsmResolution = ({
+const createNodeEsmResolver = ({
+  runtimeCompat,
   packageConditions
 }) => {
-  const addRelationshipWithPackageJson = ({
-    context,
-    packageJsonUrl,
-    field,
-    hasVersioningEffect = false
-  }) => {
-    const referenceFound = context.referenceUtils.find(ref => ref.type === "package_json" && ref.subtype === field);
+  const nodeRuntimeEnabled = Object.keys(runtimeCompat).includes("node"); // https://nodejs.org/api/esm.html#resolver-algorithm-specification
 
-    if (referenceFound) {
-      return;
-    }
-
-    const [, packageJsonUrlInfo] = context.referenceUtils.inject({
-      type: "package_json",
-      subtype: field,
-      specifier: packageJsonUrl,
-      isImplicit: true,
-      hasVersioningEffect
+  packageConditions = packageConditions || [...readCustomConditionsFromProcessArgs(), nodeRuntimeEnabled ? "node" : "browser", "import"];
+  return (reference, context) => {
+    const {
+      parentUrl,
+      specifier
+    } = reference;
+    const {
+      url,
+      type,
+      packageUrl
+    } = applyNodeEsmResolution({
+      conditions: packageConditions,
+      parentUrl,
+      specifier
     });
 
-    if (packageJsonUrlInfo.type === undefined) {
-      const packageJsonContentAsBuffer = readFileSync$1(new URL(packageJsonUrl));
-      packageJsonUrlInfo.type = "json";
-      packageJsonUrlInfo.content = String(packageJsonContentAsBuffer);
-      packageJsonUrlInfo.originalContentEtag = packageJsonUrlInfo.contentEtag = bufferToEtag$1(packageJsonContentAsBuffer);
-    }
-  };
-
-  return {
-    name: "jsenv:node_esm_resolution",
-    appliesDuring: "*",
-    init: context => {
-      const nodeRuntimeEnabled = Object.keys(context.runtimeCompat).includes("node"); // https://nodejs.org/api/esm.html#resolver-algorithm-specification
+    if (context.scenarios.dev) {
+      const dependsOnPackageJson = type !== "relative_specifier" && type !== "absolute_specifier" && type !== "node_builtin_specifier";
 
-      packageConditions = packageConditions || [...readCustomConditionsFromProcessArgs(), nodeRuntimeEnabled ? "node" : "browser", "import"];
-    },
-    resolveUrl: {
-      js_import_export: (reference, context) => {
-        const {
-          parentUrl,
-          specifier
-        } = reference;
-        const {
-          url,
-          type,
-          packageUrl
-        } = applyNodeEsmResolution({
-          conditions: packageConditions,
-          parentUrl,
-          specifier
+      if (dependsOnPackageJson) {
+        // this reference depends on package.json and node_modules
+        // to be resolved. Each file using this specifier
+        // must be invalidated when corresponding package.json changes
+        addRelationshipWithPackageJson({
+          reference,
+          context,
+          packageJsonUrl: `${packageUrl}package.json`,
+          field: type.startsWith("field:") ? `#${type.slice("field:".length)}` : ""
         });
+      }
+    }
 
-        if (context.scenarios.dev) {
-          const dependsOnPackageJson = type !== "relative_specifier" && type !== "absolute_specifier" && type !== "node_builtin_specifier";
+    if (context.scenarios.dev) {
+      // without this check a file inside a project without package.json
+      // could be considered as a node module if there is a ancestor package.json
+      // but we want to version only node modules
+      if (url.includes("/node_modules/")) {
+        const packageDirectoryUrl = defaultLookupPackageScope(url);
+
+        if (packageDirectoryUrl && packageDirectoryUrl !== context.rootDirectoryUrl) {
+          const packageVersion = defaultReadPackageJson(packageDirectoryUrl).version; // package version can be null, see https://github.com/babel/babel/blob/2ce56e832c2dd7a7ed92c89028ba929f874c2f5c/packages/babel-runtime/helpers/esm/package.json#L2
 
-          if (dependsOnPackageJson) {
-            // this reference depends on package.json and node_modules
-            // to be resolved. Each file using this specifier
-            // must be invalidated when corresponding package.json changes
+          if (packageVersion) {
             addRelationshipWithPackageJson({
               reference,
               context,
-              packageJsonUrl: `${packageUrl}package.json`,
-              field: type.startsWith("field:") ? `#${type.slice("field:".length)}` : ""
+              packageJsonUrl: `${packageDirectoryUrl}package.json`,
+              field: "version",
+              hasVersioningEffect: true
             });
           }
-        }
 
-        return url;
-      }
-    },
-    transformUrlSearchParams: (reference, context) => {
-      if (reference.type === "package_json") {
-        return null;
+          reference.version = packageVersion;
+        }
       }
+    }
 
-      if (context.scenarios.build) {
-        return null;
-      }
+    return url;
+  };
+};
 
-      if (!reference.url.startsWith("file:")) {
-        return null;
-      } // without this check a file inside a project without package.json
-      // could be considered as a node module if there is a ancestor package.json
-      // but we want to version only node modules
+const addRelationshipWithPackageJson = ({
+  context,
+  packageJsonUrl,
+  field,
+  hasVersioningEffect = false
+}) => {
+  const referenceFound = context.referenceUtils.find(ref => ref.type === "package_json" && ref.subtype === field);
 
+  if (referenceFound) {
+    return;
+  }
 
-      if (!reference.url.includes("/node_modules/")) {
-        return null;
-      }
+  const [, packageJsonUrlInfo] = context.referenceUtils.inject({
+    type: "package_json",
+    subtype: field,
+    specifier: packageJsonUrl,
+    isImplicit: true,
+    hasVersioningEffect
+  });
 
-      if (reference.searchParams.has("v")) {
-        return null;
-      }
+  if (packageJsonUrlInfo.type === undefined) {
+    const packageJsonContentAsBuffer = readFileSync$1(new URL(packageJsonUrl));
+    packageJsonUrlInfo.type = "json";
+    packageJsonUrlInfo.content = String(packageJsonContentAsBuffer);
+    packageJsonUrlInfo.originalContentEtag = packageJsonUrlInfo.contentEtag = bufferToEtag$1(packageJsonContentAsBuffer);
+  }
+};
 
-      const packageDirectoryUrl = defaultLookupPackageScope(reference.url);
+/*
+ * This plugin is responsible to resolve urls except for a few cases:
+ * - A custom plugin implements a resolveUrl hook returning something
+ * - The reference.type is "filesystem" -> it is handled by jsenv_plugin_file_urls.js
+ *
+ * By default node esm resolution applies inside js modules
+ * and the rest uses the web standard url resolution (new URL):
+ * - "http_request"
+ * - "entry_point"
+ * - "js_import_export"
+ * - "link_href"
+ * - "script_src"
+ * - "a_href"
+ * - "iframe_src
+ * - "img_src"
+ * - "img_srcset"
+ * - "source_src"
+ * - "source_srcset"
+ * - "image_href"
+ * - "use_href"
+ * - "css_@import"
+ * - "css_url"
+ * - "sourcemap_comment"
+ * - "js_url_specifier"
+ * - "js_inline_content"
+ * - "webmanifest_icon_src"
+ * - "package_json"
+ */
+const jsenvPluginUrlResolution = ({
+  runtimeCompat,
+  clientMainFileUrl,
+  urlResolution
+}) => {
+  const resolveUrlUsingWebResolution = reference => {
+    return new URL(reference.specifier, reference.baseUrl || reference.parentUrl).href;
+  };
 
-      if (!packageDirectoryUrl) {
-        return null;
-      }
+  const resolvers = {};
+  Object.keys(urlResolution).forEach(referenceType => {
+    const resolver = urlResolution[referenceType];
 
-      if (packageDirectoryUrl === context.rootDirectoryUrl) {
-        return null;
-      } // there is a dependency between this file and the package.json version field
+    if (typeof resolver !== "object") {
+      throw new Error(`Unexpected urlResolution configuration:
+"${referenceType}" resolution value must be an object, got ${resolver}`);
+    }
 
+    let {
+      web,
+      node_esm,
+      ...rest
+    } = resolver;
+    const unexpectedKey = Object.keys(rest)[0];
 
-      const packageVersion = defaultReadPackageJson(packageDirectoryUrl).version;
+    if (unexpectedKey) {
+      throw new Error(`Unexpected urlResolution configuration:
+"${referenceType}" resolution key must be "web" or "node_esm", found "${Object.keys(rest)[0]}"`);
+    }
 
-      if (!packageVersion) {
-        // example where it happens: https://github.com/babel/babel/blob/2ce56e832c2dd7a7ed92c89028ba929f874c2f5c/packages/babel-runtime/helpers/esm/package.json#L2
-        return null;
+    if (node_esm === undefined) {
+      node_esm = referenceType === "js_import_export";
+    }
+
+    if (web === undefined) {
+      web = true;
+    }
+
+    if (node_esm) {
+      if (node_esm === true) node_esm = {};
+      const {
+        packageConditions
+      } = node_esm;
+      resolvers[referenceType] = createNodeEsmResolver({
+        runtimeCompat,
+        packageConditions
+      });
+    } else if (web) {
+      resolvers[referenceType] = resolveUrlUsingWebResolution;
+    }
+  });
+
+  if (!resolvers["js_import_export"]) {
+    resolvers.js_import_export = createNodeEsmResolver({
+      runtimeCompat
+    });
+  }
+
+  if (!resolvers["*"]) {
+    resolvers["*"] = resolveUrlUsingWebResolution;
+  }
+
+  return {
+    name: "jsenv:url_resolution",
+    appliesDuring: "*",
+    resolveUrl: (reference, context) => {
+      if (reference.specifier === "/") {
+        return String(clientMainFileUrl);
       }
 
-      if (reference.type === "js_import_export") {
-        addRelationshipWithPackageJson({
-          reference,
-          context,
-          packageJsonUrl: `${packageDirectoryUrl}package.json`,
-          field: "version",
-          hasVersioningEffect: true
-        });
+      if (reference.specifier[0] === "/") {
+        return new URL(reference.specifier.slice(1), context.rootDirectoryUrl).href;
       }
 
-      return {
-        v: packageVersion
-      };
+      const resolver = resolvers[reference.type] || resolvers["*"];
+      return resolver(reference, context);
     },
+    // when specifier is prefixed by "file:///@ignore/"
+    // we return an empty js module (used by node esm)
     fetchUrlContent: urlInfo => {
       if (urlInfo.url.startsWith("file:///@ignore/")) {
         return {
@@ -13492,12 +13525,19 @@ const jsenvPluginUrlVersion = () => {
       // this goal is achieved when we reach this part of the code
       // We get rid of this params so that urlGraph and other parts of the code
       // recognize the url (it is not considered as a different url)
-      const urlObject = new URL(reference.url);
-      urlObject.searchParams.delete("v");
-      return urlObject.href;
+      const version = reference.searchParams.get("v");
+
+      if (version) {
+        const urlObject = new URL(reference.url);
+        urlObject.searchParams.delete("v");
+        reference.version = version;
+        return urlObject.href;
+      }
+
+      return null;
     },
     transformUrlSearchParams: reference => {
-      if (!reference.data.version) {
+      if (!reference.version) {
         return null;
       }
 
@@ -13506,7 +13546,7 @@ const jsenvPluginUrlVersion = () => {
       }
 
       return {
-        v: reference.data.version
+        v: reference.version
       };
     }
   };
@@ -16561,16 +16601,10 @@ const htmlNodeCanHotReload = node => {
     }
 
     if (isResourceHint) {
-      // for resource hints html will be notified the underlying resource has changed
-      // but we won't do anything (if the resource is deleted we should?)
-      return true;
-    }
-
-    if (rel === "icon") {
-      return true;
+      return false;
     }
 
-    return false;
+    return rel === "icon";
   }
 
   return [// "script_src", // script src cannot hot reload
@@ -16994,8 +17028,6 @@ const jsenvPluginAutoreloadServer = ({
                 return dependentPropagationResult;
               } // declined by absence of boundary, we can keep searching
 
-
-              continue;
             }
 
             if (instructions.length === 0) {
@@ -17135,18 +17167,7 @@ const jsenvPluginCacheControl = () => {
     appliesDuring: "dev",
     augmentResponse: ({
       reference
-    }, context) => {
-      if (context.scenarios.test) {
-        // During dev, all files are put into browser cache for 1 hour because:
-        // 1: Browser cache is a temporary directory created by playwright
-        // 2: We assume source files won't be modified while tests are running
-        return {
-          headers: {
-            "cache-control": `private,max-age=3600,immutable`
-          }
-        };
-      }
-
+    }) => {
       if (reference.searchParams.has("v") && !reference.searchParams.has("hmr")) {
         return {
           headers: {
@@ -17161,62 +17182,72 @@ const jsenvPluginCacheControl = () => {
 };
 const SECONDS_IN_30_DAYS$1 = 60 * 60 * 24 * 30;
 
+const explorerHtmlFileUrl = new URL("./html/explorer.html", import.meta.url);
 const jsenvPluginExplorer = ({
-  groups
+  groups = {
+    src: {
+      "./src/**/*.html": true
+    },
+    tests: {
+      "./tests/**/*.test.html": true
+    }
+  },
+  clientMainFileUrl
 }) => {
-  const htmlClientFileUrl = new URL("./html/explorer.html", import.meta.url);
   const faviconClientFileUrl = new URL("./other/jsenv.png", import.meta.url);
   return {
     name: "jsenv:explorer",
     appliesDuring: "dev",
-    serve: async (request, {
-      rootDirectoryUrl
-    }) => {
-      if (request.pathname !== "/") {
-        return null;
-      }
+    transformUrlContent: {
+      html: async (urlInfo, context) => {
+        if (urlInfo.url !== clientMainFileUrl) {
+          return null;
+        }
 
-      const associationsForExplorable = {};
-      Object.keys(groups).forEach(groupName => {
-        const groupConfig = groups[groupName];
-        associationsForExplorable[groupName] = {
-          "**/.jsenv/": false,
-          // avoid visting .jsenv directory in jsenv itself
-          ...groupConfig
-        };
-      });
-      const matchingFileResultArray = await collectFiles({
-        directoryUrl: rootDirectoryUrl,
-        associations: associationsForExplorable,
-        predicate: meta => Object.keys(meta).some(group => Boolean(meta[group]))
-      });
-      const files = matchingFileResultArray.map(({
-        relativeUrl,
-        meta
-      }) => ({
-        relativeUrl,
-        meta
-      }));
-      let html = String(readFileSync$1(new URL(htmlClientFileUrl)));
-      html = html.replace("ignore:FAVICON_HREF", DATA_URL.stringify({
-        contentType: CONTENT_TYPE.fromUrlExtension(faviconClientFileUrl),
-        base64Flag: true,
-        data: readFileSync$1(new URL(faviconClientFileUrl)).toString("base64")
-      }));
-      html = html.replace("SERVER_PARAMS", JSON.stringify({
-        rootDirectoryUrl,
-        groups,
-        files
-      }, null, "  "));
-      return {
-        status: 200,
-        headers: {
-          "cache-control": "no-store",
-          "content-type": "text/html",
-          "content-length": Buffer.byteLength(html)
-        },
-        body: html
-      };
+        let html = urlInfo.content;
+
+        if (html.includes("ignore:FAVICON_HREF")) {
+          html = html.replace("ignore:FAVICON_HREF", DATA_URL.stringify({
+            contentType: CONTENT_TYPE.fromUrlExtension(faviconClientFileUrl),
+            base64Flag: true,
+            data: readFileSync$1(new URL(faviconClientFileUrl)).toString("base64")
+          }));
+        }
+
+        if (html.includes("SERVER_PARAMS")) {
+          const associationsForExplorable = {};
+          Object.keys(groups).forEach(groupName => {
+            const groupConfig = groups[groupName];
+            associationsForExplorable[groupName] = {
+              "**/.jsenv/": false,
+              // avoid visting .jsenv directory in jsenv itself
+              ...groupConfig
+            };
+          });
+          const matchingFileResultArray = await collectFiles({
+            directoryUrl: context.rootDirectoryUrl,
+            associations: associationsForExplorable,
+            predicate: meta => Object.keys(meta).some(group => Boolean(meta[group]))
+          });
+          const files = matchingFileResultArray.map(({
+            relativeUrl,
+            meta
+          }) => ({
+            relativeUrl,
+            meta
+          }));
+          html = html.replace("SERVER_PARAMS", JSON.stringify({
+            rootDirectoryUrl: context.rootDirectoryUrl,
+            groups,
+            files
+          }, null, "  "));
+          Object.assign(urlInfo.headers, {
+            "cache-control": "no-store"
+          });
+        }
+
+        return html;
+      }
     }
   };
 };
@@ -17225,34 +17256,41 @@ const getCorePlugins = ({
   rootDirectoryUrl,
   runtimeCompat,
   urlAnalysis = {},
-  supervisor,
-  nodeEsmResolution = true,
-  fileSystemMagicResolution,
+  urlResolution = {},
+  fileSystemMagicRedirection,
   directoryReferenceAllowed,
+  supervisor,
   transpilation = true,
   minification = false,
   bundling = false,
+  clientMainFileUrl,
   clientAutoreload = false,
   clientFileChangeCallbackList,
   clientFilesPruneCallbackList,
   explorer
 } = {}) => {
-  if (supervisor === true) {
-    supervisor = {};
+  if (explorer === true) {
+    explorer = {};
   }
 
-  if (nodeEsmResolution === true) {
-    nodeEsmResolution = {};
+  if (supervisor === true) {
+    supervisor = {};
   }
 
-  if (fileSystemMagicResolution === true) {
-    fileSystemMagicResolution = {};
+  if (fileSystemMagicRedirection === true) {
+    fileSystemMagicRedirection = {};
   }
 
   if (clientAutoreload === true) {
     clientAutoreload = {};
   }
 
+  if (clientMainFileUrl === undefined) {
+    clientMainFileUrl = explorer ? String(explorerHtmlFileUrl) : String(new URL("./index.html", rootDirectoryUrl));
+  } else {
+    clientMainFileUrl = String(clientMainFileUrl);
+  }
+
   return [jsenvPluginUrlAnalysis({
     rootDirectoryUrl,
     ...urlAnalysis
@@ -17262,14 +17300,19 @@ const getCorePlugins = ({
   jsenvPluginInline(), // before "file urls" to resolve and load inline urls
   jsenvPluginFileUrls({
     directoryReferenceAllowed,
-    ...fileSystemMagicResolution
-  }), jsenvPluginHttpUrls(), jsenvPluginLeadingSlash(), // before url resolution to handle "js_import_export" resolution
-  jsenvPluginNodeEsmResolution(nodeEsmResolution), jsenvPluginUrlResolution(), jsenvPluginUrlVersion(), jsenvPluginCommonJsGlobals(), jsenvPluginImportMetaScenarios(), jsenvPluginNodeRuntime({
+    ...fileSystemMagicRedirection
+  }), jsenvPluginHttpUrls(), jsenvPluginUrlResolution({
+    runtimeCompat,
+    urlResolution,
+    clientMainFileUrl
+  }), jsenvPluginUrlVersion(), jsenvPluginCommonJsGlobals(), jsenvPluginImportMetaScenarios(), jsenvPluginNodeRuntime({
     runtimeCompat
   }), jsenvPluginBundling(bundling), jsenvPluginMinification(minification), jsenvPluginImportMetaHot(), ...(clientAutoreload ? [jsenvPluginAutoreload({ ...clientAutoreload,
     clientFileChangeCallbackList,
     clientFilesPruneCallbackList
-  })] : []), jsenvPluginCacheControl(), ...(explorer ? [jsenvPluginExplorer(explorer)] : [])];
+  })] : []), jsenvPluginCacheControl(), ...(explorer ? [jsenvPluginExplorer({ ...explorer,
+    clientMainFileUrl
+  })] : [])];
 };
 
 const HOOK_NAMES$1 = ["init", "serve", // is called only during dev/tests
@@ -18384,6 +18427,7 @@ const createKitchen = ({
       isResourceHint,
       isImplicit,
       hasVersioningEffect,
+      version: null,
       injected,
       timing: {},
       // for inline resources the reference contains the content
@@ -19180,55 +19224,7 @@ const determineFileUrlForOutDirectory = ({
     to: context.outDirectoryUrl,
     preferAbsolute: true
   });
-}; // import { getOriginalPosition } from "@jsenv/core/src/utils/sourcemap/original_position.js"
-// const getUrlSite = async (
-//   urlInfo,
-//   { line, column, originalLine, originalColumn },
-// ) => {
-//   if (typeof originalLine === "number") {
-//     return {
-//       url: urlInfo.url,
-//       line: originalLine,
-//       column: originalColumn,
-//     }
-//   }
-//   if (urlInfo.content === urlInfo.originalContent) {
-//     return {
-//       url: urlInfo.url,
-//       line,
-//       column,
-//     }
-//   }
-//   // at this point things were transformed: line and column are generated
-//   // no sourcemap -> cannot map back to original file
-//   const { sourcemap } = urlInfo
-//   if (!sourcemap) {
-//     return {
-//       url: urlInfo.generatedUrl,
-//       content: urlInfo.content,
-//       line,
-//       column,
-//     }
-//   }
-//   const originalPosition = await getOriginalPosition({
-//     sourcemap,
-//     line,
-//     column,
-//   })
-//   // cannot map back to original file
-//   if (!originalPosition || originalPosition.line === null) {
-//     return {
-//       url: urlInfo.generatedUrl,
-//       line,
-//       column,
-//     }
-//   }
-//   return {
-//     url: urlInfo.url,
-//     line: originalPosition.line,
-//     column: originalPosition.column,
-//   }
-// }
+};
 
 const createUrlGraphSummary = (urlGraph, {
   title = "graph summary"
@@ -19828,8 +19824,8 @@ const build = async ({
   sourcemaps = false,
   sourcemapsSourcesContent,
   urlAnalysis = {},
-  nodeEsmResolution = true,
-  fileSystemMagicResolution,
+  urlResolution,
+  fileSystemMagicRedirection,
   directoryReferenceAllowed,
   transpilation = {},
   bundling = true,
@@ -19925,8 +19921,8 @@ build ${entryPointKeys.length} entry points`);
         urlGraph: rawGraph,
         runtimeCompat,
         urlAnalysis,
-        nodeEsmResolution,
-        fileSystemMagicResolution,
+        urlResolution,
+        fileSystemMagicRedirection,
         directoryReferenceAllowed,
         transpilation: { ...transpilation,
           babelHelpersAsImport: !useExplicitJsClassicConversion,
@@ -20032,11 +20028,7 @@ ${ANSI.color(buildUrl, ANSI.MAGENTA)}
                 return true;
               }
 
-              if (rawUrlInfo.originalContent === reference.content) {
-                return true;
-              }
-
-              return false;
+              return rawUrlInfo.originalContent === reference.content;
             });
             const parentUrlInfo = finalGraph.getUrlInfo(reference.parentUrl);
 
@@ -20338,7 +20330,6 @@ ${ANSI.color(buildUrl, ANSI.MAGENTA)}
 
           if (bundler) {
             bundler.urlInfos.push(rawUrlInfo);
-            return;
           }
         };
 
@@ -21213,11 +21204,7 @@ const isUsed = urlInfo => {
     return true;
   }
 
-  if (urlInfo.dependents.size > 0) {
-    return true;
-  }
-
-  return false;
+  return urlInfo.dependents.size > 0;
 };
 
 const canUseVersionedUrl = urlInfo => {
@@ -21225,11 +21212,7 @@ const canUseVersionedUrl = urlInfo => {
     return false;
   }
 
-  if (urlInfo.type === "webmanifest") {
-    return false;
-  }
-
-  return true;
+  return urlInfo.type !== "webmanifest";
 };
 
 const createReloadableWorker = (workerFileUrl, options = {}) => {
@@ -22568,7 +22551,18 @@ const writeHead = (responseStream, {
     return;
   }
 
-  responseStream.writeHead(status, statusText, nodeHeaders);
+  try {
+    responseStream.writeHead(status, statusText, nodeHeaders);
+  } catch (e) {
+    if (e.code === "ERR_INVALID_CHAR" && e.message.includes("Invalid character in statusMessage")) {
+      throw new Error(`Invalid character in statusMessage
+--- status message ---
+${statusText}`);
+    }
+
+    throw e;
+  }
+
   onHeadersSent({
     nodeHeaders,
     status,
@@ -23279,7 +23273,8 @@ const startServer = async ({
           preferIpv6
         });
         serverOrigins.externalip = createOrigin(firstExternalIp);
-      } else if (hostnameInfo.label === "loopback") {} else {
+      } else if (hostnameInfo.label === "loopback") {// nothing
+      } else {
         serverOrigins.local = createOrigin(hostname);
       }
     } else {
@@ -24020,6 +24015,10 @@ const startServer = async ({
       const removeUpgradeCallback = listenEvent(facadeServer, "upgrade", upgradeCallback);
       stopCallbackList.add(removeUpgradeCallback);
       stopCallbackList.add(() => {
+        websocketClients.forEach(websocketClient => {
+          websocketClient.close();
+        });
+        websocketClients.clear();
         websocketServer.close();
         websocketServer = null;
       });
@@ -25250,12 +25249,13 @@ const createFileService = ({
   runtimeCompat,
   plugins,
   urlAnalysis,
+  urlResolution,
+  fileSystemMagicRedirection,
   supervisor,
-  nodeEsmResolution,
-  fileSystemMagicResolution,
   transpilation,
   clientAutoreload,
   clientFiles,
+  clientMainFileUrl,
   cooldownBetweenFileEvents,
   explorer,
   sourcemaps,
@@ -25360,10 +25360,11 @@ const createFileService = ({
         rootDirectoryUrl,
         runtimeCompat,
         urlAnalysis,
+        urlResolution,
+        fileSystemMagicRedirection,
         supervisor,
-        nodeEsmResolution,
-        fileSystemMagicResolution,
         transpilation,
+        clientMainFileUrl,
         clientAutoreload,
         clientFileChangeCallbackList,
         clientFilesPruneCallbackList,
@@ -25373,7 +25374,7 @@ const createFileService = ({
       sourcemapsSourcesProtocol,
       sourcemapsSourcesContent,
       writeGeneratedFiles,
-      outDirectoryUrl: scenarios.dev ? `${rootDirectoryUrl}.jsenv/${runtimeName}@${runtimeVersion}/` : `${rootDirectoryUrl}.jsenv/${scenarios.test ? "test" : "build"}/${runtimeName}@${runtimeVersion}/`
+      outDirectoryUrl: scenarios.dev ? `${rootDirectoryUrl}.jsenv/${runtimeName}@${runtimeVersion}/` : `${rootDirectoryUrl}.jsenv/build/${runtimeName}@${runtimeVersion}/`
     });
 
     urlGraph.createUrlInfoCallbackRef.current = urlInfo => {
@@ -25596,7 +25597,9 @@ const createFileService = ({
           url: reference.url,
           status: 200,
           // let the browser re-throw the syntax error
-          statusText: originalError.reason,
+          // reason becomes the http response statusText, it must not contain invalid chars
+          // https://github.com/nodejs/node/blob/0c27ca4bc9782d658afeaebcec85ec7b28f1cc35/lib/_http_common.js#L221
+          statusText: e.reason,
           statusMessage: originalError.message,
           headers: {
             "content-type": urlInfo.contentType,
@@ -25693,12 +25696,13 @@ const startOmegaServer = async ({
   runtimeCompat,
   plugins,
   urlAnalysis,
+  urlResolution,
+  fileSystemMagicRedirection,
   supervisor,
-  nodeEsmResolution,
-  fileSystemMagicResolution,
   transpilation,
   clientAutoreload,
   clientFiles,
+  clientMainFileUrl,
   cooldownBetweenFileEvents,
   explorer,
   sourcemaps,
@@ -25746,12 +25750,13 @@ const startOmegaServer = async ({
         runtimeCompat,
         plugins,
         urlAnalysis,
+        urlResolution,
+        fileSystemMagicRedirection,
         supervisor,
-        nodeEsmResolution,
-        fileSystemMagicResolution,
         transpilation,
         clientAutoreload,
         clientFiles,
+        clientMainFileUrl,
         cooldownBetweenFileEvents,
         explorer,
         sourcemaps,
@@ -25846,6 +25851,7 @@ const startDevServer = async ({
     "./jsenv.config.mjs": true
   },
   clientAutoreload = true,
+  clientMainFileUrl,
   devServerAutoreload = false,
   devServerMainFile = getCallerPosition().url,
   cooldownBetweenFileEvents,
@@ -25855,20 +25861,12 @@ const startDevServer = async ({
   runtimeCompat = defaultRuntimeCompat,
   plugins = [],
   urlAnalysis = {},
+  urlResolution,
   supervisor = true,
-  nodeEsmResolution,
-  fileSystemMagicResolution,
+  fileSystemMagicRedirection,
   transpilation,
-  explorer = {
-    groups: {
-      src: {
-        "./src/**/*.html": true
-      },
-      tests: {
-        "./tests/**/*.test.html": true
-      }
-    }
-  },
+  explorer = true,
+  // see jsenv_plugin_explorer.js
   // toolbar = false,
   sourcemaps = "inline",
   sourcemapsSourcesProtocol,
@@ -25948,10 +25946,7 @@ const startDevServer = async ({
       const messagePromise = new Promise(resolve => {
         worker.once("message", resolve);
       });
-      const origin = await messagePromise; // if (!keepProcessAlive) {
-      //   worker.unref()
-      // }
-
+      const origin = await messagePromise;
       return {
         origin,
         stop: () => {
@@ -25983,11 +25978,12 @@ const startDevServer = async ({
     runtimeCompat,
     plugins,
     urlAnalysis,
+    urlResolution,
+    fileSystemMagicRedirection,
     supervisor,
-    nodeEsmResolution,
-    fileSystemMagicResolution,
     transpilation,
     clientFiles,
+    clientMainFileUrl,
     clientAutoreload,
     cooldownBetweenFileEvents,
     explorer,
@@ -28293,7 +28289,6 @@ const createRuntimeFromPlaywright = ({
           });
         }
       });
-      return;
     };
 
     try {
@@ -28420,11 +28415,7 @@ const isTargetClosedError = error => {
     return true;
   }
 
-  if (error.message.includes("browserContext.close: Browser closed")) {
-    return true;
-  }
-
-  return false;
+  return error.message.includes("browserContext.close: Browser closed");
 };
 
 const extractTextFromConsoleMessage = consoleMessage => {