@jsenv/core 27.0.0-alpha.65 → 27.0.0-alpha.68

package/dist/main.js

@@ -1,8 +1,8 @@
 import { parentPort } from "node:worker_threads";
-import { urlToRelativeUrl, normalizeStructuredMetaMap, urlToMeta, registerFileLifecycle, urlIsInsideOf, urlToExtension, urlToFilename, readFileSync as readFileSync$1, fileSystemPathToUrl, urlToFileSystemPath, isFileSystemPath, bufferToEtag, writeFileSync, ensureWindowsDriveLetter, moveUrl, collectFiles, assertAndNormalizeDirectoryUrl, registerDirectoryLifecycle, resolveUrl, writeFile, ensureEmptyDirectory, writeDirectory, resolveDirectoryUrl, urlToBasename } from "@jsenv/filesystem";
+import { registerFileLifecycle, readFileSync as readFileSync$1, bufferToEtag, writeFileSync, ensureWindowsDriveLetter, collectFiles, assertAndNormalizeDirectoryUrl, registerDirectoryLifecycle, writeFile, ensureEmptyDirectory, writeDirectory } from "@jsenv/filesystem";
 import { createDetailedMessage, createLogger, loggerToLevels } from "@jsenv/logger";
 import { createTaskLog, ANSI, msAsDuration, msAsEllapsedTime, byteAsMemoryUsage, UNICODE, createLog, startSpinner, distributePercentages, byteAsFileSize } from "@jsenv/log";
-import { getCallerPosition } from "@jsenv/utils/src/caller_position.js";
+import { urlToRelativeUrl, URL_META, generateInlineContentUrl, ensurePathnameTrailingSlash, urlIsInsideOf, urlToFilename, urlToExtension, DataUrl, injectQueryParams, injectQueryParamsIntoSpecifier, fileSystemPathToUrl, urlToFileSystemPath, isFileSystemPath, normalizeUrl, stringifyUrlSite, setUrlFilename, moveUrl, getCallerPosition, resolveUrl, resolveDirectoryUrl, asUrlWithoutSearch, asUrlUntilPathname, urlToBasename } from "@jsenv/urls";
 import { initReloadableProcess } from "@jsenv/utils/process_reload/process_reload.js";
 import { parseHtmlString, stringifyHtmlAst, visitHtmlAst, getHtmlNodeAttributeByName, htmlNodePosition, findNode, getHtmlNodeTextNode, removeHtmlNode, setHtmlNodeGeneratedText, removeHtmlNodeAttributeByName, parseScriptNode, injectScriptAsEarlyAsPossible, createHtmlNode, removeHtmlNodeText, assignHtmlNodeAttributes, parseLinkNode } from "@jsenv/utils/html_ast/html_ast.js";
 import { htmlAttributeSrcSet } from "@jsenv/utils/html_ast/html_attribute_src_set.js";
@@ -11,17 +11,13 @@ import { applyPostCss } from "@jsenv/utils/css_ast/apply_post_css.js";
 import { postCssPluginUrlVisitor } from "@jsenv/utils/css_ast/postcss_plugin_url_visitor.js";
 import { parseJsUrls } from "@jsenv/utils/js_ast/parse_js_urls.js";
 import { resolveImport, normalizeImportMap, composeTwoImportMaps } from "@jsenv/importmap";
-import { generateInlineContentUrl } from "@jsenv/utils/urls/inline_content_url_generator.js";
 import { applyNodeEsmResolution, defaultLookupPackageScope, defaultReadPackageJson, readCustomConditionsFromProcessArgs, applyFileSystemMagicResolution } from "@jsenv/node-esm-resolution";
-import { statSync, readdirSync, readFileSync, realpathSync, existsSync } from "node:fs";
+import { statSync, realpathSync, readdirSync, readFileSync, existsSync } from "node:fs";
 import { pathToFileURL } from "node:url";
-import { ensurePathnameTrailingSlash, injectQueryParams, injectQueryParamsIntoSpecifier, normalizeUrl, setUrlFilename, asUrlWithoutSearch, asUrlUntilPathname } from "@jsenv/utils/urls/url_utils.js";
 import { CONTENT_TYPE } from "@jsenv/utils/content_type/content_type.js";
 import { JS_QUOTES } from "@jsenv/utils/string/js_quotes.js";
 import { applyBabelPlugins } from "@jsenv/utils/js_ast/apply_babel_plugins.js";
-import { DataUrl } from "@jsenv/utils/urls/data_url.js";
 import { transpileWithParcel, minifyWithParcel } from "@jsenv/utils/css_ast/parcel_css.js";
-import { fetchOriginalUrlInfo } from "@jsenv/utils/graph/fetch_original_url_info.js";
 import { createRequire } from "node:module";
 import { composeTwoSourcemaps } from "@jsenv/utils/sourcemap/sourcemap_composition_v3.js";
 import babelParser from "@babel/parser";
@@ -32,7 +28,6 @@ import { applyRollupPlugins } from "@jsenv/utils/js_ast/apply_rollup_plugins.js"
 import { sourcemapConverter } from "@jsenv/utils/sourcemap/sourcemap_converter.js";
 import { createCallbackList, createCallbackListNotifiedOnce, Abort, raceCallbacks, raceProcessTeardownEvents } from "@jsenv/abort";
 import { createSSEService } from "@jsenv/utils/event_source/sse_service.js";
-import { stringifyUrlSite } from "@jsenv/utils/urls/url_trace.js";
 import { timeStart, fetchFileSystem, composeTwoResponses, serveDirectory, startServer, pluginCORS, jsenvAccessControlAllowedHeaders, pluginServerTiming, pluginRequestWaitingCheck, composeServices, findFreePort } from "@jsenv/server";
 import { SOURCEMAP, generateSourcemapUrl, sourcemapToBase64Url } from "@jsenv/utils/sourcemap/sourcemap_utils.js";
 import { validateResponseIntegrity } from "@jsenv/integrity";
@@ -58,7 +53,7 @@ import { uneval } from "@jsenv/uneval";
 import { createVersionGenerator } from "@jsenv/utils/versioning/version_generator.js";
 
 const parseAndTransformHtmlUrls = async (urlInfo, context) => {
-  const url = urlInfo.data.rawUrl || urlInfo.url;
+  const url = urlInfo.originalUrl;
   const content = urlInfo.content;
   const {
     scenario,
@@ -368,7 +363,7 @@ const parseAndTransformCssUrls = async (urlInfo, context) => {
         });
       }
     })],
-    url: urlInfo.data.rawUrl || urlInfo.url,
+    url: urlInfo.originalUrl,
     content: urlInfo.content
   });
   await Promise.all(actions.map(action => action()));
@@ -409,7 +404,7 @@ const isWebWorkerUrlInfo = urlInfo => {
 const parseAndTransformJsUrls = async (urlInfo, context) => {
   const jsMentions = await parseJsUrls({
     js: urlInfo.content,
-    url: urlInfo.data && urlInfo.data.rawUrl || urlInfo.url,
+    url: urlInfo.originalUrl,
     isJsModule: urlInfo.type === "js_module",
     isWebWorker: isWebWorkerUrlInfo(urlInfo)
   });
@@ -513,16 +508,18 @@ const jsenvPluginUrlAnalysis = ({
   let getIncludeInfo = () => undefined;
 
   if (include) {
-    const includeMetaMap = normalizeStructuredMetaMap({
+    const associations = URL_META.resolveAssociations({
       include
     }, rootDirectoryUrl);
 
     getIncludeInfo = url => {
-      const meta = urlToMeta({
+      const {
+        include
+      } = URL_META.applyAssociations({
         url,
-        structuredMetaMap: includeMetaMap
+        associations
       });
-      return meta.include;
+      return include;
     };
   }
 
@@ -530,7 +527,11 @@ const jsenvPluginUrlAnalysis = ({
     name: "jsenv:url_analysis",
     appliesDuring: "*",
     redirectUrl: reference => {
-      if (reference.specifier[0] === "#") {
+      if (reference.specifier[0] === "#" && // For Html, css and in general "#" refer to a ressource in the page
+      // so that urls must be kept intact
+      // However for js import specifiers they have a different meaning and we want
+      // to resolve them (https://nodejs.org/api/packages.html#imports for instance)
+      reference.type !== "js_import_export") {
         reference.shouldHandle = false;
         return;
       }
@@ -566,12 +567,12 @@ const jsenvPluginUrlAnalysis = ({
       directory: (urlInfo, context) => {
         const originalDirectoryReference = findOriginalDirectoryReference(urlInfo, context);
         const directoryRelativeUrl = urlToRelativeUrl(urlInfo.url, context.rootDirectoryUrl);
-        JSON.parse(urlInfo.content).forEach(directoryEntry => {
+        JSON.parse(urlInfo.content).forEach(directoryEntryName => {
           context.referenceUtils.found({
             type: "filesystem",
             subtype: "directory_entry",
-            specifier: directoryEntry,
-            trace: `"${directoryRelativeUrl}${directoryEntry}" entry in directory referenced by ${originalDirectoryReference.trace}`
+            specifier: directoryEntryName,
+            trace: `"${directoryRelativeUrl}${directoryEntryName}" entry in directory referenced by ${originalDirectoryReference.trace}`
           });
         });
       }
@@ -1106,36 +1107,33 @@ const jsenvPluginFileUrls = ({
         search,
         hash
       } = urlObject;
-
-      const resolveSymlink = fileUrl => {
-        const realPath = realpathSync(new URL(fileUrl));
-        const realFileUrl = `${pathToFileURL(realPath)}${search}${hash}`;
-        return realFileUrl;
-      };
-
       let {
         pathname
       } = urlObject;
       const pathnameUsesTrailingSlash = pathname.endsWith("/");
       urlObject.search = "";
-      urlObject.hash = ""; // force trailing slash on directories and remove eventual trailing slash on files
+      urlObject.hash = "";
+      const foundADirectory = stat && stat.isDirectory();
+      const foundSomething = stat && !foundADirectory; // force trailing slash on directories
 
-      if (stat && stat.isDirectory()) {
-        reference.expectedType = "directory";
+      if (foundADirectory && !pathnameUsesTrailingSlash) {
+        urlObject.pathname = `${pathname}/`;
+      } // otherwise remove trailing slash if any
 
-        if (!pathnameUsesTrailingSlash) {
-          urlObject.pathname = `${pathname}/`;
-        }
 
-        if (directoryReferenceAllowed) {
-          return preservesSymlink ? urlObject.href : resolveSymlink(urlObject.href);
-        } // give a chane to magic resolution if enabled
-
-      } else if (pathnameUsesTrailingSlash) {
-        // a warning would be great because it's strange to reference a file with a trailing slash
+      if (foundSomething && pathnameUsesTrailingSlash) {
+        // a warning here? (because it's strange to reference a file with a trailing slash)
         urlObject.pathname = pathname.slice(0, -1);
       }
 
+      if (foundADirectory && directoryReferenceAllowed) {
+        reference.data.foundADirectory = true;
+        const directoryFacadeUrl = urlObject.href;
+        const directoryUrlRaw = preservesSymlink ? directoryFacadeUrl : resolveSymlink(directoryFacadeUrl);
+        const directoryUrl = `${directoryUrlRaw}${search}${hash}`;
+        return directoryUrl;
+      }
+
       const url = urlObject.href;
       const filesystemResolution = applyFileSystemMagicResolution(url, {
         fileStat: stat,
@@ -1144,12 +1142,15 @@ const jsenvPluginFileUrls = ({
       });
 
       if (!filesystemResolution.found) {
+        reference.data.foundADirectory = foundADirectory;
         return null;
       }
 
-      const fileUrlRaw = filesystemResolution.url;
+      reference.data.foundADirectory = filesystemResolution.isDirectory;
+      const fileFacadeUrl = filesystemResolution.url;
+      const fileUrlRaw = preservesSymlink ? fileFacadeUrl : resolveSymlink(fileFacadeUrl);
       const fileUrl = `${fileUrlRaw}${search}${hash}`;
-      return preservesSymlink ? fileUrl : resolveSymlink(fileUrl);
+      return fileUrl;
     }
   }, {
     name: "jsenv:filesystem_resolution",
@@ -1203,19 +1204,28 @@ const jsenvPluginFileUrls = ({
 
       const urlObject = new URL(urlInfo.url);
 
-      if (context.reference.expectedType === "directory") {
+      if (context.reference.data.foundADirectory) {
         if (directoryReferenceAllowed) {
           const directoryEntries = readdirSync(urlObject);
+          let filename;
+
+          if (context.reference.type === "filesystem") {
+            const parentUrlInfo = context.urlGraph.getUrlInfo(context.reference.parentUrl);
+            filename = `${parentUrlInfo.filename}${context.reference.specifier}/`;
+          } else {
+            filename = `${urlToFilename(urlInfo.url)}/`;
+          }
+
           return {
             type: "directory",
             contentType: "application/json",
             content: JSON.stringify(directoryEntries, null, "  "),
-            filename: urlToRelativeUrl(ensurePathnameTrailingSlash(urlInfo.url), context.rootDirectoryUrl)
+            filename
           };
         }
 
         const error = new Error("found a directory on filesystem");
-        error.code = "EISDIR";
+        error.code = "DIRECTORY_REFERENCE_NOT_ALLOWED";
         throw error;
       }
 
@@ -1237,6 +1247,10 @@ const jsenvPluginFileUrls = ({
   }];
 };
 
+const resolveSymlink = fileUrl => {
+  return pathToFileURL(realpathSync(new URL(fileUrl))).href;
+};
+
 const jsenvPluginHttpUrls = () => {
   return {
     name: "jsenv:http_urls",
@@ -1422,7 +1436,7 @@ const jsenvPluginJsInlineContent = ({
   const parseAndTransformInlineContentCalls = async (urlInfo, context) => {
     const inlineContentInfos = await parseJsInlineContentInfos({
       js: urlInfo.content,
-      url: urlInfo.data && urlInfo.data.rawUrl || urlInfo.url,
+      url: urlInfo.originalUrl,
       isJsModule: urlInfo.type === "js_module"
     });
 
@@ -1508,7 +1522,7 @@ const parseJsInlineContentInfos = async ({
   } = await applyBabelPlugins({
     babelPlugins: [babelPluginMetadataInlineContents],
     urlInfo: {
-      url,
+      originalUrl: url,
       type: isJsModule ? "js_module" : "js_classic",
       content: js
     }
@@ -2615,7 +2629,7 @@ const jsenvPluginAsModules = () => {
     name: `jsenv:as_json_module`,
     appliesDuring: "*",
     fetchUrlContent: async (urlInfo, context) => {
-      const originalUrlInfo = await fetchOriginalUrlInfo({
+      const originalUrlInfo = await context.fetchOriginalUrlInfo({
         urlInfo,
         context,
         searchParam: "as_json_module",
@@ -2628,6 +2642,8 @@ const jsenvPluginAsModules = () => {
 
       const jsonText = JSON.stringify(originalUrlInfo.content.trim());
       return {
+        originalUrl: originalUrlInfo.originalUrl,
+        originalContent: originalUrlInfo.originalContent,
         type: "js_module",
         contentType: "text/javascript",
         // here we could `export default ${jsonText}`:
@@ -2641,7 +2657,7 @@ const jsenvPluginAsModules = () => {
     name: `jsenv:as_css_module`,
     appliesDuring: "*",
     fetchUrlContent: async (urlInfo, context) => {
-      const originalUrlInfo = await fetchOriginalUrlInfo({
+      const originalUrlInfo = await context.fetchOriginalUrlInfo({
         urlInfo,
         context,
         searchParam: "as_css_module",
@@ -2659,6 +2675,8 @@ const jsenvPluginAsModules = () => {
         canUseTemplateString: true
       });
       return {
+        originalUrl: originalUrlInfo.originalUrl,
+        originalContent: originalUrlInfo.originalContent,
         type: "js_module",
         contentType: "text/javascript",
         content: `import { InlineContent } from ${JSON.stringify(inlineContentClientFileUrl)}
@@ -2674,7 +2692,7 @@ const jsenvPluginAsModules = () => {
     name: `jsenv:as_text_module`,
     appliesDuring: "*",
     fetchUrlContent: async (urlInfo, context) => {
-      const originalUrlInfo = await fetchOriginalUrlInfo({
+      const originalUrlInfo = await context.fetchOriginalUrlInfo({
         urlInfo,
         context,
         searchParam: "as_text_module",
@@ -2692,6 +2710,8 @@ const jsenvPluginAsModules = () => {
         canUseTemplateString: true
       });
       return {
+        originalUrl: originalUrlInfo.originalUrl,
+        originalContent: originalUrlInfo.originalContent,
         type: "js_module",
         contentType: "text/javascript",
         content: `import { InlineContent } from ${JSON.stringify(inlineContentClientFileUrl)}
@@ -2707,7 +2727,7 @@ export default inlineContent.text`
 // https://github.com/babel/babel/blob/99f4f6c3b03c7f3f67cf1b9f1a21b80cfd5b0224/packages/babel-core/src/tools/build-external-helpers.js
 // the list of possible helpers:
 // https://github.com/babel/babel/blob/99f4f6c3b03c7f3f67cf1b9f1a21b80cfd5b0224/packages/babel-helpers/src/helpers.js#L13
-const babelHelperClientDirectoryUrl = new URL("./node_modules/@jsenv/babel-plugins/src/babel_helpers/", import.meta.url).href; // we cannot use "@jsenv/core/src/*" because babel helper might be injected
+const babelHelperClientDirectoryUrl = new URL("./babel_helpers/", import.meta.url).href; // we cannot use "@jsenv/core/src/*" because babel helper might be injected
 // into node_modules not depending on "@jsenv/core"
 
 const getBabelHelperFileUrl = babelHelperName => {
@@ -3167,7 +3187,7 @@ const jsenvPluginAsJsClassicConversion = ({
       }
     },
     fetchUrlContent: async (urlInfo, context) => {
-      const originalUrlInfo = await fetchOriginalUrlInfo({
+      const originalUrlInfo = await context.fetchOriginalUrlInfo({
         urlInfo,
         context,
         searchParam: "as_js_classic",
@@ -3203,6 +3223,8 @@ const jsenvPluginAsJsClassicConversion = ({
       });
       urlInfo.data.jsClassicFormat = jsClassicFormat;
       return {
+        originalUrl: originalUrlInfo.originalUrl,
+        originalContent: originalUrlInfo.originalContent,
         type: "js_classic",
         contentType: "text/javascript",
         content,
@@ -3256,6 +3278,8 @@ const convertJsModuleToJsClassic = async ({
     }], babelPluginTransformImportMetaUrl, require$3("@babel/plugin-transform-modules-umd")])],
     urlInfo
   });
+  let sourcemap = urlInfo.sourcemap;
+  sourcemap = await composeTwoSourcemaps(sourcemap, map);
 
   if (systemJsInjection && jsClassicFormat === "system" && isJsEntryPoint) {
     const magicSource = createMagicSource(code);
@@ -3263,19 +3287,17 @@ const convertJsModuleToJsClassic = async ({
       as: "string"
     });
     magicSource.prepend(`${systemjsCode}\n\n`);
-    const {
-      content,
-      sourcemap
-    } = magicSource.toContentAndSourcemap();
+    const magicResult = magicSource.toContentAndSourcemap();
+    sourcemap = await composeTwoSourcemaps(sourcemap, magicResult.sourcemap);
     return {
-      content,
-      sourcemap: await composeTwoSourcemaps(map, sourcemap)
+      content: magicResult.content,
+      sourcemap
     };
   }
 
   return {
     content: code,
-    sourcemap: map
+    sourcemap
   };
 };
 
@@ -4834,14 +4856,14 @@ const rollupPluginJsenv = ({
   let importCanBeBundled = () => true;
 
   if (include) {
-    const bundleIncludeConfig = normalizeStructuredMetaMap({
+    const associations = URL_META.resolveAssociations({
       bundle: include
     }, rootDirectoryUrl);
 
     importCanBeBundled = url => {
-      return urlToMeta({
+      return URL_META.applyAssociations({
         url,
-        structuredMetaMap: bundleIncludeConfig
+        associations
       }).bundle;
     };
   }
@@ -6340,8 +6362,9 @@ const createUrlInfo = url => {
     contentType: "",
     // "text/html", "text/css", "text/javascript", "application/json", ...
     url,
-    filename: "",
+    originalUrl: undefined,
     generatedUrl: null,
+    filename: "",
     isInline: false,
     inlineUrlSite: null,
     shouldHandle: undefined,
@@ -6685,7 +6708,7 @@ const createUrlInfoTransformer = ({
     sourcemapsSourcesContent || urlInfo.isInline || sourcemap.sources && sourcemap.sources.some(source => !source || !source.startsWith("file:"));
 
     if (sourcemap.sources && sourcemap.sources.length > 1) {
-      sourcemap.sources = sourcemap.sources.map(source => new URL(source, urlInfo.data.rawUrl || urlInfo.url).href);
+      sourcemap.sources = sourcemap.sources.map(source => new URL(source, urlInfo.originalUrl).href);
 
       if (!wantSourcesContent) {
         sourcemap.sourcesContent = undefined;
@@ -6694,7 +6717,7 @@ const createUrlInfoTransformer = ({
       return sourcemap;
     }
 
-    sourcemap.sources = [urlInfo.data.rawUrl || urlInfo.url];
+    sourcemap.sources = [urlInfo.originalUrl];
     sourcemap.sourcesContent = [urlInfo.originalContent];
 
     if (!wantSourcesContent) {
@@ -6730,6 +6753,7 @@ const createUrlInfoTransformer = ({
     sourcemapUrlInfo.isInline = sourcemaps === "inline"; // already loaded during "load" hook (happens during build)
 
     if (urlInfo.sourcemap) {
+      urlInfo.sourcemap = normalizeSourcemap(urlInfo, urlInfo.sourcemap);
       return;
     } // check for existing sourcemap for this content
 
@@ -6758,8 +6782,9 @@ const createUrlInfoTransformer = ({
         await context.cook(sourcemapUrlInfo, {
           reference: sourcemapReference
         });
-        const sourcemap = JSON.parse(sourcemapUrlInfo.content);
-        urlInfo.sourcemap = normalizeSourcemap(urlInfo, sourcemap);
+        const sourcemapRaw = JSON.parse(sourcemapUrlInfo.content);
+        const sourcemap = normalizeSourcemap(urlInfo, sourcemapRaw);
+        urlInfo.sourcemap = sourcemap;
       } catch (e) {
         logger.error(`Error while handling existing sourcemap: ${e.message}`);
         return;
@@ -6818,7 +6843,7 @@ const createUrlInfoTransformer = ({
       if (sourcemapsRelativeSources) {
         sourcemap.sources = sourcemap.sources.map(source => {
           const sourceRelative = urlToRelativeUrl(source, urlInfo.url);
-          return sourceRelative;
+          return sourceRelative || ".";
         });
       }
 
@@ -6835,6 +6860,9 @@ const createUrlInfoTransformer = ({
           specifier: sourcemaps === "file" && sourcemapsRelativeSources ? urlToRelativeUrl(sourcemapReference.url, urlInfo.url) : sourcemapReference.generatedSpecifier
         });
       }
+    } else if (urlInfo.sourcemapReference) {
+      // in the end we don't use the sourcemap placeholder
+      urlGraph.deleteUrlInfo(urlInfo.sourcemapReference.url);
     }
 
     urlInfo.contentEtag = bufferToEtag(Buffer.from(urlInfo.content));
@@ -6912,9 +6940,9 @@ const createFetchUrlContentError = ({
     });
   }
 
-  if (error.code === "EISDIR") {
+  if (error.code === "DIRECTORY_REFERENCE_NOT_ALLOWED") {
     return createFailedToFetchUrlContentError({
-      code: "EISDIR",
+      code: "DIRECTORY_REFERENCE_NOT_ALLOWED",
       reason: `found a directory on filesystem`
     });
   }
@@ -7280,6 +7308,7 @@ const createKitchen = ({
         type,
         subtype,
         contentType = "application/octet-stream",
+        originalUrl,
         originalContent,
         content,
         sourcemap,
@@ -7294,8 +7323,9 @@ const createKitchen = ({
         type: urlInfo.type,
         subtype: urlInfo.subtype
       });
-      urlInfo.contentType = contentType; // during build urls info are reused and load returns originalContent
+      urlInfo.contentType = contentType; // during build urls info are reused and load returns originalUrl/originalContent
 
+      urlInfo.originalUrl = originalUrl || urlInfo.originalUrl;
       urlInfo.originalContent = originalContent === undefined ? content : originalContent;
       urlInfo.content = content;
       urlInfo.sourcemap = sourcemap;
@@ -7618,6 +7648,45 @@ const createKitchen = ({
     return [ref, urlInfo];
   };
 
+  const fetchOriginalUrlInfo = async ({
+    urlInfo,
+    context,
+    searchParam,
+    expectedType
+  }) => {
+    const urlObject = new URL(urlInfo.url);
+    const {
+      searchParams
+    } = urlObject;
+
+    if (!searchParams.has(searchParam)) {
+      return null;
+    }
+
+    searchParams.delete(searchParam);
+    const originalUrl = urlObject.href;
+    const originalReference = { ...(context.reference.original || context.reference),
+      expectedType
+    };
+    originalReference.url = originalUrl;
+    const originalUrlInfo = context.urlGraph.reuseOrCreateUrlInfo(originalReference.url);
+
+    if (originalUrlInfo.originalUrl === undefined) {
+      applyReferenceEffectsOnUrlInfo(originalReference, originalUrlInfo, context);
+    }
+
+    await context.fetchUrlContent(originalUrlInfo, {
+      reference: originalReference
+    });
+
+    if (originalUrlInfo.dependents.size === 0) {
+      context.urlGraph.deleteUrlInfo(originalUrlInfo.url);
+    }
+
+    return originalUrlInfo;
+  };
+
+  kitchenContext.fetchOriginalUrlInfo = fetchOriginalUrlInfo;
   return {
     pluginController,
     urlInfoTransformer,
@@ -7673,6 +7742,7 @@ const applyReferenceEffectsOnUrlInfo = (reference, urlInfo, context) => {
     urlInfo.shouldHandle = true;
   }
 
+  urlInfo.originalUrl = urlInfo.originalUrl || reference.url;
   Object.assign(urlInfo.data, reference.data);
   Object.assign(urlInfo.timing, reference.timing);
 
@@ -8061,7 +8131,7 @@ const createFileService = ({
         };
       }
 
-      if (code === "EISDIR") {
+      if (code === "DIRECTORY_REFERENCE_NOT_ALLOWED") {
         return serveDirectory(reference.url, {
           headers: {
             accept: "text/html"
@@ -8264,19 +8334,18 @@ const jsenvPluginExplorer = ({
         return null;
       }
 
-      const structuredMetaMapRelativeForExplorable = {};
+      const associationsForExplorable = {};
       Object.keys(groups).forEach(groupName => {
         const groupConfig = groups[groupName];
-        structuredMetaMapRelativeForExplorable[groupName] = {
+        associationsForExplorable[groupName] = {
           "**/.jsenv/": false,
           // avoid visting .jsenv directory in jsenv itself
           ...groupConfig
         };
       });
-      const structuredMetaMapForExplorable = normalizeStructuredMetaMap(structuredMetaMapRelativeForExplorable, rootDirectoryUrl);
       const matchingFileResultArray = await collectFiles({
         directoryUrl: rootDirectoryUrl,
-        structuredMetaMap: structuredMetaMapForExplorable,
+        associations: associationsForExplorable,
         predicate: meta => Object.keys(meta).some(group => Boolean(meta[group]))
       });
       const files = matchingFileResultArray.map(({
@@ -8287,7 +8356,7 @@ const jsenvPluginExplorer = ({
         meta
       }));
       let html = String(readFileSync(new URL(htmlClientFileUrl)));
-      html = html.replace("FAVICON_HREF", DataUrl.stringify({
+      html = html.replace("virtual:FAVICON_HREF", DataUrl.stringify({
         contentType: CONTENT_TYPE.fromUrlExtension(faviconClientFileUrl),
         base64Flag: true,
         data: readFileSync(new URL(faviconClientFileUrl)).toString("base64")
@@ -8753,13 +8822,12 @@ const generateExecutionSteps = async (plan, {
   signal,
   rootDirectoryUrl
 }) => {
-  const structuredMetaMap = {
-    filePlan: plan
-  };
   const fileResultArray = await collectFiles({
     signal,
     directoryUrl: rootDirectoryUrl,
-    structuredMetaMap,
+    associations: {
+      filePlan: plan
+    },
     predicate: ({
       filePlan
     }) => filePlan
@@ -9220,7 +9288,7 @@ const executePlan = async (plan, {
     const executionSpinner = !debugLogsEnabled && executionLogsEnabled && process.stdout.isTTY && // if there is an error during execution npm will mess up the output
     // (happens when npm runs several command in a workspace)
     // so we enable spinner only when !process.exitCode (no error so far)
-    !process.exitCode;
+    process.exitCode !== 1;
     const startMs = Date.now();
     const report = {};
     let rawOutput = "";
@@ -9234,15 +9302,18 @@ const executePlan = async (plan, {
     const coverageTempDirectoryUrl = new URL(coverageTempDirectoryRelativeUrl, rootDirectoryUrl).href;
 
     if (coverage) {
-      const structuredMetaMapForCover = normalizeStructuredMetaMap({
+      const associations = URL_META.resolveAssociations({
         cover: coverageConfig
       }, rootDirectoryUrl);
 
       const urlShouldBeCovered = url => {
-        return urlToMeta({
+        const {
+          cover
+        } = URL_META.applyAssociations({
           url: new URL(url, rootDirectoryUrl).href,
-          structuredMetaMap: structuredMetaMapForCover
-        }).cover;
+          associations
+        });
+        return cover;
       };
 
       runtimeParams.urlShouldBeCovered = urlShouldBeCovered; // in case runned multiple times, we don't want to keep writing lot of files in this directory
@@ -9705,17 +9776,20 @@ const executeTestPlan = async ({
     }
 
     if (!coverageAndExecutionAllowed) {
-      const structuredMetaMapForExecute = normalizeStructuredMetaMap({
+      const associationsForExecute = URL_META.resolveAssociations({
         execute: testPlan
       }, "file:///");
-      const structuredMetaMapForCover = normalizeStructuredMetaMap({
+      const associationsForCover = URL_META.resolveAssociations({
         cover: coverageConfig
       }, "file:///");
-      const patternsMatchingCoverAndExecute = Object.keys(structuredMetaMapForExecute.execute).filter(testPlanPattern => {
-        return urlToMeta({
+      const patternsMatchingCoverAndExecute = Object.keys(associationsForExecute.execute).filter(testPlanPattern => {
+        const {
+          cover
+        } = URL_META.applyAssociations({
           url: testPlanPattern,
-          structuredMetaMap: structuredMetaMapForCover
-        }).cover;
+          associations: associationsForCover
+        });
+        return cover;
       });
 
       if (patternsMatchingCoverAndExecute.length) {
@@ -11737,7 +11811,7 @@ const resyncRessourceHints = async ({
         }
 
         if (urlInfo.dependents.size === 0) {
-          logger.warn(`remove ressource hint because "${href}" not used anymore`);
+          logger.info(`remove ressource hint because "${href}" not used anymore`);
           actions.push(() => {
             removeHtmlNode(linkNode);
           });
@@ -11833,6 +11907,7 @@ const build = async ({
   },
   plugins = [],
   sourcemaps = false,
+  sourcemapsSourcesContent,
   urlAnalysis = {},
   nodeEsmResolution,
   fileSystemMagicResolution,
@@ -11915,6 +11990,7 @@ build ${entryPointKeys.length} entry points`);
       urlGraph: rawGraph,
       scenario: "build",
       sourcemaps,
+      sourcemapsSourcesContent,
       runtimeCompat,
       writeGeneratedFiles,
       plugins: [...plugins, {
@@ -12115,6 +12191,8 @@ build ${entryPointKeys.length} entry points`);
             type,
             subtype: rawUrlInfo ? rawUrlInfo.subtype : undefined,
             filename: rawUrlInfo ? rawUrlInfo.filename : undefined,
+            originalUrl: rawUrlInfo ? rawUrlInfo.originalUrl : undefined,
+            originalContent: rawUrlInfo ? rawUrlInfo.originalContent : undefined,
             ...bundlerGeneratedUrlInfo,
             data: { ...(rawUrlInfo ? rawUrlInfo.data : {}),
               ...bundlerGeneratedUrlInfo.data,
@@ -12160,6 +12238,7 @@ build ${entryPointKeys.length} entry points`);
       urlGraph: finalGraph,
       scenario: "build",
       sourcemaps,
+      sourcemapsSourcesContent,
       sourcemapsRelativeSources: !versioning,
       runtimeCompat,
       writeGeneratedFiles,
@@ -12315,12 +12394,12 @@ build ${entryPointKeys.length} entry points`);
               urlInfo: rawUrlInfo,
               parentUrlInfo
             });
+            rawUrls[buildUrl] = rawUrlInfo.url;
 
             if (buildUrl.includes("?")) {
               rawUrls[asUrlWithoutSearch(buildUrl)] = rawUrlInfo.url;
             }
 
-            rawUrls[buildUrl] = rawUrlInfo.url;
             return buildUrl;
           }
 
@@ -12491,6 +12570,7 @@ ${Object.keys(finalGraph.urlInfos).join("\n")}`);
         baseUrl,
         postBuildEntryUrls,
         sourcemaps,
+        sourcemapsSourcesContent,
         runtimeCompat,
         writeGeneratedFiles,
         rawGraph,
@@ -12718,6 +12798,7 @@ const applyUrlVersioning = async ({
   baseUrl,
   postBuildEntryUrls,
   sourcemaps,
+  sourcemapsSourcesContent,
   runtimeCompat,
   writeGeneratedFiles,
   rawGraph,
@@ -12820,6 +12901,7 @@ const applyUrlVersioning = async ({
       urlGraph: finalGraph,
       scenario: "build",
       sourcemaps,
+      sourcemapsSourcesContent,
       sourcemapsRelativeSources: true,
       runtimeCompat,
       writeGeneratedFiles,
@@ -12858,6 +12940,14 @@ const applyUrlVersioning = async ({
           return url;
         },
         formatUrl: reference => {
+          if (!reference.shouldHandle) {
+            if (reference.generatedUrl.startsWith("ignore:")) {
+              return reference.generatedUrl.slice("ignore:".length);
+            }
+
+            return null;
+          }
+
           if (reference.isInline || reference.url.startsWith("data:")) {
             return null;
           }