@jsenv/core 38.1.1 → 38.2.1

package/README.md

@@ -1,13 +1,9 @@
 # @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. This tool makes a special effort to let you free to code as you want. Jsenv is simple, easy to understand and well documented.
+Jsenv is a tool to develop test and build projects using JavaScript.  
+Jsenv is simple, easy to understand and well documented.
 
-[Documentation for users](<https://github.com/jsenv/core/wiki/A)-Introduction>) · [Changelog](./CHANGELOG.md)
-
-See also
-
-- [Documentation for contributors](./docs/contributors/README.md)
-- [Documentation for maintainers](./docs/maintainers/README.md)
+[Documentation](<https://github.com/jsenv/core/wiki/A)-Introduction>)
 
 <!-- # Installation
 

package/dist/babel_helpers/dispose/dispose.js

@@ -0,0 +1,45 @@
+/* @minVersion 7.22.0 */
+function dispose_SuppressedError(suppressed, error) {
+    if (typeof SuppressedError !== "undefined") {
+      // eslint-disable-next-line no-undef
+      dispose_SuppressedError = SuppressedError;
+    } else {
+      dispose_SuppressedError = function SuppressedError(suppressed, error) {
+        this.suppressed = suppressed;
+        this.error = error;
+        this.stack = new Error().stack;
+      };
+      dispose_SuppressedError.prototype = Object.create(Error.prototype, {
+        constructor: {
+          value: dispose_SuppressedError,
+          writable: true,
+          configurable: true,
+        },
+      });
+    }
+    return new dispose_SuppressedError(suppressed, error);
+  }
+  
+  export default function _dispose(stack, error, hasError) {
+    function next() {
+      while (stack.length > 0) {
+        try {
+          var r = stack.pop();
+          var p = r.d.call(r.v);
+          if (r.a) return Promise.resolve(p).then(next, err);
+        } catch (e) {
+          return err(e);
+        }
+      }
+      if (hasError) throw error;
+    }
+  
+    function err(e) {
+      error = hasError ? new dispose_SuppressedError(e, error) : e;
+      hasError = true;
+  
+      return next();
+    }
+  
+    return next();
+  }

package/dist/babel_helpers/regeneratorRuntime/regeneratorRuntime.js

@@ -483,7 +483,7 @@ export default function _regeneratorRuntime() {
     };
   };
   function values(iterable) {
-    if (iterable) {
+    if (iterable || iterable === "") {
       var iteratorMethod = iterable[iteratorSymbol];
       if (iteratorMethod) {
         return iteratorMethod.call(iterable);
@@ -508,11 +508,7 @@ export default function _regeneratorRuntime() {
         return (next.next = next);
       }
     }
-
-    // Return an iterator with no values.
-    return {
-      next: doneResult,
-    };
+    throw new TypeError(typeof iterable + " is not iterable");
   }
   exports.values = values;
   function doneResult() {

package/dist/babel_helpers/using/using.js

@@ -0,0 +1,23 @@
+/* @minVersion 7.22.0 */
+
+export default function _using(stack, value, isAwait) {
+    if (value === null || value === void 0) return value;
+    if (typeof value !== "object") {
+      throw new TypeError(
+        "using declarations can only be used with objects, null, or undefined."
+      );
+    }
+    // core-js-pure uses Symbol.for for polyfilling well-known symbols
+    if (isAwait) {
+      var dispose =
+        value[Symbol.asyncDispose || Symbol.for("Symbol.asyncDispose")];
+    }
+    if (dispose === null || dispose === void 0) {
+      dispose = value[Symbol.dispose || Symbol.for("Symbol.dispose")];
+    }
+    if (typeof dispose !== "function") {
+      throw new TypeError(`Property [Symbol.dispose] is not a function.`);
+    }
+    stack.push({ v: value, d: dispose, a: isAwait });
+    return value;
+  }

package/dist/js/ws.js

@@ -1,12 +1,12 @@
 import require$$0 from "stream";
 import require$$0$3 from "events";
 import require$$2 from "http";
-import require$$1 from "https";
-import require$$3 from "net";
-import require$$4 from "tls";
-import require$$5 from "crypto";
+import require$$1 from "crypto";
 import require$$0$1 from "zlib";
 import require$$0$2 from "buffer";
+import require$$1$1 from "https";
+import require$$3 from "net";
+import require$$4 from "tls";
 import require$$7 from "url";
 
 function getDefaultExportFromCjs (x) {
@@ -876,12 +876,15 @@ const { concat, toArrayBuffer, unmask } = bufferUtilExports;
 const { isValidStatusCode: isValidStatusCode$1, isValidUTF8 } = validationExports;
 
 const FastBuffer = Buffer[Symbol.species];
+const promise = Promise.resolve();
+
 const GET_INFO = 0;
 const GET_PAYLOAD_LENGTH_16 = 1;
 const GET_PAYLOAD_LENGTH_64 = 2;
 const GET_MASK = 3;
 const GET_DATA = 4;
 const INFLATING = 5;
+const WAIT_MICROTASK = 6;
 
 /**
  * HyBi Receiver implementation.
@@ -1020,9 +1023,23 @@ let Receiver$1 = class Receiver extends Writable {
         case GET_DATA:
           err = this.getData(cb);
           break;
+        case INFLATING:
+          this._loop = false;
+          return;
         default:
-          // `INFLATING`
+          //
+          // `WAIT_MICROTASK`.
+          //
           this._loop = false;
+
+          //
+          // `queueMicrotask()` is not available in Node.js < 11 and is no
+          // better anyway.
+          //
+          promise.then(() => {
+            this._state = GET_INFO;
+            this.startLoop(cb);
+          });
           return;
       }
     } while (this._loop);
@@ -1405,7 +1422,7 @@ let Receiver$1 = class Receiver extends Writable {
       }
     }
 
-    this._state = GET_INFO;
+    this._state = WAIT_MICROTASK;
   }
 
   /**
@@ -1422,6 +1439,8 @@ let Receiver$1 = class Receiver extends Writable {
       if (data.length === 0) {
         this.emit('conclude', 1005, EMPTY_BUFFER$2);
         this.end();
+
+        this._state = GET_INFO;
       } else {
         const code = data.readUInt16BE(0);
 
@@ -1453,14 +1472,16 @@ let Receiver$1 = class Receiver extends Writable {
 
         this.emit('conclude', code, buf);
         this.end();
+
+        this._state = GET_INFO;
       }
     } else if (this._opcode === 0x09) {
       this.emit('ping', data);
+      this._state = WAIT_MICROTASK;
     } else {
       this.emit('pong', data);
+      this._state = WAIT_MICROTASK;
     }
-
-    this._state = GET_INFO;
   }
 };
 
@@ -1489,8 +1510,8 @@ function error(ErrorCtor, message, prefix, statusCode, errorCode) {
   return err;
 }
 
-/* eslint no-unused-vars: ["error", { "varsIgnorePattern": "^net|tls$" }] */
-const { randomFillSync } = require$$5;
+/* eslint no-unused-vars: ["error", { "varsIgnorePattern": "^Duplex" }] */
+const { randomFillSync } = require$$1;
 
 const PerMessageDeflate$2 = permessageDeflate;
 const { EMPTY_BUFFER: EMPTY_BUFFER$1 } = constants;
@@ -1507,7 +1528,7 @@ let Sender$1 = class Sender {
   /**
    * Creates a Sender instance.
    *
-   * @param {(net.Socket|tls.Socket)} socket The connection socket
+   * @param {Duplex} socket The connection socket
    * @param {Object} [extensions] An object containing the negotiated extensions
    * @param {Function} [generateMask] The function used to generate the masking
    *     key
@@ -2456,14 +2477,14 @@ function format$1(extensions) {
 
 var extension$1 = { format: format$1, parse: parse$2 };
 
-/* eslint no-unused-vars: ["error", { "varsIgnorePattern": "^Readable$" }] */
+/* eslint no-unused-vars: ["error", { "varsIgnorePattern": "^Duplex|Readable$" }] */
 
 const EventEmitter$1 = require$$0$3;
-const https = require$$1;
+const https = require$$1$1;
 const http$1 = require$$2;
 const net = require$$3;
 const tls = require$$4;
-const { randomBytes, createHash: createHash$1 } = require$$5;
+const { randomBytes, createHash: createHash$1 } = require$$1;
 const { URL } = require$$7;
 
 const PerMessageDeflate$1 = permessageDeflate;
@@ -2644,8 +2665,7 @@ let WebSocket$1 = class WebSocket extends EventEmitter$1 {
   /**
    * Set up the socket and the internal resources.
    *
-   * @param {(net.Socket|tls.Socket)} socket The network socket between the
-   *     server and client
+   * @param {Duplex} socket The network socket between the server and client
    * @param {Buffer} head The first packet of the upgraded stream
    * @param {Object} options Options object
    * @param {Function} [options.generateMask] The function used to generate the
@@ -2678,8 +2698,11 @@ let WebSocket$1 = class WebSocket extends EventEmitter$1 {
     receiver.on('ping', receiverOnPing);
     receiver.on('pong', receiverOnPong);
 
-    socket.setTimeout(0);
-    socket.setNoDelay();
+    //
+    // These methods may not be available if `socket` is just a `Duplex`.
+    //
+    if (socket.setTimeout) socket.setTimeout(0);
+    if (socket.setNoDelay) socket.setNoDelay();
 
     if (head.length > 0) socket.unshift(head);
 
@@ -3122,24 +3145,30 @@ function initAsClient(websocket, address, protocols, options) {
 
   if (address instanceof URL) {
     parsedUrl = address;
-    websocket._url = address.href;
   } else {
     try {
       parsedUrl = new URL(address);
     } catch (e) {
       throw new SyntaxError(`Invalid URL: ${address}`);
     }
+  }
 
-    websocket._url = address;
+  if (parsedUrl.protocol === 'http:') {
+    parsedUrl.protocol = 'ws:';
+  } else if (parsedUrl.protocol === 'https:') {
+    parsedUrl.protocol = 'wss:';
   }
 
+  websocket._url = parsedUrl.href;
+
   const isSecure = parsedUrl.protocol === 'wss:';
   const isIpcUrl = parsedUrl.protocol === 'ws+unix:';
   let invalidUrlMessage;
 
   if (parsedUrl.protocol !== 'ws:' && !isSecure && !isIpcUrl) {
     invalidUrlMessage =
-      'The URL\'s protocol must be one of "ws:", "wss:", or "ws+unix:"';
+      'The URL\'s protocol must be one of "ws:", "wss:", ' +
+      '"http:", "https", or "ws+unix:"';
   } else if (isIpcUrl && !parsedUrl.pathname) {
     invalidUrlMessage = "The URL's pathname is empty";
   } else if (parsedUrl.hash) {
@@ -3673,7 +3702,7 @@ function resume(stream) {
 }
 
 /**
- * The listener of the `net.Socket` `'close'` event.
+ * The listener of the socket `'close'` event.
  *
  * @private
  */
@@ -3724,7 +3753,7 @@ function socketOnClose() {
 }
 
 /**
- * The listener of the `net.Socket` `'data'` event.
+ * The listener of the socket `'data'` event.
  *
  * @param {Buffer} chunk A chunk of data
  * @private
@@ -3736,7 +3765,7 @@ function socketOnData(chunk) {
 }
 
 /**
- * The listener of the `net.Socket` `'end'` event.
+ * The listener of the socket `'end'` event.
  *
  * @private
  */
@@ -3749,7 +3778,7 @@ function socketOnEnd() {
 }
 
 /**
- * The listener of the `net.Socket` `'error'` event.
+ * The listener of the socket `'error'` event.
  *
  * @private
  */
@@ -3826,11 +3855,11 @@ function parse(header) {
 
 var subprotocol$1 = { parse };
 
-/* eslint no-unused-vars: ["error", { "varsIgnorePattern": "^net|tls|https$" }] */
+/* eslint no-unused-vars: ["error", { "varsIgnorePattern": "^Duplex$" }] */
 
 const EventEmitter = require$$0$3;
 const http = require$$2;
-const { createHash } = require$$5;
+const { createHash } = require$$1;
 
 const extension = extension$1;
 const PerMessageDeflate = permessageDeflate;
@@ -4044,8 +4073,7 @@ class WebSocketServer extends EventEmitter {
    * Handle a HTTP Upgrade request.
    *
    * @param {http.IncomingMessage} req The request object
-   * @param {(net.Socket|tls.Socket)} socket The network socket between the
-   *     server and client
+   * @param {Duplex} socket The network socket between the server and client
    * @param {Buffer} head The first packet of the upgraded stream
    * @param {Function} cb Callback
    * @public
@@ -4169,8 +4197,7 @@ class WebSocketServer extends EventEmitter {
    * @param {String} key The value of the `Sec-WebSocket-Key` header
    * @param {Set} protocols The subprotocols
    * @param {http.IncomingMessage} req The request object
-   * @param {(net.Socket|tls.Socket)} socket The network socket between the
-   *     server and client
+   * @param {Duplex} socket The network socket between the server and client
    * @param {Buffer} head The first packet of the upgraded stream
    * @param {Function} cb Callback
    * @throws {Error} If called more than once with the same socket
@@ -4300,7 +4327,7 @@ function socketOnError() {
 /**
  * Close the connection when preconditions are not fulfilled.
  *
- * @param {(net.Socket|tls.Socket)} socket The socket of the upgrade request
+ * @param {Duplex} socket The socket of the upgrade request
  * @param {Number} code The HTTP response status code
  * @param {String} [message] The HTTP response body
  * @param {Object} [headers] Additional HTTP response headers
@@ -4341,7 +4368,7 @@ function abortHandshake(socket, code, message, headers) {
  *
  * @param {WebSocketServer} server The WebSocket server
  * @param {http.IncomingMessage} req The request object
- * @param {(net.Socket|tls.Socket)} socket The socket of the upgrade request
+ * @param {Duplex} socket The socket of the upgrade request
  * @param {Number} code The HTTP response status code
  * @param {String} message The HTTP response body
  * @private

package/dist/jsenv_core.js

@@ -10579,9 +10579,13 @@ const jsenvPluginJsModuleFallbackOnWorkers = () => {
       name: `jsenv:js_module_fallback_on_${subtype}`,
       appliesDuring: "*",
       init: (context) => {
+        if (Object.keys(context.runtimeCompat).toString() === "node") {
+          return false;
+        }
         if (context.isSupportedOnCurrentClients(`${subtype}_type_module`)) {
           return false;
         }
+
         return true;
       },
       redirectReference: {
@@ -14797,214 +14801,6 @@ const createRepartitionMessage = ({ html, css, js, json, other, total }) => {
 - `)}`;
 };
 
-const placeholderSymbol = Symbol.for("jsenv_placeholder");
-const PLACEHOLDER = {
-  optional: (value) => {
-    return { [placeholderSymbol]: "optional", value };
-  },
-};
-
-const replacePlaceholders = (content, replacements, urlInfo) => {
-  const magicSource = createMagicSource(content);
-  for (const key of Object.keys(replacements)) {
-    let index = content.indexOf(key);
-    const replacement = replacements[key];
-    let isOptional;
-    let value;
-    if (replacement && replacement[placeholderSymbol]) {
-      const valueBehindSymbol = replacement[placeholderSymbol];
-      isOptional = valueBehindSymbol === "optional";
-      value = replacement.value;
-    } else {
-      value = replacement;
-    }
-    if (index === -1) {
-      if (!isOptional) {
-        urlInfo.context.logger.warn(
-          `placeholder "${key}" not found in ${urlInfo.url}.
---- suggestion a ---
-Add "${key}" in that file.
---- suggestion b ---
-Fix eventual typo in "${key}"?
---- suggestion c ---
-Mark injection as optional using PLACEHOLDER.optional()
-
-import { PLACEHOLDER } from "@jsenv/core"
-
-return {
-  "${key}": PLACEHOLDER.optional(${JSON.stringify(value)})
-}`,
-        );
-      }
-      continue;
-    }
-
-    while (index !== -1) {
-      const start = index;
-      const end = index + key.length;
-      magicSource.replace({
-        start,
-        end,
-        replacement:
-          urlInfo.type === "js_classic" ||
-          urlInfo.type === "js_module" ||
-          urlInfo.type === "html"
-            ? JSON.stringify(value, null, "  ")
-            : value,
-      });
-      index = content.indexOf(key, end);
-    }
-  }
-  return magicSource.toContentAndSourcemap();
-};
-
-const injectGlobals = (content, globals, urlInfo) => {
-  if (urlInfo.type === "html") {
-    return globalInjectorOnHtml(content, globals);
-  }
-  if (urlInfo.type === "js_classic" || urlInfo.type === "js_module") {
-    return globalsInjectorOnJs(content, globals, urlInfo);
-  }
-  throw new Error(`cannot inject globals into "${urlInfo.type}"`);
-};
-
-const globalInjectorOnHtml = (content, globals) => {
-  // ideally we would inject an importmap but browser support is too low
-  // (even worse for worker/service worker)
-  // so for now we inject code into entry points
-  const htmlAst = parseHtmlString(content, {
-    storeOriginalPositions: false,
-  });
-  const clientCode = generateClientCodeForGlobals(globals, {
-    isWebWorker: false,
-  });
-  injectHtmlNodeAsEarlyAsPossible(
-    htmlAst,
-    createHtmlNode({
-      tagName: "script",
-      textContent: clientCode,
-    }),
-    "jsenv:inject_globals",
-  );
-  return stringifyHtmlAst(htmlAst);
-};
-
-const globalsInjectorOnJs = (content, globals, urlInfo) => {
-  const clientCode = generateClientCodeForGlobals(globals, {
-    isWebWorker:
-      urlInfo.subtype === "worker" ||
-      urlInfo.subtype === "service_worker" ||
-      urlInfo.subtype === "shared_worker",
-  });
-  const magicSource = createMagicSource(content);
-  magicSource.prepend(clientCode);
-  return magicSource.toContentAndSourcemap();
-};
-
-const generateClientCodeForGlobals = (globals, { isWebWorker = false }) => {
-  const globalName = isWebWorker ? "self" : "window";
-  return `Object.assign(${globalName}, ${JSON.stringify(
-    globals,
-    null,
-    "  ",
-  )});`;
-};
-
-const jsenvPluginInjections = (rawAssociations) => {
-  let resolvedAssociations;
-
-  return {
-    name: "jsenv:injections",
-    appliesDuring: "*",
-    init: (context) => {
-      resolvedAssociations = URL_META.resolveAssociations(
-        { injectionsGetter: rawAssociations },
-        context.rootDirectoryUrl,
-      );
-    },
-    transformUrlContent: async (urlInfo) => {
-      const { injectionsGetter } = URL_META.applyAssociations({
-        url: asUrlWithoutSearch(urlInfo.url),
-        associations: resolvedAssociations,
-      });
-      if (!injectionsGetter) {
-        return null;
-      }
-      if (typeof injectionsGetter !== "function") {
-        throw new TypeError("injectionsGetter must be a function");
-      }
-      const injections = await injectionsGetter(urlInfo);
-      if (!injections) {
-        return null;
-      }
-      const keys = Object.keys(injections);
-      if (keys.length === 0) {
-        return null;
-      }
-      let someGlobal = false;
-      let someReplacement = false;
-      const globals = {};
-      const replacements = {};
-      for (const key of keys) {
-        const { type, name, value } = createInjection(injections[key], key);
-        if (type === "global") {
-          globals[name] = value;
-          someGlobal = true;
-        } else {
-          replacements[name] = value;
-          someReplacement = true;
-        }
-      }
-
-      if (!someGlobal && !someReplacement) {
-        return null;
-      }
-
-      let content = urlInfo.content;
-      let sourcemap;
-      if (someGlobal) {
-        const globalInjectionResult = injectGlobals(content, globals, urlInfo);
-        content = globalInjectionResult.content;
-        sourcemap = globalInjectionResult.sourcemap;
-      }
-      if (someReplacement) {
-        const replacementResult = replacePlaceholders(
-          content,
-          replacements,
-          urlInfo,
-        );
-        content = replacementResult.content;
-        sourcemap = sourcemap
-          ? composeTwoSourcemaps(sourcemap, replacementResult.sourcemap)
-          : replacementResult.sourcemap;
-      }
-      return {
-        content,
-        sourcemap,
-      };
-    },
-  };
-};
-
-const wellKnowGlobalNames = ["window", "global", "globalThis", "self"];
-const createInjection = (value, key) => {
-  for (const wellKnowGlobalName of wellKnowGlobalNames) {
-    const prefix = `${wellKnowGlobalName}.`;
-    if (key.startsWith(prefix)) {
-      return {
-        type: "global",
-        name: key.slice(prefix.length),
-        value,
-      };
-    }
-  }
-  return {
-    type: "replacement",
-    name: key,
-    value,
-  };
-};
-
 const jsenvPluginReferenceExpectedTypes = () => {
   const redirectJsReference = (reference) => {
     const urlObject = new URL(reference.url);
@@ -15690,6 +15486,8 @@ const parseAndTransformJsReferences = async (
   const magicSource = createMagicSource(urlInfo.content);
   const parallelActions = [];
   const sequentialActions = [];
+  const isNodeJs =
+    Object.keys(urlInfo.context.runtimeCompat).toString() === "node";
 
   const onInlineReference = (inlineReferenceInfo) => {
     const inlineUrl = getUrlForContentInsideJs(inlineReferenceInfo, {
@@ -15737,6 +15535,19 @@ const parseAndTransformJsReferences = async (
     ) {
       urlInfo.data.usesImport = true;
     }
+    if (
+      isNodeJs &&
+      externalReferenceInfo.type === "js_url" &&
+      externalReferenceInfo.expectedSubtype === "worker" &&
+      externalReferenceInfo.expectedType === "js_classic" &&
+      // TODO: it's true also if closest package.json
+      // is type: module
+      urlToExtension$1(
+        new URL(externalReferenceInfo.specifier, urlInfo.url).href,
+      ) === ".mjs"
+    ) {
+      externalReferenceInfo.expectedType = "js_module";
+    }
     const reference = urlInfo.dependencies.found({
       type: externalReferenceInfo.type,
       subtype: externalReferenceInfo.subtype,
@@ -15779,6 +15590,7 @@ const parseAndTransformJsReferences = async (
     isJsModule: urlInfo.type === "js_module",
     isWebWorker: isWebWorkerUrlInfo(urlInfo),
     inlineContent,
+    isNodeJs,
   });
   for (const jsReferenceInfo of jsReferenceInfos) {
     if (jsReferenceInfo.isInline) {
@@ -18353,6 +18165,104 @@ const jsenvPluginProtocolHttp = () => {
   };
 };
 
+const jsenvPluginInjections = (rawAssociations) => {
+  let resolvedAssociations;
+
+  return {
+    name: "jsenv:injections",
+    appliesDuring: "*",
+    init: (context) => {
+      resolvedAssociations = URL_META.resolveAssociations(
+        { injectionsGetter: rawAssociations },
+        context.rootDirectoryUrl,
+      );
+    },
+    transformUrlContent: async (urlInfo) => {
+      const { injectionsGetter } = URL_META.applyAssociations({
+        url: asUrlWithoutSearch(urlInfo.url),
+        associations: resolvedAssociations,
+      });
+      if (!injectionsGetter) {
+        return null;
+      }
+      if (typeof injectionsGetter !== "function") {
+        throw new TypeError("injectionsGetter must be a function");
+      }
+      const injections = await injectionsGetter(urlInfo);
+      if (!injections) {
+        return null;
+      }
+      const keys = Object.keys(injections);
+      if (keys.length === 0) {
+        return null;
+      }
+      return replacePlaceholders(urlInfo.content, injections, urlInfo);
+    },
+  };
+};
+
+const injectionSymbol = Symbol.for("jsenv_injection");
+const INJECTIONS = {
+  optional: (value) => {
+    return { [injectionSymbol]: "optional", value };
+  },
+};
+
+// we export this because it is imported by jsenv_plugin_placeholder.js and unit test
+const replacePlaceholders = (content, replacements, urlInfo) => {
+  const magicSource = createMagicSource(content);
+  for (const key of Object.keys(replacements)) {
+    let index = content.indexOf(key);
+    const replacement = replacements[key];
+    let isOptional;
+    let value;
+    if (replacement && replacement[injectionSymbol]) {
+      const valueBehindSymbol = replacement[injectionSymbol];
+      isOptional = valueBehindSymbol === "optional";
+      value = replacement.value;
+    } else {
+      value = replacement;
+    }
+    if (index === -1) {
+      if (!isOptional) {
+        urlInfo.context.logger.warn(
+          `placeholder "${key}" not found in ${urlInfo.url}.
+--- suggestion a ---
+Add "${key}" in that file.
+--- suggestion b ---
+Fix eventual typo in "${key}"?
+--- suggestion c ---
+Mark injection as optional using INJECTIONS.optional()
+
+import { INJECTIONS } from "@jsenv/core";
+
+return {
+  "${key}": INJECTIONS.optional(${JSON.stringify(value)}),
+}`,
+        );
+      }
+      continue;
+    }
+
+    while (index !== -1) {
+      const start = index;
+      const end = index + key.length;
+      magicSource.replace({
+        start,
+        end,
+        replacement:
+          urlInfo.type === "js_classic" ||
+          urlInfo.type === "js_module" ||
+          urlInfo.type === "html"
+            ? JSON.stringify(value, null, "  ")
+            : value,
+      });
+      index = content.indexOf(key, end);
+    }
+  }
+  return magicSource.toContentAndSourcemap();
+};
+
 const jsenvPluginInliningAsDataUrl = () => {
   return {
     name: "jsenv:inlining_as_data_url",
@@ -18885,9 +18795,9 @@ const babelPluginMetadataImportMetaScenarios = () => {
 
 /*
  * Source code can contain the following
- * - __dev__
- * - __build__
- * A global will be injected with true/false when needed
+ * - __DEV__
+ * - __BUILD__
+ * That will be replaced with true/false
  */
 
 
@@ -18896,8 +18806,8 @@ const jsenvPluginGlobalScenarios = () => {
     return replacePlaceholders(
       urlInfo.content,
       {
-        __DEV__: PLACEHOLDER.optional(urlInfo.context.dev),
-        __BUILD__: PLACEHOLDER.optional(urlInfo.context.build),
+        __DEV__: INJECTIONS.optional(urlInfo.context.dev),
+        __BUILD__: INJECTIONS.optional(urlInfo.context.build),
       },
       urlInfo,
     );
@@ -22982,4 +22892,4 @@ const createBuildFilesService = ({ buildDirectoryUrl, buildMainFilePath }) => {
 
 const SECONDS_IN_30_DAYS = 60 * 60 * 24 * 30;
 
-export { build, startBuildServer, startDevServer };
+export { INJECTIONS, build, startBuildServer, startDevServer };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jsenv/core",
-  "version": "38.1.1",
+  "version": "38.2.1",
   "description": "Tool to develop, test and build js projects",
   "license": "MIT",
   "author": {
@@ -61,27 +61,26 @@
   "dependencies": {
     "@financial-times/polyfill-useragent-normaliser": "1.10.2",
     "@jsenv/abort": "4.2.4",
-    "@jsenv/ast": "5.1.2",
+    "@jsenv/ast": "5.1.3",
     "@jsenv/filesystem": "4.2.6",
     "@jsenv/importmap": "1.2.1",
     "@jsenv/integrity": "0.0.1",
     "@jsenv/log": "3.4.0",
     "@jsenv/node-esm-resolution": "1.0.1",
-    "@jsenv/js-module-fallback": "1.3.3",
+    "@jsenv/js-module-fallback": "1.3.4",
     "@jsenv/runtime-compat": "1.2.0",
-    "@jsenv/server": "15.1.0",
-    "@jsenv/sourcemap": "1.2.1",
-    "@jsenv/plugin-injections": "1.0.0",
-    "@jsenv/plugin-bundling": "2.5.1",
-    "@jsenv/plugin-minification": "1.5.0",
-    "@jsenv/plugin-transpilation": "1.3.2",
-    "@jsenv/plugin-supervisor": "1.3.2",
+    "@jsenv/server": "15.1.1",
+    "@jsenv/sourcemap": "1.2.2",
+    "@jsenv/plugin-bundling": "2.5.3",
+    "@jsenv/plugin-minification": "1.5.1",
+    "@jsenv/plugin-transpilation": "1.3.3",
+    "@jsenv/plugin-supervisor": "1.3.3",
     "@jsenv/url-meta": "8.1.0",
     "@jsenv/urls": "2.2.1",
     "@jsenv/utils": "2.0.1"
   },
   "devDependencies": {
-    "@babel/eslint-parser": "7.22.9",
+    "@babel/eslint-parser": "7.22.15",
     "@babel/plugin-syntax-import-assertions": "7.22.5",
     "babel-plugin-transform-async-to-promises": "0.8.18",
     "@jsenv/assert": "./packages/independent/assert/",
@@ -93,12 +92,12 @@
     "@jsenv/performance-impact": "4.1.1",
     "@jsenv/plugin-as-js-classic": "./packages/related/plugin-as-js-classic/",
     "@jsenv/test": "./packages/related/test/",
-    "eslint": "8.46.0",
+    "eslint": "8.49.0",
     "eslint-plugin-html": "7.1.0",
-    "eslint-plugin-import": "2.28.0",
-    "eslint-plugin-react": "7.33.1",
+    "eslint-plugin-import": "2.28.1",
+    "eslint-plugin-react": "7.33.2",
     "open": "9.1.0",
-    "playwright": "1.36.2",
-    "prettier": "3.0.0"
+    "playwright": "1.37.1",
+    "prettier": "3.0.3"
   }
 }

package/src/main.js

@@ -3,3 +3,6 @@ export { startDevServer } from "./dev/start_dev_server.js";
 // build
 export { build } from "./build/build.js";
 export { startBuildServer } from "./build/start_build_server.js";
+
+// others
+export { INJECTIONS } from "./plugins/injections/jsenv_plugin_injections.js";

package/src/plugins/global_scenarios/jsenv_plugin_global_scenarios.js

@@ -1,19 +1,22 @@
 /*
  * Source code can contain the following
- * - __dev__
- * - __build__
- * A global will be injected with true/false when needed
+ * - __DEV__
+ * - __BUILD__
+ * That will be replaced with true/false
  */
 
-import { replacePlaceholders, PLACEHOLDER } from "@jsenv/plugin-injections";
+import {
+  replacePlaceholders,
+  INJECTIONS,
+} from "../injections/jsenv_plugin_injections.js";
 
 export const jsenvPluginGlobalScenarios = () => {
   const transformIfNeeded = (urlInfo) => {
     return replacePlaceholders(
       urlInfo.content,
       {
-        __DEV__: PLACEHOLDER.optional(urlInfo.context.dev),
-        __BUILD__: PLACEHOLDER.optional(urlInfo.context.build),
+        __DEV__: INJECTIONS.optional(urlInfo.context.dev),
+        __BUILD__: INJECTIONS.optional(urlInfo.context.build),
       },
       urlInfo,
     );

package/src/plugins/injections/internal/inject_globals.js

@@ -0,0 +1,59 @@
+import { createMagicSource } from "@jsenv/sourcemap";
+import {
+  parseHtmlString,
+  injectHtmlNodeAsEarlyAsPossible,
+  createHtmlNode,
+  stringifyHtmlAst,
+} from "@jsenv/ast";
+
+export const injectGlobals = (content, globals, urlInfo) => {
+  if (urlInfo.type === "html") {
+    return globalInjectorOnHtml(content, globals, urlInfo);
+  }
+  if (urlInfo.type === "js_classic" || urlInfo.type === "js_module") {
+    return globalsInjectorOnJs(content, globals, urlInfo);
+  }
+  throw new Error(`cannot inject globals into "${urlInfo.type}"`);
+};
+
+const globalInjectorOnHtml = (content, globals) => {
+  // ideally we would inject an importmap but browser support is too low
+  // (even worse for worker/service worker)
+  // so for now we inject code into entry points
+  const htmlAst = parseHtmlString(content, {
+    storeOriginalPositions: false,
+  });
+  const clientCode = generateClientCodeForGlobals(globals, {
+    isWebWorker: false,
+  });
+  injectHtmlNodeAsEarlyAsPossible(
+    htmlAst,
+    createHtmlNode({
+      tagName: "script",
+      textContent: clientCode,
+    }),
+    "jsenv:inject_globals",
+  );
+  return stringifyHtmlAst(htmlAst);
+};
+
+const globalsInjectorOnJs = (content, globals, urlInfo) => {
+  const clientCode = generateClientCodeForGlobals(globals, {
+    isWebWorker:
+      urlInfo.subtype === "worker" ||
+      urlInfo.subtype === "service_worker" ||
+      urlInfo.subtype === "shared_worker",
+  });
+  const magicSource = createMagicSource(content);
+  magicSource.prepend(clientCode);
+  return magicSource.toContentAndSourcemap();
+};
+
+const generateClientCodeForGlobals = (globals, { isWebWorker = false }) => {
+  const globalName = isWebWorker ? "self" : "window";
+  return `Object.assign(${globalName}, ${JSON.stringify(
+    globals,
+    null,
+    "  ",
+  )});`;
+};

package/src/plugins/injections/jsenv_plugin_injections.js

@@ -0,0 +1,101 @@
+import { URL_META } from "@jsenv/url-meta";
+import { asUrlWithoutSearch } from "@jsenv/urls";
+import { createMagicSource } from "@jsenv/sourcemap";
+
+export const jsenvPluginInjections = (rawAssociations) => {
+  let resolvedAssociations;
+
+  return {
+    name: "jsenv:injections",
+    appliesDuring: "*",
+    init: (context) => {
+      resolvedAssociations = URL_META.resolveAssociations(
+        { injectionsGetter: rawAssociations },
+        context.rootDirectoryUrl,
+      );
+    },
+    transformUrlContent: async (urlInfo) => {
+      const { injectionsGetter } = URL_META.applyAssociations({
+        url: asUrlWithoutSearch(urlInfo.url),
+        associations: resolvedAssociations,
+      });
+      if (!injectionsGetter) {
+        return null;
+      }
+      if (typeof injectionsGetter !== "function") {
+        throw new TypeError("injectionsGetter must be a function");
+      }
+      const injections = await injectionsGetter(urlInfo);
+      if (!injections) {
+        return null;
+      }
+      const keys = Object.keys(injections);
+      if (keys.length === 0) {
+        return null;
+      }
+      return replacePlaceholders(urlInfo.content, injections, urlInfo);
+    },
+  };
+};
+
+const injectionSymbol = Symbol.for("jsenv_injection");
+export const INJECTIONS = {
+  optional: (value) => {
+    return { [injectionSymbol]: "optional", value };
+  },
+};
+
+// we export this because it is imported by jsenv_plugin_placeholder.js and unit test
+export const replacePlaceholders = (content, replacements, urlInfo) => {
+  const magicSource = createMagicSource(content);
+  for (const key of Object.keys(replacements)) {
+    let index = content.indexOf(key);
+    const replacement = replacements[key];
+    let isOptional;
+    let value;
+    if (replacement && replacement[injectionSymbol]) {
+      const valueBehindSymbol = replacement[injectionSymbol];
+      isOptional = valueBehindSymbol === "optional";
+      value = replacement.value;
+    } else {
+      value = replacement;
+    }
+    if (index === -1) {
+      if (!isOptional) {
+        urlInfo.context.logger.warn(
+          `placeholder "${key}" not found in ${urlInfo.url}.
+--- suggestion a ---
+Add "${key}" in that file.
+--- suggestion b ---
+Fix eventual typo in "${key}"?
+--- suggestion c ---
+Mark injection as optional using INJECTIONS.optional()
+
+import { INJECTIONS } from "@jsenv/core";
+
+return {
+  "${key}": INJECTIONS.optional(${JSON.stringify(value)}),
+}`,
+        );
+      }
+      continue;
+    }
+
+    while (index !== -1) {
+      const start = index;
+      const end = index + key.length;
+      magicSource.replace({
+        start,
+        end,
+        replacement:
+          urlInfo.type === "js_classic" ||
+          urlInfo.type === "js_module" ||
+          urlInfo.type === "html"
+            ? JSON.stringify(value, null, "  ")
+            : value,
+      });
+      index = content.indexOf(key, end);
+    }
+  }
+  return magicSource.toContentAndSourcemap();
+};

package/src/plugins/plugins.js

@@ -1,5 +1,4 @@
 import { jsenvPluginSupervisor } from "@jsenv/plugin-supervisor";
-import { jsenvPluginInjections } from "@jsenv/plugin-injections";
 import { jsenvPluginTranspilation } from "@jsenv/plugin-transpilation";
 
 import { jsenvPluginReferenceAnalysis } from "./reference_analysis/jsenv_plugin_reference_analysis.js";
@@ -9,6 +8,7 @@ import { jsenvPluginWebResolution } from "./resolution_web/jsenv_plugin_web_reso
 import { jsenvPluginVersionSearchParam } from "./version_search_param/jsenv_plugin_version_search_param.js";
 import { jsenvPluginProtocolFile } from "./protocol_file/jsenv_plugin_protocol_file.js";
 import { jsenvPluginProtocolHttp } from "./protocol_http/jsenv_plugin_protocol_http.js";
+import { jsenvPluginInjections } from "./injections/jsenv_plugin_injections.js";
 import { jsenvPluginInlining } from "./inlining/jsenv_plugin_inlining.js";
 import { jsenvPluginCommonJsGlobals } from "./commonjs_globals/jsenv_plugin_commonjs_globals.js";
 import { jsenvPluginImportMetaScenarios } from "./import_meta_scenarios/jsenv_plugin_import_meta_scenarios.js";

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

@@ -1,5 +1,6 @@
 import { createMagicSource } from "@jsenv/sourcemap";
 import { parseJsUrls, getUrlForContentInsideJs } from "@jsenv/ast";
+import { urlToExtension } from "@jsenv/urls";
 import { JS_QUOTES } from "@jsenv/utils/src/string/js_quotes.js";
 
 import { isWebWorkerUrlInfo } from "@jsenv/core/src/kitchen/web_workers.js";
@@ -34,6 +35,8 @@ const parseAndTransformJsReferences = async (
   const magicSource = createMagicSource(urlInfo.content);
   const parallelActions = [];
   const sequentialActions = [];
+  const isNodeJs =
+    Object.keys(urlInfo.context.runtimeCompat).toString() === "node";
 
   const onInlineReference = (inlineReferenceInfo) => {
     const inlineUrl = getUrlForContentInsideJs(inlineReferenceInfo, {
@@ -81,6 +84,19 @@ const parseAndTransformJsReferences = async (
     ) {
       urlInfo.data.usesImport = true;
     }
+    if (
+      isNodeJs &&
+      externalReferenceInfo.type === "js_url" &&
+      externalReferenceInfo.expectedSubtype === "worker" &&
+      externalReferenceInfo.expectedType === "js_classic" &&
+      // TODO: it's true also if closest package.json
+      // is type: module
+      urlToExtension(
+        new URL(externalReferenceInfo.specifier, urlInfo.url).href,
+      ) === ".mjs"
+    ) {
+      externalReferenceInfo.expectedType = "js_module";
+    }
     const reference = urlInfo.dependencies.found({
       type: externalReferenceInfo.type,
       subtype: externalReferenceInfo.subtype,
@@ -123,6 +139,7 @@ const parseAndTransformJsReferences = async (
     isJsModule: urlInfo.type === "js_module",
     isWebWorker: isWebWorkerUrlInfo(urlInfo),
     inlineContent,
+    isNodeJs,
   });
   for (const jsReferenceInfo of jsReferenceInfos) {
     if (jsReferenceInfo.isInline) {