✨ Support reusable QC functions in QIR output

[burgholzer]

🤖 AI text below 🤖

Description

Prepare reusable functions for Base and Adaptive QIR with the stock MLIR inliner. Coordinated QIR output inlines before QCO optimization so existing synthesis can reduce compound helpers, then normalizes global phases, unrolls modifiers, and canonicalizes before QIR conversion.

This PR is stacked on #2339 and follows the current Programs/Pipeline library split. QC, QCO, and jeff routes retain ordinary reusable calls. Unsynthesized shared-wire compound powers remain unsupported; no unsafe power distribution or call-specific QIR lowering is added.

Compiler-created and caller-owned typed-program contexts receive the standard Func/LLVM inliner extensions. Regressions cover the public textual inline pipeline and the controlled-power numeric relative phase.

Codex implemented and tested the changes with independent QIR/MLIR specialist review.

Integrated-stack validation: release build; all 3,916 registered CTest cases with one expected skip; all 294 Qiskit translation tests; whole-file C++ lint and repository lint. Stub generation passed without tracked changes. Hosted CI is separate evidence and has not been claimed as passed.

Checklist

• The pull request only contains commits that are focused and relevant to this change.
• I have added appropriate tests that cover the new/changed functionality.
• I have updated the documentation to reflect these changes.
• I have added entries to the changelog for any noteworthy additions, changes, fixes, or removals.
• I have added migration instructions to the upgrade guide (if needed).
• The changes follow the project style guidelines and introduce no new warnings.
• The changes are fully tested and pass the CI checks.
• I have reviewed my own code changes.

If PR contains AI-assisted content:

• Any agent that created, edited, or submitted GitHub content was explicitly authorized for that scope, as required by our AI Usage Guidelines.
• Every agent-authored or agent-edited public text body begins with the visible disclosure 🤖 *AI text below* 🤖 (titles are exempt).
• I have disclosed AI assistance in the PR description.
• I confirm that I have personally reviewed and understood all AI-generated content, and accept full responsibility for it.

[codecov]

Codecov Report

❌ Patch coverage is 96.15385% with 1 line in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
mlir/lib/Compiler/Pipeline.cpp	83.3%	1 Missing ⚠️

📢 Thoughts on this report? Let us know!

[burgholzer]

This also feels very clean. Getting this in