feat: asset resource side effects

[IWANABETHATGUY]

Related issue (if exists)

Closed #2804

Summary

🤖 Generated by Copilot at 070e0b3

This pull request implements and improves the tree-shaking optimization for rspack_core and rspack_plugin_javascript crates, using a new OptimizeAnalyzer trait and a new OptimizeAnalyzeResult struct. It also adds a new sideEffects option to the compiler and the rspack.config.js file, to enable or disable the optimization based on the module metadata. It also adds an example project that demonstrates the usage of asset modules and the tree-shaking optimization.

Walkthrough

🤖 Generated by Copilot at 070e0b3

• Rename TreeShakingResult to OptimizeAnalyzeResult and update imports and types accordingly (link,link,link,link,link,link,link,link,link,link,link,link,link)
• Add include_module_ids field to Compilation struct and populate it with the result of tree-shaking optimization (link,link,link,link,link,link,link,link,link,link,link,link,link,link,link,link)
• Remove used flag from ModuleGraphModule struct and related logic, since it is no longer used for tree-shaking (link,link,link,link,link)
• Rename SideEffect enum to SideEffectType and update imports and pattern matching accordingly (link,link,link,link,link,link,link,link,link,link,link,link,link,link,link)
• Add OptimizeAnalyzer trait and implement it for JsModule and AssetModule structs, to provide a common interface for analyzing different types of modules for tree-shaking optimization (link,link,link,link,link)
• Rename ModuleGraphModule struct to ModuleType and derive it with Default, to avoid confusion with the ModuleGraphModule struct in the module_graph module and allow creating an empty instance (link)
• Add included_in_chunk method to ModuleType struct, to check if a module should be included in the final chunk based on the include_module_ids set and the side_effects_options flag (link,link)
• Move ConvertModulePath trait from mod.rs to utils.rs, to avoid circular imports (link,link,link)
• Add ExtraMark struct to pass the marks for the top-level and helper symbols to the tree-shaker (link,link,link,link,link,link,link)
• Move tree_shaking.rs file from rspack_plugin_javascript crate to rspack_core crate, to make the tree-shaking logic more generic and reusable for different types of modules (link)
• Add options parameter to tree_shaking function and TreeShaker struct, to pass the compiler options to the tree-shaker (link,link,link,link)
• Change visibility of from_description method of SideEffects struct to pub, to allow using it from other modules (link)
• Add index.js and package.json files to examples/basic/a folder, to demonstrate the usage of an asset module and the tree-shaking optimization (link,link)
• Update rspack.config.js file to enable sideEffects and treeShaking options, set mode to development, and specify the type of asset modules (link)

[changeset-bot]

⚠️ No Changeset found

Latest commit: ba909a2

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR