@jsenv/core 39.1.1 → 39.1.3

package/README.md

@@ -12,20 +12,13 @@ Jsenv is a suite of tools that can be used in projects involving JavaScript.
 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
 
-[Link to documentation](<https://github.com/jsenv/core/wiki/A)-directory-structure>)
+Now what do you want to do?
 
-# The best parts
-
-- Test files are [executed like standard files](<https://github.com/jsenv/core/wiki/D)-Test#14-executing-a-single-test>)
-- [Isolated environment](<https://github.com/jsenv/core/wiki/D)-Test#33-isolated-environment>) for each test file
-- Execute [tests in multiple browsers](<https://github.com/jsenv/core/wiki/D)-Test#32-execute-on-more-browsers>): Chrome, Safari, Firefox
-- [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.
-- [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.
-- [Single set of files after 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.
-- 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>`](<https://github.com/jsenv/core/wiki/G)-Plugins#22-asjsclassic>).
+| Scenario                                              | Action                                               |
+| ----------------------------------------------------- | ---------------------------------------------------- |
+| I want to try a demo on my machine                    | Go to [./demos](#demos)                              |
+| I want to try jsenv on a project I have on my machine | Go to [./cli](#cli)                                  |
+| I want to learn how to use jsenv                      | Go to [./docs/users/users.md](./docs/users/users.md) |
 
 # Demos
 
@@ -47,7 +40,7 @@ It will prompt to choose one of the available demo:
     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:
+Selecting "web" will copy [create-jsenv/demo-web/](./packages/related/create-jsenv/demo-web/) files into a directory:
 
 ```console
 ✔ Select a demo: › web
@@ -63,10 +56,38 @@ 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 build files; 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; Documented in [D) Test](<https://github.com/jsenv/core/wiki/D)-Test>).
+- `npm run dev`: starts a server for source files; Documented in [B) Dev](./docs/users/b_dev/b_dev.md).
+- `npm run build`: generate build files; Documented in [C) Build](./docs/users/c_build/c_build.md).
+- `npm run build:serve`: start a server for build files; Documented in [C) Build#how-to-serve-build-files](./docs/users/c_build/c_build.md#3-how-to-serve-build-files).
+- `npm run test`: execute test files; Documented in [D) Test](./docs/users/d_test/d_test.md).
+
+# CLI
+
+Jsenv commands to test it quickly.
+
+| I want to                             | Command                  |
+| ------------------------------------- | ------------------------ |
+| Start a local server for source files | `npx @jsenv/cli dev`     |
+| Build source files into "./dist/"     | `npx @jsenv/cli build`   |
+| Start a local server for build files  | `npx @jsenv/cli preview` |
+| Run all test files                    | `npx @jsenv/cli test`    |
+
+The commands are very basic, for advanced use cases you should use jsenv API.
+
+For example in order to start a dev server you would rather do `npm run dev` that would be declared in [package.json#scripts.dev](./packages/related/create-jsenv/demo-web/package.json#L8) to execute [scripts/dev.mjs](./packages/related/create-jsenv/demo-web/scripts/dev.mjs).
+
+# 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>).
 
 <!--
 The following commands can be used to skip the prompt

package/dist/jsenv_core.js

@@ -13500,7 +13500,11 @@ const createUrlInfoTransformer = ({
     if (!generatedUrl.startsWith("file:")) {
       return;
     }
-    if (urlInfo.type === "directory") {
+    if (
+      urlInfo.type === "directory" ||
+      // happens when type is "html" to list directory content for example
+      urlInfo.firstReference?.leadsToADirectory
+    ) {
       // no need to write the directory
       return;
     }
@@ -18481,13 +18485,20 @@ const generateDirectoryContent = (
   directoryUrl,
   rootDirectoryUrl,
 ) => {
-  return directoryContentArray.map((filename) => {
+  const sortedNames = [];
+  for (const filename of directoryContentArray) {
     const fileUrlObject = new URL(filename, directoryUrl);
-    const fileUrl = String(fileUrlObject);
-    let fileUrlRelative = urlToRelativeUrl(fileUrl, rootDirectoryUrl);
     if (lstatSync(fileUrlObject).isDirectory()) {
-      fileUrlRelative += "/";
+      sortedNames.push(`${filename}/`);
+    } else {
+      sortedNames.push(filename);
     }
+  }
+  sortedNames.sort(comparePathnames);
+  return sortedNames.map((filename) => {
+    const fileUrlObject = new URL(filename, directoryUrl);
+    const fileUrl = String(fileUrlObject);
+    let fileUrlRelative = urlToRelativeUrl(fileUrl, rootDirectoryUrl);
     return `<li>
     <a href="/${fileUrlRelative}">/${fileUrlRelative}</a>
   </li>`;
@@ -23129,6 +23140,7 @@ ${e.trace?.message}`);
   logger.info(``);
   return {
     origin: server.origin,
+    sourceDirectoryUrl,
     stop: () => {
       server.stop();
     },

package/package.json

@@ -1,12 +1,11 @@
 {
   "name": "@jsenv/core",
-  "version": "39.1.1",
+  "version": "39.1.3",
   "description": "Tool to develop, test and build js projects",
   "license": "MIT",
   "author": {
     "name": "dmail",
-    "email": "dmaillard06@gmail.com",
-    "url": "https://twitter.com/damienmaillard"
+    "email": "dmaillard06@gmail.com"
   },
   "repository": {
     "type": "git",
@@ -66,22 +65,22 @@
   "dependencies": {
     "@financial-times/polyfill-useragent-normaliser": "1.10.2",
     "@jsenv/abort": "4.3.0",
-    "@jsenv/ast": "6.2.1",
-    "@jsenv/filesystem": "4.7.5",
-    "@jsenv/humanize": "1.2.3",
+    "@jsenv/ast": "6.2.2",
+    "@jsenv/filesystem": "4.8.0",
+    "@jsenv/humanize": "1.2.4",
     "@jsenv/importmap": "1.2.1",
     "@jsenv/integrity": "0.0.2",
-    "@jsenv/js-module-fallback": "1.3.22",
+    "@jsenv/js-module-fallback": "1.3.23",
     "@jsenv/node-esm-resolution": "1.0.2",
-    "@jsenv/plugin-bundling": "2.6.15",
-    "@jsenv/plugin-minification": "1.5.4",
-    "@jsenv/plugin-supervisor": "1.5.1",
-    "@jsenv/plugin-transpilation": "1.4.5",
+    "@jsenv/plugin-bundling": "2.6.16",
+    "@jsenv/plugin-minification": "1.5.5",
+    "@jsenv/plugin-supervisor": "1.5.2",
+    "@jsenv/plugin-transpilation": "1.4.6",
     "@jsenv/runtime-compat": "1.3.0",
-    "@jsenv/server": "15.2.12",
-    "@jsenv/sourcemap": "1.2.13",
+    "@jsenv/server": "15.2.13",
+    "@jsenv/sourcemap": "1.2.14",
     "@jsenv/url-meta": "8.4.2",
-    "@jsenv/urls": "2.2.10",
+    "@jsenv/urls": "2.2.11",
     "@jsenv/utils": "2.1.1"
   },
   "devDependencies": {
@@ -89,6 +88,7 @@
     "@babel/plugin-syntax-import-attributes": "7.24.7",
     "@babel/plugin-syntax-optional-chaining-assign": "7.24.7",
     "@jsenv/assert": "./packages/independent/assert/",
+    "@jsenv/cli": "./packages/related/cli/",
     "@jsenv/core": "./",
     "@jsenv/eslint-config": "./packages/independent/eslint-config/",
     "@jsenv/file-size-impact": "14.1.6",
@@ -98,17 +98,18 @@
     "@jsenv/plugin-as-js-classic": "./packages/related/plugin-as-js-classic/",
     "@jsenv/snapshot": "./packages/independent/snapshot/",
     "@jsenv/test": "./packages/related/test/",
-    "@playwright/browser-chromium": "1.45.1",
-    "@playwright/browser-firefox": "1.45.1",
-    "@playwright/browser-webkit": "1.45.1",
+    "@playwright/browser-chromium": "1.45.2",
+    "@playwright/browser-firefox": "1.45.2",
+    "@playwright/browser-webkit": "1.45.2",
     "babel-plugin-transform-async-to-promises": "0.8.18",
     "eslint": "8.56.0",
     "eslint-plugin-html": "8.1.1",
     "eslint-plugin-import": "2.29.1",
-    "eslint-plugin-react": "7.34.3",
+    "eslint-plugin-react": "7.34.4",
     "eslint-plugin-regexp": "2.6.0",
+    "marked": "13.0.2",
     "open": "10.1.0",
-    "playwright": "1.45.1",
-    "prettier": "3.3.2"
+    "playwright": "1.45.2",
+    "prettier": "3.3.3"
   }
 }

package/src/dev/start_dev_server.js

@@ -649,6 +649,7 @@ ${e.trace?.message}`);
   logger.info(``);
   return {
     origin: server.origin,
+    sourceDirectoryUrl,
     stop: () => {
       server.stop();
     },

package/src/kitchen/url_graph/url_info_transformations.js

@@ -268,7 +268,11 @@ export const createUrlInfoTransformer = ({
     if (!generatedUrl.startsWith("file:")) {
       return;
     }
-    if (urlInfo.type === "directory") {
+    if (
+      urlInfo.type === "directory" ||
+      // happens when type is "html" to list directory content for example
+      urlInfo.firstReference?.leadsToADirectory
+    ) {
       // no need to write the directory
       return;
     }

package/src/plugins/protocol_file/jsenv_plugin_protocol_file.js

@@ -19,7 +19,10 @@ import {
 } from "@jsenv/node-esm-resolution";
 import { pickContentType } from "@jsenv/server";
 import { CONTENT_TYPE } from "@jsenv/utils/src/content_type/content_type.js";
-import { assertAndNormalizeDirectoryUrl } from "@jsenv/filesystem";
+import {
+  assertAndNormalizeDirectoryUrl,
+  comparePathnames,
+} from "@jsenv/filesystem";
 
 const html404AndParentDirIsEmptyFileUrl = new URL(
   "./html_404_and_parent_dir_is_empty.html",
@@ -352,13 +355,20 @@ const generateDirectoryContent = (
   directoryUrl,
   rootDirectoryUrl,
 ) => {
-  return directoryContentArray.map((filename) => {
+  const sortedNames = [];
+  for (const filename of directoryContentArray) {
     const fileUrlObject = new URL(filename, directoryUrl);
-    const fileUrl = String(fileUrlObject);
-    let fileUrlRelative = urlToRelativeUrl(fileUrl, rootDirectoryUrl);
     if (lstatSync(fileUrlObject).isDirectory()) {
-      fileUrlRelative += "/";
+      sortedNames.push(`${filename}/`);
+    } else {
+      sortedNames.push(filename);
     }
+  }
+  sortedNames.sort(comparePathnames);
+  return sortedNames.map((filename) => {
+    const fileUrlObject = new URL(filename, directoryUrl);
+    const fileUrl = String(fileUrlObject);
+    let fileUrlRelative = urlToRelativeUrl(fileUrl, rootDirectoryUrl);
     return `<li>
     <a href="/${fileUrlRelative}">/${fileUrlRelative}</a>
   </li>`;