@jsenv/core 28.4.3 → 28.6.0

package/dist/js/autoreload.js

@@ -370,10 +370,4 @@ window.__server_events__.listenEvents({
   reload: reloadServerEvent => {
     reloader.addMessage(reloadServerEvent.data);
   }
-}); // const findHotMetaUrl = (originalFileRelativeUrl) => {
-//   return Object.keys(urlHotMetas).find((compileUrl) => {
-//     return (
-//       parseCompiledUrl(compileUrl).fileRelativeUrl === originalFileRelativeUrl
-//     )
-//   })
-// }
+});

package/dist/js/supervisor.js

@@ -230,7 +230,15 @@ window.__supervisor__ = (() => {
       line,
       column
     }) => {
-      return typeof line === "number" && typeof column === "number" ? `${url}:${line}:${column}` : typeof line === "number" ? `${url}:${line}` : url;
+      if (typeof line === "number" && typeof column === "number") {
+        return `${url}:${line}:${column}`;
+      }
+
+      if (typeof line === "number") {
+        return `${url}:${line}`;
+      }
+
+      return url;
     };
 
     const resolveUrlSite = ({
@@ -1046,11 +1054,7 @@ window.__supervisor__ = (() => {
           return false;
         }
 
-        if (supervisedScriptCandidate.src !== src) {
-          return false;
-        }
-
-        return true;
+        return supervisedScriptCandidate.src === src;
       });
 
       if (supervisedScript) {

package/dist/main.js

@@ -3693,7 +3693,7 @@ const formatters = {
   },
   "css_@import": {
     encode: JSON.stringify,
-    code: JSON.stringify
+    decode: JSON.stringify
   },
   // https://github.com/webpack-contrib/css-loader/pull/627/files
   "css_url": {
@@ -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: {
@@ -10301,15 +10301,24 @@ const jsenvPluginAsJsClassicHtml = ({
           }
 
           if (needsSystemJs) {
-            mutations.push(() => {
-              const [systemJsReference] = context.referenceUtils.inject({
+            mutations.push(async () => {
+              const systemJsFileContent = readFileSync$1(new URL(systemJsClientFileUrl), {
+                encoding: "utf8"
+              });
+              const [systemJsReference, systemJsUrlInfo] = context.referenceUtils.inject({
                 type: "script_src",
                 expectedType: "js_classic",
-                specifier: systemJsClientFileUrl
+                isInline: true,
+                contentType: "text/javascript",
+                content: systemJsFileContent,
+                specifier: "s.js"
+              });
+              await context.cook(systemJsUrlInfo, {
+                reference: systemJsReference
               });
               injectScriptNodeAsEarlyAsPossible(htmlAst, createHtmlNode({
                 tagName: "script",
-                src: systemJsReference.generatedSpecifier
+                textContent: systemJsUrlInfo.content
               }), "jsenv:as_js_classic_html");
             });
           }
@@ -10319,7 +10328,7 @@ const jsenvPluginAsJsClassicHtml = ({
           return null;
         }
 
-        mutations.forEach(mutation => mutation());
+        await Promise.all(mutations.map(mutation => mutation()));
         return stringifyHtmlAst(htmlAst);
       }
     }
@@ -12013,7 +12022,9 @@ const jsenvPluginImportmap = () => {
   };
 };
 
-const jsenvPluginUrlResolution = () => {
+const jsenvPluginUrlResolution = ({
+  clientMainFileUrl
+}) => {
   const urlResolver = reference => {
     return new URL(reference.specifier, reference.baseUrl || reference.parentUrl).href;
   };
@@ -12022,8 +12033,13 @@ const jsenvPluginUrlResolution = () => {
     name: "jsenv:url_resolution",
     appliesDuring: "*",
     resolveUrl: {
-      "http_request": urlResolver,
-      // during dev
+      "http_request": reference => {
+        if (reference.specifier === "/") {
+          return String(clientMainFileUrl);
+        }
+
+        return urlResolver(reference);
+      },
       "entry_point": urlResolver,
       // during build
       "link_href": urlResolver,
@@ -13140,7 +13156,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") {
@@ -16552,16 +16578,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
@@ -16985,8 +17005,6 @@ const jsenvPluginAutoreloadServer = ({
                 return dependentPropagationResult;
               } // declined by absence of boundary, we can keep searching
 
-
-              continue;
             }
 
             if (instructions.length === 0) {
@@ -17152,62 +17170,64 @@ 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
+    }
+  }
 }) => {
-  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 !== explorerHtmlFileUrl) {
+          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
-      };
+        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
+        }));
+        let html = urlInfo.content;
+        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: context.rootDirectoryUrl,
+          groups,
+          files
+        }, null, "  "));
+        Object.assign(urlInfo.headers, {
+          "cache-control": "no-store"
+        });
+        return html;
+      }
     }
   };
 };
@@ -17223,11 +17243,16 @@ const getCorePlugins = ({
   transpilation = true,
   minification = false,
   bundling = false,
+  clientMainFileUrl,
   clientAutoreload = false,
   clientFileChangeCallbackList,
   clientFilesPruneCallbackList,
   explorer
 } = {}) => {
+  if (explorer === true) {
+    explorer = {};
+  }
+
   if (supervisor === true) {
     supervisor = {};
   }
@@ -17244,6 +17269,7 @@ const getCorePlugins = ({
     clientAutoreload = {};
   }
 
+  clientMainFileUrl = clientMainFileUrl || explorer ? explorerHtmlFileUrl : new URL("./index.html", rootDirectoryUrl);
   return [jsenvPluginUrlAnalysis({
     rootDirectoryUrl,
     ...urlAnalysis
@@ -17255,7 +17281,9 @@ const getCorePlugins = ({
     directoryReferenceAllowed,
     ...fileSystemMagicResolution
   }), jsenvPluginHttpUrls(), jsenvPluginLeadingSlash(), // before url resolution to handle "js_import_export" resolution
-  jsenvPluginNodeEsmResolution(nodeEsmResolution), jsenvPluginUrlResolution(), jsenvPluginUrlVersion(), jsenvPluginCommonJsGlobals(), jsenvPluginImportMetaScenarios(), jsenvPluginNodeRuntime({
+  jsenvPluginNodeEsmResolution(nodeEsmResolution), jsenvPluginUrlResolution({
+    clientMainFileUrl
+  }), jsenvPluginUrlVersion(), jsenvPluginCommonJsGlobals(), jsenvPluginImportMetaScenarios(), jsenvPluginNodeRuntime({
     runtimeCompat
   }), jsenvPluginBundling(bundling), jsenvPluginMinification(minification), jsenvPluginImportMetaHot(), ...(clientAutoreload ? [jsenvPluginAutoreload({ ...clientAutoreload,
     clientFileChangeCallbackList,
@@ -20216,13 +20244,8 @@ ${ANSI.color(buildUrl, ANSI.MAGENTA)}
           // - happens for "as_js_classic" injecting "s.js"
 
           if (reference.injected) {
-            const [ref, rawUrlInfo] = rawGraphKitchen.injectReference({
-              type: reference.type,
-              expectedType: reference.expectedType,
-              expectedSubtype: reference.expectedSubtype,
-              parentUrl: buildToRawUrls[reference.parentUrl],
-              specifier: reference.specifier,
-              injected: true
+            const [ref, rawUrlInfo] = rawGraphKitchen.injectReference({ ...reference,
+              parentUrl: buildToRawUrls[reference.parentUrl]
             });
             await rawGraphKitchen.cook(rawUrlInfo, {
               reference: ref
@@ -23275,7 +23298,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 {
@@ -24016,6 +24040,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;
       });
@@ -25252,6 +25280,7 @@ const createFileService = ({
   transpilation,
   clientAutoreload,
   clientFiles,
+  clientMainFileUrl,
   cooldownBetweenFileEvents,
   explorer,
   sourcemaps,
@@ -25360,6 +25389,7 @@ const createFileService = ({
         nodeEsmResolution,
         fileSystemMagicResolution,
         transpilation,
+        clientMainFileUrl,
         clientAutoreload,
         clientFileChangeCallbackList,
         clientFilesPruneCallbackList,
@@ -25369,7 +25399,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 => {
@@ -25592,7 +25622,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,
@@ -25695,6 +25727,7 @@ const startOmegaServer = async ({
   transpilation,
   clientAutoreload,
   clientFiles,
+  clientMainFileUrl,
   cooldownBetweenFileEvents,
   explorer,
   sourcemaps,
@@ -25748,6 +25781,7 @@ const startOmegaServer = async ({
         transpilation,
         clientAutoreload,
         clientFiles,
+        clientMainFileUrl,
         cooldownBetweenFileEvents,
         explorer,
         sourcemaps,
@@ -25842,6 +25876,7 @@ const startDevServer = async ({
     "./jsenv.config.mjs": true
   },
   clientAutoreload = true,
+  clientMainFileUrl,
   devServerAutoreload = false,
   devServerMainFile = getCallerPosition().url,
   cooldownBetweenFileEvents,
@@ -25855,16 +25890,8 @@ const startDevServer = async ({
   nodeEsmResolution,
   fileSystemMagicResolution,
   transpilation,
-  explorer = {
-    groups: {
-      src: {
-        "./src/**/*.html": true
-      },
-      tests: {
-        "./tests/**/*.test.html": true
-      }
-    }
-  },
+  explorer = true,
+  // see jsenv_plugin_explorer.js
   // toolbar = false,
   sourcemaps = "inline",
   sourcemapsSourcesProtocol,
@@ -25944,10 +25971,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: () => {
@@ -25984,6 +26008,7 @@ const startDevServer = async ({
     fileSystemMagicResolution,
     transpilation,
     clientFiles,
+    clientMainFileUrl,
     clientAutoreload,
     cooldownBetweenFileEvents,
     explorer,
@@ -28289,7 +28314,6 @@ const createRuntimeFromPlaywright = ({
           });
         }
       });
-      return;
     };
 
     try {
@@ -28416,11 +28440,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 => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jsenv/core",
-  "version": "28.4.3",
+  "version": "28.6.0",
   "description": "Tool to develop, test and build js projects",
   "license": "MIT",
   "author": {

package/src/build/build.js

@@ -528,12 +528,8 @@ ${ANSI.color(buildUrl, ANSI.MAGENTA)}
             // - happens for "as_js_classic" injecting "s.js"
             if (reference.injected) {
               const [ref, rawUrlInfo] = rawGraphKitchen.injectReference({
-                type: reference.type,
-                expectedType: reference.expectedType,
-                expectedSubtype: reference.expectedSubtype,
+                ...reference,
                 parentUrl: buildToRawUrls[reference.parentUrl],
-                specifier: reference.specifier,
-                injected: true,
               })
               await rawGraphKitchen.cook(rawUrlInfo, { reference: ref })
               return rawUrlInfo

package/src/dev/start_dev_server.js

@@ -39,6 +39,7 @@ export const startDevServer = async ({
     "./jsenv.config.mjs": true,
   },
   clientAutoreload = true,
+  clientMainFileUrl,
   devServerAutoreload = false,
   devServerMainFile = getCallerPosition().url,
   cooldownBetweenFileEvents,
@@ -53,16 +54,7 @@ export const startDevServer = async ({
   nodeEsmResolution,
   fileSystemMagicResolution,
   transpilation,
-  explorer = {
-    groups: {
-      src: {
-        "./src/**/*.html": true,
-      },
-      tests: {
-        "./tests/**/*.test.html": true,
-      },
-    },
-  },
+  explorer = true, // see jsenv_plugin_explorer.js
   // toolbar = false,
 
   sourcemaps = "inline",
@@ -128,9 +120,6 @@ export const startDevServer = async ({
         worker.once("message", resolve)
       })
       const origin = await messagePromise
-      // if (!keepProcessAlive) {
-      //   worker.unref()
-      // }
       return {
         origin,
         stop: () => {
@@ -168,6 +157,7 @@ export const startDevServer = async ({
     fileSystemMagicResolution,
     transpilation,
     clientFiles,
+    clientMainFileUrl,
     clientAutoreload,
     cooldownBetweenFileEvents,
     explorer,

package/src/execute/runtimes/browsers/from_playwright.js

@@ -355,7 +355,6 @@ export const createRuntimeFromPlaywright = ({
           })
         }
       })
-      return
     }
 
     try {
@@ -479,10 +478,7 @@ const isTargetClosedError = (error) => {
   if (error.message.match(/Protocol error \(.*?\): Browser.*?closed/)) {
     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) => {

package/src/omega/omega_server.js

@@ -36,6 +36,7 @@ export const startOmegaServer = async ({
   transpilation,
   clientAutoreload,
   clientFiles,
+  clientMainFileUrl,
   cooldownBetweenFileEvents,
   explorer,
   sourcemaps,
@@ -98,6 +99,7 @@ export const startOmegaServer = async ({
           transpilation,
           clientAutoreload,
           clientFiles,
+          clientMainFileUrl,
           cooldownBetweenFileEvents,
           explorer,
           sourcemaps,

package/src/omega/server/file_service.js

@@ -32,6 +32,7 @@ export const createFileService = ({
   transpilation,
   clientAutoreload,
   clientFiles,
+  clientMainFileUrl,
   cooldownBetweenFileEvents,
   explorer,
   sourcemaps,
@@ -132,6 +133,7 @@ export const createFileService = ({
           fileSystemMagicResolution,
           transpilation,
 
+          clientMainFileUrl,
           clientAutoreload,
           clientFileChangeCallbackList,
           clientFilesPruneCallbackList,
@@ -144,9 +146,7 @@ export const createFileService = ({
       writeGeneratedFiles,
       outDirectoryUrl: scenarios.dev
         ? `${rootDirectoryUrl}.jsenv/${runtimeName}@${runtimeVersion}/`
-        : `${rootDirectoryUrl}.jsenv/${
-            scenarios.test ? "test" : "build"
-          }/${runtimeName}@${runtimeVersion}/`,
+        : `${rootDirectoryUrl}.jsenv/build/${runtimeName}@${runtimeVersion}/`,
     })
     urlGraph.createUrlInfoCallbackRef.current = (urlInfo) => {
       const { watch } = URL_META.applyAssociations({
@@ -352,7 +352,9 @@ export const createFileService = ({
         return {
           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,

package/src/omega/url_specifier_encoding.js

@@ -31,7 +31,7 @@ export const urlSpecifierEncoding = {
 const formatters = {
   "js_import_export": { encode: JSON.stringify, decode: JSON.parse },
   "js_url_specifier": { encode: JSON.stringify, decode: JSON.parse },
-  "css_@import": { encode: JSON.stringify, code: JSON.stringify },
+  "css_@import": { encode: JSON.stringify, decode: JSON.stringify },
   // https://github.com/webpack-contrib/css-loader/pull/627/files
   "css_url": {
     encode: (url) => {

package/src/plugins/autoreload/client/autoreload.js

@@ -197,11 +197,3 @@ window.__server_events__.listenEvents({
     reloader.addMessage(reloadServerEvent.data)
   },
 })
-
-// const findHotMetaUrl = (originalFileRelativeUrl) => {
-//   return Object.keys(urlHotMetas).find((compileUrl) => {
-//     return (
-//       parseCompiledUrl(compileUrl).fileRelativeUrl === originalFileRelativeUrl
-//     )
-//   })
-// }

package/src/plugins/autoreload/jsenv_plugin_autoreload_server.js

@@ -99,7 +99,6 @@ export const jsenvPluginAutoreloadServer = ({
                 return dependentPropagationResult
               }
               // declined by absence of boundary, we can keep searching
-              continue
             }
             if (instructions.length === 0) {
               return {

package/src/plugins/explorer/jsenv_plugin_explorer.js

@@ -3,65 +3,77 @@ import { DATA_URL } from "@jsenv/urls"
 import { collectFiles } from "@jsenv/filesystem"
 import { CONTENT_TYPE } from "@jsenv/utils/src/content_type/content_type.js"
 
-export const jsenvPluginExplorer = ({ groups }) => {
-  const htmlClientFileUrl = new URL("./client/explorer.html", import.meta.url)
+export const explorerHtmlFileUrl = new URL(
+  "./client/explorer.html",
+  import.meta.url,
+)
+
+export const jsenvPluginExplorer = ({
+  groups = {
+    src: {
+      "./src/**/*.html": true,
+    },
+    tests: {
+      "./tests/**/*.test.html": true,
+    },
+  },
+}) => {
   const faviconClientFileUrl = new URL("./client/jsenv.png", import.meta.url)
 
   return {
     name: "jsenv:explorer",
     appliesDuring: "dev",
-    serve: async (request, { rootDirectoryUrl }) => {
-      if (request.pathname !== "/") {
-        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,
+    transformUrlContent: {
+      html: async (urlInfo, context) => {
+        if (urlInfo.url !== explorerHtmlFileUrl) {
+          return null
         }
-      })
-      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(new URL(htmlClientFileUrl)))
-      html = html.replace(
-        "ignore:FAVICON_HREF",
-        DATA_URL.stringify({
-          contentType: CONTENT_TYPE.fromUrlExtension(faviconClientFileUrl),
-          base64Flag: true,
-          data: readFileSync(new URL(faviconClientFileUrl)).toString("base64"),
-        }),
-      )
-      html = html.replace(
-        "SERVER_PARAMS",
-        JSON.stringify(
-          {
-            rootDirectoryUrl,
-            groups,
-            files,
-          },
-          null,
-          "  ",
-        ),
-      )
-      return {
-        status: 200,
-        headers: {
+        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,
+        }))
+        let html = urlInfo.content
+        html = html.replace(
+          "ignore:FAVICON_HREF",
+          DATA_URL.stringify({
+            contentType: CONTENT_TYPE.fromUrlExtension(faviconClientFileUrl),
+            base64Flag: true,
+            data: readFileSync(new URL(faviconClientFileUrl)).toString(
+              "base64",
+            ),
+          }),
+        )
+        html = html.replace(
+          "SERVER_PARAMS",
+          JSON.stringify(
+            {
+              rootDirectoryUrl: context.rootDirectoryUrl,
+              groups,
+              files,
+            },
+            null,
+            "  ",
+          ),
+        )
+        Object.assign(urlInfo.headers, {
           "cache-control": "no-store",
-          "content-type": "text/html",
-          "content-length": Buffer.byteLength(html),
-        },
-        body: html,
-      }
+        })
+        return html
+      },
     },
   }
 }

package/src/plugins/import_meta_hot/html_hot_dependencies.js

@@ -125,14 +125,9 @@ const htmlNodeCanHotReload = (node) => {
       return true
     }
     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

package/src/plugins/plugins.js

@@ -20,7 +20,10 @@ import { jsenvPluginImportMetaHot } from "./import_meta_hot/jsenv_plugin_import_
 import { jsenvPluginAutoreload } from "./autoreload/jsenv_plugin_autoreload.js"
 import { jsenvPluginCacheControl } from "./cache_control/jsenv_plugin_cache_control.js"
 // dev only
-import { jsenvPluginExplorer } from "./explorer/jsenv_plugin_explorer.js"
+import {
+  explorerHtmlFileUrl,
+  jsenvPluginExplorer,
+} from "./explorer/jsenv_plugin_explorer.js"
 
 export const getCorePlugins = ({
   rootDirectoryUrl,
@@ -35,11 +38,15 @@ export const getCorePlugins = ({
   minification = false,
   bundling = false,
 
+  clientMainFileUrl,
   clientAutoreload = false,
   clientFileChangeCallbackList,
   clientFilesPruneCallbackList,
   explorer,
 } = {}) => {
+  if (explorer === true) {
+    explorer = {}
+  }
   if (supervisor === true) {
     supervisor = {}
   }
@@ -52,6 +59,10 @@ export const getCorePlugins = ({
   if (clientAutoreload === true) {
     clientAutoreload = {}
   }
+  clientMainFileUrl =
+    clientMainFileUrl || explorer
+      ? explorerHtmlFileUrl
+      : new URL("./index.html", rootDirectoryUrl)
 
   return [
     jsenvPluginUrlAnalysis({ rootDirectoryUrl, ...urlAnalysis }),
@@ -69,7 +80,7 @@ export const getCorePlugins = ({
     jsenvPluginLeadingSlash(),
     // before url resolution to handle "js_import_export" resolution
     jsenvPluginNodeEsmResolution(nodeEsmResolution),
-    jsenvPluginUrlResolution(),
+    jsenvPluginUrlResolution({ clientMainFileUrl }),
     jsenvPluginUrlVersion(),
     jsenvPluginCommonJsGlobals(),
     jsenvPluginImportMetaScenarios(),

package/src/plugins/supervisor/client/supervisor.js

@@ -191,11 +191,13 @@ window.__supervisor__ = (() => {
     }
 
     const stringifyUrlSite = ({ url, line, column }) => {
-      return typeof line === "number" && typeof column === "number"
-        ? `${url}:${line}:${column}`
-        : typeof line === "number"
-        ? `${url}:${line}`
-        : url
+      if (typeof line === "number" && typeof column === "number") {
+        return `${url}:${line}:${column}`
+      }
+      if (typeof line === "number") {
+        return `${url}:${line}`
+      }
+      return url
     }
 
     const resolveUrlSite = ({ url, line, column }) => {
@@ -913,10 +915,7 @@ window.__supervisor__ = (() => {
           if (type && supervisedScriptCandidate.type !== type) {
             return false
           }
-          if (supervisedScriptCandidate.src !== src) {
-            return false
-          }
-          return true
+          return supervisedScriptCandidate.src === src
         },
       )
       if (supervisedScript) {

package/src/plugins/toolbar/client/util/fetch_using_xhr.js

@@ -116,9 +116,6 @@ export const fetchUsingXHR = async (
     if (responseBodyType === "arrayBuffer") {
       return arrayBufferToText(responseBody)
     }
-    // if (responseBodyType === "text" || responseBodyType === 'searchParams') {
-    //   return body
-    // }
     return String(responseBody)
   }
 

package/src/plugins/transpilation/as_js_classic/jsenv_plugin_as_js_classic_html.js

@@ -5,6 +5,7 @@
  * - <link rel="modulepreload"> are converted to <link rel="preload">
  */
 
+import { readFileSync } from "node:fs"
 import {
   parseHtmlString,
   visitHtmlNodes,
@@ -160,17 +161,28 @@ export const jsenvPluginAsJsClassicHtml = ({
             }
           }
           if (needsSystemJs) {
-            mutations.push(() => {
-              const [systemJsReference] = context.referenceUtils.inject({
-                type: "script_src",
-                expectedType: "js_classic",
-                specifier: systemJsClientFileUrl,
+            mutations.push(async () => {
+              const systemJsFileContent = readFileSync(
+                new URL(systemJsClientFileUrl),
+                { encoding: "utf8" },
+              )
+              const [systemJsReference, systemJsUrlInfo] =
+                context.referenceUtils.inject({
+                  type: "script_src",
+                  expectedType: "js_classic",
+                  isInline: true,
+                  contentType: "text/javascript",
+                  content: systemJsFileContent,
+                  specifier: "s.js",
+                })
+              await context.cook(systemJsUrlInfo, {
+                reference: systemJsReference,
               })
               injectScriptNodeAsEarlyAsPossible(
                 htmlAst,
                 createHtmlNode({
                   tagName: "script",
-                  src: systemJsReference.generatedSpecifier,
+                  textContent: systemJsUrlInfo.content,
                 }),
                 "jsenv:as_js_classic_html",
               )
@@ -180,7 +192,7 @@ export const jsenvPluginAsJsClassicHtml = ({
         if (mutations.length === 0) {
           return null
         }
-        mutations.forEach((mutation) => mutation())
+        await Promise.all(mutations.map((mutation) => mutation()))
         return stringifyHtmlAst(htmlAst)
       },
     },

package/src/plugins/url_analysis/jsenv_plugin_url_analysis.js

@@ -11,7 +11,8 @@ export 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(
       { include },
@@ -56,7 +57,6 @@ export const jsenvPluginUrlAnalysis = ({
       )
       if (protocolIsSupported) {
         reference.shouldHandle = true
-        return
       }
     },
     transformUrlContent: {

package/src/plugins/url_resolution/jsenv_plugin_url_resolution.js

@@ -1,4 +1,4 @@
-export const jsenvPluginUrlResolution = () => {
+export const jsenvPluginUrlResolution = ({ clientMainFileUrl }) => {
   const urlResolver = (reference) => {
     return new URL(
       reference.specifier,
@@ -9,7 +9,12 @@ export const jsenvPluginUrlResolution = () => {
     name: "jsenv:url_resolution",
     appliesDuring: "*",
     resolveUrl: {
-      "http_request": urlResolver, // during dev
+      "http_request": (reference) => {
+        if (reference.specifier === "/") {
+          return String(clientMainFileUrl)
+        }
+        return urlResolver(reference)
+      },
       "entry_point": urlResolver, // during build
       "link_href": urlResolver,
       "script_src": urlResolver,