feat: Add methods to store & restore UI component state

[tobezdev]

Caution

Feature freeze is active, as described by our Release Schedule.

Summary

Addresses issue #2385 by adding methods to store and restore UI component states via new methods ui.View.to_component_instances() & ui.View.from_components(). The method View.from_components() has also been edited to preserve row indexes by using enumerate() rather than _walk_all_components().

Note: I have intentionally not updated any formal documentation (markdown files) as I do not believe this is required. Any new functions have docstrings explaining their exact behaviour (and their code is very readable anyways). Anything existing has not been fundamentally changed so there will be no difference in terms of how people will use those methods. Please let me know if a documentation change is required and I will be happy to add this into the PR.

The Copilot CLI was used in the development of this PR, although no code was generated by it. It was used simply to identify an issue on this repo that I could have an attempt at using the GitHub MCP server, and I used it to understand the structure and standards of the already-existing code (for example, the format of docstrings).

Information

• This PR fixes an issue.
• This PR adds something new (e.g. new method or parameters).
• This PR is a breaking change (e.g. methods or parameters removed/renamed).
• This PR is not a code change (e.g. documentation, README, typehinting,
  examples, ...).

Checklist

• I have searched the open pull requests for duplicates.
• If code changes were made then they have been tested.
  • I have updated the documentation to reflect the changes.
• If type: ignore comments were used, a comment is also left explaining why.
• I have updated the changelog to include these changes.
• AI Usage has been disclosed.
  • If AI has been used, I understand fully what the code does

[pycord-app]

Thanks for opening this pull request!
Please make sure you have read the Contributing Guidelines and Code of Conduct.

This pull request can be checked-out with:

git fetch origin pull/3208/head:pr-3208
git checkout pr-3208

This pull request can be installed with:

pip install git+https://github.com/Pycord-Development/pycord@refs/pull/3208/head

[Copilot]

Pull request overview

Adds a way to snapshot and restore discord.ui view state using component instances (rather than raw payload dicts), addressing the need described in #2385.

Changes:

• Add to_component_instances() to View and DesignerView for exporting in-memory Component instances.
• Add from_components() to View and DesignerView for restoring views from component instances (with row preservation for legacy View ActionRows).
• Add unit tests covering round-tripping for both View and DesignerView.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File	Description
discord/ui/view.py	Introduces component-instance export/import APIs for View and DesignerView.
tests/ui/test_view_component_instances.py	Adds round-trip tests for the new APIs and confirms existing dict-based behavior remains unchanged.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[NeloBlivion]

Misc.

• This should target the base ItemInterface class to support modals as well.
• I'm not sure if a testing implementation is necessary here considering we do not have any tests implemented besides voice
• This should be considered after #3093 is merged