@swc/core 1.2.145 → 1.2.148

package/CHANGELOG.md

@@ -5,6 +5,326 @@
 
 
 
+- **(css/codegen)** Fix codegen of preserved tokens (#3819) ([7ba5861](https://github.com/swc-project/swc/commit/7ba5861a334657cb443b2f143222f632fcbcf752))
+
+
+- **(css/codegen)** Fix the output of `SimpleBlock` (#3838) ([e3a5c14](https://github.com/swc-project/swc/commit/e3a5c142d5f6e965478bd68201714e6d0b4bc863))
+
+
+- **(css/parser)** Fix parsing of `;` in values (#3821) ([30cd29b](https://github.com/swc-project/swc/commit/30cd29b0f0153bd732f0004dfcb10892635ee027))
+
+
+- **(es/compat)** Fix block scoping of variables (#3826) ([406b8ea](https://github.com/swc-project/swc/commit/406b8eaeafa37d1ec68a5d5aca0f8dd337ae39ec))
+
+
+- **(es/hygiene)** Fix renaming bugs (#3824) ([043fba2](https://github.com/swc-project/swc/commit/043fba274e13055dad4b2f6cee85b1bf751572ca))
+
+
+- **(es/minifier)** Preserve more variables (#3805) ([89388e6](https://github.com/swc-project/swc/commit/89388e6ac3669f129d1dfc1f687ad7792373dbc9))
+
+
+- **(es/minifier)** Don't reorder unnecessarily (#3817) ([8a468f7](https://github.com/swc-project/swc/commit/8a468f7544ae7e717de4d629c33e5cdffdfcc7de))
+
+
+- **(es/minifier)** Support declaring multiple bindings with the same name (#3837) ([0fc819e](https://github.com/swc-project/swc/commit/0fc819e2ef04a5a809d1c15523262b2f3fbc580a))
+
+
+- **(node-swc)** Correctly close trace spans after completion (#3811) ([ffb2ee8](https://github.com/swc-project/swc/commit/ffb2ee85e6e3cac7136578c2eaaff73b883f208c))
+
+
+- **(node-swc)** Fix handling of `OptionalChainingExpression` in `Visitor` (#3809) ([4d123c3](https://github.com/swc-project/swc/commit/4d123c3789cd5a837de08014675e945990122c62))
+
+
+- **(node-swc/types)** Add a missing field of `ExportNamedDeclaration` (#3822) ([bde7577](https://github.com/swc-project/swc/commit/bde75770988a6e1c9bb6ae4b850866cea79b0f2c))
+
+### Features
+
+
+
+- **(config)** Add a dedicated cached regex (#3832) ([efc6741](https://github.com/swc-project/swc/commit/efc67417a5afd7813c2d09938300b5c372d1a978))
+
+
+- **(css)** Support color functions (#3836) ([3df887c](https://github.com/swc-project/swc/commit/3df887ca3744813d8cfc6c253a7bb3decaca54db))
+
+
+- **(css/lints)** Add `font-family-no-duplicate-names` rule (#3818) ([2d273d6](https://github.com/swc-project/swc/commit/2d273d60b9dec4d9f969f0e691ba21ce4b252b7d))
+
+
+- **(css/lints)** Implement `color-hex-alpha` rule (#3829) ([818b408](https://github.com/swc-project/swc/commit/818b40857328ae9b855d78d774621fa1ab243da9))
+
+
+- **(css/minifier)** Compress more declarations (#3840) ([0db6915](https://github.com/swc-project/swc/commit/0db6915e32d6c1de848b0f5aeacea2c4cb4522f8))
+
+
+- **(css/parser)** Improve error recovery (#3810) ([f969f8c](https://github.com/swc-project/swc/commit/f969f8c5f54e3028576a74ccfcaae72b1c19eaf9))
+
+
+- **(css/parser)** Improve error recovery (#3828) ([fbb98aa](https://github.com/swc-project/swc/commit/fbb98aa73cbbac186493065af8cfa0fd31407fe6))
+
+
+- **(es/lints)** Implement `radix` rule (#3651) ([f6b4bbe](https://github.com/swc-project/swc/commit/f6b4bbe47beccb6052d60c8e6d7d8c8c7fec5100))
+
+
+- **(es/minifier)** Drop more function parameters in strict mode (#3814) ([789eb7b](https://github.com/swc-project/swc/commit/789eb7baa9ece80e85f0ffd9a92f4d07214d9b11))
+
+
+- **(es/minifier)** Improve sequential inlining (#3820) ([364532e](https://github.com/swc-project/swc/commit/364532e9a74ee55196cecb37eb3fc8256e3a23df))
+
+
+- **(es/minifier)** Implement more rules (#3841) ([260c2a8](https://github.com/swc-project/swc/commit/260c2a885e16332a0e3401bccb65d1381bfab3f3))
+
+### Miscellaneous Tasks
+- **general**: Ignore linguist detection for CSS test files (#3831) ([8755ce1](https://github.com/swc-project/swc/commit/8755ce160f9fa6f9ce75c4ac40fc02d5df236d2d))
+
+### Performance
+
+
+
+- **(es)** Use `Mutex` from `parking_lot` (#3830) ([351b814](https://github.com/swc-project/swc/commit/351b814ed0f1ca36a1e8fd352674689ffe392eda))
+
+
+- **(es/parser)** Remove duplicated instantiations of `Parser` to reduce binary size (#3813) ([f5103a7](https://github.com/swc-project/swc/commit/f5103a77256060e2c27ca360d0c58bbcc6b92b13))
+
+### Testing
+
+
+
+- **(es/compat)** Organize tests (#3825) ([814dcc0](https://github.com/swc-project/swc/commit/814dcc09d66f9c7a968348fc3a08573cadd036f8))
+
+## [1.2.147] - 2022-03-02
+
+### Bug Fixes
+
+
+
+- **(es/compat)** Initialize class fields as a last step (#3767) ([11bf29f](https://github.com/swc-project/swc/commit/11bf29f44b4233b2e7f60b750ef56429dbe47ce9))
+
+
+- **(es/minifier)** Disable some operations for asm.js codes (#3572) ([e7f7f69](https://github.com/swc-project/swc/commit/e7f7f69db4f327b35005e863d3669bad382626c6))
+
+
+- **(es/minifier)** Fix inlining logic (#3776) ([cfc0363](https://github.com/swc-project/swc/commit/cfc036381a5c174798198f4ecf7e0a62abce5a75))
+
+
+- **(es/minifier)** Preserve unresolved references (#3780) ([73cab63](https://github.com/swc-project/swc/commit/73cab638a11978da9f94c886a5fafc462b1556b7))
+
+
+- **(es/minifier)** Fix optimizations of terminating expressions (#3794) ([8beaa20](https://github.com/swc-project/swc/commit/8beaa202e2a8c321a0f2266378d0f0a3ecb06c03))
+
+
+- **(es/react)** Catch refresh directives widely (#3791) ([5ae907f](https://github.com/swc-project/swc/commit/5ae907f6f21d31da708ac7237536bd6f838856c3))
+
+
+- **(es/react)** Fix logic for extracting refresh comments (#3796) ([b485b5a](https://github.com/swc-project/swc/commit/b485b5a1d5480548de9ce2c22060be37298e6346))
+
+
+- **(es/typescript)** Transform `this` in TypeScript classes (#3764) ([5f3f9ef](https://github.com/swc-project/swc/commit/5f3f9ef033797a1b13d32bd854c3acf3cbaf4495))
+
+
+- **(node-swc/cli)** Correctly expose `swcx` entrypoint (#3784) ([95ecc01](https://github.com/swc-project/swc/commit/95ecc013fe9b0ab0c2f52465bd961616315938c3))
+
+### Documentation
+
+
+
+- **(adr)** Add `adr-00002` for event trace profiling (#3787) ([3c1c5d0](https://github.com/swc-project/swc/commit/3c1c5d0363b231a8ac3f5bdfd15f1b2ec9224849))
+
+### Features
+
+
+
+- **(css/ast)** Union `Value` and `ComponentValue` (#3804) ([3ec45a6](https://github.com/swc-project/swc/commit/3ec45a6858a24c56ee1fe143410f3763b2b5e4b4))
+
+
+- **(css/lints)** Add CSS linter (#3765) ([66c6cae](https://github.com/swc-project/swc/commit/66c6cae8dc7d614aac83a620b4dff022459f54d7))
+
+
+- **(css/lints)** Add `selector-max-combinators` rule (#3789) ([e389bef](https://github.com/swc-project/swc/commit/e389bef3ad0f27382d2d6c5f2be62dd28e65e757))
+
+
+- **(css/minifier)** Convert more length (#3769) ([500d62c](https://github.com/swc-project/swc/commit/500d62c0850a93321baafb44fa4ac4b8a9bff3f8))
+
+
+- **(es/codegen)** Optimize output of new expressions without arguments (#3800) ([e1b13eb](https://github.com/swc-project/swc/commit/e1b13eb21a6eb1ec094a64ab30852042b89748a8))
+
+
+- **(es/compat)** Optimize handling of literals in computed property names (#3756) ([8ed4d2f](https://github.com/swc-project/swc/commit/8ed4d2fcaccf27733e8fbfe19da810504653ce6b))
+
+
+- **(es/compat)** Add tracing support for `es2022` transforms (#3785) ([4d70482](https://github.com/swc-project/swc/commit/4d7048291fae26c081754a496d9c77ddb2215575))
+
+
+- **(es/compat)** Use sequence expressions instead of iife in `classes` pass (#3773) ([5b6beca](https://github.com/swc-project/swc/commit/5b6beca1afb7e4278629840c94c775a083288cd2))
+
+
+- **(es/compat)** Add tracing support for es2020 transforms (#3798) ([8f41d7a](https://github.com/swc-project/swc/commit/8f41d7a10e99c21dc12176ee7724f0e13ca702dd))
+
+
+- **(es/dep-graph)** Add support for `require.resolve` (#3783) ([19b84e7](https://github.com/swc-project/swc/commit/19b84e7723c381843c98df90f64e5123acdd5808))
+
+
+- **(es/minifier)** Consider `arguments` while dropping unused assignments (#3775) ([714e05e](https://github.com/swc-project/swc/commit/714e05e5535dd4f8552ce700cc5b582d134d8a08))
+
+
+- **(es/module)** Workaround stack overflow bug of JavaScriptCore related to too many exports (#3763) ([ad0a853](https://github.com/swc-project/swc/commit/ad0a8539e058fda49e40cc8fab167e2602576d48))
+
+
+- **(es/modules)** Support system js (#3659) ([557a520](https://github.com/swc-project/swc/commit/557a520a6d6814f79625ca0227c47fa2d42a806e))
+
+
+- **(es/parser)** Raise a syntax error on an invalid shorthand assignment (#3734) ([2aa3b21](https://github.com/swc-project/swc/commit/2aa3b2123fc73bc187099b5c4a0b1f796b0a51f4))
+
+
+- **(es/quote)** Implement quasi quoter partially (#3155) ([fe0ddcc](https://github.com/swc-project/swc/commit/fe0ddcc54b0f8343a3a3d227bde8b38fa47ebd80))
+
+
+- **(es/quote)** Support variables (#3774) ([e3c374b](https://github.com/swc-project/swc/commit/e3c374b53bdd3fe8baef5be7a63b10d2efcd47e4))
+
+
+- **(plugin)** Expose `swc_ecma_quote` (#3790) ([bc60a6e](https://github.com/swc-project/swc/commit/bc60a6e90ccc1adcb8d9eda9ef47725e20fbfa23))
+
+
+- **(plugin/runner)** Update `wasmer` to `v2.2` (#3788) ([99d536e](https://github.com/swc-project/swc/commit/99d536e4869df5a9cc642ed0a155683165ee93c9))
+
+### Miscellaneous Tasks
+- **general**: Update `rustc` (#3768) ([3798436](https://github.com/swc-project/swc/commit/3798436201a0838e55beac974792f4d560b47657))
+
+### Performance
+
+
+
+- **(css/lints)** Skip disabled rules (#3803) ([0336029](https://github.com/swc-project/swc/commit/0336029c22a8751d2acb9765f11ead79c77115dc))
+
+
+- **(plugin/runner)** Optimize `write_into_memory_view` (#3797) ([7fd0eee](https://github.com/swc-project/swc/commit/7fd0eeecb844a182fef39872178e3991356e3ae0))
+
+### Refactor
+
+
+
+- **(css/ast)** Simplify AST types (#3753) ([815a489](https://github.com/swc-project/swc/commit/815a489dcfb72df928fc03f216dbe4a21b0e0716))
+
+
+- **(css/lints)** Simplify error reporting API (#3781) ([b8211da](https://github.com/swc-project/swc/commit/b8211da1c9a8277cf09a8a3a1d7ae537b5d6e783))
+
+### Testing
+
+
+
+- **(css/parser)** Add tests for selectors (#3770) ([1651bcc](https://github.com/swc-project/swc/commit/1651bccf4578ff2d44a9c37eab3845c006b5164d))
+
+
+- **(css/parser)** Add css files for material design (#3777) ([189707a](https://github.com/swc-project/swc/commit/189707a1fd5ef8547b3b80ac82f7f422f295086a))
+
+
+- **(es/minifier)** Prepare porting more rules from `terser` (#3779) ([86072b5](https://github.com/swc-project/swc/commit/86072b57f9e0cf59b660f88cdb2c9cee15f33720))
+
+### Build
+
+
+
+- **(node-swc)** Rename entrypoint to avoid artifact collision (#3806) ([b485a2f](https://github.com/swc-project/swc/commit/b485a2fc267e0f373b9882e61c14b9fbf7a92471))
+
+## [1.2.146] - 2022-02-27
+
+### Bug Fixes
+
+
+
+- **(css)** Fix processing of integers (#3752) ([f258ee4](https://github.com/swc-project/swc/commit/f258ee4729ccd007b43b1a08d77359d99f53ca87))
+
+
+- **(es/codegen)** Fix escaping of unicodes in es5 (#3636) ([dba90ea](https://github.com/swc-project/swc/commit/dba90eae875bbaec9911c6dd72d482b75de77982))
+
+
+- **(es/helpers)** Cast the result of the `instanceof` helper to boolean (#3728) ([72c9e6c](https://github.com/swc-project/swc/commit/72c9e6ca2b8186c4b297658bec1ce37912898d9f))
+
+
+- **(es/parser)** Handle trailing comma and bracket after an arrow function in conditional (#3685) ([342dccc](https://github.com/swc-project/swc/commit/342dccce473aa507eabb3eed96485e2ff0674188))
+
+
+- **(es/typescript)** Allow empty nested namespaces (#3754) ([f5a3647](https://github.com/swc-project/swc/commit/f5a364736420c2977a5d1211ead55ea91700fccb))
+
+
+- **(plugin/macro)** Do not free guest memory twice (#3732) ([d8b0166](https://github.com/swc-project/swc/commit/d8b01660dcd0bca43993043e8fa6ed33c62894a9))- **general**: Fix(es/parser) Throw a syntax error for `const` without initializer in strict mode (#3742)
+
+Co-authored-by: Donny/강동윤 <kdy1997.dev@gmail.com> ([abc0572](https://github.com/swc-project/swc/commit/abc05725575b0ee29319f32beadb014e70af5e06))
+
+### Features
+
+
+
+- **(cli)** Add tracing options for `compile` command (#3746) ([41f92d2](https://github.com/swc-project/swc/commit/41f92d228b778193e12c51466630a42cb8953599))
+
+
+- **(css/ast)** Support more selectors (#3729) ([f5c5e77](https://github.com/swc-project/swc/commit/f5c5e7761297e4413a1615e2537ade885ec12280))
+
+
+- **(css/ast)** Allow more syntax for `@supports` at-rule (#3740) ([9b92eba](https://github.com/swc-project/swc/commit/9b92eba63686fee2176715fad8d072d6d6d34fe9))
+
+
+- **(css/ast)** Improve type definitions for unicode ranges (#3757) ([91cf965](https://github.com/swc-project/swc/commit/91cf965e07a5382349262c6d6993477fde68aa58))
+
+
+- **(css/minifier)** Compress `display` (#3706) ([8512719](https://github.com/swc-project/swc/commit/8512719e126d4041133a78e106bce6c7eca30154))
+
+
+- **(es/codegen)** Add sourcemap entry for injected semicolons (#3750) ([0fd4fd2](https://github.com/swc-project/swc/commit/0fd4fd242287fde0e6a744dabf7c09430fb23d21))
+
+
+- **(es/compat)** Implement loose mode for `class_properties` (#3722) ([14155eb](https://github.com/swc-project/swc/commit/14155eb0e7f6295471c92067afa4dfb84b3224ca))
+
+
+- **(es/dep-graph)** Add `TsImportEqualsDecl` for `DependencyCollector` (#3758) ([7de7eca](https://github.com/swc-project/swc/commit/7de7ecaa85f21d074d8ca8a05dae2bf5b4ab3ce8))
+
+
+- **(es/parser)** Provide more api for reducing binary size (#3747) ([47ccff8](https://github.com/swc-project/swc/commit/47ccff8a7ca0054fcd761ea5878a92165f7e1c6b))
+
+
+- **(macros)** Add `#[swc_trace]` (#3738) ([b4830b6](https://github.com/swc-project/swc/commit/b4830b61dc7be716fd4de3703537517e6adefdba))
+
+
+- **(node-swc)** Add experimental trace support in `@swc/core` (#3731) ([a454996](https://github.com/swc-project/swc/commit/a454996314f31ed9d8672e10588ef94815b16e98))
+
+
+- **(plugin)** Support tracing plugin execution (#3744) ([5c29f15](https://github.com/swc-project/swc/commit/5c29f156404002d6946fbc7a71d76a6c97d7b82a))
+
+
+- **(visit)** Allow using `?Sized` as visitor (#3745) ([b0b5d5d](https://github.com/swc-project/swc/commit/b0b5d5d0c2779e48d815fbbc65c01d5344590763))
+
+### Miscellaneous Tasks
+- **general**: Skip CI for automated commits (#3760) ([6d98d14](https://github.com/swc-project/swc/commit/6d98d146a65e801677e63069bc52e66bb5315617))- **general**: Skip more actions for automated commits (#3761) ([0ff4ad3](https://github.com/swc-project/swc/commit/0ff4ad37c3783e7b141c6d879ed0a5a7e85135a3))
+
+### Performance
+
+
+
+- **(es/modules)** Reduce usage of generics (#3743) ([1094018](https://github.com/swc-project/swc/commit/1094018153bc7d0373d9b7b533193191f416406d))
+
+
+- **(es/parser)** Reduce usage of generics to reduce binary size (#3726) ([e21579d](https://github.com/swc-project/swc/commit/e21579d84ec287632393480e86032cc228bef0ce))
+
+### Refactor
+
+
+
+- **(es)** Make compilation faster (#3749) ([3d94465](https://github.com/swc-project/swc/commit/3d944656bfa47532a79925f5b7392e2aec1a8a30))
+
+
+- **(es/transforms)** Use recommended ast apis (#3735) ([fd22379](https://github.com/swc-project/swc/commit/fd223793e86f70400a3a69d7f7c8a4775b8abaad))
+
+### Testing
+
+
+
+- **(css/parser)** Add malformed hex color tests (#3762) ([9f90882](https://github.com/swc-project/swc/commit/9f90882b27d345fac79f938d42e1b5fd04d4b1b5))
+
+## [1.2.145] - 2022-02-24
+
+### Bug Fixes
+
+
+
 - **(es/codegen)** Fix sourcemap of comments (#3723) ([b8b0c92](https://github.com/swc-project/swc/commit/b8b0c920e49c235fb65ca5585d343d2af79f9526))
 
 

package/Visitor.js

@@ -779,7 +779,7 @@ class Visitor {
         }
     }
     visitOptionalChainingExpression(n) {
-        n.expr = this.visitExpression(n.expr);
+        n.base = this.visitExpression(n.base);
         return n;
     }
     visitAssignmentExpression(n) {

package/binding.d.ts

@@ -11,4 +11,5 @@ export const transform: any;
 export const transformSync: any;
 export const transformFile: any;
 export const transformFileSync: any;
+export const initCustomTraceSubscriber: any;
 export const Compiler: any;

package/binding.js

@@ -1,15 +1,15 @@
 "use strict";
-const { existsSync, readFileSync } = require("fs");
-const { join } = require("path");
+const { existsSync, readFileSync } = require('fs');
+const { join } = require('path');
 const { platform, arch } = process;
 let nativeBinding = null;
 let localFileExisted = false;
 let loadError = null;
 function isMusl() {
     // For Node 10
-    if (!process.report || typeof process.report.getReport !== "function") {
+    if (!process.report || typeof process.report.getReport !== 'function') {
         try {
-            return readFileSync("/usr/bin/ldd", "utf8").includes("musl");
+            return readFileSync('/usr/bin/ldd', 'utf8').includes('musl');
         }
         catch (e) {
             return true;
@@ -21,30 +21,30 @@ function isMusl() {
     }
 }
 switch (platform) {
-    case "android":
+    case 'android':
         switch (arch) {
-            case "arm64":
-                localFileExisted = existsSync(join(__dirname, "swc.android-arm64.node"));
+            case 'arm64':
+                localFileExisted = existsSync(join(__dirname, 'swc.android-arm64.node'));
                 try {
                     if (localFileExisted) {
-                        nativeBinding = require("./swc.android-arm64.node");
+                        nativeBinding = require('./swc.android-arm64.node');
                     }
                     else {
-                        nativeBinding = require("@swc/core-android-arm64");
+                        nativeBinding = require('@swc/core-android-arm64');
                     }
                 }
                 catch (e) {
                     loadError = e;
                 }
                 break;
-            case "arm":
-                localFileExisted = existsSync(join(__dirname, "swc.android-arm-eabi.node"));
+            case 'arm':
+                localFileExisted = existsSync(join(__dirname, 'swc.android-arm-eabi.node'));
                 try {
                     if (localFileExisted) {
-                        nativeBinding = require("./swc.android-arm-eabi.node");
+                        nativeBinding = require('./swc.android-arm-eabi.node');
                     }
                     else {
-                        nativeBinding = require("@swc/core-android-arm-eabi");
+                        nativeBinding = require('@swc/core-android-arm-eabi');
                     }
                 }
                 catch (e) {
@@ -55,44 +55,44 @@ switch (platform) {
                 throw new Error(`Unsupported architecture on Android ${arch}`);
         }
         break;
-    case "win32":
+    case 'win32':
         switch (arch) {
-            case "x64":
-                localFileExisted = existsSync(join(__dirname, "swc.win32-x64-msvc.node"));
+            case 'x64':
+                localFileExisted = existsSync(join(__dirname, 'swc.win32-x64-msvc.node'));
                 try {
                     if (localFileExisted) {
-                        nativeBinding = require("./swc.win32-x64-msvc.node");
+                        nativeBinding = require('./swc.win32-x64-msvc.node');
                     }
                     else {
-                        nativeBinding = require("@swc/core-win32-x64-msvc");
+                        nativeBinding = require('@swc/core-win32-x64-msvc');
                     }
                 }
                 catch (e) {
                     loadError = e;
                 }
                 break;
-            case "ia32":
-                localFileExisted = existsSync(join(__dirname, "swc.win32-ia32-msvc.node"));
+            case 'ia32':
+                localFileExisted = existsSync(join(__dirname, 'swc.win32-ia32-msvc.node'));
                 try {
                     if (localFileExisted) {
-                        nativeBinding = require("./swc.win32-ia32-msvc.node");
+                        nativeBinding = require('./swc.win32-ia32-msvc.node');
                     }
                     else {
-                        nativeBinding = require("@swc/core-win32-ia32-msvc");
+                        nativeBinding = require('@swc/core-win32-ia32-msvc');
                     }
                 }
                 catch (e) {
                     loadError = e;
                 }
                 break;
-            case "arm64":
-                localFileExisted = existsSync(join(__dirname, "swc.win32-arm64-msvc.node"));
+            case 'arm64':
+                localFileExisted = existsSync(join(__dirname, 'swc.win32-arm64-msvc.node'));
                 try {
                     if (localFileExisted) {
-                        nativeBinding = require("./swc.win32-arm64-msvc.node");
+                        nativeBinding = require('./swc.win32-arm64-msvc.node');
                     }
                     else {
-                        nativeBinding = require("@swc/core-win32-arm64-msvc");
+                        nativeBinding = require('@swc/core-win32-arm64-msvc');
                     }
                 }
                 catch (e) {
@@ -103,30 +103,30 @@ switch (platform) {
                 throw new Error(`Unsupported architecture on Windows: ${arch}`);
         }
         break;
-    case "darwin":
+    case 'darwin':
         switch (arch) {
-            case "x64":
-                localFileExisted = existsSync(join(__dirname, "swc.darwin-x64.node"));
+            case 'x64':
+                localFileExisted = existsSync(join(__dirname, 'swc.darwin-x64.node'));
                 try {
                     if (localFileExisted) {
-                        nativeBinding = require("./swc.darwin-x64.node");
+                        nativeBinding = require('./swc.darwin-x64.node');
                     }
                     else {
-                        nativeBinding = require("@swc/core-darwin-x64");
+                        nativeBinding = require('@swc/core-darwin-x64');
                     }
                 }
                 catch (e) {
                     loadError = e;
                 }
                 break;
-            case "arm64":
-                localFileExisted = existsSync(join(__dirname, "swc.darwin-arm64.node"));
+            case 'arm64':
+                localFileExisted = existsSync(join(__dirname, 'swc.darwin-arm64.node'));
                 try {
                     if (localFileExisted) {
-                        nativeBinding = require("./swc.darwin-arm64.node");
+                        nativeBinding = require('./swc.darwin-arm64.node');
                     }
                     else {
-                        nativeBinding = require("@swc/core-darwin-arm64");
+                        nativeBinding = require('@swc/core-darwin-arm64');
                     }
                 }
                 catch (e) {
@@ -137,34 +137,34 @@ switch (platform) {
                 throw new Error(`Unsupported architecture on macOS: ${arch}`);
         }
         break;
-    case "freebsd":
-        if (arch !== "x64") {
+    case 'freebsd':
+        if (arch !== 'x64') {
             throw new Error(`Unsupported architecture on FreeBSD: ${arch}`);
         }
-        localFileExisted = existsSync(join(__dirname, "swc.freebsd-x64.node"));
+        localFileExisted = existsSync(join(__dirname, 'swc.freebsd-x64.node'));
         try {
             if (localFileExisted) {
-                nativeBinding = require("./swc.freebsd-x64.node");
+                nativeBinding = require('./swc.freebsd-x64.node');
             }
             else {
-                nativeBinding = require("@swc/core-freebsd-x64");
+                nativeBinding = require('@swc/core-freebsd-x64');
             }
         }
         catch (e) {
             loadError = e;
         }
         break;
-    case "linux":
+    case 'linux':
         switch (arch) {
-            case "x64":
+            case 'x64':
                 if (isMusl()) {
-                    localFileExisted = existsSync(join(__dirname, "swc.linux-x64-musl.node"));
+                    localFileExisted = existsSync(join(__dirname, 'swc.linux-x64-musl.node'));
                     try {
                         if (localFileExisted) {
-                            nativeBinding = require("./swc.linux-x64-musl.node");
+                            nativeBinding = require('./swc.linux-x64-musl.node');
                         }
                         else {
-                            nativeBinding = require("@swc/core-linux-x64-musl");
+                            nativeBinding = require('@swc/core-linux-x64-musl');
                         }
                     }
                     catch (e) {
@@ -172,13 +172,13 @@ switch (platform) {
                     }
                 }
                 else {
-                    localFileExisted = existsSync(join(__dirname, "swc.linux-x64-gnu.node"));
+                    localFileExisted = existsSync(join(__dirname, 'swc.linux-x64-gnu.node'));
                     try {
                         if (localFileExisted) {
-                            nativeBinding = require("./swc.linux-x64-gnu.node");
+                            nativeBinding = require('./swc.linux-x64-gnu.node');
                         }
                         else {
-                            nativeBinding = require("@swc/core-linux-x64-gnu");
+                            nativeBinding = require('@swc/core-linux-x64-gnu');
                         }
                     }
                     catch (e) {
@@ -186,15 +186,15 @@ switch (platform) {
                     }
                 }
                 break;
-            case "arm64":
+            case 'arm64':
                 if (isMusl()) {
-                    localFileExisted = existsSync(join(__dirname, "swc.linux-arm64-musl.node"));
+                    localFileExisted = existsSync(join(__dirname, 'swc.linux-arm64-musl.node'));
                     try {
                         if (localFileExisted) {
-                            nativeBinding = require("./swc.linux-arm64-musl.node");
+                            nativeBinding = require('./swc.linux-arm64-musl.node');
                         }
                         else {
-                            nativeBinding = require("@swc/core-linux-arm64-musl");
+                            nativeBinding = require('@swc/core-linux-arm64-musl');
                         }
                     }
                     catch (e) {
@@ -202,13 +202,13 @@ switch (platform) {
                     }
                 }
                 else {
-                    localFileExisted = existsSync(join(__dirname, "swc.linux-arm64-gnu.node"));
+                    localFileExisted = existsSync(join(__dirname, 'swc.linux-arm64-gnu.node'));
                     try {
                         if (localFileExisted) {
-                            nativeBinding = require("./swc.linux-arm64-gnu.node");
+                            nativeBinding = require('./swc.linux-arm64-gnu.node');
                         }
                         else {
-                            nativeBinding = require("@swc/core-linux-arm64-gnu");
+                            nativeBinding = require('@swc/core-linux-arm64-gnu');
                         }
                     }
                     catch (e) {
@@ -216,14 +216,14 @@ switch (platform) {
                     }
                 }
                 break;
-            case "arm":
-                localFileExisted = existsSync(join(__dirname, "swc.linux-arm-gnueabihf.node"));
+            case 'arm':
+                localFileExisted = existsSync(join(__dirname, 'swc.linux-arm-gnueabihf.node'));
                 try {
                     if (localFileExisted) {
-                        nativeBinding = require("./swc.linux-arm-gnueabihf.node");
+                        nativeBinding = require('./swc.linux-arm-gnueabihf.node');
                     }
                     else {
-                        nativeBinding = require("@swc/core-linux-arm-gnueabihf");
+                        nativeBinding = require('@swc/core-linux-arm-gnueabihf');
                     }
                 }
                 catch (e) {
@@ -243,7 +243,7 @@ if (!nativeBinding) {
     }
     throw new Error(`Failed to load native binding`);
 }
-const { bundle, minify, minifySync, parse, parseSync, parseFileSync, parseFile, print, printSync, transform, transformSync, transformFile, transformFileSync, Compiler, } = nativeBinding;
+const { bundle, minify, minifySync, parse, parseSync, parseFileSync, parseFile, print, printSync, transform, transformSync, transformFile, transformFileSync, initCustomTraceSubscriber, Compiler } = nativeBinding;
 module.exports.bundle = bundle;
 module.exports.minify = minify;
 module.exports.minifySync = minifySync;
@@ -257,4 +257,5 @@ module.exports.transform = transform;
 module.exports.transformSync = transformSync;
 module.exports.transformFile = transformFile;
 module.exports.transformFileSync = transformFileSync;
+module.exports.initCustomTraceSubscriber = initCustomTraceSubscriber;
 module.exports.Compiler = Compiler;

package/index.d.ts

@@ -70,4 +70,26 @@ export declare function bundle(options?: BundleInput | string): Promise<{
 }>;
 export declare function minify(src: string, opts?: JsMinifyOptions): Promise<Output>;
 export declare function minifySync(src: string, opts?: JsMinifyOptions): Output;
+/**
+ * Configure custom trace configuration runs for a process lifecycle.
+ * Currently only chromium's trace event format is supported.
+ * (https://docs.google.com/document/d/1CvAClvFfyA5R-PhYUmn5OOQtYMH4h6I0nSsKchNAySU/preview)
+ *
+ * This should be called before calling any binding interfaces exported in `@swc/core`, such as
+ * `transform*`, or `parse*` or anything. To avoid breaking changes, each binding fn internally
+ * sets default trace subscriber if not set.
+ *
+ * Unlike other configuration, this does not belong to individual api surface using swcrc
+ * or api's parameters (`transform(..., {trace})`). This is due to current tracing subscriber
+ * can be configured only once for the global scope. Calling `registerGlobalTraceConfig` multiple
+ * time won't cause error, subsequent calls will be ignored.
+ *
+ * As name implies currently this is experimental interface may change over time without semver
+ * major breaking changes. Please provide feedbacks,
+ * or bug report at https://github.com/swc-project/swc/discussions.
+ */
+export declare function __experimental_registerGlobalTraceConfig(traceConfig: {
+    type: 'traceEvent';
+    fileName?: string;
+}): void;
 export declare const DEFAULT_EXTENSIONS: readonly string[];

package/index.js

@@ -30,7 +30,7 @@ var __rest = (this && this.__rest) || function (s, e) {
     return t;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_EXTENSIONS = exports.minifySync = exports.minify = exports.bundle = exports.transformFileSync = exports.transformFile = exports.transformSync = exports.transform = exports.printSync = exports.print = exports.parseFileSync = exports.parseFile = exports.parseSync = exports.parse = exports.Compiler = exports.plugins = exports.version = void 0;
+exports.DEFAULT_EXTENSIONS = exports.__experimental_registerGlobalTraceConfig = exports.minifySync = exports.minify = exports.bundle = exports.transformFileSync = exports.transformFile = exports.transformSync = exports.transform = exports.printSync = exports.print = exports.parseFileSync = exports.parseFile = exports.parseSync = exports.parse = exports.Compiler = exports.plugins = exports.version = void 0;
 const path_1 = require("path");
 __exportStar(require("./types"), exports);
 const spack_1 = require("./spack");
@@ -239,6 +239,30 @@ function minifySync(src, opts) {
     return compiler.minifySync(src, opts);
 }
 exports.minifySync = minifySync;
+/**
+ * Configure custom trace configuration runs for a process lifecycle.
+ * Currently only chromium's trace event format is supported.
+ * (https://docs.google.com/document/d/1CvAClvFfyA5R-PhYUmn5OOQtYMH4h6I0nSsKchNAySU/preview)
+ *
+ * This should be called before calling any binding interfaces exported in `@swc/core`, such as
+ * `transform*`, or `parse*` or anything. To avoid breaking changes, each binding fn internally
+ * sets default trace subscriber if not set.
+ *
+ * Unlike other configuration, this does not belong to individual api surface using swcrc
+ * or api's parameters (`transform(..., {trace})`). This is due to current tracing subscriber
+ * can be configured only once for the global scope. Calling `registerGlobalTraceConfig` multiple
+ * time won't cause error, subsequent calls will be ignored.
+ *
+ * As name implies currently this is experimental interface may change over time without semver
+ * major breaking changes. Please provide feedbacks,
+ * or bug report at https://github.com/swc-project/swc/discussions.
+ */
+function __experimental_registerGlobalTraceConfig(traceConfig) {
+    if (traceConfig.type === 'traceEvent') {
+        bindings.initCustomTraceSubscriber(traceConfig.fileName);
+    }
+}
+exports.__experimental_registerGlobalTraceConfig = __experimental_registerGlobalTraceConfig;
 exports.DEFAULT_EXTENSIONS = Object.freeze([
     ".js",
     ".jsx",

package/package.json

@@ -1,9 +1,12 @@
 {
   "name": "@swc/core",
-  "version": "1.2.145",
+  "version": "1.2.148",
   "description": "Super-fast alternative for babel",
   "homepage": "https://swc.rs",
   "main": "./index.js",
+  "bin": {
+    "swcx": "run_swcx.js"
+  },
   "author": "강동윤 <kdy1997.dev@gmail.com>",
   "license": "Apache-2.0",
   "keywords": [
@@ -104,18 +107,18 @@
     "url": "https://opencollective.com/swc"
   },
   "optionalDependencies": {
-    "@swc/core-win32-x64-msvc": "1.2.145",
-    "@swc/core-darwin-x64": "1.2.145",
-    "@swc/core-linux-x64-gnu": "1.2.145",
-    "@swc/core-linux-x64-musl": "1.2.145",
-    "@swc/core-freebsd-x64": "1.2.145",
-    "@swc/core-win32-ia32-msvc": "1.2.145",
-    "@swc/core-linux-arm64-gnu": "1.2.145",
-    "@swc/core-linux-arm-gnueabihf": "1.2.145",
-    "@swc/core-darwin-arm64": "1.2.145",
-    "@swc/core-android-arm64": "1.2.145",
-    "@swc/core-linux-arm64-musl": "1.2.145",
-    "@swc/core-win32-arm64-msvc": "1.2.145",
-    "@swc/core-android-arm-eabi": "1.2.145"
+    "@swc/core-win32-x64-msvc": "1.2.148",
+    "@swc/core-darwin-x64": "1.2.148",
+    "@swc/core-linux-x64-gnu": "1.2.148",
+    "@swc/core-linux-x64-musl": "1.2.148",
+    "@swc/core-freebsd-x64": "1.2.148",
+    "@swc/core-win32-ia32-msvc": "1.2.148",
+    "@swc/core-linux-arm64-gnu": "1.2.148",
+    "@swc/core-linux-arm-gnueabihf": "1.2.148",
+    "@swc/core-darwin-arm64": "1.2.148",
+    "@swc/core-android-arm64": "1.2.148",
+    "@swc/core-linux-arm64-musl": "1.2.148",
+    "@swc/core-win32-arm64-msvc": "1.2.148",
+    "@swc/core-android-arm-eabi": "1.2.148"
   }
 }

package/run_swcx.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/run_swcx.js

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Lightweight entrypoint to native swc cli binary.
+ *
+ * This is to locate corresponding per-platform executables correctly, as well as
+ * let npm links binary to `node_modules/.bin` allows npm-related ecosystem (`npx swcx`, etcs)
+ * works correctly. However, it means spawning native binary still requires warmup from node.js
+ * process.
+ *
+ * NOTE: THIS IS NOT A PERMANENT APPROACH.
+ * Distribution of native cli binary is not fully concluded yet. This allows easier
+ * opt-in while implementation is in progress to collect feedback.
+ */
+const child_process_1 = require("child_process");
+const path_1 = __importDefault(require("path"));
+const fs_1 = require("fs");
+const { platform, arch } = process;
+const isMusl = () => (() => {
+    function isMusl() {
+        if (!process.report || typeof process.report.getReport !== "function") {
+            try {
+                return (0, fs_1.readFileSync)("/usr/bin/ldd", "utf8").includes("musl");
+            }
+            catch (e) {
+                return true;
+            }
+        }
+        else {
+            const { glibcVersionRuntime } = process.report.getReport().header;
+            return !glibcVersionRuntime;
+        }
+    }
+    return isMusl();
+})();
+const platformPackagesMap = {
+    "android": {
+        "arm64": "@swc/core-android-arm64",
+        "arm": "@swc/core-android-arm-eabi",
+    },
+    "win32": {
+        "x64": "@swc/core-win32-x64-msvc",
+        "ia32": "@swc/core-win32-ia32-msvc",
+        "arm64": "@swc/core-win32-arm64-msvc"
+    },
+    "darwin": {
+        "x64": "@swc/core-darwin-x64",
+        "arm64": "@swc/core-darwin-arm64",
+    },
+    "freebsd": {
+        "x64": "@swc/core-freebsd-x64",
+    },
+    "linux": {
+        "x64": `@swc/core-linux-x64-${isMusl() ? 'musl' : 'gnu'}`,
+        "arm64": `@swc/core-linux-arm64-${isMusl() ? 'musl' : 'gnu'}`,
+        "arm": "@swc/core-linux-arm64-gnu"
+    },
+};
+const inferBinaryName = () => {
+    const packageName = platformPackagesMap[platform][arch];
+    if (!packageName) {
+        throw new Error(`Unsupported platform: binary for '${platform} ${arch}' is not available`);
+    }
+    return path_1.default.join(path_1.default.dirname(require.resolve(packageName)), platform === 'win32' ? 'swc.exe' : 'swc');
+};
+const executeBinary = () => __awaiter(void 0, void 0, void 0, function* () {
+    const binary = inferBinaryName();
+    const [, , ...args] = process.argv;
+    const options = { cwd: process.cwd(), stdio: "inherit" };
+    return (0, child_process_1.spawn)(binary, args, options);
+});
+executeBinary().catch((e) => console.error(e));

package/types.d.ts

@@ -742,7 +742,7 @@ export interface OptionalChainingExpression extends ExpressionBase {
     /**
      * Call expression or member expression.
      */
-    expr: Expression;
+    base: Expression;
 }
 export interface ThisExpression extends ExpressionBase {
     type: "ThisExpression";
@@ -1020,6 +1020,7 @@ export interface ExportNamedDeclaration extends Node, HasSpan {
     type: "ExportNamedDeclaration";
     specifiers: ExportSpecifier[];
     source?: StringLiteral;
+    typeOnly: boolean;
 }
 export interface ExportDefaultDeclaration extends Node, HasSpan {
     type: "ExportDefaultDeclaration";

package/docs/adr/00000-whats-the-big-idea.md

@@ -1 +0,0 @@
-### This adr attempts to describe 10,000ft view for the swc project itself. To be filled gradually.

package/docs/adr/00001-support-transformation-plugin-native.md

@@ -1,94 +0,0 @@
-# Support transform plugin in native rust binaries
-
--   Status: accepted <!-- optional -->
--   Deciders: @kdy1, @kwonoj <!-- optional -->
--   Date: 2021-01-01 <!-- optional -->
-
-Technical Story: [Issue](https://github.com/swc-project/swc/issues/2635) <!-- optional -->
-
-## Context and Problem Statement
-
-SWC wants to support load, run plugins in the native binary for the custom transform behavior. SWC already have priliminary support to load plugins in its node.js JS bindings but it has known limitations.
-
-## Decision Drivers <!-- optional -->
-
--   Allow to write a plugin binary can be loaded in the SWC's native binary without involving JS binding interop.
--   Provide good, satisfactory performance while loading, running plugin's custom transformation.
--   Keep abi stability as much, plugin binary should work across different versions of SWC host binary except intended breaking changes.
--   Allow to write a plugin without caring much around the native platform targets binaries.
-
-## Considered Options
-
--   [option 1] JS-based plugins, including babel plugins
-
--   [option 2] Plugins based on `abi_stable` and native dynamic libraries
-
--   [option 3] Wasm plugins based on `wasmtime`
-
--   **[option 4]** Wasm plugins based on `wasmer`
-
-## Decision Outcome
-
-Chosen option: **[option 4] Wasm plugins based on `wasmer`**
-
-This decision is taken because
-
--   It was relatively easy plugin author to generate single binary works across most of platforms SWC's host binary supports, without concern of cross-target compilations.
--   It was relatively easy to achieve abi-stable between SWC host to plugin binaries.
--   It doesn't require to have separate, specialized AST struct (named `plugin_ast`) to pass into ffi boundary of the plugin.
--   Its serialization / deserialization performance is near identical or faster than `abi_stable` based ffi
-
-## Pros and Cons of the Options <!-- optional -->
-
-### [option 1] JS-based plugins, including babel plugins
-
-SWC allow implementing plugins using javascript, and call it from worker threads as required.
-This includes babel plugins, to make migration from babel more convenient.
-
--   Good, because users can use rich ecosystem of babel.
--   Good, because users are used to javascript.
--   Good, because all platforms are supported.
--   Bad, because passing data to and from javascript is very costly. ([SWC issue: Speed up `parse`](https://github.com/swc-project/swc/issues/2175))
--   Bad, because js plugins require and block the main javascript thread.
--   Bad, because the main javascript is singled threaded and be bottleneck.
--   Bad, because `napi` (renamed to `node-api`) does not provide a way to get the return value of a function called from other thread than js thread. To workaround this, we should implement a complex request-response system based using lots of mutex.
--   Bad, because node js worker thread is not an event loop. This means worker we cannot `yield` from a worker thread when we need to call js plugin. As a result, the when main js thread is busy because of js plugins, worker threads are also blocked without doing any task.
-
-### [option 2] Plugins based on `abi_stable` and native dynamic libraries
-
-Plugins are written in rust, and built as native libraries for each platforms. SWC pass data to plugin using special form of AST, which has stable memory representation regardless of the version of `rustc`.
-
--   Good, because it's fast, even on the first run.
--   Good, because it does not require very complex request-response system.
--   Good, because plugin authors can use all features of rust.
--   Bad, because configuring CI for publishing plugins is very hard.
--   Bad, because plugin developer cannot publish a plugin from a single machine.
--   Bad, because loading of plugins is complex. Path for dynamic libraries are platform-dependant.
--   Bad, because we have to handle quirks of each platforms.
--   Bad, because `@swc/wasm` has no way to support plugins.
-
-### [option 3] Wasm plugins based on `wasmtime`
-
-SWC embeds `wasmtime`, loads plugin built as web assembly.
-
--   Good, because it's fast except the first run.
--   Good, because configuring CI is simple.
--   Good, because plugin authors can publish a plugin without CI, even with a single machine.
--   Bad, because `@swc/wasm` has no way to support plugins.
--   Bad, because first run is slow.
--   Bad, because we have to manage the cache of compiled wasm files.
--   Bad, because `wasmtime` does not support all platforms.
-
-### [option 4] Wasm plugins based on `wasmer`
-
-SWC embeds web assembly runtime (https://wasmer.io/), loads plugin built as web assembly.
-
--   Good, because it's fast except the first run.
--   Good, because configuring CI is simple.
--   Good, because plugin authors can publish a plugin without CI, even with a single machine.
--   Good, because `@swc/wasm` can support plugins in future as `wasmer` officially supports using it within a wasm file.
--   Bad, because first run is slow.
--   Bad, because we have to manage the cache of compiled wasm files.
--   Bad, because `wasmer` does not support all platforms.
-
-## Links

package/docs/adr/README.md

@@ -1,13 +0,0 @@
-# Architectural Decision Records
-
-This directory contains a series of [Architectural Decision Records](https://adr.github.io/)
-or "ADRs" for the `swc` project. We're going to try to use it as a kind of collective
-memory of the decisions we've made and the path we've taken to get the project to its current
-point.
-
-Note that these are *historical references* that do not supersede (but might enhance) the living
-documentation of the project itself, which you can find inline in the source code.
-
-Proposing a non-trivial change to the way `swc` works? You might like to start with an ADR
-by copying `template.md` into a new file, filling out a first version of the proposal, and
-posting it as a PR on the github repo for discussion.

package/docs/adr/template.md

@@ -1,72 +0,0 @@
-# [short title of solved problem and solution]
-
-* Status: [proposed | rejected | accepted | deprecated | … | superseded by [ADR-0005](0005-example.md)] <!-- optional -->
-* Deciders: [list everyone involved in the decision] <!-- optional -->
-* Date: [YYYY-MM-DD when the decision was last updated] <!-- optional -->
-
-Technical Story: [description | ticket/issue URL] <!-- optional -->
-
-## Context and Problem Statement
-
-[Describe the context and problem statement, e.g., in free form using two to three sentences. You may want to articulate the problem in form of a question.]
-
-## Decision Drivers <!-- optional -->
-
-* [driver 1, e.g., a force, facing concern, …]
-* [driver 2, e.g., a force, facing concern, …]
-* … <!-- numbers of drivers can vary -->
-
-## Considered Options
-
-* [option 1]
-* [option 2]
-* [option 3]
-* … <!-- numbers of options can vary -->
-
-## Decision Outcome
-
-Chosen option: "[option 1]", because [justification. e.g., only option, which meets k.o. criterion decision driver | which resolves force force | … | comes out best (see below)].
-
-### Positive Consequences <!-- optional -->
-
-* [e.g., improvement of quality attribute satisfaction, follow-up decisions required, …]
-* …
-
-### Negative Consequences <!-- optional -->
-
-* [e.g., compromising quality attribute, follow-up decisions required, …]
-* …
-
-## Pros and Cons of the Options <!-- optional -->
-
-### [option 1]
-
-[example | description | pointer to more information | …] <!-- optional -->
-
-* Good, because [argument a]
-* Good, because [argument b]
-* Bad, because [argument c]
-* … <!-- numbers of pros and cons can vary -->
-
-### [option 2]
-
-[example | description | pointer to more information | …] <!-- optional -->
-
-* Good, because [argument a]
-* Good, because [argument b]
-* Bad, because [argument c]
-* … <!-- numbers of pros and cons can vary -->
-
-### [option 3]
-
-[example | description | pointer to more information | …] <!-- optional -->
-
-* Good, because [argument a]
-* Good, because [argument b]
-* Bad, because [argument c]
-* … <!-- numbers of pros and cons can vary -->
-
-## Links <!-- optional -->
-
-* [Link type] [Link to ADR] <!-- example: Refined by [ADR-0005](0005-example.md) -->
-* … <!-- numbers of links can vary -->