Add support for choosing decomposition rules in decompose-lowering

[kipawaa]

Context:
decompose-lowering always applies all (applicable) decomposition rules in the IR, and removes all decomposition rules on cleanup.

Description of the Change:
Introduces a target-rules option to apply only a subset of the rules available in the IR. Rules are now applied by aligning the target_op's operands with the decomposition functions body and cloning the function body inline, to avoid the inconsistencies/heuristics of the built-in inliner. Rules are no longer removed after the decompose-lowering pass to allow use throughout the pipeline in graph-decomposition passes. Decomposition functions will be removed by the symbol-dce pass at the end of the default pipeline.

Benefits:
Provides a more versatile decompose-lowering pass, and will support a more efficient graph-decomposition pass.

Possible Drawbacks:

Related GitHub Issues:

[sc-122013]

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 96.98%. Comparing base (ce5eefa) to head (0c3b7c7).
⚠️ Report is 2 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #2973   +/-   ##
=======================================
  Coverage   96.98%   96.98%           
=======================================
  Files         166      166           
  Lines       19249    19249           
  Branches     1791     1791           
=======================================
  Hits        18668    18668           
  Misses        429      429           
  Partials      152      152           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[paul0403]

Nice 💯