@jsenv/core 27.0.0-alpha.4 → 27.0.0-alpha.40

package/src/omega/core_plugins/import_assertions/jsenv_plugin_import_assertions.js

@@ -1,211 +0,0 @@
-import { applyBabelPlugins } from "@jsenv/utils/js_ast/apply_babel_plugins.js"
-import { ContentType } from "@jsenv/utils/src/content_type.js"
-import { createMagicSource } from "@jsenv/utils/sourcemap/magic_source.js"
-import { injectQueryParamsIntoSpecifier } from "@jsenv/utils/urls/url_utils.js"
-import { JS_QUOTES } from "@jsenv/utils/string/js_quotes.js"
-
-import { babelPluginMetadataImportAssertions } from "./helpers/babel_plugin_metadata_import_assertions.js"
-import { convertJsonTextToJavascriptModule } from "./helpers/json_module.js"
-import { convertTextToJavascriptModule } from "./helpers/text_module.js"
-
-export const jsenvPluginImportAssertions = () => {
-  const importAssertions = [
-    {
-      name: "jsenv:import_assertions",
-      appliesDuring: "*",
-      transform: {
-        js_module: async (
-          { url, generatedUrl, content },
-          { scenario, isSupportedOnRuntime, referenceUtils },
-        ) => {
-          const importTypesToHandle = getImportTypesToHandle({
-            scenario,
-            isSupportedOnRuntime,
-          })
-          if (importTypesToHandle.length === 0) {
-            return null
-          }
-          const { metadata } = await applyBabelPlugins({
-            babelPlugins: [babelPluginMetadataImportAssertions],
-            url,
-            generatedUrl,
-            content,
-          })
-          const { importAssertions } = metadata
-          const magicSource = createMagicSource(content)
-          importAssertions.forEach((importAssertion) => {
-            const assertType = importAssertion.assert.type
-            if (!importTypesToHandle.includes(assertType)) {
-              return
-            }
-            const { path } = importAssertion
-            const { node } = path
-            const importType = `${assertType}_module`
-            if (node.type === "CallExpression") {
-              const importSpecifierPath = path.get("arguments")[0]
-              const specifier = importSpecifierPath.node.value
-              const newSpecifier = injectQueryParamsIntoSpecifier(specifier, {
-                [importType]: "",
-              })
-              const [newReference, newUrlInfo] = referenceUtils.updateSpecifier(
-                JSON.stringify(specifier),
-                newSpecifier,
-              )
-              newUrlInfo.data.importType = importType
-              magicSource.replace({
-                start: importSpecifierPath.node.start,
-                end: importSpecifierPath.node.end,
-                replacement: newReference.generatedSpecifier,
-              })
-              const secondArgPath = path.get("arguments")[1]
-              magicSource.remove({
-                start: secondArgPath.node.start,
-                end: secondArgPath.node.end,
-              })
-              return
-            }
-            const importSpecifierPath = path.get("source")
-            const specifier = importSpecifierPath.node.value
-            const newSpecifier = injectQueryParamsIntoSpecifier(specifier, {
-              [importType]: "",
-            })
-            const [newReference, newUrlInfo] = referenceUtils.updateSpecifier(
-              JSON.stringify(specifier),
-              newSpecifier,
-            )
-            newUrlInfo.data.importType = importType
-            magicSource.replace({
-              start: importSpecifierPath.node.start,
-              end: importSpecifierPath.node.end,
-              replacement: newReference.generatedSpecifier,
-            })
-            const assertionsPath = path.get("assertions")[0]
-            magicSource.remove({
-              start: assertionsPath.node.start,
-              end: assertionsPath.node.end,
-            })
-          })
-          return magicSource.toContentAndSourcemap()
-        },
-      },
-    },
-  ]
-
-  const importTypeJson = {
-    name: "jsenv:import_type_json",
-    appliesDuring: "*",
-    finalize: ({ url, contentType, content }) => {
-      if (!new URL(url).searchParams.has("json_module")) {
-        return null
-      }
-      if (contentType !== "application/json") {
-        throw new Error(
-          `Unexpected content type on ${url}, should be "application/json" but got ${contentType}`,
-        )
-      }
-      return convertJsonTextToJavascriptModule({
-        content,
-      })
-    },
-  }
-
-  // not standard but I expect this to happen one day?
-  const importTypeText = {
-    name: "jsenv:import_type_text",
-    appliesDuring: "*",
-    finalize: ({ url, contentType, content }) => {
-      if (!new URL(url).searchParams.has("text_module")) {
-        return null
-      }
-      if (ContentType.isTextual(contentType)) {
-        throw new Error(
-          `Unexpected content type on ${url}, should be "text/*" but got ${contentType}`,
-        )
-      }
-      return convertTextToJavascriptModule({
-        content,
-      })
-    },
-  }
-
-  return [
-    importAssertions,
-    importTypeJson,
-    jsenvPluginImportTypeCss(),
-    importTypeText,
-  ]
-}
-
-const jsenvPluginImportTypeCss = () => {
-  const inlineContentClientFileUrl = new URL(
-    "../inline/client/inline_content.js",
-    import.meta.url,
-  ).href
-
-  return {
-    name: "jsenv:import_type_css",
-    appliesDuring: "*",
-    // load the original css url
-    load: ({ data }, { urlGraph, load }) => {
-      if (data.importType !== "css_module") {
-        return null
-      }
-      return load({
-        reference: data.originalReference,
-        urlInfo: urlGraph.getUrlInfo(data.originalReference.url),
-      })
-    },
-    transform: ({ url, data, contentType, content }, { referenceUtils }) => {
-      if (data.importType !== "css_module") {
-        return null
-      }
-      if (contentType !== "text/css") {
-        throw new Error(
-          `Unexpected content type on ${url}, should be "text/css" but got ${contentType}`,
-        )
-      }
-      const [reference] = referenceUtils.inject({
-        type: "js_import_export",
-        specifier: inlineContentClientFileUrl,
-      })
-      const cssText = JS_QUOTES.escapeSpecialChars(content, {
-        // If template string is choosen and runtime do not support template literals
-        // it's ok because "jsenv:new_inline_content" plugin executes after this one
-        // and convert template strings into raw strings
-        canUseTemplateString: true,
-      })
-      return {
-        type: "js_module",
-        contentType: "application/javascript",
-        content: `import { InlineContent } from ${reference.generatedSpecifier}
-
-const css = new InlineContent(${cssText}, { type: "text/css" })
-const stylesheet = new CSSStyleSheet()
-stylesheet.replaceSync(css.text)
-export default stylesheet`,
-      }
-    },
-  }
-}
-
-const getImportTypesToHandle = ({ scenario, isSupportedOnRuntime }) => {
-  // during build always replace import assertions with the js:
-  // - means rollup can bundle more js file together
-  // - means url versioning can work for css inlined in js
-  // - avoid rollup to see import assertions
-  //   We would have to tell rollup to ignore import with assertion
-  if (scenario === "build") {
-    return ["json", "css", "text"]
-  }
-  const importTypes = []
-  if (!isSupportedOnRuntime("import_type_json")) {
-    importTypes.push("json")
-  }
-  if (!isSupportedOnRuntime("import_type_css")) {
-    importTypes.push("css")
-  }
-  if (!isSupportedOnRuntime("import_type_text")) {
-    importTypes.push("text")
-  }
-  return importTypes
-}

package/src/omega/core_plugins/inline/jsenv_plugin_inline.js

@@ -1,13 +0,0 @@
-import { jsenvPluginJsAndCssInsideHtml } from "./jsenv_plugin_js_and_css_inside_html.js"
-import { jsenvPluginNewInlineContent } from "./jsenv_plugin_new_inline_content.js"
-import { jsenvPluginDataUrls } from "./jsenv_plugin_data_urls.js"
-import { jsenvPluginInlineQueryParam } from "./jsenv_plugin_inline_query_param.js"
-
-export const jsenvPluginInline = ({ allowEscapeForVersioning } = {}) => {
-  return [
-    jsenvPluginJsAndCssInsideHtml(),
-    jsenvPluginNewInlineContent({ allowEscapeForVersioning }),
-    jsenvPluginDataUrls(),
-    jsenvPluginInlineQueryParam(),
-  ]
-}

package/src/omega/core_plugins/inline/jsenv_plugin_new_inline_content.js

@@ -1,210 +0,0 @@
-/*
- * Needs to be updated so that it sill works in the following cases:
- * - templates literals transformed to regular stuff by babel
- * - tagged name renamed by rollup
- * - the template named is minified by terser
- * In the cases above I must remain capable to recoginize the template literal
- * to be able to update the urls inside (and even version the urls)
- * because url versioning happens after minification it can be challenging
- *
- * TODO: use "keep_classnames" https://github.com/terser/terser#compress-options
- * so that new InlineContent can be recognized after minification
- */
-
-import { createMagicSource } from "@jsenv/utils/sourcemap/magic_source.js"
-import { JS_QUOTES } from "@jsenv/utils/string/js_quotes.js"
-import { applyBabelPlugins } from "@jsenv/utils/js_ast/apply_babel_plugins.js"
-import { generateInlineContentUrl } from "@jsenv/utils/urls/inline_content_url_generator.js"
-
-export const jsenvPluginNewInlineContent = ({ allowEscapeForVersioning }) => {
-  return {
-    name: "jsenv:new_inline_content",
-    appliesDuring: "*",
-    transform: {
-      js_module: async (
-        { url, generatedUrl, content, originalContent },
-        { referenceUtils, cook, isSupportedOnRuntime },
-      ) => {
-        const { metadata } = await applyBabelPlugins({
-          babelPlugins: [babelPluginMetadataInlineContentCalls],
-          url,
-          generatedUrl,
-          content,
-        })
-        const { inlineContentCalls } = metadata
-        if (inlineContentCalls.length === 0) {
-          return null
-        }
-        const magicSource = createMagicSource(content)
-        await inlineContentCalls.reduce(async (previous, inlineContentCall) => {
-          await previous
-          const inlineUrl = generateInlineContentUrl({
-            url,
-            extension: {
-              "application/json": ".json",
-              "text/css": ".css",
-              "text/plain": ".txt",
-              "application/octet-stream": "",
-            }[inlineContentCall.contentType],
-            line: inlineContentCall.line,
-            column: inlineContentCall.column,
-            lineEnd: inlineContentCall.lineEnd,
-            columnEnd: inlineContentCall.columnEnd,
-          })
-          let { quote } = inlineContentCall
-          if (
-            quote === "`" &&
-            !isSupportedOnRuntime("transform-template-literals")
-          ) {
-            // if quote is "`" and template literals are not supported
-            // we'll use a regular string (single or double quote)
-            // when rendering the string
-            quote = JS_QUOTES.pickBest(inlineContentCall.content)
-          }
-          const [inlineReference, inlineUrlInfo] = referenceUtils.foundInline({
-            type: "js_inline_content",
-            isOriginal: content === originalContent,
-            line: inlineContentCall.line,
-            column: inlineContentCall.column,
-            specifier: inlineUrl,
-            contentType: inlineContentCall.contentType,
-            content: inlineContentCall.content,
-          })
-          inlineUrlInfo.jsQuote = quote
-          inlineReference.escape = (value) =>
-            JS_QUOTES.escapeSpecialChars(value.slice(1, -1), { quote })
-          await cook({
-            reference: inlineReference,
-            urlInfo: inlineUrlInfo,
-          })
-          magicSource.replace({
-            start: inlineContentCall.start,
-            end: inlineContentCall.end,
-            replacement: JS_QUOTES.escapeSpecialChars(inlineUrlInfo.content, {
-              quote,
-              allowEscapeForVersioning,
-            }),
-          })
-        }, Promise.resolve())
-        return magicSource.toContentAndSourcemap()
-      },
-    },
-  }
-}
-
-const babelPluginMetadataInlineContentCalls = () => {
-  return {
-    name: "metadata-inline-content-calls",
-    visitor: {
-      Program: (programPath, state) => {
-        const inlineContentCalls = []
-        programPath.traverse({
-          NewExpression: (path) => {
-            const newInlineContentCall = parseAsNewInlineContentCall(path)
-            if (newInlineContentCall) {
-              inlineContentCalls.push(newInlineContentCall)
-            }
-          },
-        })
-        state.file.metadata.inlineContentCalls = inlineContentCalls
-      },
-    },
-  }
-}
-
-const parseAsNewInlineContentCall = (path) => {
-  const node = path.node
-  if (node.callee.type === "Identifier") {
-    // terser rename import to use a shorter name
-    const name = getOriginalName(path, node.callee.name)
-    if (name !== "InlineContent") {
-      return null
-    }
-  } else if (node.callee.id) {
-    // terser might combine new InlineContent('') declaration and usage
-    if (node.callee.id.type !== "Identifier") {
-      return null
-    }
-    const name = getOriginalName(path, node.callee.id.name)
-    if (name !== "InlineContent") {
-      return null
-    }
-  }
-  if (node.arguments.length !== 2) {
-    return null
-  }
-  const [firstArg, secondArg] = node.arguments
-  if (secondArg.type !== "ObjectExpression") {
-    return null
-  }
-  const typePropertyNode = secondArg.properties.find((property) => {
-    return (
-      property.key.type === "Identifier" &&
-      property.key.name === "type" &&
-      property.type === "ObjectProperty" &&
-      property.value.type === "StringLiteral"
-    )
-  })
-  if (!typePropertyNode) {
-    return null
-  }
-  const type = typePropertyNode.value.value
-  if (firstArg.type === "StringLiteral") {
-    const position = getNodePosition(firstArg)
-    return {
-      nodeType: "StringLiteral",
-      quote: firstArg.extra.raw[0],
-      contentType: type,
-      content: firstArg.value,
-      ...position,
-    }
-  }
-  if (firstArg.type === "TemplateLiteral") {
-    const quasis = firstArg.quasis
-    if (quasis.length !== 1) {
-      return null
-    }
-    const templateElementNode = quasis[0]
-    const position = getNodePosition(firstArg)
-    return {
-      nodeType: "TemplateLiteral",
-      quote: "`",
-      contentType: type,
-      content: templateElementNode.value.cooked,
-      ...position,
-    }
-  }
-  return null
-}
-
-const getNodePosition = (node) => {
-  return {
-    start: node.start,
-    end: node.end,
-    line: node.loc.start.line,
-    column: node.loc.start.column,
-    lineEnd: node.loc.end.line,
-    columnEnd: node.loc.end.column,
-  }
-}
-
-const getOriginalName = (path, name) => {
-  const binding = path.scope.getBinding(name)
-  if (!binding) {
-    return name
-  }
-  if (binding.path.type === "ImportSpecifier") {
-    const importedName = binding.path.node.imported.name
-    if (name === importedName) {
-      return name
-    }
-    return getOriginalName(path, importedName)
-  }
-  if (binding.path.type === "VariableDeclarator") {
-    if (binding.path.node.init.type === "Identifier") {
-      const previousName = binding.path.node.init.name
-      return getOriginalName(path, previousName)
-    }
-  }
-  return name
-}

package/src/omega/core_plugins/leading_slash/jsenv_plugin_leading_slash.js

@@ -1,12 +0,0 @@
-export const jsenvPluginLeadingSlash = () => {
-  return {
-    name: "jsenv:leading_slash",
-    appliesDuring: "*",
-    resolve: ({ specifier }, { rootDirectoryUrl }) => {
-      if (specifier[0] !== "/") {
-        return null
-      }
-      return new URL(specifier.slice(1), rootDirectoryUrl).href
-    },
-  }
-}

package/src/omega/core_plugins/node_esm_resolution/jsenv_plugin_node_esm_resolution.js

@@ -1,77 +0,0 @@
-/*
- * - should I restore eventual search params lost during node esm resolution
- * - what about symlinks?
- *   It feels like I should apply symlink (when we don't want to preserve them)
- *   once a file:/// url is found, regardless
- *   if that comes from node resolution or anything else (not even magic resolution)
- *   it should likely be an other plugin happening after the others
- */
-
-import {
-  applyNodeEsmResolution,
-  lookupPackageScope,
-  readPackageJson,
-} from "@jsenv/node-esm-resolution"
-
-export const jsenvPluginNodeEsmResolution = ({
-  // https://nodejs.org/api/esm.html#resolver-algorithm-specification
-  packageConditions = ["browser", "import"],
-} = {}) => {
-  const nodeEsmResolution = {
-    name: "jsenv:node_esm_resolve",
-    appliesDuring: "*",
-    resolve: {
-      js_import_export: ({ parentUrl, specifier }) => {
-        const { url } = applyNodeEsmResolution({
-          conditions: packageConditions,
-          parentUrl,
-          specifier,
-        })
-        return url
-      },
-    },
-    load: ({ url }) => {
-      if (url.startsWith("file:///@ignore/")) {
-        return {
-          content: "export default {}",
-        }
-      }
-      return null
-    },
-  }
-
-  const packageVersionInUrl = {
-    name: "jsenv:package_url_version",
-    appliesDuring: {
-      dev: true,
-      test: true,
-    },
-    transformReferencedUrl: ({ url }, { rootDirectoryUrl }) => {
-      if (!url.startsWith("file:")) {
-        return null
-      }
-      // without this check a file inside a project without package.json
-      // could be considered as a node module if there is a ancestor package.json
-      // but we want to version only node modules
-      if (!url.includes("/node_modules/")) {
-        return null
-      }
-      const urlObject = new URL(url)
-      if (urlObject.searchParams.has("v")) {
-        return null
-      }
-      const packageUrl = lookupPackageScope(url)
-      if (!packageUrl) {
-        return null
-      }
-      if (packageUrl === rootDirectoryUrl) {
-        return null
-      }
-      const packageVersion = readPackageJson(packageUrl).version
-      urlObject.searchParams.set("v", packageVersion)
-      return urlObject.href
-    },
-  }
-
-  return [nodeEsmResolution, packageVersionInUrl]
-}

package/src/omega/core_plugins.js

@@ -1,39 +0,0 @@
-import { jsenvPluginLeadingSlash } from "./core_plugins/leading_slash/jsenv_plugin_leading_slash.js"
-import { jsenvPluginImportmap } from "./core_plugins/importmap/jsenv_plugin_importmap.js"
-import { jsenvPluginUrlResolution } from "./core_plugins/url_resolution/jsenv_plugin_url_resolution.js"
-import { jsenvPluginNodeEsmResolution } from "./core_plugins/node_esm_resolution/jsenv_plugin_node_esm_resolution.js"
-import { jsenvPluginUrlVersion } from "./core_plugins/url_version/jsenv_plugin_url_version.js"
-import { jsenvPluginFileUrls } from "./core_plugins/file_urls/jsenv_plugin_file_urls.js"
-import { jsenvPluginFileSystemMagic } from "./core_plugins/filesystem_magic/jsenv_plugin_filesystem_magic.js"
-import { jsenvPluginInline } from "./core_plugins/inline/jsenv_plugin_inline.js"
-import { jsenvPluginHtmlSupervisor } from "./core_plugins/html_supervisor/jsenv_plugin_html_supervisor.js"
-import { jsenvPluginCommonJsGlobals } from "./core_plugins/commonjs_globals/jsenv_plugin_commonjs_globals.js"
-import { jsenvPluginImportAssertions } from "./core_plugins/import_assertions/jsenv_plugin_import_assertions.js"
-import { jsenvPluginImportMetaScenarios } from "./core_plugins/import_meta_scenarios/jsenv_plugin_import_meta_scenarios.js"
-import { jsenvPluginBabel } from "./core_plugins/babel/jsenv_plugin_babel.js"
-
-export const getCorePlugins = ({
-  htmlSupervisor,
-  nodeEsmResolution,
-  fileSystemMagicResolution,
-  babel,
-} = {}) => {
-  const asFewAsPossible = false // useful during dev
-  return [
-    ...(asFewAsPossible ? [] : [jsenvPluginImportAssertions()]),
-    ...(asFewAsPossible ? [] : [jsenvPluginHtmlSupervisor(htmlSupervisor)]), // before inline as it turns inline <script> into <script src>
-    ...(asFewAsPossible ? [] : [jsenvPluginInline()]), // before "file urls" to resolve and load inline urls
-    jsenvPluginImportmap(), // before node esm to handle bare specifiers before node esm
-    jsenvPluginFileUrls(),
-    jsenvPluginLeadingSlash(),
-    jsenvPluginNodeEsmResolution(nodeEsmResolution), // before url resolution to handle "js_import_export" resolution
-    jsenvPluginUrlResolution(),
-    ...(asFewAsPossible
-      ? []
-      : [jsenvPluginFileSystemMagic(fileSystemMagicResolution)]),
-    jsenvPluginUrlVersion(),
-    ...(asFewAsPossible ? [] : [jsenvPluginCommonJsGlobals()]),
-    ...(asFewAsPossible ? [] : [jsenvPluginImportMetaScenarios()]),
-    jsenvPluginBabel(babel),
-  ]
-}

package/src/omega/runtime_support/runtime_support.js

@@ -1,20 +0,0 @@
-import { findHighestVersion } from "@jsenv/utils/semantic_versioning/highest_version.js"
-
-export const isFeatureSupportedOnRuntimes = (
-  runtimeSupport,
-  featureCompat = {},
-) => {
-  const runtimeNames = Object.keys(runtimeSupport)
-  return runtimeNames.every((runtimeName) => {
-    const runtimeVersion = runtimeSupport[runtimeName]
-    const runtimeVersionCompatible = featureCompat[runtimeName] || "Infinity"
-    const highestVersion = findHighestVersion(
-      runtimeVersion,
-      runtimeVersionCompatible,
-    )
-    if (highestVersion !== runtimeVersion) {
-      return false
-    }
-    return true
-  })
-}

package/src/omega/url_mentions/css_url_mentions.js

@@ -1,63 +0,0 @@
-/*
- * https://github.com/parcel-bundler/parcel/blob/v2/packages/transformers/css/src/CSSTransformer.js
- */
-
-import { applyPostCss } from "@jsenv/utils/css_ast/apply_post_css.js"
-import { postCssPluginUrlVisitor } from "@jsenv/utils/css_ast/postcss_plugin_url_visitor.js"
-import { replaceCssUrls } from "@jsenv/utils/css_ast/replace_css_urls.js"
-
-export const parseCssUrlMentions = async ({ url, content }) => {
-  const cssUrlMentions = []
-  await applyPostCss({
-    sourcemaps: false,
-    plugins: [
-      postCssPluginUrlVisitor({
-        urlVisitor: ({ type, url, specifier, urlNode }) => {
-          cssUrlMentions.push({
-            type: `css_${type}`,
-            specifier,
-            start: urlNode.sourceIndex,
-            end: urlNode.sourceEndIndex,
-            url,
-          })
-        },
-      }),
-    ],
-    url,
-    content,
-  })
-  return {
-    urlMentions: cssUrlMentions,
-    replaceUrls: async (getReplacement) => {
-      // we can't use magic source because urlMention.start/end do not match the url specifier
-      // const magicSource = createMagicSource({ url, content })
-      // cssUrlMentions.forEach((urlMention) => {
-      //   magicSource.replace({
-      //     start: urlMention.start,
-      //     end: urlMention.end,
-      //     replacement: JSON.stringify(transformUrlMention(urlMention)),
-      //   })
-      // })
-      // return magicSource.toContentAndSourcemap()
-      const result = await replaceCssUrls({
-        url,
-        content,
-        urlVisitor: ({ url, replace }) => {
-          const cssUrlMention = cssUrlMentions.find(
-            (urlMention) => urlMention.url === url,
-          )
-          if (cssUrlMention) {
-            const replacement = getReplacement(cssUrlMention)
-            if (replacement) {
-              replace(replacement)
-            }
-          }
-        },
-      })
-      return {
-        content: result.content,
-        sourcemap: result.map,
-      }
-    },
-  }
-}