Files
oxc-guard 894c8f9cd8 release(crates): oxc v0.148.0 (#26198)
### 💥 BREAKING CHANGES

- a31567a allocator: [**BREAKING**] Make `Allocator::cursor_ptr` and `data_end_ptr` private (#26081) (overlookmotel)

### 🚀 Features

- 784e9fa minifier: Invert `!0` and `!1` in place for boolean context to `1` and `0` (#26050) (Armano)
- 1e902cc minifier: Expand fold leading assignments into the var decl (#26142) (Armano)
- 3ed4f6a minifier: Expand de morgan's optimization to allow move of `!` (#25930) (Armano)
- 5672585 parser: Attach all comments to nodes (#25944) (camc314)

### 🐛 Bug Fixes

- 4adfb4c semantic: Validate chained continue labels (#26157) (camc314)
- b874f48 ecmascript: `Math.round` only exact half ties (#26150) (camc314)
- a625378 minifier: Coerce omitted `indexOf` search argument (#26149) (camc314)
- dc7398b ecmascript: Trim trailing whitespace in string to number (#26148) (camc314)
- 243b685 transformer/object-rest: Lower multiple declarators correctly (#26147) (camc314)
- dc09a3a parser: Avoid panic on escaped string export names (#26146) (camc314)
- e412cf2 linter: Clamp invalid JS plugin locations (#26144) (camc314)
- c3dedc9 semantic: Skip function body bindings in parameters (#26099) (Dunqing)
- e74de61 transform-react: Match Babel diagnostic reporting (#26128) (Boshen)
- d5163d0 parser: Correctly classify unapplied pure annotations (#26084) (camc314)
- 8531b9b linter/plugins: Alter method for obtaining mutable `Program` when sending AST to JS plugins (#26077) (overlookmotel)
- 9b51658 regular_expression: Allow oversized decimal escape for Annex B (#26070) (leaysgur)
- c8de4df regular_expression: Reject oversized backreferences (#26055) (camc314)

### ⚡ Performance

- ac4785a diagnostics: Use fixed ANSI styles (#26130) (Boshen)
- 07a0793 packages/codegen: Flatten output in chunks (#26109) (overlookmotel)
- 487427a packages/codegen: Faster string flattening (#26108) (overlookmotel)
- 7785583 packages/codegen: Ensure indent strings are flattened (#26107) (overlookmotel)
- 0dd4db3 packages/codegen: Store mapping positions in an `Int32Array` (#26085) (overlookmotel)
2026-09-01 08:15:07 +00:00
..
…

Oxc Transformer Plugins

Specialized transformation plugins for common JavaScript and TypeScript patterns.

Overview

This crate provides specific transformation plugins that can be used independently or as part of the broader oxc transformation pipeline. These plugins handle common transformation needs like global variable injection and module format conversion.

Key Features

  • Global variable injection: Add global variables to modules
  • Module runner transforms: Transform modules for different execution environments
  • Global defines replacement: Replace compile-time constants
  • Composable plugins: Use individually or combine multiple plugins

Architecture

Plugin System

Each plugin implements the transformation logic for a specific use case:

  • Focused responsibility: Each plugin handles one type of transformation
  • Traverse integration: Uses oxc's traversal system for efficient AST walking
  • Composable: Multiple plugins can be applied in sequence
  • Context-aware: Access to semantic information when needed

Common Use Cases

Build-time Optimizations

  • Dead code elimination: Remove unreachable code paths
  • Constant folding: Replace compile-time constants
  • Environment variables: Inject environment-specific values

Module System Compatibility

  • Polyfill injection: Add necessary polyfills for target environments
  • Global shimming: Provide Node.js globals in browser environments
  • Format conversion: Transform between module formats

Development Tools

  • Debug injection: Add development-time debugging code
  • Hot module replacement: Support for HMR systems
  • Testing utilities: Inject test-specific globals

Integration Points

These plugins integrate with:

  • oxc_transformer: Core transformation infrastructure
  • oxc_traverse: AST traversal and mutation
  • Build tools: Webpack, Vite, Rollup, and other bundlers
  • CLI tools: Direct usage in command-line transformations

The plugin architecture enables extensible, composable transformations while maintaining high performance through oxc's efficient traversal system.