@jsenv/core 38.2.4 → 38.2.5

package/README.md

@@ -24,7 +24,9 @@ When coding, we spend most of our time working on source files. At some point we
 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
+It also means tools used on source files can be reused on test files: ESlint, VSCode debugger, etc. No need to maintain separate tools and/or configurations.
+
+## Other good parts
 
 - 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.
@@ -37,7 +39,58 @@ Jsenv makes a special effort to [provide a solution](<https://github.com/jsenv/c
 
 # 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)<sup>↗</sup> 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.
+
+> **Info**
+> "npm install" can take time because tests are runned in headless browsers that needs to be installed first.
+
+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) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jsenv/core",
-  "version": "38.2.4",
+  "version": "38.2.5",
   "description": "Tool to develop, test and build js projects",
   "license": "MIT",
   "author": {
@@ -62,7 +62,7 @@
     "@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",