swc/ARCHITECTURE.md

swc Architecture

This document gives a high level overview of swc internals. You may find it useful if you want to contribute to swc or if you are interested in the inner workings of swc.

Macros

swc uses proc macro extensively to reduce work. Please see links below to know what each macro do.

• enum_kind
• string_enum
• ast_node

And some adhoc-macros are used.

• parser_macros
• codegen_macros

These macro breaks macro hygiene.

Tests

swc uses official ecmascript conformance test suite called test262 for testing.

Parser tests ensures that parsed result of test262/pass is identical with test262/pass-explicit.

Codegen tests ensures that generated code is equivalent to goldened reference files located at tests/references.