scripts/repro/swc-minifier-matrix/README.md

GitHub

SWC Minifier Reproduction Matrix

This harness checks how focused SWC minifier options lower small JavaScript snippets, then runs Wakaru on the lowered output. It is for investigation, not a committed snapshot source.

Use the local sibling ../swc repository as a reference for minifier source and test shapes. The matrix owns the Wakaru-facing expectations because SWC's tests assert minified output, not decompiler output.

node scripts/repro/swc-minifier-matrix/matrix.mjs

Add --details to print full original, lowered, and recovered code for missed cases. Add --level minimal, --level standard, or --level aggressive to run Wakaru with a specific rewrite level.

Rows marked no or info-miss are investigation findings and do not make the script exit non-zero. The script exits non-zero only when SWC or Wakaru cannot run.

The matrix installs @swc/core@1 under target/repro-tools/swc-minifier/. Set WAKARU to test a specific binary:

$env:WAKARU = "$PWD\target\debug\wakaru.exe"
node scripts/repro/swc-minifier-matrix/matrix.mjs --details

Rows are grouped by distinct lowered output per snippet. The grouping key only normalizes CRLF to LF and trims leading/trailing whitespace, so exact minifier shape is preserved while duplicate tool outputs are collapsed.

Some rows are informational. Constant folding and full inlining can erase the original structure, so those rows document what Wakaru currently emits rather than implying a reversible source recovery is expected.

Promoting Findings

When the matrix finds a useful missed shape, minimize the lowered code and add a focused Rust unit test. Do not rely on matrix output or pipeline snapshots alone.

  • Sequence recovery belongs in crates/core/tests/simplify_sequence_rule.rs.
  • !0 / !1 recovery belongs in crates/core/tests/unminify_booleans_rule.rs.
  • !!x recovery belongs in crates/core/tests/un_double_negation_rule.rs.
  • Inline and IIFE findings belong in smart_inline_rule.rs or un_iife_rule.rs.
  • Mangle/name recovery findings belong in smart_rename_rule.rs, unless the finding is helper body detection, in which case use the specific helper test or pipeline_helpers_rule.rs.

Record the producer in the test comment, for example:

// Produced by @swc/core minify with compress.sequences=true, mangle=false.