feat(compat): extract compatibility data to oxc_compat crate

Author: sapphi-red

Cargo.lock

@@ -110,6 +110,7 @@ oxc_ast_macros = { version = "0.90.0", path = "crates/oxc_ast_macros" }
 oxc_ast_visit = { version = "0.90.0", path = "crates/oxc_ast_visit" }
 oxc_cfg = { version = "0.90.0", path = "crates/oxc_cfg" }
 oxc_codegen = { version = "0.90.0", path = "crates/oxc_codegen" }
+oxc_compat = { version = "0.90.0", path = "crates/oxc_compat" }
 oxc_data_structures = { version = "0.90.0", path = "crates/oxc_data_structures" }
 oxc_diagnostics = { version = "0.90.0", path = "crates/oxc_diagnostics" }
 oxc_ecmascript = { version = "0.90.0", path = "crates/oxc_ecmascript" }

Cargo.toml

@@ -0,0 +1,28 @@
+[package]
+name = "oxc_compat"
+version = "0.90.0"
+authors.workspace = true
+categories.workspace = true
+edition.workspace = true
+homepage.workspace = true
+include = ["/src"]
+keywords.workspace = true
+license.workspace = true
+publish = true
+repository.workspace = true
+rust-version.workspace = true
+description.workspace = true
+
+[lints]
+workspace = true
+
+[lib]
+test = true
+doctest = false
+
+[dependencies]
+cow-utils = { workspace = true }
+oxc-browserslist = { workspace = true }
+oxc_syntax = { workspace = true }
+rustc-hash = { workspace = true }
+serde = { workspace = true, features = ["derive"] }

crates/oxc_compat/Cargo.toml

@@ -0,0 +1 @@
+# Oxc Compat

crates/oxc_compat/README.md

@@ -4,7 +4,7 @@ pub use browserslist::Version;
 use rustc_hash::FxHashMap;
 use serde::Deserialize;
 
-use crate::options::{BrowserslistQuery, Engine, EngineTargets};
+use crate::{BrowserslistQuery, Engine, EngineTargets};
 
 /// <https://babel.dev/docs/babel-preset-env#targets>
 #[derive(Debug, Deserialize)]

crates/oxc_transformer/src/options/babel/env/targets.rs renamed to crates/oxc_compat/src/babel_targets.rs

@@ -18,6 +18,11 @@ fn cache() -> &'static RwLock<FxHashMap<BrowserslistQuery, EngineTargets>> {
 }
 
 impl BrowserslistQuery {
+    /// # Errors
+    /// When the query is invalid.
+    ///
+    /// # Panics
+    /// When the rwlock is poisoned.
     pub fn exec(&self) -> Result<EngineTargets, String> {
         if let Some(v) = cache().read().unwrap().get(self) {
             return Ok(v.clone());

crates/oxc_transformer/src/options/browserslist_query.rs renamed to crates/oxc_compat/src/browserslist_query.rs

@@ -4,14 +4,16 @@ use std::{
     str::FromStr,
 };
 
-use browserslist::Version;
+pub use browserslist::Version;
+use oxc_syntax::es_target::ESTarget;
 use rustc_hash::FxHashMap;
 use serde::Deserialize;
 
+use crate::browserslist_query::BrowserslistQuery;
+use crate::{babel_targets::BabelTargets, es_target::ESVersion};
+
 use super::{
-    BrowserslistQuery,
-    babel::BabelTargets,
-    engine::Engine,
+    Engine,
     es_features::{ESFeature, features},
 };
 
@@ -46,11 +48,15 @@ impl EngineTargets {
         BrowserslistQuery::Single(query.to_string()).exec()
     }
 
-    /// Returns true if all fields are [None].
+    /// Returns true if all fields are empty.
     pub fn is_any_target(&self) -> bool {
         self.0.is_empty()
     }
 
+    /// Check if the target engines support the given ES feature.
+    ///
+    /// Returns `true` if the feature is NOT supported (needs transformation),
+    /// `false` if the feature IS supported (can be used natively).
     pub fn has_feature(&self, feature: ESFeature) -> bool {
         let feature_engine_targets = &features()[&feature];
         for (engine, feature_version) in feature_engine_targets.iter() {
@@ -88,4 +94,42 @@ impl EngineTargets {
         }
         engine_targets
     }
+
+    /// # Errors
+    ///
+    /// * When the query failed to parse.
+    pub fn from_target(s: &str) -> Result<Self, String> {
+        if s.contains(',') {
+            Self::from_target_list(&s.split(',').collect::<Vec<_>>())
+        } else {
+            Self::from_target_list(&[s])
+        }
+    }
+
+    /// # Errors
+    ///
+    /// * When the query failed to parse.
+    pub fn from_target_list<S: AsRef<str>>(list: &[S]) -> Result<Self, String> {
+        let mut es_target = None;
+        let mut engine_targets = EngineTargets::default();
+
+        for s in list {
+            let s = s.as_ref();
+            // Parse `esXXXX`.
+            if let Ok(target) = ESTarget::from_str(s) {
+                if let Some(target) = es_target {
+                    return Err(format!("'{target}' is already specified."));
+                }
+                es_target = Some(target);
+            } else {
+                // Parse `chromeXX`, `edgeXX` etc.
+                let (engine, version) = Engine::parse_name_and_version(s)?;
+                if engine_targets.insert(engine, version).is_some() {
+                    return Err(format!("'{s}' is already specified."));
+                }
+            }
+        }
+        engine_targets.insert(Engine::Es, es_target.unwrap_or(ESTarget::default()).version());
+        Ok(engine_targets)
+    }
 }