mirror of
https://github.com/oxc-project/oxc.git
synced 2026-09-14 19:36:11 +08:00
oxc-guard
0389c4010e
### 🚀 Features -83cb516minifier: Improve negation of expressions in boolean context (#25755) (Armano) ### 🐛 Bug Fixes -134fb22isolated-declarations: Preserve unresolved parameter types (#25909) (Dunqing) -526c2b3codegen: Remove deprecated test APIs (#25889) (camc314) -344a9b2codegen: Align enum template sourcemaps (#25872) (camc314) ### ⚡ Performance -5ef0c93minifier: Unwrap all unary exprs without creating dummy expressions (#25891) (Armano) -8783524packages/codegen: Remove loop from `growMappingBuffer` (#25886) (overlookmotel) -b6b14c0packages/codegen: Remove redundant branch (#25885) (overlookmotel) -be6adf0packages/sourcemap: Make `location` passed to `recordSourceMapping` always a number (#25884) (overlookmotel) -f720f15packages/codegen: Take named-mapping only code off hot path in `recordSourceMapping` (#25883) (overlookmotel) -a734af5packages/codegen: Remove redundant setting of `last` in `printImportAttributes` and `printIf` (#25882) (overlookmotel) -c6e44c6packages/codegen: Combine 2 writes in `printJSXElement` (#25881) (overlookmotel) -8801662packages/codegen: Remove redundant mapping from `printParams` (#25880) (overlookmotel) ### 📚 Documentation -5ad330epackages/codegen: Reformat comments (#25876) (overlookmotel)
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.