@jsenv/core 40.1.6 → 40.2.0

package/dist/build/build.js

@@ -1,7 +1,7 @@
 import { parseHtml, injectHtmlNodeAsEarlyAsPossible, createHtmlNode, stringifyHtmlAst, applyBabelPlugins, generateUrlForInlineContent, parseJsWithAcorn, visitHtmlNodes, analyzeScriptNode, getHtmlNodeText, getHtmlNodeAttribute, getHtmlNodePosition, getUrlForContentInsideHtml, setHtmlNodeAttributes, setHtmlNodeText, parseCssUrls, getHtmlNodeAttributePosition, parseSrcSet, removeHtmlNodeText, parseJsUrls, getUrlForContentInsideJs, analyzeLinkNode, injectJsenvScript, findHtmlNode, removeHtmlNode, insertHtmlNodeAfter } from "@jsenv/ast";
 import { memoryUsage } from "node:process";
 import { readFileSync, existsSync, readdirSync, lstatSync, realpathSync } from "node:fs";
-import { lookupPackageDirectory$1 as lookupPackageDirectory, registerDirectoryLifecycle$1 as registerDirectoryLifecycle, urlToRelativeUrl$1 as urlToRelativeUrl, createDetailedMessage$1 as createDetailedMessage, stringifyUrlSite$1 as stringifyUrlSite, generateContentFrame$1 as generateContentFrame, validateResponseIntegrity$1 as validateResponseIntegrity, urlIsInsideOf$1 as urlIsInsideOf, ensureWindowsDriveLetter$1 as ensureWindowsDriveLetter, setUrlFilename$1 as setUrlFilename, moveUrl$1 as moveUrl, getCallerPosition$1 as getCallerPosition, urlToBasename$1 as urlToBasename, urlToExtension$1 as urlToExtension, asSpecifierWithoutSearch$1 as asSpecifierWithoutSearch, asUrlWithoutSearch$1 as asUrlWithoutSearch, injectQueryParamsIntoSpecifier$1 as injectQueryParamsIntoSpecifier, bufferToEtag$1 as bufferToEtag, isFileSystemPath$1 as isFileSystemPath, urlToPathname$1 as urlToPathname, setUrlBasename$1 as setUrlBasename, urlToFileSystemPath$1 as urlToFileSystemPath, writeFileSync$1 as writeFileSync, createLogger$1 as createLogger, URL_META$1 as URL_META, applyNodeEsmResolution$1 as applyNodeEsmResolution, RUNTIME_COMPAT$1 as RUNTIME_COMPAT, normalizeUrl$1 as normalizeUrl, ANSI$1 as ANSI, CONTENT_TYPE$1 as CONTENT_TYPE, urlToFilename$1 as urlToFilename, DATA_URL$1 as DATA_URL, normalizeImportMap$1 as normalizeImportMap, composeTwoImportMaps$1 as composeTwoImportMaps, resolveImport$1 as resolveImport, JS_QUOTES$1 as JS_QUOTES, defaultLookupPackageScope$1 as defaultLookupPackageScope, defaultReadPackageJson$1 as defaultReadPackageJson, readCustomConditionsFromProcessArgs$1 as readCustomConditionsFromProcessArgs, readEntryStatSync$1 as readEntryStatSync, ensurePathnameTrailingSlash$1 as ensurePathnameTrailingSlash, compareFileUrls$1 as compareFileUrls, applyFileSystemMagicResolution$1 as applyFileSystemMagicResolution, getExtensionsToTry$1 as getExtensionsToTry, setUrlExtension$1 as setUrlExtension, jsenvPluginTranspilation$1 as jsenvPluginTranspilation, renderDetails, humanizeDuration, humanizeFileSize, renderTable, renderBigSection, distributePercentages, humanizeMemory, comparePathnames, UNICODE, escapeRegexpSpecialChars, injectQueryParamIntoSpecifierWithoutEncoding, renderUrlOrRelativeUrlFilename, assertAndNormalizeDirectoryUrl$1 as assertAndNormalizeDirectoryUrl, Abort, raceProcessTeardownEvents, startMonitoringCpuUsage, startMonitoringMemoryUsage, inferRuntimeCompatFromClosestPackage, browserDefaultRuntimeCompat, nodeDefaultRuntimeCompat, clearDirectorySync, createTaskLog$1 as createTaskLog, jsenvPluginBundling, jsenvPluginMinification, ensureEmptyDirectory, jsenvPluginJsModuleFallback, createDynamicLog } from "../jsenv_core_packages.js";
+import { lookupPackageDirectory$1 as lookupPackageDirectory, registerDirectoryLifecycle$1 as registerDirectoryLifecycle, urlToRelativeUrl$1 as urlToRelativeUrl, createDetailedMessage$1 as createDetailedMessage, stringifyUrlSite$1 as stringifyUrlSite, generateContentFrame$1 as generateContentFrame, validateResponseIntegrity$1 as validateResponseIntegrity, urlIsInsideOf$1 as urlIsInsideOf, ensureWindowsDriveLetter$1 as ensureWindowsDriveLetter, setUrlFilename$1 as setUrlFilename, moveUrl$1 as moveUrl, getCallerPosition$1 as getCallerPosition, urlToBasename$1 as urlToBasename, urlToExtension$1 as urlToExtension, asSpecifierWithoutSearch$1 as asSpecifierWithoutSearch, asUrlWithoutSearch$1 as asUrlWithoutSearch, injectQueryParamsIntoSpecifier$1 as injectQueryParamsIntoSpecifier, bufferToEtag$1 as bufferToEtag, isFileSystemPath$1 as isFileSystemPath, urlToPathname$1 as urlToPathname, setUrlBasename$1 as setUrlBasename, urlToFileSystemPath$1 as urlToFileSystemPath, writeFileSync$1 as writeFileSync, createLogger$1 as createLogger, URL_META$1 as URL_META, applyNodeEsmResolution$1 as applyNodeEsmResolution, RUNTIME_COMPAT$1 as RUNTIME_COMPAT, normalizeUrl$1 as normalizeUrl, ANSI$1 as ANSI, CONTENT_TYPE$1 as CONTENT_TYPE, urlToFilename$1 as urlToFilename, DATA_URL$1 as DATA_URL, normalizeImportMap$1 as normalizeImportMap, composeTwoImportMaps$1 as composeTwoImportMaps, resolveImport$1 as resolveImport, JS_QUOTES$1 as JS_QUOTES, defaultLookupPackageScope$1 as defaultLookupPackageScope, defaultReadPackageJson$1 as defaultReadPackageJson, readCustomConditionsFromProcessArgs$1 as readCustomConditionsFromProcessArgs, readEntryStatSync$1 as readEntryStatSync, ensurePathnameTrailingSlash$1 as ensurePathnameTrailingSlash, compareFileUrls$1 as compareFileUrls, applyFileSystemMagicResolution$1 as applyFileSystemMagicResolution, getExtensionsToTry$1 as getExtensionsToTry, setUrlExtension$1 as setUrlExtension, jsenvPluginTranspilation$1 as jsenvPluginTranspilation, renderDetails, humanizeDuration, humanizeFileSize, renderTable, renderBigSection, distributePercentages, humanizeMemory, comparePathnames, UNICODE, escapeRegexpSpecialChars, injectQueryParamIntoSpecifierWithoutEncoding, renderUrlOrRelativeUrlFilename, assertAndNormalizeDirectoryUrl$1 as assertAndNormalizeDirectoryUrl, Abort, raceProcessTeardownEvents, startMonitoringCpuUsage, startMonitoringMemoryUsage, readPackageAtOrNull, inferRuntimeCompatFromClosestPackage, browserDefaultRuntimeCompat, nodeDefaultRuntimeCompat, clearDirectorySync, createTaskLog$1 as createTaskLog, jsenvPluginBundling, jsenvPluginMinification, ensureEmptyDirectory, jsenvPluginJsModuleFallback, createDynamicLog } from "../jsenv_core_packages.js";
 import { pathToFileURL } from "node:url";
 import { generateSourcemapFileUrl, createMagicSource, composeTwoSourcemaps, generateSourcemapDataUrl, SOURCEMAP } from "@jsenv/sourcemap";
 import { performance } from "node:perf_hooks";
@@ -8122,7 +8122,7 @@ const jsenvPluginChromeDevtoolsJson = () => {
     appliesDuring: "dev",
     devServerRoutes: [
       {
-        route: "GET /.well-known/appspecific/com.chrome.devtools.json",
+        endpoint: "GET /.well-known/appspecific/com.chrome.devtools.json",
         fetch: (request, { kitchen }) => {
           const { rootDirectoryUrl } = kitchen.context;
           return Response.json({
@@ -8137,6 +8137,39 @@ const jsenvPluginChromeDevtoolsJson = () => {
   };
 };
 
+const jsenvPluginAutoreloadOnServerRestart = () => {
+  const autoreloadOnRestartClientFileUrl = import.meta.resolve(
+    "@jsenv/server/src/services/autoreload_on_server_restart/client/autoreload_on_server_restart.js",
+  );
+
+  return {
+    name: "jsenv:autoreload_on_server_restart",
+    appliesDuring: "dev",
+    transformUrlContent: {
+      html: (urlInfo) => {
+        // we should not do this for inspector and 4xx.html
+        const htmlAst = parseHtml({
+          html: urlInfo.content,
+          url: urlInfo.url,
+        });
+        const autoreloadOnRestartClientFileReference =
+          urlInfo.dependencies.inject({
+            type: "script",
+            subtype: "js_classic",
+            expectedType: "js_classic",
+            specifier: autoreloadOnRestartClientFileUrl,
+          });
+        injectJsenvScript(htmlAst, {
+          "src": autoreloadOnRestartClientFileReference.generatedSpecifier,
+          "pluginName": "jsenv:autoreload_on_server_restart",
+          "data-ws-endpoint": "/.internal/events.websocket",
+        });
+        return stringifyHtmlAst(htmlAst);
+      },
+    },
+  };
+};
+
 // tslint:disable:ordered-imports
 
 
@@ -8160,6 +8193,7 @@ const getCorePlugins = ({
   http = false,
 
   clientAutoreload,
+  clientAutoreloadOnServerRestart,
   cacheControl,
   scenarioPlaceholders = true,
   ribbon = true,
@@ -8229,6 +8263,9 @@ const getCorePlugins = ({
 
     // "jsenvPluginSupervisor" MUST be after "jsenvPluginInlining" as it needs inline script to be cooked
     ...(supervisor ? [jsenvPluginSupervisor(supervisor)] : []),
+    ...(clientAutoreloadOnServerRestart
+      ? [jsenvPluginAutoreloadOnServerRestart()]
+      : []),
 
     jsenvPluginCommonJsGlobals(),
     jsenvPluginImportMetaScenarios(),
@@ -8669,6 +8706,7 @@ const createBuildSpecifierManager = ({
   versioningMethod,
   versionLength,
   canUseImportmap,
+  onSourceFileBuild,
 }) => {
   const placeholderAPI = createPlaceholderAPI({
     length,
@@ -8680,18 +8718,18 @@ const createBuildSpecifierManager = ({
 
   const generateReplacement = (reference) => {
     let buildUrl;
+    const buildUrlInfo = reference.urlInfo;
     if (reference.type === "sourcemap_comment") {
       const parentBuildUrl = urlInfoToBuildUrlMap.get(reference.ownerUrlInfo);
       buildUrl = generateSourcemapFileUrl(parentBuildUrl);
       reference.generatedSpecifier = buildUrl;
     } else {
       const url = reference.generatedUrl;
-      let urlInfo;
       const rawUrlInfo = rawKitchen.graph.getUrlInfo(reference.url);
+      let urlInfo;
       if (rawUrlInfo) {
         urlInfo = rawUrlInfo;
       } else {
-        const buildUrlInfo = reference.urlInfo;
         buildUrlInfo.type = reference.expectedType || "asset";
         buildUrlInfo.subtype = reference.expectedSubtype;
         urlInfo = buildUrlInfo;
@@ -8735,6 +8773,31 @@ const createBuildSpecifierManager = ({
       buildSpecifier,
       reference,
     );
+
+    if (buildUrlInfo.sourceUrls) {
+      for (const sourceUrl of buildUrlInfo.sourceUrls) {
+        const rawUrlInfo = rawKitchen.graph.getUrlInfo(sourceUrl);
+        if (rawUrlInfo) {
+          onSourceFileBuild({
+            sourceUrlInfo: rawUrlInfo,
+            buildUrlInfo,
+            sourceFileUrl: rawUrlInfo.url,
+            buildFileUrl: buildUrl,
+          });
+        }
+      }
+    } else if (buildUrlInfo.originalUrl) {
+      const rawUrlInfo = rawKitchen.graph.getUrlInfo(buildUrlInfo.originalUrl);
+      if (rawUrlInfo) {
+        onSourceFileBuild({
+          sourceUrlInfo: rawUrlInfo,
+          buildUrlInfo,
+          sourceFileUrl: rawUrlInfo.url,
+          buildFileUrl: buildUrl,
+        });
+      }
+    }
+
     return buildGeneratedSpecifier;
   };
   const internalRedirections = new Map();
@@ -8911,6 +8974,7 @@ const createBuildSpecifierManager = ({
         if (!finalUrlInfo.filenameHint && bundleInfo.data.bundleRelativeUrl) {
           finalUrlInfo.filenameHint = bundleInfo.data.bundleRelativeUrl;
         }
+        finalUrlInfo.sourceUrls = bundleInfo.sourceUrls;
         return {
           // url: bundleInfo.url,
           originalUrl: bundleInfo.originalUrl,
@@ -8923,6 +8987,7 @@ const createBuildSpecifierManager = ({
       }
       const rawUrlInfo = rawKitchen.graph.getUrlInfo(rawUrl);
       if (rawUrlInfo) {
+        // if the rawUrl info had
         if (rawUrlInfo.type === "entry_build") {
           const otherEntryBuildInfo = rawUrlInfo.otherEntryBuildInfo;
           if (
@@ -10697,6 +10762,67 @@ const build = async ({
     const startDate = Date.now();
     const { onBuildEnd, onEntryPointBuildStart } = startBuildLogs();
 
+    const sourceFileBuildCallbackMap = new Map();
+    const registerSourceFileBuildEffect = (url, callback) => {
+      const buildCallbackSet = sourceFileBuildCallbackMap.get(url);
+      if (buildCallbackSet) {
+        buildCallbackSet.add(callback);
+      } else {
+        const set = new Set();
+        set.add(callback);
+        sourceFileBuildCallbackMap.set(url, set);
+      }
+    };
+    const onSourceFileBuild = ({ sourceFileUrl, buildFileUrl }) => {
+      const buildCallbackSet = sourceFileBuildCallbackMap.get(sourceFileUrl);
+      if (buildCallbackSet) {
+        for (const buildCallback of buildCallbackSet) {
+          buildCallback({ buildFileUrl });
+        }
+      }
+    };
+    sync_package_side_effects: {
+      if (!packageDirectoryUrl) {
+        break sync_package_side_effects;
+      }
+      const packageJson = readPackageAtOrNull(packageDirectoryUrl);
+      if (!packageJson) {
+        break sync_package_side_effects;
+      }
+      const { sideEffects } = packageJson;
+      if (!sideEffects || !Array.isArray(sideEffects)) {
+        break sync_package_side_effects;
+      }
+      const sideEffectFileUrlSet = new Set();
+      const packageJsonFileUrl = new URL("./package.json", packageDirectoryUrl)
+        .href;
+      for (const sideEffectFileRelativeUrl of sideEffects) {
+        const sideEffectFileUrl = new URL(
+          sideEffectFileRelativeUrl,
+          packageDirectoryUrl,
+        ).href;
+        sideEffectFileUrlSet.add(sideEffectFileUrl);
+        registerSourceFileBuildEffect(sideEffectFileUrl, ({ buildFileUrl }) => {
+          const urlRelativeToPackage = urlToRelativeUrl(
+            buildFileUrl,
+            packageDirectoryUrl,
+          );
+          if (sideEffectFileUrlSet.has(buildFileUrl)) {
+            return;
+          }
+          sideEffects.push(
+            urlRelativeToPackage[0] === "."
+              ? urlRelativeToPackage
+              : `./${urlRelativeToPackage}`,
+          );
+          writeFileSync(
+            packageJsonFileUrl,
+            JSON.stringify(packageJson, null, "  "),
+          );
+        });
+      }
+    }
+
     const buildUrlsGenerator = createBuildUrlsGenerator({
       sourceDirectoryUrl,
       buildDirectoryUrl,
@@ -10749,6 +10875,7 @@ const build = async ({
           sourceRelativeUrl: entryPoint.sourceRelativeUrl,
           buildUrlsGenerator,
           someEntryPointUseNode,
+          onSourceFileBuild,
         },
         entryPoint.params,
       );
@@ -10832,12 +10959,10 @@ const build = async ({
     if (writeOnFileSystem) {
       clearDirectorySync(buildDirectoryUrl, buildDirectoryCleanPatterns);
       const buildRelativeUrls = Object.keys(buildFileContents);
-      buildRelativeUrls.forEach((buildRelativeUrl) => {
-        writeFileSync(
-          new URL(buildRelativeUrl, buildDirectoryUrl),
-          buildFileContents[buildRelativeUrl],
-        );
-      });
+      for (const buildRelativeUrl of buildRelativeUrls) {
+        const buildUrl = new URL(buildRelativeUrl, buildDirectoryUrl);
+        writeFileSync(buildUrl, buildFileContents[buildRelativeUrl]);
+      }
     }
     onBuildEnd({
       buildFileContents,
@@ -10973,6 +11098,7 @@ const prepareEntryPointBuild = async (
     outDirectoryUrl,
     buildUrlsGenerator,
     someEntryPointUseNode,
+    onSourceFileBuild,
   },
   entryPointParams,
 ) => {
@@ -11216,6 +11342,7 @@ const prepareEntryPointBuild = async (
           versioningViaImportmap &&
           rawKitchen.graph.getUrlInfo(entryReference.url).type === "html" &&
           rawKitchen.context.isSupportedOnCurrentClients("importmap"),
+        onSourceFileBuild,
       });
       const finalPluginStore = createPluginStore([
         jsenvPluginReferenceAnalysis({

package/dist/jsenv_core_packages.js

@@ -23677,4 +23677,4 @@ const assertAndNormalizeDirectoryUrl = (
   return value;
 };
 
-export { ANSI$2 as ANSI, ANSI$1, Abort$1 as Abort, Abort as Abort$1, CONTENT_TYPE$1 as CONTENT_TYPE, CONTENT_TYPE as CONTENT_TYPE$1, DATA_URL$1 as DATA_URL, DATA_URL as DATA_URL$1, JS_QUOTES$1 as JS_QUOTES, JS_QUOTES as JS_QUOTES$1, RUNTIME_COMPAT$1 as RUNTIME_COMPAT, RUNTIME_COMPAT as RUNTIME_COMPAT$1, UNICODE$1 as UNICODE, URL_META$1 as URL_META, URL_META as URL_META$1, applyFileSystemMagicResolution$1 as applyFileSystemMagicResolution, applyFileSystemMagicResolution as applyFileSystemMagicResolution$1, applyNodeEsmResolution$1 as applyNodeEsmResolution, applyNodeEsmResolution as applyNodeEsmResolution$1, asSpecifierWithoutSearch$1 as asSpecifierWithoutSearch, asSpecifierWithoutSearch as asSpecifierWithoutSearch$1, asUrlWithoutSearch$1 as asUrlWithoutSearch, asUrlWithoutSearch as asUrlWithoutSearch$1, assertAndNormalizeDirectoryUrl$2 as assertAndNormalizeDirectoryUrl, assertAndNormalizeDirectoryUrl$1, assertAndNormalizeDirectoryUrl as assertAndNormalizeDirectoryUrl$2, browserDefaultRuntimeCompat, bufferToEtag$1 as bufferToEtag, bufferToEtag as bufferToEtag$1, clearDirectorySync, compareFileUrls$1 as compareFileUrls, compareFileUrls as compareFileUrls$1, comparePathnames, composeTwoImportMaps$1 as composeTwoImportMaps, composeTwoImportMaps as composeTwoImportMaps$1, createDetailedMessage$3 as createDetailedMessage, createDetailedMessage$1, createDynamicLog$1 as createDynamicLog, createLogger$2 as createLogger, createLogger$1, createLogger as createLogger$2, createTaskLog$2 as createTaskLog, createTaskLog$1, createTaskLog as createTaskLog$2, defaultLookupPackageScope$1 as defaultLookupPackageScope, defaultLookupPackageScope as defaultLookupPackageScope$1, defaultReadPackageJson$1 as defaultReadPackageJson, defaultReadPackageJson as defaultReadPackageJson$1, distributePercentages, ensureEmptyDirectory, ensurePathnameTrailingSlash$2 as ensurePathnameTrailingSlash, ensurePathnameTrailingSlash$1, ensureWindowsDriveLetter$1 as ensureWindowsDriveLetter, ensureWindowsDriveLetter as ensureWindowsDriveLetter$1, escapeRegexpSpecialChars, generateContentFrame$1 as generateContentFrame, generateContentFrame as generateContentFrame$1, getCallerPosition$1 as getCallerPosition, getCallerPosition as getCallerPosition$1, getExtensionsToTry$1 as getExtensionsToTry, getExtensionsToTry as getExtensionsToTry$1, humanizeDuration$1 as humanizeDuration, humanizeFileSize, humanizeMemory, inferRuntimeCompatFromClosestPackage, injectQueryParamIntoSpecifierWithoutEncoding, injectQueryParamsIntoSpecifier$1 as injectQueryParamsIntoSpecifier, injectQueryParamsIntoSpecifier as injectQueryParamsIntoSpecifier$1, isFileSystemPath$2 as isFileSystemPath, isFileSystemPath$1, jsenvPluginBundling, jsenvPluginJsModuleFallback, jsenvPluginMinification, jsenvPluginTranspilation$1 as jsenvPluginTranspilation, jsenvPluginTranspilation as jsenvPluginTranspilation$1, lookupPackageDirectory$1 as lookupPackageDirectory, lookupPackageDirectory as lookupPackageDirectory$1, memoizeByFirstArgument, moveUrl$1 as moveUrl, moveUrl as moveUrl$1, nodeDefaultRuntimeCompat, normalizeImportMap$1 as normalizeImportMap, normalizeImportMap as normalizeImportMap$1, normalizeUrl$1 as normalizeUrl, normalizeUrl as normalizeUrl$1, raceProcessTeardownEvents$1 as raceProcessTeardownEvents, raceProcessTeardownEvents as raceProcessTeardownEvents$1, readCustomConditionsFromProcessArgs$1 as readCustomConditionsFromProcessArgs, readCustomConditionsFromProcessArgs as readCustomConditionsFromProcessArgs$1, readEntryStatSync$1 as readEntryStatSync, readEntryStatSync as readEntryStatSync$1, registerDirectoryLifecycle$1 as registerDirectoryLifecycle, registerDirectoryLifecycle as registerDirectoryLifecycle$1, renderBigSection, renderDetails, renderTable, renderUrlOrRelativeUrlFilename, resolveImport$1 as resolveImport, resolveImport as resolveImport$1, setUrlBasename$1 as setUrlBasename, setUrlBasename as setUrlBasename$1, setUrlExtension$1 as setUrlExtension, setUrlExtension as setUrlExtension$1, setUrlFilename$1 as setUrlFilename, setUrlFilename as setUrlFilename$1, startMonitoringCpuUsage, startMonitoringMemoryUsage, stringifyUrlSite$1 as stringifyUrlSite, stringifyUrlSite as stringifyUrlSite$1, urlIsInsideOf$1 as urlIsInsideOf, urlIsInsideOf as urlIsInsideOf$1, urlToBasename$1 as urlToBasename, urlToBasename as urlToBasename$1, urlToExtension$4 as urlToExtension, urlToExtension$2 as urlToExtension$1, urlToExtension as urlToExtension$2, urlToFileSystemPath$1 as urlToFileSystemPath, urlToFileSystemPath as urlToFileSystemPath$1, urlToFilename$3 as urlToFilename, urlToFilename$1, urlToPathname$4 as urlToPathname, urlToPathname$2 as urlToPathname$1, urlToPathname as urlToPathname$2, urlToRelativeUrl$1 as urlToRelativeUrl, urlToRelativeUrl as urlToRelativeUrl$1, validateResponseIntegrity$1 as validateResponseIntegrity, validateResponseIntegrity as validateResponseIntegrity$1, writeFileSync$1 as writeFileSync, writeFileSync as writeFileSync$1 };
+export { ANSI$2 as ANSI, ANSI$1, Abort$1 as Abort, Abort as Abort$1, CONTENT_TYPE$1 as CONTENT_TYPE, CONTENT_TYPE as CONTENT_TYPE$1, DATA_URL$1 as DATA_URL, DATA_URL as DATA_URL$1, JS_QUOTES$1 as JS_QUOTES, JS_QUOTES as JS_QUOTES$1, RUNTIME_COMPAT$1 as RUNTIME_COMPAT, RUNTIME_COMPAT as RUNTIME_COMPAT$1, UNICODE$1 as UNICODE, URL_META$1 as URL_META, URL_META as URL_META$1, applyFileSystemMagicResolution$1 as applyFileSystemMagicResolution, applyFileSystemMagicResolution as applyFileSystemMagicResolution$1, applyNodeEsmResolution$1 as applyNodeEsmResolution, applyNodeEsmResolution as applyNodeEsmResolution$1, asSpecifierWithoutSearch$1 as asSpecifierWithoutSearch, asSpecifierWithoutSearch as asSpecifierWithoutSearch$1, asUrlWithoutSearch$1 as asUrlWithoutSearch, asUrlWithoutSearch as asUrlWithoutSearch$1, assertAndNormalizeDirectoryUrl$2 as assertAndNormalizeDirectoryUrl, assertAndNormalizeDirectoryUrl$1, assertAndNormalizeDirectoryUrl as assertAndNormalizeDirectoryUrl$2, browserDefaultRuntimeCompat, bufferToEtag$1 as bufferToEtag, bufferToEtag as bufferToEtag$1, clearDirectorySync, compareFileUrls$1 as compareFileUrls, compareFileUrls as compareFileUrls$1, comparePathnames, composeTwoImportMaps$1 as composeTwoImportMaps, composeTwoImportMaps as composeTwoImportMaps$1, createDetailedMessage$3 as createDetailedMessage, createDetailedMessage$1, createDynamicLog$1 as createDynamicLog, createLogger$2 as createLogger, createLogger$1, createLogger as createLogger$2, createTaskLog$2 as createTaskLog, createTaskLog$1, createTaskLog as createTaskLog$2, defaultLookupPackageScope$1 as defaultLookupPackageScope, defaultLookupPackageScope as defaultLookupPackageScope$1, defaultReadPackageJson$1 as defaultReadPackageJson, defaultReadPackageJson as defaultReadPackageJson$1, distributePercentages, ensureEmptyDirectory, ensurePathnameTrailingSlash$2 as ensurePathnameTrailingSlash, ensurePathnameTrailingSlash$1, ensureWindowsDriveLetter$1 as ensureWindowsDriveLetter, ensureWindowsDriveLetter as ensureWindowsDriveLetter$1, escapeRegexpSpecialChars, generateContentFrame$1 as generateContentFrame, generateContentFrame as generateContentFrame$1, getCallerPosition$1 as getCallerPosition, getCallerPosition as getCallerPosition$1, getExtensionsToTry$1 as getExtensionsToTry, getExtensionsToTry as getExtensionsToTry$1, humanizeDuration$1 as humanizeDuration, humanizeFileSize, humanizeMemory, inferRuntimeCompatFromClosestPackage, injectQueryParamIntoSpecifierWithoutEncoding, injectQueryParamsIntoSpecifier$1 as injectQueryParamsIntoSpecifier, injectQueryParamsIntoSpecifier as injectQueryParamsIntoSpecifier$1, isFileSystemPath$2 as isFileSystemPath, isFileSystemPath$1, jsenvPluginBundling, jsenvPluginJsModuleFallback, jsenvPluginMinification, jsenvPluginTranspilation$1 as jsenvPluginTranspilation, jsenvPluginTranspilation as jsenvPluginTranspilation$1, lookupPackageDirectory$1 as lookupPackageDirectory, lookupPackageDirectory as lookupPackageDirectory$1, memoizeByFirstArgument, moveUrl$1 as moveUrl, moveUrl as moveUrl$1, nodeDefaultRuntimeCompat, normalizeImportMap$1 as normalizeImportMap, normalizeImportMap as normalizeImportMap$1, normalizeUrl$1 as normalizeUrl, normalizeUrl as normalizeUrl$1, raceProcessTeardownEvents$1 as raceProcessTeardownEvents, raceProcessTeardownEvents as raceProcessTeardownEvents$1, readCustomConditionsFromProcessArgs$1 as readCustomConditionsFromProcessArgs, readCustomConditionsFromProcessArgs as readCustomConditionsFromProcessArgs$1, readEntryStatSync$1 as readEntryStatSync, readEntryStatSync as readEntryStatSync$1, readPackageAtOrNull, registerDirectoryLifecycle$1 as registerDirectoryLifecycle, registerDirectoryLifecycle as registerDirectoryLifecycle$1, renderBigSection, renderDetails, renderTable, renderUrlOrRelativeUrlFilename, resolveImport$1 as resolveImport, resolveImport as resolveImport$1, setUrlBasename$1 as setUrlBasename, setUrlBasename as setUrlBasename$1, setUrlExtension$1 as setUrlExtension, setUrlExtension as setUrlExtension$1, setUrlFilename$1 as setUrlFilename, setUrlFilename as setUrlFilename$1, startMonitoringCpuUsage, startMonitoringMemoryUsage, stringifyUrlSite$1 as stringifyUrlSite, stringifyUrlSite as stringifyUrlSite$1, urlIsInsideOf$1 as urlIsInsideOf, urlIsInsideOf as urlIsInsideOf$1, urlToBasename$1 as urlToBasename, urlToBasename as urlToBasename$1, urlToExtension$4 as urlToExtension, urlToExtension$2 as urlToExtension$1, urlToExtension as urlToExtension$2, urlToFileSystemPath$1 as urlToFileSystemPath, urlToFileSystemPath as urlToFileSystemPath$1, urlToFilename$3 as urlToFilename, urlToFilename$1, urlToPathname$4 as urlToPathname, urlToPathname$2 as urlToPathname$1, urlToPathname as urlToPathname$2, urlToRelativeUrl$1 as urlToRelativeUrl, urlToRelativeUrl as urlToRelativeUrl$1, validateResponseIntegrity$1 as validateResponseIntegrity, validateResponseIntegrity as validateResponseIntegrity$1, writeFileSync$1 as writeFileSync, writeFileSync as writeFileSync$1 };

package/dist/start_dev_server/start_dev_server.js

@@ -8163,7 +8163,7 @@ const jsenvPluginChromeDevtoolsJson = () => {
     appliesDuring: "dev",
     devServerRoutes: [
       {
-        route: "GET /.well-known/appspecific/com.chrome.devtools.json",
+        endpoint: "GET /.well-known/appspecific/com.chrome.devtools.json",
         fetch: (request, { kitchen }) => {
           const { rootDirectoryUrl } = kitchen.context;
           return Response.json({
@@ -8178,6 +8178,39 @@ const jsenvPluginChromeDevtoolsJson = () => {
   };
 };
 
+const jsenvPluginAutoreloadOnServerRestart = () => {
+  const autoreloadOnRestartClientFileUrl = import.meta.resolve(
+    "@jsenv/server/src/services/autoreload_on_server_restart/client/autoreload_on_server_restart.js",
+  );
+
+  return {
+    name: "jsenv:autoreload_on_server_restart",
+    appliesDuring: "dev",
+    transformUrlContent: {
+      html: (urlInfo) => {
+        // we should not do this for inspector and 4xx.html
+        const htmlAst = parseHtml({
+          html: urlInfo.content,
+          url: urlInfo.url,
+        });
+        const autoreloadOnRestartClientFileReference =
+          urlInfo.dependencies.inject({
+            type: "script",
+            subtype: "js_classic",
+            expectedType: "js_classic",
+            specifier: autoreloadOnRestartClientFileUrl,
+          });
+        injectJsenvScript(htmlAst, {
+          "src": autoreloadOnRestartClientFileReference.generatedSpecifier,
+          "pluginName": "jsenv:autoreload_on_server_restart",
+          "data-ws-endpoint": "/.internal/events.websocket",
+        });
+        return stringifyHtmlAst(htmlAst);
+      },
+    },
+  };
+};
+
 // tslint:disable:ordered-imports
 
 
@@ -8201,6 +8234,7 @@ const getCorePlugins = ({
   http = false,
 
   clientAutoreload,
+  clientAutoreloadOnServerRestart,
   cacheControl,
   scenarioPlaceholders = true,
   ribbon = true,
@@ -8270,6 +8304,9 @@ const getCorePlugins = ({
 
     // "jsenvPluginSupervisor" MUST be after "jsenvPluginInlining" as it needs inline script to be cooked
     ...(supervisor ? [jsenvPluginSupervisor(supervisor)] : []),
+    ...(clientAutoreloadOnServerRestart
+      ? [jsenvPluginAutoreloadOnServerRestart()]
+      : []),
 
     jsenvPluginCommonJsGlobals(),
     jsenvPluginImportMetaScenarios(),
@@ -8455,6 +8492,7 @@ const startDevServer = async ({
 
   sourceFilesConfig = {},
   clientAutoreload = true,
+  clientAutoreloadOnServerRestart = true,
 
   // runtimeCompat is the runtimeCompat for the build
   // when specified, dev server use it to warn in case
@@ -8636,6 +8674,7 @@ const startDevServer = async ({
         transpilation,
 
         clientAutoreload,
+        clientAutoreloadOnServerRestart,
         cacheControl,
         ribbon,
       }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jsenv/core",
-  "version": "40.1.6",
+  "version": "40.2.0",
   "description": "Tool to develop, test and build js projects",
   "license": "MIT",
   "author": {
@@ -90,7 +90,7 @@
     "@jsenv/plugin-minification": "1.6.2",
     "@jsenv/plugin-supervisor": "1.6.12",
     "@jsenv/plugin-transpilation": "1.5.9",
-    "@jsenv/server": "16.0.6",
+    "@jsenv/server": "16.0.7",
     "@jsenv/sourcemap": "1.3.4",
     "@jsenv/url-meta": "8.5.6",
     "@jsenv/urls": "2.7.1",

package/src/build/build.js

@@ -24,6 +24,7 @@ import {
   compareFileUrls,
   ensureEmptyDirectory,
   lookupPackageDirectory,
+  readPackageAtOrNull,
   writeFileSync,
 } from "@jsenv/filesystem";
 import {
@@ -515,6 +516,67 @@ export const build = async ({
     const startDate = Date.now();
     const { onBuildEnd, onEntryPointBuildStart } = startBuildLogs();
 
+    const sourceFileBuildCallbackMap = new Map();
+    const registerSourceFileBuildEffect = (url, callback) => {
+      const buildCallbackSet = sourceFileBuildCallbackMap.get(url);
+      if (buildCallbackSet) {
+        buildCallbackSet.add(callback);
+      } else {
+        const set = new Set();
+        set.add(callback);
+        sourceFileBuildCallbackMap.set(url, set);
+      }
+    };
+    const onSourceFileBuild = ({ sourceFileUrl, buildFileUrl }) => {
+      const buildCallbackSet = sourceFileBuildCallbackMap.get(sourceFileUrl);
+      if (buildCallbackSet) {
+        for (const buildCallback of buildCallbackSet) {
+          buildCallback({ buildFileUrl });
+        }
+      }
+    };
+    sync_package_side_effects: {
+      if (!packageDirectoryUrl) {
+        break sync_package_side_effects;
+      }
+      const packageJson = readPackageAtOrNull(packageDirectoryUrl);
+      if (!packageJson) {
+        break sync_package_side_effects;
+      }
+      const { sideEffects } = packageJson;
+      if (!sideEffects || !Array.isArray(sideEffects)) {
+        break sync_package_side_effects;
+      }
+      const sideEffectFileUrlSet = new Set();
+      const packageJsonFileUrl = new URL("./package.json", packageDirectoryUrl)
+        .href;
+      for (const sideEffectFileRelativeUrl of sideEffects) {
+        const sideEffectFileUrl = new URL(
+          sideEffectFileRelativeUrl,
+          packageDirectoryUrl,
+        ).href;
+        sideEffectFileUrlSet.add(sideEffectFileUrl);
+        registerSourceFileBuildEffect(sideEffectFileUrl, ({ buildFileUrl }) => {
+          const urlRelativeToPackage = urlToRelativeUrl(
+            buildFileUrl,
+            packageDirectoryUrl,
+          );
+          if (sideEffectFileUrlSet.has(buildFileUrl)) {
+            return;
+          }
+          sideEffects.push(
+            urlRelativeToPackage[0] === "."
+              ? urlRelativeToPackage
+              : `./${urlRelativeToPackage}`,
+          );
+          writeFileSync(
+            packageJsonFileUrl,
+            JSON.stringify(packageJson, null, "  "),
+          );
+        });
+      }
+    }
+
     const buildUrlsGenerator = createBuildUrlsGenerator({
       sourceDirectoryUrl,
       buildDirectoryUrl,
@@ -567,6 +629,7 @@ export const build = async ({
           sourceRelativeUrl: entryPoint.sourceRelativeUrl,
           buildUrlsGenerator,
           someEntryPointUseNode,
+          onSourceFileBuild,
         },
         entryPoint.params,
       );
@@ -650,12 +713,10 @@ export const build = async ({
     if (writeOnFileSystem) {
       clearDirectorySync(buildDirectoryUrl, buildDirectoryCleanPatterns);
       const buildRelativeUrls = Object.keys(buildFileContents);
-      buildRelativeUrls.forEach((buildRelativeUrl) => {
-        writeFileSync(
-          new URL(buildRelativeUrl, buildDirectoryUrl),
-          buildFileContents[buildRelativeUrl],
-        );
-      });
+      for (const buildRelativeUrl of buildRelativeUrls) {
+        const buildUrl = new URL(buildRelativeUrl, buildDirectoryUrl);
+        writeFileSync(buildUrl, buildFileContents[buildRelativeUrl]);
+      }
     }
     onBuildEnd({
       buildFileContents,
@@ -791,6 +852,7 @@ const prepareEntryPointBuild = async (
     outDirectoryUrl,
     buildUrlsGenerator,
     someEntryPointUseNode,
+    onSourceFileBuild,
   },
   entryPointParams,
 ) => {
@@ -1034,6 +1096,7 @@ const prepareEntryPointBuild = async (
           versioningViaImportmap &&
           rawKitchen.graph.getUrlInfo(entryReference.url).type === "html" &&
           rawKitchen.context.isSupportedOnCurrentClients("importmap"),
+        onSourceFileBuild,
       });
       const finalPluginStore = createPluginStore([
         jsenvPluginReferenceAnalysis({

package/src/build/build_specifier_manager.js

@@ -20,9 +20,8 @@ import {
   urlToRelativeUrl,
 } from "@jsenv/urls";
 import { CONTENT_TYPE } from "@jsenv/utils/src/content_type/content_type.js";
-import { createHash } from "node:crypto";
-
 import { escapeRegexpSpecialChars } from "@jsenv/utils/src/string/escape_regexp_special_chars.js";
+import { createHash } from "node:crypto";
 import { prependContent } from "../kitchen/prepend_content.js";
 import { GRAPH_VISITOR } from "../kitchen/url_graph/url_graph_visitor.js";
 import { isWebWorkerUrlInfo } from "../kitchen/web_workers.js";
@@ -46,6 +45,7 @@ export const createBuildSpecifierManager = ({
   versioningMethod,
   versionLength,
   canUseImportmap,
+  onSourceFileBuild,
 }) => {
   const placeholderAPI = createPlaceholderAPI({
     length,
@@ -57,18 +57,18 @@ export const createBuildSpecifierManager = ({
 
   const generateReplacement = (reference) => {
     let buildUrl;
+    const buildUrlInfo = reference.urlInfo;
     if (reference.type === "sourcemap_comment") {
       const parentBuildUrl = urlInfoToBuildUrlMap.get(reference.ownerUrlInfo);
       buildUrl = generateSourcemapFileUrl(parentBuildUrl);
       reference.generatedSpecifier = buildUrl;
     } else {
       const url = reference.generatedUrl;
-      let urlInfo;
       const rawUrlInfo = rawKitchen.graph.getUrlInfo(reference.url);
+      let urlInfo;
       if (rawUrlInfo) {
         urlInfo = rawUrlInfo;
       } else {
-        const buildUrlInfo = reference.urlInfo;
         buildUrlInfo.type = reference.expectedType || "asset";
         buildUrlInfo.subtype = reference.expectedSubtype;
         urlInfo = buildUrlInfo;
@@ -112,6 +112,31 @@ export const createBuildSpecifierManager = ({
       buildSpecifier,
       reference,
     );
+
+    if (buildUrlInfo.sourceUrls) {
+      for (const sourceUrl of buildUrlInfo.sourceUrls) {
+        const rawUrlInfo = rawKitchen.graph.getUrlInfo(sourceUrl);
+        if (rawUrlInfo) {
+          onSourceFileBuild({
+            sourceUrlInfo: rawUrlInfo,
+            buildUrlInfo,
+            sourceFileUrl: rawUrlInfo.url,
+            buildFileUrl: buildUrl,
+          });
+        }
+      }
+    } else if (buildUrlInfo.originalUrl) {
+      const rawUrlInfo = rawKitchen.graph.getUrlInfo(buildUrlInfo.originalUrl);
+      if (rawUrlInfo) {
+        onSourceFileBuild({
+          sourceUrlInfo: rawUrlInfo,
+          buildUrlInfo,
+          sourceFileUrl: rawUrlInfo.url,
+          buildFileUrl: buildUrl,
+        });
+      }
+    }
+
     return buildGeneratedSpecifier;
   };
   const internalRedirections = new Map();
@@ -288,6 +313,7 @@ export const createBuildSpecifierManager = ({
         if (!finalUrlInfo.filenameHint && bundleInfo.data.bundleRelativeUrl) {
           finalUrlInfo.filenameHint = bundleInfo.data.bundleRelativeUrl;
         }
+        finalUrlInfo.sourceUrls = bundleInfo.sourceUrls;
         return {
           // url: bundleInfo.url,
           originalUrl: bundleInfo.originalUrl,
@@ -300,6 +326,7 @@ export const createBuildSpecifierManager = ({
       }
       const rawUrlInfo = rawKitchen.graph.getUrlInfo(rawUrl);
       if (rawUrlInfo) {
+        // if the rawUrl info had
         if (rawUrlInfo.type === "entry_build") {
           const otherEntryBuildInfo = rawUrlInfo.otherEntryBuildInfo;
           if (

package/src/dev/start_dev_server.js

@@ -76,6 +76,7 @@ export const startDevServer = async ({
 
   sourceFilesConfig = {},
   clientAutoreload = true,
+  clientAutoreloadOnServerRestart = true,
 
   // runtimeCompat is the runtimeCompat for the build
   // when specified, dev server use it to warn in case
@@ -258,6 +259,7 @@ export const startDevServer = async ({
         transpilation,
 
         clientAutoreload,
+        clientAutoreloadOnServerRestart,
         cacheControl,
         ribbon,
       }),

package/src/plugins/autoreload_on_server_restart/jsenv_plugin_autoreload_on_server_restart.js

@@ -0,0 +1,34 @@
+import { injectJsenvScript, parseHtml, stringifyHtmlAst } from "@jsenv/ast";
+
+export const jsenvPluginAutoreloadOnServerRestart = () => {
+  const autoreloadOnRestartClientFileUrl = import.meta.resolve(
+    "@jsenv/server/src/services/autoreload_on_server_restart/client/autoreload_on_server_restart.js",
+  );
+
+  return {
+    name: "jsenv:autoreload_on_server_restart",
+    appliesDuring: "dev",
+    transformUrlContent: {
+      html: (urlInfo) => {
+        // we should not do this for inspector and 4xx.html
+        const htmlAst = parseHtml({
+          html: urlInfo.content,
+          url: urlInfo.url,
+        });
+        const autoreloadOnRestartClientFileReference =
+          urlInfo.dependencies.inject({
+            type: "script",
+            subtype: "js_classic",
+            expectedType: "js_classic",
+            specifier: autoreloadOnRestartClientFileUrl,
+          });
+        injectJsenvScript(htmlAst, {
+          "src": autoreloadOnRestartClientFileReference.generatedSpecifier,
+          "pluginName": "jsenv:autoreload_on_server_restart",
+          "data-ws-endpoint": "/.internal/events.websocket",
+        });
+        return stringifyHtmlAst(htmlAst);
+      },
+    },
+  };
+};

package/src/plugins/chrome_devtools_json/jsenv_plugin_chrome_devtools_json.js

@@ -27,7 +27,7 @@ export const jsenvPluginChromeDevtoolsJson = () => {
     appliesDuring: "dev",
     devServerRoutes: [
       {
-        route: "GET /.well-known/appspecific/com.chrome.devtools.json",
+        endpoint: "GET /.well-known/appspecific/com.chrome.devtools.json",
         fetch: (request, { kitchen }) => {
           const { rootDirectoryUrl } = kitchen.context;
           return Response.json({

package/src/plugins/plugins.js

@@ -24,6 +24,7 @@ import { jsenvPluginCacheControl } from "./cache_control/jsenv_plugin_cache_cont
 import { jsenvPluginRibbon } from "./ribbon/jsenv_plugin_ribbon.js";
 import { jsenvPluginCleanHTML } from "./clean_html/jsenv_plugin_clean_html.js";
 import { jsenvPluginChromeDevtoolsJson } from "./chrome_devtools_json/jsenv_plugin_chrome_devtools_json.js";
+import { jsenvPluginAutoreloadOnServerRestart } from "./autoreload_on_server_restart/jsenv_plugin_autoreload_on_server_restart.js";
 
 export const getCorePlugins = ({
   rootDirectoryUrl,
@@ -45,6 +46,7 @@ export const getCorePlugins = ({
   http = false,
 
   clientAutoreload,
+  clientAutoreloadOnServerRestart,
   cacheControl,
   scenarioPlaceholders = true,
   ribbon = true,
@@ -114,6 +116,9 @@ export const getCorePlugins = ({
 
     // "jsenvPluginSupervisor" MUST be after "jsenvPluginInlining" as it needs inline script to be cooked
     ...(supervisor ? [jsenvPluginSupervisor(supervisor)] : []),
+    ...(clientAutoreloadOnServerRestart
+      ? [jsenvPluginAutoreloadOnServerRestart()]
+      : []),
 
     jsenvPluginCommonJsGlobals(),
     jsenvPluginImportMetaScenarios(),