embeds

def command_detail_embed(
    command: AppCommand,
    *,
    thumbnail_url: Optional[str] = None,
    guild: Optional[disnake.Guild] = None,
    color: Optional[disnake.Color] = None,
) -> disnake.Embed:
    """Create and return an embed showing command details.

    Parameters
    ----------
    command: AppCommand
        The `AppCommand` retrieved from `AppCommandHelp.get_command_named`
    thumbnail_url: Optional[str]
        The image's URL. - *changed in 0.5.0 - thumbnail -> thumbnail_url*
    guild: Optional[disnake.Guild]
        Guild where this embed will be displayed. Used to convert
        any role checks into role objects
    color: Optional[disnake.Color]
        Set the color the embed. Default is None

    Examples
    --------
    ```py
    from disnake.ext.app_command_help import AppCommandHelp, utils

    ...
    app_command_help = AppCommandHelp(bot)

    ...
    command = app_command_help.get_command_named(name)
    embed = utils.command_detail_embed(command, guild=inter.guild)
    await inter.response.send_message(embed=embed)
    ```

    Returns
    -------
    disnake.Embed
        The created embed containing the command details.
    """
    type_ = (
        "Slash Command Details"
        if command.type is AppCommandType.SLASH
        else (
            "User Command Details"
            if command.type is AppCommandType.USER
            else "Message Command Details"
        )
    )

    embed = disnake.Embed(description=f"{command.mention}\n{command.description}", color=color)
    embed.set_author(name=f'{type_} {"(NSFW)" if command.nsfw else ""}')
    if thumbnail_url:
        embed.set_thumbnail(url=thumbnail_url)

    if command.cooldown:
        cooldown = command.cooldown
        text = f"{cooldown.rate} / {cooldown.per}s / {cooldown.type}"
        embed.add_field(name="Cooldown", value=text, inline=False)

    if command.checks.permissions:
        permissions = ", ".join(command.checks.permissions)
        embed.add_field(name="Required Permissions", value=permissions, inline=True)

    if command.checks.roles:
        if guild:
            roles = Helply.roles_from_checks(command.checks, guild)
            role_checks = ", ".join(r.mention for r in roles)
        else:
            role_checks = ", ".join(str(check) for check in command.checks.roles)

        roles_as_string = f"**Required Roles**:\n{role_checks}"
        embed.add_field(name="Required Role(s)", value=roles_as_string, inline=True)

    if command.type is AppCommandType.SLASH:
        embed.set_footer(text="[ required ] | ( optional )")
        if command.args:
            args: str = ""

            for arg in command.args:
                name = f"**[{arg.name}]**" if arg.required else f"**({arg.name})**"
                args += f"{name}: *{arg.description}*\n"

            embed.add_field(name="Parameters", value=args, inline=False)
        else:
            embed.add_field(name="Parameters", value="None", inline=True)

    return embed

def commands_overview_embeds(
    commands: List[AppCommand],
    *,
    thumbnail_url: Optional[str] = None,
    max_field_chars: int = MAX_CHARS_PER_FIELD,
    max_fields: int = MAX_FIELDS_PER_EMBED,
    color: Optional[disnake.Color] = None,
    category: str = "",
) -> List[disnake.Embed]:
    """Create and return one or more embeds containing all commands and descriptions.

    Parameters
    ----------
    commands: List[AppCommand]
        List of `AppCommand` received from `AppCommandHelp.get_all_commands`
    thumbnail_url: Optional[str]
        The image's URL. - *changed in 0.5.0 - thumbnail -> thumbnail_url*
    max_field_chars: int
        Max number of characters per embed field description, default is MAX_CHARS_PER_FIELD (1024)
    max_fields: int
        Max number of fields per embed. default is MAX_FIELDS_PER_EMBED (10)
    color: Optional[disnake.Color]
        Set the color the embed(s). Default is None


    Examples
    --------
    ```py
    from disnake.ext.app_command_help import AppCommandHelp, utils

    ...
    app_command_help = AppCommandHelp(bot)

    ...
    commands = app_command_help.get_all_commands(inter.guild)
    embeds = utils.commands_overview_embeds(commands)
    await inter.response.send_message(embeds=embeds)
    ```

    Returns
    -------
    List[disnake.Embed]
        A list of disnake.Embed containing an overview of the commands.
    """
    if max_field_chars > MAX_CHARS_PER_FIELD:
        max_field_chars = MAX_CHARS_PER_FIELD

    if max_fields > MAX_FIELDS_PER_EMBED:
        max_fields = MAX_FIELDS_PER_EMBED

    msg = "%s must be greater or equal to one. Got %s"
    if max_field_chars <= 0:
        raise ValueError(msg % ("'max_field_chars'", str(max_field_chars)))

    if max_fields <= 0:
        raise ValueError(msg % ("'max_fields'", str(max_fields)))

    embeds: list[disnake.Embed] = []
    current_embed: Optional[disnake.Embed] = None
    current_field: str = ""
    current_field_chars: int = 0

    for command in commands:
        type_ = (
            "Slash Command"
            if command.type is AppCommandType.SLASH
            else "User Command"
            if command.type is AppCommandType.USER
            else "Message Command"
        )

        nsfw = "*(NSFW)*" if command.nsfw else ""

        command_lines = f"{command.mention} *({type_})* {nsfw}\n{command.description}\n\n"

        if current_embed is None:
            title = (
                f"{category} Commands Overview"
                if not embeds
                else f"{category} Commands Overview (continued)"
            )
            current_embed = _create_base_embed(title, color, thumbnail_url)
            current_field_chars = 0

        if current_field_chars + len(command_lines) <= max_field_chars:
            current_field += command_lines
            current_field_chars += len(command_lines)
        else:
            current_embed.add_field(name="\u200b", value=current_field, inline=False)
            current_field = command_lines
            current_field_chars = len(command_lines)

        if len(current_embed.fields) >= max_fields:
            embeds.append(current_embed)
            current_embed = None

    if current_embed is not None:
        current_embed.add_field(name="\u200b", value=current_field, inline=False)
        embeds.append(current_embed)

    return embeds