feat: Viewless components

[Paillat-dev]

ok now that this is starting to become more concrete, here is some info:

This pull request refactors rewrites py-cord's Components and Modals interface from the ground up. discord.ui has been removed entirely and replaced by top-level classes available in discord directly.

Since View has been removed, purposefully, py-cord becomes entirely stateless, which essentially means that all "views" are now persistent.

Caution

This removes ext.pages entirely since it cannot fundamentally be updated to work with the new design.

The API works as follows:

Components Example (click to open)

def build_container(secret_message: str) -> Container:
    return Container(
        ActionRow(
            Button(
                style=ButtonStyle.primary,
                label="Click me! I'll tell you a secret",
                custom_id=f"v1:hello_button_{secret_message}",
                emoji=PartialEmoji(name="🤫"),
            )
        ),
        id=3,
    )


@bot.command()
async def secret(ctx: ApplicationContext, secret_message: str) -> None:
    await ctx.respond(
        components=[build_container(secret_message)],
    )

def hello_button_predicate(custom_id: str) -> bool:
   return custom_id.startswith("v1:hello_button_") 

@bot.component_listener(hello_button_predicate)
async def hello_button(interaction: ComponentInteraction[Button]) -> None:
    secret_message = interaction.custom_id.split("hello_button_")[1]
    await interaction.respond(
        f"Hello {interaction.user.name}! The secret message is: ||{secret_message}||", ephemeral=True
    )

If you want to understand the api in more detail, you can open the latest readthedocs build and take a look at:

• discord.Component
• discord.ComponentsSequence
• discord.Bot.component_listener
• discord.Bot.add_component_listener
• discord.Bot.remove_component_listener

You can also take a look at the diff of the CHANGELOG-V3.md file

Additionally, this implements stuff of the new discord Modals API like shown below:

Modals Example (click to open)

from discord import components
SECRET_MODAL = components.Modal(
    components.Label(
        label="Secret Message",
        component=components.TextInput(
            style=discord.TextInputStyle.long,
            custom_id="v1:secret_input",
            placeholder="Enter your secret message here...",
            required=True,
        ),
    ),
    Label(
        label="Favourite Color",
        component=components.StringSelectMenu(
            options=[
                components.SelectOption(label="Red", value="red"),
                components.SelectOption(label="Green", value="green"),
                components.SelectOption(label="Blue", value="blue"),
            ],
            required=False,
            custom_id="v1:color_select",
            min_values=1,
            max_values=1
        )
    ),
    components.Label(
        label="Your favourite user",
        description="Please select your favourite user in this server",
        component=components.UserSelectMenu(
            custom_id="v1:user_select",
            min_values=1,
            max_values=4,
            required=True,
            default_values=[components.DefaultSelectOption(856780995629154305, "user"), components.DefaultSelectOption(707196665668436019, "user")]
        )
    ),
    components.TextDisplay(
        content="By submitting this form, you acknowledge that the information provided is accurate and truthful to the best of your knowledge."
    ),
    title="Secret Message Input",
    custom_id=f"v1:secret_modal",
)


@bot.command(integration_types={components.IntegrationType.guild_install, components.IntegrationType.user_install}, context={components.InteractionContextType.guild, components.InteractionContextType.bot_dm, components.InteractionContextType.private_channel})
async def secret(ctx: discord.ApplicationContext) -> None:
    await ctx.send_modal(SECRET_MODAL)

@bot.modal_listener("v1:secret_modal")
async def hello_button(
        interaction: discord.ModalInteraction[
            components.PartialLabel[components.PartialTextInput], components.PartialLabel[components.PartialStringSelect], components.PartialLabel[components.PartialUserSelect], components.PartialTextDisplay
        ],
) -> None:
    _ = await interaction.respond(
        components=[
            components.Container(
                components.TextDisplay("## Your secret message has been received!"),
                components.TextDisplay(f"**Secret Message:** {interaction.components[0].component.value}"),
                components.TextDisplay(
                    f"**Favourite Color:** {interaction.components[1].component.values[0]}"
                ),
                components.TextDisplay(
                    f"**Favourite Users:** {', '.join([f'<@{option}>' for option in interaction.components[2].component.values])}"
                ),
            )
        ],
        allowed_mentions=AllowedMentions.none(),
    )

This also removes multiple long deprecated methods / properties from interactions.py

depends on #44
depends on #62

fixes: #11

[Copilot]

Pull Request Overview

This pull request refactors py-cord's component and modal system from the ground up, completely removing the discord.ui module and replacing it with top-level classes in the discord namespace. The refactor makes the library stateless by removing the View class and making all components persistent by default.

• Complete removal of discord.ui module and View class, making the library stateless
• Introduction of new component system with top-level classes accessible directly from discord
• Implementation of new Discord Modals API features
• Removal of ext.pages module due to incompatibility with the new design

Reviewed Changes

Copilot reviewed 68 out of 69 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
pyproject.toml	Updates typing-extensions minimum version requirement
examples/views/new_components.py	Updates button example to use message.edit instead of parent.edit
examples/modal_dialogs.py	Updates to use new TextInput and TextInputStyle names
docs/	Removes ext.pages documentation and updates UI Kit API documentation
discord/ui/	Complete removal of entire UI module including View, Modal, Button, Select classes
discord/components/	New comprehensive component system with individual classes
discord/interactions.py	Adds new ModalInteraction and ComponentInteraction classes
discord/state.py	Removes view/modal storage and dispatching logic
discord/enums.py	Renames InputTextStyle to TextInputStyle

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[Copilot]

Pull Request Overview

Copilot reviewed 91 out of 92 changed files in this pull request and generated 8 comments.

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}