@jsenv/core 39.13.2 → 39.14.0

package/README.md

@@ -4,32 +4,31 @@
 
 Jsenv is a suite of tools that can be used in projects involving JavaScript.
 
-`@jsenv/core` goal is too provide the following tools:
+The goal of `@jsenv/core` is to provide the following tools:
 
-1. **dev server**; a server for source files
-2. **build**; generate an optimized version of source files into a directory
-3. **build server**; a server for build files
-4. **test runner**; execute all test files at once
+1. **dev server**; A server that serves source files, facilitating development with live reloading.
+2. **build**; Optimizes source files into a specified directory for production.
+3. **build server**; Serves the built files, allowing for testing and verifying the production build.
+4. **test runner**; Runs test files concurrently, ensuring code reliability.
 
-It favors standards and simplicity.  
-As a result it can be enjoyed by people without much experience in tooling or seeking for simple tools without hidden complexities.
+Jsenv prioritizes standards and simplicity, making it ideal for both beginners and those who need straightforward tools without unnecessary complexities.
 
-If you want to try jsenv on your machine, use [@jsenv/cli](./packages/related/cli/#jsenvcli).
+To try jsenv on your machine, use [@jsenv/cli](./packages/related/cli/#jsenvcli).
 
-Link to [documentation](./docs/users/users.md)
+For additional details, consult the [documentation](./docs/users/users.md)
 
 # The best parts
 
-- Test files are [executed like standard files](./docs/users/d_test/d_test.md#14-executing-a-single-test)
-- [Isolated environment](./docs/users/d_test/d_test.md#33-isolated-environment) for each test file
-- Execute [tests in multiple browsers](./docs/users/d_test/d_test.md#32-execute-on-more-browsers>): Chrome, Safari, Firefox
-- [Large browser support during dev](./docs/users/b_dev/b_dev.md#21-browser-support>). Because some people might be happy to use an other browser than the latest chrome during dev. Moreover it is useful to reproduce bug specific to certain browsers.
-- [Large browser support after build](./docs/users/c_build/c_build.md#211-maximal-browser-support). Because some product still needs to support old versions of Firefox, Chrome and Safari.
-- [Single set of files after build](./docs/users/c_build/c_build.md#212-same-build-for-all-browsers). Because a single one is simpler to properly support in every aspects.
-- Versioning during build is robust and <a href="https://bundlers.tooling.report/hashing/avoid-cascade/" target="_blank">avoids cascading hash changes</a><sup>↗</sup>
-- Advanced support of top level await, allowing to use it everywhere
-- Advanced support of web workers including worker type module
-- Unlock [js module features on a classic `<script>`](./docs/users/g_plugins/g_plugins.md#22-asjsclassic>).
+- **Test files are executed like standard files**.
+- **Isolated environment for each test file**: Ensures tests run independently, preventing side effects.
+- Execute tests in multiple browsers: Supports Chrome, Safari, and Firefox.
+- Extensive browser support during dev: Allows the use of various browsers beyond the latest Chrome, which is useful for reproducing browser-specific bugs.
+- **Large browser support after build**: Ensures compatibility with older versions of Firefox, Chrome, and Safari.
+- Single set of files after build: Simplifies support and deployement with a single set of files.
+- **Robust versioning during build**: Avoids <a href="https://bundlers.tooling.report/hashing/avoid-cascade/" target="_blank">cascading hash changes</a><sup>↗</sup>.
+- **Advanced support of top level await**.
+- **Advanced support of web workers**.
+- **Load js module with classic script**: See the [asJsClassic plugin](./docs/users/g_plugins/g_plugins.md#22-asjsclassic>).
 
 <!--
 The following commands can be used to skip the prompt

package/dist/jsenv_core.js

@@ -3226,6 +3226,27 @@ const readDirectory = async (url, { emfileMaxWait = 1000 } = {}) => {
   return attempt();
 };
 
+const generateWindowsEPERMErrorMessage = (
+  error,
+  { operation, path },
+) => {
+  const pathLengthIsExceedingUsualLimit = String(path).length >= 256;
+  let message = "";
+
+  if (operation) {
+    message += `error while trying to fix windows EPERM after ${operation} on ${path}`;
+  }
+
+  if (pathLengthIsExceedingUsualLimit) {
+    message += "\n";
+    message += `Maybe because path length is exceeding the usual limit of 256 characters of windows OS?`;
+    message += "\n";
+  }
+  message += "\n";
+  message += error.stack;
+  return message;
+};
+
 const writeEntryPermissions = async (source, permissions) => {
   const sourceUrl = assertAndNormalizeFileUrl(source);
 
@@ -3296,7 +3317,10 @@ const readEntryStat = async (
               return stats;
             } catch (e) {
               console.error(
-                `error while trying to fix windows EPERM after stats on ${sourcePath}: ${e.stack}`,
+                generateWindowsEPERMErrorMessage(e, {
+                  operation: "stats",
+                  path: sourcePath,
+                }),
               );
               throw error;
             }
@@ -3398,7 +3422,10 @@ const readEntryStatSync = (
               return stats;
             } catch (e) {
               console.error(
-                `error while trying to fix windows EPERM after stats on ${sourcePath}: ${e.stack}`,
+                generateWindowsEPERMErrorMessage(e, {
+                  operation: "stats",
+                  path: sourcePath,
+                }),
               );
               throw error;
             }
@@ -3816,7 +3843,10 @@ const removeDirectorySync$1 = (
                   return;
                 }
                 console.error(
-                  `error while trying to fix windows EPERM after readir on ${directoryPath}: ${openOrCloseError.stack}`,
+                  generateWindowsEPERMErrorMessage(openOrCloseError, {
+                    path: directoryPath,
+                    operation: "readir",
+                  }),
                 );
                 throw error;
               }
@@ -4152,7 +4182,6 @@ const removeDirectory = async (
               console.error(
                 `trying to fix windows EPERM after readir on ${directoryPath}`,
               );
-
               let openOrCloseError;
               try {
                 const fd = openSync(directoryPath);
@@ -4166,7 +4195,10 @@ const removeDirectory = async (
                   return;
                 }
                 console.error(
-                  `error while trying to fix windows EPERM after readir on ${directoryPath}: ${openOrCloseError.stack}`,
+                  generateWindowsEPERMErrorMessage(openOrCloseError, {
+                    operation: "readdir",
+                    path: directoryPath,
+                  }),
                 );
                 throw error;
               }
@@ -4305,7 +4337,10 @@ const createWatcher = (sourcePath, options) => {
             return;
           }
           console.error(
-            `error while trying to get rid of windows EPERM: ${e.stack}`,
+            generateWindowsEPERMErrorMessage(error, {
+              operation: "watch",
+              path: sourcePath,
+            }),
           );
           throw error;
         }
@@ -11325,7 +11360,7 @@ const JS_QUOTE_REPLACEMENTS = {
 
 const jsenvPluginImportAttributes = ({
   json = "auto",
-  css = "auto",
+  css = true,
   text = "auto",
 }) => {
   const transpilations = { json, css, text };
@@ -11335,7 +11370,11 @@ const jsenvPluginImportAttributes = ({
       reference.filenameHint = `${urlToFilename$1(reference.url)}.js`;
     }
   };
-  const turnIntoJsModuleProxy = (reference, type) => {
+  const turnIntoJsModuleProxy = (
+    reference,
+    type,
+    { injectSearchParamForSideEffectImports },
+  ) => {
     reference.mutation = (magicSource) => {
       if (reference.subtype === "import_dynamic") {
         const { importTypeAttributeNode } = reference.astInfo;
@@ -11362,12 +11401,19 @@ const jsenvPluginImportAttributes = ({
     };
     const newUrl = injectQueryParams(reference.url, {
       [`as_${type}_module`]: "",
+      ...(injectSearchParamForSideEffectImports && reference.isSideEffectImport
+        ? { side_effect: "" }
+        : {}),
     });
     markAsJsModuleProxy(reference);
     return newUrl;
   };
 
-  const createImportTypePlugin = ({ type, createUrlContent }) => {
+  const createImportTypePlugin = ({
+    type,
+    createUrlContent,
+    injectSearchParamForSideEffectImports,
+  }) => {
     return {
       name: `jsenv:import_type_${type}`,
       appliesDuring: "*",
@@ -11405,7 +11451,9 @@ const jsenvPluginImportAttributes = ({
           return null;
         }
         if (reference.importAttributes.type === type) {
-          return turnIntoJsModuleProxy(reference, type);
+          return turnIntoJsModuleProxy(reference, type, {
+            injectSearchParamForSideEffectImports,
+          });
         }
         return null;
       },
@@ -11454,6 +11502,7 @@ const jsenvPluginImportAttributes = ({
 
   const asCssModule = createImportTypePlugin({
     type: "css",
+    injectSearchParamForSideEffectImports: true,
     createUrlContent: (cssUrlInfo) => {
       const cssText = JS_QUOTES.escapeSpecialChars(cssUrlInfo.content, {
         // If template string is choosen and runtime do not support template literals
@@ -11471,15 +11520,38 @@ const jsenvPluginImportAttributes = ({
       } else {
         inlineContentCall = `new __InlineContent__(${cssText}, { type: "text/css" })`;
       }
-      return {
-        content: `
-import ${JSON.stringify(cssUrlInfo.context.inlineContentClientFileUrl)};
+
+      let autoInject = cssUrlInfo.searchParams.has("side_effect");
+      let cssModuleAutoInjectCode = ``;
+      if (autoInject) {
+        if (cssUrlInfo.context.dev) {
+          cssModuleAutoInjectCode = `
+document.adoptedStyleSheets = [...document.adoptedStyleSheets, stylesheet];
+
+if (import.meta.hot) {
+  import.meta.hot.dispose(() => {
+    document.adoptedStyleSheets = document.adoptedStyleSheets.filter(
+      (s) => s !== stylesheet,
+    );
+  });
+};
+`;
+        } else {
+          cssModuleAutoInjectCode = `
+document.adoptedStyleSheets = [...document.adoptedStyleSheets, stylesheet];
+`;
+        }
+      }
+      let cssModuleContent = `import ${JSON.stringify(cssUrlInfo.context.inlineContentClientFileUrl)};
 
 const inlineContent = ${inlineContentCall};
 const stylesheet = new CSSStyleSheet();
 stylesheet.replaceSync(inlineContent.text);
+${cssModuleAutoInjectCode}
+export default stylesheet;`;
 
-export default stylesheet;`,
+      return {
+        content: cssModuleContent,
         contentType: "text/javascript",
         type: "js_module",
         originalUrl: cssUrlInfo.originalUrl,
@@ -13194,6 +13266,7 @@ const createReference = ({
   urlInfo = null,
   escape = null,
   importAttributes,
+  isSideEffectImport = false,
   astInfo = {},
   mutation,
 }) => {
@@ -13257,6 +13330,7 @@ const createReference = ({
     // used mostly by worker and import assertions
     astInfo,
     importAttributes,
+    isSideEffectImport,
     mutation,
   };
 
@@ -17675,6 +17749,7 @@ const parseAndTransformJsReferences = async (
         "document.currentScript.src": urlInfo.url,
       }[externalReferenceInfo.baseUrlType],
       importAttributes: externalReferenceInfo.importAttributes,
+      isSideEffectImport: externalReferenceInfo.isSideEffectImport,
       astInfo: externalReferenceInfo.astInfo,
     });
     parallelActions.push(async () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jsenv/core",
-  "version": "39.13.2",
+  "version": "39.14.0",
   "description": "Tool to develop, test and build js projects",
   "license": "MIT",
   "author": {
@@ -69,17 +69,17 @@
   "dependencies": {
     "@financial-times/polyfill-useragent-normaliser": "1.10.2",
     "@jsenv/abort": "4.3.0",
-    "@jsenv/ast": "6.5.0",
-    "@jsenv/filesystem": "4.13.3",
+    "@jsenv/ast": "6.5.1",
+    "@jsenv/filesystem": "4.13.4",
     "@jsenv/humanize": "1.2.8",
     "@jsenv/importmap": "1.2.1",
     "@jsenv/integrity": "0.0.2",
-    "@jsenv/js-module-fallback": "1.3.57",
+    "@jsenv/js-module-fallback": "1.3.58",
     "@jsenv/node-esm-resolution": "1.0.6",
     "@jsenv/plugin-bundling": "2.7.25",
     "@jsenv/plugin-minification": "1.5.13",
-    "@jsenv/plugin-supervisor": "1.6.4",
-    "@jsenv/plugin-transpilation": "1.4.93",
+    "@jsenv/plugin-supervisor": "1.6.5",
+    "@jsenv/plugin-transpilation": "1.4.94",
     "@jsenv/runtime-compat": "1.3.1",
     "@jsenv/server": "15.5.1",
     "@jsenv/sourcemap": "1.2.30",

package/src/kitchen/url_graph/references.js

@@ -304,6 +304,7 @@ const createReference = ({
   urlInfo = null,
   escape = null,
   importAttributes,
+  isSideEffectImport = false,
   astInfo = {},
   mutation,
 }) => {
@@ -367,6 +368,7 @@ const createReference = ({
     // used mostly by worker and import assertions
     astInfo,
     importAttributes,
+    isSideEffectImport,
     mutation,
   };
 

package/src/plugins/reference_analysis/js/jsenv_plugin_js_reference_analysis.js

@@ -117,6 +117,7 @@ const parseAndTransformJsReferences = async (
         "document.currentScript.src": urlInfo.url,
       }[externalReferenceInfo.baseUrlType],
       importAttributes: externalReferenceInfo.importAttributes,
+      isSideEffectImport: externalReferenceInfo.isSideEffectImport,
       astInfo: externalReferenceInfo.astInfo,
     });
     parallelActions.push(async () => {