swc/crates/swc_core/Cargo.toml

[package]
authors     = ["강동윤 <kdy1997.dev@gmail.com>", "OJ Kwon <kwon.ohjoong@gmail.com>"]
description = "TBD"
edition     = "2021"
license     = "Apache-2.0"
name        = "swc_core"
repository  = "https://github.com/swc-project/swc.git"
version     = "0.5.0"

  [package.metadata.docs.rs]
  features = [
    "common_perf",
    "allocator_node",
    "base",
    "base_node",
    "common",
    "common_concurrent",
    "visit",
    "quote",
    "utils",
    "transforms",
    "bundler",
    "loader",
    "ast",
    "trace_macro",
    "plugin_transform",
    "plugin_transform_host_js",
    "plugin_transform_host_native",
  ]
  rustdoc-args = ["--cfg", "docsrs"]

[lib]
doctest = false

[features]
### Public features
### Users should opt in necessary features explicitly

## Flags to opt into certain optimizations. In most cases this won't expose new interfaces,
## but changes internal logics to perform differently. These flag should be turned on in combination with
## actual features. Refer build.rs for more details.

# swc_common/perf
common_perf = ["swc_common/perf"]

# configures specific memory allocator.
# node.js binding should depend on this.
allocator_node = ["swc_node_base"]

## General
# Enable swc reexports. To avoid confusion between swc_core namespace,
# it is named as 'base' instead.
base            = ["__base"]
base_concurrent = ["__base", "swc/concurrent"]
base_node       = ["__base", "swc/node"]

# Enable swc_common reexports.
#
# In most cases, top-level features (i.e plugin, or plugin_host) will include this, so no need to
# explicitly opt in. However, if top-level feature should be controlled by feature as opt-in
# and some other dependent feature need this, can be manually selected.
# refer binding_core_wasm for example: it has plugin_transform_host feature, but
# it has to be a feature to be enabled by compile time flag to avoid cargo's feature collision,
# while it also need to access 'common' exports by default for cargo check / or clippy.
common = ["__common"]
# TODO: internally concurrent / perf refers to the same feature (`parking_lot`)
# - can we consolidate them?
common_concurrent = ["__common", "swc_common/concurrent"]

# Enable swc_ecma_visit
visit = ["swc_ecma_visit"]

# Enable `quote!` macro support.
quote = [
  # Dependent features
  "__common",
  "ast",
  # Enable optional package
  "swc_ecma_quote_macros",
]

# Enable swc_ecma_utils
utils = ["__utils", "__common"]

# Enable swc_ecma_transforms base features
transforms = ["__transforms"]

# Enable swc_bundler
bundler = ["swc_bundler"]

# Enable swc_ecma_loader
loader = ["swc_ecma_loader"]

# Enable swc_ecma_ast / swc_atoms support.
# TODO: currently both are enabled at once, we may want to separate them.
ast = ["swc_ecma_ast", "swc_atoms"]

# Enable trace macro support.
# TODO: Once all top-level package (node, wasm, cli..) imports swc_core,
# we may encapsulate `tracing` package into swc_core.
trace_macro = ["swc_trace_macro"]

## Plugins
# Top level features should be enabled to write plugins for the custom transform.
plugin_transform = ["__plugin_transform", "__plugin_transform_schema_v1"]

# Host features to enable plugin `runner` runtime.
# native feature is for the host environment does not have, or cannot access
# to the wasm runtime (i.e cli, or @swc/core node bindings).
# js feature is for the environment can access wasm runtime (i.e @swc/wasm)
plugin_transform_host_js = [
  # Dependent features
  "__plugin_transform_host",
  "__plugin_transform_host_schema_v1",
  "__plugin_transform_env_js",
]
plugin_transform_host_native = [
  # Dependent features
  "__plugin_transform_host",
  "__plugin_transform_host_schema_v1",
  "__plugin_transform_env_native",
]

### Internal features that public features are relying on.
### This is not supposed to be used directly, and does not gaurantee
### stability across each versions.

# Specify version of AST schema will be used.
# This'll be automatically selected via transform_plugin features,
# SWC upstream decides which version to be used for specific version of
# swc_core.
__plugin_transform_host_schema_v1 = [
  # Dependent features
  "__plugin_transform_schema_v1",
  # Enable optional features
  "swc/plugin_transform_schema_v1",
  "swc_plugin_runner/plugin_transform_schema_v1",
]
__plugin_transform_schema_v1 = ["swc_common/plugin_transform_schema_v1"]

# Do not use: testing purpose only
__plugin_transform_host_schema_vtest = [
  # Dependent features
  "__plugin_transform_schema_vtest",
  # Enable optional features
  "swc/plugin_transform_schema_vtest",
  "swc_plugin_runner/plugin_transform_schema_vtest",
]
__plugin_transform_schema_vtest = ["swc_common/plugin_transform_schema_vtest"]

## Plugins

# Internal flags for any transform plugin feature
__plugin_transform = [
  # Dependent features
  "visit",
  "__common",
  "ast",
  # Enable optional packages
  "swc_ecma_ast/rkyv-impl",
  "swc_common/plugin-mode",
  "swc_plugin_proxy/plugin-mode",
  "swc_plugin_macro",
  "swc_plugin",
  "once_cell",
]

# Internal flags for any transform plugin host feature
__plugin_transform_host = [
  # Dependent features
  "__common",
  # Enable optional packages
  # TODO: we may simply flag around downlevel plugin feature
  "swc_plugin_proxy/plugin-rt",
  "swc/plugin",
]
# Internal flags to control plugin environment
__plugin_transform_env_native = [
  "swc_plugin_runner/filesystem_cache",
  "wasmer/default",
  "wasmer-wasi/default",
]

__plugin_transform_env_js = [
  "swc_plugin_runner/memory_cache",
  "wasmer/js-default",
  "wasmer-wasi/js-default",
]

# Do not use: testing purpose only
# Force enable different version of AST schema
__plugin_transform_schema_test = [
  "__plugin_transform",
  "__plugin_transform_schema_vtest",
]

## Common
__base       = ["swc"]
__common     = ["swc_common"]
__transforms = ["swc_ecma_transforms"]
__utils      = ["swc_ecma_utils"]

[dependencies]
# 3rd party dependencies
once_cell   = { optional = true, version = "1.13.0" }
wasmer      = { optional = true, version = "2.3.0", default-features = false }
wasmer-wasi = { optional = true, version = "2.3.0", default-features = false }

# swc_* dependencies
swc                   = { optional = true, version = "0.213.0", path = "../swc" }
swc_atoms             = { optional = true, version = "0.4.0", path = "../swc_atoms" }
swc_bundler           = { optional = true, version = "0.176.0", path = "../swc_bundler" }
swc_common            = { optional = true, version = "0.27.0", path = "../swc_common" }
swc_ecma_ast          = { optional = true, version = "0.90.0", path = "../swc_ecma_ast" }
swc_ecma_loader       = { optional = true, version = "0.39.0", path = "../swc_ecma_loader" }
swc_ecma_parser       = { optional = true, version = "0.117.0", path = "../swc_ecma_parser" }
swc_ecma_quote_macros = { optional = true, version = "0.28.0", path = "../swc_ecma_quote_macros" }
swc_ecma_transforms   = { optional = true, version = "0.182.0", path = "../swc_ecma_transforms" }
swc_ecma_utils        = { optional = true, version = "0.99.0", path = "../swc_ecma_utils" }
swc_ecma_visit        = { optional = true, version = "0.76.0", path = "../swc_ecma_visit" }
swc_node_base         = { optional = true, version = "0.5.5", path = "../swc_node_base" }
swc_plugin            = { optional = true, version = "0.89.0", path = "../swc_plugin" }
swc_plugin_macro      = { optional = true, version = "0.9.0", path = "../swc_plugin_macro" }
swc_plugin_proxy      = { optional = true, version = "0.18.0", path = "../swc_plugin_proxy" }
swc_trace_macro       = { optional = true, version = "0.1.0", path = "../swc_trace_macro" }
# TODO: eventually swc_plugin_runner needs to remove default features
swc_plugin_runner = { optional = true, version = "0.71.0", path = "../swc_plugin_runner", default-features = false }

[dev-dependencies]
testing = { version = "0.29.0", path = "../testing" }