@jsenv/core 38.2.4 → 38.2.6

package/README.md

@@ -1,6 +1,6 @@
 # @jsenv/core [![npm package](https://img.shields.io/npm/v/@jsenv/core.svg?logo=npm&label=package)](https://www.npmjs.com/package/@jsenv/core)
 
-Jsenv is a tool to develop test and build projects using JavaScript. Jsenv is simple, easy to understand and well [documented](<https://github.com/jsenv/core/wiki/A)-directory-structure>).
+Jsenv is a tool to develop test and build projects using JavaScript. Jsenv is simple, easy to understand and well documented.
 
 Jsenv cares a lot about the developper experience, especially when it comes to tests.
 
@@ -11,21 +11,11 @@ The pillars of jsenv are:
 3. A build server serving build files
 4. A test runner executing test files in web browser(s)
 
-# The best parts
-
-## Reduce cognitive load inside test files
-
-When coding, we spend most of our time working on source files. At some point we switch from source files to test files. Suddenly things are different:
+[Link to documentation](<https://github.com/jsenv/core/wiki/A)-directory-structure>)
 
-- code does not execute as it would in source files
-- some tools are used differently in test files, some cannot be used at all
-- you are forced to code in a certain way that is completely different from the one in source files
-
-This huge gap between source files and test files creates a context switching costing a lot of cognitive energy.  
-Jsenv makes a special effort to [provide a solution](<https://github.com/jsenv/core/wiki/D)-Test>) where switching from source files to test files is easy.
-
-## Others
+# The best parts
 
+- Tools and habits used in source files [can be reused in test files](<https://github.com/jsenv/core/wiki/D)-Test>).
 - A [large browser support during dev](<https://github.com/jsenv/core/wiki/B)-Dev#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.
 - A [large browser support after build](<https://github.com/jsenv/core/wiki/C)-Build#211-maximal-browser-support>). Because some product still needs to support old versions of Firefox, Chrome and Safari.
 - A [single set of files during build](<https://github.com/jsenv/core/wiki/C)-Build#212-same-build-for-all-browsers>). Because a single one is simpler to properly support in every aspects.
@@ -33,11 +23,59 @@ Jsenv makes a special effort to [provide a solution](<https://github.com/jsenv/c
 - Ability to [execute tests in multiple browsers](<https://github.com/jsenv/core/wiki/D)-Test#32-executing-on-more-browsers>): Chrome, Safari, Firefox
 - An advanced support of top level await, allowing to use it everywhere
 - An advanced support of web workers including worker type module
-- Unlock js module features on a regular `<script>` when needed. If you need the behaviour of `<script>` which is to block other `<script>` tag in the page, you'll be happy to still have the power of js modules, like imports, at your disposal.
+- Unlock js module features on a regular `<script>` when needed. If you need the behaviour of `<script>` which is to block execution of following `<script>` in the page, you'll be happy to [still have the power of js modules](<https://github.com/jsenv/core/wiki/G)-Plugins#22-asjsclassic>), like imports, at your disposal.
 
 # Demos
 
-[H) Demos](<https://github.com/jsenv/core/wiki/H)-Demos>).
+A demo is a project pre-configured with jsenv.
+
+The following command can be used to install and try a demo:
+
+```console
+npm create jsenv@latest
+```
+
+It will prompt to choose one of the available demo:
+
+```console
+? Select a demo: › - Use arrow-keys. Return to submit.
+❯   web
+    web-react
+    web-preact
+    node-package
+```
+
+Selecting "web" will copy [create-jsenv/demo-web](https://github.com/jsenv/core/tree/bc7fb0aa2c8ced1db4d7583a2ea1858be464c23b/packages/related/create-jsenv/demo-web) files into a directory:
+
+```console
+✔ Select a demo: › web
+✔ copy demo files into "[...]jsenv-demo-web/" (done in 0.1 second)
+----- commands to run -----
+cd jsenv-demo-web
+npm install
+npm start
+---------------------------
+```
+
+After running the suggested commands the demo is ready.
+
+The demo contains preconfigured scripts:
+
+- `npm run dev`: starts a server for source files; Documented in [B) Dev](<https://github.com/jsenv/core/wiki/B)-Dev>).
+- `npm run build`: generate files optimized for production; Documented in [C) Build](<https://github.com/jsenv/core/wiki/C)-Build>).
+- `npm run build:serve`: start a server for build files; Documented in [C) Build#how-to-serve-build-files](<https://github.com/jsenv/core/wiki/C)-Build#3-how-to-serve-build-files>).
+- `npm run test`: execute test files on browsers(s); Documented in [D) Test](<https://github.com/jsenv/core/wiki/D)-Test>).
+
+<!--
+The following commands can be used to skip the prompt
+
+| Command                                     |
+| ------------------------------------------- |
+| `npm create jsenv@latest -- --web`          |
+| `npm create jsenv@latest -- --web-preact`   |
+| `npm create jsenv@latest -- --web-react`    |
+| `npm create jsenv@latest -- --node-package` |
+-->
 
 <!-- # Installation
 

package/dist/jsenv_core.js

@@ -2545,7 +2545,8 @@ callback: ${callback}`);
   return { registerCleanupCallback, cleanup };
 };
 
-const fsWatchSupportsRecursive = process.platform !== "linux";
+const isLinux = process.platform === "linux";
+const fsWatchSupportsRecursive = !isLinux;
 
 const registerDirectoryLifecycle = (
   source,
@@ -2881,10 +2882,10 @@ const shouldCallUpdated = (entryInfo) => {
   if (stat.atimeMs < stat.mtimeMs) {
     return true;
   }
-  if (stat.mtimeMs > previousInfo.stat.mtimeMs) {
-    return true;
+  if (isLinux && stat.mtimeMs <= previousInfo.stat.mtimeMs) {
+    return false;
   }
-  return false;
+  return true;
 };
 
 const undefinedOrFunction = (value) => {
@@ -3856,6 +3857,7 @@ const createLog = ({
     write,
     dynamicWrite,
     destroy,
+    stream,
   });
   return log;
 };
@@ -3890,7 +3892,7 @@ const startSpinner = ({
   stopOnVerticalOverflow = true,
   render = () => "",
   effect = () => {},
-  animated = true,
+  animated = log.stream.isTTY,
 }) => {
   let frameIndex = 0;
   let interval;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jsenv/core",
-  "version": "38.2.4",
+  "version": "38.2.6",
   "description": "Tool to develop, test and build js projects",
   "license": "MIT",
   "author": {
@@ -62,16 +62,16 @@
     "@financial-times/polyfill-useragent-normaliser": "1.10.2",
     "@jsenv/abort": "4.2.4",
     "@jsenv/ast": "5.1.4",
-    "@jsenv/filesystem": "4.3.1",
+    "@jsenv/filesystem": "4.3.2",
     "@jsenv/importmap": "1.2.1",
     "@jsenv/integrity": "0.0.1",
-    "@jsenv/log": "3.4.0",
+    "@jsenv/log": "3.4.1",
     "@jsenv/node-esm-resolution": "1.0.1",
     "@jsenv/js-module-fallback": "1.3.5",
     "@jsenv/runtime-compat": "1.2.0",
-    "@jsenv/server": "15.1.2",
+    "@jsenv/server": "15.1.3",
     "@jsenv/sourcemap": "1.2.3",
-    "@jsenv/plugin-bundling": "2.5.4",
+    "@jsenv/plugin-bundling": "2.5.5",
     "@jsenv/plugin-minification": "1.5.2",
     "@jsenv/plugin-transpilation": "1.3.4",
     "@jsenv/plugin-supervisor": "1.3.4",