@jsenv/core 27.0.0-alpha.9 → 27.0.0-alpha.92

package/src/{omega → plugins}/plugin_controller.js

@@ -1,14 +1,16 @@
+import { timeStart } from "@jsenv/server"
+
 export const createPluginController = ({
   plugins,
   scenario,
   hooks = [
-    "resolve",
-    "normalize",
-    "load",
-    "transform",
-    "transformReferencedUrl",
-    "formatReferencedUrl",
-    "finalize",
+    "resolveUrl",
+    "redirectUrl",
+    "fetchUrlContent",
+    "transformUrlContent",
+    "transformUrlSearchParams",
+    "formatUrl",
+    "finalizeUrlContent",
     "cooked",
     "destroy",
   ],
@@ -47,7 +49,13 @@ export const createPluginController = ({
     }
     currentPlugin = hook.plugin
     currentHookName = hook.hookName
+    const timeEnd = timeStart(
+      `${currentHookName}-${currentPlugin.name.replace("jsenv:", "")}`,
+    )
     let valueReturned = hookFn(info, context)
+    if (info.timing) {
+      Object.assign(info.timing, timeEnd())
+    }
     valueReturned = assertAndNormalizeReturnValue(hook.hookName, valueReturned)
     currentPlugin = null
     currentHookName = null
@@ -60,7 +68,13 @@ export const createPluginController = ({
     }
     currentPlugin = hook.plugin
     currentHookName = hook.hookName
+    const timeEnd = timeStart(
+      `${currentHookName}-${currentPlugin.name.replace("jsenv:", "")}`,
+    )
     let valueReturned = await hookFn(info, context)
+    if (info.timing) {
+      Object.assign(info.timing, timeEnd())
+    }
     valueReturned = assertAndNormalizeReturnValue(hook.hookName, valueReturned)
     currentPlugin = null
     currentHookName = null
@@ -99,6 +113,9 @@ export const createPluginController = ({
   }
   const callAsyncHooksUntil = (hookName, info, context) => {
     const hooks = hookGroups[hookName]
+    if (hooks.length === 0) {
+      return null
+    }
     return new Promise((resolve, reject) => {
       const visit = (index) => {
         if (index >= hooks.length) {
@@ -142,15 +159,35 @@ const flattenAndFilterPlugins = (pluginsRaw, { scenario }) => {
       return
     }
     if (typeof pluginEntry === "object" && pluginEntry !== null) {
+      if (!pluginEntry.name) {
+        pluginEntry.name = "anonymous"
+      }
       const { appliesDuring } = pluginEntry
       if (appliesDuring === undefined) {
         console.warn(`"appliesDuring" is undefined on ${pluginEntry.name}`)
+        return
       }
       if (appliesDuring === "*") {
         plugins.push(pluginEntry)
         return
       }
-      if (appliesDuring && appliesDuring[scenario]) {
+      if (typeof appliesDuring === "string") {
+        if (!["dev", "build", "test"].includes(appliesDuring)) {
+          throw new Error(
+            `"appliesDuring" must be "dev", "test" or "build", got ${appliesDuring}`,
+          )
+        }
+        if (appliesDuring === scenario) {
+          plugins.push(pluginEntry)
+        }
+        return
+      }
+      if (typeof appliesDuring !== "object") {
+        throw new Error(
+          `"appliesDuring" must be an object or a string, got ${appliesDuring}`,
+        )
+      }
+      if (appliesDuring[scenario]) {
         plugins.push(pluginEntry)
         return
       }
@@ -203,7 +240,7 @@ const assertAndNormalizeReturnValue = (hookName, returnValue) => {
 const returnValueAssertions = [
   {
     name: "url_assertion",
-    appliesTo: ["resolve", "redirect"],
+    appliesTo: ["resolveUrl", "redirectUrl"],
     assertion: (valueReturned) => {
       if (valueReturned instanceof URL) {
         return valueReturned.href
@@ -218,14 +255,22 @@ const returnValueAssertions = [
   },
   {
     name: "content_assertion",
-    appliesTo: ["load", "transform", "finalize"],
+    appliesTo: [
+      "fetchUrlContent",
+      "transformUrlContent",
+      "finalizeUrlContent",
+      "optimizeUrlContent",
+    ],
     assertion: (valueReturned) => {
       if (typeof valueReturned === "string" || Buffer.isBuffer(valueReturned)) {
         return { content: valueReturned }
       }
       if (typeof valueReturned === "object") {
-        const { content } = valueReturned
-        if (typeof content !== "string" && !Buffer.isBuffer(content)) {
+        const { shouldHandle, content, body } = valueReturned
+        if (shouldHandle === false) {
+          return undefined
+        }
+        if (typeof content !== "string" && !Buffer.isBuffer(content) && !body) {
           throw new Error(
             `Unexpected "content" returned by plugin: it must be a string or a buffer; got ${content}`,
           )

package/src/plugins/plugins.js

@@ -0,0 +1,91 @@
+import { jsenvPluginUrlAnalysis } from "../plugins/url_analysis/jsenv_plugin_url_analysis.js"
+import { jsenvPluginLeadingSlash } from "./leading_slash/jsenv_plugin_leading_slash.js"
+import { jsenvPluginImportmap } from "./importmap/jsenv_plugin_importmap.js"
+import { jsenvPluginUrlResolution } from "./url_resolution/jsenv_plugin_url_resolution.js"
+import { jsenvPluginNodeEsmResolution } from "./node_esm_resolution/jsenv_plugin_node_esm_resolution.js"
+import { jsenvPluginUrlVersion } from "./url_version/jsenv_plugin_url_version.js"
+import { jsenvPluginFileUrls } from "./file_urls/jsenv_plugin_file_urls.js"
+import { jsenvPluginHttpUrls } from "./http_urls/jsenv_plugin_http_urls.js"
+import { jsenvPluginInline } from "./inline/jsenv_plugin_inline.js"
+import { jsenvPluginHtmlSupervisor } from "./html_supervisor/jsenv_plugin_html_supervisor.js"
+import { jsenvPluginCommonJsGlobals } from "./commonjs_globals/jsenv_plugin_commonjs_globals.js"
+import { jsenvPluginImportMetaScenarios } from "./import_meta_scenarios/jsenv_plugin_import_meta_scenarios.js"
+import { jsenvPluginTranspilation } from "./transpilation/jsenv_plugin_transpilation.js"
+import { jsenvPluginNodeRuntime } from "./node_runtime/jsenv_plugin_node_runtime.js"
+// build only
+import { jsenvPluginBundling } from "./bundling/jsenv_plugin_bundling.js"
+import { jsenvPluginMinification } from "./minification/jsenv_plugin_minification.js"
+// autoreload
+import { jsenvPluginImportMetaHot } from "./import_meta_hot/jsenv_plugin_import_meta_hot.js"
+import { jsenvPluginAutoreload } from "./autoreload/jsenv_plugin_autoreload.js"
+import { jsenvPluginCacheControl } from "./cache_control/jsenv_plugin_cache_control.js"
+
+export const getCorePlugins = ({
+  rootDirectoryUrl,
+  urlGraph,
+  scenario,
+  runtimeCompat,
+
+  urlAnalysis = {},
+  htmlSupervisor,
+  nodeEsmResolution,
+  fileSystemMagicResolution,
+  directoryReferenceAllowed,
+  transpilation = true,
+  minification = false,
+  bundling = false,
+
+  clientAutoreload = false,
+  clientFileChangeCallbackList,
+  clientFilesPruneCallbackList,
+} = {}) => {
+  if (htmlSupervisor === true) {
+    htmlSupervisor = {}
+  }
+  if (nodeEsmResolution === true) {
+    nodeEsmResolution = {}
+  }
+  return [
+    jsenvPluginUrlAnalysis({ rootDirectoryUrl, ...urlAnalysis }),
+    jsenvPluginTranspilation(transpilation),
+    ...(htmlSupervisor ? [jsenvPluginHtmlSupervisor(htmlSupervisor)] : []), // before inline as it turns inline <script> into <script src>
+    jsenvPluginImportmap(),
+    // before node esm to handle bare specifiers
+    // + before node esm to handle importmap before inline content
+    jsenvPluginInline(), // before "file urls" to resolve and load inline urls
+    jsenvPluginFileUrls({
+      directoryReferenceAllowed,
+      ...fileSystemMagicResolution,
+    }),
+    jsenvPluginHttpUrls(),
+    jsenvPluginLeadingSlash(),
+    // before url resolution to handle "js_import_export" resolution
+    jsenvPluginNodeEsmResolution({
+      rootDirectoryUrl,
+      runtimeCompat,
+      ...nodeEsmResolution,
+    }),
+    jsenvPluginUrlResolution(),
+    jsenvPluginUrlVersion(),
+    jsenvPluginCommonJsGlobals(),
+    jsenvPluginImportMetaScenarios(),
+
+    jsenvPluginNodeRuntime({ runtimeCompat }),
+    jsenvPluginBundling(bundling),
+    jsenvPluginMinification(minification),
+
+    jsenvPluginImportMetaHot(),
+    ...(clientAutoreload
+      ? [
+          jsenvPluginAutoreload({
+            rootDirectoryUrl,
+            urlGraph,
+            scenario,
+            clientFileChangeCallbackList,
+            clientFilesPruneCallbackList,
+          }),
+        ]
+      : []),
+    jsenvPluginCacheControl(),
+  ]
+}

package/src/plugins/transpilation/as_js_classic/client/s.js

@@ -0,0 +1,429 @@
+/*
+ * This file is a modified version of https://github.com/systemjs/systemjs/blob/main/dist/s.js
+ * with the following changes:
+ *
+ * - Code can use aync/await, const, ... because an es5 version of this file is generated
+ * - Can use document.currentScript because we don't support IE
+ * - auto import inline System.register
+ * - auto import first System.register in web workers
+ * - queing events in web workers
+ * - no support for importmap because jsenv don't need it
+ */
+
+;(function () {
+  /* eslint-env browser */
+  /* globals self */
+
+  const loadRegistry = Object.create(null)
+  const registerRegistry = Object.create(null)
+  let inlineScriptCount = 0
+  const System = {}
+
+  const hasDocument = typeof document === "object"
+  const envGlobal = self
+  const isWorker =
+    !hasDocument &&
+    typeof envGlobal.WorkerGlobalScope === "function" &&
+    envGlobal instanceof envGlobal.WorkerGlobalScope
+  const isServiceWorker = isWorker && typeof self.skipWaiting === "function"
+  envGlobal.System = System
+
+  let baseUrl = envGlobal.location.href.split("#")[0].split("?")[0]
+  const lastSlashIndex = baseUrl.lastIndexOf("/")
+  if (lastSlashIndex !== -1) {
+    baseUrl = baseUrl.slice(0, lastSlashIndex + 1)
+  }
+
+  const resolveUrl = (specifier, baseUrl) => new URL(specifier, baseUrl).href
+
+  if (hasDocument) {
+    const baseElement = document.querySelector("base[href]")
+    if (baseElement) {
+      baseUrl = baseElement.href
+    }
+    System.register = (deps, declare) => {
+      if (!document.currentScript) {
+        throw new Error("unexpected call to System.register (document.currentScript is undefined)")
+      }
+      if (document.currentScript.__s__) {
+        registerRegistry[document.currentScript.src] = [deps, declare]
+        return null
+      }
+      const url =
+        document.currentScript.src ||
+        `${window.location.href}__inline_script__${++inlineScriptCount}`
+      registerRegistry[url] = [deps, declare]
+      return _import(url)
+    }
+    System.instantiate = (url) => {
+      const script = createScript(url)
+      return new Promise(function (resolve, reject) {
+        let lastWindowErrorUrl
+        let lastWindowError
+        const windowErrorCallback = (event) => {
+          lastWindowErrorUrl = event.filename
+          lastWindowError = event.error
+        }
+        window.addEventListener("error", windowErrorCallback)
+        script.addEventListener("error", () => {
+          window.removeEventListener("error", windowErrorCallback)
+          reject(`An error occured while loading url with <script> for ${url}`)
+        })
+        script.addEventListener("load", () => {
+          window.removeEventListener("error", windowErrorCallback)
+          document.head.removeChild(script)
+          // Note that if an error occurs that isn't caught by this if statement,
+          // that getRegister will return null and a "did not instantiate" error will be thrown.
+          if (lastWindowErrorUrl === url) {
+            reject(lastWindowError)
+          } else {
+            resolve()
+          }
+        })
+        document.head.appendChild(script)
+      })
+    }
+    const createScript = (url) => {
+      const script = document.createElement("script")
+      script.async = true
+      // Only add cross origin for actual cross origin
+      // this is because Safari triggers for all
+      // - https://bugs.webkit.org/show_bug.cgi?id=171566
+      if (url.indexOf(`${self.location.origin}/`)) {
+        script.crossOrigin = "anonymous"
+      }
+      script.__s__ = true
+      script.src = url
+      return script
+    }
+  }
+  if (isWorker) {
+    /*
+     * SystemJs loads X files before executing the worker/service worker main file
+     * It mean events dispatched during this phase could be missed
+     * A warning like the one below is displayed in chrome devtools:
+     * "Event handler of 'install' event must be added on the initial evaluation of worker script"
+     * To fix that code below listen for these events early and redispatch them later
+     * once the worker file is executed (the listeners are installed)
+     */
+    const firstImportCallbacks = []
+    if (isServiceWorker) {
+      // for service worker there is more events to listen
+      // and, to get rid of the warning, we override self.addEventListener
+      const eventsToCatch = ["message", "install", "activate", "fetch"]
+      const eventCallbackProxies = {}
+      const firstImportPromise = new Promise((resolve) => {
+        firstImportCallbacks.push(resolve)
+      })
+      eventsToCatch.forEach((eventName) => {
+        const eventsToDispatch = []
+        const eventCallback = (event) => {
+          const eventCallbackProxy = eventCallbackProxies[event.type]
+          if (eventCallbackProxy) {
+            eventCallbackProxy(event)
+          } else {
+            eventsToDispatch.push(event)
+            event.waitUntil(firstImportPromise)
+          }
+        }
+        self.addEventListener(eventName, eventCallback)
+        firstImportCallbacks.push(() => {
+          if (eventsToDispatch.length) {
+            const eventCallbackProxy =
+              eventCallbackProxies[eventsToDispatch[0].type]
+            if (eventCallbackProxy) {
+              eventsToDispatch.forEach((event) => {
+                eventCallbackProxy(event)
+              })
+            }
+            eventsToDispatch.length = 0
+          }
+        })
+      })
+
+      const addEventListener = self.addEventListener
+      self.addEventListener = function (eventName, callback, options) {
+        if (eventsToCatch.indexOf(eventName) > -1) {
+          eventCallbackProxies[eventName] = callback
+          return null
+        }
+        return addEventListener.call(self, eventName, callback, options)
+      }
+    } else {
+      const eventsToCatch = ["message"]
+      eventsToCatch.forEach((eventName) => {
+        var eventQueue = []
+        var eventCallback = (event) => {
+          eventQueue.push(event)
+        }
+        self.addEventListener(eventName, eventCallback)
+        firstImportCallbacks.push(() => {
+          self.removeEventListener(eventName, eventCallback)
+          eventQueue.forEach(function (event) {
+            self.dispatchEvent(event)
+          })
+          eventQueue.length = 0
+        })
+      })
+    }
+
+    System.register = async (deps, declare) => {
+      System.register = () => {
+        throw new Error("unexpected call to System.register (called outside url instantiation)")
+      }
+      const url = self.location.href
+      registerRegistry[url] = [deps, declare]
+      const namespace = await _import(url)
+      firstImportCallbacks.forEach((firstImportCallback) => {
+        firstImportCallback()
+      })
+      firstImportCallbacks.length = 0
+      return namespace
+    }
+    System.instantiate = async (url) => {
+      const response = await self.fetch(url, {
+        credentials: "same-origin",
+      })
+      if (!response.ok) {
+        throw Error(`Failed to fetch module at ${url}`)
+      }
+      let source = await response.text()
+      if (source.indexOf("//# sourceURL=") < 0) {
+        source += `\n//# sourceURL=${url}`
+      }
+      const register = System.register
+      System.register = (deps, declare) => {
+        registerRegistry[url] = [deps, declare]
+      }
+      ;(0, self.eval)(source)
+      System.register = register
+    }
+  }
+
+  const _import = (specifier, parentUrl) => {
+    const url = resolveUrl(specifier, parentUrl)
+    const load = getOrCreateLoad(url, parentUrl)
+    return load.completionPromise || startExecution(load)
+  }
+
+  const getOrCreateLoad = (url, firstParentUrl) => {
+    const existingLoad = loadRegistry[url]
+    if (existingLoad) {
+      return existingLoad
+    }
+
+    const load = {
+      url,
+    }
+    loadRegistry[url] = load
+
+    const importerSetters = []
+    load.importerSetters = importerSetters
+
+    const namespace = createNamespace()
+    load.namespace = namespace
+
+    load.instantiatePromise = (async () => {
+      try {
+        let registration = registerRegistry[url]
+        if (!registration) {
+          const instantiateReturnValue = System.instantiate(url, firstParentUrl)
+          if (instantiateReturnValue) {
+            await instantiateReturnValue
+          }
+          registration = registerRegistry[url]
+        }
+        if (!registration) {
+          throw new Error(`System.register() not called after executing ${url}`)
+        }
+
+        const _export = (firstArg, secondArg) => {
+          load.hoistedExports = true
+          let changed = false
+          if (typeof firstArg === "string") {
+            const name = firstArg
+            const value = secondArg
+            if (!(name in namespace) || namespace[name] !== value) {
+              namespace[name] = value
+              changed = true
+            }
+          } else {
+            Object.keys(firstArg).forEach((name) => {
+              const value = firstArg[name]
+              if (!(name in namespace) || namespace[name] !== value) {
+                namespace[name] = value
+                changed = true
+              }
+            })
+            if (firstArg && firstArg.__esModule) {
+              namespace.__esModule = firstArg.__esModule
+            }
+          }
+          if (changed) {
+            importerSetters.forEach((importerSetter) => {
+              if (importerSetter) {
+                importerSetter(namespace)
+              }
+            })
+          }
+          return secondArg
+        }
+        const [deps, declare] = registration
+        const { setters, execute = () => {} } = declare(_export, {
+          import: (importId) => _import(importId, url),
+          meta: createMeta(url),
+        })
+        load.deps = deps
+        load.setters = setters
+        load.execute = execute
+      } catch (e) {
+        load.error = e
+        load.execute = null
+      }
+    })()
+
+    load.linkPromise = (async () => {
+      await load.instantiatePromise
+      const dependencyLoads = await Promise.all(
+        load.deps.map(async (dep, index) => {
+          const setter = load.setters[index]
+          const dependencyUrl = resolveUrl(dep, url)
+          const dependencyLoad = getOrCreateLoad(dependencyUrl, url)
+          if (dependencyLoad.instantiatePromise) {
+            await dependencyLoad.instantiatePromise
+          }
+          if (setter) {
+            dependencyLoad.importerSetters.push(setter)
+            if (
+              dependencyLoad.hoistedExports ||
+              !dependencyLoad.instantiatePromise
+            ) {
+              setter(dependencyLoad.namespace)
+            }
+          }
+          return dependencyLoad
+        }),
+      )
+      load.dependencyLoads = dependencyLoads
+    })()
+
+    return load
+  }
+
+  const startExecution = async (load) => {
+    load.completionPromise = (async () => {
+      await instantiateAll(load, load, {})
+      await postOrderExec(load, {})
+      return load.namespace
+    })()
+    return load.completionPromise
+  }
+
+  const instantiateAll = async (load, parent, loaded) => {
+    if (loaded[load.url]) {
+      return
+    }
+    loaded[load.url] = true
+    try {
+      if (load.linkPromise) {
+        // load.linkPromise is null once instantiated
+        await load.linkPromise
+      }
+      // if (!load.parent || !load.parent.execute) {
+      //   load.parent = parent
+      // }
+      await Promise.all(
+        load.dependencyLoads.map((dependencyLoad) => {
+          return instantiateAll(dependencyLoad, parent, loaded)
+        }),
+      )
+    } catch (error) {
+      if (load.error) {
+        throw error
+      }
+      load.execute = null
+      throw error
+    }
+  }
+
+  const postOrderExec = async (load, seen) => {
+    if (seen[load.url]) {
+      return
+    }
+    seen[load.url] = true
+    if (!load.execute) {
+      if (load.error) {
+        throw load.error
+      }
+      if (load.executePromise) {
+        await load.executePromise
+      }
+      return
+    }
+
+    // deps execute first, unless circular
+    const depLoadPromises = []
+    load.dependencyLoads.forEach((dependencyLoad) => {
+      try {
+        const depLoadPromise = postOrderExec(dependencyLoad, seen)
+        if (depLoadPromise) {
+          depLoadPromises.push(depLoadPromise)
+        }
+      } catch (err) {
+        load.execute = null
+        load.error = err
+        throw err
+      }
+    })
+    if (depLoadPromises.length) {
+      await Promise.all(depLoadPromises)
+    }
+
+    try {
+      const executeReturnValue = load.execute.call(nullContext)
+      if (executeReturnValue) {
+        load.executePromise = executeReturnValue.then(
+          () => {
+            load.executePromise = null
+            load.completionPromise = load.namespace
+          },
+          (error) => {
+            load.executePromise = null
+            load.error = error
+            throw error
+          },
+        )
+        return
+      }
+      load.instantiatePromise = null
+      load.linkPromise = null
+      load.completionPromise = load.namespace
+    } catch (error) {
+      load.error = error
+      throw error
+    } finally {
+      load.execute = null
+    }
+  }
+
+  // the closest we can get to call(undefined)
+  const nullContext = Object.freeze(Object.create(null))
+
+  const createMeta = (url) => {
+    return {
+      url,
+      resolve: (id, parentUrl) => resolveUrl(id, parentUrl),
+    }
+  }
+
+  const createNamespace =
+    typeof Symbol !== "undefined" && Symbol.toStringTag
+      ? () => {
+          const namespace = Object.create(null)
+          Object.defineProperty(namespace, Symbol.toStringTag, {
+            value: "Module",
+          })
+          return namespace
+        }
+      : () => Object.create(null)
+})();

package/src/plugins/transpilation/as_js_classic/helpers/babel_plugin_transform_import_meta_url.js

@@ -0,0 +1,47 @@
+import babelParser from "@babel/parser"
+
+export const babelPluginTransformImportMetaUrl = (babel) => {
+  return {
+    name: "transform-import-meta-url",
+    visitor: {
+      Program: (programPath) => {
+        const currentUrlIdentifier =
+          programPath.scope.generateUidIdentifier("currentUrl")
+        let used = false
+
+        programPath.traverse({
+          MemberExpression: (path) => {
+            const node = path.node
+            if (
+              node.object.type === "MetaProperty" &&
+              node.object.property.name === "meta" &&
+              node.property.name === "url"
+            ) {
+              // const node = babel.types.valueToNode(10)
+              const identifier = babel.types.identifier(
+                currentUrlIdentifier.name,
+              )
+              const expressionStatement =
+                babel.types.expressionStatement(identifier)
+              path.replaceWith(expressionStatement)
+              used = true
+            }
+          },
+        })
+        if (used) {
+          const ast = generateExpressionAst(`document.currentScript.src`)
+          programPath.scope.push({
+            id: currentUrlIdentifier,
+            init: ast,
+          })
+        }
+      },
+    },
+  }
+}
+
+const generateExpressionAst = (expression, options) => {
+  const { parseExpression } = babelParser
+  const ast = parseExpression(expression, options)
+  return ast
+}