@jsenv/core 39.9.4 → 39.9.6

package/dist/js/autoreload.js

@@ -52,7 +52,29 @@ const initAutoreload = ({ mainFilePath }) => {
     currentExecution: null,
     reload: () => {
       const someEffectIsFullReload = reloader.changes.value.some(
-        (reloadMessage) => reloadMessage.type === "full",
+        (reloadMessage) => {
+          if (reloadMessage.type === "full") {
+            return true;
+          }
+          if (reloadMessage.type === "hot") {
+            for (const reloadInstruction of reloadMessage.hotInstructions) {
+              if (reloadInstruction.type === "html") {
+                const acceptedByUrl = new URL(
+                  reloadInstruction.acceptedBy,
+                  `${window.location.origin}/`,
+                ).href;
+                const isCurrentHtmlFile = compareTwoUrlPaths(
+                  acceptedByUrl,
+                  window.location.href,
+                );
+                if (isCurrentHtmlFile) {
+                  return true;
+                }
+              }
+            }
+          }
+          return false;
+        },
       );
       if (someEffectIsFullReload) {
         dispatchBeforeFullReload();
@@ -136,30 +158,32 @@ This could be due to syntax errors or importing non-existent modules (see errors
       // - code was not executed (code splitting with dynamic import)
       // - import.meta.hot.accept() is not called (happens for HTML and CSS)
       if (type === "prune") {
-        if (urlHotMeta) {
-          dispatchBeforePrune();
-          delete urlHotMetas[urlToFetch];
-          if (urlHotMeta.disposeCallback) {
-            console.log(
-              `[jsenv] cleanup ${boundary} (no longer referenced by ${acceptedBy})`,
-            );
-            await urlHotMeta.disposeCallback();
-          }
+        if (!urlHotMeta) {
+          // code not executed for this url, no need to prune
+          continue;
+        }
+        dispatchBeforePrune();
+        delete urlHotMetas[urlToFetch];
+        if (urlHotMeta.disposeCallback) {
+          console.log(
+            `[jsenv] cleanup ${boundary} (no longer referenced by ${acceptedBy})`,
+          );
+          await urlHotMeta.disposeCallback();
         }
         continue;
       }
-      if (acceptedBy === boundary) {
-        console.log(`[jsenv] hot reloading ${boundary} (${cause})`);
-      } else {
-        console.log(
-          `[jsenv] hot reloading ${acceptedBy} usage in ${boundary} (${cause})`,
-        );
-      }
       if (type === "js_module") {
         if (!urlHotMeta) {
-          // code was not executed, no need to re-execute it
+          // code not yet executed for this url, no need to re-execute it
           continue;
         }
+        if (acceptedBy === boundary) {
+          console.log(`[jsenv] hot reload ${boundary} (${cause})`);
+        } else {
+          console.log(
+            `[jsenv] hot reload ${acceptedBy} usage in ${boundary} (${cause})`,
+          );
+        }
         if (urlHotMeta.disposeCallback) {
           await urlHotMeta.disposeCallback();
         }
@@ -189,6 +213,13 @@ This could be due to syntax errors or importing non-existent modules (see errors
           // we are not in that HTML page
           continue;
         }
+        if (acceptedBy === boundary) {
+          console.log(`[jsenv] hot reload ${boundary} (${cause})`);
+        } else {
+          console.log(
+            `[jsenv] hot reload ${acceptedBy} usage in ${boundary} (${cause})`,
+          );
+        }
         const urlToReload = new URL(acceptedBy, `${window.location.origin}/`)
           .href;
         const domNodesUsingUrl = getDOMNodesUsingUrl(urlToReload);

package/dist/js/new_stylesheet.js

@@ -218,7 +218,7 @@
       null,
       false,
     );
-    for (var next = void 0; (next = iter.nextNode()); ) {
+    for (var next = undefined; (next = iter.nextNode()); ) {
       callback(getShadowRoot(next));
     }
   }

package/dist/js/regenerator_runtime.js

@@ -225,7 +225,7 @@ var runtime = (function (exports) {
   // AsyncIterator objects; they just return a Promise for the value of
   // the final result produced by the iterator.
   exports.async = function(innerFn, outerFn, self, tryLocsList, PromiseImpl) {
-    if (PromiseImpl === void 0) PromiseImpl = Promise;
+    if (PromiseImpl === undefined) PromiseImpl = Promise;
 
     var iter = new AsyncIterator(
       wrap(innerFn, outerFn, self, tryLocsList),

package/dist/js/ws.js

@@ -1738,8 +1738,8 @@ function requireBuffer () {
 		    byteOffset = 0;
 		  } else if (byteOffset > 0x7fffffff) {
 		    byteOffset = 0x7fffffff;
-		  } else if (byteOffset < -0x80000000) {
-		    byteOffset = -0x80000000;
+		  } else if (byteOffset < -2147483648) {
+		    byteOffset = -2147483648;
 		  }
 		  byteOffset = +byteOffset; // Coerce to Number.
 		  if (numberIsNaN(byteOffset)) {
@@ -2480,7 +2480,7 @@ function requireBuffer () {
 		Buffer.prototype.writeInt8 = function writeInt8 (value, offset, noAssert) {
 		  value = +value;
 		  offset = offset >>> 0;
-		  if (!noAssert) checkInt(this, value, offset, 1, 0x7f, -0x80);
+		  if (!noAssert) checkInt(this, value, offset, 1, 0x7f, -128);
 		  if (value < 0) value = 0xff + value + 1;
 		  this[offset] = (value & 0xff);
 		  return offset + 1
@@ -2489,7 +2489,7 @@ function requireBuffer () {
 		Buffer.prototype.writeInt16LE = function writeInt16LE (value, offset, noAssert) {
 		  value = +value;
 		  offset = offset >>> 0;
-		  if (!noAssert) checkInt(this, value, offset, 2, 0x7fff, -0x8000);
+		  if (!noAssert) checkInt(this, value, offset, 2, 0x7fff, -32768);
 		  this[offset] = (value & 0xff);
 		  this[offset + 1] = (value >>> 8);
 		  return offset + 2
@@ -2498,7 +2498,7 @@ function requireBuffer () {
 		Buffer.prototype.writeInt16BE = function writeInt16BE (value, offset, noAssert) {
 		  value = +value;
 		  offset = offset >>> 0;
-		  if (!noAssert) checkInt(this, value, offset, 2, 0x7fff, -0x8000);
+		  if (!noAssert) checkInt(this, value, offset, 2, 0x7fff, -32768);
 		  this[offset] = (value >>> 8);
 		  this[offset + 1] = (value & 0xff);
 		  return offset + 2
@@ -2507,7 +2507,7 @@ function requireBuffer () {
 		Buffer.prototype.writeInt32LE = function writeInt32LE (value, offset, noAssert) {
 		  value = +value;
 		  offset = offset >>> 0;
-		  if (!noAssert) checkInt(this, value, offset, 4, 0x7fffffff, -0x80000000);
+		  if (!noAssert) checkInt(this, value, offset, 4, 0x7fffffff, -2147483648);
 		  this[offset] = (value & 0xff);
 		  this[offset + 1] = (value >>> 8);
 		  this[offset + 2] = (value >>> 16);
@@ -2518,7 +2518,7 @@ function requireBuffer () {
 		Buffer.prototype.writeInt32BE = function writeInt32BE (value, offset, noAssert) {
 		  value = +value;
 		  offset = offset >>> 0;
-		  if (!noAssert) checkInt(this, value, offset, 4, 0x7fffffff, -0x80000000);
+		  if (!noAssert) checkInt(this, value, offset, 4, 0x7fffffff, -2147483648);
 		  if (value < 0) value = 0xffffffff + value + 1;
 		  this[offset] = (value >>> 24);
 		  this[offset + 1] = (value >>> 16);

package/dist/jsenv_core.js

@@ -1968,7 +1968,7 @@ const comparePathnames = (leftPathame, rightPathname) => {
 
     // longer comes first
     if (!leftPartExists) {
-      return +1;
+      return 1;
     }
     if (!rightPartExists) {
       return -1;
@@ -1978,7 +1978,7 @@ const comparePathnames = (leftPathame, rightPathname) => {
     const rightPartIsLast = i === rightPartArray.length - 1;
     // folder comes first
     if (leftPartIsLast && !rightPartIsLast) {
-      return +1;
+      return 1;
     }
     if (!leftPartIsLast && rightPartIsLast) {
       return -1;
@@ -1995,7 +1995,7 @@ const comparePathnames = (leftPathame, rightPathname) => {
   }
 
   if (leftLength < rightLength) {
-    return +1;
+    return 1;
   }
   if (leftLength > rightLength) {
     return -1;
@@ -3900,6 +3900,7 @@ const writeDirectorySync = (
               .slice(0, -1),
           ),
         );
+        destinationStats = null;
       } else {
         throw new Error(
           `cannot write directory at ${destinationPath} because there is a file at ${urlToFileSystemPath(
@@ -3919,10 +3920,14 @@ const writeDirectorySync = (
       }
       throw new Error(`directory already exists at ${destinationPath}`);
     }
-    const destinationType = statsToType(destinationStats);
-    throw new Error(
-      `cannot write directory at ${destinationPath} because there is a ${destinationType}`,
-    );
+    if (force) {
+      unlinkSync(destinationPath);
+    } else {
+      const destinationType = statsToType(destinationStats);
+      throw new Error(
+        `cannot write directory at ${destinationPath} because there is a ${destinationType}`,
+      );
+    }
   }
 
   try {
@@ -13056,7 +13061,7 @@ const createReference = ({
   isInline = false,
   content,
   contentType,
-  leadsToADirectory = false,
+  fsStat = null,
   debug = false,
   original = null,
   prev = null,
@@ -13117,7 +13122,7 @@ const createReference = ({
     version,
     injected,
     timing: {},
-    leadsToADirectory,
+    fsStat,
     debug,
     // for inline resources the reference contains the content
     isInline,
@@ -14038,7 +14043,7 @@ const createUrlInfo = (url, context) => {
       version: reference.version,
       content: reference.content,
       contentType: reference.contentType,
-      leadsToADirectory: reference.leadsToADirectory,
+      fsStat: reference.fsStat,
       debug: reference.debug,
       importAttributes: reference.importAttributes,
       astInfo: reference.astInfo,
@@ -14498,11 +14503,15 @@ const createUrlInfoTransformer = ({
     if (!generatedUrl.startsWith("file:")) {
       return;
     }
-    if (
-      urlInfo.type === "directory" ||
-      // happens when type is "html" to list directory content for example
-      urlInfo.firstReference?.leadsToADirectory
-    ) {
+    if (urlToPathname$1(generatedUrl).endsWith("/")) {
+      // when users explicitely request a directory
+      // we can't write the content returned by the server in ".jsenv" at that url
+      // because it would try to write a directory
+      // ideally we would decide a filename for this
+      // for now we just don't write anything
+      return;
+    }
+    if (urlInfo.type === "directory") {
       // no need to write the directory
       return;
     }
@@ -15585,7 +15594,6 @@ const jsenvPluginDirectoryReferenceEffect = (
       if (pathname[pathname.length - 1] !== "/") {
         return null;
       }
-      reference.leadsToADirectory = true;
       reference.expectedType = "directory";
       if (reference.ownerUrlInfo.type === "directory") {
         reference.dirnameHint = reference.ownerUrlInfo.filenameHint;
@@ -16905,11 +16913,7 @@ const jsenvPluginHtmlReferenceAnalysis = ({
             } else {
               position = getHtmlNodeAttributePosition(node, attributeName);
             }
-            const {
-              line,
-              column,
-              // originalLine, originalColumn
-            } = position;
+            const { line, column, originalLine, originalColumn } = position;
             const debug =
               getHtmlNodeAttribute(node, "jsenv-debug") !== undefined;
 
@@ -16942,8 +16946,9 @@ const jsenvPluginHtmlReferenceAnalysis = ({
               subtype,
               expectedType,
               specifier: attributeValue,
-              specifierLine: line,
-              specifierColumn: column,
+              specifierLine: originalLine === undefined ? line : originalLine,
+              specifierColumn:
+                originalColumn === undefined ? column : originalColumn,
               specifierStart: attributeValueStart,
               specifierEnd: attributeValueEnd,
               isResourceHint,
@@ -18885,11 +18890,6 @@ const createNodeEsmResolver = ({
       return reference.specifier;
     }
     const { ownerUrlInfo } = reference;
-    if (reference.specifier === "/") {
-      const { mainFilePath, rootDirectoryUrl } = ownerUrlInfo.context;
-      const url = new URL(mainFilePath, rootDirectoryUrl);
-      return url;
-    }
     if (reference.specifier[0] === "/") {
       const url = new URL(
         reference.specifier.slice(1),
@@ -19092,11 +19092,6 @@ const jsenvPluginWebResolution = () => {
     appliesDuring: "*",
     resolveReference: (reference) => {
       const { ownerUrlInfo } = reference;
-      if (reference.specifier === "/") {
-        const { mainFilePath, rootDirectoryUrl } = ownerUrlInfo.context;
-        const url = new URL(mainFilePath, rootDirectoryUrl);
-        return url;
-      }
       if (reference.specifier[0] === "/") {
         const url = new URL(
           reference.specifier.slice(1),
@@ -19107,7 +19102,9 @@ const jsenvPluginWebResolution = () => {
       // baseUrl happens second argument to new URL() is different from
       // import.meta.url or document.currentScript.src
       const parentUrl =
-        reference.baseUrl || ownerUrlInfo.originalUrl || ownerUrlInfo.url;
+        reference.baseUrl || ownerUrlInfo.context.dev
+          ? ownerUrlInfo.url
+          : ownerUrlInfo.originalUrl || ownerUrlInfo.url;
       const url = new URL(reference.specifier, parentUrl);
       return url;
     },
@@ -19165,7 +19162,6 @@ const jsenvPluginFsRedirection = ({
         return null;
       }
       if (reference.url === "file:///" || reference.url === "file://") {
-        reference.leadsToADirectory = true;
         return `ignore:file:///`;
       }
       // ignore all new URL second arg
@@ -19180,27 +19176,19 @@ const jsenvPluginFsRedirection = ({
       //   return `ignore:${reference.url}`;
       // }
       const urlObject = new URL(reference.url);
-      let stat;
-      try {
-        stat = readEntryStatSync(urlObject);
-      } catch (e) {
-        if (e.code === "ENOENT") {
-          stat = null;
-        } else {
-          throw e;
-        }
-      }
+      let fsStat = readEntryStatSync(urlObject, { nullIfNotFound: true });
+      reference.fsStat = fsStat;
       const { search, hash } = urlObject;
       urlObject.search = "";
       urlObject.hash = "";
-      applyStatEffectsOnUrlObject(urlObject, stat);
+      applyFsStatEffectsOnUrlObject(urlObject, fsStat);
       const shouldApplyFilesystemMagicResolution =
         reference.type === "js_import";
       if (shouldApplyFilesystemMagicResolution) {
         const filesystemResolution = applyFileSystemMagicResolution(
           urlObject.href,
           {
-            fileStat: stat,
+            fileStat: fsStat,
             magicDirectoryIndex,
             magicExtensions: getExtensionsToTry(
               magicExtensions,
@@ -19209,12 +19197,28 @@ const jsenvPluginFsRedirection = ({
           },
         );
         if (filesystemResolution.stat) {
-          stat = filesystemResolution.stat;
+          fsStat = filesystemResolution.stat;
+          reference.fsStat = fsStat;
           urlObject.href = filesystemResolution.url;
-          applyStatEffectsOnUrlObject(urlObject, stat);
+          applyFsStatEffectsOnUrlObject(urlObject, fsStat);
         }
       }
-      if (!stat) {
+      if (!fsStat) {
+        // for SPA we want to serve the root HTML file only when:
+        // 1. There is no corresponding file on the filesystem
+        // 2. The url pathname does not have an extension
+        //    This point assume client is requesting a file when there is an extension
+        //    and it assumes all routes will not use extension
+        // 3. The url pathname does not ends with "/"
+        //    In that case we assume client explicitely asks to load a directory
+        if (
+          !urlToExtension$1(urlObject) &&
+          !urlToPathname$1(urlObject).endsWith("/")
+        ) {
+          const { mainFilePath, rootDirectoryUrl } =
+            reference.ownerUrlInfo.context;
+          return new URL(mainFilePath, rootDirectoryUrl);
+        }
         return null;
       }
       const urlBeforeSymlinkResolution = urlObject.href;
@@ -19234,15 +19238,19 @@ const jsenvPluginFsRedirection = ({
   };
 };
 
-const applyStatEffectsOnUrlObject = (urlObject, stat) => {
+const applyFsStatEffectsOnUrlObject = (urlObject, fsStat) => {
+  if (!fsStat) {
+    return;
+  }
   const { pathname } = urlObject;
   const pathnameUsesTrailingSlash = pathname.endsWith("/");
   // force trailing slash on directories
-  if (stat && stat.isDirectory() && !pathnameUsesTrailingSlash) {
-    urlObject.pathname = `${pathname}/`;
-  }
-  // otherwise remove trailing slash if any
-  if (stat && !stat.isDirectory() && pathnameUsesTrailingSlash) {
+  if (fsStat.isDirectory()) {
+    if (!pathnameUsesTrailingSlash) {
+      urlObject.pathname = `${pathname}/`;
+    }
+  } else if (pathnameUsesTrailingSlash) {
+    // otherwise remove trailing slash if any
     // a warning here? (because it's strange to reference a file with a trailing slash)
     urlObject.pathname = pathname.slice(0, -1);
   }
@@ -19327,45 +19335,16 @@ const jsenvPluginProtocolFile = ({
         if (!urlInfo.url.startsWith("file:")) {
           return null;
         }
-        const { rootDirectoryUrl } = urlInfo.context;
-        const generateContent = () => {
-          const urlObject = new URL(urlInfo.url);
-          const { firstReference } = urlInfo;
-          if (firstReference.leadsToADirectory) {
-            const directoryContentArray = readdirSync(urlObject);
-            if (firstReference.type === "filesystem") {
-              const content = JSON.stringify(directoryContentArray, null, "  ");
-              return {
-                type: "directory",
-                contentType: "application/json",
-                content,
-              };
-            }
-            const acceptsHtml = urlInfo.context.request
-              ? pickContentType(urlInfo.context.request, ["text/html"])
-              : false;
-            if (acceptsHtml) {
-              firstReference.expectedType = "html";
-              const directoryUrl = urlObject.href;
-              const directoryContentItems = generateDirectoryContentItems(
-                directoryUrl,
-                rootDirectoryUrl,
-              );
-              const html = generateHtmlForDirectory(directoryContentItems);
-              return {
-                type: "html",
-                contentType: "text/html",
-                content: html,
-              };
-            }
-            return {
-              type: "directory",
-              contentType: "application/json",
-              content: JSON.stringify(directoryContentArray, null, "  "),
-            };
-          }
-          const contentType = CONTENT_TYPE.fromUrlExtension(urlInfo.url);
-          const fileBuffer = readFileSync(urlObject);
+        const { firstReference } = urlInfo;
+        let { fsStat } = firstReference;
+        if (!fsStat) {
+          fsStat = readEntryStatSync(urlInfo.url, { nullIfNotFound: true });
+        }
+        const isDirectory = fsStat?.isDirectory();
+        const { rootDirectoryUrl, request } = urlInfo.context;
+        const serveFile = (url) => {
+          const contentType = CONTENT_TYPE.fromUrlExtension(url);
+          const fileBuffer = readFileSync(new URL(url));
           const content = CONTENT_TYPE.isTextual(contentType)
             ? String(fileBuffer)
             : fileBuffer;
@@ -19376,14 +19355,8 @@ const jsenvPluginProtocolFile = ({
           };
         };
 
-        const request = urlInfo.context.request;
-        if (request && request.headers["sec-fetch-dest"] === "document") {
-          try {
-            return generateContent();
-          } catch (e) {
-            if (e.code !== "ENOENT") {
-              throw e;
-            }
+        if (!fsStat) {
+          if (request && request.headers["sec-fetch-dest"] === "document") {
             const directoryContentItems = generateDirectoryContentItems(
               urlInfo.url,
               rootDirectoryUrl,
@@ -19403,7 +19376,40 @@ const jsenvPluginProtocolFile = ({
             };
           }
         }
-        return generateContent();
+        if (isDirectory) {
+          const directoryContentArray = readdirSync(new URL(urlInfo.url));
+          if (firstReference.type === "filesystem") {
+            const content = JSON.stringify(directoryContentArray, null, "  ");
+            return {
+              type: "directory",
+              contentType: "application/json",
+              content,
+            };
+          }
+          const acceptsHtml = request
+            ? pickContentType(request, ["text/html"])
+            : false;
+          if (acceptsHtml) {
+            firstReference.expectedType = "html";
+            const directoryUrl = urlInfo.url;
+            const directoryContentItems = generateDirectoryContentItems(
+              directoryUrl,
+              rootDirectoryUrl,
+            );
+            const html = generateHtmlForDirectory(directoryContentItems);
+            return {
+              type: "html",
+              contentType: "text/html",
+              content: html,
+            };
+          }
+          return {
+            type: "directory",
+            contentType: "application/json",
+            content: JSON.stringify(directoryContentArray, null, "  "),
+          };
+        }
+        return serveFile(urlInfo.url);
       },
     },
   ];
@@ -21122,6 +21128,19 @@ const getCorePlugins = ({
       directoryListingUrlMocks,
     }),
 
+    {
+      name: "jsenv:resolve_root_as_main",
+      appliesDuring: "*",
+      resolveReference: (reference) => {
+        const { ownerUrlInfo } = reference;
+        if (reference.specifier === "/") {
+          const { mainFilePath, rootDirectoryUrl } = ownerUrlInfo.context;
+          const url = new URL(mainFilePath, rootDirectoryUrl);
+          return url;
+        }
+        return null;
+      },
+    },
     ...(nodeEsmResolution
       ? [jsenvPluginNodeEsmResolution(nodeEsmResolution)]
       : []),
@@ -22865,7 +22884,7 @@ const build = async ({
     if (outDirectoryUrl === undefined) {
       if (
         process.env.CAPTURING_SIDE_EFFECTS ||
-        (!true)
+        (false)
       ) {
         outDirectoryUrl = new URL("../.jsenv_b/", sourceDirectoryUrl);
       } else {
@@ -23742,7 +23761,7 @@ const startDevServer = async ({
     if (outDirectoryUrl === undefined) {
       if (
         process.env.CAPTURING_SIDE_EFFECTS ||
-        (!true)
+        (false)
       ) {
         outDirectoryUrl = new URL("../.jsenv/", sourceDirectoryUrl);
       } else {
@@ -24052,12 +24071,14 @@ const startDevServer = async ({
           parentUrl,
         );
         if (!reference) {
-          reference =
-            kitchen.graph.rootUrlInfo.dependencies.createResolveAndFinalize({
-              trace: { message: parentUrl },
-              type: "http_request",
-              specifier: request.resource,
-            });
+          const rootUrlInfo = kitchen.graph.rootUrlInfo;
+          rootUrlInfo.context.request = request;
+          reference = rootUrlInfo.dependencies.createResolveAndFinalize({
+            trace: { message: parentUrl },
+            type: "http_request",
+            specifier: request.resource,
+          });
+          rootUrlInfo.context.request = null;
         }
         const urlInfo = reference.urlInfo;
         const ifNoneMatch = request.headers["if-none-match"];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jsenv/core",
-  "version": "39.9.4",
+  "version": "39.9.6",
   "description": "Tool to develop, test and build js projects",
   "license": "MIT",
   "author": {
@@ -34,7 +34,7 @@
     "/src/"
   ],
   "volta": {
-    "node": "22.3.0"
+    "node": "22.13.1"
   },
   "workspaces": [
     "./packages/independent/*",
@@ -69,17 +69,17 @@
   "dependencies": {
     "@financial-times/polyfill-useragent-normaliser": "1.10.2",
     "@jsenv/abort": "4.3.0",
-    "@jsenv/ast": "6.4.1",
-    "@jsenv/filesystem": "4.13.0",
+    "@jsenv/ast": "6.4.3",
+    "@jsenv/filesystem": "4.13.1",
     "@jsenv/humanize": "1.2.8",
     "@jsenv/importmap": "1.2.1",
     "@jsenv/integrity": "0.0.2",
-    "@jsenv/js-module-fallback": "1.3.54",
+    "@jsenv/js-module-fallback": "1.3.55",
     "@jsenv/node-esm-resolution": "1.0.6",
-    "@jsenv/plugin-bundling": "2.7.21",
-    "@jsenv/plugin-minification": "1.5.12",
-    "@jsenv/plugin-supervisor": "1.6.1",
-    "@jsenv/plugin-transpilation": "1.4.89",
+    "@jsenv/plugin-bundling": "2.7.23",
+    "@jsenv/plugin-minification": "1.5.13",
+    "@jsenv/plugin-supervisor": "1.6.2",
+    "@jsenv/plugin-transpilation": "1.4.91",
     "@jsenv/runtime-compat": "1.3.1",
     "@jsenv/server": "15.3.3",
     "@jsenv/sourcemap": "1.2.29",
@@ -91,7 +91,6 @@
   "devDependencies": {
     "@babel/plugin-syntax-import-attributes": "7.26.0",
     "@babel/plugin-syntax-optional-chaining-assign": "7.25.9",
-    "@eslint/compat": "1.2.4",
     "@jsenv/assert": "workspace:*",
     "@jsenv/cli": "workspace:*",
     "@jsenv/core": "./",
@@ -108,7 +107,7 @@
     "@playwright/browser-firefox": "1.49.1",
     "@playwright/browser-webkit": "1.49.1",
     "babel-plugin-transform-async-to-promises": "0.8.18",
-    "eslint": "9.17.0",
+    "eslint": "9.18.0",
     "open": "10.1.0",
     "playwright": "1.49.1",
     "prettier": "3.4.2",

package/src/dev/start_dev_server.js

@@ -422,12 +422,14 @@ export const startDevServer = async ({
           parentUrl,
         );
         if (!reference) {
-          reference =
-            kitchen.graph.rootUrlInfo.dependencies.createResolveAndFinalize({
-              trace: { message: parentUrl },
-              type: "http_request",
-              specifier: request.resource,
-            });
+          const rootUrlInfo = kitchen.graph.rootUrlInfo;
+          rootUrlInfo.context.request = request;
+          reference = rootUrlInfo.dependencies.createResolveAndFinalize({
+            trace: { message: parentUrl },
+            type: "http_request",
+            specifier: request.resource,
+          });
+          rootUrlInfo.context.request = null;
         }
         const urlInfo = reference.urlInfo;
         const ifNoneMatch = request.headers["if-none-match"];

package/src/kitchen/url_graph/references.js

@@ -291,7 +291,7 @@ const createReference = ({
   isInline = false,
   content,
   contentType,
-  leadsToADirectory = false,
+  fsStat = null,
   debug = false,
   original = null,
   prev = null,
@@ -352,7 +352,7 @@ const createReference = ({
     version,
     injected,
     timing: {},
-    leadsToADirectory,
+    fsStat,
     debug,
     // for inline resources the reference contains the content
     isInline,

package/src/kitchen/url_graph/url_graph.js

@@ -336,7 +336,7 @@ const createUrlInfo = (url, context) => {
       version: reference.version,
       content: reference.content,
       contentType: reference.contentType,
-      leadsToADirectory: reference.leadsToADirectory,
+      fsStat: reference.fsStat,
       debug: reference.debug,
       importAttributes: reference.importAttributes,
       astInfo: reference.astInfo,

package/src/kitchen/url_graph/url_info_transformations.js

@@ -4,7 +4,7 @@ import {
   generateSourcemapDataUrl,
   SOURCEMAP,
 } from "@jsenv/sourcemap";
-import { isFileSystemPath, urlToRelativeUrl } from "@jsenv/urls";
+import { isFileSystemPath, urlToPathname, urlToRelativeUrl } from "@jsenv/urls";
 import { pathToFileURL } from "node:url";
 import {
   defineGettersOnPropertiesDerivedFromContent,
@@ -251,11 +251,15 @@ export const createUrlInfoTransformer = ({
     if (!generatedUrl.startsWith("file:")) {
       return;
     }
-    if (
-      urlInfo.type === "directory" ||
-      // happens when type is "html" to list directory content for example
-      urlInfo.firstReference?.leadsToADirectory
-    ) {
+    if (urlToPathname(generatedUrl).endsWith("/")) {
+      // when users explicitely request a directory
+      // we can't write the content returned by the server in ".jsenv" at that url
+      // because it would try to write a directory
+      // ideally we would decide a filename for this
+      // for now we just don't write anything
+      return;
+    }
+    if (urlInfo.type === "directory") {
       // no need to write the directory
       return;
     }

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

@@ -65,7 +65,29 @@ export const initAutoreload = ({ mainFilePath }) => {
     currentExecution: null,
     reload: () => {
       const someEffectIsFullReload = reloader.changes.value.some(
-        (reloadMessage) => reloadMessage.type === "full",
+        (reloadMessage) => {
+          if (reloadMessage.type === "full") {
+            return true;
+          }
+          if (reloadMessage.type === "hot") {
+            for (const reloadInstruction of reloadMessage.hotInstructions) {
+              if (reloadInstruction.type === "html") {
+                const acceptedByUrl = new URL(
+                  reloadInstruction.acceptedBy,
+                  `${window.location.origin}/`,
+                ).href;
+                const isCurrentHtmlFile = compareTwoUrlPaths(
+                  acceptedByUrl,
+                  window.location.href,
+                );
+                if (isCurrentHtmlFile) {
+                  return true;
+                }
+              }
+            }
+          }
+          return false;
+        },
       );
       if (someEffectIsFullReload) {
         dispatchBeforeFullReload();
@@ -149,33 +171,35 @@ This could be due to syntax errors or importing non-existent modules (see errors
       // - code was not executed (code splitting with dynamic import)
       // - import.meta.hot.accept() is not called (happens for HTML and CSS)
       if (type === "prune") {
-        if (urlHotMeta) {
-          dispatchBeforePrune();
-          delete urlHotMetas[urlToFetch];
-          if (urlHotMeta.disposeCallback) {
-            console.log(
-              `[jsenv] cleanup ${boundary} (no longer referenced by ${acceptedBy})`,
-            );
-            if (debug) {
-              console.log(`call dispose callback`);
-            }
-            await urlHotMeta.disposeCallback();
+        if (!urlHotMeta) {
+          // code not executed for this url, no need to prune
+          continue;
+        }
+        dispatchBeforePrune();
+        delete urlHotMetas[urlToFetch];
+        if (urlHotMeta.disposeCallback) {
+          console.log(
+            `[jsenv] cleanup ${boundary} (no longer referenced by ${acceptedBy})`,
+          );
+          if (debug) {
+            console.log(`call dispose callback`);
           }
+          await urlHotMeta.disposeCallback();
         }
         continue;
       }
-      if (acceptedBy === boundary) {
-        console.log(`[jsenv] hot reloading ${boundary} (${cause})`);
-      } else {
-        console.log(
-          `[jsenv] hot reloading ${acceptedBy} usage in ${boundary} (${cause})`,
-        );
-      }
       if (type === "js_module") {
         if (!urlHotMeta) {
-          // code was not executed, no need to re-execute it
+          // code not yet executed for this url, no need to re-execute it
           continue;
         }
+        if (acceptedBy === boundary) {
+          console.log(`[jsenv] hot reload ${boundary} (${cause})`);
+        } else {
+          console.log(
+            `[jsenv] hot reload ${acceptedBy} usage in ${boundary} (${cause})`,
+          );
+        }
         if (urlHotMeta.disposeCallback) {
           if (debug) {
             console.log(`call dispose callback`);
@@ -211,9 +235,21 @@ This could be due to syntax errors or importing non-existent modules (see errors
           !isRootHtmlFile &&
           !compareTwoUrlPaths(urlToFetch, window.location.href)
         ) {
+          if (debug) {
+            console.log(
+              `[jsenv] skip ${acceptedBy} hot reload because we are not in that html page`,
+            );
+          }
           // we are not in that HTML page
           continue;
         }
+        if (acceptedBy === boundary) {
+          console.log(`[jsenv] hot reload ${boundary} (${cause})`);
+        } else {
+          console.log(
+            `[jsenv] hot reload ${acceptedBy} usage in ${boundary} (${cause})`,
+          );
+        }
         const urlToReload = new URL(acceptedBy, `${window.location.origin}/`)
           .href;
         const domNodesUsingUrl = getDOMNodesUsingUrl(urlToReload);

package/src/plugins/directory_reference_effect/jsenv_plugin_directory_reference_effect.js

@@ -22,7 +22,6 @@ export const jsenvPluginDirectoryReferenceEffect = (
       if (pathname[pathname.length - 1] !== "/") {
         return null;
       }
-      reference.leadsToADirectory = true;
       reference.expectedType = "directory";
       if (reference.ownerUrlInfo.type === "directory") {
         reference.dirnameHint = reference.ownerUrlInfo.filenameHint;

package/src/plugins/plugins.js

@@ -81,6 +81,19 @@ export const getCorePlugins = ({
       directoryListingUrlMocks,
     }),
 
+    {
+      name: "jsenv:resolve_root_as_main",
+      appliesDuring: "*",
+      resolveReference: (reference) => {
+        const { ownerUrlInfo } = reference;
+        if (reference.specifier === "/") {
+          const { mainFilePath, rootDirectoryUrl } = ownerUrlInfo.context;
+          const url = new URL(mainFilePath, rootDirectoryUrl);
+          return url;
+        }
+        return null;
+      },
+    },
     ...(nodeEsmResolution
       ? [jsenvPluginNodeEsmResolution(nodeEsmResolution)]
       : []),

package/src/plugins/protocol_file/jsenv_plugin_fs_redirection.js

@@ -3,6 +3,7 @@ import {
   applyFileSystemMagicResolution,
   getExtensionsToTry,
 } from "@jsenv/node-esm-resolution";
+import { urlToExtension, urlToPathname } from "@jsenv/urls";
 import { realpathSync } from "node:fs";
 import { pathToFileURL } from "node:url";
 
@@ -23,7 +24,6 @@ export const jsenvPluginFsRedirection = ({
         return null;
       }
       if (reference.url === "file:///" || reference.url === "file://") {
-        reference.leadsToADirectory = true;
         return `ignore:file:///`;
       }
       // ignore all new URL second arg
@@ -38,27 +38,19 @@ export const jsenvPluginFsRedirection = ({
       //   return `ignore:${reference.url}`;
       // }
       const urlObject = new URL(reference.url);
-      let stat;
-      try {
-        stat = readEntryStatSync(urlObject);
-      } catch (e) {
-        if (e.code === "ENOENT") {
-          stat = null;
-        } else {
-          throw e;
-        }
-      }
+      let fsStat = readEntryStatSync(urlObject, { nullIfNotFound: true });
+      reference.fsStat = fsStat;
       const { search, hash } = urlObject;
       urlObject.search = "";
       urlObject.hash = "";
-      applyStatEffectsOnUrlObject(urlObject, stat);
+      applyFsStatEffectsOnUrlObject(urlObject, fsStat);
       const shouldApplyFilesystemMagicResolution =
         reference.type === "js_import";
       if (shouldApplyFilesystemMagicResolution) {
         const filesystemResolution = applyFileSystemMagicResolution(
           urlObject.href,
           {
-            fileStat: stat,
+            fileStat: fsStat,
             magicDirectoryIndex,
             magicExtensions: getExtensionsToTry(
               magicExtensions,
@@ -67,12 +59,28 @@ export const jsenvPluginFsRedirection = ({
           },
         );
         if (filesystemResolution.stat) {
-          stat = filesystemResolution.stat;
+          fsStat = filesystemResolution.stat;
+          reference.fsStat = fsStat;
           urlObject.href = filesystemResolution.url;
-          applyStatEffectsOnUrlObject(urlObject, stat);
+          applyFsStatEffectsOnUrlObject(urlObject, fsStat);
         }
       }
-      if (!stat) {
+      if (!fsStat) {
+        // for SPA we want to serve the root HTML file only when:
+        // 1. There is no corresponding file on the filesystem
+        // 2. The url pathname does not have an extension
+        //    This point assume client is requesting a file when there is an extension
+        //    and it assumes all routes will not use extension
+        // 3. The url pathname does not ends with "/"
+        //    In that case we assume client explicitely asks to load a directory
+        if (
+          !urlToExtension(urlObject) &&
+          !urlToPathname(urlObject).endsWith("/")
+        ) {
+          const { mainFilePath, rootDirectoryUrl } =
+            reference.ownerUrlInfo.context;
+          return new URL(mainFilePath, rootDirectoryUrl);
+        }
         return null;
       }
       const urlBeforeSymlinkResolution = urlObject.href;
@@ -92,15 +100,19 @@ export const jsenvPluginFsRedirection = ({
   };
 };
 
-const applyStatEffectsOnUrlObject = (urlObject, stat) => {
+const applyFsStatEffectsOnUrlObject = (urlObject, fsStat) => {
+  if (!fsStat) {
+    return;
+  }
   const { pathname } = urlObject;
   const pathnameUsesTrailingSlash = pathname.endsWith("/");
   // force trailing slash on directories
-  if (stat && stat.isDirectory() && !pathnameUsesTrailingSlash) {
-    urlObject.pathname = `${pathname}/`;
-  }
-  // otherwise remove trailing slash if any
-  if (stat && !stat.isDirectory() && pathnameUsesTrailingSlash) {
+  if (fsStat.isDirectory()) {
+    if (!pathnameUsesTrailingSlash) {
+      urlObject.pathname = `${pathname}/`;
+    }
+  } else if (pathnameUsesTrailingSlash) {
+    // otherwise remove trailing slash if any
     // a warning here? (because it's strange to reference a file with a trailing slash)
     urlObject.pathname = pathname.slice(0, -1);
   }

package/src/plugins/protocol_file/jsenv_plugin_protocol_file.js

@@ -1,6 +1,7 @@
 import {
   assertAndNormalizeDirectoryUrl,
   comparePathnames,
+  readEntryStatSync,
 } from "@jsenv/filesystem";
 import { pickContentType } from "@jsenv/server";
 import {
@@ -84,45 +85,16 @@ export const jsenvPluginProtocolFile = ({
         if (!urlInfo.url.startsWith("file:")) {
           return null;
         }
-        const { rootDirectoryUrl } = urlInfo.context;
-        const generateContent = () => {
-          const urlObject = new URL(urlInfo.url);
-          const { firstReference } = urlInfo;
-          if (firstReference.leadsToADirectory) {
-            const directoryContentArray = readdirSync(urlObject);
-            if (firstReference.type === "filesystem") {
-              const content = JSON.stringify(directoryContentArray, null, "  ");
-              return {
-                type: "directory",
-                contentType: "application/json",
-                content,
-              };
-            }
-            const acceptsHtml = urlInfo.context.request
-              ? pickContentType(urlInfo.context.request, ["text/html"])
-              : false;
-            if (acceptsHtml) {
-              firstReference.expectedType = "html";
-              const directoryUrl = urlObject.href;
-              const directoryContentItems = generateDirectoryContentItems(
-                directoryUrl,
-                rootDirectoryUrl,
-              );
-              const html = generateHtmlForDirectory(directoryContentItems);
-              return {
-                type: "html",
-                contentType: "text/html",
-                content: html,
-              };
-            }
-            return {
-              type: "directory",
-              contentType: "application/json",
-              content: JSON.stringify(directoryContentArray, null, "  "),
-            };
-          }
-          const contentType = CONTENT_TYPE.fromUrlExtension(urlInfo.url);
-          const fileBuffer = readFileSync(urlObject);
+        const { firstReference } = urlInfo;
+        let { fsStat } = firstReference;
+        if (!fsStat) {
+          fsStat = readEntryStatSync(urlInfo.url, { nullIfNotFound: true });
+        }
+        const isDirectory = fsStat?.isDirectory();
+        const { rootDirectoryUrl, request } = urlInfo.context;
+        const serveFile = (url) => {
+          const contentType = CONTENT_TYPE.fromUrlExtension(url);
+          const fileBuffer = readFileSync(new URL(url));
           const content = CONTENT_TYPE.isTextual(contentType)
             ? String(fileBuffer)
             : fileBuffer;
@@ -133,14 +105,8 @@ export const jsenvPluginProtocolFile = ({
           };
         };
 
-        const request = urlInfo.context.request;
-        if (request && request.headers["sec-fetch-dest"] === "document") {
-          try {
-            return generateContent();
-          } catch (e) {
-            if (e.code !== "ENOENT") {
-              throw e;
-            }
+        if (!fsStat) {
+          if (request && request.headers["sec-fetch-dest"] === "document") {
             const directoryContentItems = generateDirectoryContentItems(
               urlInfo.url,
               rootDirectoryUrl,
@@ -160,7 +126,40 @@ export const jsenvPluginProtocolFile = ({
             };
           }
         }
-        return generateContent();
+        if (isDirectory) {
+          const directoryContentArray = readdirSync(new URL(urlInfo.url));
+          if (firstReference.type === "filesystem") {
+            const content = JSON.stringify(directoryContentArray, null, "  ");
+            return {
+              type: "directory",
+              contentType: "application/json",
+              content,
+            };
+          }
+          const acceptsHtml = request
+            ? pickContentType(request, ["text/html"])
+            : false;
+          if (acceptsHtml) {
+            firstReference.expectedType = "html";
+            const directoryUrl = urlInfo.url;
+            const directoryContentItems = generateDirectoryContentItems(
+              directoryUrl,
+              rootDirectoryUrl,
+            );
+            const html = generateHtmlForDirectory(directoryContentItems);
+            return {
+              type: "html",
+              contentType: "text/html",
+              content: html,
+            };
+          }
+          return {
+            type: "directory",
+            contentType: "application/json",
+            content: JSON.stringify(directoryContentArray, null, "  "),
+          };
+        }
+        return serveFile(urlInfo.url);
       },
     },
   ];

package/src/plugins/reference_analysis/html/jsenv_plugin_html_reference_analysis.js

@@ -156,11 +156,7 @@ export const jsenvPluginHtmlReferenceAnalysis = ({
             } else {
               position = getHtmlNodeAttributePosition(node, attributeName);
             }
-            const {
-              line,
-              column,
-              // originalLine, originalColumn
-            } = position;
+            const { line, column, originalLine, originalColumn } = position;
             const debug =
               getHtmlNodeAttribute(node, "jsenv-debug") !== undefined;
 
@@ -193,8 +189,9 @@ export const jsenvPluginHtmlReferenceAnalysis = ({
               subtype,
               expectedType,
               specifier: attributeValue,
-              specifierLine: line,
-              specifierColumn: column,
+              specifierLine: originalLine === undefined ? line : originalLine,
+              specifierColumn:
+                originalColumn === undefined ? column : originalColumn,
               specifierStart: attributeValueStart,
               specifierEnd: attributeValueEnd,
               isResourceHint,

package/src/plugins/resolution_node_esm/node_esm_resolver.js

@@ -33,11 +33,6 @@ export const createNodeEsmResolver = ({
       return reference.specifier;
     }
     const { ownerUrlInfo } = reference;
-    if (reference.specifier === "/") {
-      const { mainFilePath, rootDirectoryUrl } = ownerUrlInfo.context;
-      const url = new URL(mainFilePath, rootDirectoryUrl);
-      return url;
-    }
     if (reference.specifier[0] === "/") {
       const url = new URL(
         reference.specifier.slice(1),

package/src/plugins/resolution_web/jsenv_plugin_web_resolution.js

@@ -4,11 +4,6 @@ export const jsenvPluginWebResolution = () => {
     appliesDuring: "*",
     resolveReference: (reference) => {
       const { ownerUrlInfo } = reference;
-      if (reference.specifier === "/") {
-        const { mainFilePath, rootDirectoryUrl } = ownerUrlInfo.context;
-        const url = new URL(mainFilePath, rootDirectoryUrl);
-        return url;
-      }
       if (reference.specifier[0] === "/") {
         const url = new URL(
           reference.specifier.slice(1),
@@ -19,7 +14,9 @@ export const jsenvPluginWebResolution = () => {
       // baseUrl happens second argument to new URL() is different from
       // import.meta.url or document.currentScript.src
       const parentUrl =
-        reference.baseUrl || ownerUrlInfo.originalUrl || ownerUrlInfo.url;
+        reference.baseUrl || ownerUrlInfo.context.dev
+          ? ownerUrlInfo.url
+          : ownerUrlInfo.originalUrl || ownerUrlInfo.url;
       const url = new URL(reference.specifier, parentUrl);
       return url;
     },